Ready for 3.45

Removed trailing white space at end of lines

wait.2, ttyname.3, undocumented.3:  tstamp

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

Changes: Ready for 3.45

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

sysctl.2: Mention CONFIG_SYSCTL_SYSCALL

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

sysctl.2: Calls to sysctl() log warnings to the kernel log since 2.6.24

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

recv.2: UNIX domain sockets support MSG_TRUNC since 3.4

Reported-by: Eric Dumazet <eric.dumazet@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

mkstemp.3: Deemphasize discussion of mode 066 in glibc 2.0.6

Glibc 2.0.6 is now so ld that the discussion of details
of that version can be deemphasized placing just under
NOTES.

See https://bugzilla.kernel.org/show_bug.cgi?id=51811

Reported-by: Florian Weimer <fweimer@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

elf.5: tfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

syscalls.2: Update various references to "i386" to "x86"

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

fallocate.2: srcfix: Affed FIXME

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

sysconf.3, cciss.4: Global fix: s/runtime/run time/

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

s390_runtime_instr.2: Minor fixes fo Jan's page

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

s390_runtime_instr.2: New page for s390-specific s390_runtime_instr(2)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

ipv6.7: Minor fix to Gao Feng's patch

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

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>

syscalls.2: Add s390_runtime_instr(2)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

sendmmsg.2: Minor fix-ups for Elie De Brauwer's patch

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

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>

ipv6.7: srcfix: Added/updated FIXMEs

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

ip.7: srcfix: Added/updated FIXMEs

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

tcp.7: srcfix: Added/updated FIXMEs

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

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>

socket.7: srcfix: updated FIXMEs

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

if_indextoname.3: New link to if_nametoindex.3:

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

if_nametoindex.3: Minor fixes

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

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>

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>

undocumented.3: Remove some now documented functions

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

if_nameindex.3: Add an example program

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

if_nameindex.3:  Edits, improvements and corrections to Hideaki's page

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

if_freenameindex.3: New link to if_nameindex.3

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

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>

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>

unshare.2: srcfix: Added FIXME

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

gettimeofday.2: srcfix: Added FIXME

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

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>

syslog.2: Add mention of CONFIG_LOG_BUF_SHIFT

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

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>

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>

syslog.2: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

syslog.2: Clarify where SYSLOG_ACTION_READ_ALL places data it reads

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

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>

syslog.2: Clarify discussion of privileges for commands 3 and 10

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

syslog.2: Add kernel symbolic 'type' names

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

exec.3: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

wait.2: BUGS: Document odd waitid() behavior when 'infop' is NULL

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

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>

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>

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>

proc.5: Note change of /proc/[pid]/limits file permissions in 2.6.36

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

getrlimit.2: Point reader at discussion of /proc/[pid]/limits in proc(5)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

ipc.2: tfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

rpc.3: ffix

fopen.3: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

confstr.3: ffix

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>

proc.5: tfix

Reported-by: Jim Paris <jim@jtan.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

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>

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>

rtnetlink.7: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

resolv.conf.5: Document IPv6 format for nameserver

See: http://bugs.debian.org/610036
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

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>

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>

io_getevents.2: io_getevents() may cause segfault when called with invalid ctx_id

For reference see: http://marc.info/?l=linux-aio&m=130089887002435&w=2

Signed-off-by: Cyril Hrubis <chrubis@suse.cz>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

getauxval.3: tfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

prctl.2: wfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

socket.7: Explain effect of SO_SNDTIMEO for connect()

When SO_SNDTIMEO is set before connect(), then connect()
may return EWOULDBLOCK when the timeout fires.

Signed-off-by: Andi Kleen <ak@linux.intel.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

ld.so.8: tfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

getenv.3: tfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

ptrace.2: tfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

time.7: spfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

delete_module.2: Small rewording of description of effect of O_TRUNC

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

delete_module.2: tfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

Start of man-pages-3.45: updating Changes and Changes.old

Start of man-pages-3.45: updating .Announce and .lsm files

Start of man-pages-3.45: renaming .Announce and .lsm files

Ready for 3.44

Removed trailing white space at end of lines

clock_getres.2, clock_nanosleep.2, ipv6.7: tstamp

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

Changes: Ready for 3.44

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

init_module.2: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

ipc.2: tfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

delete_module.2: spfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

getenv.3: SEE ALSO: add getauxval(3)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

ld.so.8: SEE ALSO: add getauxval(3)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

getauxval.3: Document getauxval() function added in glibc 2.16

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

proc.5: tfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

proc.5: Minor fixes

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

proc.5: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

ipv6.7: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

clock_getres.2, clock_nanosleep.2: Linking with -lrt is no longer needed from glibc 2.17 onward

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

clock_getcpuclockid.3: Linking with -lrt is no longer needed from glibc 2.17 onward

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

time.7: Add a subsection on timer slack

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

proc.5: Default for /proc/sys/fs/protected_{hardlinks,symlinks} is now 0

The default setting of 1 in/proc/sys/fs/protected_hardlinks
and /proc/sys/fs/protected_symlinks caused one too many
breakages for Linus's taste, so commit 561ec64ae67e changed
the default for both files to 0.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

fork.2: Note treatment of default timer slack value on fork()

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

prctl.2: Document PR_SET_TIMERSLACK and PR_GET_TIMERSLACK

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

execve.2: Document treatment of SECBIT_KEEP_CAPS securebits flag on execve()

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

execve.2: Document treatment of PR_SET_PDEATHSIG on execve()

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

prctl.2: tfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>