Source-Changes-HG archive
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index][Old Index]
[src/trunk]: src/share/man/man4 Remove superfluous Tn markup.
details: https://anonhg.NetBSD.org/src/rev/8b48eccc467c
branches: trunk
changeset: 355766:8b48eccc467c
user: wiz <wiz%NetBSD.org@localhost>
date: Sun Aug 13 18:18:57 2017 +0000
description:
Remove superfluous Tn markup.
diffstat:
share/man/man4/ip.4 | 86 ++++++++++++++--------------------------------------
1 files changed, 24 insertions(+), 62 deletions(-)
diffs (185 lines):
diff -r a719fd2d8e66 -r 8b48eccc467c share/man/man4/ip.4
--- a/share/man/man4/ip.4 Sun Aug 13 08:49:27 2017 +0000
+++ b/share/man/man4/ip.4 Sun Aug 13 18:18:57 2017 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: ip.4,v 1.38 2017/08/10 04:31:58 ryo Exp $
+.\" $NetBSD: ip.4,v 1.39 2017/08/13 18:18:57 wiz Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -41,38 +41,24 @@
.Ft int
.Fn socket AF_INET SOCK_RAW proto
.Sh DESCRIPTION
-.Tn IP
-is the network layer protocol used by the Internet protocol family.
+IP is the network layer protocol used by the Internet protocol family.
Options may be set at the
-.Tn IP
-level when using higher-level protocols that are based on
-.Tn IP
-(such as
-.Tn TCP
-and
-.Tn UDP ) .
+IP level when using higher-level protocols that are based on
+IP (such as TCP and UDP).
It may also be accessed through a
.Dq raw socket
when developing new protocols, or special-purpose applications.
.Pp
-There are several
-.Tn IP-level
+There are several IP-level
.Xr setsockopt 2 Ns / Ns Xr getsockopt 2
options.
.Dv IP_OPTIONS
-may be used to provide
-.Tn IP
-options to be transmitted in the
-.Tn IP
-header of each outgoing packet
+may be used to provide IP options to be transmitted in the
+IP header of each outgoing packet
or to examine the header options on incoming packets.
-.Tn IP
-options may be used with any socket type in the Internet family.
-The format of
-.Tn IP
-options to be sent is that specified by the
-.Tn IP
-protocol specification (RFC 791), with one exception:
+IP options may be used with any socket type in the Internet family.
+The format of IP options to be sent is that specified by the
+IP protocol specification (RFC 791), with one exception:
the list of addresses for Source Route options must include the first-hop
gateway at the beginning of the list of gateways.
The first-hop gateway address will be extracted from the option list
@@ -86,8 +72,7 @@
and
.Dv IP_TTL
may be used to set the type-of-service and time-to-live fields in the
-.Tn IP
-header for
+IP header for
.Dv SOCK_STREAM
and
.Dv SOCK_DGRAM
@@ -154,8 +139,7 @@
.Ed
.Pp
The port selection can be also viewed and controlled at a global level for all
-.Tn IP
-sockets using the following
+IP sockets using the following
.Xr sysctl 7
variables:
.Dv net.inet.ip.anonportalgo.available
@@ -183,15 +167,9 @@
socket,
the
.Xr recvmsg 2
-call will return the destination
-.Tn IP
-address for a
-.Tn UDP
-datagram.
+call will return the destination IP address for a UDP datagram.
The msg_control field in the msghdr structure points to a buffer
-that contains a cmsghdr structure followed by the
-.Tn IP
-address.
+that contains a cmsghdr structure followed by the IP address.
The cmsghdr fields have the following values:
.Bd -literal
cmsg_len = CMSG_LEN(sizeof(struct in_addr))
@@ -231,13 +209,9 @@
.Dv SOCK_DGRAM
socket, the
.Xr recvmsg 2
-call will return the
-.Tn TTL
-of the received datagram.
+call will return the TTL of the received datagram.
The msg_control field in the msghdr structure points to a buffer
-that contains a cmsghdr structure followed by the
-.Tn TTL
-value.
+that contains a cmsghdr structure followed by the TTL value.
The cmsghdr fields have the following values:
.Bd -literal
cmsg_len = CMSG_LEN(sizeof(uint8_t))
@@ -261,8 +235,7 @@
setsockopt(s, IPPROTO_IP, IP_MINTTL, &minttl, sizeof(minttl));
.Ed
.Ss MULTICAST OPTIONS
-.Tn IP
-multicasting is supported only on
+IP multicasting is supported only on
.Dv AF_INET
sockets of type
.Dv SOCK_DGRAM
@@ -298,9 +271,7 @@
setsockopt(s, IPPROTO_IP, IP_MULTICAST_IF, &addr, sizeof(addr));
.Ed
.Pp
-where "addr" is the local
-.Tn IP
-address of the desired interface or
+where "addr" is the local IP address of the desired interface or
.Dv INADDR_ANY
to specify the default interface.
An interface's local IP address and multicast capability can
@@ -371,8 +342,7 @@
.Dv imr_interface
should be
.Dv INADDR_ANY
-to choose the default multicast interface, or the
-.Tn IP
+to choose the default multicast interface, or the IP
address of a particular multicast-capable interface if
the host is multihomed.
Membership is associated with a single interface;
@@ -394,9 +364,7 @@
Memberships are dropped when the socket is closed or the process exits.
.\"-----------------------
.Ss RAW IP SOCKETS
-Raw
-.Tn IP
-sockets are connectionless, and are normally used with the
+Raw IP sockets are connectionless, and are normally used with the
.Xr sendto 2
and
.Xr recvfrom 2
@@ -424,15 +392,12 @@
is non-zero, that protocol number will be used on outgoing packets
and to filter incoming packets.
.Pp
-Outgoing packets automatically have an
-.Tn IP
+Outgoing packets automatically have an IP
header prepended to them (based on the destination address and the
protocol number the socket is created with), unless the
.Dv IP_HDRINCL
option has been set.
-Incoming packets are received with
-.Tn IP
-header and options intact.
+Incoming packets are received with IP header and options intact.
.Pp
.Dv IP_HDRINCL
indicates the complete IP header is included with the data and may
@@ -479,11 +444,8 @@
when an attempt is made to create a raw IP socket by a non-privileged process.
.El
.Pp
-The following errors specific to
-.Tn IP
-may occur when setting or getting
-.Tn IP
-options:
+The following errors specific to IP may occur when setting or getting
+IP options:
.Bl -tag -width EADDRNOTAVAILxx
.It Bq Er EINVAL
An unknown socket option name was given.
Home |
Main Index |
Thread Index |
Old Index