Commit Graph

8207 Commits

Author SHA1 Message Date
Michael Kerrisk 2970eb3bb4 ipv6.7: Minor fix to Gao Feng's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-12-17 22:01:22 +01:00
Gao Feng 032e1ba5c0 ipv6.7: Add description of getsockopt() for IPV6_MTU
In IPv4,IP_MTU is only supported by getsockopt.
In IPv6, we can use IPV6_MTU to set socket's MTU,
but the return value of getsockopt() is the path MTU.

Signed-off-by: Gao feng <gaofeng@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-12-17 20:15:06 +01:00
Michael Kerrisk 993d1ce33e syscalls.2: Add s390_runtime_instr(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-12-17 20:15:06 +01:00
Michael Kerrisk 821e74fad4 sendmmsg.2: Minor fix-ups for Elie De Brauwer's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-12-17 20:15:01 +01:00
Elie De Brauwer daf3eb0c70 sendmmsg.2: Add example program for sendmmsg()
The example uses sendmmsg() to send out a string "onetwo"
on a first datagram, where both halves originate from
distinct buffers and a second datagram contains "three",
coming from a single buffer.

Tested with netcat listening:
root@ubuntu:~# nc -l -u -p 1234
onetwothree

And tcpdump peeking:
root@ubuntu:~# tcpdump -c 2 -s 0 -X -ni lo tcpdump: verbose output suppressed, use -v or -vv for full protocol decode
listening on lo, link-type EN10MB (Ethernet), capture size 65535 bytes
18:45:16.632134 IP 127.0.0.1.34715 > 127.0.0.1.1234: UDP, length 6
     0x0000:  4500 0022 c21c 4000 4011 7aac 7f00 0001  E.."..@.@.z.....
     0x0010:  7f00 0001 879b 04d2 000e fe21 6f6e 6574  ...........!onet
     0x0020:  776f                                     wo
18:45:16.633267 IP 127.0.0.1.34715 > 127.0.0.1.1234: UDP, length 5
     0x0000:  4500 0021 c21d 4000 4011 7aac 7f00 0001  E..!..@.@.z.....
     0x0010:  7f00 0001 879b 04d2 000d fe20 7468 7265  ............thre
     0x0020:  65                                       e
2 packets captured
4 packets received by filter
0 packets dropped by kernel

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-12-15 19:18:26 +01:00
Michael Kerrisk c6a7484a2d ipv6.7: srcfix: Added/updated FIXMEs
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-12-15 19:18:26 +01:00
Michael Kerrisk f645fea8c0 ip.7: srcfix: Added/updated FIXMEs
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-12-15 19:18:26 +01:00
Michael Kerrisk 08df16d409 tcp.7: srcfix: Added/updated FIXMEs
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-12-15 19:18:19 +01:00
Michael Kerrisk b1b84b7a5c socket.7: Document 'sockaddr' and 'sockaddr_storage' types
Reported-by: YOSHIFUJI Hideaki <yoshfuji@linux-ipv6.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-12-15 19:17:48 +01:00
Michael Kerrisk 8cd5dce111 socket.7: srcfix: updated FIXMEs
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-12-14 18:25:20 +01:00
Michael Kerrisk 12770b9757 if_indextoname.3: New link to if_nametoindex.3:
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-12-14 17:49:05 +01:00
Michael Kerrisk e8a16dbb96 if_nametoindex.3: Minor fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-12-14 17:49:05 +01:00
YOSHIFUJI Hideaki 2a5e7b351f if_nametoindex.3: New page documenting if_nametoindex(3) and if_indextoname(3)
References:
    RFC 3542

    POSIX Man Page Set
        http://www.unix.com/man-page/POSIX/3posix/if_indextoname
        http://www.unix.com/man-page/POSIX/3posix/if_nametoindex

    OS X Developer Tools Manual Page
        http://developer.apple.com/library/mac/#documentation/Darwin/Reference/Manpages/man3/if_nameindex.3.html

    Source: sysdeps/unix/sysv/linux/{if_index.c,ifaddrs.c}

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-12-14 17:48:58 +01:00
Michael Kerrisk f2b5a96993 if_nameindex.3: Fix printf() specifier in example program
Reported-by: YOSHIFUJI Hideaki <yoshfuji@linux-ipv6.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-12-14 17:48:57 +01:00
Michael Kerrisk 08afc5acf2 undocumented.3: Remove some now documented functions
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-12-14 17:48:57 +01:00
Michael Kerrisk 8b931bbdc4 if_nameindex.3: Add an example program
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-12-14 17:48:57 +01:00
Michael Kerrisk 7fd06e7dd4 if_nameindex.3: Edits, improvements and corrections to Hideaki's page
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-12-14 17:48:57 +01:00
Michael Kerrisk a54e254c41 if_freenameindex.3: New link to if_nameindex.3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-12-14 17:48:57 +01:00
YOSHIFUJI Hideaki 79bfe3d8cf if_nameindex.3: Document if_nameindex(3) and if_freenameindex(3)
References:
    RFC 3542

    POSIX Man Page Set
        http://www.unix.com/man-page/POSIX/3posix/if_indexname
        http://www.unix.com/man-page/POSIX/3posix/if_freeindexname

    OS X Developer Tools Manual Page
    http://developer.apple.com/library/mac/#documentation/Darwin/Reference/Manpages/man3/if_nameindex.3.html

    Source: sysdeps/unix/sysv/linux/{if_index.c,ifaddrs.c}

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-12-14 17:48:48 +01:00
Michael Kerrisk 6455a3f2c6 capabilities.7: Correct URL for POSIX.1e draft
Reported-by: Rens van der Heijden <rens.vanderheijden@uni-ulm.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-12-09 11:26:50 +01:00
Michael Kerrisk f26fe082b4 unshare.2: srcfix: Added FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-12-05 17:21:14 +01:00
Michael Kerrisk f70f94e84d gettimeofday.2: srcfix: Added FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-12-04 12:41:30 +01:00
Michael Kerrisk 89f54905a0 clone.2: Since 2.6.30, CLONE_NEWIPC also supports POSIX message queues
See kernel commit 7eafd7c74c3f2e67c27621b987b28397110d643f

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-11-30 11:02:49 +01:00
Michael Kerrisk f766e43c28 syslog.2: Add mention of CONFIG_LOG_BUF_SHIFT
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-11-29 15:51:22 +01:00
Michael Kerrisk 0adbf43a03 syslog.2: Clarify SYSLOG_ACTION_SIZE_UNREAD semantics
SYSLOG_ACTION_SIZE_UNREAD returns the number of bytes
available for reading via SYSLOG_ACTION_READ.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-11-29 15:51:22 +01:00
Michael Kerrisk 7fc3d0580b syslog.2: Clarify semantics of SYSLOG_ACTION_CLEAR
The SYSLOG_ACTION_CLEAR command (5) does not really clear
the ring buffer; rather it affects the semantics of what
is returned by commands 3 (SYSLOG_ACTION_READ_ALL) and
4 (SYSLOG_ACTION_READ_CLEAR).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-11-29 15:51:22 +01:00
Michael Kerrisk 70a259dcd5 syslog.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-11-28 14:42:27 +01:00
Michael Kerrisk 55ed5fceec syslog.2: Clarify where SYSLOG_ACTION_READ_ALL places data it reads
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-11-28 14:42:27 +01:00
Michael Kerrisk 1850e19a35 syslog.2: Substantially reorganize discussion of commands
Make the layout if the discussion of the commands
more readable.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-11-28 14:42:27 +01:00
Michael Kerrisk 9f924d1702 syslog.2: Clarify discussion of privileges for commands 3 and 10
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-11-28 12:04:14 +01:00
Michael Kerrisk e4a952a1a9 syslog.2: Add kernel symbolic 'type' names
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-11-28 11:53:10 +01:00
Mike Frysinger 784a11da36 exec.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-11-27 08:35:34 +01:00
Michael Kerrisk 00a1fbcfc4 wait.2: BUGS: Document odd waitid() behavior when 'infop' is NULL
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-11-27 07:49:59 +01:00
Michael Kerrisk 1113a8fcc1 strcmp.3: Enhance RETURN VALUE text and remove redundant text from DESCRIPTION
Note that sign of result equals sign of difference between
first two bytes that differ (treated as "unsigned char")."

Reported-by: Jon Grant <jg@jguk.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-11-27 07:49:59 +01:00
Michael Kerrisk 3b5b9fd8b5 memcmp.3: Enhance RETURN VALUE text and remove redundant text from DESCRIPTION
Note that sign of result equals sign of difference between
first two bytes that differ (treated as "unsigned char")."

Reported-by: Jon Grant <jg@jguk.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-11-27 07:49:59 +01:00
Michael Kerrisk 27bada1fa1 getrlimit.2: Document Linux's nonstandard treatment or RLIMIT_CPU soft limit
Upon encountering the RLIMIT_CPU soft limit when a SIGXCPU handler
has been installed, Linux invokes the signal handler *and* raises
the soft limit by one second. This behavior repeats until the
limit is encountered.  No other implementation that I tested
(Solaris 10, FreeBSD 9.0, OpenBSD 5.0) does this, and it seems
unlikely to be POSIX-conformant. The (Linux-specific)
RLIMIT_RTTIME soft limit exhibits similar behavior.

Reported-by: Trevor Woerner <twoerner@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-11-27 07:49:59 +01:00
Michael Kerrisk e1282f176c proc.5: Note change of /proc/[pid]/limits file permissions in 2.6.36
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-11-24 09:14:31 +01:00
Michael Kerrisk 6d0620d865 getrlimit.2: Point reader at discussion of /proc/[pid]/limits in proc(5)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-11-24 09:08:04 +01:00
Thierry Vignaud b8d5a242bf ipc.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-11-22 05:38:06 +01:00
Michael Kerrisk 4fb45673f8 rpc.3: ffix 2012-11-16 13:07:29 +01:00
Michael Kerrisk 2ff4446136 fopen.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-11-16 13:06:31 +01:00
Michael Kerrisk 06f38b2f30 confstr.3: ffix 2012-11-16 13:05:49 +01:00
Michael Kerrisk c16d4f25c7 proc.5: Correct description of SwapFree in /proc/meminfo
Reported-by: Jim Paris <jim@jtan.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-11-16 07:58:27 +01:00
Michael Kerrisk 46fbfc072b proc.5: tfix
Reported-by: Jim Paris <jim@jtan.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-11-16 07:28:27 +01:00
Michael Kerrisk bbeb81bdf3 getifaddrs.3: Update description of ifa_data to Linux 2.6+ reality
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=526778

Reported-by: Julien Cristau <jcristau@debian.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-11-11 13:02:28 +01:00
Michael Kerrisk 3036baf00e rtnetlink.7: Update description of IFLA_STATS to Linux 2.6+ reality
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=526778

Reported-by: Julien Cristau <jcristau@debian.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-11-11 13:01:19 +01:00
Michael Kerrisk 94c0ab851a rtnetlink.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-11-11 12:58:41 +01:00
Simon Paillard b1171e214e resolv.conf.5: Document IPv6 format for nameserver
See: http://bugs.debian.org/610036
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-11-11 12:08:29 +01:00
Michael Kerrisk 4bcf05347c ttyname.3: Fix confused text in ERRORS
The existing text suggested that the ERRORS applied
only for ttyname_r(). However, 2 of the 3 errors
can occur for ttyname().

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-11-11 11:57:30 +01:00
Simon Paillard fec75159e1 stat.2: Clarify description of EOVERFLOW error
The EOVERFLOW error is not only for st_size, but also
inode and block size fields. See glibc source file
sysdeps/unix/sysv/linux/xstatconv.c and kernel source
file fs/stat.c. Also, fix bit/byte confusion
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=604928

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-11-11 11:40:23 +01:00