ip.7: Convention, order, and typo
PATCH 1/1 ip.7: Convention, order, and typo
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1
Hi,
Please find inline a patch against current ip(7) manual page, in order to fix some issue spotted while reviewing it's translation.
The first part goal is to mark in _italic_ the text that should be replaced with appropriate argument, as it is correctly used in other parts of the page (and in the other pages).
The second part of the patch is a nip-ticking one, proposed in case you find it justified to also follow this rule for INADDR_*.
I also noticed that socket options used to be order alphabetically, this is addressed in the following parts of the patch.
Finally, maybe the most important one if I'm not mistaken, the last part of the patch fixes a socket option name issue.
man7/ip.7 +0 -0
- --- a/man7/ip.7
+++ b/man7/ip.7
@@ -41,7 +41,7 @@ For more information on sockets, see
An IP socket is created by calling the
.BR socket (2)
function as
- -.BR "socket(AF_INET, socket_type, protocol)" .
+.BR "socket(AF_INET, \fIsocket_type\fB, \fIprotocol\fB)" .
Valid socket types are
.B SOCK_STREAM
to open a
@@ -151,7 +151,7 @@ member of
.I struct in_addr
contains the host interface address in network byte order.
.I in_addr
- -should be assigned one of the INADDR_* values (e.g.,
+should be assigned one of the \fBINADDR_\fI*\fR values (e.g.,
.BR INADDR_ANY )
or set using the
.BR inet_aton (3),
@@ -263,6 +263,19 @@ or
structure similar to
.BR IP_ADD_MEMBERSHIP .
.TP
+.BR IP_FREEBIND " (since Linux 2.4)"
+.\" Precisely: 2.4.0-test10
+If enabled, this boolean option allows binding to an IP address
+that is nonlocal or does not (yet) exist.
+This permits listening on a socket,
+without requiring the underlying network interface or the
+specified dynamic IP address to be up at the time that
+the application is trying to bind to it.
+This option is the per-socket equivalent of the
+.IR ip_nonlocal_bind
+.I /proc
+interface described below.
+.TP
.BR IP_HDRINCL " (since Linux 2.0)"
If enabled,
the user supplies an IP header in front of the user data.
@@ -278,19 +291,6 @@ When this flag is enabled the values set by
and
.B IP_TOS
are ignored.
- -.TP
- -.BR IP_FREEBIND " (since Linux 2.4)"
- -.\" Precisely: 2.4.0-test10
- -If enabled, this boolean option allows binding to an IP address
- -that is nonlocal or does not (yet) exist.
- -This permits listening on a socket,
- -without requiring the underlying network interface or the
- -specified dynamic IP address to be up at the time that
- -the application is trying to bind to it.
- -This option is the per-socket equivalent of the
- -.IR ip_nonlocal_bind
- -.I /proc
- -interface described below.
.\"
.\" FIXME Document IP_IPSEC_POLICY
.\" Since Linux 2.5.47
@@ -449,18 +449,6 @@ puts the current IP options used for sending into the supplied buffer.
.\" commit 2c7946a7bf45ae86736ab3b43d0085e43947945c
.\" Author: Catherine Zhang <[email protected]> .TP
- -.BR IP_RECVORIGDSTADDR " (since Linux 2.6.29)"
- -.\" FIXME: Document IP_ORIGDSTADDR+IP_RECVORIGDSTADDR, added in Linux 2.6.29
- -.\" commit e8b2dfe9b4501ed0047459b2756ba26e5a940a69
- -This boolean option enables the
- -.B IP_ORIGDSTADDR
- -ancillary message in
- -.BR recvmsg (2),
- -in which the kernel returns the original destination address
- -of the datagram being received.
- -The ancillary message contains a
- -.IR "struct sockaddr_in" .
- -.TP
.BR IP_PKTINFO " (since Linux 2.2)"
.\" Precisely: 2.1.68
Pass an
@@ -661,6 +649,18 @@ Not supported for
.B SOCK_STREAM
sockets.
.TP
+.BR IP_RECVORIGDSTADDR " (since Linux 2.6.29)"
+.\" FIXME: Document IP_ORIGDSTADDR+IP_RECVORIGDSTADDR, added in Linux 2.6.29 +.\" commit e8b2dfe9b4501ed0047459b2756ba26e5a940a69
+This boolean option enables the
+.B IP_ORIGDSTADDR
+ancillary message in
+.BR recvmsg (2),
+in which the kernel returns the original destination address
+of the datagram being received.
+The ancillary message contains a
+.IR "struct sockaddr_in" .
+.TP
.BR IP_RECVTOS " (since Linux 2.2)"
.\" Precisely: 2.1.68
If enabled the
@@ -733,7 +733,7 @@ socket option (see
.\" Author: KOVACS Krisztian <[email protected]> .\" http://lwn.net/Articles/252545/
.TP
- -.BR IP_TTL " (since Linux 2.6.24)"
+.BR IP_TRANSPARENT " (since Linux 2.6.24)"
.\" commit f5715aea4564f233767ea1d944b2637a5fd7cd2e
.\" This patch introduces the IP_TRANSPARENT socket option: enabling that
.\" will make the IPv4 routing omit the non-local source address check on
Regards
David
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.10 (GNU/Linux)
iEYEARECAAYFAkzA/KUACgkQ18/WetbTC/rgiQCgk6vSXqUdHcLZ8JqpwdnSOG6s r+UAn2GD2C063PcEdmdo+zk/ispXwvOQ
=NO7w
-----END PGP SIGNATURE-----
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html
[Same message, without the signature that may have broken the inline patch]
Hi,
Please find inline a patch against current ip(7) manual page, in order to fix some issue spotted while reviewing it's translation.
The first part goal is to mark in _italic_ the text that should be replaced with appropriate argument, as it is correctly used in other parts of the page (and in the other pages).
The second part of the patch is a nip-ticking one, proposed in case you find it justified to also follow this rule for INADDR_*.
I also noticed that socket options used to be order alphabetically, this is addressed in the following parts of the patch.
Finally, maybe the most important one if I'm not mistaken, the last part of the patch fixes a socket option name issue.
man7/ip.7 +28 -28
@@ -41,7 +41,7 @@ For more information on sockets, see An IP socket is created by calling the .BR socket (2) function as -.BR "socket(AF_INET, socket_type, protocol)" . +.BR "socket(AF_INET, \fIsocket_type\fB, \fIprotocol\fB)" . Valid socket types are .B SOCK_STREAM to open a
@@ -151,7 +151,7 @@ member of .I struct in_addr contains the host interface address in network byte order. .I in_addr -should be assigned one of the INADDR_* values (e.g., +should be assigned one of the \fBINADDR_\fI*\fR values (e.g., .BR INADDR_ANY ) or set using the .BR inet_aton (3),
@@ -263,6 +263,19 @@ or structure similar to .BR IP_ADD_MEMBERSHIP . .TP +.BR IP_FREEBIND " (since Linux 2.4)" +.\" Precisely: 2.4.0-test10 +If enabled, this boolean option allows binding to an IP address +that is nonlocal or does not (yet) exist. +This permits listening on a socket, +without requiring the underlying network interface or the +specified dynamic IP address to be up at the time that +the application is trying to bind to it. +This option is the per-socket equivalent of the +.IR ip_nonlocal_bind +.I /proc +interface described below. +.TP .BR IP_HDRINCL " (since Linux 2.0)" If enabled, the user supplies an IP header in front of the user data.
@@ -278,19 +291,6 @@ When this flag is enabled the values set by and .B IP_TOS are ignored. -.TP -.BR IP_FREEBIND " (since Linux 2.4)" -.\" Precisely: 2.4.0-test10 -If enabled, this boolean option allows binding to an IP address -that is nonlocal or does not (yet) exist. -This permits listening on a socket, -without requiring the underlying network interface or the -specified dynamic IP address to be up at the time that -the application is trying to bind to it. -This option is the per-socket equivalent of the -.IR ip_nonlocal_bind -.I /proc -interface described below. .\" .\" FIXME Document IP_IPSEC_POLICY .\" Since Linux 2.5.47
@@ -449,18 +449,6 @@ puts the current IP options used for sending into the supplied buffer. .\" commit 2c7946a7bf45ae86736ab3b43d0085e43947945c .\" Author: Catherine Zhang <[email protected]> .TP -.BR IP_RECVORIGDSTADDR " (since Linux 2.6.29)" -.\" FIXME: Document IP_ORIGDSTADDR+IP_RECVORIGDSTADDR, added in Linux 2.6.29 -.\" commit e8b2dfe9b4501ed0047459b2756ba26e5a940a69 -This boolean option enables the -.B IP_ORIGDSTADDR -ancillary message in -.BR recvmsg (2), -in which the kernel returns the original destination address -of the datagram being received. -The ancillary message contains a -.IR "struct sockaddr_in" . -.TP .BR IP_PKTINFO " (since Linux 2.2)" .\" Precisely: 2.1.68 Pass an
@@ -661,6 +649,18 @@ Not supported for .B SOCK_STREAM sockets. .TP +.BR IP_RECVORIGDSTADDR " (since Linux 2.6.29)" +.\" FIXME: Document IP_ORIGDSTADDR+IP_RECVORIGDSTADDR, added in Linux 2.6.29 +.\" commit e8b2dfe9b4501ed0047459b2756ba26e5a940a69 +This boolean option enables the +.B IP_ORIGDSTADDR +ancillary message in +.BR recvmsg (2), +in which the kernel returns the original destination address +of the datagram being received. +The ancillary message contains a +.IR "struct sockaddr_in" . +.TP .BR IP_RECVTOS " (since Linux 2.2)" .\" Precisely: 2.1.68 If enabled the
@@ -733,7 +733,7 @@ socket option (see .\" Author: KOVACS Krisztian <[email protected]> .\" http://lwn.net/Articles/252545/ .TP -.BR IP_TTL " (since Linux 2.6.24)" +.BR IP_TRANSPARENT " (since Linux 2.6.24)" .\" commit f5715aea4564f233767ea1d944b2637a5fd7cd2e .\" This patch introduces the IP_TRANSPARENT socket option: enabling that .\" will make the IPv4 routing omit the non-local source address check on
Regards
David
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1
Hi
Quoted 2 lines · David Prévot
Please find inline a patch against current ip(7) manual page, in order to fix some issue spotted while reviewing it's translation.
Please find some more “bold“ issues spotted later (please let me know if you prefer various messages for this type of issues in the future, instead of just one typo patch).
@@ -609,11 +597,13 @@ caused the error, which can be accessed with the
macro.
The
.I sin_family
- -field of the SO_EE_OFFENDER address is
+field of the
+.B SO_EE_OFFENDER
+address is
.B AF_UNSPEC
when the source was unknown.
When the error originated from the network, all IP options
- -.RI ( IP_OPTIONS ", " IP_TTL ", "
+.RB ( IP_OPTIONS ", " IP_TTL ", "
etc.) enabled on the socket and contained in the
error packet are passed as control messages.
The payload of the packet causing the error is returned as normal payload.
Regards
David
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.10 (GNU/Linux)
iEYEARECAAYFAkzBnIMACgkQ18/WetbTC/q8KwCdGxXFKvfVi50Cfyq0ynuFLUrf 12cAn0ziNnze8W3FxXeyVUuX6gmA0nw9
=aTsu
-----END PGP SIGNATURE-----
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html
Hello David,
Quoted 9 lines · David Prévot
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1Hi
Quoted 2 lines · David Prévot
Please find inline a patch against current ip(7) manual page, in order to fix some issue spotted while reviewing it's translation.
Thanks. Applied for 3.30.
Quoted 3 lines
Please find some more “bold“ issues spotted later (please let me know if you prefer various messages for this type of issues in the future, instead of just one typo patch).
I prefer to split things up logically (see how I split up your first patch), but when all of the issues are minor, it's not too much of a problem to get everything in one patch.
Cheers,
Michael
Quoted 35 lines
(quoted diff) +0
-0@@ -609,11 +597,13 @@ caused the error, which can be accessed with themacro.
The
.Isin_family
- -field of theSO_EE_OFFENDERaddress is(quoted diff) +3
-0+field of the +.B SO_EE_OFFENDER +address is.B
AF_UNSPEC
when the source was unknown.
When the error originated from the network, all IP options
- -.RI (IP_OPTIONS", "IP_TTL", "
+.RB (IP_OPTIONS", "IP_TTL", "
etc.) enabled on the socket and contained in the
error packet are passed as control messages.
The payload of the packet causing the error is returned as normal payload.Regards
David
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.10 (GNU/Linux)iEYEARECAAYFAkzBnIMACgkQ18/WetbTC/q8KwCdGxXFKvfVi50Cfyq0ynuFLUrf 12cAn0ziNnze8W3FxXeyVUuX6gmA0nw9
=aTsu
-----END PGP SIGNATURE-------
To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html
Signature · 7 lines
Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Author of "The Linux Programming Interface"; http://man7.org/tlpi/ -- To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html
Hello David,
Quoted 12 lines · David Prévot
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1Hi,
Please find inline a patch against current ip(7) manual page, in order to fix some issue spotted while reviewing it's translation.
The first part goal is to mark in _italic_ the text that should be replaced with appropriate argument, as it is correctly used in other parts of the page (and in the other pages).
Quoted 8 lines
The second part of the patch is a nip-ticking one, proposed in case you find it justified to also follow this rule for INADDR_*.
I also noticed that socket options used to be order alphabetically, this is addressed in the following parts of the patch.
Finally, maybe the most important one if I'm not mistaken, the last part of the patch fixes a socket option name issue.
Thanks. I applied these changes in 3 pieces. (See git.) The changes will be in man-pages-3.30.
Thanks,
Michael
Quoted 128 lines
man7/ip.7 +1
-1- --- a/man7/ip.7 +++ b/man7/ip.7@@ -41,7 +41,7 @@ For more information on sockets, seeAn IP socket is created by calling the
.BR socket (2)
function as
- -.BR "socket(AF_INET, socket_type, protocol)" . +.BR "socket(AF_INET, \fIsocket_type\fB, \fIprotocol\fB)" . Valid socket types are
.BSOCK_STREAM
to open aman7/ip.7 +0
-0@@ -151,7 +151,7 @@ member of.I struct
in_addr
contains the host interface address in network byte order. .Iin_addr
- -should be assigned one of the INADDR_* values (e.g., +should be assigned one of the \fBINADDR_\fI*\fR values (e.g., .BRINADDR_ANY)
or set using the
.BRinet_aton(3),man7/ip.7 +0
-0@@ -263,6 +263,19 @@ orstructure similar to
.BRIP_ADD_MEMBERSHIP.
.TP
+.BRIP_FREEBIND" (since Linux 2.4)"
+.\" Precisely: 2.4.0-test10man7/ip.7 +11
-0+If enabled, this boolean option allows binding to an IP address +that is nonlocal or does not (yet) exist. +This permits listening on a socket, +without requiring the underlying network interface or the +specified dynamic IP address to be up at the time that +the application is trying to bind to it. +This option is the per-socket equivalent of the +.IR ip_nonlocal_bind +.I /proc +interface described below. +.TP.BR
IP_HDRINCL" (since Linux 2.0)"
If enabled,
the user supplies an IP header in front of the user data.man7/ip.7 +0
-0@@ -278,19 +291,6 @@ When this flag is enabled the values set byand
.BIP_TOS
are ignored.
- -.TP
- -.BRIP_FREEBIND" (since Linux 2.4)"
- -.\" Precisely: 2.4.0-test10
- -If enabled, this boolean option allows binding to an IP address
- -that is nonlocal or does not (yet) exist.
- -This permits listening on a socket,
- -without requiring the underlying network interface or the
- -specified dynamic IP address to be up at the time that
- -the application is trying to bind to it.
- -This option is the per-socket equivalent of the
- -.IRip_nonlocal_bind
- -.I /proc
- -interface described below.
.\"
.\" FIXME DocumentIP_IPSEC_POLICY
.\" Since Linux 2.5.47man7/ip.7 +0
-0@@ -449,18 +449,6 @@ puts the current IP options used for sending into the supplied buffer..\" commit
2c7946a7bf45ae86736ab3b43d0085e43947945c
.\" Author: Catherine Zhang <[email protected]> .TP
- -.BRIP_RECVORIGDSTADDR" (since Linux 2.6.29)"
- -.\" FIXME: Document IP_ORIGDSTADDR+IP_RECVORIGDSTADDR, added in Linux 2.6.29
- -.\" commite8b2dfe9b4501ed0047459b2756ba26e5a940a69
- -This boolean option enables the
- -.BIP_ORIGDSTADDR
- -ancillary message in
- -.BR recvmsg (2),
- -in which the kernel returns the original destination address
- -of the datagram being received.
- -The ancillary message contains a
- -.IR "structsockaddr_in" .
- -.TP
.BRIP_PKTINFO" (since Linux 2.2)"
.\" Precisely: 2.1.68
Pass anman7/ip.7 +0
-0@@ -661,6 +649,18 @@ Not supported for.B
SOCK_STREAM
sockets.
.TP
+.BRIP_RECVORIGDSTADDR" (since Linux 2.6.29)"
+.\" FIXME: Document IP_ORIGDSTADDR+IP_RECVORIGDSTADDR, added in Linux 2.6.29 +.\" commite8b2dfe9b4501ed0047459b2756ba26e5a940a69man7/ip.7 +9
-0+This boolean option enables the +.B IP_ORIGDSTADDR +ancillary message in +.BR recvmsg (2), +in which the kernel returns the original destination address +of the datagram being received. +The ancillary message contains a +.IR "struct sockaddr_in" . +.TP.BR
IP_RECVTOS" (since Linux 2.2)"
.\" Precisely: 2.1.68
If enabled theman7/ip.7 +0
-0@@ -733,7 +733,7 @@ socket option (see.\" Author: KOVACS Krisztian <[email protected]> .\" http://lwn.net/Articles/252545/
.TP
- -.BRIP_TTL" (since Linux 2.6.24)"
+.BRIP_TRANSPARENT" (since Linux 2.6.24)"
.\" commitf5715aea4564f233767ea1d944b2637a5fd7cd2e
.\" This patch introduces theIP_TRANSPARENTsocket option: enabling that .\" will make the IPv4 routing omit the non-local source address check onRegards
David
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.10 (GNU/Linux)iEYEARECAAYFAkzA/KUACgkQ18/WetbTC/rgiQCgk6vSXqUdHcLZ8JqpwdnSOG6s r+UAn2GD2C063PcEdmdo+zk/ispXwvOQ
=NO7w
-----END PGP SIGNATURE-------
To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html
Signature · 7 lines
Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Author of "The Linux Programming Interface"; http://man7.org/tlpi/ -- To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html