Commit 4a19ec5800fc3bb64e2d87c4d9fdd9e636086fe0 in Jan 2008 added
the new SO_MARK socket option.
This patch is based on text from the commit message.
See https://bugzilla.kernel.org/show_bug.cgi?id=16461.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Fis warning from "groff -ww ..." (or "man --warnings=w ..."):
<groff: mdoc.7>:294: warning:
tab character in unquoted macro argument
In one table the distance between columns is too small in the
"ps" output. (Bug in the groff "doc.tmac" macro?)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
From "man -ww ..." (groff -ww ...):
<standard input>:541: warning:
tab character in unquoted macro argument
[+3 similar warnings]
<standard input>:813: warning: macro `Pu' not defined
Usage: .Rv -std in sections 2 and 3 only (#1669)
mdoc warning: A .Bl directive has no matching .El (#1821)
String "Pu" defined as a row of punctuation characters.
".Bl" and ".El" fixed.
Some arguments, that start with a period or are the name of a
macro, protected with "\&".
Variable name for macro ".Rv" corrected.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Fix warning from "man ..." ("nroff -ww ..."):
nroff: netlink.7: warning: around line 195:
table wider than line width
Horizontal line incorporated into table.
No right adjustment of text blocks in tables.
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=673875
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Fix warning from "man ..." ("nroff -ww ..."):
nroff: rtnetlink.7: warning: around line 415:
table wider than line width
Column gutter reduced to fit line length.
Right adjustment in text blocks removed in tables.
Some header made centered in tables.
One table put on same page.
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=674051
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Including <sys/types.h> and <sys/ipc.h> isn't needed on Linux
and isn't really relevant for the explanation on this page.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
There's no need to mention that the 'ipc_perm' structure
is defined in <sys/ipc.h>. That's an implementation detail,
and furthermore <sys/ipc.h> is itself included by the other
System V IPC header files. The current text might lead the
reader to conclude that they must include <sys/ipc.h>, which
is not the case (it is required neither on Linux, nor by the
standards).
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Fix warning from "man ..." ("nroff -ww ..."):
nroff: netdevice.7: warning: around line 98:
table wider than line width
Fix: No right adjustment in text blocks in tables.
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=673873
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
man(1) on the present page yields errors:
grotty: ... character above first line discarded
The culprit is "Dl 0 -xxxx" (vertical line) where "xxxx" is
one line (40 nroff units) too long. Or there is a bug in
"grotty". "nroff" or "tbl" makes an empty line where a page is.
The patch fixes the problem by setting the page length to
a large value.
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=673436
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
From "nroff -ww -t ...":
warning: around line 44: table wider than line width
Columns are made narrower (column gutter decreased).
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Fix following from "groff -t -ww ...":
warning: around line 53: table wider than line width
Extra indent for "troff" makes the table look misplaced
(default "ps" output).
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Some of the sockets/network protocol pages included names of
the corresponding address family constants in the NAME line,
but this wasn't done consistently across all pages, and probably
it adds little value in those pages that did do this. So, remove
these constants from those pages that have them in the NAME
section.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
It must be a very long time since the statement there
about SIGLOST was true. (The text seems to date back to
1996.)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This patch clarifies that 0xc0 and 0xc1 are not valid in any UTF-8
encoding[0], and it also references RFC 3629 instead of RFC 2279.
[0] In order to have 0xc0, you'd have to have a two-byte encoding
with all the data bits zero in the first byte (and thus only six
bits of data), which would be an ASCII character encoded in the
non-shortest form. Similarly with 0xc1.
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=538641
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
A change in 2.6.28 restored the 2.2 behavior:
https://lkml.org/lkml/2009/6/30/499
Reported-by: lepton <ytht.net@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
In tcp.7, about TCP_MAXSEG, it reads
If this option is set before connection establishment,
it also changes the MSS value announced to the other
end in the initial packet.
It is correct for kernel version 2.2, but it is not
correct for modern kernel such as 2.4 and 2.6.
On a linux box with a modern kernel, the setting for
TCP_MAXSEG won't change the MSS value announced to the
other end.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
As reported by Alexey:
socket(7) says:
SO_BROADCAST
Set or get the broadcast flag. When enabled, datagram sockets
receive packets sent to a broadcast address and they are allowed
to send packets to a broadcast address. This option has no
effect on stream-oriented sockets.
I believe the second sentence is half wrong: when I try it, it
only affects the ability to send broadcast datagrams. You can only
receive broadcast datagrams if you bind to INADDR_ANY and don't
connect. The POSIX standard agrees with my tests and disagrees
with the manpage:
http://www.opengroup.org/onlinepubs/009695399/functions/xsh_chap02_10.html
Reported-by: Alexey Toptygin <alexeyt@freeshell.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This patch adds common but missing SIOC configuration ioctls to
the netdevice.7 manual pages that are not documented anywhere
else. SIOCSIFPFLAGS and SIOCGIFPFLAGS are linux-specific. Flag
values come from Linux 2.6.25 kernel headers for sockios. The
others are standard BSD ioctls that have alwasy been implemented
by Linux and were verified from inspecting netdevice.c kernel
code.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
As noted by reporter:
* The code sample given for the NAME section is incomplete because
the actual content sample is not given.
* Additionally, the description assumes that the item described is
a command, which need not be the case.
* The command makewhatis is not present on my system; the
documented tool to create the whatis database is called mandb.
* The description on .SH NAME in man(7) should either copy the
relevant paragraph of lexgrog(1) or refer to it.
Reported by: Kristof Zelechovski <giecrilj@stegny.2a.pl>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reported-by: Benjamin Poirier <benjamin.poirier@gmail.com>
Reported-by: Neil Horman <nhorman@tuxdriver.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
I noticed what appears to be a discrepancy between the ip(7)
man page and the kernel code with regards to the IP DF flag
for UDP sockets.
The man page says that "The don't-fragment flag is set on all
outgoing datagrams" and that the ip_no_pmtu_disc sysctl affects
only SOCK_STREAM sockets. This is quickly disproved by doing:
echo 1 > /proc/sys/net/ipv4/ip_no_pmtu_disc
firing up netcat and looking at a few outgoing UDP packets in
wireshark (they don't have the DF flag set).
1) in the words of `man 7 ip`:
IP_MTU_DISCOVER (since Linux 2.2)
Set or receive the Path MTU Discovery setting for a socket.
When enabled, Linux will perform Path MTU Discovery as defined
in RFC 1191 on this socket. The don't-fragment flag is set on
all outgoing datagrams. The system-wide default is controlled
by the /proc/sys/net/ipv4/ip_no_pmtu_disc file for SOCK_STREAM
sockets, and disabled on all others.
2) in net/ipv4/af_inet.c:inet_create():
if (ipv4_config.no_pmtu_disc)
inet->pmtudisc = IP_PMTUDISC_DONT;
else
inet->pmtudisc = IP_PMTUDISC_WANT;
and pmtudisc is left alone from there on for UDP sockets.
Reviewed-by: Neil Horman <nhorman@tuxdriver.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Starting with Linux 2.6.33, the CONFIG_SECURITY_FILE_CAPABILITIES
has been removed, and file capabilities are always part of the
kernel.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This flag was added in Linux 2.6.36.
See kernel commit 8c1934c8d70b22ca8333b216aec6c7d09fdbd6a6.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Please find inline another tiny patch in order to shrink
the definite article from some other pages (found with
"rgrep -i ' \\\- the' man*").
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
The patch addresses the uppercase hexadecimal numbers
minor issue for iso_8859-10.7. Please note that this
patch also address a minor s/ca/CB/ typo.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
koi8-u.7 was not the only character set page displaying lowercase
hexadecimal numbers. The patch addresses this minor issue for
armscii-8.7 (other will follow, capitalized number are mostly used,
and that is the way they are presented in Unicode.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
koi8-u.7 seems to be the only character set page displaying
lowercase hexadecimal numbers. The inline patch address this
minor issue.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
he koi8-r(7) (Russian Net Character Set) manual page refers to
iso-8859-7(7) manual page, which is the Latin/Greek one. I guess it
should refer instead to the iso-8859-5(7) (Latin/Cyrillic) one. This is
addressed at the end of the patch.
It has also been spotted that letter names are different in this manual
page and in the Unicode related page [0], the first part of the page
address this.
0: http://www.unicode.org/charts/PDF/U0400.pdf
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Text based on input from Lennart Poettering and Balazs Scheidler.
See https://bugzilla.kernel.org/show_bug.cgi?id=20082
Reported-by: Lennart Poettering <zxreary@0pointer.de>
Reported-by: Balazs Scheidler <bazsi@balabit.hu>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
The man pages were rather inconsistent in the use of "Unix"
versus "UNIX". Let's go with the trademark usage.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
As reported by Lennart Poettering:
The part about "pathname" sockets suggests usage of
sizeof(sa_family_t) + strlen(sun_path) + 1
for calculating the sockaddr size. Due to alignment/padding
this is probably not a good idea. Instead, one should use
offsetof(struct sockaddr_un, sun_path) + strlen() + 1
or something like that.
See https://bugzilla.kernel.org/show_bug.cgi?id=19812
Reported-by: Lennart Poettering <mzxreary@0pointer.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
As reported by Lennart Poettering:
The part about "abstract" sockets is misleading as it suggests
that the sockaddr returned by getsockname() would necessarily
have the size of sizeof(struct sockaddr), which however is not
the case: getsockname() returns exactly the sockaddr size that
was passed in on bind(). In particular, two sockets that are
bound to the same sockaddr but different sizes are completely
independent.
See https://bugzilla.kernel.org/show_bug.cgi?id=19812
Reported-by: Lennart Poettering <mzxreary@0pointer.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Several interfaces use this structure. Best to centralize the
common details in one place. Content taken from the existing
timerfd_create.2 and mq_open.3 pages, with additions by
Petr Baudis and Michael Kerrisk.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Move the text that notes the requirement that feature test macros
must be defined before including any header files to the top of
the page, and highlight the text further, so that the reader will
not miss this point.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
These pages specify feature test macros in the function
prototypes. Add a reference to feature_test_macros(7),
so that readers are pointed to the information that
feature test macros must be defined before including
*any* header file.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Programmers often make the mistake of including a feature test
macro only after having already included some header files.
This patch adds some text at opportune places to remind
programmers to do things the right way.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Octal and hexadecimal values are right, but there are some
off-by one errors in decimal values. Correct values are
printed by this command:
perl -pi -e 'if (s/^([0-7]+)\t([0-9]+)\t([0-9a-fA-F]+)//)
{printf "%03o\t%d\t%s", hex($3), hex($3), $3;};' man7/*.7
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Warn that FIONREAD can't can't distinguish case of a zero-length
datagram from the case where no datagrams are available.
Reported-by: Alexander E. Patrakov <patrakov@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Make a clearer statement that signal(2) is less portable for
establishing a signal handler.
Reported-by: Reuben Thomas <rrt@sc3d.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Clarify that this signal really is synonymous with SIGSYS.
See http://bugzilla.kernel.org/show_bug.cgi?id=14449
Reported-by: Garrett Cooper <yaneurabeya@yahoo.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
All definitions of the Epoch have been refactored to the following:
1970-01-01 00:00:00 +0000 (UTC)
That form is more consistent, logical, precise, and internationally
recognizable than the other variants.
Also, some wording has been altered as well.
Signed-off-by: Michael Witten <mfwitten@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
The tendency in English, as prescribed in style guides like
Chicago MoS, is towards removing hyphens after prefixes
like "multi-" etc.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
The tendency in English, as prescribed in style guides like
Chicago MoS, is towards removing hyphens after prefixes
like "re-" etc.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
The tendency in English, as prescribed in style guides like
Chicago MoS, is towards removing hyphens after prefixes
like "pre-" etc.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
The tendency in English, as prescribed in style guides like
Chicago MoS, is towards removing hyphens after prefixes
like "sub-" etc.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
The tendency in English, as prescribed in style guides like
Chicago MoS, is towards removing hyphens after prefixes
like "non-" etc.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
The tendency in English, as prescribed in style guides like
Chicago MoS, is towards removing hyphens after prefixes
like "non-" etc.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
The tendency in English, as prescribed in style guides like
Chicago MoS, is towards removing hyphens after prefixes
like "non-" etc.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
The tendency in English, as prescribed in style guides like
Chicago MoS, is towards removing hyphens after prefixes
like "non-" etc.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
The tendency in English, as prescribed in style guides like
Chicago MoS, is towards removing hyphens after prefixes
like "non-" etc.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
The tendency in English, as prescribed in style guides like
Chicago MoS, is towards removing hyphens after prefixes
like "non-" etc.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
The tendency in English, as prescribed in style guides like
Chicago MoS, is towards removing hyphens after prefixes
like "non-" etc.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
The tendency in English, as prescribed in style guides like
Chicago MoS, is towards removing hyphens after prefixes
like "non-" etc.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
The tendency in English, as prescribed in style guides like
Chicago MoS, is towards removing hyphens after prefixes
like "non-" etc.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
The tendency in English, as prescribed in style guides like
Chicago MoS, is towards removing hyphens after prefixes
like "non-" etc.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
The tendency in English, as prescribed in style guides like
Chicago MoS, is towards removing hyphens after prefixes
like "non-" etc.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>