Commit Graph

1210 Commits

Author SHA1 Message Date
Michael Kerrisk 82232e78e9 gettimeofday.2, ptrace.2, sigaction.2, aio_init.3, mpool.3, scandir.3, inotify.7, netdevice.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-26 09:12:59 +12:00
Michael Kerrisk 3a6548ffb0 tcp.7: Amend 84b183e
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>
2012-04-26 09:12:59 +12:00
Michael Kerrisk 4ba272b3e0 inotify.7: Note buffer size that guarantees being able to read at least one event
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-24 09:35:45 +12:00
James Hunt 655684a9d9 inotify.7: Correct description of size of inotify_event structure
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-24 09:33:57 +12:00
lepton 84b183e9f7 tcp.7: Correct description for TCP_MAXSEG on modern kernel
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>
2012-04-23 21:17:09 +12:00
Michael Kerrisk 42bd5b3db0 socket.7: Correct description of SO_BROADCAST
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>
2012-04-23 21:02:31 +12:00
Brian F. G. Bidulock c643e947f7 netdevice.7: Document some SIOC configuration ioctls
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>
2012-04-23 08:29:44 +12:00
Eugen Dedu 1463d77202 iso_8859-1.7: Add "-" for SOFT HYPHEN
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=156154

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-22 19:12:38 +12:00
Michael Kerrisk 24a690f714 locale.7: srcfix: Add FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-22 14:48:28 +12:00
Michael Kerrisk ffbe890768 div.3, mallopt.3, perror.3, epoll.7, ld.so.8: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-17 23:23:57 +12:00
Michael Kerrisk 50b5741877 Removed trailing white space at end of lines 2012-04-17 23:09:04 +12:00
Michael Kerrisk 1e4e3badf3 unix.7: Add a detail on autobind feature
Reported-by: Tetsuo Handa <penguin-kernel@i-love.sakura.ne.jp>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-17 23:09:04 +12:00
Michael Kerrisk ecc1f45b58 capabilities.7: Add prctl(PR_SET_MM) to CAP_SYS_RESOURCE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-15 12:56:14 +12:00
Michael Kerrisk 2b348e568f epoll.7: Some minor clarifications at start of DESCRIPTION
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-15 09:39:52 +12:00
Jeff Mahoney dfad7db9a2 netlink.7: Note cases where nonprivileged users can use netlink multicast groups
See also https://bugzilla.novell.com/show_bug.cgi?id=754611

Reported-by: Petr Gajdos <pgajdos@suse.cz>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-14 13:32:33 +12:00
Michael Kerrisk b2d0b0dab2 packet.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-25 07:39:16 +13:00
Michael Kerrisk 10968d61b8 tcp.7: Correct RFC for TIME_WAIT assassination hazards
Reported-by: Artyom Pervukhin <artyom@evasive.ru>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-20 06:18:13 +13:00
Michael Kerrisk 2bfe665643 capabilities.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-07 07:35:22 +13:00
Michael Kerrisk ed924588d8 packet.7: Fix comment on 'sll_hatype' field
Reported-by: Iain Fraser <iainkfraser@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-06 10:35:30 +13:00
Michael Kerrisk 88ea664e34 packet.7: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-06 10:31:07 +13:00
Michael Kerrisk aa66392d63 capabilities.7: Update CAP_SYS_RESOURCE with notes from include/linux/capability.h
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-06 08:45:57 +13:00
Michael Kerrisk d6b087086e capabilities.7: Add CAP_WAKE_ALARM
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-06 08:45:57 +13:00
Michael Kerrisk 0f322ccc46 capabilities.7: Add perf_event_open(2) to CAP_SYS_ADMIN
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-06 08:45:57 +13:00
Michael Kerrisk c11e38916f capabilities.7: Add VM86_REQUEST_IRQ vm86(2) command to CAP_SYS_ADMIN
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-06 08:45:52 +13:00
Michael Kerrisk c42221c4b7 capabilities.7: Add nfsservctl(2) to CAP_SYS_ADMIN
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-05 14:34:28 +13:00
Michael Kerrisk 1a3cde77e8 capabilities.7: Minor wording improvement in SEE ALSO
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-05 14:34:28 +13:00
Michael Kerrisk 93e9e2d6f2 capabilities.7: Update CAP_NET_RAW with notes from include/linux/capability.h
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-05 14:34:28 +13:00
Michael Kerrisk e87268ecb8 capabilities.7: Update CAP_NET_ADMIN with notes from include/linux/capability.h
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-05 14:34:28 +13:00
Michael Kerrisk b39a2012be capabilities.7: Add POSIX messages queues queues_max case to CAP_SYS_RESOURCE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-05 14:34:28 +13:00
Michael Kerrisk ad7b0f9185 capabilities.7: Add F_SETPIPE_SZ case to CAP_SYS_RESOURCE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-05 14:34:28 +13:00
Michael Kerrisk 46c73a4487 capabilities.7: srcfix: Added FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-05 14:34:27 +13:00
Michael Kerrisk 749ac7696e capabilities.7: Add virtual terminal ioctl()s under CAP_SYS_TTY_CONFIG
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-05 14:34:27 +13:00
Michael Kerrisk 474e1f9d1a capabilities.7: Add ioctl(FIBMAP) under CAP_SYS_RAWIO
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-05 14:34:27 +13:00
Michael Kerrisk aa26786894 capabilities.7: SEE ALSO: Add libcap(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-05 14:34:27 +13:00
Michael Kerrisk 0f807eeafc capabilities.7: Add various operations under CAP_SYS_ADMIN
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-05 14:34:27 +13:00
Michael Kerrisk ea22a037c6 feature_test_macros.7: Document _ISOC11_SOURCE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-01-18 14:21:03 +13:00
Michael Kerrisk 591b7a5f21 inotify.7: Note that 'cookie' field is set to zero when unused
Reported-by: Yang Yang <wdscxsj@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-12-07 07:19:58 +01:00
Michael Kerrisk a1712680c4 man.7: Various fixes for description of NAME section
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>
2011-10-05 08:10:43 +02:00
Michael Kerrisk 41acdb62c9 Changes, setns.2, stat.2, proc.5, capabilities.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-10-04 08:32:21 +02:00
Michael Kerrisk 5503c85ea4 intro.1, fork.2, futex.2, open.2, rename.2, select_tut.2, semop.2, spu_create.2, stat.2, netlink.3, random.3, scanf.3, shm_open.3, strftime.3, console.4, console_codes.4, sk98lin.4, st.4, bootparam.7, cpuset.7, credentials.7, man-pages.7, path_resolution.7, uri.7: Global fix: remove spaces around em-dash
Normal English typographical convention is not to have
spaces around em dashes.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-10-03 08:47:35 +02:00
Michael Kerrisk e4698850d1 capabilities.7: List setns(2) as an operation allowed by CAP_SYS_ADMIN
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-10-03 08:36:41 +02:00
Michael Kerrisk 836830b4c9 readlink.2, getsubopt.3, termcap.5, tzfile.5, unix.7: srcfix: change single quote to "\(aq"
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-28 04:56:17 +02:00
Michael Kerrisk 4e83614439 clock_getres.2, clone.2, mbind.2, set_mempolicy.2, atan2.3, getipnodebyname.3, ilogb.3, lgamma.3, elf.5, capabilities.7, math_error.7: srcfix: Remove double space
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-27 05:17:10 +02:00
Michael Kerrisk 776b81f6cb ip.7: Mnor fixes
Reported-by: Benjamin Poirier <benjamin.poirier@gmail.com>
Reported-by: Neil Horman <nhorman@tuxdriver.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-23 07:25:34 +02:00
Michael Kerrisk b18e759d8c fstatat.2, rt_sigqueueinfo.2, sendfile.2, hsearch.3, matherr.3, rtld-audit.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-23 07:11:27 +02:00
Benjamin Poirier 8341e3a766 ip.7: Improve description of IP_MTU_DISCOVER
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>
2011-09-22 06:08:30 +02:00
Michael Kerrisk 4023450d6c ipv6.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-22 05:58:54 +02:00
Michael Kerrisk 9458d0daac ip.7: Minor fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-22 05:42:02 +02:00
Michael Kerrisk 23038eae08 signal.7: SEE ALSO: Add rt_sigqueueinfo(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-19 17:32:54 +02:00
Michael Kerrisk 485ab7013e getrlimit.2, kill.2, rt_sigqueueinfo.2, sigaction.2, signal.2, signalfd.2, sigprocmask.2, sigwaitinfo.2, psignal.3, pthread_sigqueue.3, credentials.7, signal.7: Change reference to "sigqueue(2)" to "sigqueue(3)"
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-19 17:32:53 +02:00