diff -Nru manpages-4.04/Changes manpages-4.05/Changes --- manpages-4.04/Changes 2015-12-29 12:51:43.000000000 +0000 +++ manpages-4.05/Changes 2016-03-15 03:47:38.000000000 +0000 @@ -1,6 +1,6 @@ -==================== Changes in man-pages-4.04 ==================== +==================== Changes in man-pages-4.05 ==================== -Released: 2015-12-29, Munich +Released: 2015-03-15, Munich Contributors @@ -10,41 +10,76 @@ in the changelog below) reports, notes, and ideas that have been incorporated in changes in this release: -Alexander Monakov -Andries E. Brouwer -Archie Cobbs +Adhemerval Zanella +Akihiro Suda +Alan Aversa +Alan Cox +Alec Leamas +Alex Henrie +Alexander Miller +Andreas Gruenbacher +Andreas Schwab +Anna Schumaker +Askar Safin +Bill O. Gallmeister Carlos O'Donell -Colin Rice -Darren Hart +Chris Pick +Christoph Hellwig +Craig Gallek +Darrick J. Wong Davidlohr Bueso Dmitry V. Levin -Eric B Munson +Dr. Tobias Quathamer +Eric Blake +Eric Dumazet +Florian Weimer +Gabriel Corona Heinrich Schuchardt -H.J. Lu +Ivan Shapovalov Jakub Wilk -Jonathan Wakely -Jonny Grant -Laurent Georget -Lennart Poettering -Mathieu Desnoyers -Michael Kerrisk -Michal Hocko +Jason Baron +Jason Vas Dias +Jérémie Galarneau +Jeremy Harris +Joachim Wuttke +Joe Stein +John Stultz +Josh Triplett +Kondo, Naoya +Krzysztof Adamski +Manfred Spraul +Marianne CHEVROT +Marko Myllynen +Mark Post +Martin Gebert +Mats Wichmann +Matt Zimmerman +Michael Kerrisk ` Mike Frysinger -Pádraig Brady +Minchan Kim +Naoya Kondo +Naresh Kamboju +Nikola Forró +Nikos Mavrogiannopoulos +Orion Poplawski +Pakin Yury +Patrick Donnelly Paul Eggert -Pavel Machek -Phil Blundell -Richard Voigt -Rich Felker -Rusty Russell -Thomas Gleixner -Tom Gundersen -Torvald Riegel -Vincent Lefevre -Vlastimil Babka -Walter Harms -Zack Weinberg - +Paul Pluzhnikov +Peter Hurley +Peter Wu +Petr Gajdos +Philip Semanchuk +Rasmus Villemoes +Rich Felker +Simon Que +Stephan Bergmann +Stéphane Aulery +Stephen Hurd +Vincent Bernat +William Preston +Yuri Kozlov +Zefram Apologies if I missed anyone! @@ -52,29 +87,163 @@ New and rewritten pages ----------------------- -futex.2 - Michael Kerrisk, Thomas Gleixner, Torvald Riegel [Davidlohr Bueso, Heinrich Schuchardt, Darren Hart, Rusty Russell, Pavel Machek, Rich Felker] - Rewrite and massively expand page +copy_file_range.2 + Anna Schumaker [Darrick J. Wong, Christoph Hellwig, Michael Kerrisk] + New page documenting copy_file_range() + copy_file_range() is a new system call for copying ranges of data + completely in the kernel. This gives filesystems an opportunity to + implement some kind of "copy acceleration", such as reflinks or + server-side-copy (in the case of NFS). + +personality.2 + Michael Kerrisk + This page has been greatly expanded, to add descriptions of + personality domains. + +ntp_gettime.3 + Michael Kerrisk + New page describing ntp_gettime(3) and ntp_gettimex(3) -membarrier.2 - Mathieu Desnoyers [Michael Kerrisk] - New page documenting membarrier() system call +lirc.4 + Alec Leamas + New page documenting lirc device driver Newly documented interfaces in existing pages --------------------------------------------- -mlock.2 - Eric B Munson [Michal Hocko, Vlastimil Babka, Michael Kerrisk] - Document mlock2(2) and MCL_ONFAULT +adjtimex.2 + Michael Kerrisk + Document ntp_adjtime(3) + +epoll_ctl.2 + Michael Kerrisk [Jason Baron] + Document EPOLLEXCLUSIVE + +ioperm.3 + Michael Kerrisk [Alex Henrie] + ioperm.2: Permissions are inherited across fork(2) + See https://bugzilla.kernel.org/show_bug.cgi?id=99911 + +iopl.2 + Michael Kerrisk [Alex Henrie] + Permissions are not inherited across fork(2) or preserved on execve(2) + See https://bugzilla.kernel.org/show_bug.cgi?id=99901 + +madvise.2 + Minchan Kim [Michael Kerrisk] + Document MADV_FREE + Document the MADV_FREE flag added to madvise() in Linux 4.5. + +fmemopen.3 + Michael Kerrisk [Adhemerval Zanella] + Significant reworking of this page: + * Rework discussion of the (obsolete) binary mode + * Split open_memstream(3) description into a separate page. + * Note various fmemopen() bugs that were fixed in glibc 2.22 + * Greatly expand description of 'mode' argument + * Rework description of 'buf' and 'len' arguments + * Expand discussion of "current position" for fmemopen() stream + +open_memstream.3 + Michael Kerrisk + New page created by split of fmemopen(3). + At the same time, add and rework a few details in the text. + +posix_spawn.3 + Bill O. Gallmeister, Michael Kerrisk + New man page documenting posix_spawn(3) and posix_spawnp(3) + +readdir.3 + Michael Kerrisk [Florian Weimer] + Split readdir_r() content into separate page + As suggested by Florian Weimer: + + It may make sense to move this documentation to a separate + manual page, specific to readdir_r. This will keep the + readdir() documentation nice and crisp. Most programmers + will never have to consult all these details. + Michael Kerrisk + Near complete restructuring of the page and add some further details + Michael Kerrisk [Florian Weimer, Rich Felker, Paul Eggert] + Add a lot more detail on portable use of the 'd_name' field + +readdir_r.3 + Michael Kerrisk [Florian Weimer] + New page created after split of readdir(3). + Michael Kerrisk [Florian Weimer] + Explain why readdir_r() is deprecated and readdir() is preferred + Michael Kerrisk [Florian Weimer] + Remove misleading code example using pathconf() + +proc.5 + Michael Kerrisk + Document CmaTotal and CmaFree fields of /proc/meminfo + Michael Kerrisk + Document additional /proc/meminfo fields + Document DirectMap4k, DirectMap4M, DirectMap2M, DirectMap1G + Michael Kerrisk + Document MemAvailable /proc/meminfo field + Michael Kerrisk + Document inotify /proc/PID/fdinfo entries + Michael Kerrisk + Document fanotify /proc/PID/fdinfo entries + Michael Kerrisk + Add some kernel version numbers for /proc/PID/fdinfo entries + Michael Kerrisk [Patrick Donnelly] + /proc/PID/fdinfo displays the setting of the close-on-exec flag + Note also the pre-3.1 bug in the display of this info. + +socket.7 + Craig Gallek [Michael Kerrisk, Vincent Bernat] + Document some BPF-related socket options + Document the behavior and the first kernel version for each of the + following socket options: + + SO_ATTACH_FILTER + SO_ATTACH_BPF + SO_ATTACH_REUSEPORT_CBPF + SO_ATTACH_REUSEPORT_EBPF + SO_DETACH_FILTER + SO_DETACH_BPF + SO_LOCK_FILTER New and changed links --------------------- -mlock2.2 - Eric B Munson - New link to mlock.2 +isalpha_l.3 + Michael Kerrisk + New link to isalpha.3 + +longjmp.3 + Michael Kerrisk + Replace page with link to setjmp(3), which now incorporates longjmp() + +ntp_adjtime.3 + Michael Kerrisk + New link to adjtimex(2) + +ntp_gettimex.3 + Michael Kerrisk + New link to ntp_gettime.3 + +open_wmemstream.3 + Michael Kerrisk + Update link to point to new open_memstream(2) page + +posix_spawnp.3 + Michael Kerrisk + New link to new posix_spawn.3 page + +siglongjmp.3 + Michael Kerrisk + Rewire link to point to setjmp(3) + +strerror_l.3 + Michael Kerrisk + New link to strerror.3 + Fix missing link Global changes @@ -82,162 +251,795 @@ Various pages Michael Kerrisk - ERRORS: standardize text for EMFILE error + Update FTM requirements (_DEFAULT_SOURCE) + Michael Kerrisk + Update feature test macro requirements + Update to use _DEFAULT_SOURCE, and also changes brought by + glibc commit 266865c0e7b79d4196e2cc393693463f03c90bd8. + +Various pages + Michael Kerrisk + Simplify FTM requirements + Looking at (or feature_test_macros(7)), one can + see that when _XOPEN_SOURCE is defined with the value 700 + (or greater), then _POSIX_C_SOURCE is defined with the value + 200809L (or greater). Therefore, terms in the man pages such as + + _XOPEN_SOURCE\ >=\ 700 || _POSIX_C_SOURCE\ >=\ 200809L + + can be simplified to: + + _POSIX_C_SOURCE\ >=\ 200809L + +Various pages + Michael Kerrisk + Simplify FTM requirements + Looking at (or feature_test_macros(7)), one can + see that when _XOPEN_SOURCE is defined with the value 600 + (or greater), then _POSIX_C_SOURCE is defined with the value + 200112L (or greater). Therefore, terms in the man pages such as + + _XOPEN_SOURCE\ >=\ 600 || _POSIX_C_SOURCE\ >=\ 200112L + + can be simplified to: + + _POSIX_C_SOURCE\ >=\ 200112L + +Various pages + Michael Kerrisk + Simplify FTM requirements + _XOPEN_SOURCE implies _POSIX_C_SOURCE >=2, so simplify FTM + requirements in various pages. + +Various pages + Michael Kerrisk + Remove "or 'cc -std=c99'" from SYNOPSIS + Under the FTM requirements all of these pages document the + requirement for _ISOC99_SOURCE. And feature_test_macros(7) now + documents that "cc -std=c99" produces the same effect as defining + _ISOC99_SOURCE. So, all of these pages don't additionally need + to specify "or 'cc -std=c99'" under the FTM requirements + in the SYNOPSIS. Removing that redundant text also simplifies + the SYNOPSIS a little. + +Various pages + Michael Kerrisk + Simplify FTM requirements + Looking at (or feature_test_macros(7)), one can + see that when _XOPEN_SOURCE is defined with the value 600 + (or greater), then _POSIX_C_SOURCE is defined with the value + 200112L (or greater). Therefore, terms in the man pages such as + + _XOPEN_SOURCE\ >=\ 600 || _POSIX_C_SOURCE\ >=\ 200112L + + can be simplified to: + + _POSIX_C_SOURCE\ >=\ 200112L + +Various pages + Michael Kerrisk + Remove references to _XOPEN_SOURCE_EXTENDED in SYNOPSIS + _XOPEN_SOURCE_EXTENDED is obsolete (it existed in SUSv1, but not + subsequent standards). _XOPEN_SOURCE >= 500 produces the same + effects as (_XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED). Modifying + the SYNOPSIS of various ages that contain: + + _XOPEN_SOURCE\ >=\ 500 || + _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED + + to just: + + _XOPEN_SOURCE\ >=\ 500 + + This has the following benefits: + + a) Simplifying the SYNOPSIS by removing ancient + historical information. + + b) Preventing users from being misled into using + _XOPEN_SOURCE_EXTENDED in new source code. + +Various pages + Michael Kerrisk + Remove mention of the obsolete _POSIX_SOURCE macro from SYNOPSIS + _POSIX_SOURCE was a POSIX.1-1990 creation that was soon made + obsolete bu _POSIX_C_SOURCE. Retaining mention of it + in the feature test macro requirements section of the + SYNOPSIS doesn't contain important information, and may + mislead readers into actually trying to use this macro. + A few mentions of it are maintained in a some pages where + defining _POSIX_SOURCE inhibits some behavior. + +Various sockets-related pages + Michael Kerrisk [Carlos O'Donell] + Use consistent argument/variable names for socket addresses and lengths + As noted by Carlos, there's quite a bit of inconsistency across + pages. Use 'addr' and 'addrlen' consistently in variables and + function arguments. Various pages Michael Kerrisk - ERRORS: standardize error text for ENOTSOCK error + Wording fix: "current file offset" ==> "file offset" + "File offset" is the preferred POSIX terminology. Various pages Michael Kerrisk - ERRORS: standardize text for ENFILE error + Word "descriptor" more precisely + Use either "file descriptor" or message queue descriptor". + +Various pages + Michael Kerrisk + ERRORS: add reference to signal(7) in description of EINTR Changes to individual pages --------------------------- -clock_getres.2 +locale.1 + Marko Myllynen + Add "locale -c charmap" as an example + Addresses https://bugzilla.kernel.org/show_bug.cgi?id=104511. + +localedef.1 + Marko Myllynen + Add hint on purpose of --no-archive + Indicate why using --no-archive might be a good idea. The issue + is that if you create a custom locale with localedef(1) and put + it to the locale archive then during the next glibc upgrade the + locale archive is updated as well and your custom locale is gone.) + +accept.2 + Michael Kerrisk + ERRORS: improve description for EBADF + +adjtimex.2 + Michael Kerrisk [John Stultz] + Various improvements after feedback from John Stultz + Michael Kerrisk + Remove FTM requirements + It seems that adjtimex() never needed _BSD_SOURCE (and my + earlier commit 5918743bc8b02b was simply a blunder). + Michael Kerrisk + Split EINVAL error cases + Michael Kerrisk + Note treatment of out-of-range buf.offset + Michael Kerrisk + Don't refer reader to adjtime(3) + Probably, it's not wise to suggest adjtime(3) as the more + portable API. Rather, ntp_adjtime(3) should be used. + Michael Kerrisk [Naresh Kamboju] + Update details of buf.offset EINVAL error + Michael Kerrisk + SEE ALSO: add ntp_gettime(3) + Michael Kerrisk + Improve description of some PPS timex fields + Michael Kerrisk + Add ATTRIBUTES section + William Preston [Petr Gajdos] + Update a detail in adjtimex return value description + Michael Kerrisk + Note range constraints and clamping for ADJ_FREQUENCY + +bdflush.2 + Michael Kerrisk + Note that glibc support for this system call went away in version 2.23 + +bind.2 + Michael Kerrisk + Improve description of ENOENT error + +bpf.2 + Michael Kerrisk + Document close-on-exec semantics + The close-on-exec file descriptor flag is automatically enabled + for FDs returned by bpf(). + +chmod.2 Michael Kerrisk - SEE ALSO: add vdso(7) + Clarify terminology (file mode versus file permission bits) -epoll_create.2 +chown.2 Michael Kerrisk - ERRORS: add another EMFILE error case + ERRORS: improve EBADF description + +clone.2 +unshare.2 + Michael Kerrisk + Remove mention of _BSD_SOURCE and _SVID_SOURCE + The right way to expose declarations for these Linux-specific + system calls was always _GNU_SOURCE. Mentioning the historical + use of _BSD_SOURCE and _SVID_SOURCE just clouds the issue. + +connect.2 + Michael Kerrisk + ERRORS: improve EBADF description + +create_module.2 + Michael Kerrisk + Glibc 2.23 removed last vestiges of support for this system call + +delete_module.2 + Michael Kerrisk + Glibc 2.23 removed last vestiges of support for this system call + +epoll_ctl.2 + Michael Kerrisk + Document ELOOP error for circular monitoring loops + +eventfd.2 + Michael Kerrisk + Note that eventfd info is available in /proc/PID/fdinfo + +execve.2 + Michael Kerrisk [Krzysztof Adamski] + Add EPERM error for capabilities check of capability-dumb binaries + Michael Kerrisk + Add reference to ld-linux.so(8) + Michael Kerrisk + SEE ALSO: add system(3) fanotify_init.2 Michael Kerrisk - ERRORS: add an EMFILE error case + Note kernel version that allowed O_CLOEXEC for event_f_flags -fork.2 +fcntl.2 +flock.2 Michael Kerrisk - Child of MT-process is restricted to async-signal-safe functions + SEE ALSO: add lslocks(8) -getcpu.2 +fcntl.2 + Michael Kerrisk [Jason Vas Dias] + Rework description of F_SETOWN + As suggested by Jason, make it clearer that I/O signalling + requires the use of both F_SETOWN and O_ASYNC. While we're at, + make a few other cleanups to the text. + Michael Kerrisk + Remove mention of _BSD_SOURCE to get definition of F_SETOWN/F_GETOWN + This usage went away in glibc 2.20, and the simplest remedy + is just to omit mention of it. + +futex.2 Michael Kerrisk - SEE ALSO: add vdso(7) + FUTEX_CLOCK_REALTIME can now be used with FUTEX_WAIT -getrlimit.2 - Michael Kerrisk [Lennart Poettering] - The init of measurement for RLIMIT_RSS is bytes, not pages +get_kernel_syms.2 + Michael Kerrisk + Note that glibc des not support this system call -get_robust_list.2 +init_module.2 Michael Kerrisk - Reword EINVAL error text + Glibc 2.23 removed last vestiges of support for this system call + +ioctl_list.2 + Heinrich Schuchardt + Include uapi/linux/wireless.h + Add the list of wireless IOCTLs. + Heinrich Schuchardt + Path to sockios.h + sockios.h is now in include/uapi + Heinrich Schuchardt + Add reference to netdevice.7 + netdevice.7 describes most of the IOCTLs of sockios.h + Heinrich Schuchardt + Transfer structure (wireless.h IOCTLs) + The sole parameter to be passed to the wireless.h IOCTLs is + of type struct iwreq *. -gettimeofday.2 - Carlos O'Donell - Expand on the historical meaning of tz_dsttime +lseek.2 Michael Kerrisk - SEE ALSO: add vdso(7) + FUSE now supports SEEK_HOLE and SEEK_DATA + Michael Kerrisk + NFS supports SEEK_HOLE and SEEK_DATA -inotify_init.2 Michael Kerrisk - ERRORS: add an EMFILE error case + SEE ALSO: add open(2) -personality.2 - Dmitry V. Levin - Note kernel and glibc versions that introduced this system call +madvise.2 + Michael Kerrisk + Clarify MADV_HWPOISON wording to say that it applies to a page range + +mknod.2 + Michael Kerrisk + SEE ALSO: add mknod(1) + +mount.2 + Michael Kerrisk + SEE ALSO: add findmnt(8) + +open.2 + Michael Kerrisk + NOTES: mention existence of proc/PID/fd and /proc/PID/fdinfo + Mark Post [Petr Gajdos] + O_TMPFILE support is now provided bt Btrfs + +pipe.2 + Michael Kerrisk [Eric Blake] + Note treatment of 'pipefd' on error poll.2 - Richard Voigt - timeout_ts is a pointer, so use -> not . for member access + Michael Kerrisk [Josh Triplett] + Document spurious EAGAIN error that can occur on other systems + Light reworking of text proposed by Josh Triplett. + +readlink.2 + Michael Kerrisk + Clarify EINVAL error description + +recv.2 + Heinrich Schuchardt + Equivalence to read() + Describe the recv(2)-read(2) and the recvfrom(2)-recv(2) + equivalences for zero-valued arguments. + Michael Kerrisk + MSG_WAITALL has no effect for datagram sockets + +recv.2 +cmsg.3 + Nikola Forró + Fix type of cmsg_len member of cmsghdr structure + The type shown for cmsg_len member of cmsghdr structure is socklen_t, + but the actual type used by glibc and the kernel is size_t. + The information was obtained from glibc source code: + http://bit.ly/21m1RMp + Michael Kerrisk + Note that cmsg_len is typed as socklen_t in POSIX.1 + + +sched_setaffinity.2 + Michael Kerrisk [Florian Weimer, Florian Weimer] + Warn that CPU_ALLOC() may allocate a slightly CPU set than requested + Michael Kerrisk [Florian Weimer] + Add reference to CPU_ALLOC(3) + +sched_setattr.2 + Michael Kerrisk [Akihiro Suda] + EPERM depends on affinity mask of target thread, not calling thread + +select.2 + Michael Kerrisk [Josh Triplett] + Document spurious EAGAIN error that can occur on other systems + Light reworking of text proposed by Josh Triplett. + Nikos Mavrogiannopoulos + Mention the 'fd_set' size limitation early and refer to poll(2) + Change this because of the serious limitation of select() + imposing a limit on the range of file descriptors that can + be monitored. This is currently mentioned too late in the + documentation (in the NOTES section). The man page should + warn early and refer to poll(2) as soon as possible. + Michael Kerrisk + Add details on the glibc fixed-size fd_set limitation + No modern application should use select() on Linux. + +select_tut.2 + Michael Kerrisk + Some readability fixes to example program + Michael Kerrisk + Better variable names in example program + Michael Kerrisk + Simplify 'if' logic in in example program + Michael Kerrisk + Use correct type (socklen_t) for addrlen + +semctl.2 + Michael Kerrisk [Davidlohr Bueso, Manfred Spraul, Philip Semanchuk] + NOTES: note when 'sempid' is set on various implementations + See https://bugzilla.kernel.org/show_bug.cgi?id=112271 and + http://thread.gmane.org/gmane.linux.kernel/2162754/ + Subject: [PATCH] Don't set sempid in semctl syscall. + Date: 2016-02-26 12:21:38 GMT + +semop.2 Michael Kerrisk - Shorten name of timeout argument for ppoll() - The name is overly long, and does not hint at the fact - that this argument is a pointer. Fix this by renaming: - s/timeout_ts/tmo_p/ + Tweak comment describing 'sempid' sendfile.2 - Laurent Georget - Document more ERRORS + Askar Safin + Fix incorrect description in text referring to splice(2) + Michael Kerrisk + SEE ALSO: add copy_file_range(2) + +setpgid.2 + Michael Kerrisk + Correct/simplify FTM requirements for BSD setpgrp() and getpgrp() + +signalfd.2 + Michael Kerrisk + Note that signalfd info is available in /proc/PID/fdinfo + +sigprocmask.2 + Michael Kerrisk [Mike Frysinger] + Explicitly refer the reader to sigsetops(3) + This man page did not make it obvious which functions + should be used for manipulating signals sets, nor where + those functions were documented. + +socketpair.2 + Michael Kerrisk [Eric Blake] + Note treatment of 'sv' on error -sigreturn.2 +splice.2 + Askar Safin + Improve description of 0 return value. + See https://bugzilla.kernel.org/show_bug.cgi?id=90911 + +statfs.2 + Michael Kerrisk [Jakub Wilk] + Use consistent case for hex constants + +sync.2 + Christoph Hellwig + Clarify description and document the Linux data integrity guarantees + +syscall.2 + Mike Frysinger + Add more architectures and improve error documentation + Move the error register documentation into the main table rather + than listing them in sentences after the fact. + + Add sparc error return details. + + Add details for alpha/arc/m68k/microblaze/nios2/powerpc/superh/ + tile/xtensa. + +syscalls.2 Michael Kerrisk - SEE ALSO: add vdso(7) + Add copy_file_range(2) -socketcall.2 +times.2 + Kondo, Naoya + Fix an incorrect description in NOTES + The text has an incorrect description in NOTES, it says + that (2^32/HZ) - 300 is about 429 million. It is correct + only if HZ=10 which does not look common today. So just + removing "(i.e., about 429 million)" is good enough. + +truncate.2 Michael Kerrisk - Since Linux 4.3, x86-32 provides direct system calls for the sockets API + SEE ALSO: add truncate(1) -time.2 - Zack Weinberg - Explain why the glibc time() wrapper never sets 'errno' - Michael Kerrisk [H.J. Lu] - Where time() is provided by vDSO, an invalid address may give SIGSEGV - Michael Kerrisk [Paul Eggert] - Describe EOVERFLOW details +uselib.2 Michael Kerrisk - SEE ALSO: add vdso(7) + Mention CONFIG_USELIB Michael Kerrisk - Rename 't' argument to 'tloc' + Note that glibc does not support this (obsolete) system call -dlerror.3 - Michael Kerrisk [Jonny Grant] - Clarify that the string returned by dlerror() is null terminated +wait.2 +wait4.2 + Michael Kerrisk + Rename the "status" argument to "wstatus" + The fact that exit(3)/_exit(2) has an argument called + "status" and the same name is used in the arguments to the + wait*() calls can a little too easily lead the user into + thinking that the two arguments hold the same information, + when of course they don't. So, use a different name + for the argument of the wait*() functions, to reduce + the chances of such confusion. -dlopen.3 +backtrace.3 + Michael Kerrisk [Martin Gebert] + Small fixes to example program + +clearenv.3 + Michael Kerrisk [Matt Zimmerman] + Clarify the use and effect of clearenv() + See http://bugs.debian.org/679323 + Michael Kerrisk + Variables can be added to the environment after calling clearenv() + +clog10.3 Michael Kerrisk - Include a shell session showing build/run in EXAMPLE + Show an alternative equivalence for clog10() Michael Kerrisk - Change arguments to main() to "void" in EXAMPLE + Update CONFORMING TO + Fix grammar error and add C11. -drand48.3 - Michael Kerrisk [Vincent Lefevre] - Correct descriptions of ranges returned by these functions - See http://bugs.debian.org/803459 +dl_iterate_phdr.3 + Michael Kerrisk [Paul Pluzhnikov] + Describe 'struct dl_phdr_info' fields added in glibc 2.4 + See https://bugzilla.kernel.org/show_bug.cgi?id=103011 + Michael Kerrisk [Simon Que] + Note that first object visited by 'callback' is the main program + See https://bugzilla.kernel.org/show_bug.cgi?id=94141 errno.3 Michael Kerrisk - Note probable cause of ENFILE error + Add some explanation of ENOENT error -fnmatch.3 - Pádraig Brady - Describe the FNM_EXTMATCH flag and pattern syntax - -iconv.3 - Andries E. Brouwer - NOTES: describe correct usage for flushing partially buffered input - -random_r.3 - Michael Kerrisk [Archie Cobbs] - Clarify need to use initstate_r() - -tzset.3 - Carlos O'Donell - Clarify "daylight" and remove erroneous note - -random.4 - Michael Kerrisk [Tom Gundersen] - Rework example scripts to assume 'poolsize' unit is bits, not bytes - Michael Kerrisk [Walter Harms] - Use modern command substitution syntax in shell session log +exec.3 + Michael Kerrisk + SEE ALSO: add system(3) -proc.5 +exp.3 + Michael Kerrisk [Joachim Wuttke] + SEE ALSO: add expm1(3) + +fopen.3 Michael Kerrisk - Reaching /proc/sys/fs/file-max limit normally produces an ENFILE error + SEE ALSO: add open_memstream(3) -futex.7 - Heinrich Schuchardt - SEE ALSO updates +fts.3 Michael Kerrisk - Note some other locking primitives that are built with futexes - Heinrich Schuchardt - NPTL, avoid abbreviation + BUGS: glibc-2.23 now has LFS support for the fts functions + +gamma.3 + Michael Kerrisk [Alan Cox] + gamma() was documented in SVID 2 + +getaddrinfo.3 + Michael Kerrisk [Andreas Schwab, Orion Poplawski] + Update FTM requirements for glibc 2.22 + Since glibc 2.22 getaddrinfo() etc. are only declared for + POSIX.1-2001 or later. + +getcwd.3 + Michael Kerrisk + SEE ALSO: add pwd(1) + +opendir.3 + Michael Kerrisk + Help the reader by explicitly mentioning the use of readdir(3) + +perror.3 + Michael Kerrisk + Suggest use of strerror(3) in place of deprecated 'sys_errlist' + +posix_fallocate.3 + Jérémie Galarneau + ERRORS: add EINTR + The glibc implementation of posix_fallocate(), which calls + fallocate(), may be interrupted. The fallocate() emulation + also makes use of pread()/pwrite(), which may also be + interrupted. + +posix_memalign.3 + Michael Kerrisk [Eric Blake] + Note posix_memalign()'s treatment of 'memptr' on error + +pthread_setaffinity_np.3 + Michael Kerrisk + SEE ALSO: add CPU_SET(3) + +queue.3 + Dr. Tobias Quathamer + Remove double CONFORMING TO section + +rcmd.3 + Nikola Forró + Add missing condition concerning .rhosts file + The list of conditions determining if iruserok() and ruserok() + functions automatically fail is incomplete. According to glibc + source code, the functions also fail if the .rhosts file + is hard linked anywhere. + +setbuf.3 + Michael Kerrisk + SEE ALSO: add stdbuf(1) + +setjmp.3 + Michael Kerrisk + Rewrite and merge longjmp()/siglongjmp() discussion into this page + The discussion of nonlocal gotos is much easier to read if + setjmp() and longjmp() are discussed in the same page. While + we're at it, rework almost the entire text and add several + more details. + Michael Kerrisk + Note the interactions of longjmp() and non-async-signal-safe functions + POSIX.1-2008 TC2 adds explicit text on this point. + See http://austingroupbugs.net/view.php?id=516#c1195 + Michael Kerrisk + Explain why nonlocal gotos make code harder to maintain + Michael Kerrisk + Reword warning on longjmp() to function that has already returned + Michael Kerrisk + Remove reference to obsolete _XOPEN_SOURCE_EXTENDED + +sleep.3 + Michael Kerrisk + SEE ALSO: add sleep(1) + +strftime.3 + Michael Kerrisk [Jeremy Harris] + Note which 'tm' fields are used to calculate each output string + See https://bugzilla.redhat.com/show_bug.cgi?id=1162218 + +strlen.3 + Michael Kerrisk [Alan Aversa] + CONFORMING TO: add C11 + +system.3 + Michael Kerrisk + SEE ALSO: add execve(2) + +termios.3 + Dr. Tobias Quathamer + Document line length in canonical mode + See https://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/tree/drivers/tty/n_tty.c#n1673 + See https://bugs.debian.org/797479 Michael Kerrisk - Note that a futex is 4 bytes on all platforms + SEE ALSO: add tty(1) + Michael Kerrisk [Peter Hurley] + Further improvements to recent tweaks of canonical mode 4096 char limit -vdso.7 +timegm.3 + Michael Kerrisk [Stephen Hurd, Mats Wichmann] + Remove sample implementation of timegm() + Stephen and Mats both question the wisdom of showing a portable + *non-thread-safe* implementation of timegm(), and I find it + hard to disagree. So, remove this code. + + See https://bugzilla.kernel.org/show_bug.cgi?id=103701 + Michael Kerrisk + Expand DESCRIPTION a little + +st4.4 + Dr. Tobias Quathamer + Remove spurious copyright section + +tty_ioctl.4 + Michael Kerrisk + SEE ALSO: add ldattach(1) + +elf.5 + Michael Kerrisk [Gabriel Corona, Mike Frysinger] + Fix description of STV_PROTECTED + Michael Kerrisk + Improve description of STV_DEFAULT + Michael Kerrisk + Improve description of STV_HIDDEN + Chris Pick + Remove erroneous, duplicate SHN_* section + Michael Kerrisk [Chris Pick] + Reword discussion of range values a little + +gai.conf.5 + Michael Kerrisk + Add VERSIONS section + +group.5 + Michael Kerrisk + SEE ALSO: add groups(2) + SEE ALSO: add gpasswd(1) + SEE ALSO: add sg(1) + SE ALSO: add gshadow(5) + SEE ALSO: add chgrp(1) + +locale.5 + Marko Myllynen [Mike Frysinger] + tel + fax are deprecated + +nsswitch.conf.5 + Nikola Forró + Update NSS compatibility mode description + +utmp.5 + Michael Kerrisk + SEE ALSO: add lslogins(1) + +aio.7 + Andreas Gruenbacher + Improve example + When aio_sigevent.sigev_notify is set to SIGEV_SIGNAL, signal + handlers called for asynchronous I/O operations will have + si->si_code set to SI_ASYNCIO. Check to make sure that + si->si_value.sival_ptr is defined. + +capabilities.7 + Michael Kerrisk + Explain safety check for capability-dumb binaries + Michael Kerrisk + SEE ALSO: add sg(1), su(1) + SEE ALSO: add id(1), group(5), passwd(5) + +credentials.7 + Michael Kerrisk + SEE ALSO: add groups(2) + +environ.7 + Michael Kerrisk + Describe the Bourne "NAME=value command" syntax + Michael Kerrisk + Add some details describing hos shell's environment is initialized + Michael Kerrisk + Note that child of fork(2) inherits copy of parent's environment + Michael Kerrisk + SEE ALSO: add pam_env(3) + +epoll.7 + Michael Kerrisk + Mention that epoll info is available via /proc/PID/fdinfo + +fanotify.7 Michael Kerrisk - Add note on strace(1) and vDSO + Refer reader to proc(5) for info on /proc/PID/fdinfo fanotify entries -ld.so.8 - H.J. Lu [Michael Kerrisk] - Document LD_PREFER_MAP_32BIT_EXEC + +feature_test_macros.7 + Michael Kerrisk + Add a summary of some FTM key points + Michael Kerrisk + Give an early hint about some macros being defined by default + Michael Kerrisk + Clarify relation between _XOPEN_SOURCE >=500 and _XOPEN_SOURCE_EXTENDED + Emphasize that defining _XOPEN_SOURCE >=500 produces same + effects as defining _XOPEN_SOURCE_EXTENDED. + Michael Kerrisk + Note that man pages don't mention _XOPEN_SOURCE_EXTENDED + As per previous commit, mention of _XOPEN_SOURCE_EXTENDED + has generally been removed from the man pages. + Michael Kerrisk + Note effects of "cc -std=c99" and "cc -std=c11" + Michael Kerrisk + Clarify some _ISOC99_SOURCE / _DEFAULT_SOURCE details + Michael Kerrisk + Clarify that _XOPEN_SOURCE_EXTENDED is obsolete + Since SUSv2, _XOPEN_SOURCE_EXTENDED is no longer specified + in the standard. + +inotify.7 + Michael Kerrisk + Refer reader to proc(5) for info on /proc/PID/fdinfo inotify entries + +ip.7 + Eric Dumazet + Document IP_BIND_ADDRESS_NO_PORT socket option + +mq_overview.7 + Michael Kerrisk + Note that the close-on-exec flag is automatically set on MQ descriptors + +namespaces.7 + Michael Kerrisk + SEE ALSO: add lsns(1) + lsns(1) was recently added in util-linux, probably to appear + in next release (2.28?). + +pipe.7 + Michael Kerrisk [Jason Vas Dias] + Clarify that I/O signalling requires use of both F_SETOWN and O_ASYNC + Michael Kerrisk + SEE ALSO: add mkfifo(1) + +signal.7 + Michael Kerrisk + Note the interactions of longjmp() and non-async-signal-safe functions + See http://austingroupbugs.net/view.php?id=516#c1195. + +socket.7 + Michael Kerrisk + SEE ALSO: add pcap(3) + SEE ALSO: add wireshark(1) and tcpdump(8) + +standards.7 Michael Kerrisk - Clarify setting of LD_BIND_NOT + Add POSIX.1-2008 TC2 (POSIX.1-2016) + +svipc.7 Michael Kerrisk - Clarify setting of LD_DYNAMIC_WEAK + Tweak description of 'sempid' + Michael Kerrisk + SEE ALSO: add lsipc(1) + +symlink.7 + Michael Kerrisk [Zefram] + Some "magic" symlinks have permissions other than 0777 + See https://bugs.debian.org/743525 + +time.7 + Michael Kerrisk + SEE ALSO: add timeout(1) + SEE ALSO: add ntp_adjtime(3) and ntp_gettime(3) + +unicode.7 + Dr. Tobias Quathamer + Document private use areas + See https://bugs.debian.org/285444 + +unix.7 + Heinrich Schuchardt + Add example + A complete example demonstrating the usage of sockets for local + interprocess communication is added. Michael Kerrisk - Clarify setting of LD_TRACE_PRELINKING + Introduce term "sequenced-packet" for SOCK_SEQPACKET Michael Kerrisk - Clarify some details for LD_SHOW_AUXV + Some wording improvements diff -Nru manpages-4.04/Changes.old manpages-4.05/Changes.old --- manpages-4.04/Changes.old 2015-12-29 12:51:43.000000000 +0000 +++ manpages-4.05/Changes.old 2016-03-15 03:47:38.000000000 +0000 @@ -1210,7 +1210,7 @@ semop.2 mtk Added BUG: in some circumstances, a process that is - waiting for a semaphore to become zero is not not woken + waiting for a semaphore to become zero is not woken up when the value does actually reach zero. http://marc.theaimsgroup.com/?l=linux-kernel&m=110260821123863&w=2 http://marc.theaimsgroup.com/?l=linux-kernel&m=110261701025794&w=2 @@ -2117,7 +2117,7 @@ frexp.3 Volker Reichelt / mtk - Fixed to point out that that frexp() returns a number whose + Fixed to point out that frexp() returns a number whose *absolute* value is >= 0.5 and < 1. Amended the example program to demonstrate this. @@ -16331,7 +16331,7 @@ Global fix: s/mount-point namespace/mount namespace/ This is more consistent with the term "mounts namespace" used in the 2008 ACM SIGOPS paper, "Virtual servers - and and checkpoint/restart in mainstream Linux". + and checkpoint/restart in mainstream Linux". (I avoided the "s", because using the plural strikes me as klunky English, and anyway we don't talk about the "PIDs namespace" or the "networks namespace", etc..) @@ -16557,7 +16557,7 @@ Michael Kerrisk PTHREAD_INHERIT_SCHED is default for inherit scheduler attribute In EXAMPLE, note that PTHREAD_INHERIT_SCHED is the default for - the inherit scheduler attribute attribute. + the inherit scheduler attribute. syslog.3 Masanari Iida @@ -18060,7 +18060,7 @@ syscalls.2 Michael Kerrisk Note that getpmsg(2) and putmsg(2) are unimplemented - See See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=514771 + See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=514771 timerfd_create.2 Michael Kerrisk @@ -19891,7 +19891,7 @@ udp.7 Michael Kerrisk Add FIONREAD warning. - Warn that FIONREAD can't can't distinguish case of a zero-length + Warn that FIONREAD can't distinguish case of a zero-length datagram from the case where no datagrams are available. @@ -26090,7 +26090,7 @@ socket.7 Pavel Emelyanov SO_BINDTODEVICE is now readable - SO_BINDTODEVICE is readable since since kernel 3.8. + SO_BINDTODEVICE is readable since kernel 3.8. ==================== Changes in man-pages-3.49 ==================== @@ -26425,7 +26425,7 @@ and the wrapper function in the introductory text. Michael Kerrisk Update feature test macro requirements - The requirements quietly changed changed in glibc 2.14 + The requirements quietly changed in glibc 2.14 See also http://www.sourceware.org/bugzilla/show_bug.cgi?id=4749 Michael Kerrisk [Mike Frysinger] @@ -26537,7 +26537,7 @@ unshare.2 Michael Kerrisk Update feature test macro requirements - The requirements quietly changed changed in glibc 2.14 + The requirements quietly changed in glibc 2.14 See also http://www.sourceware.org/bugzilla/show_bug.cgi?id=4749 @@ -26576,7 +26576,7 @@ sched_getcpu.3 Michael Kerrisk Update feature test macro requirements - The requirements quietly changed changed in glibc 2.14 + The requirements quietly changed in glibc 2.14 See also http://www.sourceware.org/bugzilla/show_bug.cgi?id=4749 @@ -40197,3 +40197,248 @@ Inspired by a patch from Maria Guseva. Maria Guseva [Silvan Jegen] LD_DEBUG is effective in secure-execution mode if /etc/suid-debug exists + + +==================== Changes in man-pages-4.04 ==================== + +Released: 2015-12-29, Munich + + +Contributors +------------ + +The following people contributed patches/fixes or (noted in brackets +in the changelog below) reports, notes, and ideas that have been +incorporated in changes in this release: + +Alexander Monakov +Andries E. Brouwer +Archie Cobbs +Carlos O'Donell +Colin Rice +Darren Hart +Davidlohr Bueso +Dmitry V. Levin +Eric B Munson +Heinrich Schuchardt +H.J. Lu +Jakub Wilk +Jonathan Wakely +Jonny Grant +Laurent Georget +Lennart Poettering +Mathieu Desnoyers +Michael Kerrisk +Michal Hocko +Mike Frysinger +Pádraig Brady +Paul Eggert +Pavel Machek +Phil Blundell +Richard Voigt +Rich Felker +Rusty Russell +Thomas Gleixner +Tom Gundersen +Torvald Riegel +Vincent Lefevre +Vlastimil Babka +Walter Harms +Zack Weinberg + + +Apologies if I missed anyone! + + +New and rewritten pages +----------------------- + +futex.2 + Michael Kerrisk, Thomas Gleixner, Torvald Riegel [Davidlohr Bueso, Heinrich Schuchardt, Darren Hart, Rusty Russell, Pavel Machek, Rich Felker] + Rewrite and massively expand page + +membarrier.2 + Mathieu Desnoyers [Michael Kerrisk] + New page documenting membarrier() system call + + +Newly documented interfaces in existing pages +--------------------------------------------- + +mlock.2 + Eric B Munson [Michal Hocko, Vlastimil Babka, Michael Kerrisk] + Document mlock2(2) and MCL_ONFAULT + + +New and changed links +--------------------- + +mlock2.2 + Eric B Munson + New link to mlock.2 + + +Global changes +-------------- + +Various pages + Michael Kerrisk + ERRORS: standardize text for EMFILE error + +Various pages + Michael Kerrisk + ERRORS: standardize error text for ENOTSOCK error + +Various pages + Michael Kerrisk + ERRORS: standardize text for ENFILE error + + +Changes to individual pages +--------------------------- + +clock_getres.2 + Michael Kerrisk + SEE ALSO: add vdso(7) + +epoll_create.2 + Michael Kerrisk + ERRORS: add another EMFILE error case + +fanotify_init.2 + Michael Kerrisk + ERRORS: add an EMFILE error case + +fork.2 + Michael Kerrisk + Child of MT-process is restricted to async-signal-safe functions + +getcpu.2 + Michael Kerrisk + SEE ALSO: add vdso(7) + +getrlimit.2 + Michael Kerrisk [Lennart Poettering] + The init of measurement for RLIMIT_RSS is bytes, not pages + +get_robust_list.2 + Michael Kerrisk + Reword EINVAL error text + +gettimeofday.2 + Carlos O'Donell + Expand on the historical meaning of tz_dsttime + Michael Kerrisk + SEE ALSO: add vdso(7) + +inotify_init.2 + Michael Kerrisk + ERRORS: add an EMFILE error case + +personality.2 + Dmitry V. Levin + Note kernel and glibc versions that introduced this system call + +poll.2 + Richard Voigt + timeout_ts is a pointer, so use -> not . for member access + Michael Kerrisk + Shorten name of timeout argument for ppoll() + The name is overly long, and does not hint at the fact + that this argument is a pointer. Fix this by renaming: + s/timeout_ts/tmo_p/ + +sendfile.2 + Laurent Georget + Document more ERRORS + +sigreturn.2 + Michael Kerrisk + SEE ALSO: add vdso(7) + +socketcall.2 + Michael Kerrisk + Since Linux 4.3, x86-32 provides direct system calls for the sockets API + +time.2 + Zack Weinberg + Explain why the glibc time() wrapper never sets 'errno' + Michael Kerrisk [H.J. Lu] + Where time() is provided by vDSO, an invalid address may give SIGSEGV + Michael Kerrisk [Paul Eggert] + Describe EOVERFLOW details + Michael Kerrisk + SEE ALSO: add vdso(7) + Michael Kerrisk + Rename 't' argument to 'tloc' + +dlerror.3 + Michael Kerrisk [Jonny Grant] + Clarify that the string returned by dlerror() is null terminated + +dlopen.3 + Michael Kerrisk + Include a shell session showing build/run in EXAMPLE + Michael Kerrisk + Change arguments to main() to "void" in EXAMPLE + +drand48.3 + Michael Kerrisk [Vincent Lefevre] + Correct descriptions of ranges returned by these functions + See http://bugs.debian.org/803459 + +errno.3 + Michael Kerrisk + Note probable cause of ENFILE error + +fnmatch.3 + Pádraig Brady + Describe the FNM_EXTMATCH flag and pattern syntax + +iconv.3 + Andries E. Brouwer + NOTES: describe correct usage for flushing partially buffered input + +random_r.3 + Michael Kerrisk [Archie Cobbs] + Clarify need to use initstate_r() + +tzset.3 + Carlos O'Donell + Clarify "daylight" and remove erroneous note + +random.4 + Michael Kerrisk [Tom Gundersen] + Rework example scripts to assume 'poolsize' unit is bits, not bytes + Michael Kerrisk [Walter Harms] + Use modern command substitution syntax in shell session log + +proc.5 + Michael Kerrisk + Reaching /proc/sys/fs/file-max limit normally produces an ENFILE error + +futex.7 + Heinrich Schuchardt + SEE ALSO updates + Michael Kerrisk + Note some other locking primitives that are built with futexes + Heinrich Schuchardt + NPTL, avoid abbreviation + Michael Kerrisk + Note that a futex is 4 bytes on all platforms + +vdso.7 + Michael Kerrisk + Add note on strace(1) and vDSO + +ld.so.8 + H.J. Lu [Michael Kerrisk] + Document LD_PREFER_MAP_32BIT_EXEC + Michael Kerrisk + Clarify setting of LD_BIND_NOT + Michael Kerrisk + Clarify setting of LD_DYNAMIC_WEAK + Michael Kerrisk + Clarify setting of LD_TRACE_PRELINKING + Michael Kerrisk + Clarify some details for LD_SHOW_AUXV diff -Nru manpages-4.04/debian/changelog manpages-4.05/debian/changelog --- manpages-4.04/debian/changelog 2016-02-15 13:02:11.000000000 +0000 +++ manpages-4.05/debian/changelog 2016-03-16 16:43:16.000000000 +0000 @@ -1,3 +1,19 @@ +manpages (4.05-1) unstable; urgency=medium + + * Imported Upstream version 4.05 + - write.2: Document behaviour on tty devices. (Closes: #797479) + - clearenv.3: Clarify the use and effect of clearenv(). (Closes: #679323) + - perror.3: Suggest use of strerror(3) in place of deprecated + 'sys_errlist'. (Closes: #794876) + - printf.3: Remove stray asterisk in "NAN*". (Closes: #756599) + - unicode.7: Document "Private Use Areas". (Closes: #285444) + * Do not install sk98lin.4 (Closes: #780544) + * Refresh patches + * Remove obsolete installation script + * Update d/copyright and d/watch + + -- Dr. Tobias Quathamer Wed, 16 Mar 2016 17:23:06 +0100 + manpages (4.04-2) unstable; urgency=medium * Update copyright to DEP-5 format diff -Nru manpages-4.04/debian/copyright manpages-4.05/debian/copyright --- manpages-4.04/debian/copyright 2016-02-15 12:51:27.000000000 +0000 +++ manpages-4.05/debian/copyright 2016-03-16 16:43:16.000000000 +0000 @@ -279,41 +279,42 @@ man3/nan.3 man3/nanf.3 man3/nanl.3 man3/netlink.3 man3/nextafter.3 man3/nextafterf.3 man3/nextafterl.3 man3/nexttoward.3 man3/nexttowardf.3 man3/nexttowardl.3 man3/nftw.3 man3/nl_langinfo.3 - man3/nl_langinfo_l.3 man3/open_memstream.3 man3/open_wmemstream.3 - man3/passwd2des.3 man3/perror.3 man3/posix_madvise.3 man3/printf.3 - man3/putgrent.3 man3/putspent.3 man3/pututline.3 man3/pututxline.3 - man3/putwc.3 man3/putwchar.3 man3/remquo.3 man3/remquof.3 - man3/remquol.3 man3/rtime.3 man3/setaliasent.3 man3/setjmp.3 - man3/setkey.3 man3/setkey_r.3 man3/setnetgrent.3 man3/setspent.3 - man3/setttyent.3 man3/setutent.3 man3/setutxent.3 man3/sgetspent.3 - man3/sgetspent_r.3 man3/siglongjmp.3 man3/signbit.3 man3/signgam.3 - man3/significand.3 man3/significandf.3 man3/significandl.3 - man3/sigsetjmp.3 man3/sincos.3 man3/sincosf.3 man3/sincosl.3 - man3/snprintf.3 man3/sprintf.3 man3/stpncpy.3 man3/strfmon.3 - man3/strfmon_l.3 man3/strnlen.3 man3/strtoimax.3 man3/strtoumax.3 - man3/swprintf.3 man3/sys_errlist.3 man3/sys_nerr.3 man3/tcdrain.3 - man3/tcflow.3 man3/tcflush.3 man3/tcgetattr.3 man3/tcsendbreak.3 - man3/tcsetattr.3 man3/termios.3 man3/tgamma.3 man3/tgammaf.3 - man3/tgammal.3 man3/towctrans.3 man3/towlower.3 man3/towlower_l.3 - man3/towupper.3 man3/towupper_l.3 man3/ttyname.3 man3/ttyname_r.3 - man3/ualarm.3 man3/ulckpwdf.3 man3/ungetwc.3 man3/updwtmp.3 - man3/updwtmpx.3 man3/utmpname.3 man3/utmpxname.3 man3/vdprintf.3 - man3/vfprintf.3 man3/vfwprintf.3 man3/vprintf.3 man3/vsnprintf.3 - man3/vsprintf.3 man3/vswprintf.3 man3/vwprintf.3 man3/wcpcpy.3 - man3/wcpncpy.3 man3/wcrtomb.3 man3/wcscasecmp.3 man3/wcscat.3 - man3/wcschr.3 man3/wcscmp.3 man3/wcscpy.3 man3/wcscspn.3 - man3/wcsdup.3 man3/wcslen.3 man3/wcsncasecmp.3 man3/wcsncat.3 - man3/wcsncmp.3 man3/wcsncpy.3 man3/wcsnlen.3 man3/wcsnrtombs.3 - man3/wcspbrk.3 man3/wcsrchr.3 man3/wcsrtombs.3 man3/wcsspn.3 - man3/wcsstr.3 man3/wcstoimax.3 man3/wcstok.3 man3/wcstombs.3 - man3/wcstoumax.3 man3/wcswidth.3 man3/wctob.3 man3/wctomb.3 - man3/wctrans.3 man3/wctype.3 man3/wcwidth.3 man3/wmemchr.3 - man3/wmemcmp.3 man3/wmemcpy.3 man3/wmemmove.3 man3/wmempcpy.3 - man3/wmemset.3 man3/wordexp.3 man3/wordfree.3 man3/wprintf.3 - man3/xcrypt.3 man3/xdecrypt.3 man3/xencrypt.3 man4/console.4 - man4/console_codes.4 man4/console_ioctl.4 man4/dsp56k.4 man4/fd.4 - man4/hd.4 man4/intro.4 man4/kmem.4 man4/loop-control.4 man4/loop.4 - man4/lp.4 man4/mem.4 man4/null.4 man4/port.4 man4/ram.4 man4/random.4 + man3/nl_langinfo_l.3 man3/ntp_adjtime.3 man3/open_memstream.3 + man3/open_wmemstream.3 man3/passwd2des.3 man3/perror.3 + man3/posix_madvise.3 man3/printf.3 man3/putgrent.3 man3/putspent.3 + man3/pututline.3 man3/pututxline.3 man3/putwc.3 man3/putwchar.3 + man3/remquo.3 man3/remquof.3 man3/remquol.3 man3/rtime.3 + man3/setaliasent.3 man3/setjmp.3 man3/setkey.3 man3/setkey_r.3 + man3/setnetgrent.3 man3/setspent.3 man3/setttyent.3 man3/setutent.3 + man3/setutxent.3 man3/sgetspent.3 man3/sgetspent_r.3 + man3/siglongjmp.3 man3/signbit.3 man3/signgam.3 man3/significand.3 + man3/significandf.3 man3/significandl.3 man3/sigsetjmp.3 + man3/sincos.3 man3/sincosf.3 man3/sincosl.3 man3/snprintf.3 + man3/sprintf.3 man3/stpncpy.3 man3/strfmon.3 man3/strfmon_l.3 + man3/strnlen.3 man3/strtoimax.3 man3/strtoumax.3 man3/swprintf.3 + man3/sys_errlist.3 man3/sys_nerr.3 man3/tcdrain.3 man3/tcflow.3 + man3/tcflush.3 man3/tcgetattr.3 man3/tcsendbreak.3 man3/tcsetattr.3 + man3/termios.3 man3/tgamma.3 man3/tgammaf.3 man3/tgammal.3 + man3/towctrans.3 man3/towlower.3 man3/towlower_l.3 man3/towupper.3 + man3/towupper_l.3 man3/ttyname.3 man3/ttyname_r.3 man3/ualarm.3 + man3/ulckpwdf.3 man3/ungetwc.3 man3/updwtmp.3 man3/updwtmpx.3 + man3/utmpname.3 man3/utmpxname.3 man3/vdprintf.3 man3/vfprintf.3 + man3/vfwprintf.3 man3/vprintf.3 man3/vsnprintf.3 man3/vsprintf.3 + man3/vswprintf.3 man3/vwprintf.3 man3/wcpcpy.3 man3/wcpncpy.3 + man3/wcrtomb.3 man3/wcscasecmp.3 man3/wcscat.3 man3/wcschr.3 + man3/wcscmp.3 man3/wcscpy.3 man3/wcscspn.3 man3/wcsdup.3 + man3/wcslen.3 man3/wcsncasecmp.3 man3/wcsncat.3 man3/wcsncmp.3 + man3/wcsncpy.3 man3/wcsnlen.3 man3/wcsnrtombs.3 man3/wcspbrk.3 + man3/wcsrchr.3 man3/wcsrtombs.3 man3/wcsspn.3 man3/wcsstr.3 + man3/wcstoimax.3 man3/wcstok.3 man3/wcstombs.3 man3/wcstoumax.3 + man3/wcswidth.3 man3/wctob.3 man3/wctomb.3 man3/wctrans.3 + man3/wctype.3 man3/wcwidth.3 man3/wmemchr.3 man3/wmemcmp.3 + man3/wmemcpy.3 man3/wmemmove.3 man3/wmempcpy.3 man3/wmemset.3 + man3/wordexp.3 man3/wordfree.3 man3/wprintf.3 man3/xcrypt.3 + man3/xdecrypt.3 man3/xencrypt.3 man4/console.4 man4/console_codes.4 + man4/console_ioctl.4 man4/dsp56k.4 man4/fd.4 man4/hd.4 man4/intro.4 + man4/kmem.4 man4/lirc.4 man4/loop-control.4 man4/loop.4 man4/lp.4 + man4/mem.4 man4/null.4 man4/port.4 man4/ram.4 man4/random.4 man4/rtc.4 man4/sk98lin.4 man4/tty.4 man4/ttyS.4 man4/tty_ioctl.4 man4/urandom.4 man4/vcs.4 man4/vcsa.4 man4/wavelan.4 man4/zero.4 man5/attr.5 man5/charmap.5 man5/filesystems.5 man5/fs.5 @@ -388,10 +389,12 @@ (C) 2014 Michael Kerrisk (C) 2014 Michael Kerrisk (C) 2014 Peter Zijlstra + (C) 2014, 2016 Michael Kerrisk (C) 2014, Michael Kerrisk (C) 2015 Andrew Lutomirski (C) 2015 Heinrich Schuchardt (C) 2015 Michael Kerrisk + (C) 2016 Michael Kerrisk (C) Andreas Gruenbacher, February 2001 (C) Linux Foundation, 2008, written by Michael Kerrisk (C) Markus Kuhn, 1995, 2001 @@ -451,6 +454,7 @@ (c) 2015 Andrew Lutomirski (c) 2015 Michael Kerrisk (c) 2015 Sam Varshavchik + (c) 2015, Alec Leamas (c) 2015, Robin H. Johnson (c) Andries Brouwer (c) Bruno Haible @@ -489,8 +493,7 @@ 2003 Walter Harms, Andries Brouwer 2003 walter harms (walter.harms@informatik.uni-oldenburg.de) 2003, 2015 Michael Kerrisk (mtk.manpages@gmail.com). - 2005 walter harms (walter.harms@informatik.uni-oldenburg.de), - 2005, 2012 Michael Kerrisk + 2005, 2012, 2016 Michael Kerrisk 2008, Linux Foundation, written by Michael Kerrisk 2009 Lefteris Dimitroulakis (edimitro@tee.gr) 2009 Lefteris Dimitroulakis (edimitro@tee.gr) @@ -544,16 +547,17 @@ man2/arm_fadvise.2 man2/arm_fadvise64_64.2 man2/arm_sync_file_range.2 man2/bpf.2 man2/chdir.2 man2/chmod.2 man2/chown.2 man2/chown32.2 man2/chroot.2 man2/clock_getres.2 man2/clock_gettime.2 - man2/clock_nanosleep.2 man2/clock_settime.2 man2/close.2 man2/creat.2 - man2/delete_module.2 man2/dup.2 man2/dup2.2 man2/dup3.2 man2/execve.2 - man2/execveat.2 man2/exit.2 man2/exit_group.2 man2/faccessat.2 - man2/fadvise64.2 man2/fadvise64_64.2 man2/fanotify_init.2 - man2/fanotify_mark.2 man2/fchdir.2 man2/fchmod.2 man2/fchmodat.2 - man2/fchown.2 man2/fchown32.2 man2/fchownat.2 man2/fcntl.2 - man2/fcntl64.2 man2/fdatasync.2 man2/finit_module.2 man2/flock.2 - man2/fork.2 man2/free_hugepages.2 man2/fstat.2 man2/fstat64.2 - man2/fstatat.2 man2/fstatat64.2 man2/fstatfs.2 man2/fstatfs64.2 - man2/fstatvfs.2 man2/fsync.2 man2/futimesat.2 man2/get_mempolicy.2 + man2/clock_nanosleep.2 man2/clock_settime.2 man2/close.2 + man2/copy_file_range.2 man2/creat.2 man2/delete_module.2 man2/dup.2 + man2/dup2.2 man2/dup3.2 man2/execve.2 man2/execveat.2 man2/exit.2 + man2/exit_group.2 man2/faccessat.2 man2/fadvise64.2 + man2/fadvise64_64.2 man2/fanotify_init.2 man2/fanotify_mark.2 + man2/fchdir.2 man2/fchmod.2 man2/fchmodat.2 man2/fchown.2 + man2/fchown32.2 man2/fchownat.2 man2/fcntl.2 man2/fcntl64.2 + man2/fdatasync.2 man2/finit_module.2 man2/flock.2 man2/fork.2 + man2/free_hugepages.2 man2/fstat.2 man2/fstat64.2 man2/fstatat.2 + man2/fstatat64.2 man2/fstatfs.2 man2/fstatfs64.2 man2/fstatvfs.2 + man2/fsync.2 man2/futimesat.2 man2/get_mempolicy.2 man2/get_robust_list.2 man2/getcontext.2 man2/getcpu.2 man2/getcwd.2 man2/getdents.2 man2/getdents64.2 man2/getdomainname.2 man2/getdtablesize.2 man2/getegid.2 man2/getegid32.2 man2/geteuid.2 @@ -729,18 +733,18 @@ man3/inet_network.3 man3/inet_ntoa.3 man3/inet_ntop.3 man3/inet_pton.3 man3/infnan.3 man3/initgroups.3 man3/initstate.3 man3/initstate_r.3 man3/insque.3 man3/intro.3 man3/isalnum.3 - man3/isalnum_l.3 man3/isalpha.3 man3/isascii.3 man3/isascii_l.3 - man3/isatty.3 man3/isblank.3 man3/isblank_l.3 man3/iscntrl.3 - man3/iscntrl_l.3 man3/isdigit.3 man3/isdigit_l.3 man3/isfdtype.3 - man3/isgraph.3 man3/isgraph_l.3 man3/isinff.3 man3/isinfl.3 - man3/islower.3 man3/islower_l.3 man3/isnanf.3 man3/isnanl.3 - man3/isprint.3 man3/isprint_l.3 man3/ispunct.3 man3/ispunct_l.3 - man3/isspace.3 man3/isspace_l.3 man3/isupper.3 man3/isupper_l.3 - man3/isxdigit.3 man3/isxdigit_l.3 man3/j0.3 man3/j0f.3 man3/j0l.3 - man3/j1.3 man3/j1f.3 man3/j1l.3 man3/jn.3 man3/jnf.3 man3/jnl.3 - man3/jrand48.3 man3/jrand48_r.3 man3/klogctl.3 man3/labs.3 - man3/lcong48.3 man3/lcong48_r.3 man3/ldexp.3 man3/ldexpf.3 - man3/ldexpl.3 man3/ldiv.3 man3/le16toh.3 man3/le32toh.3 + man3/isalnum_l.3 man3/isalpha.3 man3/isalpha_l.3 man3/isascii.3 + man3/isascii_l.3 man3/isatty.3 man3/isblank.3 man3/isblank_l.3 + man3/iscntrl.3 man3/iscntrl_l.3 man3/isdigit.3 man3/isdigit_l.3 + man3/isfdtype.3 man3/isgraph.3 man3/isgraph_l.3 man3/isinff.3 + man3/isinfl.3 man3/islower.3 man3/islower_l.3 man3/isnanf.3 + man3/isnanl.3 man3/isprint.3 man3/isprint_l.3 man3/ispunct.3 + man3/ispunct_l.3 man3/isspace.3 man3/isspace_l.3 man3/isupper.3 + man3/isupper_l.3 man3/isxdigit.3 man3/isxdigit_l.3 man3/j0.3 + man3/j0f.3 man3/j0l.3 man3/j1.3 man3/j1f.3 man3/j1l.3 man3/jn.3 + man3/jnf.3 man3/jnl.3 man3/jrand48.3 man3/jrand48_r.3 man3/klogctl.3 + man3/labs.3 man3/lcong48.3 man3/lcong48_r.3 man3/ldexp.3 + man3/ldexpf.3 man3/ldexpl.3 man3/ldiv.3 man3/le16toh.3 man3/le32toh.3 man3/le64toh.3 man3/lfind.3 man3/llabs.3 man3/lldiv.3 man3/llrint.3 man3/llrintf.3 man3/llrintl.3 man3/llround.3 man3/llroundf.3 man3/llroundl.3 man3/localeconv.3 man3/localtime.3 man3/localtime_r.3 @@ -766,30 +770,31 @@ man3/mrand48.3 man3/mrand48_r.3 man3/mtrace.3 man3/muntrace.3 man3/nearbyint.3 man3/nearbyintf.3 man3/nearbyintl.3 man3/newlocale.3 man3/nrand48.3 man3/nrand48_r.3 man3/ntohl.3 man3/ntohs.3 - man3/on_exit.3 man3/opendir.3 man3/openlog.3 man3/optarg.3 - man3/opterr.3 man3/optind.3 man3/optopt.3 man3/pathconf.3 - man3/posix_fallocate.3 man3/posix_memalign.3 man3/posix_openpt.3 - man3/pow.3 man3/pow10.3 man3/pow10f.3 man3/pow10l.3 man3/powf.3 - man3/powl.3 man3/profil.3 man3/psiginfo.3 man3/psignal.3 - man3/pthread_attr_destroy.3 man3/pthread_attr_getaffinity_np.3 - man3/pthread_attr_getdetachstate.3 man3/pthread_attr_getguardsize.3 - man3/pthread_attr_getinheritsched.3 man3/pthread_attr_getschedparam.3 - man3/pthread_attr_getschedpolicy.3 man3/pthread_attr_getscope.3 - man3/pthread_attr_getstack.3 man3/pthread_attr_getstackaddr.3 - man3/pthread_attr_getstacksize.3 man3/pthread_attr_init.3 - man3/pthread_attr_setaffinity_np.3 man3/pthread_attr_setdetachstate.3 - man3/pthread_attr_setguardsize.3 man3/pthread_attr_setinheritsched.3 - man3/pthread_attr_setschedparam.3 man3/pthread_attr_setschedpolicy.3 - man3/pthread_attr_setscope.3 man3/pthread_attr_setstack.3 - man3/pthread_attr_setstackaddr.3 man3/pthread_attr_setstacksize.3 - man3/pthread_cancel.3 man3/pthread_cleanup_pop.3 - man3/pthread_cleanup_pop_restore_np.3 man3/pthread_cleanup_push.3 - man3/pthread_cleanup_push_defer_np.3 man3/pthread_create.3 - man3/pthread_detach.3 man3/pthread_equal.3 man3/pthread_exit.3 - man3/pthread_getaffinity_np.3 man3/pthread_getattr_np.3 - man3/pthread_getconcurrency.3 man3/pthread_getcpuclockid.3 - man3/pthread_getname_np.3 man3/pthread_getschedparam.3 - man3/pthread_join.3 man3/pthread_kill.3 + man3/ntp_gettime.3 man3/ntp_gettimex.3 man3/on_exit.3 man3/opendir.3 + man3/openlog.3 man3/optarg.3 man3/opterr.3 man3/optind.3 + man3/optopt.3 man3/pathconf.3 man3/posix_fallocate.3 + man3/posix_memalign.3 man3/posix_openpt.3 man3/posix_spawn.3 + man3/posix_spawnp.3 man3/pow.3 man3/pow10.3 man3/pow10f.3 + man3/pow10l.3 man3/powf.3 man3/powl.3 man3/profil.3 man3/psiginfo.3 + man3/psignal.3 man3/pthread_attr_destroy.3 + man3/pthread_attr_getaffinity_np.3 man3/pthread_attr_getdetachstate.3 + man3/pthread_attr_getguardsize.3 man3/pthread_attr_getinheritsched.3 + man3/pthread_attr_getschedparam.3 man3/pthread_attr_getschedpolicy.3 + man3/pthread_attr_getscope.3 man3/pthread_attr_getstack.3 + man3/pthread_attr_getstackaddr.3 man3/pthread_attr_getstacksize.3 + man3/pthread_attr_init.3 man3/pthread_attr_setaffinity_np.3 + man3/pthread_attr_setdetachstate.3 man3/pthread_attr_setguardsize.3 + man3/pthread_attr_setinheritsched.3 man3/pthread_attr_setschedparam.3 + man3/pthread_attr_setschedpolicy.3 man3/pthread_attr_setscope.3 + man3/pthread_attr_setstack.3 man3/pthread_attr_setstackaddr.3 + man3/pthread_attr_setstacksize.3 man3/pthread_cancel.3 + man3/pthread_cleanup_pop.3 man3/pthread_cleanup_pop_restore_np.3 + man3/pthread_cleanup_push.3 man3/pthread_cleanup_push_defer_np.3 + man3/pthread_create.3 man3/pthread_detach.3 man3/pthread_equal.3 + man3/pthread_exit.3 man3/pthread_getaffinity_np.3 + man3/pthread_getattr_np.3 man3/pthread_getconcurrency.3 + man3/pthread_getcpuclockid.3 man3/pthread_getname_np.3 + man3/pthread_getschedparam.3 man3/pthread_join.3 man3/pthread_kill.3 man3/pthread_kill_other_threads_np.3 man3/pthread_rwlockattr_getkind_np.3 man3/pthread_rwlockattr_setkind_np.3 man3/pthread_self.3 @@ -840,35 +845,36 @@ man3/stdio_ext.3 man3/stpcpy.3 man3/strcasecmp.3 man3/strcasestr.3 man3/strcat.3 man3/strchr.3 man3/strchrnul.3 man3/strcmp.3 man3/strcoll.3 man3/strcpy.3 man3/strcspn.3 man3/strdup.3 - man3/strdupa.3 man3/strerror.3 man3/strerror_r.3 man3/strfry.3 - man3/strftime.3 man3/string.3 man3/strlen.3 man3/strncasecmp.3 - man3/strncat.3 man3/strncmp.3 man3/strncpy.3 man3/strndup.3 - man3/strndupa.3 man3/strpbrk.3 man3/strptime.3 man3/strrchr.3 - man3/strsep.3 man3/strsignal.3 man3/strspn.3 man3/strstr.3 - man3/strtok.3 man3/strtok_r.3 man3/strtol.3 man3/strtoll.3 - man3/strtoq.3 man3/strtoul.3 man3/strtoull.3 man3/strtouq.3 - man3/strverscmp.3 man3/strxfrm.3 man3/swab.3 man3/swapcontext.3 - man3/sysconf.3 man3/syslog.3 man3/system.3 man3/sysv_signal.3 - man3/tan.3 man3/tanf.3 man3/tanh.3 man3/tanhf.3 man3/tanhl.3 - man3/tanl.3 man3/tcgetpgrp.3 man3/tcgetsid.3 man3/tcsetpgrp.3 - man3/tdelete.3 man3/tdestroy.3 man3/telldir.3 man3/tempnam.3 - man3/tfind.3 man3/timegm.3 man3/timelocal.3 man3/timeradd.3 - man3/timerclear.3 man3/timercmp.3 man3/timerisset.3 man3/timersub.3 - man3/timezone.3 man3/tmpfile.3 man3/tmpnam.3 man3/tmpnam_r.3 - man3/toascii.3 man3/tolower.3 man3/tolower_l.3 man3/toupper.3 - man3/toupper_l.3 man3/trunc.3 man3/truncf.3 man3/truncl.3 - man3/tsearch.3 man3/ttyslot.3 man3/twalk.3 man3/tzname.3 man3/tzset.3 - man3/ulimit.3 man3/undocumented.3 man3/ungetc.3 man3/unlocked_stdio.3 - man3/unsetenv.3 man3/uselocale.3 man3/usleep.3 man3/valloc.3 - man3/vasprintf.3 man3/vlimit.3 man3/vsyslog.3 man3/vtimes.3 man3/y0.3 - man3/y0f.3 man3/y0l.3 man3/y1.3 man3/y1f.3 man3/y1l.3 man3/yn.3 - man3/ynf.3 man3/ynl.3 man4/cpuid.4 man4/full.4 man4/initrd.4 - man4/mouse.4 man4/msr.4 man4/sd.4 man4/st.4 man5/acct.5 man5/core.5 - man5/ipc.5 man5/numa_maps.5 man5/services.5 man5/slabinfo.5 - man7/aio.7 man7/arp.7 man7/capabilities.7 man7/credentials.7 - man7/ddp.7 man7/fanotify.7 man7/feature_test_macros.7 man7/fifo.7 - man7/glibc.7 man7/hier.7 man7/icmp.7 man7/inotify.7 man7/ip.7 - man7/ipv6.7 man7/libc.7 man7/locale.7 man7/man-pages.7 man7/man.7 + man3/strdupa.3 man3/strerror.3 man3/strerror_l.3 man3/strerror_r.3 + man3/strfry.3 man3/strftime.3 man3/string.3 man3/strlen.3 + man3/strncasecmp.3 man3/strncat.3 man3/strncmp.3 man3/strncpy.3 + man3/strndup.3 man3/strndupa.3 man3/strpbrk.3 man3/strptime.3 + man3/strrchr.3 man3/strsep.3 man3/strsignal.3 man3/strspn.3 + man3/strstr.3 man3/strtok.3 man3/strtok_r.3 man3/strtol.3 + man3/strtoll.3 man3/strtoq.3 man3/strtoul.3 man3/strtoull.3 + man3/strtouq.3 man3/strverscmp.3 man3/strxfrm.3 man3/swab.3 + man3/swapcontext.3 man3/sysconf.3 man3/syslog.3 man3/system.3 + man3/sysv_signal.3 man3/tan.3 man3/tanf.3 man3/tanh.3 man3/tanhf.3 + man3/tanhl.3 man3/tanl.3 man3/tcgetpgrp.3 man3/tcgetsid.3 + man3/tcsetpgrp.3 man3/tdelete.3 man3/tdestroy.3 man3/telldir.3 + man3/tempnam.3 man3/tfind.3 man3/timegm.3 man3/timelocal.3 + man3/timeradd.3 man3/timerclear.3 man3/timercmp.3 man3/timerisset.3 + man3/timersub.3 man3/timezone.3 man3/tmpfile.3 man3/tmpnam.3 + man3/tmpnam_r.3 man3/toascii.3 man3/tolower.3 man3/tolower_l.3 + man3/toupper.3 man3/toupper_l.3 man3/trunc.3 man3/truncf.3 + man3/truncl.3 man3/tsearch.3 man3/ttyslot.3 man3/twalk.3 + man3/tzname.3 man3/tzset.3 man3/ulimit.3 man3/undocumented.3 + man3/ungetc.3 man3/unlocked_stdio.3 man3/unsetenv.3 man3/uselocale.3 + man3/usleep.3 man3/valloc.3 man3/vasprintf.3 man3/vlimit.3 + man3/vsyslog.3 man3/vtimes.3 man3/y0.3 man3/y0f.3 man3/y0l.3 + man3/y1.3 man3/y1f.3 man3/y1l.3 man3/yn.3 man3/ynf.3 man3/ynl.3 + man4/cpuid.4 man4/full.4 man4/initrd.4 man4/mouse.4 man4/msr.4 + man4/sd.4 man4/st.4 man5/acct.5 man5/core.5 man5/ipc.5 + man5/numa_maps.5 man5/services.5 man5/slabinfo.5 man7/aio.7 + man7/arp.7 man7/capabilities.7 man7/credentials.7 man7/ddp.7 + man7/fanotify.7 man7/feature_test_macros.7 man7/fifo.7 man7/glibc.7 + man7/hier.7 man7/icmp.7 man7/inotify.7 man7/ip.7 man7/ipv6.7 + man7/libc.7 man7/locale.7 man7/man-pages.7 man7/man.7 man7/math_error.7 man7/mq_overview.7 man7/namespaces.7 man7/netdevice.7 man7/nptl.7 man7/numa.7 man7/packet.7 man7/path_resolution.7 man7/pid_namespaces.7 man7/pipe.7 @@ -905,6 +911,7 @@ (C) 1998 Heiner Eisen. (C) 1998 Jamie Lokier; (C) 1998 Pawel Krawczyk. + (C) 1999 Andi Kleen , (C) 1999 Andi Kleen . (C) 1999 Andries Brouwer (aeb@cwi.nl) (C) 1999 Claus Fischer. @@ -963,13 +970,13 @@ (C) 2008 Michael Kerrisk (C) 2008 Petr Baudis (dladdr caveat) (C) 2008, 2010, 2015, Michael Kerrisk - (C) 2008, 2012 Michael Kerrisk (C) 2008, 2014 Michael Kerrisk (C) 2008, 2014, Michael Kerrisk + (C) 2008, 2016 Michael Kerrisk (C) 2008, Linux Foundation, written by Michael Kerrisk (C) 2008, Michael Kerrisk (C) 2008, Nanno Langstraat - (C) 2008-2014, Michael Kerrisk + (C) 2008-2014, Michael Kerrisk , (C) 2009 Petr Baudis (C) 2009, Linux Foundation, written by Michael Kerrisk (C) 2010 Intel Corporation, Author: Andi Kleen @@ -1000,8 +1007,12 @@ (C) 2014, Theodore Ts'o (C) 2014,2015 Heinrich Schuchardt (C) 2015 Alexei Starovoitov + (C) 2015 Anna Schumaker (C) 2015 Michael Kerrisk (C) 2015, Michael Kerrisk + (C) 2016 Florian Weimer + (C) 2016, Heinrich Schuchardt + (C) 2016, Michael Kerrisk (C) The Internet Society (1998). All Rights Reserved. (C), 1994, Graeme W. Wilford (Wilf). (C), 1994, Graeme W. Wilford. (Wilf.) @@ -1063,6 +1074,7 @@ (c) 2008 Petr Baudis (c) 2008 by Gerrit Renker (c) 2008, Linux Foundation, written by Michael Kerrisk + (c) 2009 Bill O. Gallmeister (bgallmeister@gmail.com) (c) 2009 Intel Corporation, Author Andi Kleen (c) 2009 Linux Foundation, written by Michael Kerrisk (c) 2009 Michael Kerrisk, @@ -1091,6 +1103,7 @@ (c) 2015 by Michael Kerrisk (c) 2015, IBM Corporation. (c) 2015, Michael Kerrisk + (c) 2016 by Michael Kerrisk 1991, 1992 Free Software Foundation 1992 Rickard E. Faith (faith@cs.unc.edu) 1992-1999 Rickard E. Faith and David A. Wheeler @@ -1135,6 +1148,7 @@ 2008, 2015 Michael Kerrisk 2008, Linux Foundation, written by Michael Kerrisk 2009 Intel Corporation + 2010 Michael Kerrisk 2012 Michael Kerrisk 2013 Michael Kerrisk (mtk.manpages@gmail.com). 2013, Michael kerrisk diff -Nru manpages-4.04/debian/inst manpages-4.05/debian/inst --- manpages-4.04/debian/inst 2016-01-06 16:06:21.000000000 +0000 +++ manpages-4.05/debian/inst 1970-01-01 00:00:00.000000000 +0000 @@ -1,113 +0,0 @@ -#!/bin/bash - -set -e - -install -d -m 755 licenses - -install -d -m 755 debian/manpages/usr/share/man/man{1,2,3,4,5,6,7,8} -install -p -m 644 man2/intro.2 debian/manpages/usr/share/man/man2 -install -p -m 644 man3/intro.3 debian/manpages/usr/share/man/man3 -gzip -9n debian/manpages/usr/share/man/man{2,3}/* - -# Installing manpages files -for i in man[145678]; do - echo "-- Installing section ${i#man}:" - for j in $i/*.*; do - echo -n ${j#*/} - case ${j#*/} in - time.1) - echo -n "(skipped, provided by time)" - ;; - fd.4) - echo -n "(skipped, provided by fdutils)" - ;; - attr.5) - echo -n "(skipped, provided by attr)" - ;; - ftpusers.5) - echo -n "(skipped, provided by ftpd etc.)" - ;; - passwd.5) - echo -n "(skipped, provided by passwd)" - ;; - nscd.conf.5|nscd.8) - echo -n "(skipped, provided by nscd)" - ;; - *) - read Y < $j - case "$Y" in - .so*) - echo -n "(symlinked)" - Y=${Y#.so } - if [ ! -f $Y ] - then - echo -n " (ignored) " - continue - fi - if [ "${Y%/*}" = "$i" ]; then - Y=${Y#*/}.gz - else - Y=../$Y.gz - fi - ln -s $Y debian/manpages/usr/share/man/$j.gz - ;; - *) - install -p -m 644 $j debian/manpages/usr/share/man/$i - perl -pe 'exit if /^\.(Dd|TH)/; s/\.\\"\s*//o' \ - < $j > licenses/`basename $j` - ;; - esac - ;; - esac - echo -n " " - done - gzip -9n debian/manpages/usr/share/man/$i/*.? - echo -done - -# Installing manpages-dev files -for i in man[23]; do - echo "-- Installing section ${i#man}:" - install -d -m 755 debian/manpages-dev/usr/share/man/$i - for j in $i/*.*; do - echo -n ${j#*/} - case ${j#*/} in - intro.*) - ;; - fgetxattr.2|flistxattr.2|fremovexattr.2|fsetxattr.2|\ - getxattr.2|lgetxattr.2|listxattr.2|llistxattr.2|lremovexattr.2|\ - lsetxattr.2|removexattr.2|setxattr.2) - echo -n "(skipped, provided by libattr1-dev)" - ;; - *) - read Y < $j - case "$Y" in - .so*) - echo -n "(symlinked)" - Y=${Y#.so } - if [ ! -f $Y ] - then - echo -n " (ignored) " - continue - fi - if [ "${Y%/*}" = "$i" ]; then - Y=${Y#*/}.gz - else - Y=../$Y.gz - fi - ln -s $Y debian/manpages-dev/usr/share/man/$j.gz - ;; - *) - install -p -m 644 $j debian/manpages-dev/usr/share/man/$i - perl -pe 'exit if /^\.(Dd|TH)/; s/\.\\"\s*//o' \ - < $j > licenses/`basename $j` - ;; - esac - ;; - esac - echo -n " " - done - gzip -9n debian/manpages-dev/usr/share/man/$i/*.? - echo -done - diff -Nru manpages-4.04/debian/patches/0001-fclose.3.patch manpages-4.05/debian/patches/0001-fclose.3.patch --- manpages-4.04/debian/patches/0001-fclose.3.patch 2016-02-15 12:51:38.000000000 +0000 +++ manpages-4.05/debian/patches/0001-fclose.3.patch 2016-03-16 16:43:16.000000000 +0000 @@ -7,7 +7,7 @@ 1 file changed, 10 insertions(+) diff --git a/man3/fclose.3 b/man3/fclose.3 -index c288bd7..77d3fd0 100644 +index d4ccfaa..e6af31d 100644 --- a/man3/fclose.3 +++ b/man3/fclose.3 @@ -56,6 +56,16 @@ function flushes the stream pointed to by diff -Nru manpages-4.04/debian/patches/0002-getpwent.3.patch manpages-4.05/debian/patches/0002-getpwent.3.patch --- manpages-4.04/debian/patches/0002-getpwent.3.patch 2016-02-15 12:51:38.000000000 +0000 +++ manpages-4.05/debian/patches/0002-getpwent.3.patch 2016-03-16 16:43:16.000000000 +0000 @@ -7,7 +7,7 @@ 1 file changed, 19 insertions(+), 1 deletion(-) diff --git a/man3/getpwent.3 b/man3/getpwent.3 -index 63f9ced..c46e21b 100644 +index a39b594..c6d7a36 100644 --- a/man3/getpwent.3 +++ b/man3/getpwent.3 @@ -28,7 +28,8 @@ @@ -18,9 +18,9 @@ +.\" Modified Mon May 27 21:37:47 1996 by Martin Schulze +.\" Modified Thu Dec 13 21:10:55 2001 by Martin Schulze .\" - .TH GETPWENT 3 2015-12-28 "GNU" "Linux Programmer's Manual" + .TH GETPWENT 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME -@@ -97,6 +98,21 @@ struct passwd { +@@ -99,6 +100,21 @@ struct passwd { }; .fi .in @@ -42,7 +42,7 @@ .PP For more information about the fields of this structure, see .BR passwd (5). -@@ -194,6 +210,8 @@ field is not specified in POSIX, but is present on most implementations. +@@ -197,6 +213,8 @@ field is not specified in POSIX, but is present on most implementations. .BR getpwnam (3), .BR getpwuid (3), .BR putpwent (3), @@ -50,4 +50,4 @@ +.BR shadow (5), .BR passwd (5) .SH COLOPHON - This page is part of release 4.04 of the Linux + This page is part of release 4.05 of the Linux diff -Nru manpages-4.04/debian/patches/0003-getpwnam.3.patch manpages-4.05/debian/patches/0003-getpwnam.3.patch --- manpages-4.04/debian/patches/0003-getpwnam.3.patch 2016-02-15 12:51:38.000000000 +0000 +++ manpages-4.05/debian/patches/0003-getpwnam.3.patch 2016-03-16 16:43:16.000000000 +0000 @@ -7,10 +7,10 @@ 1 file changed, 9 insertions(+) diff --git a/man3/getpwnam.3 b/man3/getpwnam.3 -index 8e4ab7e..4146809 100644 +index fc3d7b1..0b290f7 100644 --- a/man3/getpwnam.3 +++ b/man3/getpwnam.3 -@@ -208,10 +208,18 @@ structure. +@@ -209,10 +209,18 @@ structure. .TP .B ERANGE Insufficient buffer space supplied. @@ -29,11 +29,11 @@ .SH ATTRIBUTES For an explanation of the terms used in this section, see .BR attributes (7). -@@ -337,6 +345,7 @@ main(int argc, char *argv[]) +@@ -338,6 +346,7 @@ main(int argc, char *argv[]) .BR getspnam (3), .BR putpwent (3), .BR setpwent (3), +.BR nsswitch.conf (5), .BR passwd (5) .SH COLOPHON - This page is part of release 4.04 of the Linux + This page is part of release 4.05 of the Linux diff -Nru manpages-4.04/debian/patches/0004-nl_langinfo.3.patch manpages-4.05/debian/patches/0004-nl_langinfo.3.patch --- manpages-4.04/debian/patches/0004-nl_langinfo.3.patch 2016-02-15 12:51:38.000000000 +0000 +++ manpages-4.05/debian/patches/0004-nl_langinfo.3.patch 2016-03-16 16:43:16.000000000 +0000 @@ -7,7 +7,7 @@ 1 file changed, 2 insertions(+) diff --git a/man3/nl_langinfo.3 b/man3/nl_langinfo.3 -index b785ce0..b4a87a0 100644 +index 5de78b4..ffaf8b0 100644 --- a/man3/nl_langinfo.3 +++ b/man3/nl_langinfo.3 @@ -45,6 +45,8 @@ which was previously created by diff -Nru manpages-4.04/debian/patches/0005-console_codes.4.patch manpages-4.05/debian/patches/0005-console_codes.4.patch --- manpages-4.04/debian/patches/0005-console_codes.4.patch 2016-02-15 12:51:38.000000000 +0000 +++ manpages-4.05/debian/patches/0005-console_codes.4.patch 2016-03-16 16:43:16.000000000 +0000 @@ -7,7 +7,7 @@ 1 file changed, 4 insertions(+) diff --git a/man4/console_codes.4 b/man4/console_codes.4 -index fb922fe..90daf10 100644 +index c6a5582..79d70bc 100644 --- a/man4/console_codes.4 +++ b/man4/console_codes.4 @@ -19,6 +19,7 @@ diff -Nru manpages-4.04/debian/patches/0006-dir_colors.5.patch manpages-4.05/debian/patches/0006-dir_colors.5.patch --- manpages-4.04/debian/patches/0006-dir_colors.5.patch 2016-02-15 12:51:38.000000000 +0000 +++ manpages-4.05/debian/patches/0006-dir_colors.5.patch 2016-03-16 16:43:16.000000000 +0000 @@ -7,10 +7,10 @@ 1 file changed, 8 insertions(+) diff --git a/man5/dir_colors.5 b/man5/dir_colors.5 -index 84359c9..c805449 100644 +index 30c70c1..2491372 100644 --- a/man5/dir_colors.5 +++ b/man5/dir_colors.5 -@@ -380,9 +380,17 @@ hash mark as the first character. +@@ -377,9 +377,17 @@ hash mark as the first character. .SH FILES .TP .I /etc/DIR_COLORS diff -Nru manpages-4.04/debian/patches/0007-motd.5.patch manpages-4.05/debian/patches/0007-motd.5.patch --- manpages-4.04/debian/patches/0007-motd.5.patch 2016-02-15 12:51:38.000000000 +0000 +++ manpages-4.05/debian/patches/0007-motd.5.patch 2016-03-16 16:43:16.000000000 +0000 @@ -7,7 +7,7 @@ 1 file changed, 14 insertions(+), 3 deletions(-) diff --git a/man5/motd.5 b/man5/motd.5 -index 3219ac7..7b50a0d 100644 +index 721f61f..482a9e6 100644 --- a/man5/motd.5 +++ b/man5/motd.5 @@ -31,17 +31,28 @@ motd \- message of the day @@ -40,5 +40,5 @@ +.BR issue (5), +.BR pam_motd (8) .SH COLOPHON - This page is part of release 4.04 of the Linux + This page is part of release 4.05 of the Linux .I man-pages diff -Nru manpages-4.04/debian/patches/0008-nsswitch.conf.5.patch manpages-4.05/debian/patches/0008-nsswitch.conf.5.patch --- manpages-4.04/debian/patches/0008-nsswitch.conf.5.patch 2016-02-15 12:51:38.000000000 +0000 +++ manpages-4.05/debian/patches/0008-nsswitch.conf.5.patch 2016-03-16 16:43:16.000000000 +0000 @@ -7,12 +7,12 @@ 1 file changed, 5 insertions(+) diff --git a/man5/nsswitch.conf.5 b/man5/nsswitch.conf.5 -index 02a808c..da13b8e 100644 +index 1ea8e20..02ff88a 100644 --- a/man5/nsswitch.conf.5 +++ b/man5/nsswitch.conf.5 -@@ -271,6 +271,11 @@ Include the specified +@@ -277,6 +277,11 @@ Include the specified .I user - from the NIS passwd map. + from the NIS passwd/shadow map. .TP +.BI + user:::::: +Include the specified diff -Nru manpages-4.04/debian/patches/0009-resolv.conf.5.patch manpages-4.05/debian/patches/0009-resolv.conf.5.patch --- manpages-4.04/debian/patches/0009-resolv.conf.5.patch 2016-02-15 12:51:38.000000000 +0000 +++ manpages-4.05/debian/patches/0009-resolv.conf.5.patch 2016-03-16 16:43:16.000000000 +0000 @@ -7,7 +7,7 @@ 1 file changed, 2 insertions(+) diff --git a/man5/resolv.conf.5 b/man5/resolv.conf.5 -index 29bc789..678eb47 100644 +index c33c34b..a2f0850 100644 --- a/man5/resolv.conf.5 +++ b/man5/resolv.conf.5 @@ -207,6 +207,8 @@ This has the effect of trying an AAAA query before an A query inside the diff -Nru manpages-4.04/debian/patches/0010-tzfile.5.patch manpages-4.05/debian/patches/0010-tzfile.5.patch --- manpages-4.04/debian/patches/0010-tzfile.5.patch 2016-02-15 12:51:38.000000000 +0000 +++ manpages-4.05/debian/patches/0010-tzfile.5.patch 2016-03-16 16:43:16.000000000 +0000 @@ -7,7 +7,7 @@ 1 file changed, 16 insertions(+) diff --git a/man5/tzfile.5 b/man5/tzfile.5 -index da7bccd..d919b2b 100644 +index 9fef8f2..1e88a45 100644 --- a/man5/tzfile.5 +++ b/man5/tzfile.5 @@ -151,6 +151,22 @@ if either diff -Nru manpages-4.04/debian/patches/0011-man.7.patch manpages-4.05/debian/patches/0011-man.7.patch --- manpages-4.04/debian/patches/0011-man.7.patch 2016-02-15 12:51:38.000000000 +0000 +++ manpages-4.05/debian/patches/0011-man.7.patch 2016-03-16 16:43:16.000000000 +0000 @@ -7,7 +7,7 @@ 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/man7/man.7 b/man7/man.7 -index 87b49bc..046235d 100644 +index ad54ac2..34221df 100644 --- a/man7/man.7 +++ b/man7/man.7 @@ -563,12 +563,12 @@ is not implemented. @@ -23,5 +23,5 @@ -.BR mdoc.samples (7) +.BR mdoc (7) .SH COLOPHON - This page is part of release 4.04 of the Linux + This page is part of release 4.05 of the Linux .I man-pages diff -Nru manpages-4.04/debian/patches/0012-mdoc.7.patch manpages-4.05/debian/patches/0012-mdoc.7.patch --- manpages-4.04/debian/patches/0012-mdoc.7.patch 2016-02-15 12:51:38.000000000 +0000 +++ manpages-4.05/debian/patches/0012-mdoc.7.patch 2016-03-16 16:43:16.000000000 +0000 @@ -7,7 +7,7 @@ 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/man7/mdoc.7 b/man7/mdoc.7 -index a7ac692..0c6baec 100644 +index 930d8dd..774b087 100644 --- a/man7/mdoc.7 +++ b/man7/mdoc.7 @@ -62,7 +62,7 @@ The macro names and their meanings are diff -Nru manpages-4.04/debian/patches/0013-rtnetlink.7.patch manpages-4.05/debian/patches/0013-rtnetlink.7.patch --- manpages-4.04/debian/patches/0013-rtnetlink.7.patch 2016-02-15 12:51:38.000000000 +0000 +++ manpages-4.05/debian/patches/0013-rtnetlink.7.patch 2016-03-16 16:43:16.000000000 +0000 @@ -7,7 +7,7 @@ 1 file changed, 2 insertions(+) diff --git a/man7/rtnetlink.7 b/man7/rtnetlink.7 -index 180b1b2..1c6a0bc 100644 +index 6a32f8c..c414b2e 100644 --- a/man7/rtnetlink.7 +++ b/man7/rtnetlink.7 @@ -18,6 +18,8 @@ rtnetlink \- Linux IPv4 routing socket diff -Nru manpages-4.04/debian/rules manpages-4.05/debian/rules --- manpages-4.04/debian/rules 2016-02-10 18:43:02.000000000 +0000 +++ manpages-4.05/debian/rules 2016-02-16 19:57:14.000000000 +0000 @@ -42,6 +42,8 @@ rm -f debian/manpages-dev/usr/share/man/man2/lsetxattr.2 rm -f debian/manpages-dev/usr/share/man/man2/removexattr.2 rm -f debian/manpages-dev/usr/share/man/man2/setxattr.2 + # Do not install sk98lin.4, see https://bugs.debian.org/780544 + rm -f debian/manpages/usr/share/man/man4/sk98lin.4 # manpages-dev has no docs dir override_dh_installdocs: diff -Nru manpages-4.04/debian/watch manpages-4.05/debian/watch --- manpages-4.04/debian/watch 2015-12-30 20:53:05.000000000 +0000 +++ manpages-4.05/debian/watch 2016-03-16 16:43:16.000000000 +0000 @@ -1,3 +1,3 @@ version=3 -opts=pgpsigurlmangle=s/$/.asc/ http://www.kernel.org/pub/linux/docs/man-pages/man-pages-(.*)\.tar\.xz -# http://man7.org/linux/download/man-pages/man-pages-(.*)\.tar\.gz +opts=pgpsigurlmangle=s/$/.sign/ https://www.kernel.org/pub/linux/docs/man-pages/ \ +(?:|.*/)man-pages(?:[_\-]v?|)(\d[^\s/]*)\.(?:tar\.xz|txz|tar\.bz2|tbz2|tar\.gz|tgz) diff -Nru manpages-4.04/man1/getent.1 manpages-4.05/man1/getent.1 --- manpages-4.04/man1/getent.1 2015-12-29 12:51:43.000000000 +0000 +++ manpages-4.05/man1/getent.1 2016-03-15 03:47:38.000000000 +0000 @@ -398,11 +398,11 @@ .SH SEE ALSO .BR nsswitch.conf (5) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man1/iconv.1 manpages-4.05/man1/iconv.1 --- manpages-4.04/man1/iconv.1 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man1/iconv.1 2016-03-15 03:47:38.000000000 +0000 @@ -203,11 +203,11 @@ .BR charsets (7), .BR iconvconfig (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man1/intro.1 manpages-4.05/man1/intro.1 --- manpages-4.04/man1/intro.1 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man1/intro.1 2016-03-15 03:47:38.000000000 +0000 @@ -324,11 +324,11 @@ .BR man-pages (7), .BR standards (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man1/ldd.1 manpages-4.05/man1/ldd.1 --- manpages-4.04/man1/ldd.1 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man1/ldd.1 2016-03-15 03:47:38.000000000 +0000 @@ -111,11 +111,11 @@ .BR ld.so (8), .BR ldconfig (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man1/locale.1 manpages-4.05/man1/locale.1 --- manpages-4.04/man1/locale.1 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man1/locale.1 2016-03-15 03:47:38.000000000 +0000 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH LOCALE 1 2015-07-23 "Linux" "Linux User Manual" +.TH LOCALE 1 2016-03-15 "Linux" "Linux User Manual" .SH NAME locale \- get locale-specific information .SH SYNOPSIS @@ -65,6 +65,8 @@ .TP .BR \-m ", " \-\-charmaps Display the available charmaps (character set description files). +To display the current character set for the locale, use +\fBlocale -c charmap\fR. .PP The .B locale @@ -205,11 +207,11 @@ .BR locale (5), .BR locale (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man1/localedef.1 manpages-4.05/man1/localedef.1 --- manpages-4.04/man1/localedef.1 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man1/localedef.1 2016-03-15 03:47:38.000000000 +0000 @@ -31,7 +31,7 @@ .\" Lars Wirzenius to document new functionality (as of GNU .\" C library 2.3.5). .\" -.TH LOCALEDEF 1 2014-12-31 "Linux" "Linux User Manual" +.TH LOCALEDEF 1 2016-03-15 "Linux" "Linux User Manual" .SH NAME localedef \- compile locale definition files .SH SYNOPSIS @@ -243,6 +243,9 @@ .I outputpath as a subdirectory in the same directory as the locale archive file, and create separate output files for locale categories in it. +This is helpful to prevent system locale archive updates from overwriting +custom locales created with +.BR localedef . .TP .BR \-? ", " \-\-help Print a usage summary and exit. @@ -369,11 +372,11 @@ .BR repertoiremap (5), .BR locale (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man1/memusage.1 manpages-4.05/man1/memusage.1 --- manpages-4.04/man1/memusage.1 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man1/memusage.1 2016-03-15 03:47:38.000000000 +0000 @@ -120,7 +120,6 @@ the additional field "free" shows reallocations that caused a block to be freed (i.e., the reallocated size was 0). - The "realloc/total memory" of the table output by .B memusage does not reflect cases where @@ -273,11 +272,11 @@ .BR mtrace (1) .BR ld.so (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man1/memusagestat.1 manpages-4.05/man1/memusagestat.1 --- manpages-4.04/man1/memusagestat.1 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man1/memusagestat.1 2016-03-15 03:47:38.000000000 +0000 @@ -89,11 +89,11 @@ .BR memusage (1), .BR mtrace (1) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man1/mtrace.1 manpages-4.05/man1/mtrace.1 --- manpages-4.04/man1/mtrace.1 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man1/mtrace.1 2016-03-15 03:47:38.000000000 +0000 @@ -62,11 +62,11 @@ .BR memusage (1), .BR mtrace (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man1/pldd.1 manpages-4.05/man1/pldd.1 --- manpages-4.04/man1/pldd.1 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man1/pldd.1 2016-03-15 03:47:38.000000000 +0000 @@ -94,11 +94,11 @@ .BR dlopen (3), .BR ld.so (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man1/sprof.1 manpages-4.05/man1/sprof.1 --- manpages-4.04/man1/sprof.1 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man1/sprof.1 2016-03-15 03:47:38.000000000 +0000 @@ -301,11 +301,11 @@ .BR ldd (1), .BR ld.so (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man1/time.1 manpages-4.05/man1/time.1 --- manpages-4.04/man1/time.1 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man1/time.1 2016-03-15 03:47:38.000000000 +0000 @@ -322,11 +322,11 @@ .BR times (2), .BR wait3 (2) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/accept.2 manpages-4.05/man2/accept.2 --- manpages-4.04/man2/accept.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/accept.2 2016-03-15 03:47:38.000000000 +0000 @@ -38,7 +38,7 @@ .\" Modified 2004-06-17 by Michael Kerrisk .\" 2008-12-04, mtk, Add documentation of accept4() .\" -.TH ACCEPT 2 2015-12-28 "Linux" "Linux Programmer's Manual" +.TH ACCEPT 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME accept, accept4 \- accept a connection on a socket .SH SYNOPSIS @@ -146,7 +146,7 @@ Confirmation can be implied by a normal read or write on the new file descriptor, and rejection can be implied by closing the new socket. -Currently only +Currently, only DECNet has these semantics on Linux. @@ -179,7 +179,7 @@ for reasons why this may be useful. .SH RETURN VALUE On success, -these system calls return a nonnegative integer that is a descriptor +these system calls return a nonnegative integer that is a file descriptor for the accepted socket. On error, \-1 is returned, and .I errno @@ -223,7 +223,8 @@ so a portable application should check for both possibilities. .TP .B EBADF -The descriptor is invalid. +.I sockfd +is not an open file descriptor. .TP .B ECONNABORTED A connection has been aborted. @@ -389,11 +390,11 @@ .BR socket (2), .BR socket (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/access.2 manpages-4.05/man2/access.2 --- manpages-4.04/man2/access.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/access.2 2016-03-15 03:47:38.000000000 +0000 @@ -40,7 +40,7 @@ .\" Modified 2004-06-23 by Michael Kerrisk .\" 2007-06-10, mtk, various parts rewritten, and added BUGS section. .\" -.TH ACCESS 2 2015-07-23 "Linux" "Linux Programmer's Manual" +.TH ACCESS 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME access, faccessat \- check user's permissions for a file .SH SYNOPSIS @@ -67,7 +67,7 @@ .RS 4 .TP 4 Since glibc 2.10: -_XOPEN_SOURCE\ >=\ 700 || _POSIX_C_SOURCE\ >=\ 200809L +_POSIX_C_SOURCE\ >=\ 200809L .TP Before glibc 2.10: _ATFILE_SOURCE @@ -414,11 +414,11 @@ .BR path_resolution (7), .BR symlink (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/acct.2 manpages-4.05/man2/acct.2 --- manpages-4.04/man2/acct.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/acct.2 2016-03-15 03:47:38.000000000 +0000 @@ -28,7 +28,7 @@ .\" Modified 1998-11-04 by Tigran Aivazian .\" Modified 2004-05-27, 2004-06-17, 2004-06-23 by Michael Kerrisk .\" -.TH ACCT 2 2015-12-28 "Linux" "Linux Programmer's Manual" +.TH ACCT 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME acct \- switch process accounting on or off .SH SYNOPSIS @@ -46,7 +46,15 @@ .in .sp .BR acct (): -_BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE\ <\ 500) +.nf + Since glibc 2.21: +.\" commit 266865c0e7b79d4196e2cc393693463f03c90bd8 + _DEFAULT_SOURCE + In glibc 2.19 and 2.20: + _DEFAULT_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE\ <\ 500) + Up to and including glibc 2.19: + _BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE\ <\ 500) +.fi .SH DESCRIPTION The .BR acct () @@ -143,11 +151,11 @@ .SH SEE ALSO .BR acct (5) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/add_key.2 manpages-4.05/man2/add_key.2 --- manpages-4.04/man2/add_key.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/add_key.2 2016-03-15 03:47:38.000000000 +0000 @@ -130,11 +130,11 @@ .BR keyctl (3), .BR keyrings (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/adjtimex.2 manpages-4.05/man2/adjtimex.2 --- manpages-4.04/man2/adjtimex.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/adjtimex.2 2016-03-15 03:47:38.000000000 +0000 @@ -1,5 +1,5 @@ .\" Copyright (c) 1995 Michael Chastain (mec@shell.portal.com), 15 April 1995. -.\" and Copyright (C) 2014 Michael Kerrisk +.\" and Copyright (C) 2014, 2016 Michael Kerrisk .\" .\" %%%LICENSE_START(GPLv2+_DOC_FULL) .\" This is free documentation; you can redistribute it and/or @@ -26,15 +26,16 @@ .\" Modified 1997-07-30 by Paul Slootman .\" Modified 2004-05-27 by Michael Kerrisk .\" -.TH ADJTIMEX 2 2014-12-31 "Linux" "Linux Programmer's Manual" +.TH ADJTIMEX 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME -adjtimex \- tune kernel clock +adjtimex, ntp_adjtime \- tune kernel clock .SH SYNOPSIS .nf -.BR "#define _BSD_SOURCE" " /* See feature_test_macros(7) */" .B #include .BI "int adjtimex(struct timex *" "buf" ); + +.BI "int ntp_adjtime(struct timex *" buf ); .fi .SH DESCRIPTION Linux uses David L. Mills' clock adjustment algorithm (see RFC\ 5905). @@ -43,8 +44,8 @@ reads and optionally sets adjustment parameters for this algorithm. It takes a pointer to a .I timex -structure, updates kernel parameters from field values, -and returns the same structure with current kernel values. +structure, updates kernel parameters from (selected) field values, +and returns the same structure updated with the current kernel values. This structure is declared as follows: .PP .in +4n @@ -52,33 +53,40 @@ struct timex { int modes; /* Mode selector */ long offset; /* Time offset; nanoseconds, if STA_NANO - status flag is set, otherwise microseconds */ - long freq; /* Frequency offset, in units of 2^-16 ppm - (parts per million, see NOTES below) */ + status flag is set, otherwise + microseconds */ + long freq; /* Frequency offset; see NOTES for units */ long maxerror; /* Maximum error (microseconds) */ long esterror; /* Estimated error (microseconds) */ int status; /* Clock command/status */ long constant; /* PLL (phase-locked loop) time constant */ - long precision; /* Clock precision (microseconds, read-only) */ - long tolerance; /* Clock frequency tolerance (ppm, read-only) */ + long precision; /* Clock precision + (microseconds, read-only) */ + long tolerance; /* Clock frequency tolerance (read-only); + see NOTES for units */ struct timeval time; /* Current time (read-only, except for ADJ_SETOFFSET); upon return, time.tv_usec contains nanoseconds, if STA_NANO status flag is set, otherwise microseconds */ long tick; /* Microseconds between clock ticks */ - long ppsfreq; /* PPS (pulse per second) frequency (in units - of 2^-16 ppm\-\-see NOTES, read-only) */ + long ppsfreq; /* PPS (pulse per second) frequency + (read-only); see NOTES for units */ long jitter; /* PPS jitter (read-only); nanoseconds, if STA_NANO status flag is set, otherwise microseconds */ - int shift; /* PPS interval duration (seconds, read-only) */ - long stabil; /* PPS stability (2^-16 ppm\-\-see NOTES, - read-only) */ - long jitcnt; /* PPS jitter limit exceeded (read-only) */ - long calcnt; /* PPS calibration intervals (read-only) */ - long errcnt; /* PPS calibration errors (read-only) */ - long stbcnt; /* PPS stability limit exceeded (read-only) */ + int shift; /* PPS interval duration + (seconds, read-only) */ + long stabil; /* PPS stability (read-only); + see NOTES for units */ + long jitcnt; /* PPS count of jitter limit exceeded + events (read-only) */ + long calcnt; /* PPS count of calibration intervals + (read-only) */ + long errcnt; /* PPS count of calibration errors + (read-only) */ + long stbcnt; /* PPS count of stability limit exceeded + events (read-only) */ int tai; /* TAI offset, as set by previous ADJ_TAI operation (seconds, read-only, since Linux 2.6.26) */ @@ -90,6 +98,10 @@ The .I modes field determines which parameters, if any, to set. +(As described later in this page, +the constants used for +.BR ntp_adjtime () +are equivalent but differently named.) It is a bit mask containing a .RI bitwise- or combination of zero or more of the following bits: @@ -97,10 +109,22 @@ .BR ADJ_OFFSET Set time offset from .IR buf.offset . +Since Linux 2.6.26, +.\" commit 074b3b87941c99bc0ce35385b5817924b1ed0c23 +the supplied value is clamped to the range (\-0.5s, +0.5s). +In older kernels, an +.B EINVAL +error occurs if the supplied value is out of range. .TP .BR ADJ_FREQUENCY Set frequency offset from .IR buf.freq . +Since Linux 2.6.26, +.\" commit 074b3b87941c99bc0ce35385b5817924b1ed0c23 +the supplied value is clamped to the range (\-32768000, +32768000). +In older kernels, an +.B EINVAL +error occurs if the supplied value is out of range. .TP .BR ADJ_MAXERROR Set maximum time error from @@ -111,8 +135,9 @@ .IR buf.esterror . .TP .BR ADJ_STATUS -Set clock status from +Set clock status bits from .IR buf.status . +A description of these bits is provided below. .TP .BR ADJ_TIMECONST Set PLL time constant from @@ -154,13 +179,13 @@ .BR ADJ_TAI " (since Linux 2.6.26)" .\" commit 153b5d054ac2d98ea0d86504884326b6777f683d Set TAI (Atomic International Time) offset from -.IR buf->constant . +.IR buf.constant . .BR ADJ_TAI should not be used in conjunction with .BR ADJ_TIMECONST , since the latter mode also employs the -.IR buf->constant +.IR buf.constant field. For a complete explanation of TAI @@ -218,50 +243,88 @@ Some bits in the mask are both readable and settable, while others are read-only. .TP -.BR STA_PLL -Enable phase-locked loop (PLL) updates (read-write) via +.BR STA_PLL " (read-write)" +Enable phase-locked loop (PLL) updates via .BR ADJ_OFFSET . .TP -.BR STA_PPSFREQ -Enable PPS freq discipline (read-write). -.TP -.BR STA_PPSTIME -Enable PPS time discipline (read-write). -.TP -.BR STA_FLL -Select frequency-locked loop (FLL) mode (read-write). -.TP -.BR STA_INS -Insert leap second (read-write). -.TP -.BR STA_DEL -Delete leap second (read-write). -.TP -.BR STA_UNSYNC -Clock unsynchronized (read-write). -.TP -.BR STA_FREQHOLD -Hold frequency (read-write). +.BR STA_PPSFREQ " (read-write)" +Enable PPS (pulse-per-second) frequency discipline. .TP -.BR STA_PPSSIGNAL -PPS signal present (read-only). +.BR STA_PPSTIME " (read-write)" +Enable PPS time discipline. .TP -.BR STA_PPSJITTER -PPS signal jitter exceeded (read-only). +.BR STA_FLL " (read-write)" +Select frequency-locked loop (FLL) mode. .TP -.BR STA_PPSWANDER -PPS signal wander exceeded (read-only). -.TP -.BR STA_PPSERROR -PPS signal calibration error (read-only). +.BR STA_INS " (read-write)" +Insert a leap second after the last second of the UTC day, +thus extending the last minute of the day by one second. +Leap-second insertion will occur each day, so long as this flag remains set. +.\" John Stultz; +.\" Usually this is written as extending the day by one second, +.\" which is represented as: +.\" 23:59:59 +.\" 23:59:60 +.\" 00:00:00 +.\" +.\" But since posix cannot represent 23:59:60, we repeat the last second: +.\" 23:59:59 + TIME_INS +.\" 23:59:59 + TIME_OOP +.\" 00:00:00 + TIME_WAIT +.\" .TP -.BR STA_CLOCKERR -Clock hardware fault (read-only). +.BR STA_DEL " (read-write)" +Delete a leap second at the last second of the UTC day. +.\" John Stultz: +.\" Similarly the progression here is: +.\" 23:59:57 + TIME_DEL +.\" 23:59:58 + TIME_DEL +.\" 00:00:00 + TIME_WAIT +Leap second deletion will occur each day, so long as this flag +remains set. +.\" FIXME Does there need to be a statement that it is nonsensical to set +.\" to set both STA_INS and STA_DEL? +.TP +.BR STA_UNSYNC " (read-write)" +Clock unsynchronized. +.TP +.BR STA_FREQHOLD " (read-write)" +Hold frequency. +.\" Following text from John Stultz: +Normally adjustments made via +.B ADJ_OFFSET +result in dampened frequency adjustments also being made. +So a single call corrects the current offset, +but as offsets in the same direction are made repeatedly, +the small frequency adjustments will accumulate to fix the long-term skew. + +This flag prevents the small frequency adjustment from being made +when correcting for an +.B ADJ_OFFSET +value. +.\" According to the Kernel Application Program Interface document, +.\" STA_FREQHOLD is not used by the NTP version 4 daemon +.TP +.BR STA_PPSSIGNAL " (read-only)" +A valid PPS (pulse-per-second) signal is present. +.TP +.BR STA_PPSJITTER " (read-only)" +PPS signal jitter exceeded. +.TP +.BR STA_PPSWANDER " (read-only)" +PPS signal wander exceeded. +.TP +.BR STA_PPSERROR " (read-only)" +PPS signal calibration error. +.TP +.BR STA_CLOCKERR " (read-only)" +Clock hardware fault. +.\" Not set in current kernel (4.5), but checked in a few places .TP -.BR STA_NANO " (since Linux 2.6.26)" +.BR STA_NANO " (read-only; since Linux 2.6.26)" .\" commit eea83d896e318bda54be2d2770d2c5d6668d11db .\" Author: Roman Zippel -Resolution (0 = microsecond, 1 = nanoseconds; read-only). +Resolution (0 = microsecond, 1 = nanoseconds). Set via .BR ADJ_NANO , cleared via @@ -270,49 +333,118 @@ .BR STA_MODE " (since Linux 2.6.26)" .\" commit eea83d896e318bda54be2d2770d2c5d6668d11db .\" Author: Roman Zippel -Mode (0 = Phase Locked Loop, 1 = Frequency Locked Loop; read-only). +Mode (0 = Phase Locked Loop, 1 = Frequency Locked Loop). .TP -.BR STA_CLK " (since Linux 2.6.26)" +.BR STA_CLK " (read-only; since Linux 2.6.26)" .\" commit eea83d896e318bda54be2d2770d2c5d6668d11db .\" Author: Roman Zippel -Clock source (0 = A, 1 = B; read-only). -.\" FIXME It would be helpful to have some explanation of what -.\" "Clock source" is. +Clock source (0 = A, 1 = B); currently unused. .PP Attempts to set read-only .I status bits are silently ignored. +.\" +.SS ntp_adjtime () +The +.BR ntp_adjtime () +library function +(described in the NTP "Kernel Application Program API", KAPI) +is a more portable interface for performing the same task as +.BR adjtimex (). +Other than the following points, it is identical to +.BR adjtime (): +.IP * 3 +The constants used in +.I modes +are prefixed with "MOD_" rather than "ADJ_", and have the same suffixes (thus, +.BR MOD_OFFSET , +.BR MOD_FREQUENCY , +and so on), other than the exceptions noted in the following points. +.IP * +.BR MOD_CLKA +is the synonym for +.BR ADJ_OFFSET_SINGLESHOT . +.IP * +.BR MOD_CLKB +is the synonym for +.BR ADJ_TICK . +.IP * +The is no synonym for +.BR ADJ_OFFSET_SS_READ , +which is not described in the KAPI. .SH RETURN VALUE On success, .BR adjtimex () -returns the clock state; that is, one of the following values: +and +.BR ntp_adjtime () +return the clock state; that is, one of the following values: .TP 12 .BR TIME_OK -Clock synchronized. +Clock synchronized, no leap second adjustment pending. .TP .BR TIME_INS -Insert leap second. +Indicates that a leap second will be added at the end of the UTC day. .TP .BR TIME_DEL -Delete leap second. +Indicates that a leap second will be deleted at the end of the UTC day. .TP .BR TIME_OOP -Leap second in progress. +Insertion of a leap second is in progress. .TP .BR TIME_WAIT -Leap second has occurred. +A leap-second insertion or deletion has been completed. +This value will be returned until the next +.BR ADJ_STATUS +operation clears the +.B STA_INS +and +.B STA_DEL +flags. .TP .BR TIME_ERROR -Clock not synchronized. +The system clock is not synchronized to a reliable server. +This value is returned when any of the following holds true: +.RS +.IP * 3 +Either +.B STA_UNSYNC +or +.B STA_CLOCKERR +is set. +.IP * +.B STA_PPSSIGNAL +is clear and either +.B STA_PPSFREQ +or +.B STA_PPSTIME +is set. +.IP * +.B STA_PPSTIME +and +.B STA_PPSJITTER +are both set. +.IP * +.B STA_PPSFREQ +is set and either +.B STA_PPSWANDER +or +.B STA_PPSJITTER +is set. +.RE +.IP The symbolic name .B TIME_BAD is a synonym for .BR TIME_ERROR , provided for backward compatibility. .PP -On failure, -.BR adjtimex () -returns \-1 and sets +Note that starting with Linux 3.4, +.\" commit 6b43ae8a619d17c4935c3320d2ef9e92bdeed05d changed to asynchronous +.\" operation, so we can no longer rely on the return code. +the call operates asynchronously and the return value usually will +not reflect a state change caused by the call itself. +.PP +On failure, these calls return \-1 and set .IR errno . .SH ERRORS .TP @@ -320,14 +452,27 @@ .I buf does not point to writable memory. .TP -.B EINVAL +.BR EINVAL " (kernels before Linux 2.6.26)" +An attempt was made to set +.I buf.freq +to a value outside the range (\-33554432, +33554432). +.\" From a quick glance, it appears there was no clamping or range check +.\" for buf.freq in kernels before 2.0 +.TP +.BR EINVAL " (kernels before Linux 2.6.26)" An attempt was made to set .I buf.offset -to a value outside the range \-131071 to +131071, -or to set +to a value outside the permitted range. +In kernels before Linux 2.0, the permitted range was (\-131072, +131072). +From Linux 2.0 onwards, the permitted range was (\-512000, +512000). +.TP +.B EINVAL +An attempt was made to set .I buf.status -to a value other than those listed above, -or to set +to a value other than those listed above. +.TP +.B EINVAL +An attempt was made to set .I buf.tick to a value outside the range .RB 900000/ HZ @@ -358,26 +503,53 @@ This is the case for both input values (in the case of .IR freq ) and output values. + +The leap-second processing triggered by +.B STA_INS +and +.B STA_DEL +is done by the kernel in timer context +Thus, it will take one tick into the second +for the leap second to be inserted or deleted. +.SH ATTRIBUTES +For an explanation of the terms used in this section, see +.BR attributes (7). +.TS +allbox; +lb lb lb +l l l. +Interface Attribute Value +T{ +.BR ntp_adjtime () +T} Thread safety MT-Safe +.TE .SH CONFORMING TO +Neither of these interfaces is described in POSIX.1 + .BR adjtimex () is Linux-specific and should not be used in programs intended to be portable. -See -.BR adjtime (3) -for a more portable, but less flexible, -method of adjusting the system clock. + +The preferred API for the NTP daemon is +.BR ntp_adjtime (3). .SH SEE ALSO .BR settimeofday (2), .BR adjtime (3), +.BR ntp_gettime (3), .BR capabilities (7), .BR time (7), .BR adjtimex (8) + +.ad l +.UR http://www.slac.stanford.edu/comp/unix/\:package/\:rtems/\:src/\:ssrlApps/\:ntpNanoclock/\:api.htm +NTP "Kernel Application Program Interface" +.UE .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/alarm.2 manpages-4.05/man2/alarm.2 --- manpages-4.04/man2/alarm.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/alarm.2 2016-03-15 03:47:38.000000000 +0000 @@ -93,11 +93,11 @@ .BR sleep (3), .BR time (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/alloc_hugepages.2 manpages-4.05/man2/alloc_hugepages.2 --- manpages-4.04/man2/alloc_hugepages.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/alloc_hugepages.2 2016-03-15 03:47:38.000000000 +0000 @@ -148,11 +148,11 @@ .\" mount -t hugetlbfs hugetlbfs /huge .\" SHM_HUGETLB .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/arch_prctl.2 manpages-4.05/man2/arch_prctl.2 --- manpages-4.04/man2/arch_prctl.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/arch_prctl.2 2016-03-15 03:47:38.000000000 +0000 @@ -150,11 +150,11 @@ AMD X86-64 Programmer's manual .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/bdflush.2 manpages-4.05/man2/bdflush.2 --- manpages-4.04/man2/bdflush.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/bdflush.2 2016-03-15 03:47:38.000000000 +0000 @@ -24,7 +24,7 @@ .\" Modified 1997-01-31 by Eric S. Raymond .\" Modified 2004-06-17 by Michael Kerrisk .\" -.TH BDFLUSH 2 2014-08-19 "Linux" "Linux Programmer's Manual" +.TH BDFLUSH 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME bdflush \- start, flush, or tune buffer-dirty-flush daemon .SH SYNOPSIS @@ -112,6 +112,8 @@ Caller does not have the .B CAP_SYS_ADMIN capability. +.SH +Since version 2.23, glibc no longer supports this obsolete system call. .SH CONFORMING TO .BR bdflush () is Linux-specific and should not be used in programs @@ -121,11 +123,11 @@ .BR sync (2), .BR sync (1) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/bind.2 manpages-4.05/man2/bind.2 --- manpages-4.04/man2/bind.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/bind.2 2016-03-15 03:47:38.000000000 +0000 @@ -65,7 +65,7 @@ .\" $Id: bind.2,v 1.3 1999/04/23 19:56:07 freitag Exp $ .\" Modified 2004-06-23 by Michael Kerrisk .\" -.TH BIND 2 2015-12-28 "Linux" "Linux Programmer's Manual" +.TH BIND 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME bind \- bind a name to a socket .SH SYNOPSIS @@ -173,10 +173,9 @@ .I /proc/sys/net/ipv4/ip_local_port_range .BR ip (7). .TP -.TP .B EBADF .I sockfd -is not a valid descriptor. +is not a valid file descriptor. .TP .B EINVAL The socket is already bound to an address. @@ -220,7 +219,7 @@ is too long. .TP .B ENOENT -The file does not exist. +A component in the directory prefix of the socket pathname does not exist. .TP .B ENOMEM Insufficient kernel memory was available. @@ -341,11 +340,11 @@ .BR socket (7), .BR unix (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/bpf.2 manpages-4.05/man2/bpf.2 --- manpages-4.04/man2/bpf.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/bpf.2 2016-03-15 03:47:38.000000000 +0000 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH BPF 2 2015-07-23 "Linux" "Linux Programmer's Manual" +.TH BPF 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME bpf - perform a command on an extended BPF map or program .SH SYNOPSIS @@ -153,6 +153,9 @@ .TP .B BPF_MAP_CREATE Create a map and return a file descriptor that refers to the map. +The close-on-exec file descriptor flag (see +.BR fcntl (2)) +is automatically enabled for the new file descriptor. .TP .B BPF_MAP_LOOKUP_ELEM Look up an element by key in a specified map and return its value. @@ -170,6 +173,9 @@ .B BPF_PROG_LOAD Verify and load an eBPF program, returning a new file descriptor associated with the program. +The close-on-exec file descriptor flag (see +.BR fcntl (2)) +is automatically enabled for the new file descriptor. .P The .I bpf_attr @@ -1157,11 +1163,11 @@ Both classic and extended BPF are explained in the kernel source file .IR Documentation/networking/filter.txt . .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/brk.2 manpages-4.05/man2/brk.2 --- manpages-4.04/man2/brk.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/brk.2 2016-03-15 03:47:38.000000000 +0000 @@ -26,7 +26,7 @@ .\" Modified Wed Jul 21 19:52:58 1993 by Rik Faith .\" Modified Sun Aug 21 17:40:38 1994 by Rik Faith .\" -.TH BRK 2 2015-07-23 "Linux" "Linux Programmer's Manual" +.TH BRK 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME brk, sbrk \- change data segment size .SH SYNOPSIS @@ -47,17 +47,27 @@ .RS 4 .PD 0 .TP 4 -Since glibc 2.12: +Since glibc 2.19: .nf -_BSD_SOURCE || _SVID_SOURCE || - (_XOPEN_SOURCE\ >=\ 500 || - _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED) && - !(_POSIX_C_SOURCE\ >=\ 200112L || _XOPEN_SOURCE\ >=\ 600) +_DEFAULT_SOURCE || + (_XOPEN_SOURCE\ >=\ 500) && +.\" (_XOPEN_SOURCE\ >=\ 500 || +.\" _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED) && + ! (_POSIX_C_SOURCE\ >=\ 200112L) +.fi .TP 4 +From glibc 2.12 to 2.19: +.nf +_BSD_SOURCE || _SVID_SOURCE || + (_XOPEN_SOURCE\ >=\ 500) && +.\" (_XOPEN_SOURCE\ >=\ 500 || +.\" _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED) && + ! (_POSIX_C_SOURCE\ >=\ 200112L) .fi +.TP 4 Before glibc 2.12: -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 || -_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED +_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 +.\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED .PD .RE .ad b @@ -166,11 +176,11 @@ .BR end (3), .BR malloc (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/cacheflush.2 manpages-4.05/man2/cacheflush.2 --- manpages-4.04/man2/cacheflush.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/cacheflush.2 2016-03-15 03:47:38.000000000 +0000 @@ -102,11 +102,11 @@ .I cache argument. .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/capget.2 manpages-4.05/man2/capget.2 --- manpages-4.04/man2/capget.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/capget.2 2016-03-15 03:47:38.000000000 +0000 @@ -72,7 +72,6 @@ .\" commit ca05a99a54db1db5bca72eccb5866d2a86f8517f #define _LINUX_CAPABILITY_U32S_3 2 - typedef struct __user_cap_header_struct { __u32 version; int pid; @@ -244,11 +243,11 @@ .BR gettid (2), .BR capabilities (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/chdir.2 manpages-4.05/man2/chdir.2 --- manpages-4.04/man2/chdir.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/chdir.2 2016-03-15 03:47:38.000000000 +0000 @@ -30,7 +30,7 @@ .\" Modified 1997-08-21 by Joseph S. Myers .\" Modified 2004-06-23 by Michael Kerrisk .\" -.TH CHDIR 2 2015-08-08 "Linux" "Linux Programmer's Manual" +.TH CHDIR 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME chdir, fchdir \- change working directory .SH SYNOPSIS @@ -49,10 +49,10 @@ .PD 0 .ad l .RS 4 -_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 || -_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED -.br -|| /* Since glibc 2.12: */ _POSIX_C_SOURCE\ >=\ 200809L +_XOPEN_SOURCE\ >=\ 500 +.\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED + || /* Since glibc 2.12: */ _POSIX_C_SOURCE\ >=\ 200809L + || /* Glibc up to and including 2.19: */ _BSD_SOURCE .RE .ad .PD @@ -101,7 +101,9 @@ is too long. .TP .B ENOENT -The file does not exist. +The directory specified in +.I path +does not exist. .TP .B ENOMEM Insufficient kernel memory was available. @@ -138,11 +140,11 @@ .BR getcwd (3), .BR path_resolution (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/chmod.2 manpages-4.05/man2/chmod.2 --- manpages-4.04/man2/chmod.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/chmod.2 2016-03-15 03:47:38.000000000 +0000 @@ -29,7 +29,7 @@ .\" : NFS details .\" Modified 2004-06-23 by Michael Kerrisk .\" -.TH CHMOD 2 2015-07-23 "Linux" "Linux Programmer's Manual" +.TH CHMOD 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME chmod, fchmod, fchmodat \- change permissions of a file .SH SYNOPSIS @@ -56,11 +56,11 @@ .PD 0 .BR fchmod (): .RS 4 -_BSD_SOURCE || -_XOPEN_SOURCE\ >=\ 500 || -_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED -.br -|| /* Since glibc 2.12: */ _POSIX_C_SOURCE\ >=\ 200809L +/* Since glibc 2.16: */ _POSIX_C_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE + || /* Glibc versions <= 2.15: */ _XOPEN_SOURCE\ >=\ 500 +.\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED + || /* Glibc 2.12 to 2.15: */ _POSIX_C_SOURCE\ >=\ 200809L .RE .PD .sp @@ -70,7 +70,7 @@ .RS 4 .TP 4 Since glibc 2.10: -_XOPEN_SOURCE\ >=\ 700 || _POSIX_C_SOURCE\ >=\ 200809L +_POSIX_C_SOURCE\ >=\ 200809L .TP Before glibc 2.10: _ATFILE_SOURCE @@ -83,19 +83,21 @@ .BR chmod () and .BR fchmod () -system calls change the permissions of a file. -They differ only in how the file is specified: +system calls change a files mode bits. +(The file mode consists of the file permission bits plus the set-user-ID, +set-group-ID, and sticky bits.) +These system calls differ only in how the file is specified: .IP * 2 .BR chmod () -changes the permissions of the file specified whose pathname is given in +changes the mode of the file specified whose pathname is given in .IR pathname , which is dereferenced if it is a symbolic link. .IP * .BR fchmod () -changes the permissions of the file referred to by the open file descriptor +changes the mode of the file referred to by the open file descriptor .IR fd . .PP -The new file permissions are specified in +The new file mode is specified in .IR mode , which is a bit mask created by ORing together zero or more of the following: @@ -366,11 +368,11 @@ .BR path_resolution (7), .BR symlink (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/chown.2 manpages-4.05/man2/chown.2 --- manpages-4.04/man2/chown.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/chown.2 2016-03-15 03:47:38.000000000 +0000 @@ -35,7 +35,7 @@ .\" (bsdgroups versus sysvgroups, and the effect of the parent .\" directory's set-group-ID mode bit). .\" -.TH CHOWN 2 2015-05-07 "Linux" "Linux Programmer's Manual" +.TH CHOWN 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME chown, fchown, lchown, fchownat \- change ownership of a file .SH SYNOPSIS @@ -55,7 +55,6 @@ .BI " uid_t " owner ", gid_t " group ", int " flags ); .fi .sp -.sp .in -4n Feature Test Macro Requirements for glibc (see .BR feature_test_macros (7)): @@ -66,10 +65,10 @@ .PD 0 .ad l .RS 4 -_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 || -_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED -.br -|| /* Since glibc 2.12: */ _POSIX_C_SOURCE\ >=\ 200809L +/* Since glibc 2.12: */ _POSIX_C_SOURCE\ >=\ 200809L + || _XOPEN_SOURCE\ >=\ 500 +.\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED + || /* Glibc versions <= 2.19: */ _BSD_SOURCE .RE .sp .BR fchownat (): @@ -78,7 +77,7 @@ .RS 4 .TP 4 Since glibc 2.10: -_XOPEN_SOURCE\ >=\ 700 || _POSIX_C_SOURCE\ >=\ 200809L +_POSIX_C_SOURCE\ >=\ 200809L .TP Before glibc 2.10: _ATFILE_SOURCE @@ -123,8 +122,8 @@ .I group is specified as \-1, then that ID is not changed. -When the owner or group of an executable file are -changed by an unprivileged user the +When the owner or group of an executable file is +changed by an unprivileged user, the .B S_ISUID and .B S_ISGID @@ -204,7 +203,6 @@ .B _GNU_SOURCE .\" Before glibc 2.16, defining _ATFILE_SOURCE sufficed to obtain its definition. - .TP .B AT_SYMLINK_NOFOLLOW If @@ -272,7 +270,8 @@ are listed below: .TP .B EBADF -The descriptor is not valid. +.I fd +is not a valid open file descriptor. .TP .B EIO A low-level I/O error occurred while modifying the inode. @@ -493,11 +492,11 @@ .BR path_resolution (7), .BR symlink (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/chroot.2 manpages-4.05/man2/chroot.2 --- manpages-4.04/man2/chroot.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/chroot.2 2016-03-15 03:47:38.000000000 +0000 @@ -30,7 +30,7 @@ .\" Modified 1997-08-21 by Joseph S. Myers .\" Modified 2004-06-23 by Michael Kerrisk .\" -.TH CHROOT 2 2015-07-23 "Linux" "Linux Programmer's Manual" +.TH CHROOT 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME chroot \- change root directory .SH SYNOPSIS @@ -50,10 +50,9 @@ .TP 4 Since glibc 2.2.2: .nf -_BSD_SOURCE || - (_XOPEN_SOURCE\ >=\ 500 || - _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED) && - !(_POSIX_C_SOURCE\ >=\ 200112L || _XOPEN_SOURCE\ >=\ 600) +_XOPEN_SOURCE && ! (_POSIX_C_SOURCE\ >=\ 200112L) + || /* Since glibc 2.20: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE .TP 4 .fi Before glibc 2.2.2: none @@ -112,7 +111,6 @@ This call does not close open file descriptors, and such file descriptors may allow access to files outside the chroot tree. - .SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and @@ -178,11 +176,11 @@ .BR chdir (2), .BR path_resolution (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/clock_getres.2 manpages-4.05/man2/clock_getres.2 --- manpages-4.04/man2/clock_getres.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/clock_getres.2 2016-03-15 03:47:38.000000000 +0000 @@ -134,7 +134,6 @@ .BR CLOCK_REALTIME . Use when you need very fast, but not fine-grained timestamps. .TP -.TP .B CLOCK_MONOTONIC Clock that cannot be set and represents monotonic time since some unspecified starting point. @@ -302,11 +301,11 @@ .BR time (7), .BR vdso (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/clock_nanosleep.2 manpages-4.05/man2/clock_nanosleep.2 --- manpages-4.04/man2/clock_nanosleep.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/clock_nanosleep.2 2016-03-15 03:47:38.000000000 +0000 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH CLOCK_NANOSLEEP 2 2015-08-08 "Linux" "Linux Programmer's Manual" +.TH CLOCK_NANOSLEEP 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME clock_nanosleep \- high-resolution sleep with specifiable clock .SH SYNOPSIS @@ -45,7 +45,7 @@ .sp .BR clock_nanosleep (): .RS 4 -_XOPEN_SOURCE\ >=\ 600 || _POSIX_C_SOURCE\ >=\ 200112L +_POSIX_C_SOURCE\ >=\ 200112L .RE .ad .SH DESCRIPTION @@ -164,7 +164,8 @@ specified an invalid address. .TP .B EINTR -The sleep was interrupted by a signal handler. +The sleep was interrupted by a signal handler; see +.BR signal (7). .TP .B EINVAL The value in the @@ -259,11 +260,11 @@ .BR usleep (3), .BR time (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/clone.2 manpages-4.05/man2/clone.2 --- manpages-4.04/man2/clone.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/clone.2 2016-03-15 03:47:38.000000000 +0000 @@ -39,13 +39,14 @@ .\" 2008-11-19, mtk, document CLONE_NEWIPC .\" 2008-11-19, Jens Axboe, mtk, document CLONE_IO .\" -.TH CLONE 2 2015-07-23 "Linux" "Linux Programmer's Manual" +.TH CLONE 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME clone, __clone2 \- create a child process .SH SYNOPSIS .nf /* Prototype for the glibc wrapper function */ +.B #define _GNU_SOURCE .B #include .BI "int clone(int (*" "fn" ")(void *), void *" child_stack , @@ -59,27 +60,6 @@ .BI " void *" ptid ", void *" ctid , .BI " struct pt_regs *" regs ); .fi -.sp -.in -4n -Feature Test Macro Requirements for glibc wrapper function (see -.BR feature_test_macros (7)): -.in -.sp -.BR clone (): -.ad l -.RS 4 -.PD 0 -.TP 4 -Since glibc 2.14: -_GNU_SOURCE -.TP 4 -.\" See http://sources.redhat.com/bugzilla/show_bug.cgi?id=4749 -Before glibc 2.14: -_BSD_SOURCE || _SVID_SOURCE - /* _GNU_SOURCE also suffices */ -.PD -.RE -.ad b .SH DESCRIPTION .BR clone () creates a new process, in a manner similar to @@ -1224,11 +1204,11 @@ .BR namespaces (7), .BR pthreads (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/close.2 manpages-4.05/man2/close.2 --- manpages-4.04/man2/close.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/close.2 2016-03-15 03:47:38.000000000 +0000 @@ -32,7 +32,7 @@ .\" Modified 2000-07-22 by Nicolás Lichtmaier .\" added note about close(2) not guaranteeing that data is safe on close. .\" -.TH CLOSE 2 2015-08-08 "Linux" "Linux Programmer's Manual" +.TH CLOSE 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME close \- close a file descriptor .SH SYNOPSIS @@ -57,7 +57,7 @@ open file description (see .BR open (2)), the resources associated with the open file description are freed; -if the descriptor was the last reference to a file which has been +if the file descriptor was the last reference to a file which has been removed using .BR unlink (2), the file is deleted. @@ -103,7 +103,7 @@ .BR close () should not be retried after an .B EINTR -since this may cause a reused descriptor from another thread to be closed. +since this may cause a reused file descriptor from another thread to be closed. .PP A successful close does not guarantee that the data has been successfully saved to disk, as the kernel defers writes. @@ -136,11 +136,11 @@ .BR unlink (2), .BR fclose (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/connect.2 manpages-4.05/man2/connect.2 --- manpages-4.04/man2/connect.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/connect.2 2016-03-15 03:47:38.000000000 +0000 @@ -64,7 +64,7 @@ .\" Modified 1998, 1999 by Andi Kleen .\" Modified 2004-06-23 by Michael Kerrisk .\" -.TH CONNECT 2 2015-12-28 "Linux" "Linux Programmer's Manual" +.TH CONNECT 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME connect \- initiate a connection on a socket .SH SYNOPSIS @@ -175,7 +175,8 @@ been completed. .TP .B EBADF -The file descriptor is not a valid index in the descriptor table. +.I sockfd +is not a valid open file descriptor. .TP .B ECONNREFUSED No-one listening on the remote address. @@ -288,11 +289,11 @@ .BR socket (2), .BR path_resolution (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/copy_file_range.2 manpages-4.05/man2/copy_file_range.2 --- manpages-4.04/man2/copy_file_range.2 1970-01-01 00:00:00.000000000 +0000 +++ manpages-4.05/man2/copy_file_range.2 2016-03-15 03:47:38.000000000 +0000 @@ -0,0 +1,228 @@ +.\"This manpage is Copyright (C) 2015 Anna Schumaker +.\" +.\" %%%LICENSE_START(VERBATIM) +.\" Permission is granted to make and distribute verbatim copies of this +.\" manual provided the copyright notice and this permission notice are +.\" preserved on all copies. +.\" +.\" Permission is granted to copy and distribute modified versions of +.\" this manual under the conditions for verbatim copying, provided that +.\" the entire resulting derived work is distributed under the terms of +.\" a permission notice identical to this one. +.\" +.\" Since the Linux kernel and libraries are constantly changing, this +.\" manual page may be incorrect or out-of-date. The author(s) assume +.\" no responsibility for errors or omissions, or for damages resulting +.\" from the use of the information contained herein. The author(s) may +.\" not have taken the same level of care in the production of this +.\" manual, which is licensed free of charge, as they might when working +.\" professionally. +.\" +.\" Formatted or processed versions of this manual, if unaccompanied by +.\" the source, must acknowledge the copyright and authors of this work. +.\" %%%LICENSE_END +.\" +.TH COPY 2 2016-03-15 "Linux" "Linux Programmer's Manual" +.SH NAME +copy_file_range \- Copy a range of data from one file to another +.SH SYNOPSIS +.nf +.B #include +.B #include + +.BI "ssize_t copy_file_range(int " fd_in ", loff_t *" off_in , +.BI " int " fd_out ", loff_t *" off_out , +.BI " size_t " len ", unsigned int " flags ); +.fi +.SH DESCRIPTION +The +.BR copy_file_range () +system call performs an in-kernel copy between two file descriptors +without the additional cost of transferring data from the kernel to user space +and then back into the kernel. +It copies up to +.I len +bytes of data from file descriptor +.I fd_in +to file descriptor +.IR fd_out , +overwriting any data that exists within the requested range of the target file. + +The following semantics apply for +.IR off_in , +and similar statements apply to +.IR off_out : +.IP * 3 +If +.I off_in +is NULL, then bytes are read from +.I fd_in +starting from the file offset, and the file offset is +adjusted by the number of bytes copied. +.IP * +If +.I off_in +is not NULL, then +.I off_in +must point to a buffer that specifies the starting +offset where bytes from +.I fd_in +will be read. +The file offset of +.I fd_in +is not changed, but +.I off_in +is adjusted appropriately. +.PP + +The +.I flags +argument is provided to allow for future extensions +and currently must be to 0. +.SH RETURN VALUE +Upon successful completion, +.BR copy_file_range () +will return the number of bytes copied between files. +This could be less than the length originally requested. + +On error, +.BR copy_file_range () +returns \-1 and +.I errno +is set to indicate the error. +.SH ERRORS +.TP +.B EBADF +One or more file descriptors are not valid; or +.I fd_in +is not open for reading; or +.I fd_out +is not open for writing; or +the +.B O_APPEND +flag is set for the open file description referred to by +.IR fd_out . +.TP +.B EINVAL +Requested range extends beyond the end of the source file; or the +.I flags +argument is not 0. +.TP +.B EIO +A low-level I/O error occurred while copying. +.TP +.B ENOMEM +Out of memory. +.TP +.B ENOSPC +There is not enough space on the target filesystem to complete the copy. +.TP +.B EXDEV +The files referred to by +.IR file_in " and " file_out +are not on the same mounted filesystem. +.SH VERSIONS +The +.BR copy_file_range () +system call first appeared in Linux 4.5. +.SH CONFORMING TO +The +.BR copy_file_range () +system call is a nonstandard Linux extension. +.SH NOTES +If +.I file_in +is a sparse file, then +.BR copy_file_range () +may expand any holes existing in the requested range. +Users may benefit from calling +.BR copy_file_range () +in a loop, and using the +.BR lseek (2) +.BR SEEK_DATA +and +.BR SEEK_HOLE +operations to find the locations of data segments. + +.BR copy_file_range () +gives filesystems an opportunity to implement "copy acceleration" techniques, +such as the use of reflinks (i.e., two or more i-nodes that share +pointers to the same copy-on-write disk blocks) +or server-side-copy (in the case of NFS). +.SH EXAMPLE +.nf +#define _GNU_SOURCE +#include +#include +#include +#include +#include +#include + +static loff_t +copy_file_range(int fd_in, loff_t *off_in, int fd_out, + loff_t *off_out, size_t len, unsigned int flags) +{ + return syscall(__NR_copy_file_range, fd_in, off_in, fd_out, + off_out, len, flags); +} + +int +main(int argc, char **argv) +{ + int fd_in, fd_out; + struct stat stat; + loff_t len, ret; + + if (argc != 3) { + fprintf(stderr, "Usage: %s \\n", argv[0]); + exit(EXIT_FAILURE); + } + + fd_in = open(argv[1], O_RDONLY); + if (fd_in == \-1) { + perror("open (argv[1])"); + exit(EXIT_FAILURE); + } + + if (fstat(fd_in, &stat) == \-1) { + perror("fstat"); + exit(EXIT_FAILURE); + } + + len = stat.st_size; + + fd_out = open(argv[2], O_CREAT | O_WRONLY | O_TRUNC, 0644); + if (fd_out == \-1) { + perror("open (argv[2])"); + exit(EXIT_FAILURE); + } + + do { + ret = copy_file_range(fd_in, NULL, fd_out, NULL, len, 0); + if (ret == \-1) { + perror("copy_file_range"); + exit(EXIT_FAILURE); + } + + len \-= ret; + } while (len > 0); + + close(fd_in); + close(fd_out); + exit(EXIT_SUCCESS); +} +.fi +.SH SEE ALSO +.BR lseek (2), +.BR sendfile (2), +.BR splice (2) +.SH COLOPHON +This page is part of release 4.05 of the Linux +.I man-pages +project. +A description of the project, +information about reporting bugs, +and the latest version of this page, +can be found at +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/create_module.2 manpages-4.05/man2/create_module.2 --- manpages-4.04/man2/create_module.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/create_module.2 2016-03-15 03:47:38.000000000 +0000 @@ -7,7 +7,7 @@ .\" 2006-02-09, some reformatting by Luc Van Oostenryck; some .\" reformatting and rewordings by mtk .\" -.TH CREATE_MODULE 2 2014-05-10 "Linux" "Linux Programmer's Manual" +.TH CREATE_MODULE 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME create_module \- create a loadable module entry .SH SYNOPSIS @@ -18,7 +18,7 @@ .fi .IR Note : -No declaration of this function is provided in glibc headers; see NOTES. +No declaration of this system call is provided in glibc headers; see NOTES. .SH DESCRIPTION .IR Note : This system call is present only in kernels before Linux 2.6. @@ -66,25 +66,23 @@ .BR create_module () is Linux-specific. .SH NOTES -The -.BR create_module () -system call is not supported by glibc. -No declaration is provided in glibc headers, but, -through a quirk of history, glibc does export an ABI for this system call. +This obsolete system call is not supported by glibc. +No declaration is provided in glibc headers, but, through a quirk of history, +glibc versions before 2.23 did export an ABI for this system call. Therefore, in order to employ this system call, -it is sufficient to manually declare the interface in your code; -alternatively, you can invoke the system call using +it was sufficient to manually declare the interface in your code; +alternatively, you could invoke the system call using .BR syscall (2). .SH SEE ALSO .BR delete_module (2), .BR init_module (2), .BR query_module (2) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/delete_module.2 manpages-4.05/man2/delete_module.2 --- manpages-4.04/man2/delete_module.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/delete_module.2 2016-03-15 03:47:38.000000000 +0000 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH DELETE_MODULE 2 2014-05-10 "Linux" "Linux Programmer's Manual" +.TH DELETE_MODULE 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME delete_module \- unload a kernel module .SH SYNOPSIS @@ -31,7 +31,7 @@ .fi .IR Note : -No declaration of this function is provided in glibc headers; see NOTES. +No declaration of this system call is provided in glibc headers; see NOTES. .SH DESCRIPTION The .BR delete_module () @@ -176,10 +176,11 @@ The .BR delete_module () system call is not supported by glibc. -No declaration is provided in glibc headers, but, -through a quirk of history, glibc does export an ABI for this system call. +No declaration is provided in glibc headers, but, through a quirk of history, +glibc versions before 2.23 did export an ABI for this system call. Therefore, in order to employ this system call, -it is sufficient to manually declare the interface in your code; +it is (before glibc 2.23) sufficient to +manually declare the interface in your code; alternatively, you can invoke the system call using .BR syscall (2). @@ -214,11 +215,11 @@ .BR modprobe (8), .BR rmmod (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/dup.2 manpages-4.05/man2/dup.2 --- manpages-4.04/man2/dup.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/dup.2 2016-03-15 03:47:38.000000000 +0000 @@ -34,7 +34,7 @@ .\" details for dup2(). .\" 2008-10-09, mtk: add description of dup3() .\" -.TH DUP 2 2015-12-28 "Linux" "Linux Programmer's Manual" +.TH DUP 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME dup, dup2, dup3 \- duplicate a file descriptor .SH SYNOPSIS @@ -55,7 +55,7 @@ .BR dup () system call creates a copy of the file descriptor .IR oldfd , -using the lowest-numbered unused descriptor for the new descriptor. +using the lowest-numbered unused file descriptor for the new descriptor. After a successful return, the old and new file descriptors may be used interchangeably. @@ -64,9 +64,9 @@ and thus share file offset and file status flags; for example, if the file offset is modified by using .BR lseek (2) -on one of the descriptors, the offset is also changed for the other. +on one of the file descriptors, the offset is also changed for the other. -The two descriptors do not share file descriptor flags +The two file descriptors do not share file descriptor flags (the close-on-exec flag). The close-on-exec flag .RB ( FD_CLOEXEC ; @@ -80,9 +80,9 @@ system call performs the same task as .BR dup (), but instead of using the lowest-numbered unused file descriptor, -it uses the descriptor number specified in +it uses the file descriptor number specified in .IR newfd . -If the descriptor +If the file descriptor .IR newfd was previously open, it is silently closed before being reused. @@ -149,7 +149,7 @@ .BR EINVAL . .SH RETURN VALUE On success, these system calls -return the new descriptor. +return the new file descriptor. On error, \-1 is returned, and .I errno is set appropriately. @@ -278,11 +278,11 @@ .BR fcntl (2), .BR open (2) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/epoll_create.2 manpages-4.05/man2/epoll_create.2 --- manpages-4.04/man2/epoll_create.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/epoll_create.2 2016-03-15 03:47:38.000000000 +0000 @@ -150,11 +150,11 @@ .BR epoll_wait (2), .BR epoll (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/epoll_ctl.2 manpages-4.05/man2/epoll_ctl.2 --- manpages-4.04/man2/epoll_ctl.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/epoll_ctl.2 2016-03-15 03:47:38.000000000 +0000 @@ -17,9 +17,9 @@ .\" . .\" %%%LICENSE_END .\" -.TH EPOLL_CTL 2 2015-05-07 "Linux" "Linux Programmer's Manual" +.TH EPOLL_CTL 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME -epoll_ctl \- control interface for an epoll descriptor +epoll_ctl \- control interface for an epoll file descriptor .SH SYNOPSIS .B #include .sp @@ -186,6 +186,74 @@ for the event file descriptor with .BR EPOLL_CTL_MOD . See also BUGS. +.TP +.BR EPOLLEXCLUSIVE " (since Linux 4.5)" +Sets an exclusive wakeup mode for the epoll file descriptor that is being +attached to the target file descriptor, +.IR fd . +When a wakeup event occurs and multiple epoll file descriptors +are attached to the same target file using +.BR EPOLLEXCLUSIVE , +one or more of the epoll file descriptors will receive an event with +.BR epoll_wait (2). +The default in this scenario (when +.BR EPOLLEXCLUSIVE +is not set) is for all epoll file descriptors to receive an event. +.BR EPOLLEXCLUSIVE +is thus useful for avoiding thundering herd problems in certain scenarios. + +If the same file descriptor is in multiple epoll instances, +some with the +.BR EPOLLEXCLUSIVE +flag, and others without, then events will provided to all epoll +instances that did not specify +.BR EPOLLEXCLUSIVE , +and at least one of the epoll instances that did specify +.BR EPOLLEXCLUSIVE . + +The following values may be specified in conjunction with +.BR EPOLLEXCLUSIVE : +.BR EPOLLIN , +.BR EPOLLOUT , +.BR EPOLLWAKEUP, +and +.BR EPOLLET . +.BR EPOLLHUP +and +.BR EPOLLERR +can also be specified, but this is not required: +as usual, these events are always reported if they occur, +regardless of whether they are specified in +.IR events . +Attempts to specify other values in +.I events +yield an error. +.B EPOLLEXCLUSIVE +may be used only in an +.B EPOLL_CTL_ADD +operation; attempts to employ it with +.B EPOLL_CTL_MOD +yield an error. +If +.B EPOLLEXCLUSIVE +has set using +.BR epoll_ctl (2), +then a subsequent +.B EPOLL_CTL_MOD +on the same +.IR epfd ",\ " fd +pair yields an error. +A call to +.BR epoll_ctl (2) +that specifies +.B EPOLLEXCLUSIVE +in +.I events +and specifies the target file descriptor +.I fd +as an epoll instance will likewise fail. +The error in all of these cases is +.BR EINVAL . .SH RETURN VALUE When successful, .BR epoll_ctl () @@ -224,6 +292,46 @@ .I op is not supported by this interface. .TP +.B ELOOP +.I fd +refers to an epoll instance and this +.B EPOLL_CTL_ADD +operation would result in a circular loop of epoll instances +monitoring one another. +.TP +.B EINVAL +An invalid event type was specified along with +.B EPOLLEXCLUSIVE +in +.IR events . +.TP +.B EINVAL +.I op +was +.B EPOLL_CTL_MOD +and +.IR events +included +.BR EPOLLEXCLUSIVE . +.TP +.B EINVAL +.I op +was +.B EPOLL_CTL_MOD +and the +.BR EPOLLEXCLUSIVE +flag has previously been applied to this +.IR epfd ",\ " fd +pair. +.TP +.B EINVAL +.BR EPOLLEXCLUSIVE +was specified in +.IR event +and +.I fd +refers to an epoll instance. +.TP .B ENOENT .I op was @@ -318,11 +426,11 @@ .BR poll (2), .BR epoll (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/epoll_wait.2 manpages-4.05/man2/epoll_wait.2 --- manpages-4.04/man2/epoll_wait.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/epoll_wait.2 2016-03-15 03:47:38.000000000 +0000 @@ -244,11 +244,11 @@ .BR epoll_ctl (2), .BR epoll (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/eventfd.2 manpages-4.05/man2/eventfd.2 --- manpages-4.04/man2/eventfd.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/eventfd.2 2016-03-15 03:47:38.000000000 +0000 @@ -19,7 +19,7 @@ .\" .\" 2008-10-10, mtk: describe eventfd2(), and EFD_NONBLOCK and EFD_CLOEXEC .\" -.TH EVENTFD 2 2015-12-28 Linux "Linux Programmer's Manual" +.TH EVENTFD 2 2016-03-15 Linux "Linux Programmer's Manual" .SH NAME eventfd \- create a file descriptor for event notification .SH SYNOPSIS @@ -312,6 +312,15 @@ .BR poll (2), or .BR epoll (7).) + +The current value of an eventfd counter can be viewed +via the entry for the corresponding file descriptor in the process's +.IR /proc/[pid]/fdinfo +directory. +See +.BR proc (5) +for further details. +.\" .SS C library/kernel differences There are two underlying Linux system calls: .BR eventfd () @@ -439,11 +448,11 @@ .BR epoll (7), .BR sem_overview (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/execve.2 manpages-4.05/man2/execve.2 --- manpages-4.04/man2/execve.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/execve.2 2016-03-15 03:47:38.000000000 +0000 @@ -34,7 +34,7 @@ .\" 2007-09-14 Ollie Wild , mtk .\" Add text describing limits on command-line arguments + environment .\" -.TH EXECVE 2 2015-12-28 "Linux" "Linux Programmer's Manual" +.TH EXECVE 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME execve \- execute program .SH SYNOPSIS @@ -114,7 +114,8 @@ shared objects. This interpreter is typically .I /lib/ld-linux.so.2 -for binaries linked with glibc. +for binaries linked with glibc (see +.BR ld-linux.so (8)). All process attributes are preserved during an .BR execve (), @@ -465,8 +466,14 @@ The process is being traced, the user is not the superuser and the file has the set-user-ID or set-group-ID bit set. .TP +.B EPERM +A "capability-dumb" applications would not obtain the full set of +permitted capabilities granted by the executable file. +See +.BR capabilities (7). +.TP .B ETXTBSY -Executable was open for writing by one or more processes. +The specified executable was open for writing by one or more processes. .SH CONFORMING TO POSIX.1-2001, POSIX.1-2008, SVr4, 4.3BSD. POSIX does not document the #! behavior, but it exists @@ -768,16 +775,17 @@ .BR execl (3), .BR fexecve (3), .BR getopt (3), +.BR system (3), .BR credentials (7), .BR environ (7), .BR path_resolution (7), .BR ld.so (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/execveat.2 manpages-4.05/man2/execveat.2 --- manpages-4.04/man2/execveat.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/execveat.2 2016-03-15 03:47:38.000000000 +0000 @@ -231,11 +231,11 @@ .BR openat (2), .BR fexecve (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/_exit.2 manpages-4.05/man2/_exit.2 --- manpages-4.04/man2/_exit.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/_exit.2 2016-03-15 03:47:38.000000000 +0000 @@ -26,7 +26,7 @@ .\" Modified Wed Jul 21 23:02:38 1993 by Rik Faith .\" Modified 2001-11-17, aeb .\" -.TH _EXIT 2 2015-07-23 "Linux" "Linux Programmer's Manual" +.TH _EXIT 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME _exit, _Exit \- terminate the calling process .SH SYNOPSIS @@ -46,11 +46,7 @@ .ad l .BR _Exit (): .RS 4 -_XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L .RE .ad .SH DESCRIPTION @@ -133,11 +129,11 @@ .BR on_exit (3), .BR termios (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/exit_group.2 manpages-4.05/man2/exit_group.2 --- manpages-4.04/man2/exit_group.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/exit_group.2 2016-03-15 03:47:38.000000000 +0000 @@ -49,11 +49,11 @@ .SH SEE ALSO .BR exit (2) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/fallocate.2 manpages-4.05/man2/fallocate.2 --- manpages-4.04/man2/fallocate.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/fallocate.2 2016-03-15 03:47:38.000000000 +0000 @@ -8,7 +8,7 @@ .\" 2011-09-19: Added FALLOC_FL_PUNCH_HOLE .\" 2011-09-19: Substantial restructuring of the page .\" -.TH FALLOCATE 2 2015-07-23 "Linux" "Linux Programmer's Manual" +.TH FALLOCATE 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME fallocate \- manipulate file space .SH SYNOPSIS @@ -304,7 +304,8 @@ and the current file size+\fIlen\fP exceeds the maximum file size. .TP .B EINTR -A signal was caught during execution. +A signal was caught during execution; see +.BR signal (7). .TP .B EINVAL .I offset @@ -462,11 +463,11 @@ .BR posix_fadvise (3), .BR posix_fallocate (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/fanotify_init.2 manpages-4.05/man2/fanotify_init.2 --- manpages-4.04/man2/fanotify_init.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/fanotify_init.2 2016-03-15 03:47:38.000000000 +0000 @@ -21,7 +21,7 @@ .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END -.TH FANOTIFY_INIT 2 2015-12-28 "Linux" "Linux Programmer's Manual" +.TH FANOTIFY_INIT 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME fanotify_init \- create and initialize fanotify group .SH SYNOPSIS @@ -176,7 +176,8 @@ error when trying to open a large file which is monitored by an fanotify group on a 32-bit system. .TP -.B O_CLOEXEC +.BR O_CLOEXEC " (since Linux 3.18)" +.\" commit 0b37e097a648aa71d4db1ad108001e95b69a2da4 Enable the close-on-exec flag for the file descriptor. See the description of the .B O_CLOEXEC @@ -264,11 +265,11 @@ .BR fanotify_mark (2), .BR fanotify (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/fanotify_mark.2 manpages-4.05/man2/fanotify_mark.2 --- manpages-4.04/man2/fanotify_mark.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/fanotify_mark.2 2016-03-15 03:47:38.000000000 +0000 @@ -332,11 +332,11 @@ .BR fanotify_init (2), .BR fanotify (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/fcntl.2 manpages-4.05/man2/fcntl.2 --- manpages-4.04/man2/fcntl.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/fcntl.2 2016-03-15 03:47:38.000000000 +0000 @@ -62,7 +62,7 @@ .\" 2014-07-08, David Herrmann .\" Document F_ADD_SEALS and F_GET_SEALS .\" -.TH FCNTL 2 2015-12-28 "Linux" "Linux Programmer's Manual" +.TH FCNTL 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME fcntl \- manipulate file descriptor .SH SYNOPSIS @@ -113,9 +113,9 @@ .IR fd . This is different from .BR dup2 (2), -which uses exactly the descriptor specified. +which uses exactly the file descriptor specified. .IP -On success, the new descriptor is returned. +On success, the new file descriptor is returned. .IP See .BR dup (2) @@ -125,7 +125,7 @@ As for .BR F_DUPFD , but additionally set the -close-on-exec flag for the duplicate descriptor. +close-on-exec flag for the duplicate file descriptor. Specifying this flag permits a program to avoid an additional .BR fcntl () .B F_SETFD @@ -681,9 +681,9 @@ .B SIGIO and .B SIGURG -signals for events on file descriptor -.IR fd -to the ID given in +signals for events on the file descriptor +.IR fd . +The target process or process group ID is specified in .IR arg . A process ID is specified as a positive value; a process group ID is specified as a negative value. @@ -693,22 +693,23 @@ is specified as .BR getpid (2)). -.\" From glibc.info: -If you set the -.B O_ASYNC -status flag on a file descriptor by using the +As well as setting the file descriptor owner, +one must also enable generation of signals on the file descriptor. +This is done by using the +.BR fcntl () .B F_SETFL -command of -.BR fcntl (), -a +command to set the +.B O_ASYNC +file status flag on the file descriptor. +Subsequently, a .B SIGIO signal is sent whenever input or output becomes possible -on that file descriptor. +on the file descriptor. +The +.BR fcntl () .B F_SETSIG -can be used to obtain delivery of a signal other than +command can be used to obtain delivery of a signal other than .BR SIGIO . -If this permission check fails, then the signal is -silently discarded. Sending a signal to the owner process (group) specified by .B F_SETOWN @@ -717,6 +718,8 @@ where the sending process is the one that employs .B F_SETOWN (but see BUGS below). +If this permission check fails, then the signal is +silently discarded. If the file descriptor .I fd @@ -937,7 +940,7 @@ Note that the file descriptor provided in .I si_fd -is the one that that was specified during the +is the one that was specified during the .BR F_SETSIG operation. This can lead to an unusual corner case. @@ -1052,8 +1055,8 @@ or released using any of these descriptors. Furthermore, the lease is released by either an explicit .B F_UNLCK -operation on any of these duplicate descriptors, or when all -such descriptors have been closed. +operation on any of these duplicate file descriptors, or when all +such file descriptors have been closed. .P Leases may be taken out only on regular files. An unprivileged process may take out a lease only on a file whose @@ -1159,7 +1162,7 @@ .I siginfo_t structure as its second argument, and the .I si_fd -field of this argument will hold the descriptor of the leased file +field of this argument will hold the file descriptor of the leased file that has been accessed by another process. (This is useful if the caller holds leases against multiple files.) .SS File and directory change notification (dnotify) @@ -1465,7 +1468,7 @@ For a successful call, the return value depends on the operation: .TP 0.9i .B F_DUPFD -The new descriptor. +The new file descriptor. .TP .B F_GETFD Value of file descriptor flags. @@ -1477,7 +1480,7 @@ Type of lease held on file descriptor. .TP .B F_GETOWN -Value of descriptor owner. +Value of file descriptor owner. .TP .B F_GETSIG Value of signal sent when read or write becomes possible, or zero @@ -1677,8 +1680,8 @@ .B F_SETOWN are specified in POSIX.1-2001. (To get their definitions, define either -.BR _BSD_SOURCE , -or +.\" .BR _BSD_SOURCE , +.\" or .BR _XOPEN_SOURCE with the value 500 or greater, or .BR _POSIX_C_SOURCE @@ -1941,7 +1944,8 @@ .BR socket (2), .BR lockf (3), .BR capabilities (7), -.BR feature_test_macros (7) +.BR feature_test_macros (7), +.BR lslocks (8) .IR locks.txt , .IR mandatory-locking.txt , @@ -1956,11 +1960,11 @@ is called .IR mandatory.txt ) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/flock.2 manpages-4.05/man2/flock.2 --- manpages-4.04/man2/flock.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/flock.2 2016-03-15 03:47:38.000000000 +0000 @@ -32,7 +32,7 @@ .\" FIXME Maybe document LOCK_MAND, LOCK_RW, LOCK_READ, LOCK_WRITE .\" which only have effect for SAMBA. .\" -.TH FLOCK 2 2014-09-21 "Linux" "Linux Programmer's Manual" +.TH FLOCK 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME flock \- apply or remove an advisory lock on an open file .SH SYNOPSIS @@ -80,20 +80,20 @@ or .BR dup (2)) refer to the same lock, and this lock may be modified -or released using any of these descriptors. +or released using any of these file descriptors. Furthermore, the lock is released either by an explicit .B LOCK_UN -operation on any of these duplicate descriptors, or when all -such descriptors have been closed. +operation on any of these duplicate file descriptors, or when all +such file descriptors have been closed. If a process uses .BR open (2) -(or similar) to obtain more than one descriptor for the same file, -these descriptors are treated independently by +(or similar) to obtain more than one file descriptor for the same file, +these file descriptors are treated independently by .BR flock (). An attempt to lock the file using one of these file descriptors may be denied by a lock that the calling process has -already placed via another descriptor. +already placed via another file descriptor. A process may hold only one type of lock (shared or exclusive) on a file. @@ -239,18 +239,19 @@ .BR fcntl (2), .BR fork (2), .BR open (2), -.BR lockf (3) +.BR lockf (3), +.BR lslocks (8) .I Documentation/filesystems/locks.txt in the Linux kernel source tree .RI ( Documentation/locks.txt in older kernels) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/fork.2 manpages-4.05/man2/fork.2 --- manpages-4.04/man2/fork.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/fork.2 2016-03-15 03:47:38.000000000 +0000 @@ -36,7 +36,7 @@ .\" Greatly expanded, to describe all attributes that differ .\" parent and child. .\" -.TH FORK 2 2015-12-28 "Linux" "Linux Programmer's Manual" +.TH FORK 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME fork \- create a child process .SH SYNOPSIS @@ -174,8 +174,8 @@ open file description (see .BR open (2)) as the corresponding file descriptor in the parent. -This means that the two descriptors share open file status flags, -current file offset, +This means that the two file descriptors share open file status flags, +file offset, and signal-driven I/O attributes (see the description of .B F_SETOWN and @@ -186,10 +186,10 @@ The child inherits copies of the parent's set of open message queue descriptors (see .BR mq_overview (7)). -Each descriptor in the child refers to the same +Each file descriptor in the child refers to the same open message queue description -as the corresponding descriptor in the parent. -This means that the two descriptors share the same flags +as the corresponding file descriptor in the parent. +This means that the two file descriptors share the same flags .RI ( mq_flags ). .IP * The child inherits copies of the parent's set of open directory streams (see @@ -292,11 +292,11 @@ .BR capabilities (7), .BR credentials (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/fsync.2 manpages-4.05/man2/fsync.2 --- manpages-4.04/man2/fsync.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/fsync.2 2016-03-15 03:47:38.000000000 +0000 @@ -35,7 +35,7 @@ .\" 2006-04-28, mtk, substantial rewrite of various parts. .\" 2012-02-27 Various changes by Christoph Hellwig .\" -.TH FSYNC 2 2015-08-08 "Linux" "Linux Programmer's Manual" +.TH FSYNC 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME fsync, fdatasync \- synchronize a file's in-core state with storage device .SH SYNOPSIS @@ -51,13 +51,14 @@ .in .sp .BR fsync (): -_BSD_SOURCE || _XOPEN_SOURCE -.br - || /* since glibc 2.8: */ _POSIX_C_SOURCE\ >=\ 200112L -.\" _POSIX_C_SOURCE\ >=\ 200112L only since glibc 2.8 + Glibc 2.16 and later: + No feature test macros need be defined + Glibc up to and including 2.15: + _BSD_SOURCE || _XOPEN_SOURCE + || /* since glibc 2.8: */ _POSIX_C_SOURCE\ >=\ 200112L .br .BR fdatasync (): -_POSIX_C_SOURCE\ >=\ 199309L || _XOPEN_SOURCE\ >=\ 500 + _POSIX_C_SOURCE\ >=\ 199309L || _XOPEN_SOURCE\ >=\ 500 .SH DESCRIPTION .BR fsync () transfers ("flushes") all modified in-core data of @@ -168,11 +169,11 @@ .BR mount (8), .BR sync (1) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/futex.2 manpages-4.05/man2/futex.2 --- manpages-4.04/man2/futex.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/futex.2 2016-03-15 03:47:38.000000000 +0000 @@ -19,7 +19,7 @@ .\" FIXME Do we need to add some text regarding Torvald Riegel's 2015-01-24 mail .\" at http://thread.gmane.org/gmane.linux.kernel/1703405/focus=1873242 .\" -.TH FUTEX 2 2015-12-28 "Linux" "Linux Programmer's Manual" +.TH FUTEX 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME futex \- fast user-space locking .SH SYNOPSIS @@ -88,7 +88,7 @@ .\" Totally ordered with respect futex operations refers to semantics .\" of the ACQUIRE/RELEASE operations and how they impact ordering of .\" memory reads and writes. The kernel futex operations are protected -.\" by spinlocks, which ensure that that all operations are serialized +.\" by spinlocks, which ensure that all operations are serialized .\" with respect to one another. .\" .\" This is a lot to attempt to define in this document. Perhaps a @@ -125,11 +125,11 @@ This .BR futex () operation will block if and only if the lock is still acquired -(i.e., the value in the futex word still matches the "acquiired state"). +(i.e., the value in the futex word still matches the "acquired state"). When releasing the lock, a thread has to first reset the lock state to not acquired and then execute a futex operation that wakes threads blocked on the lock flag used as a futex word -(this can be be further optimized to avoid unnecessary wake-ups). +(this can be further optimized to avoid unnecessary wake-ups). See .BR futex (7) for more detail on how to use futexes. @@ -199,7 +199,7 @@ .I futex_op argument consists of two parts: a command that specifies the operation to be performed, -bit-wise ORed with zero or or more options that +bit-wise ORed with zero or more options that modify the behaviour of the operation. The options that may be included in .I futex_op @@ -234,9 +234,12 @@ .BR FUTEX_CLOCK_REALTIME " (since Linux 2.6.28)" .\" commit 1acdac104668a0834cfa267de9946fac7764d486 This option bit can be employed only with the -.BR FUTEX_WAIT_BITSET +.BR FUTEX_WAIT_BITSET , +.BR FUTEX_WAIT_REQUEUE_PI , and -.BR FUTEX_WAIT_REQUEUE_PI +.BR FUTEX_WAIT +(since Linux 4.5) +.\" commit 337f13046ff03717a9e99675284a817527440a49 operations. If this option is set, the kernel treats @@ -274,7 +277,7 @@ This load, the comparison with the expected value, and starting to sleep are performed atomically .\" FIXME: Torvald, I think we may need to add some explanation of -.\" "totally odered" here. +.\" "totally ordered" here. and totally ordered with respect to other futex operations on the same futex word. If the thread starts to sleep, @@ -312,7 +315,6 @@ and .I val3 are ignored. - .\" FIXME(Torvald) I think we should remove this. Or maybe adapt to a .\" different example. .\" For @@ -350,7 +352,6 @@ and .I val3 are ignored. - .\" FIXME(Torvald) I think we should remove this. Or maybe adapt to .\" a different example. .\" For @@ -456,7 +457,7 @@ Typical values to specify for .I val -are 0 or or 1. +are 0 or 1. (Specifying .BR INT_MAX is not useful, because it would make the @@ -516,7 +517,7 @@ If a waker thread used .BR FUTEX_WAKE , then all waiters waiting on B would be woken up, -and they would would all try to acquire lock A. +and they would all try to acquire lock A. However, waking all of the threads in this manner would be pointless because all except one of the threads would immediately block on lock A again. By contrast, a requeue operation wakes just one waiter and moves @@ -835,7 +836,6 @@ bit shall be set in the futex word's value; in other words, this value is: FUTEX_WAITERS | TID - .IP (Note that is invalid for a PI futex word to have no owner and .BR FUTEX_WAITERS @@ -1878,11 +1878,11 @@ .\" WIP, and the generic pthread_mutex_t and perhaps condvar .\" implementations. .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/futimesat.2 manpages-4.05/man2/futimesat.2 --- manpages-4.04/man2/futimesat.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/futimesat.2 2016-03-15 03:47:38.000000000 +0000 @@ -132,11 +132,11 @@ .BR futimes (3), .BR path_resolution (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/getcpu.2 manpages-4.05/man2/getcpu.2 --- manpages-4.04/man2/getcpu.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/getcpu.2 2016-03-15 03:47:38.000000000 +0000 @@ -144,11 +144,11 @@ .BR cpuset (7), .BR vdso (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/getdents.2 manpages-4.05/man2/getdents.2 --- manpages-4.04/man2/getdents.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/getdents.2 2016-03-15 03:47:38.000000000 +0000 @@ -309,11 +309,11 @@ .BR readdir (2), .BR readdir (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/getdomainname.2 manpages-4.05/man2/getdomainname.2 --- manpages-4.04/man2/getdomainname.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/getdomainname.2 2016-03-15 03:47:38.000000000 +0000 @@ -26,7 +26,7 @@ .\" Modified 2004-06-17 by Michael Kerrisk .\" Modified 2008-11-27 by mtk .\" -.TH GETDOMAINNAME 2 2012-10-25 "Linux" "Linux Programmer's Manual" +.TH GETDOMAINNAME 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME getdomainname, setdomainname \- get/set NIS domain name .SH SYNOPSIS @@ -44,9 +44,15 @@ .ad l .BR getdomainname (), .BR setdomainname (): -.RS 4 -_BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE\ <\ 500) -.RE +.nf + Since glibc 2.21: +.\" commit 266865c0e7b79d4196e2cc393693463f03c90bd8 + _DEFAULT_SOURCE + In glibc 2.19 and 2.20: + _DEFAULT_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE\ <\ 500) + Up to and including glibc 2.19: + _BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE\ <\ 500) +.fi .ad .SH DESCRIPTION These functions are used to access or to change the NIS domain name of the @@ -129,11 +135,11 @@ .BR sethostname (2), .BR uname (2) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/getgid.2 manpages-4.05/man2/getgid.2 --- manpages-4.04/man2/getgid.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/getgid.2 2016-03-15 03:47:39.000000000 +0000 @@ -65,11 +65,11 @@ .BR setregid (2), .BR credentials (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/getgroups.2 manpages-4.05/man2/getgroups.2 --- manpages-4.04/man2/getgroups.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/getgroups.2 2016-03-15 03:47:39.000000000 +0000 @@ -29,7 +29,7 @@ .\" 2008-05-03, mtk, expanded and rewrote parts of DESCRIPTION and RETURN .\" VALUE, made style of page more consistent with man-pages style. .\" -.TH GETGROUPS 2 2015-07-23 "Linux" "Linux Programmer's Manual" +.TH GETGROUPS 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME getgroups, setgroups \- get/set list of supplementary group IDs .SH SYNOPSIS @@ -49,7 +49,10 @@ .in .sp .BR setgroups (): -_BSD_SOURCE + Since glibc 2.19: + _DEFAULT_SOURCE + Glibc 2.19 and earlier: + _SVID_SOURCE .SH DESCRIPTION .PP .BR getgroups () @@ -212,11 +215,11 @@ .BR capabilities (7), .BR credentials (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/gethostname.2 manpages-4.05/man2/gethostname.2 --- manpages-4.04/man2/gethostname.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/gethostname.2 2016-03-15 03:47:39.000000000 +0000 @@ -29,7 +29,7 @@ .\" Modified 2004-06-17 by mtk .\" Modified 2008-11-27 by mtk .\" -.TH GETHOSTNAME 2 2015-07-23 "Linux" "Linux Programmer's Manual" +.TH GETHOSTNAME 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME gethostname, sethostname \- get/set hostname .SH SYNOPSIS @@ -55,9 +55,15 @@ .RE .br .BR sethostname (): -.RS 4 -_BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE\ <\ 500) -.RE +.nf + Since glibc 2.21: +.\" commit 266865c0e7b79d4196e2cc393693463f03c90bd8 + _DEFAULT_SOURCE + In glibc 2.19 and 2.20: + _DEFAULT_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE\ <\ 500) + Up to and including glibc 2.19: + _BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE\ <\ 500) +.fi .PD .ad .SH DESCRIPTION @@ -178,11 +184,11 @@ .BR setdomainname (2), .BR uname (2) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/getitimer.2 manpages-4.05/man2/getitimer.2 --- manpages-4.04/man2/getitimer.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/getitimer.2 2016-03-15 03:47:39.000000000 +0000 @@ -251,11 +251,11 @@ .BR timerfd_create (2), .BR time (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/get_kernel_syms.2 manpages-4.05/man2/get_kernel_syms.2 --- manpages-4.04/man2/get_kernel_syms.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/get_kernel_syms.2 2016-03-15 03:47:39.000000000 +0000 @@ -7,7 +7,7 @@ .\" 2006-02-09, some reformatting by Luc Van Oostenryck; some .\" reformatting and rewordings by mtk .\" -.TH GET_KERNEL_SYMS 2 2012-10-18 "Linux" "Linux Programmer's Manual" +.TH GET_KERNEL_SYMS 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME get_kernel_syms \- retrieve exported kernel and module symbols .SH SYNOPSIS @@ -16,6 +16,9 @@ .sp .BI "int get_kernel_syms(struct kernel_sym *" table ); .fi + +.IR Note : +No declaration of this system call is provided in glibc headers; see NOTES. .SH DESCRIPTION .BR Note : This system call is present only in kernels before Linux 2.6. @@ -77,17 +80,25 @@ .BR query_module (2) (which is itself nowadays deprecated in favor of other interfaces described on its manual page). +.SH NOTES +This obsolete system call is not supported by glibc. +No declaration is provided in glibc headers, but, through a quirk of history, +glibc versions before 2.23 did export an ABI for this system call. +Therefore, in order to employ this system call, +it was sufficient to manually declare the interface in your code; +alternatively, you could invoke the system call using +.BR syscall (2). .SH SEE ALSO .BR create_module (2), .BR delete_module (2), .BR init_module (2), .BR query_module (2) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/get_mempolicy.2 manpages-4.05/man2/get_mempolicy.2 --- manpages-4.04/man2/get_mempolicy.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/get_mempolicy.2 2016-03-15 03:47:39.000000000 +0000 @@ -245,11 +245,11 @@ .BR numa (7), .BR numactl (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/getpagesize.2 manpages-4.05/man2/getpagesize.2 --- manpages-4.04/man2/getpagesize.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/getpagesize.2 2016-03-15 03:47:39.000000000 +0000 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH GETPAGESIZE 2 2014-08-19 "Linux" "Linux Programmer's Manual" +.TH GETPAGESIZE 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME getpagesize \- get memory page size .SH SYNOPSIS @@ -40,15 +40,19 @@ .RS 4 .PD 0 .TP 4 -Since glibc 2.12: +Since glibc 2.19: .nf -_BSD_SOURCE || - !(_POSIX_C_SOURCE\ >=\ 200112L || _XOPEN_SOURCE\ >=\ 600) +_DEFAULT_SOURCE || ! (_POSIX_C_SOURCE\ >=\ 200112L) +.TP 4 +.fi +From glibc 2.12 to 2.19: +.nf +_BSD_SOURCE || ! (_POSIX_C_SOURCE\ >=\ 200112L) .TP 4 .fi Before glibc 2.12: -_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 || -_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED +_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 +.\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED .PD .RE .ad b @@ -109,11 +113,11 @@ .BR mmap (2), .BR sysconf (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/getpeername.2 manpages-4.05/man2/getpeername.2 --- manpages-4.04/man2/getpeername.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/getpeername.2 2016-03-15 03:47:39.000000000 +0000 @@ -39,7 +39,7 @@ .\" Modified 17 Jul 2002, Michael Kerrisk .\" Added 'socket' to NAME, so that "man -k socket" will show this page. .\" -.TH GETPEERNAME 2 2015-12-28 "Linux" "Linux Programmer's Manual" +.TH GETPEERNAME 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME getpeername \- get name of connected peer socket .SH SYNOPSIS @@ -75,7 +75,7 @@ .B EBADF The argument .I sockfd -is not a valid descriptor. +is not a valid file descriptor. .TP .B EFAULT The @@ -148,11 +148,11 @@ .BR socket (7), .BR unix (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/getpid.2 manpages-4.05/man2/getpid.2 --- manpages-4.04/man2/getpid.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/getpid.2 2016-03-15 03:47:39.000000000 +0000 @@ -115,11 +115,11 @@ .BR credentials (7), .BR pid_namespaces (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/getpriority.2 manpages-4.05/man2/getpriority.2 --- manpages-4.04/man2/getpriority.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/getpriority.2 2016-03-15 03:47:39.000000000 +0000 @@ -240,11 +240,11 @@ .I Documentation/scheduler/sched-nice-design.txt in the Linux kernel source tree (since Linux 2.6.23) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/getrandom.2 manpages-4.05/man2/getrandom.2 --- manpages-4.04/man2/getrandom.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/getrandom.2 2016-03-15 03:47:39.000000000 +0000 @@ -328,11 +328,11 @@ .BR urandom (4), .BR signal (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/getresuid.2 manpages-4.05/man2/getresuid.2 --- manpages-4.04/man2/getresuid.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/getresuid.2 2016-03-15 03:47:39.000000000 +0000 @@ -90,11 +90,11 @@ .BR setuid (2), .BR credentials (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/getrlimit.2 manpages-4.05/man2/getrlimit.2 --- manpages-4.04/man2/getrlimit.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/getrlimit.2 2016-03-15 03:47:39.000000000 +0000 @@ -801,11 +801,11 @@ .BR capabilities (7), .BR signal (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/get_robust_list.2 manpages-4.05/man2/get_robust_list.2 --- manpages-4.04/man2/get_robust_list.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/get_robust_list.2 2016-03-15 03:47:39.000000000 +0000 @@ -133,11 +133,11 @@ in the Linux kernel source tree .\" http://lwn.net/Articles/172149/ .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/getrusage.2 manpages-4.05/man2/getrusage.2 --- manpages-4.04/man2/getrusage.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/getrusage.2 2016-03-15 03:47:39.000000000 +0000 @@ -271,11 +271,11 @@ .BR wait4 (2), .BR clock (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/getsid.2 manpages-4.05/man2/getsid.2 --- manpages-4.04/man2/getsid.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/getsid.2 2016-03-15 03:47:39.000000000 +0000 @@ -23,7 +23,7 @@ .\" .\" Modified Thu Oct 31 14:18:40 1996 by Eric S. Raymond .\" Modified 2001-12-17, aeb -.TH GETSID 2 2015-08-08 "Linux" "Linux Programmer's Manual" +.TH GETSID 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME getsid \- get session ID .SH SYNOPSIS @@ -40,10 +40,10 @@ .PD 0 .BR getsid (): .RS 4 -_XOPEN_SOURCE\ >=\ 500 || -_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED +_XOPEN_SOURCE\ >=\ 500 +.\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED .br -|| /* Since glibc 2.12: */ _POSIX_C_SOURCE\ >=\ 200809L + || /* Since glibc 2.12: */ _POSIX_C_SOURCE\ >=\ 200809L .RE .PD .ad @@ -86,11 +86,11 @@ .BR setsid (2), .BR credentials (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/getsockname.2 manpages-4.05/man2/getsockname.2 --- manpages-4.04/man2/getsockname.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/getsockname.2 2016-03-15 03:47:39.000000000 +0000 @@ -37,7 +37,7 @@ .\" Modified Tue Oct 22 00:22:35 EDT 1996 by Eric S. Raymond .\" Modified Sun Mar 28 21:26:46 1999 by Andries Brouwer .\" -.TH GETSOCKNAME 2 2015-12-28 "Linux" "Linux Programmer's Manual" +.TH GETSOCKNAME 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME getsockname \- get socket name .SH SYNOPSIS @@ -74,7 +74,7 @@ .B EBADF The argument .I sockfd -is not a valid descriptor. +is not a valid file descriptor. .TP .B EFAULT The @@ -119,11 +119,11 @@ .BR socket (7), .BR unix (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/getsockopt.2 manpages-4.05/man2/getsockopt.2 --- manpages-4.04/man2/getsockopt.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/getsockopt.2 2016-03-15 03:47:39.000000000 +0000 @@ -41,7 +41,7 @@ .\" Modified 1999 by Andi Kleen . .\" Removed most stuff because it is in socket.7 now. .\" -.TH GETSOCKOPT 2 2015-12-28 "Linux" "Linux Programmer's Manual" +.TH GETSOCKOPT 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME getsockopt, setsockopt \- get and set options on sockets .SH SYNOPSIS @@ -142,7 +142,7 @@ .B EBADF The argument .I sockfd -is not a valid descriptor. +is not a valid file descriptor. .TP .B EFAULT The address pointed to by @@ -215,11 +215,11 @@ .BR udp (7), .BR unix (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/gettid.2 manpages-4.05/man2/gettid.2 --- manpages-4.04/man2/gettid.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/gettid.2 2016-03-15 03:47:39.000000000 +0000 @@ -77,7 +77,7 @@ .BR fork (2)), the new process is a thread group leader, and its thread group ID (the value returned by -.BR gettid (2)) +.BR getpid (2)) is the same as its thread ID (the value returned by .BR gettid ()). .SH SEE ALSO @@ -100,11 +100,11 @@ .BR tgkill (2), .BR timer_create (2) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/gettimeofday.2 manpages-4.05/man2/gettimeofday.2 --- manpages-4.04/man2/gettimeofday.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/gettimeofday.2 2016-03-15 03:47:39.000000000 +0000 @@ -37,7 +37,7 @@ .\" Modified, 2004-05-27 by Michael Kerrisk .\" Added notes on capability requirement. .\" -.TH GETTIMEOFDAY 2 2015-12-28 "Linux" "Linux Programmer's Manual" +.TH GETTIMEOFDAY 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME gettimeofday, settimeofday \- get / set time .SH SYNOPSIS @@ -56,7 +56,10 @@ .in .sp .BR settimeofday (): -_BSD_SOURCE + Since glibc 2.19: + _DEFAULT_SOURCE + Glibc 2.19 and earlier: + _BSD_SOURCE .SH DESCRIPTION The functions .BR gettimeofday () @@ -271,11 +274,11 @@ .BR time (7), .BR vdso (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/getuid.2 manpages-4.05/man2/getuid.2 --- manpages-4.04/man2/getuid.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/getuid.2 2016-03-15 03:47:39.000000000 +0000 @@ -76,11 +76,11 @@ .BR setuid (2), .BR credentials (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/getunwind.2 manpages-4.05/man2/getunwind.2 --- manpages-4.04/man2/getunwind.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/getunwind.2 2016-03-15 03:47:39.000000000 +0000 @@ -111,11 +111,11 @@ .SH SEE ALSO .BR getauxval (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/getxattr.2 manpages-4.05/man2/getxattr.2 --- manpages-4.04/man2/getxattr.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/getxattr.2 2016-03-15 03:47:39.000000000 +0000 @@ -156,11 +156,11 @@ .BR symlink (7), .BR xattr (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/idle.2 manpages-4.05/man2/idle.2 --- manpages-4.04/man2/idle.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/idle.2 2016-03-15 03:47:39.000000000 +0000 @@ -62,11 +62,11 @@ This function is Linux-specific, and should not be used in programs intended to be portable. .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/init_module.2 manpages-4.05/man2/init_module.2 --- manpages-4.04/man2/init_module.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/init_module.2 2016-03-15 03:47:39.000000000 +0000 @@ -24,7 +24,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH INIT_MODULE 2 2014-05-10 "Linux" "Linux Programmer's Manual" +.TH INIT_MODULE 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME init_module, finit_module \- load a kernel module .SH SYNOPSIS @@ -265,10 +265,11 @@ The .BR init_module () system call is not supported by glibc. -No declaration is provided in glibc headers, but, -through a quirk of history, glibc does export an ABI for this system call. +No declaration is provided in glibc headers, but, through a quirk of history, +glibc versions before 2.23 did export an ABI for this system call. Therefore, in order to employ this system call, -it is sufficient to manually declare the interface in your code; +it is (before glibc 2.23) sufficient to +manually declare the interface in your code; alternatively, you can invoke the system call using .BR syscall (2). @@ -357,11 +358,11 @@ .BR lsmod (8), .BR modprobe (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/inotify_add_watch.2 manpages-4.05/man2/inotify_add_watch.2 --- manpages-4.04/man2/inotify_add_watch.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/inotify_add_watch.2 2016-03-15 03:47:39.000000000 +0000 @@ -122,11 +122,11 @@ .BR inotify_rm_watch (2), .BR inotify (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/inotify_init.2 manpages-4.05/man2/inotify_init.2 --- manpages-4.04/man2/inotify_init.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/inotify_init.2 2016-03-15 03:47:39.000000000 +0000 @@ -108,11 +108,11 @@ .BR inotify_rm_watch (2), .BR inotify (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/inotify_rm_watch.2 manpages-4.05/man2/inotify_rm_watch.2 --- manpages-4.04/man2/inotify_rm_watch.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/inotify_rm_watch.2 2016-03-15 03:47:39.000000000 +0000 @@ -73,11 +73,11 @@ .BR inotify_init (2), .BR inotify (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/intro.2 manpages-4.05/man2/intro.2 --- manpages-4.04/man2/intro.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/intro.2 2016-03-15 03:47:39.000000000 +0000 @@ -133,11 +133,11 @@ .BR symlink (7), .BR time (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/io_cancel.2 manpages-4.05/man2/io_cancel.2 --- manpages-4.04/man2/io_cancel.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/io_cancel.2 2016-03-15 03:47:39.000000000 +0000 @@ -100,11 +100,11 @@ .\" .SH AUTHOR .\" Kent Yoder. .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/ioctl.2 manpages-4.05/man2/ioctl.2 --- manpages-4.04/man2/ioctl.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/ioctl.2 2016-03-15 03:47:39.000000000 +0000 @@ -38,7 +38,7 @@ .\" Modified 1999-06-25 by Rachael Munns .\" Modified 2000-09-21 by Andries Brouwer .\" -.TH IOCTL 2 2015-05-07 "Linux" "Linux Programmer's Manual" +.TH IOCTL 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME ioctl \- control device .SH SYNOPSIS @@ -95,7 +95,7 @@ .TP 0.7i .B EBADF .I fd -is not a valid descriptor. +is not a valid file descriptor. .TP .B EFAULT .I argp @@ -113,7 +113,7 @@ .TP .B ENOTTY The specified request does not apply to the kind of object that the -descriptor +file descriptor .I fd references. .SH CONFORMING TO @@ -151,11 +151,11 @@ .BR sd (4), .BR tty (4) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/ioctl_fat.2 manpages-4.05/man2/ioctl_fat.2 --- manpages-4.04/man2/ioctl_fat.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/ioctl_fat.2 2016-03-15 03:47:39.000000000 +0000 @@ -500,11 +500,11 @@ .SH SEE ALSO .BR ioctl (2) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/ioctl_list.2 manpages-4.05/man2/ioctl_list.2 --- manpages-4.04/man2/ioctl_list.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/ioctl_list.2 2016-03-15 03:47:39.000000000 +0000 @@ -28,7 +28,7 @@ .\" : .\" Various formatting improvements .\" -.TH IOCTL_LIST 2 2015-03-29 "Linux" "Linux Programmer's Manual" +.TH IOCTL_LIST 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME ioctl_list \- list of ioctl calls in Linux/i386 kernel .SH DESCRIPTION @@ -505,6 +505,70 @@ 0x000089E3 SIOCNRRTCTL const int * .TE +// +.br +// This API is deprecated. +.br +// It is being replaced by nl80211 and cfg80211. +See +.br +// +.I https://wireless.wiki.kernel.org/en/developers/documentation/nl80211 +.TS +l l l. +x00008b00 SIOCSIWCOMMIT struct iwreq * +x00008b01 SIOCGIWNAME struct iwreq * +x00008b02 SIOCSIWNWID struct iwreq * +x00008b03 SIOCGIWNWID struct iwreq * +x00008b04 SIOCSIWFREQ struct iwreq * +x00008b05 SIOCGIWFREQ struct iwreq * +x00008b06 SIOCSIWMODE struct iwreq * +x00008b07 SIOCGIWMODE struct iwreq * +x00008b08 SIOCSIWSENS struct iwreq * +x00008b09 SIOCGIWSENS struct iwreq * +x00008b0a SIOCSIWRANGE struct iwreq * +x00008b0b SIOCGIWRANGE struct iwreq * +x00008b0c SIOCSIWPRIV struct iwreq * +x00008b0d SIOCGIWPRIV struct iwreq * +x00008b0e SIOCSIWSTATS struct iwreq * +x00008b0f SIOCGIWSTATS struct iwreq * +x00008b10 SIOCSIWSPY struct iwreq * +x00008b11 SIOCGIWSPY struct iwreq * +x00008b12 SIOCSIWTHRSPY struct iwreq * +x00008b13 SIOCGIWTHRSPY struct iwreq * +x00008b14 SIOCSIWAP struct iwreq * +x00008b15 SIOCGIWAP struct iwreq * +x00008b17 SIOCGIWAPLIST struct iwreq * +x00008b18 SIOCSIWSCAN struct iwreq * +x00008b19 SIOCGIWSCAN struct iwreq * +x00008b1a SIOCSIWESSID struct iwreq * +x00008b1b SIOCGIWESSID struct iwreq * +x00008b1c SIOCSIWNICKN struct iwreq * +x00008b1d SIOCGIWNICKN struct iwreq * +x00008b20 SIOCSIWRATE struct iwreq * +x00008b21 SIOCGIWRATE struct iwreq * +x00008b22 SIOCSIWRTS struct iwreq * +x00008b23 SIOCGIWRTS struct iwreq * +x00008b24 SIOCSIWFRAG struct iwreq * +x00008b25 SIOCGIWFRAG struct iwreq * +x00008b26 SIOCSIWTXPOW struct iwreq * +x00008b27 SIOCGIWTXPOW struct iwreq * +x00008b28 SIOCSIWRETRY struct iwreq * +x00008b29 SIOCGIWRETRY struct iwreq * +x00008b2a SIOCSIWENCODE struct iwreq * +x00008b2b SIOCGIWENCODE struct iwreq * +x00008b2c SIOCSIWPOWER struct iwreq * +x00008b2d SIOCGIWPOWER struct iwreq * +x00008b30 SIOCSIWGENIE struct iwreq * +x00008b31 SIOCGIWGENIE struct iwreq * +x00008b16 SIOCSIWMLME struct iwreq * +x00008b32 SIOCSIWAUTH struct iwreq * +x00008b33 SIOCGIWAUTH struct iwreq * +x00008b34 SIOCSIWENCODEEXT struct iwreq * +x00008b35 SIOCGIWENCODEEXT struct iwreq * +x00008b36 SIOCSIWPMKSA struct iwreq * +.TE + // .TS l l l. @@ -540,7 +604,9 @@ 0x80027501 SMB_IOC_GETMOUNTUID uid_t * .TE -// +// see +.BR netdevice (7) + .TS l l l l. 0x0000890B SIOCADDRT const struct rtentry * // MORE @@ -973,13 +1039,14 @@ .TE .SH SEE ALSO .BR ioctl (2), -.BR ioctl_fat (2) +.BR ioctl_fat (2), +.BR netdevice (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/io_destroy.2 manpages-4.05/man2/io_destroy.2 --- manpages-4.04/man2/io_destroy.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/io_destroy.2 2016-03-15 03:47:39.000000000 +0000 @@ -89,11 +89,11 @@ .\" .SH AUTHOR .\" Kent Yoder. .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/io_getevents.2 manpages-4.05/man2/io_getevents.2 --- manpages-4.04/man2/io_getevents.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/io_getevents.2 2016-03-15 03:47:39.000000000 +0000 @@ -133,11 +133,11 @@ .\" .SH AUTHOR .\" Kent Yoder. .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/ioperm.2 manpages-4.05/man2/ioperm.2 --- manpages-4.04/man2/ioperm.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/ioperm.2 2016-03-15 03:47:39.000000000 +0000 @@ -31,7 +31,7 @@ .\" Modified, 27 May 2004, Michael Kerrisk .\" Added notes on capability requirements .\" -.TH IOPERM 2 2014-08-19 "Linux" "Linux Programmer's Manual" +.TH IOPERM 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME ioperm \- set port input/output permissions .SH SYNOPSIS @@ -63,11 +63,9 @@ argument of 3). Since Linux 2.6.8, 65,536 I/O ports can be specified. -Permissions are not inherited by the child created by -.BR fork (2); -following a +Permissions are inherited by the child created by .BR fork (2) -the child must turn on those permissions that it needs. +(but see NOTES). Permissions are preserved across .BR execve (2); this is useful for giving port access permissions to unprivileged @@ -107,6 +105,10 @@ .I /proc/ioports file shows the I/O ports that are currently allocated on the system. +Before Linux 2.4, +permissions were not inherited by a child created by +.BR fork (2). + Glibc has an .BR ioperm () prototype both in @@ -119,11 +121,11 @@ .BR outb (2), .BR capabilities (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/iopl.2 manpages-4.05/man2/iopl.2 --- manpages-4.04/man2/iopl.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/iopl.2 2016-03-15 03:47:39.000000000 +0000 @@ -30,7 +30,7 @@ .\" Modified, 27 May 2004, Michael Kerrisk .\" Added notes on capability requirements .\" -.TH IOPL 2 2015-07-23 "Linux" "Linux Programmer's Manual" +.TH IOPL 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME iopl \- change I/O privilege level .SH SYNOPSIS @@ -53,10 +53,11 @@ I/O privilege level also allows the process to disable interrupts. This will probably crash the system, and is not recommended. -Permissions are inherited by +Permissions are not inherited by the child process created by .BR fork (2) -and -.BR execve (2). +and are not preserved across +.BR execve (2) +(but see NOTES). The I/O privilege level for a normal process is 0. @@ -97,16 +98,26 @@ and in .IR . Avoid the latter, it is available on i386 only. + +Prior to Linux 3.7, +on some architectures (such as i386), permissions +.I were +inherited by the child produced by +.BR fork (2) +and were preserved across +.BR execve (2). +This behavior was inadvertently changed in Linux 3.7, +and won't be reinstated. .SH SEE ALSO .BR ioperm (2), .BR outb (2), .BR capabilities (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/ioprio_set.2 manpages-4.05/man2/ioprio_set.2 --- manpages-4.04/man2/ioprio_set.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/ioprio_set.2 2016-03-15 03:47:39.000000000 +0000 @@ -368,11 +368,11 @@ .I Documentation/block/ioprio.txt in the Linux kernel source tree .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/io_setup.2 manpages-4.05/man2/io_setup.2 --- manpages-4.04/man2/io_setup.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/io_setup.2 2016-03-15 03:47:39.000000000 +0000 @@ -102,11 +102,11 @@ .\" .SH AUTHOR .\" Kent Yoder. .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/io_submit.2 manpages-4.05/man2/io_submit.2 --- manpages-4.04/man2/io_submit.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/io_submit.2 2016-03-15 03:47:39.000000000 +0000 @@ -104,11 +104,11 @@ .\" .SH AUTHOR .\" Kent Yoder. .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/ipc.2 manpages-4.05/man2/ipc.2 --- manpages-4.04/man2/ipc.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/ipc.2 2016-03-15 03:47:39.000000000 +0000 @@ -68,11 +68,11 @@ .BR shmdt (2), .BR shmget (2) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/kcmp.2 manpages-4.05/man2/kcmp.2 --- manpages-4.04/man2/kcmp.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/kcmp.2 2016-03-15 03:47:39.000000000 +0000 @@ -223,11 +223,11 @@ .BR clone (2), .BR unshare (2) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/kexec_load.2 manpages-4.05/man2/kexec_load.2 --- manpages-4.04/man2/kexec_load.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/kexec_load.2 2016-03-15 03:47:39.000000000 +0000 @@ -24,7 +24,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH KEXEC_LOAD 2 2015-02-01 "Linux" "Linux Programmer's Manual" +.TH KEXEC_LOAD 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME kexec_load, kexec_file_load \- load a new kernel for later execution .SH SYNOPSIS @@ -60,7 +60,7 @@ Execute the new kernel automatically on a system crash. This "crash kernel" is loaded into an area of reserved memory that is determined at boot time using the -.I craskkernel +.I crashkernel kernel command-line parameter. The location of this reserved memory is exported to user space via the .I /proc/iomem @@ -195,10 +195,11 @@ system call is similar to .BR kexec_load (), but it takes a different set of arguments. -It reads the kernel to be loaded from the file referred to by the descriptor +It reads the kernel to be loaded from the file referred to by +the file descriptor .IR kernel_fd , and the initrd (initial RAM disk) -to be loaded from file referred to by the descriptor +to be loaded from file referred to by the file descriptor .IR initrd_fd . The .IR cmdline @@ -348,11 +349,11 @@ and .IR Documentation/kernel-parameters.txt . .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/keyctl.2 manpages-4.05/man2/keyctl.2 --- manpages-4.04/man2/keyctl.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/keyctl.2 2016-03-15 03:47:39.000000000 +0000 @@ -98,7 +98,7 @@ .P These are wrapped by .B libkeyutils -into individual functions to permit compiler the compiler to check types. +into individual functions to permit the compiler to check types. See the .B See Also section at the bottom. @@ -167,11 +167,11 @@ The kernel source file .IR Documentation/security/keys.txt . .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/kill.2 manpages-4.05/man2/kill.2 --- manpages-4.04/man2/kill.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/kill.2 2016-03-15 03:47:39.000000000 +0000 @@ -41,7 +41,7 @@ .\" Modified 2004-06-24 by aeb .\" Modified, 2004-11-30, after idea from emmanuel.colbus@ensimag.imag.fr .\" -.TH KILL 2 2015-08-08 "Linux" "Linux Programmer's Manual" +.TH KILL 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME kill \- send signal to a process .SH SYNOPSIS @@ -60,7 +60,7 @@ .sp .ad l .BR kill (): -_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _POSIX_SOURCE +_POSIX_C_SOURCE .ad b .SH DESCRIPTION The @@ -179,11 +179,11 @@ .BR credentials (7), .BR signal (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/killpg.2 manpages-4.05/man2/killpg.2 --- manpages-4.04/man2/killpg.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/killpg.2 2016-03-15 03:47:39.000000000 +0000 @@ -39,7 +39,7 @@ .\" Added notes on CAP_KILL .\" Modified 2004-06-21 by aeb .\" -.TH KILLPG 2 2015-07-23 "Linux" "Linux Programmer's Manual" +.TH KILLPG 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME killpg \- send signal to a process group .SH SYNOPSIS @@ -54,8 +54,10 @@ .ad l .TP 4 .BR killpg (): -_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 || -_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED +_XOPEN_SOURCE\ >=\ 500 +.\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE .ad .SH DESCRIPTION .BR killpg () @@ -138,11 +140,11 @@ .BR capabilities (7), .BR credentials (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/link.2 manpages-4.05/man2/link.2 --- manpages-4.04/man2/link.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/link.2 2016-03-15 03:47:39.000000000 +0000 @@ -29,7 +29,7 @@ .\" Modified 2004-06-23 by Michael Kerrisk .\" Modified 2005-04-04, as per suggestion by Michael Hardt for rename.2 .\" -.TH LINK 2 2014-08-19 "Linux" "Linux Programmer's Manual" +.TH LINK 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME link, linkat \- make a new name for a file .SH SYNOPSIS @@ -56,7 +56,7 @@ .RS 4 .TP 4 Since glibc 2.10: -_XOPEN_SOURCE\ >=\ 700 || _POSIX_C_SOURCE\ >=\ 200809L +_POSIX_C_SOURCE\ >=\ 200809L .TP Before glibc 2.10: _ATFILE_SOURCE @@ -418,11 +418,11 @@ .BR path_resolution (7), .BR symlink (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/listen.2 manpages-4.05/man2/listen.2 --- manpages-4.04/man2/listen.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/listen.2 2016-03-15 03:47:39.000000000 +0000 @@ -42,7 +42,7 @@ .\" Modified 11 May 2001 by Sam Varshavchik .\" .\" -.TH LISTEN 2 2015-12-28 "Linux" "Linux Programmer's Manual" +.TH LISTEN 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME listen \- listen for connections on a socket .SH SYNOPSIS @@ -105,7 +105,7 @@ .B EBADF The argument .I sockfd -is not a valid descriptor. +is not a valid file descriptor. .TP .B ENOTSOCK The file descriptor @@ -185,11 +185,11 @@ .BR socket (2), .BR socket (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/listxattr.2 manpages-4.05/man2/listxattr.2 --- manpages-4.04/man2/listxattr.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/listxattr.2 2016-03-15 03:47:39.000000000 +0000 @@ -340,11 +340,11 @@ .BR symlink (7), .BR xattr (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/llseek.2 manpages-4.05/man2/llseek.2 --- manpages-4.04/man2/llseek.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/llseek.2 2016-03-15 03:47:39.000000000 +0000 @@ -25,7 +25,7 @@ .\" .\" Modified Thu Oct 31 15:16:23 1996 by Eric S. Raymond .\" -.TH LLSEEK 2 2015-04-19 "Linux" "Linux Programmer's Manual" +.TH LLSEEK 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME _llseek \- reposition read/write file offset .SH SYNOPSIS @@ -43,12 +43,12 @@ .SH DESCRIPTION The .BR _llseek () -function repositions the offset of the open file associated +function repositions the offset of the open file description associated with the file descriptor .I fd to .I (offset_high<<32) | offset_low -bytes relative to the beginning of the file, the current position in the file, +bytes relative to the beginning of the file, the current file offset, or the end of the file, depending on whether .I whence is @@ -93,13 +93,14 @@ wrapper function instead. .SH SEE ALSO .BR lseek (2), +.BR open (2), .BR lseek64 (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/lookup_dcookie.2 manpages-4.05/man2/lookup_dcookie.2 --- manpages-4.04/man2/lookup_dcookie.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/lookup_dcookie.2 2016-03-15 03:47:39.000000000 +0000 @@ -86,11 +86,11 @@ The path returned may be suffixed by the string " (deleted)" if the directory entry has been removed. .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/lseek.2 manpages-4.05/man2/lseek.2 --- manpages-4.04/man2/lseek.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/lseek.2 2016-03-15 03:47:39.000000000 +0000 @@ -44,7 +44,7 @@ .\" Modified 2003-08-21 by Andries Brouwer .\" 2011-09-18, mtk, Added SEEK_DATA + SEEK_HOLE .\" -.TH LSEEK 2 2015-08-08 "Linux" "Linux Programmer's Manual" +.TH LSEEK 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME lseek \- reposition read/write file offset .SH SYNOPSIS @@ -56,8 +56,8 @@ .SH DESCRIPTION The .BR lseek () -function repositions the offset of the open file associated with the -file descriptor +function repositions the file offset of the open file description +associated with the file descriptor .I fd to the argument .I offset @@ -66,17 +66,17 @@ as follows: .TP .B SEEK_SET -The offset is set to +The file offset is set to .I offset bytes. .TP .B SEEK_CUR -The offset is set to its current location plus +The file offset is set to its current location plus .I offset bytes. .TP .B SEEK_END -The offset is set to the size of the file plus +The file offset is set to the size of the file plus .I offset bytes. .PP @@ -176,6 +176,13 @@ ext4 (since Linux 3.8) .IP * tmpfs (since Linux 3.8) +.IP * +NFS (since Linux 3.18) +.\" commit 1c6dcbe5ceff81c2cf8d929646af675cd59fe7c0 +.\" commit 24bab491220faa446d945624086d838af41d616c +.IP * +FUSE (since Linux 4.5) +.\" commit 0b5da8db145bfd44266ac964a2636a0cf8d7c286 .SH RETURN VALUE Upon successful completion, .BR lseek () @@ -213,7 +220,7 @@ .B SEEK_DATA or .BR SEEK_HOLE , -and the current file offset is beyond the end of the file. +and the file offset is beyond the end of the file. .SH CONFORMING TO POSIX.1-2001, POSIX.1-2008, SVr4, 4.3BSD. @@ -262,8 +269,8 @@ .BR dup (2) or .BR fork (2) -share the current file position pointer, so seeking on such files may be -subject to race conditions. +refer to the same open file descriptions (and thus file offsets), +so seeking on such files may be subject to race conditions. .SH SEE ALSO .BR dup (2), .BR fork (2), @@ -272,11 +279,11 @@ .BR lseek64 (3), .BR posix_fallocate (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/madvise.2 manpages-4.05/man2/madvise.2 --- manpages-4.04/man2/madvise.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/madvise.2 2016-03-15 03:47:39.000000000 +0000 @@ -32,7 +32,7 @@ .\" 2011-09-18, Doug Goldstein .\" Document MADV_HUGEPAGE and MADV_NOHUGEPAGE .\" -.TH MADVISE 2 2015-04-19 "Linux" "Linux Programmer's Manual" +.TH MADVISE 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME madvise \- give advice about use of memory .SH SYNOPSIS @@ -46,7 +46,16 @@ .in .sp .BR madvise (): +.PD 0 +.RS 4 +.TP 4 +Since glibc 2.19: +_DEFAULT_SOURCE +.TP +Up to and including glibc 2.19: _BSD_SOURCE +.RE +.PD .SH DESCRIPTION The .BR madvise () @@ -229,7 +238,12 @@ .TP .BR MADV_HWPOISON " (since Linux 2.6.32) .\" commit 9893e49d64a4874ea67849ee2cfbf3f3d6817573 -Poison a page and handle it like a hardware memory corruption. +Poison the pages in the range specified by +.I addr +and +.IR length +and handle subsequent references to those pages +like a hardware memory corruption. This operation is available only for privileged .RB ( CAP_SYS_ADMIN ) processes. @@ -241,26 +255,6 @@ it is available only if the kernel was configured with .BR CONFIG_MEMORY_FAILURE . .TP -.BR MADV_SOFT_OFFLINE " (since Linux 2.6.33) -.\" commit afcf938ee0aac4ef95b1a23bac704c6fbeb26de6 -Soft offline the pages in the range specified by -.I addr -and -.IR length . -The memory of each page in the specified range is preserved -(i.e., when next accessed, the same content will be visible, -but in a new physical page frame), -and the original page is offlined -(i.e., no longer used, and taken out of normal memory management). -The effect of the -.B MADV_SOFT_OFFLINE -operation is invisible to (i.e., does not change the semantics of) -the calling process. - -This feature is intended for testing of memory error-handling code; -it is available only if the kernel was configured with -.BR CONFIG_MEMORY_FAILURE . -.TP .BR MADV_MERGEABLE " (since Linux 2.6.32)" .\" commit f8af4da3b4c14e7267c4ffb952079af3912c51c5 Enable Kernel Samepage Merging (KSM) for the pages in the range specified by @@ -298,6 +292,26 @@ and .IR length . .TP +.BR MADV_SOFT_OFFLINE " (since Linux 2.6.33) +.\" commit afcf938ee0aac4ef95b1a23bac704c6fbeb26de6 +Soft offline the pages in the range specified by +.I addr +and +.IR length . +The memory of each page in the specified range is preserved +(i.e., when next accessed, the same content will be visible, +but in a new physical page frame), +and the original page is offlined +(i.e., no longer used, and taken out of normal memory management). +The effect of the +.B MADV_SOFT_OFFLINE +operation is invisible to (i.e., does not change the semantics of) +the calling process. + +This feature is intended for testing of memory error-handling code; +it is available only if the kernel was configured with +.BR CONFIG_MEMORY_FAILURE . +.TP .BR MADV_HUGEPAGE " (since Linux 2.6.38)" .\" commit 0af4e98b6b095c74588af04872f83d333c958c32 .\" http://lwn.net/Articles/358904/ @@ -356,6 +370,36 @@ .BR MADV_DODUMP " (since Linux 3.4)" Undo the effect of an earlier .BR MADV_DONTDUMP . +.TP +.BR MADV_FREE " (since Linux 4.5)" +The application no longer requires the pages in the range specified by +.IR addr +and +.IR len . +The kernel can thus free these pages, +but the freeing could be delayed until memory pressure occurs. +For each of the pages that has been marked to be freed +but has not yet been freed, +the free operation will be canceled if the caller writes into the page. +After a successful +.B MADV_FREE +operation, any stale data (i.e., dirty, unwritten pages) will be lost +when the kernel frees the pages. +However, subsequent writes to pages in the range will succeed +and then kernel cannot free those dirtied pages, +so that the caller can always see just written data. +If there is no subsequent write, +the kernel can free the pages at any time. +Once pages in the range have been freed, the caller will +see zero-fill-on-demand pages upon subsequent page references. + +The +.B MADV_FREE +operation +can be applied only to private anonymous pages (see +.BR mmap (2)). +On a swapless system, freeing pages in a given range happens instantly, +regardless of memory pressure. .SH RETURN VALUE On success, .BR madvise () @@ -490,11 +534,11 @@ .BR prctl (2), .BR core (5) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/mbind.2 manpages-4.05/man2/mbind.2 --- manpages-4.04/man2/mbind.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/mbind.2 2016-03-15 03:47:39.000000000 +0000 @@ -469,11 +469,11 @@ .BR numa (7), .BR numactl (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/membarrier.2 manpages-4.05/man2/membarrier.2 --- manpages-4.04/man2/membarrier.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/membarrier.2 2016-03-15 03:47:39.000000000 +0000 @@ -29,7 +29,6 @@ .B #include .sp .BI "int membarrier(int " cmd ", int " flags "); -.sp .SH DESCRIPTION The .BR membarrier () @@ -69,7 +68,6 @@ The .I cmd argument is one of the following: - .TP .B MEMBARRIER_CMD_QUERY Query the set of supported commands. @@ -93,7 +91,6 @@ The .I flags argument is currently unused and must be specified as 0. - .PP All memory accesses performed in program order from each targeted thread are guaranteed to be ordered with respect to @@ -117,7 +114,6 @@ barrier() X X O smp_mb() X O O membarrier() O O O - .SH RETURN VALUE On success, the .B MEMBARRIER_CMD_QUERY @@ -138,7 +134,6 @@ .I flags set to 0, error handling is required only for the first call to .BR membarrier (). - .SH ERRORS .TP .B EINVAL @@ -151,18 +146,15 @@ The .BR membarrier () system call is not implemented by this kernel. - .SH VERSIONS The .BR membarrier () system call was added in Linux 4.3. - +.\" .SH CONFORMING TO .BR membarrier () is Linux-specific. - .SH NOTES - A memory barrier instruction is part of the instruction set of architectures with weakly-ordered memory models. It orders memory @@ -179,9 +171,7 @@ .BR membarrier () can be useful include implementations of Read-Copy-Update libraries and garbage collectors. - .SH EXAMPLE - Assuming a multithreaded application where "fast_path()" is executed very frequently, and where "slow_path()" is executed infrequently, the following code (x86) can be transformed using @@ -319,11 +309,11 @@ .fi .in .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/memfd_create.2 manpages-4.05/man2/memfd_create.2 --- manpages-4.04/man2/memfd_create.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/memfd_create.2 2016-03-15 03:47:39.000000000 +0000 @@ -18,7 +18,7 @@ .\" . .\" %%%LICENSE_END .\" -.TH MEMFD_CREATE 2 2015-12-28 Linux "Linux Programmer's Manual" +.TH MEMFD_CREATE 2 2016-03-15 Linux "Linux Programmer's Manual" .SH NAME memfd_create \- create an anonymous file .SH SYNOPSIS @@ -109,7 +109,7 @@ .RB ( O_RDWR ) and .B O_LARGEFILE -is set for the descriptor. +is set for the file descriptor. With respect to .BR fork (2) @@ -215,7 +215,6 @@ its peer can't modify the shared memory in an undesired fashion. An example of the usage of the sealing mechanism is as follows: - .IP 1. 3 The first process creates a .I tmpfs @@ -337,7 +336,7 @@ .BR memfd_create () by opening the .IR /proc/PID/fd -file that corresponds to the descriptor opened by +file that corresponds to the file descriptor opened by .BR memfd_create (). Using that pathname, we inspect the content of the .IR /proc/PID/fd @@ -491,11 +490,11 @@ .BR shmget (2), .BR shm_open (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/migrate_pages.2 manpages-4.05/man2/migrate_pages.2 --- manpages-4.04/man2/migrate_pages.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/migrate_pages.2 2016-03-15 03:47:39.000000000 +0000 @@ -183,11 +183,11 @@ .IR Documentation/vm/page_migration in the Linux kernel source tree .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/mincore.2 manpages-4.05/man2/mincore.2 --- manpages-4.04/man2/mincore.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/mincore.2 2016-03-15 03:47:39.000000000 +0000 @@ -31,7 +31,7 @@ .\" after message from .\" 2007-01-08 mtk, rewrote various parts .\" -.TH MINCORE 2 2008-04-22 "Linux" "Linux Programmer's Manual" +.TH MINCORE 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME mincore \- determine whether pages are resident in memory .SH SYNOPSIS @@ -47,7 +47,10 @@ .in .sp .BR mincore (): -_BSD_SOURCE || _SVID_SOURCE + Since glibc 2.19: + _DEFAULT_SOURCE + Glibc 2.19 and earlier: + _BSD_SOURCE || _SVID_SOURCE .SH DESCRIPTION .BR mincore () returns a vector that indicates whether pages @@ -167,11 +170,11 @@ .BR mlock (2), .BR mmap (2) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/mkdir.2 manpages-4.05/man2/mkdir.2 --- manpages-4.04/man2/mkdir.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/mkdir.2 2016-03-15 03:47:39.000000000 +0000 @@ -8,7 +8,7 @@ .\" Public License. It comes with NO WARRANTY. .\" %%%LICENSE_END .\" -.TH MKDIR 2 2015-05-07 "Linux" "Linux Programmer's Manual" +.TH MKDIR 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME mkdir, mkdirat \- create a directory .SH SYNOPSIS @@ -36,7 +36,7 @@ .RS 4 .TP 4 Since glibc 2.10: -_XOPEN_SOURCE\ >=\ 700 || _POSIX_C_SOURCE\ >=\ 200809L +_POSIX_C_SOURCE\ >=\ 200809L .TP Before glibc 2.10: _ATFILE_SOURCE @@ -247,11 +247,11 @@ .BR acl (5) .BR path_resolution (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/mknod.2 manpages-4.05/man2/mknod.2 --- manpages-4.04/man2/mknod.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/mknod.2 2016-03-15 03:47:39.000000000 +0000 @@ -12,7 +12,7 @@ .\" Modified 2003-04-23 by Michael Kerrisk .\" Modified 2004-06-23 by Michael Kerrisk .\" -.TH MKNOD 2 2015-05-07 "Linux" "Linux Programmer's Manual" +.TH MKNOD 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME mknod, mknodat \- create a special or ordinary file .SH SYNOPSIS @@ -39,8 +39,10 @@ .BR mknod (): .ad l .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 || -_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED +_XOPEN_SOURCE\ >=\ 500 +.\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .ad .SH DESCRIPTION @@ -284,6 +286,7 @@ and .BR mknodat (2). .SH SEE ALSO +.BR mknod (1), .BR chmod (2), .BR chown (2), .BR fcntl (2), @@ -298,11 +301,11 @@ .BR acl (5) .BR path_resolution (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/mlock.2 manpages-4.05/man2/mlock.2 --- manpages-4.04/man2/mlock.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/mlock.2 2016-03-15 03:47:39.000000000 +0000 @@ -463,11 +463,11 @@ .BR proc (5), .BR capabilities (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/mmap.2 manpages-4.05/man2/mmap.2 --- manpages-4.04/man2/mmap.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/mmap.2 2016-03-15 03:47:39.000000000 +0000 @@ -37,7 +37,7 @@ .\" 2007-07-10, mtk, Added an example program. .\" 2008-11-18, mtk, document MAP_STACK .\" -.TH MMAP 2 2015-12-28 "Linux" "Linux Programmer's Manual" +.TH MMAP 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME mmap, munmap \- map or unmap files or devices into memory .SH SYNOPSIS @@ -585,11 +585,15 @@ Certain .I flags -constants are defined only if either +constants are defined only if suitable feature test macros are defined +(possibly by default): +.BR _DEFAULT_SOURCE +with glibc 2.19 or later; +or .BR _BSD_SOURCE or .BR _SVID_SOURCE -is defined. +in glibc 2.19 and earlier. (Requiring .BR _GNU_SOURCE also suffices, @@ -827,11 +831,11 @@ .\" Repeat after me: private read-only mappings are 100% equivalent to .\" shared read-only mappings. No ifs, buts, or maybes. -- Linus .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/mmap2.2 manpages-4.05/man2/mmap2.2 --- manpages-4.04/man2/mmap2.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/mmap2.2 2016-03-15 03:47:39.000000000 +0000 @@ -99,11 +99,11 @@ .BR msync (2), .BR shm_open (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/modify_ldt.2 manpages-4.05/man2/modify_ldt.2 --- manpages-4.04/man2/modify_ldt.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/modify_ldt.2 2016-03-15 03:47:39.000000000 +0000 @@ -209,11 +209,11 @@ .BR set_thread_area (2), .BR vm86 (2) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/mount.2 manpages-4.05/man2/mount.2 --- manpages-4.04/man2/mount.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/mount.2 2016-03-15 03:47:39.000000000 +0000 @@ -37,7 +37,7 @@ .\" 2008-10-06, mtk: move umount*() material into separate umount.2 page. .\" 2008-10-06, mtk: Add discussion of namespaces. .\" -.TH MOUNT 2 2015-04-19 "Linux" "Linux Programmer's Manual" +.TH MOUNT 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME mount \- mount filesystem .SH SYNOPSIS @@ -91,9 +91,7 @@ .\" MS_SHARED .\" Mount points that are marked SHARED propagate mount events .\" to one another after being cloned. - .\" mount --make-rshared ==> MS_SHARED | MS_REC - .\" MS_SLAVE .\" A previously shared mount point can be marked SLAVE, meaning .\" it receives propagated events, but does not propagate events. @@ -529,14 +527,15 @@ .BR namespaces (7), .BR path_resolution (7), .BR lsblk (8), +.BR findmnt (8), .BR mount (8), .BR umount (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/move_pages.2 manpages-4.05/man2/move_pages.2 --- manpages-4.04/man2/move_pages.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/move_pages.2 2016-03-15 03:47:39.000000000 +0000 @@ -235,11 +235,11 @@ .BR migratepages (8), .BR numastat (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/mprotect.2 manpages-4.05/man2/mprotect.2 --- manpages-4.04/man2/mprotect.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/mprotect.2 2016-03-15 03:47:39.000000000 +0000 @@ -247,11 +247,11 @@ .BR mmap (2), .BR sysconf (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/mq_getsetattr.2 manpages-4.05/man2/mq_getsetattr.2 --- manpages-4.04/man2/mq_getsetattr.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/mq_getsetattr.2 2016-03-15 03:47:39.000000000 +0000 @@ -57,11 +57,11 @@ .BR mq_getattr (3), .BR mq_overview (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/mremap.2 manpages-4.05/man2/mremap.2 --- manpages-4.04/man2/mremap.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/mremap.2 2016-03-15 03:47:39.000000000 +0000 @@ -223,11 +223,11 @@ \fIInside Linux\fP by Randolf Bentson, \fIThe Design of the UNIX Operating System\fP by Maurice J. Bach) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/msgctl.2 manpages-4.05/man2/msgctl.2 --- manpages-4.04/man2/msgctl.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/msgctl.2 2016-03-15 03:47:39.000000000 +0000 @@ -372,11 +372,11 @@ .BR mq_overview (7), .BR svipc (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/msgget.2 manpages-4.05/man2/msgget.2 --- manpages-4.04/man2/msgget.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/msgget.2 2016-03-15 03:47:39.000000000 +0000 @@ -239,11 +239,11 @@ .BR mq_overview (7), .BR svipc (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/msgop.2 manpages-4.05/man2/msgop.2 --- manpages-4.04/man2/msgop.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/msgop.2 2016-03-15 03:47:39.000000000 +0000 @@ -430,7 +430,7 @@ .BR signal (7). .TP .B EINVAL -.I msgqid +.I msqid was invalid, or .I msgsz was less than 0. @@ -589,7 +589,6 @@ .RB "$" " ./a.out \-r" message received: a message at Wed Mar 4 16:25:45 2015 - .fi .in .SS Program source @@ -715,11 +714,11 @@ .BR mq_overview (7), .BR svipc (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/msync.2 manpages-4.05/man2/msync.2 --- manpages-4.04/man2/msync.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/msync.2 2016-03-15 03:47:39.000000000 +0000 @@ -152,11 +152,11 @@ B.O. Gallmeister, POSIX.4, O'Reilly, pp. 128-129 and 389-391. .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/nanosleep.2 manpages-4.05/man2/nanosleep.2 --- manpages-4.04/man2/nanosleep.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/nanosleep.2 2016-03-15 03:47:39.000000000 +0000 @@ -31,7 +31,7 @@ .\" NOTES: describe case where clock_nanosleep() can be preferable. .\" NOTES: describe CLOCK_REALTIME versus CLOCK_NANOSLEEP .\" Replace crufty discussion of HZ with a pointer to time(7). -.TH NANOSLEEP 2 2015-08-08 "Linux" "Linux Programmer's Manual" +.TH NANOSLEEP 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME nanosleep \- high-resolution sleep .SH SYNOPSIS @@ -114,7 +114,8 @@ .TP .B EINTR The pause has been interrupted by a signal that was -delivered to the thread. +delivered to the thread (see +.BR signal (7)). The remaining sleep time has been written into .I *rem @@ -216,11 +217,11 @@ .BR usleep (3), .BR time (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/nfsservctl.2 manpages-4.05/man2/nfsservctl.2 --- manpages-4.04/man2/nfsservctl.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/nfsservctl.2 2016-03-15 03:47:39.000000000 +0000 @@ -62,11 +62,11 @@ .SH CONFORMING TO This call is Linux-specific. .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/nice.2 manpages-4.05/man2/nice.2 --- manpages-4.04/man2/nice.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/nice.2 2016-03-15 03:47:39.000000000 +0000 @@ -28,7 +28,7 @@ .\" Modified 2001-06-04 by aeb .\" Modified 2004-05-27 by Michael Kerrisk .\" -.TH NICE 2 2015-08-08 "Linux" "Linux Programmer's Manual" +.TH NICE 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME nice \- change process priority .SH SYNOPSIS @@ -42,7 +42,9 @@ .in .sp .BR nice (): -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE +_XOPEN_SOURCE + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .SH DESCRIPTION .BR nice () adds @@ -111,11 +113,11 @@ .BR capabilities (7), .BR sched (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/open.2 manpages-4.05/man2/open.2 --- manpages-4.04/man2/open.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/open.2 2016-03-15 03:47:39.000000000 +0000 @@ -48,7 +48,7 @@ .\" FIXME . Apr 08: The next POSIX revision has O_EXEC, O_SEARCH, and .\" O_TTYINIT. Eventually these may need to be documented. --mtk .\" -.TH OPEN 2 2015-12-05 "Linux" "Linux Programmer's Manual" +.TH OPEN 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME open, openat, creat \- open and possibly create a file .SH SYNOPSIS @@ -78,7 +78,7 @@ .RS 4 .TP 4 Since glibc 2.10: -_XOPEN_SOURCE\ >=\ 700 || _POSIX_C_SOURCE\ >=\ 200809L +_POSIX_C_SOURCE\ >=\ 200809L .TP Before glibc 2.10: _ATFILE_SOURCE @@ -236,7 +236,7 @@ .BR O_CLOEXEC flag to deal with this problem.) .\" This flag fixes only one form of the race condition; -.\" The race can also occur with, for example, descriptors +.\" The race can also occur with, for example, file descriptors .\" returned by accept(), pipe(), etc. .TP .B O_CREAT @@ -256,8 +256,9 @@ .\" XFS (since 2.6.14). .RS .PP +The .I mode -specifies the mode to use in case a new file is created. +argument specifies the file mode bits be applied when a new file is created. This argument must be supplied when .B O_CREAT or @@ -710,7 +711,6 @@ .B O_EXCL otherwise.) - There are two main use cases for .\" Inspired by http://lwn.net/Articles/559147/ .BR O_TMPFILE : @@ -744,7 +744,9 @@ XFS support was added .\" commit 99b6436bc29e4f10e4388c27a3e4810191cc4788 .\" commit ab29743117f9f4c22ac44c13c1647fb24fb2bafe -in Linux 3.15. +in Linux 3.15, and Btrfs support was added +.\" commit ef3b9af50bfa6a1f02cd7b3f5124b712b1ba3e3c +in Linux 3.16. .TP .B O_TRUNC If the file already exists and is a regular file and the access mode allows @@ -1099,7 +1101,6 @@ This is typically used to open devices in order to get a file descriptor for use with .BR ioctl (2). - .LP The (undefined) effect of .B O_RDONLY | O_TRUNC @@ -1142,6 +1143,17 @@ and .I st_mtime fields are set to the current time. + +The files in the +.I /proc/[pid]/fd +directory show the open file descriptors of the process with the PID +.IR pid . +The files in the +.I /proc/[pid]/fdinfo +directory show even more information about these files descriptors. +See +.BR proc (5) +for further details of both of these directories. .\" .\" .SS Open file descriptions @@ -1311,10 +1323,10 @@ Linux reserves the special, nonstandard access mode 3 (binary 11) in .I flags to mean: -check for read and write permission on the file and return a descriptor +check for read and write permission on the file and return a file descriptor that can't be used for reading or writing. This nonstandard access mode is used by some Linux drivers to return a -descriptor that is to be used only for device-specific +file descriptor that is to be used only for device-specific .BR ioctl (2) operations. .\" See for example util-linux's disk-utils/setfdprm.c @@ -1580,11 +1592,11 @@ .BR path_resolution (7), .BR symlink (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/open_by_handle_at.2 manpages-4.05/man2/open_by_handle_at.2 --- manpages-4.04/man2/open_by_handle_at.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/open_by_handle_at.2 2016-03-15 03:47:39.000000000 +0000 @@ -237,7 +237,6 @@ .B O_NOFOLLOW flag, if specified, is ignored. - The caller must have the .B CAP_DAC_READ_SEARCH capability to invoke @@ -734,11 +733,11 @@ .UR https://www.kernel.org/pub/linux/utils/util-linux/ .UE .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/outb.2 manpages-4.05/man2/outb.2 --- manpages-4.04/man2/outb.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/outb.2 2016-03-15 03:47:39.000000000 +0000 @@ -97,11 +97,11 @@ .BR ioperm (2), .BR iopl (2) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/pause.2 manpages-4.05/man2/pause.2 --- manpages-4.04/man2/pause.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/pause.2 2016-03-15 03:47:39.000000000 +0000 @@ -62,11 +62,11 @@ .BR signal (2), .BR sigsuspend (2) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/pciconfig_read.2 manpages-4.05/man2/pciconfig_read.2 --- manpages-4.04/man2/pciconfig_read.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/pciconfig_read.2 2016-03-15 03:47:39.000000000 +0000 @@ -114,11 +114,11 @@ .SH SEE ALSO .BR capabilities (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/perf_event_open.2 manpages-4.05/man2/perf_event_open.2 --- manpages-4.04/man2/perf_event_open.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/perf_event_open.2 2016-03-15 03:47:39.000000000 +0000 @@ -362,7 +362,7 @@ .\" commit 60e2364e60e86e81bc6377f49779779e6120977f .B PERF_ATTR_SIZE_VER5 is 112 corresponding to the addition of -.I aux_watermak +.I aux_watermark in Linux 4.1. .\" commit 1a5941312414c71dece6717da9a0fa1303127afa .TP @@ -1046,7 +1046,7 @@ ) only measure events happening inside a guest instance. This is only meaningful outside the guests; this setting does not change counts gathered inside of a guest. -Currently this functionality is x86 only. +Currently, this functionality is x86 only. .TP .IR "exclude_guest" " (since Linux 3.2)" .\" commit a240f76165e6255384d4bdb8139895fac7988799 @@ -1057,7 +1057,7 @@ ) do not measure events happening inside guest instances. This is only meaningful outside the guests; this setting does not change counts gathered inside of a guest. -Currently this functionality is x86 only. +Currently, this functionality is x86 only. .TP .IR "exclude_callchain_kernel" " (since Linux 3.7)" .\" commit d077526485d5c9b12fe85d0b2b3b7041e6bc5f91 @@ -1226,11 +1226,9 @@ .TP .B PERF_SAMPLE_BRANCH_PLM_ALL A convenience value that is the three preceding values ORed together. - .P In addition to the privilege value, at least one or more of the following bits must be set. - .TP .B PERF_SAMPLE_BRANCH_ANY Any branch type. @@ -1265,7 +1263,6 @@ This requires hardware support, currently only found on Intel x86 Haswell or newer. .RE - .TP .IR "sample_regs_user" " (since Linux 3.7)" .\" commit 4018994f3d8785275ef0e7391b75c3462c029e56 @@ -1492,7 +1489,6 @@ and .I cap_user_rdpmc fields instead. - .TP .IR cap_bit0_is_deprecated " (since Linux 3.12)" .\" commit fa7315871046b9a4c48627905691dbde57e51033 @@ -1509,7 +1505,6 @@ .I cap_usr_rdpmc map to the same bit and thus both features should be used with caution. - .TP .IR cap_user_rdpmc " (since Linux 3.12)" .\" commit fa7315871046b9a4c48627905691dbde57e51033 @@ -1816,7 +1811,6 @@ depend on the .I type selected as shown. - .RS .TP 4 .B PERF_RECORD_MMAP @@ -2131,7 +2125,6 @@ .IR abort " (since Linux 3.11)" .\" commit 135c5612c460f89657c4698fe2ea753f6f667963 The branch was in an aborted transactional memory transaction. - .P The entries are from most to least recent, so the first entry has the most recent branch. @@ -2147,7 +2140,6 @@ .I branch_sample_type field. .RE - .TP .IR abi ", " regs[weight(mask)] If @@ -2693,7 +2685,6 @@ .\" commit ad0cf3478de8677f720ee06393b3147819568d6a this ioctl always failed due to a bug in the kernel. - .TP .B PERF_EVENT_IOC_SET_OUTPUT This tells the kernel to report event notifications to the specified @@ -3168,11 +3159,11 @@ .BR prctl (2), .BR read (2) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/perfmonctl.2 manpages-4.05/man2/perfmonctl.2 --- manpages-4.04/man2/perfmonctl.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/perfmonctl.2 2016-03-15 03:47:39.000000000 +0000 @@ -148,7 +148,7 @@ .B PFM_GET_FEATURES .\" pfm_get_features() .nf -.BI "perfmonctl(int " fd ", PFM_GET_FEARURES, pfarg_features_t *" arg ", 1); +.BI "perfmonctl(int " fd ", PFM_GET_FEATURES, pfarg_features_t *" arg ", 1); .fi .TP .B PFM_DEBUG @@ -207,11 +207,11 @@ The perfmon2 interface specification .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/personality.2 manpages-4.05/man2/personality.2 --- manpages-4.04/man2/personality.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/personality.2 2016-03-15 03:47:39.000000000 +0000 @@ -1,4 +1,5 @@ .\" Copyright (C) 1995, Thomas K. Dyas +.\" and Copyright (C) 2016, Michael Kerrisk .\" .\" %%%LICENSE_START(VERBATIM) .\" Permission is granted to make and distribute verbatim copies of this @@ -29,7 +30,7 @@ .\" changed prototype, documented 0xffffffff, aeb, 030101 .\" Modified 2004-11-03 patch from Martin Schulze .\" -.TH PERSONALITY 2 2015-12-28 "Linux" "Linux Programmer's Manual" +.TH PERSONALITY 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME personality \- set the process execution domain .SH SYNOPSIS @@ -59,6 +60,192 @@ A list of the available execution domains can be found in .IR . +The execution domain is a 32-bit value in which the top three +bytes are set aside for flags that cause the kernel to modify the +behavior of certain system calls so as to emulate historical or +architectural quirks. +The least significant byte is value defining the personality +the kernel should assume. +The flag values are as follows: +.TP +.BR ADDR_COMPAT_LAYOUT " (since Linux 2.6.9)" +With this flag set, provide legacy virtual address space layout. +.TP +.BR ADDR_NO_RANDOMIZE " (since Linux 2.6.12)" +With this flag set, disable address-space-layout randomization. +.TP +.BR ADDR_LIMIT_32BIT " (since Linux 2.2)" +Limit the address space to 32 bits. +.TP +.BR ADDR_LIMIT_3GB " (since Linux 2.4.0)" +With this flag set, use 0xc0000000 as the offset at which to search +a virtual memory chunk on +.BR mmap (2); +otherwise use 0xffffe000. +.TP +.BR FDPIC_FUNCPTRS " (since Linux 2.6.11)" +User-space function pointers to signal handlers point +(on certain architectures) to descriptors. +.TP +.BR MMAP_PAGE_ZERO " (since Linux 2.4.0)" +Map page 0 as read-only +(to support binaries that depend on this SVr4 behavior). +.TP +.BR READ_IMPLIES_EXEC " (since Linux 2.6.8)" +With this flag set, +.BR PROT_READ +implies +.BR PROT_EXEC +for +.BR mmap (2). +.TP +.BR SHORT_INODE " (since Linux 2.4.0)" +No effects(?). +.TP +.BR STICKY_TIMEOUTS " (since Linux 1.2.0)" +With this flag set, +.BR select (2), +.BR pselect (2), +and +.BR ppoll (2) +do not modify the returned timeout argument when +interrupted by a signal handler. +.TP +.BR UNAME26 " (since Linux 3.1)" +Have +.BR uname (2) +report a 2.6.40+ version number rather than a 3.x version number. +Added as a stopgap measure to support broken applications that +could not handle the kernel version-numbering switch from 2.6.x to 3.x. +.TP +.BR WHOLE_SECONDS " (since Linux 1.2.0)" +No effects(?). +.PP +The available execution domains are: +.TP +.BR PER_BSD " (since Linux 1.2.0)" +BSD. (No effects.) +.TP +.BR PER_HPUX " (since Linux 2.4)" +Support for 32-bit HP/UX. +This support was never complete, and was dropped so that since Linux 4.0, +this value has no effect. +.TP +.BR PER_IRIX32 " (since Linux 2.2)" +IRIX 5 32-bit. +Never fully functional; support dropped in Linux 2.6.27. +Implies +.BR STICKY_TIMEOUTS . +.TP +.BR PER_IRIX64 " (since Linux 2.2)" +IRIX 6 64-bit. +Implies +.BR STICKY_TIMEOUTS ; +otherwise no effects. +.TP +.BR PER_IRIXN32 " (since Linux 2.2)" +IRIX 6 new 32-bit. +Implies +.BR STICKY_TIMEOUTS ; +otherwise no effects. +.TP +.BR PER_ISCR4 " (since Linux 1.2.0)" +Implies +.BR STICKY_TIMEOUTS ; +otherwise no effects. +.TP +.BR PER_LINUX " (since Linux 1.2.0)" +Linux. +.TP +.BR PER_LINUX32 " (since Linux 2.2)" +[To be documented.] +.TP +.BR PER_LINUX32_3GB " (since Linux 2.4)" +Implies +.BR ADDR_LIMIT_3GB . +.TP +.BR PER_LINUX_32BIT " (since Linux 2.0)" +Implies +.BR ADDR_LIMIT_32BIT . +.TP +.BR PER_LINUX_FDPIC " (since Linux 2.6.11)" +Implies +.BR FDPIC_FUNCPTRS . +.TP +.BR PER_OSF4 " (since Linux 2.4)" +OSF/1 v4. +On alpha, +.\" Following is from a comment in arch/alpha/kernel/osf_sys.c +clear top 32 bits of iov_len in the user's buffer for +compatibility with old versions of OSF/1 where iov_len +was defined as. +.IR int . +.TP +.BR PER_OSR5 " (since Linux 2.4)" +Implies +.BR STICKY_TIMEOUTS +and +.BR WHOLE_SECONDS ; +otherwise no effects. +.TP +.BR PER_RISCOS " (since Linux 2.2)" +[To be documented.] +.TP +.BR PER_SCOSVR3 " (since Linux 1.2.0)" +Implies +.BR STICKY_TIMEOUTS , +.BR WHOLE_SECONDS , +and +.BR SHORT_INODE ; +otherwise no effects. +.TP +.BR PER_SOLARIS " (since Linux 2.4)" +Implies +.BR STICKY_TIMEOUTS ; +otherwise no effects. +.TP +.BR PER_SUNOS " (since Linux 2.4.0)" +Implies +.BR STICKY_TIMEOUTS . +Divert library and dynamic linker searches to +.IR /usr/gnemul . +Buggy, largely unmaintained, and almost entirely unused; +support was removed in Linux 2.6.26. +.TP +.BR PER_SVR3 " (since Linux 1.2.0)" +Implies +.BR STICKY_TIMEOUTS +and +.BR SHORT_INODE ; +otherwise no effects. +.TP +.BR PER_SVR4 " (since Linux 1.2.0)" +Implies +.BR STICKY_TIMEOUTS +and +.BR MMAP_PAGE_ZERO ; +otherwise no effects. +.TP +.BR PER_UW7 " (since Linux 2.4)" +Implies +.BR STICKY_TIMEOUTS +and +.BR MMAP_PAGE_ZERO ; +otherwise no effects. +.TP +.BR PER_WYSEV386 " (since Linux 1.2.0)" +Implies +.BR STICKY_TIMEOUTS +and +.BR SHORT_INODE ; +otherwise no effects. +.TP +.BR PER_XENIX " (since Linux 1.2.0)" +Implies +.BR STICKY_TIMEOUTS +and +.BR SHORT_INODE ; +otherwise no effects. .SH RETURN VALUE On success, the previous .I persona @@ -71,7 +258,8 @@ .B EINVAL The kernel was unable to change the personality. .SH VERSIONS -This system call first appeared in Linux 1.1.20; +This system call first appeared in Linux 1.1.20 +(and thus first in a stable kernel release with Linux 1.2.0); library support was added in glibc 2.3. .\" personality wrapper first appeared in glibc 1.90, .\" was added later in 2.2.91. @@ -82,11 +270,11 @@ .SH SEE ALSO .BR setarch (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/pipe.2 manpages-4.05/man2/pipe.2 --- manpages-4.04/man2/pipe.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/pipe.2 2016-03-15 03:47:39.000000000 +0000 @@ -33,7 +33,7 @@ .\" to EXAMPLE text. .\" 2008-10-10, mtk: add description of pipe2() .\" -.TH PIPE 2 2015-12-28 "Linux" "Linux Programmer's Manual" +.TH PIPE 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME pipe, pipe2 \- create pipe .SH SYNOPSIS @@ -135,6 +135,20 @@ On error, \-1 is returned, and .I errno is set appropriately. + +On Linux (and other systems), +.BR pipe () +does not modify +.I pipefd +on failure. +A requirement standardizing this behavior was added in POSIX.1-2016. +.\" http://austingroupbugs.net/view.php?id=467 +The Linux-specific +.BR pipe2 () +system call +likewise does not modify +.I pipefd +on failure. .SH ERRORS .TP .B EFAULT @@ -171,7 +185,7 @@ descriptors that refer to the same pipe. After the .BR fork (2), -each process closes the descriptors that it doesn't need for the pipe +each process closes the file descriptors that it doesn't need for the pipe (see .BR pipe (7)). The parent then writes the string contained in the program's @@ -238,11 +252,11 @@ .BR popen (3), .BR pipe (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/pivot_root.2 manpages-4.05/man2/pivot_root.2 --- manpages-4.04/man2/pivot_root.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/pivot_root.2 2016-03-15 03:47:39.000000000 +0000 @@ -147,11 +147,11 @@ .BR initrd (4), .BR pivot_root (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/poll.2 manpages-4.05/man2/poll.2 --- manpages-4.04/man2/poll.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/poll.2 2016-03-15 03:47:39.000000000 +0000 @@ -28,7 +28,7 @@ .\" 2006-07-01, mtk, Added POLLRDHUP + various other wording and .\" formatting changes. .\" -.TH POLL 2 2015-12-28 "Linux" "Linux Programmer's Manual" +.TH POLL 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME poll, ppoll \- wait for some event on a file descriptor .SH SYNOPSIS @@ -364,6 +364,20 @@ is Linux-specific. .\" NetBSD 3.0 has a pollts() which is like Linux ppoll(). .SH NOTES +On some other UNIX systems, +.\" Darwin, according to a report by Jeremy Sequoia, relayed by Josh Triplett +.BR poll () +can fail with the error +.B EAGAIN +if the system fails to allocate kernel-internal resources, rather than +.B ENOMEM +as Linux does. +POSIX permits this behavior. +Portable programs may wish to check for +.B EAGAIN +and loop, just as with +.BR EINTR . + Some implementations define the nonstandard constant .B INFTIM with the value \-1 for use as a @@ -414,11 +428,11 @@ .BR epoll (7), .BR time (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/posix_fadvise.2 manpages-4.05/man2/posix_fadvise.2 --- manpages-4.04/man2/posix_fadvise.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/posix_fadvise.2 2016-03-15 03:47:39.000000000 +0000 @@ -25,7 +25,7 @@ .\" 2005-04-08 mtk, noted kernel version and added BUGS .\" 2010-10-09, mtk, document arm_fadvise64_64() .\" -.TH POSIX_FADVISE 2 2015-07-23 "Linux" "Linux Programmer's Manual" +.TH POSIX_FADVISE 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME posix_fadvise \- predeclare an access pattern for file data .SH SYNOPSIS @@ -44,7 +44,7 @@ .sp .BR posix_fadvise (): .RS 4 -_XOPEN_SOURCE\ >=\ 600 || _POSIX_C_SOURCE\ >=\ 200112L +_POSIX_C_SOURCE\ >=\ 200112L .RE .ad .SH DESCRIPTION @@ -156,7 +156,7 @@ Requests to discard partial pages are ignored. It is preferable to preserve needed data than discard unneeded data. -If the application requires that data be considered for discarding then +If the application requires that data be considered for discarding, then .I offset and .I len @@ -219,11 +219,11 @@ .BR posix_fallocate (3), .BR posix_madvise (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/prctl.2 manpages-4.05/man2/prctl.2 --- manpages-4.04/man2/prctl.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/prctl.2 2016-03-15 03:47:39.000000000 +0000 @@ -311,9 +311,9 @@ .TP .BR PR_SET_KEEPCAPS " (since Linux 2.2.18)" Set the state of the thread's "keep capabilities" flag, -which determines whether the threads's permitted -capability set is cleared when a change is made to the threads's user IDs -such that the threads's real UID, effective UID, and saved set-user-ID +which determines whether the thread's permitted +capability set is cleared when a change is made to the thread's user IDs +such that the thread's real UID, effective UID, and saved set-user-ID all become nonzero when at least one of them previously had the value 0. By default, the permitted capability set is cleared when such a change is made; setting the "keep capabilities" flag prevents it from being cleared. @@ -328,7 +328,7 @@ .BR execve (2). .TP .BR PR_GET_KEEPCAPS " (since Linux 2.2.18)" -Return (as the function result) the current state of the calling threads's +Return (as the function result) the current state of the calling thread's "keep capabilities" flag. .TP .BR PR_MCE_KILL " (since Linux 2.6.32)" @@ -1349,11 +1349,11 @@ .BR signal (2), .BR core (5) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/pread.2 manpages-4.05/man2/pread.2 --- manpages-4.04/man2/pread.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/pread.2 2016-03-15 03:47:39.000000000 +0000 @@ -170,11 +170,11 @@ .BR readv (2), .BR write (2) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/process_vm_readv.2 manpages-4.05/man2/process_vm_readv.2 --- manpages-4.04/man2/process_vm_readv.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/process_vm_readv.2 2016-03-15 03:47:39.000000000 +0000 @@ -348,11 +348,11 @@ .BR readv (2), .BR writev (2) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/ptrace.2 manpages-4.05/man2/ptrace.2 --- manpages-4.04/man2/ptrace.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/ptrace.2 2016-03-15 03:47:39.000000000 +0000 @@ -2085,7 +2085,7 @@ .B PTRACE_ATTACH to any other process running under the same UID, as long as the tracee is dumpable (i.e., it did -did not transition UIDs or start start privileged, and it has not employed +not transition UIDs or start privileged, and it has not employed the .BR prctl (2) .B PR_SET_DUMPABLE @@ -2277,11 +2277,11 @@ .BR capabilities (7), .BR signal (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/query_module.2 manpages-4.05/man2/query_module.2 --- manpages-4.04/man2/query_module.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/query_module.2 2016-03-15 03:47:39.000000000 +0000 @@ -19,7 +19,7 @@ .fi .IR Note : -No declaration of this function is provided in glibc headers; see NOTES. +No declaration of this system call is provided in glibc headers; see NOTES. .SH DESCRIPTION .IR Note : This system call is present only in kernels before Linux 2.6. @@ -198,11 +198,11 @@ .BR lsmod (8), .BR modinfo (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/quotactl.2 manpages-4.05/man2/quotactl.2 --- manpages-4.04/man2/quotactl.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/quotactl.2 2016-03-15 03:47:39.000000000 +0000 @@ -510,11 +510,11 @@ .BR quotacheck (8), .BR quotaon (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/read.2 manpages-4.05/man2/read.2 --- manpages-4.04/man2/read.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/read.2 2016-03-15 03:47:39.000000000 +0000 @@ -32,7 +32,7 @@ .\" Modified Sat Jul 12 20:45:39 1997 by Michael Haardt .\" .\" -.TH READ 2 2015-07-23 "Linux" "Linux Programmer's Manual" +.TH READ 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME read \- read from a file descriptor .SH SYNOPSIS @@ -51,9 +51,9 @@ .IR buf . On files that support seeking, -the read operation commences at the current file offset, +the read operation commences at the file offset, and the file offset is incremented by the number of bytes read. -If the current file offset is at or past the end of file, +If the file offset is at or past the end of file, no bytes are read, and .BR read () returns zero. @@ -140,7 +140,7 @@ .IR buf , the value specified in .IR count , -or the current file offset is not suitably aligned. +or the file offset is not suitably aligned. .TP .B EINVAL .I fd @@ -256,11 +256,11 @@ .BR write (2), .BR fread (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/readahead.2 manpages-4.05/man2/readahead.2 --- manpages-4.04/man2/readahead.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/readahead.2 2016-03-15 03:47:39.000000000 +0000 @@ -25,7 +25,7 @@ .\" 2004-05-40 Created by Michael Kerrisk .\" 2004-10-05 aeb, minor correction .\" -.TH READAHEAD 2 2014-03-15 "Linux" "Linux Programmer's Manual" +.TH READAHEAD 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME readahead \- initiate file readahead into page cache .SH SYNOPSIS @@ -60,7 +60,7 @@ .IR "(offset+count)" . .BR readahead () does not read beyond the end of the file. -The current file offset of the open file referred to by +The file offset of the open file description referred to by .I fd is left unchanged. .SH RETURN VALUE @@ -111,11 +111,11 @@ .BR posix_fadvise (2), .BR read (2) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/readdir.2 manpages-4.05/man2/readdir.2 --- manpages-4.04/man2/readdir.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/readdir.2 2016-03-15 03:47:39.000000000 +0000 @@ -128,11 +128,11 @@ .BR getdents (2), .BR readdir (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/readlink.2 manpages-4.05/man2/readlink.2 --- manpages-4.04/man2/readlink.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/readlink.2 2016-03-15 03:47:39.000000000 +0000 @@ -41,7 +41,7 @@ .\" 2011-09-20, Guillem Jover : .\" Added text on dynamically allocating buffer + example program .\" -.TH READLINK 2 2014-10-15 "Linux" "Linux Programmer's Manual" +.TH READLINK 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME readlink, readlinkat \- read value of a symbolic link .SH SYNOPSIS @@ -66,8 +66,9 @@ .ad l .BR readlink (): .RS 4 -_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 || -_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED || _POSIX_C_SOURCE\ >=\ 200112L +_XOPEN_SOURCE\ >=\ 500 || _POSIX_C_SOURCE\ >=\ 200112L +.\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED + || /* Glibc versions <= 2.19: */ _BSD_SOURCE .RE .sp .BR readlinkat (): @@ -76,7 +77,7 @@ .RS 4 .TP 4 Since glibc 2.10: -_XOPEN_SOURCE\ >=\ 700 || _POSIX_C_SOURCE\ >=\ 200809L +_POSIX_C_SOURCE\ >=\ 200809L .TP Before glibc 2.10: _ATFILE_SOURCE @@ -177,7 +178,9 @@ .\" Subject: [patch 0/3] [RFC] kernel/glibc mismatch of "readlink" syscall? .TP .B EINVAL -The named file is not a symbolic link. +The named file (i.e., the final filename component of +.IR pathname ) +is not a symbolic link. .TP .B EIO An I/O error occurred while reading from the filesystem. @@ -334,11 +337,11 @@ .BR path_resolution (7), .BR symlink (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/readv.2 manpages-4.05/man2/readv.2 --- manpages-4.04/man2/readv.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/readv.2 2016-03-15 03:47:39.000000000 +0000 @@ -29,7 +29,7 @@ .\" add more details. .\" 2010-11-16, mtk, Added documentation of preadv() and pwritev() .\" -.TH READV 2 2015-07-23 "Linux" "Linux Programmer's Manual" +.TH READV 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME readv, writev, preadv, pwritev \- read or write data into multiple buffers .SH SYNOPSIS @@ -54,7 +54,10 @@ .sp .BR preadv (), .BR pwritev (): -_BSD_SOURCE + Since glibc 2.19: + _DEFAULT_SOURCE + Glibc 2.19 and earlier: + _BSD_SOURCE .SH DESCRIPTION The .BR readv () @@ -131,6 +134,7 @@ and .BR writev () are atomic: the data written by +.\" Regarding atomicity, see https://bugzilla.kernel.org/show_bug.cgi?id=10596 .BR writev () is written as a single block that is not intermingled with output from writes in other processes (but see @@ -245,8 +249,8 @@ .IR sysconf(_SC_IOV_MAX) . On modern Linux systems, the limit is 1024. Back in Linux 2.0 days, this limit was 16. -\" -\" +.\" +.\" .SS C library/kernel differences The raw .BR preadv () @@ -330,11 +334,11 @@ .BR read (2), .BR write (2) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/reboot.2 manpages-4.05/man2/reboot.2 --- manpages-4.04/man2/reboot.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/reboot.2 2016-03-15 03:47:39.000000000 +0000 @@ -226,11 +226,11 @@ .BR halt (8), .BR reboot (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/recv.2 manpages-4.05/man2/recv.2 --- manpages-4.04/man2/recv.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/recv.2 2016-03-15 03:47:39.000000000 +0000 @@ -38,7 +38,7 @@ .\" Modified 1998,1999 by Andi Kleen .\" 2001-06-19 corrected SO_EE_OFFENDER, bug report by James Hawtin .\" -.TH RECV 2 2015-12-28 "Linux" "Linux Programmer's Manual" +.TH RECV 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME recv, recvfrom, recvmsg \- receive a message from a socket .SH SYNOPSIS @@ -68,6 +68,26 @@ This page first describes common features of all three system calls, and then describes the differences between the calls. .PP +The only difference between +.BR recv () +and +.BR read (2) +is the presence of +.IR flags . +With a zero +.I flags +argument, +.BR recv () +is equivalent to +.BR read (2). +Also, the following call + + recv(sockfd, buf, len, flags); + +is equivalent to + + recvfrom(sockfd, buf, len, flags, NULL, NULL); +.PP All three calls return the length of the message on successful completion. If a message is too long to fit in the supplied buffer, excess @@ -250,6 +270,7 @@ However, the call may still return less data than requested if a signal is caught, an error or disconnect occurs, or the next data to be received is of a different type than that returned. +This flag has no effect for datagram sockets. .\" .SS recvfrom() .BR recvfrom () @@ -372,9 +393,10 @@ .nf struct cmsghdr { - socklen_t cmsg_len; /* data byte count, including hdr */ - int cmsg_level; /* originating protocol */ - int cmsg_type; /* protocol-specific type */ + size_t cmsg_len; /* Data byte count, including header + (type is socklen_t in POSIX) */ + int cmsg_level; /* Originating protocol */ + int cmsg_type; /* Protocol-specific type */ /* followed by unsigned char cmsg_data[]; */ }; @@ -448,7 +470,7 @@ .B EBADF The argument .I sockfd -is an invalid descriptor. +is an invalid file descriptor. .TP .B ECONNREFUSED A remote host refused to allow the network connection (typically @@ -536,11 +558,11 @@ .BR sockatmark (3), .BR socket (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/recvmmsg.2 manpages-4.05/man2/recvmmsg.2 --- manpages-4.04/man2/recvmmsg.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/recvmmsg.2 2016-03-15 03:47:39.000000000 +0000 @@ -28,7 +28,7 @@ .\" Author: Arnaldo Carvalho de Melo .\" Date: Mon Oct 12 23:40:10 2009 -0700 .\" -.TH RECVMMSG 2 2014-06-13 "Linux" "Linux Programmer's Manual" +.TH RECVMMSG 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME recvmmsg \- receive multiple messages on a socket .SH SYNOPSIS @@ -219,7 +219,7 @@ #define BUFSIZE 200 #define TIMEOUT 1 int sockfd, retval, i; - struct sockaddr_in sa; + struct sockaddr_in addr; struct mmsghdr msgs[VLEN]; struct iovec iovecs[VLEN]; char bufs[VLEN][BUFSIZE+1]; @@ -231,10 +231,10 @@ exit(EXIT_FAILURE); } - sa.sin_family = AF_INET; - sa.sin_addr.s_addr = htonl(INADDR_LOOPBACK); - sa.sin_port = htons(1234); - if (bind(sockfd, (struct sockaddr *) &sa, sizeof(sa)) == \-1) { + addr.sin_family = AF_INET; + addr.sin_addr.s_addr = htonl(INADDR_LOOPBACK); + addr.sin_port = htons(1234); + if (bind(sockfd, (struct sockaddr *) &addr, sizeof(addr)) == \-1) { perror("bind()"); exit(EXIT_FAILURE); } @@ -283,11 +283,11 @@ .BR socket (2), .BR socket (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/remap_file_pages.2 manpages-4.05/man2/remap_file_pages.2 --- manpages-4.04/man2/remap_file_pages.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/remap_file_pages.2 2016-03-15 03:47:39.000000000 +0000 @@ -181,11 +181,11 @@ .BR mremap (2), .BR msync (2) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/removexattr.2 manpages-4.05/man2/removexattr.2 --- manpages-4.04/man2/removexattr.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/removexattr.2 2016-03-15 03:47:39.000000000 +0000 @@ -118,11 +118,11 @@ .BR symlink (7), .BR xattr (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/rename.2 manpages-4.05/man2/rename.2 --- manpages-4.04/man2/rename.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/rename.2 2016-03-15 03:47:39.000000000 +0000 @@ -30,7 +30,7 @@ .\" Modified Thu Mar 3 09:49:35 2005 by Michael Haardt .\" 2007-03-25, mtk, added various text to DESCRIPTION. .\" -.TH RENAME 2 2015-07-23 "Linux" "Linux Programmer's Manual" +.TH RENAME 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME rename, renameat, renameat2 \- change the name or location of a file .SH SYNOPSIS @@ -61,7 +61,7 @@ .RS 4 .TP 4 Since glibc 2.10: -_XOPEN_SOURCE\ >=\ 700 || _POSIX_C_SOURCE\ >=\ 200809L +_POSIX_C_SOURCE\ >=\ 200809L .TP Before glibc 2.10: _ATFILE_SOURCE @@ -523,11 +523,11 @@ .BR path_resolution (7), .BR symlink (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/request_key.2 manpages-4.05/man2/request_key.2 --- manpages-4.04/man2/request_key.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/request_key.2 2016-03-15 03:47:39.000000000 +0000 @@ -8,7 +8,7 @@ .\" 2 of the License, or (at your option) any later version. .\" %%%LICENSE_END .\" -.TH REQUEST_KEY 2 2015-05-07 Linux "Linux Key Management Calls" +.TH REQUEST_KEY 2 2016-03-15 Linux "Linux Key Management Calls" .SH NAME request_key \- request a key from the kernel's key management facility .SH SYNOPSIS @@ -103,7 +103,8 @@ The keyring wasn't available for modification by the user. .TP .B EINTR -The request was interrupted by a signal. +The request was interrupted by a signal; see +.BR signal (7). .TP .B EDQUOT The key quota for this user would be exceeded by creating this key or linking @@ -139,11 +140,11 @@ .BR keyrings (7), .BR request-key (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/restart_syscall.2 manpages-4.05/man2/restart_syscall.2 --- manpages-4.04/man2/restart_syscall.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/restart_syscall.2 2016-03-15 03:47:39.000000000 +0000 @@ -142,11 +142,11 @@ .\" spent suspended is *not* deducted when the select() is restarted. .\" FIXME . check whether recvmmsg() handles stop-sig+SIGCONT properly. .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/rmdir.2 manpages-4.05/man2/rmdir.2 --- manpages-4.04/man2/rmdir.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/rmdir.2 2016-03-15 03:47:39.000000000 +0000 @@ -140,11 +140,11 @@ .BR unlink (2), .BR unlinkat (2) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/rt_sigqueueinfo.2 manpages-4.05/man2/rt_sigqueueinfo.2 --- manpages-4.04/man2/rt_sigqueueinfo.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/rt_sigqueueinfo.2 2016-03-15 03:47:39.000000000 +0000 @@ -194,11 +194,11 @@ .BR sigqueue (3), .BR signal (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/s390_pci_mmio_write.2 manpages-4.05/man2/s390_pci_mmio_write.2 --- manpages-4.04/man2/s390_pci_mmio_write.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/s390_pci_mmio_write.2 2016-03-15 03:47:39.000000000 +0000 @@ -107,11 +107,11 @@ .SH SEE ALSO .BR syscall (2) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/s390_runtime_instr.2 manpages-4.05/man2/s390_runtime_instr.2 --- manpages-4.04/man2/s390_runtime_instr.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/s390_runtime_instr.2 2016-03-15 03:47:39.000000000 +0000 @@ -89,11 +89,11 @@ .BR syscall (2), .BR signal (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/sched_get_priority_max.2 manpages-4.05/man2/sched_get_priority_max.2 --- manpages-4.04/man2/sched_get_priority_max.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/sched_get_priority_max.2 2016-03-15 03:47:39.000000000 +0000 @@ -124,11 +124,11 @@ .BR sched_setscheduler (2), .BR sched (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/sched_rr_get_interval.2 manpages-4.05/man2/sched_rr_get_interval.2 --- manpages-4.04/man2/sched_rr_get_interval.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/sched_rr_get_interval.2 2016-03-15 03:47:39.000000000 +0000 @@ -132,11 +132,11 @@ .SH SEE ALSO .BR sched (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/sched_setaffinity.2 manpages-4.05/man2/sched_setaffinity.2 --- manpages-4.04/man2/sched_setaffinity.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/sched_setaffinity.2 2016-03-15 03:47:39.000000000 +0000 @@ -31,7 +31,7 @@ .\" 2008-11-12, mtk, removed CPU_*() macro descriptions to a .\" separate CPU_SET(3) page. .\" -.TH SCHED_SETAFFINITY 2 2015-07-23 "Linux" "Linux Programmer's Manual" +.TH SCHED_SETAFFINITY 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME sched_setaffinity, sched_getaffinity \- \ set and get a thread's CPU affinity mask @@ -181,7 +181,7 @@ .BR _SC_NPROCESSORS_CONF and .BR _SC_NPROCESSORS_ONLN -parameters; and inspecting the list CPU directories under +parameters; and inspecting the list of CPU directories under .IR /sys/devices/system/cpu/ . .BR sched (7) @@ -269,12 +269,28 @@ When working on systems with large kernel CPU affinity masks, one must dynamically allocate the .I mask -argument. +argument (see +.BR CPU_ALLOC (3)). Currently, the only way to do this is by probing for the size of the required mask using .BR sched_getaffinity () calls with increasing mask sizes (until the call does not fail with the error .BR EINVAL ). + +Be aware that +.BR CPU_ALLOC (3) +may allocate a slightly larger CPU set than requested +(because CPU sets are implemented as bit masks allocated in units of +.IR sizeof(long) ). +Consequently, +.BR sched_getaffinity () +can set bits beyond the requested allocation size, because the kernel +sees a few additional bits. +Therefore, the caller should iterate over the bits in the returned set, +counting those which are set, and stop upon reaching the value returned by +.BR CPU_COUNT (3) +(rather than iterating over the number of bits +requested to be allocated). .SH EXAMPLE The program below creates a child process. The parent and child then each assign themselves to a specified CPU @@ -408,11 +424,11 @@ .BR cpuset (7), .BR sched (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/sched_setattr.2 manpages-4.05/man2/sched_setattr.2 --- manpages-4.04/man2/sched_setattr.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/sched_setattr.2 2016-03-15 03:47:39.000000000 +0000 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH SCHED_SETATTR 2 2015-07-23 "Linux" "Linux Programmer's Manual" +.TH SCHED_SETATTR 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME sched_setattr, sched_getattr \- set and get scheduling policy and attributes @@ -341,7 +341,8 @@ The caller does not have appropriate privileges. .TP .B EPERM -The caller's CPU affinity mask +The CPU affinity mask of the thread specified by +.I pid does not include all CPUs in the system (see .BR sched_setaffinity (2)). @@ -406,11 +407,11 @@ .BR sched (7) .ad .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/sched_setparam.2 manpages-4.05/man2/sched_setparam.2 --- manpages-4.04/man2/sched_setparam.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/sched_setparam.2 2016-03-15 03:47:39.000000000 +0000 @@ -140,11 +140,11 @@ .BR capabilities (7), .BR sched (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/sched_setscheduler.2 manpages-4.05/man2/sched_setscheduler.2 --- manpages-4.04/man2/sched_setscheduler.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/sched_setscheduler.2 2016-03-15 03:47:39.000000000 +0000 @@ -36,7 +36,6 @@ .BI " const struct sched_param *" param ); .sp .BI "int sched_getscheduler(pid_t " pid ); -.sp .fi .SH DESCRIPTION The @@ -240,11 +239,11 @@ .BR sched (7) .ad .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/sched_yield.2 manpages-4.05/man2/sched_yield.2 --- manpages-4.04/man2/sched_yield.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/sched_yield.2 2016-03-15 03:47:39.000000000 +0000 @@ -79,11 +79,11 @@ .SH SEE ALSO .BR sched (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/seccomp.2 manpages-4.05/man2/seccomp.2 --- manpages-4.04/man2/seccomp.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/seccomp.2 2016-03-15 03:47:39.000000000 +0000 @@ -832,11 +832,11 @@ .UR http://www.tcpdump.org/papers/bpf-usenix93.pdf .UE .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/select.2 manpages-4.05/man2/select.2 --- manpages-4.04/man2/select.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/select.2 2016-03-15 03:47:39.000000000 +0000 @@ -35,7 +35,7 @@ .\" 2005-03-11, mtk, modified pselect() text (it is now a system .\" call in 2.6.16. .\" -.TH SELECT 2 2015-07-23 "Linux" "Linux Programmer's Manual" +.TH SELECT 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME select, pselect, FD_CLR, FD_ISSET, FD_SET, FD_ZERO \- synchronous I/O multiplexing @@ -77,7 +77,7 @@ .in .sp .BR pselect (): -_POSIX_C_SOURCE\ >=\ 200112L || _XOPEN_SOURCE\ >=\ 600 +_POSIX_C_SOURCE\ >=\ 200112L .SH DESCRIPTION .BR select () and @@ -91,6 +91,13 @@ without blocking, or a sufficiently small .BR write (2)). .PP +.BR select () +can monitor only file descriptors numbers that are less than +.BR FD_SETSIZE ; +.BR poll (2) +does not have this limitation. +See BUGS. +.PP The operation of .BR select () and @@ -334,12 +341,12 @@ .BR getrlimit (2)). .TP .B EINVAL -the value contained within +The value contained within .I timeout is invalid. .TP .B ENOMEM -unable to allocate memory for internal tables. +Unable to allocate memory for internal tables. .SH VERSIONS .BR pselect () was added to Linux in kernel 2.6.16. @@ -379,6 +386,23 @@ .I fd to be a valid file descriptor. +On some other UNIX systems, +.\" Darwin, according to a report by Jeremy Sequoia, relayed by Josh Triplett +.BR select () +can fail with the error +.B EAGAIN +if the system fails to allocate kernel-internal resources, rather than +.B ENOMEM +as Linux does. +POSIX specifies this error for +.BR poll (2), +but not for +.BR select (). +Portable programs may wish to check for +.B EAGAIN +and loop, just as with +.BR EINTR . + Concerning the types involved, the classical situation is that the two fields of a .I timeval @@ -446,6 +470,14 @@ in this scenario must be considered buggy. .\" .SS C library/kernel differences +The Linux kernel allows file descriptor sets of arbitrary size, +determining the length of the sets to be checked from the value of +.IR nfds . +However, in the glibc implementation, the +.IR fd_set +type is fixed in size. +See also BUGS. + The .BR pselect () interface described in this page is implemented by glibc. @@ -490,6 +522,22 @@ while allowing for the fact that most architectures support a maximum of 6 arguments to a system call. .SH BUGS +POSIX allows an implementation to define an upper limit, +advertised via the constant +.BR FD_SETSIZE , +on the range of file descriptors that can be specified +in a file descriptor set. +The Linux kernel imposes no fixed limit, but the glibc implementation makes +.IR fd_set +a fixed-size type, with +.BR FD_SETSIZE +defined as 1024, and the +.BR FD_* () +macros operating according to that limit. +To monitor file descriptors greater than 1023, use +.BR poll (2) +instead. + Glibc 2.0 provided a version of .BR pselect () that did not take a @@ -568,10 +616,12 @@ int retval; /* Watch stdin (fd 0) to see when it has input. */ + FD_ZERO(&rfds); FD_SET(0, &rfds); /* Wait up to five seconds. */ + tv.tv_sec = 5; tv.tv_usec = 0; @@ -605,11 +655,11 @@ For a tutorial with discussion and examples, see .BR select_tut (2). .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/select_tut.2 manpages-4.05/man2/select_tut.2 --- manpages-4.04/man2/select_tut.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/select_tut.2 2016-03-15 03:47:39.000000000 +0000 @@ -29,7 +29,7 @@ .\" various other changes .\" 2008-01-26, mtk, substantial changes and rewrites .\" -.TH SELECT_TUT 2 2015-08-08 "Linux" "Linux Programmer's Manual" +.TH SELECT_TUT 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME select, pselect, FD_CLR, FD_ISSET, FD_SET, FD_ZERO \- synchronous I/O multiplexing @@ -71,7 +71,7 @@ .in .sp .BR pselect (): -_POSIX_C_SOURCE\ >=\ 200112L || _XOPEN_SOURCE\ >=\ 600 +_POSIX_C_SOURCE\ >=\ 200112L .SH DESCRIPTION .BR select () (or @@ -79,7 +79,7 @@ is used to efficiently monitor multiple file descriptors, to see if any of them is, or becomes, "ready"; that is, to see whether I/O becomes possible, -or an "exceptional condition" has occurred on any of the descriptors. +or an "exceptional condition" has occurred on any of the file descriptors. Its principal arguments are three "sets" of file descriptors: \fIreadfds\fP, \fIwritefds\fP, and \fIexceptfds\fP. @@ -313,7 +313,7 @@ .SS Practical So what is the point of .BR select ()? -Can't I just read and write to my descriptors whenever I want? +Can't I just read and write to my file descriptors whenever I want? The point of .BR select () is that it watches @@ -434,11 +434,11 @@ .BR send (2) fail with errors other than those listed in \fB7.\fP, or one of the input functions returns 0, indicating end of file, -then you should \fInot\fP pass that descriptor to +then you should \fInot\fP pass that file descriptor to .BR select () again. In the example below, -I close the descriptor immediately, and then set it to \-1 +I close the file descriptor immediately, and then set it to \-1 to prevent it being included in a set. .TP 10. @@ -553,65 +553,68 @@ static int listen_socket(int listen_port) { - struct sockaddr_in a; - int s; + struct sockaddr_in addr; + int lfd; int yes; - s = socket(AF_INET, SOCK_STREAM, 0); - if (s == \-1) { + lfd = socket(AF_INET, SOCK_STREAM, 0); + if (lfd == \-1) { perror("socket"); return \-1; } + yes = 1; - if (setsockopt(s, SOL_SOCKET, SO_REUSEADDR, + if (setsockopt(lfd, SOL_SOCKET, SO_REUSEADDR, &yes, sizeof(yes)) == \-1) { perror("setsockopt"); - close(s); + close(lfd); return \-1; } - memset(&a, 0, sizeof(a)); - a.sin_port = htons(listen_port); - a.sin_family = AF_INET; - if (bind(s, (struct sockaddr *) &a, sizeof(a)) == \-1) { + + memset(&addr, 0, sizeof(addr)); + addr.sin_port = htons(listen_port); + addr.sin_family = AF_INET; + if (bind(lfd, (struct sockaddr *) &addr, sizeof(addr)) == \-1) { perror("bind"); - close(s); + close(lfd); return \-1; } + printf("accepting connections on port %d\\n", listen_port); - listen(s, 10); - return s; + listen(lfd, 10); + return lfd; } static int connect_socket(int connect_port, char *address) { - struct sockaddr_in a; - int s; + struct sockaddr_in addr; + int cfd; - s = socket(AF_INET, SOCK_STREAM, 0); - if (s == \-1) { + cfd = socket(AF_INET, SOCK_STREAM, 0); + if (cfd == \-1) { perror("socket"); - close(s); + close(cfd); return \-1; } - memset(&a, 0, sizeof(a)); - a.sin_port = htons(connect_port); - a.sin_family = AF_INET; + memset(&addr, 0, sizeof(addr)); + addr.sin_port = htons(connect_port); + addr.sin_family = AF_INET; - if (!inet_aton(address, (struct in_addr *) &a.sin_addr.s_addr)) { + if (!inet_aton(address, (struct in_addr *) &addr.sin_addr.s_addr)) { perror("bad IP address format"); - close(s); + close(cfd); return \-1; } - if (connect(s, (struct sockaddr *) &a, sizeof(a)) == \-1) { + if (connect(cfd, (struct sockaddr *) &addr, sizeof(addr)) == \-1) { perror("connect()"); - shutdown(s, SHUT_RDWR); - close(s); + shutdown(cfd, SHUT_RDWR); + close(cfd); return \-1; } - return s; + return cfd; } #define SHUT_FD1 do { \\ @@ -656,139 +659,136 @@ exit(EXIT_FAILURE); for (;;) { - int r, nfds = 0; - fd_set rd, wr, er; - - FD_ZERO(&rd); - FD_ZERO(&wr); - FD_ZERO(&er); - FD_SET(h, &rd); + int ready, nfds = 0; + ssize_t nbytes; + fd_set readfds, writefds, exceptfds; + + FD_ZERO(&readfds); + FD_ZERO(&writefds); + FD_ZERO(&exceptfds); + FD_SET(h, &readfds); nfds = max(nfds, h); if (fd1 > 0 && buf1_avail < BUF_SIZE) { - FD_SET(fd1, &rd); + FD_SET(fd1, &readfds); nfds = max(nfds, fd1); } if (fd2 > 0 && buf2_avail < BUF_SIZE) { - FD_SET(fd2, &rd); + FD_SET(fd2, &readfds); nfds = max(nfds, fd2); } if (fd1 > 0 && buf2_avail \- buf2_written > 0) { - FD_SET(fd1, &wr); + FD_SET(fd1, &writefds); nfds = max(nfds, fd1); } if (fd2 > 0 && buf1_avail \- buf1_written > 0) { - FD_SET(fd2, &wr); + FD_SET(fd2, &writefds); nfds = max(nfds, fd2); } if (fd1 > 0) { - FD_SET(fd1, &er); + FD_SET(fd1, &exceptfds); nfds = max(nfds, fd1); } if (fd2 > 0) { - FD_SET(fd2, &er); + FD_SET(fd2, &exceptfds); nfds = max(nfds, fd2); } - r = select(nfds + 1, &rd, &wr, &er, NULL); + ready = select(nfds + 1, &readfds, &writefds, &exceptfds, NULL); - if (r == \-1 && errno == EINTR) + if (ready == \-1 && errno == EINTR) continue; - if (r == \-1) { + if (ready == \-1) { perror("select()"); exit(EXIT_FAILURE); } - if (FD_ISSET(h, &rd)) { - unsigned int l; - struct sockaddr_in client_address; - - memset(&client_address, 0, l = sizeof(client_address)); - r = accept(h, (struct sockaddr *) &client_address, &l); - if (r == \-1) { + if (FD_ISSET(h, &readfds)) { + socklen_t addrlen; + struct sockaddr_in client_addr; + int fd; + + addrlen = sizeof(client_addr); + memset(&client_addr, 0, addrlen); + fd = accept(h, (struct sockaddr *) &client_addr, &addrlen); + if (fd == \-1) { perror("accept()"); } else { SHUT_FD1; SHUT_FD2; buf1_avail = buf1_written = 0; buf2_avail = buf2_written = 0; - fd1 = r; + fd1 = fd; fd2 = connect_socket(forward_port, argv[3]); if (fd2 == \-1) SHUT_FD1; else printf("connect from %s\\n", - inet_ntoa(client_address.sin_addr)); + inet_ntoa(client_addr.sin_addr)); } } - /* NB: read oob data before normal reads */ + /* NB: read OOB data before normal reads */ - if (fd1 > 0) - if (FD_ISSET(fd1, &er)) { - char c; + if (fd1 > 0 && FD_ISSET(fd1, &exceptfds)) { + char c; - r = recv(fd1, &c, 1, MSG_OOB); - if (r < 1) - SHUT_FD1; - else - send(fd2, &c, 1, MSG_OOB); - } - if (fd2 > 0) - if (FD_ISSET(fd2, &er)) { - char c; - - r = recv(fd2, &c, 1, MSG_OOB); - if (r < 1) - SHUT_FD2; - else - send(fd1, &c, 1, MSG_OOB); - } - if (fd1 > 0) - if (FD_ISSET(fd1, &rd)) { - r = read(fd1, buf1 + buf1_avail, - BUF_SIZE \- buf1_avail); - if (r < 1) - SHUT_FD1; - else - buf1_avail += r; - } - if (fd2 > 0) - if (FD_ISSET(fd2, &rd)) { - r = read(fd2, buf2 + buf2_avail, - BUF_SIZE \- buf2_avail); - if (r < 1) - SHUT_FD2; - else - buf2_avail += r; - } - if (fd1 > 0) - if (FD_ISSET(fd1, &wr)) { - r = write(fd1, buf2 + buf2_written, - buf2_avail \- buf2_written); - if (r < 1) - SHUT_FD1; - else - buf2_written += r; - } - if (fd2 > 0) - if (FD_ISSET(fd2, &wr)) { - r = write(fd2, buf1 + buf1_written, - buf1_avail \- buf1_written); - if (r < 1) - SHUT_FD2; - else - buf1_written += r; - } + nbytes = recv(fd1, &c, 1, MSG_OOB); + if (nbytes < 1) + SHUT_FD1; + else + send(fd2, &c, 1, MSG_OOB); + } + if (fd2 > 0 && FD_ISSET(fd2, &exceptfds)) { + char c; + + nbytes = recv(fd2, &c, 1, MSG_OOB); + if (nbytes < 1) + SHUT_FD2; + else + send(fd1, &c, 1, MSG_OOB); + } + if (fd1 > 0 && FD_ISSET(fd1, &readfds)) { + nbytes = read(fd1, buf1 + buf1_avail, + BUF_SIZE \- buf1_avail); + if (nbytes < 1) + SHUT_FD1; + else + buf1_avail += nbytes; + } + if (fd2 > 0 && FD_ISSET(fd2, &readfds)) { + nbytes = read(fd2, buf2 + buf2_avail, + BUF_SIZE \- buf2_avail); + if (nbytes < 1) + SHUT_FD2; + else + buf2_avail += nbytes; + } + if (fd1 > 0 && FD_ISSET(fd1, &writefds)) { + nbytes = write(fd1, buf2 + buf2_written, + buf2_avail \- buf2_written); + if (nbytes < 1) + SHUT_FD1; + else + buf2_written += nbytes; + } + if (fd2 > 0 && FD_ISSET(fd2, &writefds)) { + nbytes = write(fd2, buf1 + buf1_written, + buf1_avail \- buf1_written); + if (nbytes < 1) + SHUT_FD2; + else + buf1_written += nbytes; + } - /* check if write data has caught read data */ + /* Check if write data has caught read data */ if (buf1_written == buf1_avail) buf1_written = buf1_avail = 0; if (buf2_written == buf2_avail) buf2_written = buf2_avail = 0; - /* one side has closed the connection, keep + /* One side has closed the connection, keep writing to the other side until empty */ if (fd1 < 0 && buf1_avail \- buf1_written == 0) @@ -838,11 +838,11 @@ .\" .SH AUTHORS .\" This man page was written by Paul Sheer. .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/semctl.2 manpages-4.05/man2/semctl.2 --- manpages-4.04/man2/semctl.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/semctl.2 2016-03-15 03:47:39.000000000 +0000 @@ -38,7 +38,7 @@ .\" Added semid_ds and ipc_perm structure definitions .\" 2005-08-02, mtk: Added IPC_INFO, SEM_INFO, SEM_STAT descriptions. .\" -.TH SEMCTL 2 2015-08-08 "Linux" "Linux Programmer's Manual" +.TH SEMCTL 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME semctl \- System V semaphore control operations .SH SYNOPSIS @@ -269,12 +269,9 @@ .B sempid for the .IR semnum \-th -semaphore of the set -(i.e., the PID of the process that executed the last -.BR semop (2) -call for the -.IR semnum \-th -semaphore of the set). +semaphore of the set. +This is the PID of the process that last performed an operation on +that semaphore (but see NOTES). The calling process must have read permission on the semaphore set. .TP .B GETVAL @@ -535,6 +532,49 @@ For greater portability, it is best to always call .BR semctl () with four arguments. +.\" +.SS The sempid value +POSIX.1 defines +.I sempid +as the "process ID of [the] last operation" on a semaphore, +and explicitly notes that this value is set by a successful +.BR semop (2) +call, with the implication that no other interface affects the +.I sempid +value. + +While some implementations conform to the behavior specified in POSIX.1, +others do not. +(The fault here probably lies with POSIX.1 inasmuch as it likely failed +to capture the full range of existing implementation behaviors.) +Various other implementations +.\" At least OpenSolaris (and, one supposes, older Solaris) and Darwin +also update +.I sempid +for the other operations that update the value of a semaphore: the +.B SETVAL +and +.B SETALL +operations, as well as the semaphore adjustments performed +on process termination as a consequence of the use of the +.B SEM_UNDO +flag (see +.BR semop (2)). + +Linux also updates +.I sempid +for +.BR SETVAL +operations and semaphore adjustments. +However, somewhat inconsistently, it does not update +.I sempid +for +.BR SETALL +operations. +While the +.B SETALL +behavior might be viewed as a bug, the behavior is longstanding, +and is probably unlikely to change. .SH SEE ALSO .BR ipc (2), .BR semget (2), @@ -543,11 +583,11 @@ .BR sem_overview (7), .BR svipc (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/semget.2 manpages-4.05/man2/semget.2 --- manpages-4.04/man2/semget.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/semget.2 2016-03-15 03:47:39.000000000 +0000 @@ -311,11 +311,11 @@ .BR sem_overview (7), .BR svipc (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/semop.2 manpages-4.05/man2/semop.2 --- manpages-4.04/man2/semop.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/semop.2 2016-03-15 03:47:39.000000000 +0000 @@ -32,7 +32,7 @@ .\" 2005-04-08, mtk, Noted kernel version numbers for semtimedop() .\" 2007-07-09, mtk, Added an EXAMPLE code segment. .\" -.TH SEMOP 2 2015-08-08 "Linux" "Linux Programmer's Manual" +.TH SEMOP 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME semop, semtimedop \- System V semaphore operations .SH SYNOPSIS @@ -63,7 +63,8 @@ unsigned short semval; /* semaphore value */ unsigned short semzcnt; /* # waiting for zero */ unsigned short semncnt; /* # waiting for increase */ -pid_t sempid; /* ID of process that did last op */ +pid_t sempid; /* PID of process that last + modified semaphore value */ .sp .in -4n .fi @@ -552,11 +553,11 @@ .BR svipc (7), .BR time (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/send.2 manpages-4.05/man2/send.2 --- manpages-4.04/man2/send.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/send.2 2016-03-15 03:47:39.000000000 +0000 @@ -37,7 +37,7 @@ .\" Modified Oct 2003 by aeb .\" Modified 2004-07-01 by mtk .\" -.TH SEND 2 2015-12-28 "Linux" "Linux Programmer's Manual" +.TH SEND 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME send, sendto, sendmsg \- send a message on a socket .SH SYNOPSIS @@ -354,7 +354,8 @@ .BR ip (7). .TP .B EBADF -An invalid descriptor was specified. +.I sockfd +is not a valid open file descriptor. .TP .B ECONNRESET Connection reset by peer. @@ -475,11 +476,11 @@ .BR tcp (7), .BR udp (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/sendfile.2 manpages-4.05/man2/sendfile.2 --- manpages-4.04/man2/sendfile.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/sendfile.2 2016-03-15 03:47:39.000000000 +0000 @@ -16,7 +16,7 @@ .\" .\" 2005-03-31 Martin Pool mmap() improvements .\" -.TH SENDFILE 2 2015-12-28 "Linux" "Linux Programmer's Manual" +.TH SENDFILE 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME sendfile \- transfer data between file descriptors .SH SYNOPSIS @@ -75,9 +75,9 @@ .I offset is not NULL, then .BR sendfile () -does not modify the current file offset of +does not modify the file offset of .IR in_fd ; -otherwise the current file offset is adjusted to reflect +otherwise the file offset is adjusted to reflect the number of bytes read from .IR in_fd . @@ -85,7 +85,7 @@ .I offset is NULL, then data will be read from .IR in_fd -starting at the current file offset, +starting at the file offset, and the file offset will be updated by the call. .I count @@ -234,19 +234,20 @@ The Linux-specific .BR splice (2) -call supports transferring data between arbitrary files -(e.g., a pair of sockets). +call supports transferring data between arbitrary file descriptors +provided one (or both) of them is a pipe. .SH SEE ALSO +.BR copy_file_range (2), .BR mmap (2), .BR open (2), .BR socket (2), .BR splice (2) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/sendmmsg.2 manpages-4.05/man2/sendmmsg.2 --- manpages-4.04/man2/sendmmsg.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/sendmmsg.2 2016-03-15 03:47:39.000000000 +0000 @@ -25,7 +25,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH SENDMMSG 2 2014-07-08 "Linux" "Linux Programmer's Manual" +.TH SENDMMSG 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME sendmmsg \- send multiple messages on a socket .SH SYNOPSIS @@ -188,7 +188,7 @@ main(void) { int sockfd; - struct sockaddr_in sa; + struct sockaddr_in addr; struct mmsghdr msg[2]; struct iovec msg1[2], msg2; int retval; @@ -199,10 +199,10 @@ exit(EXIT_FAILURE); } - sa.sin_family = AF_INET; - sa.sin_addr.s_addr = htonl(INADDR_LOOPBACK); - sa.sin_port = htons(1234); - if (connect(sockfd, (struct sockaddr *) &sa, sizeof(sa)) == \-1) { + addr.sin_family = AF_INET; + addr.sin_addr.s_addr = htonl(INADDR_LOOPBACK); + addr.sin_port = htons(1234); + if (connect(sockfd, (struct sockaddr *) &addr, sizeof(addr)) == \-1) { perror("connect()"); exit(EXIT_FAILURE); } @@ -239,11 +239,11 @@ .BR socket (2), .BR socket (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/seteuid.2 manpages-4.05/man2/seteuid.2 --- manpages-4.04/man2/seteuid.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/seteuid.2 2016-03-15 03:47:39.000000000 +0000 @@ -26,7 +26,7 @@ .\" Modified, 27 May 2004, Michael Kerrisk .\" Added notes on capability requirements .\" -.TH SETEUID 2 2015-07-23 "Linux" "Linux Programmer's Manual" +.TH SETEUID 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME seteuid, setegid \- set effective user or group ID .SH SYNOPSIS @@ -47,7 +47,8 @@ .BR seteuid (), .BR setegid (): .RS 4 -_BSD_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L || _XOPEN_SOURCE\ >=\ 600 +_POSIX_C_SOURCE\ >=\ 200112L + || /* Glibc versions <= 2.19: */ _BSD_SOURCE .RE .ad .SH DESCRIPTION @@ -147,11 +148,11 @@ .BR credentials (7), .BR user_namespaces (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/setfsgid.2 manpages-4.05/man2/setfsgid.2 --- manpages-4.04/man2/setfsgid.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/setfsgid.2 2016-03-15 03:47:39.000000000 +0000 @@ -126,11 +126,11 @@ .BR capabilities (7), .BR credentials (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/setfsuid.2 manpages-4.05/man2/setfsuid.2 --- manpages-4.04/man2/setfsuid.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/setfsuid.2 2016-03-15 03:47:39.000000000 +0000 @@ -134,11 +134,11 @@ .BR capabilities (7), .BR credentials (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/setgid.2 manpages-4.05/man2/setgid.2 --- manpages-4.04/man2/setgid.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/setgid.2 2016-03-15 03:47:39.000000000 +0000 @@ -105,11 +105,11 @@ .BR credentials (7), .BR user_namespaces (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/set_mempolicy.2 manpages-4.05/man2/set_mempolicy.2 --- manpages-4.04/man2/set_mempolicy.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/set_mempolicy.2 2016-03-15 03:47:39.000000000 +0000 @@ -296,11 +296,11 @@ .BR numa (7), .BR numactl (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/setns.2 manpages-4.05/man2/setns.2 --- manpages-4.04/man2/setns.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/setns.2 2016-03-15 03:47:39.000000000 +0000 @@ -5,7 +5,7 @@ .\" Licensed under the GPLv2 .\" %%%LICENSE_END .\" -.TH SETNS 2 2015-01-10 "Linux" "Linux Programmer's Manual" +.TH SETNS 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME setns \- reassociate thread with a namespace .SH SYNOPSIS @@ -274,7 +274,7 @@ exit(EXIT_FAILURE); } - fd = open(argv[1], O_RDONLY); /* Get descriptor for namespace */ + fd = open(argv[1], O_RDONLY); /* Get file descriptor for namespace */ if (fd == \-1) errExit("open"); @@ -293,11 +293,11 @@ .BR namespaces (7), .BR unix (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/setpgid.2 manpages-4.05/man2/setpgid.2 --- manpages-4.04/man2/setpgid.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/setpgid.2 2016-03-15 03:47:39.000000000 +0000 @@ -45,7 +45,7 @@ .\" 2007-07-25, mtk, fairly substantial rewrites and rearrangements .\" of text. .\" -.TH SETPGID 2 2014-01-07 "Linux" "Linux Programmer's Manual" +.TH SETPGID 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME setpgid, getpgid, setpgrp, getpgrp \- set/get process group .SH SYNOPSIS @@ -74,26 +74,27 @@ .PD 0 .BR getpgid (): .RS 4 -_XOPEN_SOURCE\ >=\ 500 || -_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED +_XOPEN_SOURCE\ >=\ 500 +.\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED .br -|| /* Since glibc 2.12: */ _POSIX_C_SOURCE\ >=\ 200809L + || /* Since glibc 2.12: */ _POSIX_C_SOURCE\ >=\ 200809L .RE .sp .BR setpgrp "() (POSIX.1):" .nf - _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 || - _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED -.br - || /* Since glibc 2.19: */ _BSD_SOURCE + _XOPEN_SOURCE\ >=\ 500 +.\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _SVID_SOURCE .fi .sp .BR setpgrp "()\ (BSD)," -.BR getpgrp "()\ (BSD) [before glibc 2.19]:" +.BR getpgrp "()\ (BSD):" .nf + [These are available only before glibc 2.19] _BSD_SOURCE && !\ (_POSIX_SOURCE || _POSIX_C_SOURCE || _XOPEN_SOURCE || - _XOPEN_SOURCE_EXTENDED || _GNU_SOURCE || _SVID_SOURCE) + _GNU_SOURCE || _SVID_SOURCE) .fi .PD .ad @@ -345,11 +346,11 @@ .BR termios (3), .BR credentials (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/setresuid.2 manpages-4.05/man2/setresuid.2 --- manpages-4.04/man2/setresuid.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/setresuid.2 2016-03-15 03:47:39.000000000 +0000 @@ -158,11 +158,11 @@ .BR credentials (7), .BR user_namespaces (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/setreuid.2 manpages-4.05/man2/setreuid.2 --- manpages-4.04/man2/setreuid.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/setreuid.2 2016-03-15 03:47:39.000000000 +0000 @@ -43,7 +43,7 @@ .\" 2004-07-04 by aeb .\" 2004-05-27 by Michael Kerrisk .\" -.TH SETREUID 2 2015-07-23 "Linux" "Linux Programmer's Manual" +.TH SETREUID 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME setreuid, setregid \- set real and/or effective user or group ID .SH SYNOPSIS @@ -64,8 +64,10 @@ .BR setregid (): .RS 4 .ad l -_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 || -_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED +_XOPEN_SOURCE\ >=\ 500 +.\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE .ad .RE .SH DESCRIPTION @@ -220,11 +222,11 @@ .BR credentials (7), .BR user_namespaces (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/setsid.2 manpages-4.05/man2/setsid.2 --- manpages-4.04/man2/setsid.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/setsid.2 2016-03-15 03:47:39.000000000 +0000 @@ -98,11 +98,11 @@ .BR tcgetsid (3), .BR credentials (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/set_thread_area.2 manpages-4.05/man2/set_thread_area.2 --- manpages-4.04/man2/set_thread_area.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/set_thread_area.2 2016-03-15 03:47:39.000000000 +0000 @@ -165,11 +165,11 @@ .BR arch_prctl (2), .BR modify_ldt (2) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/set_tid_address.2 manpages-4.05/man2/set_tid_address.2 --- manpages-4.04/man2/set_tid_address.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/set_tid_address.2 2016-03-15 03:47:39.000000000 +0000 @@ -101,11 +101,11 @@ .BR futex (2), .BR gettid (2) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/setuid.2 manpages-4.05/man2/setuid.2 --- manpages-4.04/man2/setuid.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/setuid.2 2016-03-15 03:47:39.000000000 +0000 @@ -170,11 +170,11 @@ .BR credentials (7), .BR user_namespaces (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/setup.2 manpages-4.05/man2/setup.2 --- manpages-4.04/man2/setup.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/setup.2 2016-03-15 03:47:39.000000000 +0000 @@ -70,11 +70,11 @@ and at other times a single argument .IR "int magic" . .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/setxattr.2 manpages-4.05/man2/setxattr.2 --- manpages-4.04/man2/setxattr.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/setxattr.2 2016-03-15 03:47:39.000000000 +0000 @@ -166,11 +166,11 @@ .BR symlink (7), .BR xattr (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/sgetmask.2 manpages-4.05/man2/sgetmask.2 --- manpages-4.04/man2/sgetmask.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/sgetmask.2 2016-03-15 03:47:39.000000000 +0000 @@ -90,11 +90,11 @@ .BR sigprocmask (2), .BR signal (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/shmctl.2 manpages-4.05/man2/shmctl.2 --- manpages-4.04/man2/shmctl.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/shmctl.2 2016-03-15 03:47:39.000000000 +0000 @@ -433,11 +433,11 @@ .BR capabilities (7), .BR svipc (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/shmget.2 manpages-4.05/man2/shmget.2 --- manpages-4.04/man2/shmget.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/shmget.2 2016-03-15 03:47:39.000000000 +0000 @@ -412,11 +412,11 @@ .BR shm_overview (7), .BR svipc (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/shmop.2 manpages-4.05/man2/shmop.2 --- manpages-4.04/man2/shmop.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/shmop.2 2016-03-15 03:47:39.000000000 +0000 @@ -299,11 +299,11 @@ .BR shm_overview (7), .BR svipc (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/shutdown.2 manpages-4.05/man2/shutdown.2 --- manpages-4.04/man2/shutdown.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/shutdown.2 2016-03-15 03:47:39.000000000 +0000 @@ -37,7 +37,7 @@ .\" Modified Tue Oct 22 22:04:51 1996 by Eric S. Raymond .\" Modified 1998 by Andi Kleen .\" -.TH SHUTDOWN 2 2015-12-28 "Linux" "Linux Programmer's Manual" +.TH SHUTDOWN 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME shutdown \- shut down part of a full-duplex connection .SH SYNOPSIS @@ -75,7 +75,7 @@ .TP .B EBADF .I sockfd -is not a valid descriptor. +is not a valid file descriptor. .TP .B EINVAL An invalid value was specified in @@ -118,11 +118,11 @@ .BR socket (2), .BR socket (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/sigaction.2 manpages-4.05/man2/sigaction.2 --- manpages-4.04/man2/sigaction.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/sigaction.2 2016-03-15 03:47:39.000000000 +0000 @@ -46,7 +46,7 @@ .\" 2015-01-17, Kees Cook .\" Added notes on ptrace SIGTRAP and SYS_SECCOMP. .\" -.TH SIGACTION 2 2015-08-08 "Linux" "Linux Programmer's Manual" +.TH SIGACTION 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME sigaction, rt_sigaction \- examine and change a signal action .SH SYNOPSIS @@ -64,7 +64,7 @@ .sp .ad l .BR sigaction (): -_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _POSIX_SOURCE +_POSIX_C_SOURCE .IR siginfo_t : _POSIX_C_SOURCE >= 199309L @@ -928,11 +928,11 @@ .BR core (5), .BR signal (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/sigaltstack.2 manpages-4.05/man2/sigaltstack.2 --- manpages-4.04/man2/sigaltstack.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/sigaltstack.2 2016-03-15 03:47:39.000000000 +0000 @@ -24,7 +24,7 @@ .\" %%%LICENSE_END .\" .\" aeb, various minor fixes -.TH SIGALTSTACK 2 2015-07-23 "Linux" "Linux Programmer's Manual" +.TH SIGALTSTACK 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME sigaltstack \- set and/or get signal stack context .SH SYNOPSIS @@ -41,10 +41,10 @@ .ad l .RS 4 .PD 0 -_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 || -_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED -.br -|| /* Since glibc 2.12: */ _POSIX_C_SOURCE\ >=\ 200809L +_XOPEN_SOURCE\ >=\ 500 +.\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED + || /* Since glibc 2.12: */ _POSIX_C_SOURCE\ >=\ 200809L + || /* Glibc versions <= 2.19: */ _BSD_SOURCE .PD .RE .ad @@ -252,11 +252,11 @@ .BR sigsetjmp (3), .BR signal (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/signal.2 manpages-4.05/man2/signal.2 --- manpages-4.04/man2/signal.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/signal.2 2016-03-15 03:47:39.000000000 +0000 @@ -33,7 +33,7 @@ .\" various sections. .\" 2008-07-11, mtk: rewrote and expanded portability discussion. .\" -.TH SIGNAL 2 2015-08-08 "Linux" "Linux Programmer's Manual" +.TH SIGNAL 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME signal \- ANSI C signal handling .SH SYNOPSIS @@ -155,6 +155,10 @@ .I sig_t if .B _BSD_SOURCE +(glibc 2.19 and earlier) +or +.BR _DEFAULT_SOURCE +(glibc 2.19 and later) is defined. Without use of such a type, the declaration of .BR signal () @@ -232,34 +236,18 @@ Instead, it calls .BR sigaction (2) using flags that supply BSD semantics. -This default behavior is provided as long as the -.B _BSD_SOURCE -feature test macro is defined. -By default, +This default behavior is provided as long as a suitable +feature test macro is defined: .B _BSD_SOURCE -is defined; -it is also implicitly defined if one defines -.BR _GNU_SOURCE , -and can of course be explicitly defined. -.IP * -On glibc 2 and later, if the -.B _BSD_SOURCE -feature test macro is not defined, then +on glibc 2.19 and earlier or +.BR _DEFAULT_SOURCE +in glibc 2.19 and later. +(By default, these macros are defined; see +.BR feature_test_macros (7) +for details.) +If such a feature test macro is not defined, then .BR signal () provides System\ V semantics. -(The default implicit definition of -.B _BSD_SOURCE -is not provided if one invokes -.BR gcc (1) -in one of its standard modes -.RI ( -std=xxx " or " -ansi ) -or defines various other feature test macros such as -.BR _POSIX_SOURCE , -.BR _XOPEN_SOURCE , -or -.BR _SVID_SOURCE ; -see -.BR feature_test_macros (7).) .\" .\" System V semantics are also provided if one uses the separate .\" .BR sysv_signal (3) @@ -295,11 +283,11 @@ .BR sysv_signal (3), .BR signal (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/signalfd.2 manpages-4.05/man2/signalfd.2 --- manpages-4.04/man2/signalfd.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/signalfd.2 2016-03-15 03:47:39.000000000 +0000 @@ -17,7 +17,7 @@ .\" . .\" %%%LICENSE_END .\" -.TH SIGNALFD 2 2015-12-05 Linux "Linux Programmer's Manual" +.TH SIGNALFD 2 2016-03-15 Linux "Linux Programmer's Manual" .SH NAME signalfd \- create a file descriptor for accepting signals .SH SYNOPSIS @@ -62,13 +62,13 @@ then the call creates a new file descriptor and associates the signal set specified in .I mask -with that descriptor. +with that file descriptor. If .I fd is not \-1, then it must specify a valid existing signalfd file descriptor, and .I mask -is used to replace the signal set associated with that descriptor. +is used to replace the signal set associated with that file descriptor. Starting with Linux 2.6.27, the following values may be bitwise ORed in .IR flags @@ -327,11 +327,20 @@ .BR poll (2), or .BR epoll (7): -the arrival of different signals will make different descriptors ready.) +the arrival of different signals will make different file descriptors ready.) If a signal appears in the .I mask of more than one of the file descriptors, then occurrences -of that signal can be read (once) from any one of the descriptors. +of that signal can be read (once) from any one of the file descriptors. + +The signal mask employed by a signalfd file descriptor can be viewed +via the entry for the corresponding file descriptor in the process's +.IR /proc/[pid]/fdinfo +directory. +See +.BR proc (5) +for further details. +.\" .SS C library/kernel differences The underlying Linux system call requires an additional argument, .IR "size_t sizemask" , @@ -453,11 +462,11 @@ .BR epoll (7), .BR signal (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/sigpending.2 manpages-4.05/man2/sigpending.2 --- manpages-4.04/man2/sigpending.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/sigpending.2 2016-03-15 03:47:39.000000000 +0000 @@ -26,7 +26,7 @@ .\" .\" 2005-09-15, mtk, Created new page by splitting off from sigaction.2 .\" -.TH SIGPENDING 2 2015-07-23 "Linux" "Linux Programmer's Manual" +.TH SIGPENDING 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME sigpending, rt_sigpending \- examine pending signals .SH SYNOPSIS @@ -41,7 +41,7 @@ .sp .ad l .BR sigpending (): -_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _POSIX_SOURCE +_POSIX_C_SOURCE .ad b .SH DESCRIPTION .PP @@ -125,11 +125,11 @@ .BR sigsetops (3), .BR signal (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/sigprocmask.2 manpages-4.05/man2/sigprocmask.2 --- manpages-4.04/man2/sigprocmask.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/sigprocmask.2 2016-03-15 03:47:39.000000000 +0000 @@ -26,7 +26,7 @@ .\" .\" 2005-09-15, mtk, Created new page by splitting off from sigaction.2 .\" -.TH SIGPROCMASK 2 2015-07-23 "Linux" "Linux Programmer's Manual" +.TH SIGPROCMASK 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME sigprocmask, rt_sigprocmask \- examine and change blocked signals .SH SYNOPSIS @@ -42,7 +42,7 @@ .sp .ad l .BR sigprocmask (): -_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _POSIX_SOURCE +_POSIX_C_SOURCE .ad b .SH DESCRIPTION .BR sigprocmask () @@ -86,6 +86,11 @@ .I oldset (if it is not NULL). +A set of functions for modifying and inspecting variables of type +.I sigset_t +("signal sets") is described in +.BR sigsetops (3). + The use of .BR sigprocmask () is unspecified in a multithreaded process; see @@ -191,11 +196,11 @@ .BR sigsetops (3), .BR signal (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/sigreturn.2 manpages-4.05/man2/sigreturn.2 --- manpages-4.04/man2/sigreturn.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/sigreturn.2 2016-03-15 03:47:39.000000000 +0000 @@ -144,11 +144,11 @@ .BR signal (7), .BR vdso (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/sigsuspend.2 manpages-4.05/man2/sigsuspend.2 --- manpages-4.04/man2/sigsuspend.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/sigsuspend.2 2016-03-15 03:47:39.000000000 +0000 @@ -26,7 +26,7 @@ .\" .\" 2005-09-15, mtk, Created new page by splitting off from sigaction.2 .\" -.TH SIGSUSPEND 2 2015-07-23 "Linux" "Linux Programmer's Manual" +.TH SIGSUSPEND 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME sigsuspend, rt_sigsuspend \- wait for a signal .SH SYNOPSIS @@ -41,7 +41,7 @@ .sp .ad l .BR sigsuspend (): -_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _POSIX_SOURCE +_POSIX_C_SOURCE .ad b .SH DESCRIPTION .BR sigsuspend () @@ -80,7 +80,8 @@ points to memory which is not a valid part of the process address space. .TP .B EINTR -The call was interrupted by a signal. +The call was interrupted by a signal; +.BR signal (7). .SH CONFORMING TO POSIX.1-2001, POSIX.1-2008. .SH NOTES @@ -144,11 +145,11 @@ .BR sigwait (3), .BR signal (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/sigwaitinfo.2 manpages-4.05/man2/sigwaitinfo.2 --- manpages-4.04/man2/sigwaitinfo.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/sigwaitinfo.2 2016-03-15 03:47:39.000000000 +0000 @@ -236,11 +236,11 @@ .BR signal (7), .BR time (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/socket.2 manpages-4.05/man2/socket.2 --- manpages-4.04/man2/socket.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/socket.2 2016-03-15 03:47:39.000000000 +0000 @@ -51,7 +51,8 @@ .BI "int socket(int " domain ", int " type ", int " protocol ); .SH DESCRIPTION .BR socket () -creates an endpoint for communication and returns a descriptor. +creates an endpoint for communication and returns a file descriptor +that refers to that endpoint. .PP The .I domain @@ -426,11 +427,11 @@ reprinted in .I UNIX Programmer's Supplementary Documents Volume 1. .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/socketcall.2 manpages-4.05/man2/socketcall.2 --- manpages-4.04/man2/socketcall.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/socketcall.2 2016-03-15 03:47:39.000000000 +0000 @@ -82,11 +82,11 @@ .BR socket (2), .BR socketpair (2) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/socketpair.2 manpages-4.05/man2/socketpair.2 --- manpages-4.04/man2/socketpair.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/socketpair.2 2016-03-15 03:47:39.000000000 +0000 @@ -39,7 +39,7 @@ .\" Modified 2004-06-17 by Michael Kerrisk .\" 2008-10-11, mtk: Add description of SOCK_NONBLOCK and SOCK_CLOEXEC .\" -.TH SOCKETPAIR 2 2015-12-28 "Linux" "Linux Programmer's Manual" +.TH SOCKETPAIR 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME socketpair \- create a pair of connected sockets .SH SYNOPSIS @@ -61,7 +61,7 @@ For further details of these arguments, see .BR socket (2). -The descriptors used in referencing the new sockets are returned in +The file descriptors used in referencing the new sockets are returned in .IR sv [0] and .IR sv [1]. @@ -71,6 +71,14 @@ On error, \-1 is returned, and .I errno is set appropriately. + +On Linux (and other systems), +.BR socketpair () +does not modify +.I sv +on failure. +A requirement standardizing this behavior was added in POSIX.1-2016. +.\" http://austingroupbugs.net/view.php?id=483 .SH ERRORS .TP .B EAFNOSUPPORT @@ -130,11 +138,11 @@ .BR socket (7), .BR unix (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/splice.2 manpages-4.05/man2/splice.2 --- manpages-4.04/man2/splice.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/splice.2 2016-03-15 03:47:39.000000000 +0000 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH SPLICE 2 2014-12-31 "Linux" "Linux Programmer's Manual" +.TH SPLICE 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME splice \- splice data to/from a pipe .SH SYNOPSIS @@ -46,7 +46,7 @@ .I fd_in to the file descriptor .IR fd_out , -where one of the descriptors must refer to a pipe. +where one of the file descriptors must refer to a pipe. The following semantics apply for .I fd_in @@ -65,8 +65,8 @@ .I off_in is NULL, then bytes are read from .I fd_in -starting from the current file offset, -and the current file offset is adjusted appropriately. +starting from the file offset, +and the file offset is adjusted appropriately. .IP * If .I fd_in @@ -77,7 +77,7 @@ must point to a buffer which specifies the starting offset from which bytes will be read from .IR fd_in ; -in this case, the current file offset of +in this case, the file offset of .I fd_in is not changed. .PP @@ -137,10 +137,13 @@ .BR splice () returns the number of bytes spliced to or from the pipe. -A return value of 0 means that there was no data to transfer, -and it would not make sense to block, because there are no -writers connected to the write end of the pipe referred to by -.IR fd_in . + +A return value of 0 means end of input. +If +.I fd_in +refers to a pipe, then this means that there was no data to transfer, +and it would not make sense to block because there are no writers +connected to the write end of the pipe. On error, .BR splice () @@ -164,7 +167,7 @@ target file is opened in append mode; .\" The append-mode error is given since 2.6.27; in earlier kernels, .\" splice() in append mode was broken -neither of the descriptors refers to a pipe; or +neither of the file descriptors refers to a pipe; or offset given for nonseekable device. .TP .B ENOMEM @@ -238,15 +241,16 @@ See .BR tee (2). .SH SEE ALSO +.BR copy_file_range (2), .BR sendfile (2), .BR tee (2), .BR vmsplice (2) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/spu_create.2 manpages-4.05/man2/spu_create.2 --- manpages-4.04/man2/spu_create.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/spu_create.2 2016-03-15 03:47:39.000000000 +0000 @@ -273,11 +273,11 @@ .BR capabilities (7), .BR spufs (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/spu_run.2 manpages-4.05/man2/spu_run.2 --- manpages-4.04/man2/spu_run.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/spu_run.2 2016-03-15 03:47:39.000000000 +0000 @@ -267,11 +267,11 @@ .BR capabilities (7), .BR spufs (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/stat.2 manpages-4.05/man2/stat.2 --- manpages-4.04/man2/stat.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/stat.2 2016-03-15 03:47:39.000000000 +0000 @@ -37,7 +37,7 @@ .\" 2007-06-08 mtk: Added example program .\" 2007-07-05 mtk: Added details on underlying system call interfaces .\" -.TH STAT 2 2015-07-23 "Linux" "Linux Programmer's Manual" +.TH STAT 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME stat, fstat, lstat, fstatat \- get file status .SH SYNOPSIS @@ -71,14 +71,14 @@ .sp .BR lstat (): .RS 4 -/* glibc 2.19 and earlier */ _BSD_SOURCE || +/* glibc 2.19 and earlier */ _BSD_SOURCE .br -/* Since glibc 2.20 */_DEFAULT_SOURCE || + || /* Since glibc 2.20 */ _DEFAULT_SOURCE .br -_XOPEN_SOURCE\ >=\ 500 || -_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED + || _XOPEN_SOURCE\ >=\ 500 +.\" _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED .br -|| /* Since glibc 2.10: */ _POSIX_C_SOURCE\ >=\ 200112L + || /* Since glibc 2.10: */ _POSIX_C_SOURCE\ >=\ 200112L .RE .sp .BR fstatat (): @@ -87,7 +87,7 @@ .RS 4 .TP 4 Since glibc 2.10: -_XOPEN_SOURCE\ >=\ 700 || _POSIX_C_SOURCE\ >=\ 200809L +_POSIX_C_SOURCE\ >=\ 200809L .TP Before glibc 2.10: _ATFILE_SOURCE @@ -140,7 +140,7 @@ struct stat { dev_t st_dev; /* ID of device containing file */ ino_t st_ino; /* inode number */ - mode_t st_mode; /* protection */ + mode_t st_mode; /* file type and mode */ nlink_t st_nlink; /* number of hard links */ uid_t st_uid; /* user ID of owner */ gid_t st_gid; /* group ID of owner */ @@ -566,7 +566,7 @@ .TP .B EBADF .I fd -is bad. +is not a valid open file descriptor. .TP .B EFAULT Bad address. @@ -1009,11 +1009,11 @@ .BR capabilities (7), .BR symlink (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/statfs.2 manpages-4.05/man2/statfs.2 --- manpages-4.04/man2/statfs.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/statfs.2 2016-03-15 03:47:39.000000000 +0000 @@ -25,7 +25,7 @@ .\" Modified 2003-08-17 by Walter Harms .\" Modified 2004-06-23 by Michael Kerrisk .\" -.TH STATFS 2 2015-02-21 "Linux" "Linux Programmer's Manual" +.TH STATFS 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME statfs, fstatfs \- get filesystem statistics .SH SYNOPSIS @@ -68,38 +68,38 @@ Filesystem types: ADFS_SUPER_MAGIC 0xadf5 - AFFS_SUPER_MAGIC 0xADFF + AFFS_SUPER_MAGIC 0xadff BDEVFS_MAGIC 0x62646576 BEFS_SUPER_MAGIC 0x42465331 - BFS_MAGIC 0x1BADFACE + BFS_MAGIC 0x1badface BINFMTFS_MAGIC 0x42494e4d - BTRFS_SUPER_MAGIC 0x9123683E + BTRFS_SUPER_MAGIC 0x9123683e CGROUP_SUPER_MAGIC 0x27e0eb - CIFS_MAGIC_NUMBER 0xFF534D42 + CIFS_MAGIC_NUMBER 0xff534d42 CODA_SUPER_MAGIC 0x73757245 - COH_SUPER_MAGIC 0x012FF7B7 + COH_SUPER_MAGIC 0x012ff7b7 CRAMFS_MAGIC 0x28cd3d45 DEBUGFS_MAGIC 0x64626720 DEVFS_SUPER_MAGIC 0x1373 DEVPTS_SUPER_MAGIC 0x1cd1 EFIVARFS_MAGIC 0xde5e81e4 - EFS_SUPER_MAGIC 0x00414A53 - EXT_SUPER_MAGIC 0x137D - EXT2_OLD_SUPER_MAGIC 0xEF51 - EXT2_SUPER_MAGIC 0xEF53 - EXT3_SUPER_MAGIC 0xEF53 - EXT4_SUPER_MAGIC 0xEF53 + EFS_SUPER_MAGIC 0x00414a53 + EXT_SUPER_MAGIC 0x137d + EXT2_OLD_SUPER_MAGIC 0xef51 + EXT2_SUPER_MAGIC 0xef53 + EXT3_SUPER_MAGIC 0xef53 + EXT4_SUPER_MAGIC 0xef53 FUSE_SUPER_MAGIC 0x65735546 - FUTEXFS_SUPER_MAGIC 0xBAD1DEA + FUTEXFS_SUPER_MAGIC 0xbad1dea HFS_SUPER_MAGIC 0x4244 HOSTFS_SUPER_MAGIC 0x00c0ffee - HPFS_SUPER_MAGIC 0xF995E849 + HPFS_SUPER_MAGIC 0xf995e849 HUGETLBFS_MAGIC 0x958458f6 ISOFS_SUPER_MAGIC 0x9660 JFFS2_SUPER_MAGIC 0x72b6 JFS_SUPER_MAGIC 0x3153464a - MINIX_SUPER_MAGIC 0x137F /* orig. minix */ - MINIX_SUPER_MAGIC2 0x138F /* 30 char minix */ + MINIX_SUPER_MAGIC 0x137f /* orig. minix */ + MINIX_SUPER_MAGIC2 0x138f /* 30 char minix */ MINIX2_SUPER_MAGIC 0x2468 /* minix V2 */ MINIX2_SUPER_MAGIC2 0x2478 /* minix V2, 30 char names */ MINIX3_SUPER_MAGIC 0x4d5a /* minix V3 fs, 60 char names */ @@ -113,7 +113,7 @@ OPENPROM_SUPER_MAGIC 0x9fa1 PIPEFS_MAGIC 0x50495045 PROC_SUPER_MAGIC 0x9fa0 - PSTOREFS_MAGIC 0x6165676C + PSTOREFS_MAGIC 0x6165676c QNX4_SUPER_MAGIC 0x002f QNX6_SUPER_MAGIC 0x68191122 RAMFS_MAGIC 0x858458f6 @@ -121,22 +121,22 @@ ROMFS_MAGIC 0x7275 SELINUX_MAGIC 0xf97cff8c SMACK_MAGIC 0x43415d53 - SMB_SUPER_MAGIC 0x517B - SOCKFS_MAGIC 0x534F434B + SMB_SUPER_MAGIC 0x517b + SOCKFS_MAGIC 0x534f434b SQUASHFS_MAGIC 0x73717368 SYSFS_MAGIC 0x62656572 - SYSV2_SUPER_MAGIC 0x012FF7B6 - SYSV4_SUPER_MAGIC 0x012FF7B5 + SYSV2_SUPER_MAGIC 0x012ff7b6 + SYSV4_SUPER_MAGIC 0x012ff7b5 TMPFS_MAGIC 0x01021994 UDF_SUPER_MAGIC 0x15013346 UFS_MAGIC 0x00011954 USBDEVICE_SUPER_MAGIC 0x9fa2 V9FS_MAGIC 0x01021997 - VXFS_SUPER_MAGIC 0xa501FCF5 + VXFS_SUPER_MAGIC 0xa501fcf5 XENFS_SUPER_MAGIC 0xabba1974 - XENIX_SUPER_MAGIC 0x012FF7B4 + XENIX_SUPER_MAGIC 0x012ff7b4 XFS_SUPER_MAGIC 0x58465342 - _XIAFS_SUPER_MAGIC 0x012FD16D + _XIAFS_SUPER_MAGIC 0x012fd16d .fi .in .PP @@ -221,7 +221,8 @@ points to an invalid address. .TP .B EINTR -This call was interrupted by a signal. +This call was interrupted by a signal; see +.BR signal (7). .TP .B EIO An I/O error occurred while reading from the filesystem. @@ -369,11 +370,11 @@ .BR statvfs (2), .BR path_resolution (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/stime.2 manpages-4.05/man2/stime.2 --- manpages-4.04/man2/stime.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/stime.2 2016-03-15 03:47:39.000000000 +0000 @@ -27,7 +27,7 @@ .\" Modified 2001-03-16 by Andries Brouwer .\" Modified 2004-05-27 by Michael Kerrisk .\" -.TH STIME 2 2014-05-10 "Linux" "Linux Programmer's Manual" +.TH STIME 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME stime \- set time .SH SYNOPSIS @@ -41,7 +41,10 @@ .in .sp .BR stime (): -_SVID_SOURCE + Since glibc 2.19: + _DEFAULT_SOURCE + Glibc 2.19 and earlier: + _SVID_SOURCE .SH DESCRIPTION .BR stime () sets the system's idea of the time and date. @@ -72,11 +75,11 @@ .BR settimeofday (2), .BR capabilities (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/subpage_prot.2 manpages-4.05/man2/subpage_prot.2 --- manpages-4.04/man2/subpage_prot.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/subpage_prot.2 2016-03-15 03:47:39.000000000 +0000 @@ -132,11 +132,11 @@ .IR Documentation/vm/hugetlbpage.txt in the Linux kernel source tree .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/swapon.2 manpages-4.05/man2/swapon.2 --- manpages-4.04/man2/swapon.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/swapon.2 2016-03-15 03:47:39.000000000 +0000 @@ -204,11 +204,11 @@ .BR swapoff (8), .BR swapon (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/symlink.2 manpages-4.05/man2/symlink.2 --- manpages-4.04/man2/symlink.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/symlink.2 2016-03-15 03:47:39.000000000 +0000 @@ -30,7 +30,7 @@ .\" Modified 1997-01-31 by Eric S. Raymond .\" Modified 2004-06-23 by Michael Kerrisk .\" -.TH SYMLINK 2 2015-04-19 "Linux" "Linux Programmer's Manual" +.TH SYMLINK 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME symlink, symlinkat \- make a new name for a file .SH SYNOPSIS @@ -54,8 +54,9 @@ .ad l .BR symlink (): .RS 4 -_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 || -_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED || _POSIX_C_SOURCE\ >=\ 200112L +_XOPEN_SOURCE\ >=\ 500 || _POSIX_C_SOURCE\ >=\ 200112L +.\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED + || /* Glibc versions <= 2.19: */ _BSD_SOURCE .RE .sp .BR symlinkat (): @@ -64,7 +65,7 @@ .RS 4 .TP 4 Since glibc 2.10: -_XOPEN_SOURCE\ >=\ 700 || _POSIX_C_SOURCE\ >=\ 200809L +_POSIX_C_SOURCE\ >=\ 200809L .TP Before glibc 2.10: _ATFILE_SOURCE @@ -271,11 +272,11 @@ .BR path_resolution (7), .BR symlink (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/sync.2 manpages-4.05/man2/sync.2 --- manpages-4.04/man2/sync.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/sync.2 2016-03-15 03:47:39.000000000 +0000 @@ -33,9 +33,9 @@ .\" Modified 2001-10-10 by aeb, following Michael Kerrisk. .\" 2011-09-07, mtk, Added syncfs() documentation, .\" -.TH SYNC 2 2015-08-08 "Linux" "Linux Programmer's Manual" +.TH SYNC 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME -sync, syncfs \- commit buffer cache to disk +sync, syncfs \- commit filesystem caches to disk .SH SYNOPSIS .B #include .sp @@ -51,8 +51,10 @@ .BR sync (): .ad l .RS 4 -_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 || -_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED +_XOPEN_SOURCE\ >=\ 500 +.\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE .RE .ad .sp @@ -64,8 +66,8 @@ .ad .SH DESCRIPTION .BR sync () -causes all buffered modifications to file metadata and data to be -written to the underlying filesystems. +causes all pending modifications to file system metadata and cached file +data to be written to the underlying filesystems. .BR syncfs () is like @@ -108,25 +110,30 @@ it was "int sync(void)", and .BR sync () always returned 0. -.SH BUGS + According to the standard specification (e.g., POSIX.1-2001), .BR sync () schedules the writes, but may return before the actual -writing is done. -However, since version 1.3.20 Linux does actually wait. -(This still does not guarantee data integrity: modern disks have -large caches.) +writing is done. However Linux waits for I/O completions, +and thus +.BR sync () +or +.BR syncfs () +provide the same guarantees as fsync called on every file in +the system or filesystem respectively. +.SH BUGS +Before version 1.3.20 Linux did not wait for I/O to complete +before returning. .SH SEE ALSO -.BR bdflush (2), +.BR sync (1), .BR fdatasync (2), -.BR fsync (2), -.BR sync (1) +.BR fsync (2) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/sync_file_range.2 manpages-4.05/man2/sync_file_range.2 --- manpages-4.04/man2/sync_file_range.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/sync_file_range.2 2016-03-15 03:47:39.000000000 +0000 @@ -225,11 +225,11 @@ .BR msync (2), .BR sync (2) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/_syscall.2 manpages-4.05/man2/_syscall.2 --- manpages-4.04/man2/_syscall.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/_syscall.2 2016-03-15 03:47:39.000000000 +0000 @@ -186,11 +186,11 @@ .BR syscall (2), .BR errno (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/syscall.2 manpages-4.05/man2/syscall.2 --- manpages-4.04/man2/syscall.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/syscall.2 2016-03-15 03:47:39.000000000 +0000 @@ -39,7 +39,7 @@ .\" 2015-01-17, Kees Cook .\" Added mips and arm64. .\" -.TH SYSCALL 2 2015-03-29 "Linux" "Linux Programmer's Manual" +.TH SYSCALL 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME syscall \- indirect system call .SH SYNOPSIS @@ -145,52 +145,87 @@ kernel. The details for various architectures are listed in the two tables below. -The first table lists the instruction used to transition to kernel mode, +The first table lists the instruction used to transition to kernel mode (which might not be the fastest or best way to transition to the kernel, so you might have to refer to .BR vdso (7)), the register used to indicate the system call number, -and the register used to return the system call result. +the register used to return the system call result, +and the register used to signal an error. .if t \{\ .ft CW \} .TS -l l1 l l1 l. -arch/ABI instruction syscall # retval Notes +l2 l2 l2 l2 l2 l. +arch/ABI instruction syscall # retval error Notes _ -arm/OABI swi NR - a1 NR is syscall # -arm/EABI swi 0x0 r7 r0 -arm64 svc #0 x8 x0 -blackfin excpt 0x0 P0 R0 -i386 int $0x80 eax eax -ia64 break 0x100000 r15 r8 See below -mips syscall v0 v0 See below -parisc ble 0x100(%sr2, %r0) r20 r28 -s390 svc 0 r1 r2 See below -s390x svc 0 r1 r2 See below -sparc/32 t 0x10 g1 o0 -sparc/64 t 0x6d g1 o0 -x86_64 syscall rax rax See below -x32 syscall rax rax See below +alpha callsys v0 a0 a3 [1] +arc trap0 r8 r0 - +arm/OABI swi NR - a1 - [2] +arm/EABI swi 0x0 r7 r0 - +arm64 svc #0 x8 x0 - +blackfin excpt 0x0 P0 R0 - +i386 int $0x80 eax eax - +ia64 break 0x100000 r15 r8 r10 [1] +m68k trap #0 d0 d0 - +microblaze brki r14,8 r12 r3 - +mips syscall v0 v0 a3 [1] +nios2 trap r2 r2 r7 +parisc ble 0x100(%sr2, %r0) r20 r28 - +powerpc sc r0 r3 r0 [1] +s390 svc 0 r1 r2 - [3] +s390x svc 0 r1 r2 - [3] +superh trap #0x17 r3 r0 - [4] +sparc/32 t 0x10 g1 o0 psr/csr [1] +sparc/64 t 0x6d g1 o0 psr/csr [1] +tile swint1 R10 R00 R01 [1] +x86_64 syscall rax rax - [5] +x32 syscall rax rax - [5] +xtensa syscall a2 a2 - .TE .PP -For s390 and s390x, NR (the system call number) -may be passed directly with "svc NR" if it is less than 256. - +Notes: +.RS 4 +.IP [1] 4 +On a few architectures, +a register is used as a boolean +(0 indicating no error, and \-1 indicating an error) to signal that the +system call failed. +The actual error value is still contained in the return register. +On sparc, the carry bit +.RI ( csr ) +in the processor status register +.RI ( psr ) +is used instead of a full register. +.IP [2] +.I NR +is the system call number. +.IP [3] +For s390 and s390x, +.I NR +(the system call number) may be passed directly with +.I "svc\ NR" +if it is less than 256. +.IP [4] +On SuperH, the trap number controls the maximum number of arguments passed. +A +.IR "trap\ #0x10" +can be used with only 0-argument system calls, a +.IR "trap\ #0x11" +can be used with 0- or 1-argument system calls, +and so on up to +.IR "trap #0x17" +for 7-argument system calls. +.IP [5] The x32 ABI uses the same instruction as the x86_64 ABI and is used on the same processors. To differentiate between them, the bit mask .I __X32_SYSCALL_BIT is bitwise-ORed into the system call number for system calls under the x32 ABI. - -On a few architectures, -a register is used to indicate simple boolean failure of the system call: -ia64 uses -.I r10 -for this purpose, -and mips uses -.IR a3 . +Both system call tables are available though, +so setting the bit is not a hard requirement. +.RE .if t \{\ .in .ft P @@ -204,25 +239,38 @@ l l2 l2 l2 l2 l2 l2 l2 l. arch/ABI arg1 arg2 arg3 arg4 arg5 arg6 arg7 Notes _ +alpha a0 a1 a2 a3 a4 a5 - +arc r0 r1 r2 r3 r4 r5 - arm/OABI a1 a2 a3 a4 v1 v2 v3 arm/EABI r0 r1 r2 r3 r4 r5 r6 arm64 x0 x1 x2 x3 x4 x5 - blackfin R0 R1 R2 R3 R4 R5 - i386 ebx ecx edx esi edi ebp - ia64 out0 out1 out2 out3 out4 out5 - -mips/o32 a0 a1 a2 a3 - - - See below +m68k d1 d2 d3 d4 d5 a0 - +microblaze r5 r6 r7 r8 r9 r10 - +mips/o32 a0 a1 a2 a3 - - - [1] mips/n32,64 a0 a1 a2 a3 a4 a5 - +nios2 r4 r5 r6 r7 r8 r9 - parisc r26 r25 r24 r23 r22 r21 - +powerpc r3 r4 r5 r6 r7 r8 r9 s390 r2 r3 r4 r5 r6 r7 - s390x r2 r3 r4 r5 r6 r7 - +superh r4 r5 r6 r7 r0 r1 r2 sparc/32 o0 o1 o2 o3 o4 o5 - sparc/64 o0 o1 o2 o3 o4 o5 - +tile R00 R01 R02 R03 R04 R05 - x86_64 rdi rsi rdx r10 r8 r9 - x32 rdi rsi rdx r10 r8 r9 - +xtensa a6 a3 a4 a5 a8 a9 - .TE .PP +Notes: +.RS 4 +.IP [1] 4 The mips/o32 system call convention passes arguments 5 through 8 on the user stack. +.RE .if t \{\ .in .ft P @@ -254,11 +302,11 @@ .BR errno (3), .BR vdso (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/syscalls.2 manpages-4.05/man2/syscalls.2 --- manpages-4.04/man2/syscalls.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/syscalls.2 2016-03-15 03:47:39.000000000 +0000 @@ -28,7 +28,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH SYSCALLS 2 2015-12-05 "Linux" "Linux Programmer's Manual" +.TH SYSCALLS 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME syscalls \- Linux system calls .SH SYNOPSIS @@ -144,7 +144,7 @@ When this is so, the version where the system call appeared in both of the major kernel series is listed. .PP -The list of system calls that are available as at kernel 4.4 +The list of system calls that are available as at kernel 4.5 (or in a few cases only on older kernels) is as follows: .\" .\" Looking at scripts/checksyscalls.sh in the kernel source is @@ -196,6 +196,7 @@ \fBclone\fP(2) 1.0 \fBclose\fP(2) 1.0 \fBconnect\fP(2) 2.0 See notes on \fBsocketcall\fP(2) +\fBcopy_file_range\fP(2) 4.5 \fBcreat\fP(2) 1.0 \fBcreate_module\fP(2) 1.0 Removed in 2.6 \fBdelete_module\fP(2) 1.0 @@ -853,11 +854,11 @@ .BR libc (7), .BR vdso (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/sysctl.2 manpages-4.05/man2/sysctl.2 --- manpages-4.04/man2/sysctl.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/sysctl.2 2016-03-15 03:47:39.000000000 +0000 @@ -181,11 +181,11 @@ .SH SEE ALSO .BR proc (5) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/sysfs.2 manpages-4.05/man2/sysfs.2 --- manpages-4.04/man2/sysfs.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/sysfs.2 2016-03-15 03:47:39.000000000 +0000 @@ -102,11 +102,11 @@ There is no libc or glibc support. There is no way to guess how large \fIbuf\fP should be. .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/sysinfo.2 manpages-4.05/man2/sysinfo.2 --- manpages-4.04/man2/sysinfo.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/sysinfo.2 2016-03-15 03:47:39.000000000 +0000 @@ -90,11 +90,11 @@ .SH SEE ALSO .BR proc (5) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/syslog.2 manpages-4.05/man2/syslog.2 --- manpages-4.04/man2/syslog.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/syslog.2 2016-03-15 03:47:39.000000000 +0000 @@ -298,7 +298,6 @@ it defaults to .IR default_message_loglevel . The conventional meaning of the log level is as follows: - .TS lB lB lB lB c l. @@ -390,11 +389,11 @@ .BR syslog (3), .BR capabilities (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/tee.2 manpages-4.05/man2/tee.2 --- manpages-4.04/man2/tee.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/tee.2 2016-03-15 03:47:39.000000000 +0000 @@ -213,11 +213,11 @@ .BR splice (2), .BR vmsplice (2) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/time.2 manpages-4.05/man2/time.2 --- manpages-4.04/man2/time.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/time.2 2016-03-15 03:47:39.000000000 +0000 @@ -125,11 +125,11 @@ .BR time (7), .BR vdso (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/timer_create.2 manpages-4.05/man2/timer_create.2 --- manpages-4.04/man2/timer_create.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/timer_create.2 2016-03-15 03:47:39.000000000 +0000 @@ -443,11 +443,11 @@ .BR signal (7), .BR time (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/timer_delete.2 manpages-4.05/man2/timer_delete.2 --- manpages-4.04/man2/timer_delete.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/timer_delete.2 2016-03-15 03:47:39.000000000 +0000 @@ -73,11 +73,11 @@ .BR timer_settime (2), .BR time (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/timerfd_create.2 manpages-4.05/man2/timerfd_create.2 --- manpages-4.04/man2/timerfd_create.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/timerfd_create.2 2016-03-15 03:47:39.000000000 +0000 @@ -576,11 +576,11 @@ .BR epoll (7), .BR time (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/timer_getoverrun.2 manpages-4.05/man2/timer_getoverrun.2 --- manpages-4.04/man2/timer_getoverrun.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/timer_getoverrun.2 2016-03-15 03:47:39.000000000 +0000 @@ -139,11 +139,11 @@ .BR signal (7), .BR time (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/timer_settime.2 manpages-4.05/man2/timer_settime.2 --- manpages-4.04/man2/timer_settime.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/timer_settime.2 2016-03-15 03:47:39.000000000 +0000 @@ -214,11 +214,11 @@ .BR timer_getoverrun (2), .BR time (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/times.2 manpages-4.05/man2/times.2 --- manpages-4.04/man2/times.2 2015-12-29 12:51:44.000000000 +0000 +++ manpages-4.05/man2/times.2 2016-03-15 03:47:39.000000000 +0000 @@ -35,7 +35,7 @@ .\" Added notes on nonstandard behavior: Linux allows 'buf' to .\" be NULL, but POSIX.1 doesn't specify this and it's nonportable. .\" -.TH TIMES 2 2015-08-08 "Linux" "Linux Programmer's Manual" +.TH TIMES 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME times \- get process times .SH SYNOPSIS @@ -168,7 +168,7 @@ is measured has varied across kernel versions. On Linux 2.4 and earlier this point is the moment the system was booted. Since Linux 2.6, this point is \fI(2^32/HZ) \- 300\fP -(i.e., about 429 million) seconds before system boot time. +seconds before system boot time. This variability across kernel versions (and across UNIX implementations), combined with the fact that the returned value may overflow the range of .IR clock_t , @@ -213,11 +213,11 @@ .BR sysconf (3), .BR time (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/tkill.2 manpages-4.05/man2/tkill.2 --- manpages-4.04/man2/tkill.2 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man2/tkill.2 2016-03-15 03:47:39.000000000 +0000 @@ -127,11 +127,11 @@ .BR kill (2), .BR rt_sigqueueinfo (2) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/truncate.2 manpages-4.05/man2/truncate.2 --- manpages-4.04/man2/truncate.2 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man2/truncate.2 2016-03-15 03:47:39.000000000 +0000 @@ -40,7 +40,7 @@ .\" Modified 2002-04-06 by Andries Brouwer .\" Modified 2004-06-23 by Michael Kerrisk .\" -.TH TRUNCATE 2 2015-08-08 "Linux" "Linux Programmer's Manual" +.TH TRUNCATE 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME truncate, ftruncate \- truncate a file to a specified length .SH SYNOPSIS @@ -61,18 +61,19 @@ .sp .BR truncate (): .RS 4 -_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 || -_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED +_XOPEN_SOURCE\ >=\ 500 +.\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED .br -|| /* Since glibc 2.12: */ _POSIX_C_SOURCE\ >=\ 200809L + || /* Since glibc 2.12: */ _POSIX_C_SOURCE\ >=\ 200809L + || /* Glibc versions <= 2.19: */ _BSD_SOURCE .RE .sp .BR ftruncate (): .RS 4 -_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 || -_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED -.br -|| /* Since glibc 2.3.5: */ _POSIX_C_SOURCE\ >=\ 200112L +_XOPEN_SOURCE\ >=\ 500 +.\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED + || /* Since glibc 2.3.5: */ _POSIX_C_SOURCE\ >=\ 200112L + || /* Glibc versions <= 2.19: */ _BSD_SOURCE .RE .PD .ad b @@ -177,7 +178,7 @@ The named file resides on a read-only filesystem. .TP .B ETXTBSY -The file is a pure procedure (shared text) file that is being executed. +The file is an executable file that is being executed. .PP For .BR ftruncate () @@ -188,7 +189,7 @@ .TP .B EBADF .I fd -is not a valid descriptor. +is not a valid file descriptor. .TP .BR EBADF " or " EINVAL .I fd @@ -269,15 +270,16 @@ was 200809L instead of 200112L. This has been fixed in later glibc versions. .SH SEE ALSO +.BR truncate (1), .BR open (2), .BR stat (2), .BR path_resolution (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/umask.2 manpages-4.05/man2/umask.2 --- manpages-4.04/man2/umask.2 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man2/umask.2 2016-03-15 03:47:39.000000000 +0000 @@ -138,11 +138,11 @@ .BR stat (2), .BR acl (5) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/umount.2 manpages-4.05/man2/umount.2 --- manpages-4.04/man2/umount.2 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man2/umount.2 2016-03-15 03:47:39.000000000 +0000 @@ -213,11 +213,11 @@ .BR mount (8), .BR umount (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/uname.2 manpages-4.05/man2/uname.2 --- manpages-4.04/man2/uname.2 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man2/uname.2 2016-03-15 03:47:39.000000000 +0000 @@ -170,11 +170,11 @@ .BR gethostname (2), .BR namespaces (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/unimplemented.2 manpages-4.05/man2/unimplemented.2 --- manpages-4.04/man2/unimplemented.2 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man2/unimplemented.2 2016-03-15 03:47:39.000000000 +0000 @@ -64,11 +64,11 @@ .SH SEE ALSO .BR syscalls (2) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/unlink.2 manpages-4.05/man2/unlink.2 --- manpages-4.04/man2/unlink.2 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man2/unlink.2 2016-03-15 03:47:39.000000000 +0000 @@ -30,7 +30,7 @@ .\" Modified 2001-05-17 by aeb .\" Modified 2004-06-23 by Michael Kerrisk .\" -.TH UNLINK 2 2014-08-19 "Linux" "Linux Programmer's Manual" +.TH UNLINK 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME unlink, unlinkat \- delete a name and possibly the file it refers to .SH SYNOPSIS @@ -56,7 +56,7 @@ .RS 4 .TP 4 Since glibc 2.10: -_XOPEN_SOURCE\ >=\ 700 || _POSIX_C_SOURCE\ >=\ 200809L +_POSIX_C_SOURCE\ >=\ 200809L .TP Before glibc 2.10: _ATFILE_SOURCE @@ -129,7 +129,7 @@ is a bit mask that can either be specified as 0, or by ORing together flag values that control the operation of .BR unlinkat (). -Currently only one such flag is defined: +Currently, only one such flag is defined: .TP .B AT_REMOVEDIR By default, @@ -310,11 +310,11 @@ .BR path_resolution (7), .BR symlink (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/unshare.2 manpages-4.05/man2/unshare.2 --- manpages-4.04/man2/unshare.2 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man2/unshare.2 2016-03-15 03:47:39.000000000 +0000 @@ -17,36 +17,16 @@ .\" by clone, which would require porting and maintaining all commands .\" such as login, and su, that establish a user session. .\" -.TH UNSHARE 2 2015-04-19 "Linux" "Linux Programmer's Manual" +.TH UNSHARE 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME unshare \- disassociate parts of the process execution context .SH SYNOPSIS .nf +.B #define _GNU_SOURCE .B #include .sp .BI "int unshare(int " flags ); .fi -.sp -.in -4n -Feature Test Macro Requirements for glibc (see -.BR feature_test_macros (7)): -.in -.sp -.BR unshare (): -.ad l -.RS 4 -.PD 0 -.TP 4 -Since glibc 2.14: -_GNU_SOURCE -.TP 4 -.\" See http://sources.redhat.com/bugzilla/show_bug.cgi?id=4749 -Before glibc 2.14: -_BSD_SOURCE || _SVID_SOURCE - /* _GNU_SOURCE also suffices */ -.PD -.RE -.ad b .SH DESCRIPTION .BR unshare () allows a process (or thread) to disassociate parts of its execution @@ -468,11 +448,11 @@ .I Documentation/unshare.txt in the Linux kernel source tree .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/uselib.2 manpages-4.05/man2/uselib.2 --- manpages-4.04/man2/uselib.2 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man2/uselib.2 2016-03-15 03:47:39.000000000 +0000 @@ -28,13 +28,16 @@ .\" Modified 2004-06-23 by Michael Kerrisk .\" Modified 2005-01-09 by aeb .\" -.TH USELIB 2 2015-12-28 "Linux" "Linux Programmer's Manual" +.TH USELIB 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME uselib \- load shared library .SH SYNOPSIS .B #include .sp .BI "int uselib(const char *" library ); + +.IR Note : +No declaration of this system call is provided in glibc headers; see NOTES. .SH DESCRIPTION The system call .BR uselib () @@ -78,8 +81,17 @@ is Linux-specific, and should not be used in programs intended to be portable. .SH NOTES +This obsolete system call is not supported by glibc. +No declaration is provided in glibc headers, but, through a quirk of history, +glibc versions before 2.23 did export an ABI for this system call. +Therefore, in order to employ this system call, +it was sufficient to manually declare the interface in your code; +alternatively, you could invoke the system call using +.BR syscall (2). + +In ancient libc versions, .BR uselib () -was used by early libc startup code to load +was used to load the shared libraries with names found in an array of names in the binary. .LP @@ -99,6 +111,12 @@ This is also the state of affairs in libc5. .LP glibc2 does not use this call. + +Since Linux 3.15, +.\" commit 69369a7003735d0d8ef22097e27a55a8bad9557a +this system call is available only when the kernel is configured with the +.B CONFIG_USELIB +option. .SH SEE ALSO .BR ar (1), .BR gcc (1), @@ -110,11 +128,11 @@ .BR capabilities (7), .BR ld.so (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/ustat.2 manpages-4.05/man2/ustat.2 --- manpages-4.04/man2/ustat.2 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man2/ustat.2 2016-03-15 03:47:39.000000000 +0000 @@ -119,11 +119,11 @@ .BR stat (2), .BR statfs (2) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/utime.2 manpages-4.05/man2/utime.2 --- manpages-4.04/man2/utime.2 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man2/utime.2 2016-03-15 03:47:39.000000000 +0000 @@ -190,11 +190,11 @@ .BR futimens (3), .BR futimes (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/utimensat.2 manpages-4.05/man2/utimensat.2 --- manpages-4.04/man2/utimensat.2 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man2/utimensat.2 2016-03-15 03:47:39.000000000 +0000 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH UTIMENSAT 2 2015-07-23 "Linux" "Linux Programmer's Manual" +.TH UTIMENSAT 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME utimensat, futimens \- change file timestamps with nanosecond precision .SH SYNOPSIS @@ -48,7 +48,7 @@ .RS 4 .TP 4 Since glibc 2.10: -_XOPEN_SOURCE\ >=\ 700 || _POSIX_C_SOURCE\ >=\ 200809L +_POSIX_C_SOURCE\ >=\ 200809L .TP Before glibc 2.10: _ATFILE_SOURCE @@ -58,7 +58,7 @@ .RS 4 .TP Since glibc 2.10: -_XOPEN_SOURCE\ >=\ 700 || _POSIX_C_SOURCE\ >=\ 200809L +_POSIX_C_SOURCE\ >=\ 200809L .TP Before glibc 2.10: _GNU_SOURCE @@ -240,10 +240,9 @@ .I tv_nsec values are .BR UTIME_NOW , -and: -.PD 0 +and either: .RS -.IP * 2 +.IP * 3 the effective user ID of the caller does not match the owner of the file, the caller does not have write access to the file, @@ -279,7 +278,6 @@ .BR chattr (1)). .\" EXT2_IMMUTABLE_FL and similar flags for other filesystems. .RE -.PD .TP .B EBADF .RB ( futimens ()) @@ -378,10 +376,9 @@ .I tv_nsec field is .BR UTIME_OMIT ) -and: -.PD 0 +and either: .RS -.IP * 2 +.IP * 3 the caller's effective user ID does not match the owner of file, and the caller is not privileged (Linux: does not have the @@ -401,7 +398,6 @@ .\" EACCES and EPERM, where only EPERM tests for append-only. .\" (This was also so for the older utimes() implementation.) .RE -.PD .TP .B EROFS The file is on a read-only filesystem. @@ -491,7 +487,7 @@ on kernels before 2.6.26. These bugs are either nonconformances with the POSIX.1 draft specification or inconsistencies with historical Linux behavior. -.IP * 2 +.IP * 3 POSIX.1 specifies that if one of the .I tv_nsec fields has the value @@ -639,11 +635,11 @@ .BR path_resolution (7), .BR symlink (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/vfork.2 manpages-4.05/man2/vfork.2 --- manpages-4.04/man2/vfork.2 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man2/vfork.2 2016-03-15 03:47:39.000000000 +0000 @@ -25,7 +25,7 @@ .\" 1999-11-10: Merged text taken from the page contributed by .\" Reed H. Petty (rhp@draper.net) .\" -.TH VFORK 2 2012-08-05 "Linux" "Linux Programmer's Manual" +.TH VFORK 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME vfork \- create a child process and block parent .SH SYNOPSIS @@ -47,15 +47,14 @@ .TP 4 Since glibc 2.12: .nf -_BSD_SOURCE || - (_XOPEN_SOURCE\ >=\ 500 || - _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED) && - !(_POSIX_C_SOURCE\ >=\ 200809L || _XOPEN_SOURCE\ >=\ 700) +(_XOPEN_SOURCE\ >=\ 500) && ! (_POSIX_C_SOURCE\ >=\ 200809L) + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE .TP 4 .fi Before glibc 2.12: -_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 || -_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED +_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 +.\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED .PD .RE .ad b @@ -277,11 +276,11 @@ .BR unshare (2), .BR wait (2) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/vhangup.2 manpages-4.05/man2/vhangup.2 --- manpages-4.04/man2/vhangup.2 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man2/vhangup.2 2016-03-15 03:47:39.000000000 +0000 @@ -25,7 +25,7 @@ .\" Modified, 27 May 2004, Michael Kerrisk .\" Added notes on capability requirements .\" -.TH VHANGUP 2 2007-07-26 "Linux" "Linux Programmer's Manual" +.TH VHANGUP 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME vhangup \- virtually hangup the current terminal .SH SYNOPSIS @@ -40,7 +40,15 @@ .sp .ad l .BR vhangup (): -_BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE\ <\ 500) +.nf + Since glibc 2.21: +.\" commit 266865c0e7b79d4196e2cc393693463f03c90bd8 + _DEFAULT_SOURCE + In glibc 2.19 and 2.20: + _DEFAULT_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE\ <\ 500) + Up to and including glibc 2.19: + _BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE\ <\ 500) +.fi .ad b .SH DESCRIPTION .BR vhangup () @@ -67,11 +75,11 @@ .BR capabilities (7), .BR init (1) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/vm86.2 manpages-4.05/man2/vm86.2 --- manpages-4.04/man2/vm86.2 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man2/vm86.2 2016-03-15 03:47:39.000000000 +0000 @@ -74,11 +74,11 @@ This call is specific to Linux on 32-bit Intel processors, and should not be used in programs intended to be portable. .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/vmsplice.2 manpages-4.05/man2/vmsplice.2 --- manpages-4.04/man2/vmsplice.2 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man2/vmsplice.2 2016-03-15 03:47:39.000000000 +0000 @@ -167,11 +167,11 @@ .BR splice (2), .BR tee (2) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/wait.2 manpages-4.05/man2/wait.2 --- manpages-4.04/man2/wait.2 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man2/wait.2 2016-03-15 03:47:39.000000000 +0000 @@ -46,7 +46,7 @@ .\" 2005-05-10, mtk, __W* flags can't be used with waitid() .\" 2008-07-04, mtk, removed erroneous text about SA_NOCLDSTOP .\" -.TH WAIT 2 2015-07-23 "Linux" "Linux Programmer's Manual" +.TH WAIT 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME wait, waitpid, waitid \- wait for process to change state .SH SYNOPSIS @@ -54,9 +54,9 @@ .br .B #include .sp -.BI "pid_t wait(int *" "status" ); +.BI "pid_t wait(int *" "wstatus" ); -.BI "pid_t waitpid(pid_t " pid ", int *" status ", int " options ); +.BI "pid_t waitpid(pid_t " pid ", int *" wstatus ", int " options ); .BI "int waitid(idtype_t " idtype ", id_t " id \ ", siginfo_t *" infop ", int " options ); @@ -72,11 +72,9 @@ .PD 0 .BR waitid (): .RS 4 -_SVID_SOURCE || -_XOPEN_SOURCE\ >=\ 500 || -_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED -.br -|| /* Since glibc 2.12: */ _POSIX_C_SOURCE\ >=\ 200809L +_XOPEN_SOURCE + || /* Since glibc 2.12: */ _POSIX_C_SOURCE\ >=\ 200809L + || /* Glibc versions <= 2.19: */ _BSD_SOURCE .RE .PD .ad @@ -108,11 +106,11 @@ system call suspends execution of the calling process until one of its children terminates. The call -.I wait(&status) +.I wait(&wstatus) is equivalent to: .nf - waitpid(\-1, &status, 0); + waitpid(\-1, &wstatus, 0); .fi The @@ -168,7 +166,7 @@ (For Linux-only options, see below.) .PP If -.I status +.I wstatus is not NULL, .BR wait () and @@ -181,7 +179,7 @@ and .BR waitpid ()!): .TP -.BI WIFEXITED( status ) +.BI WIFEXITED( wstatus ) returns true if the child terminated normally, that is, by calling .BR exit (3) @@ -189,10 +187,10 @@ .BR _exit (2), or by returning from main(). .TP -.BI WEXITSTATUS( status ) +.BI WEXITSTATUS( wstatus ) returns the exit status of the child. This consists of the least significant 8 bits of the -.I status +.I wstatus argument that the child specified in a call to .BR exit (3) or @@ -202,17 +200,17 @@ .B WIFEXITED returned true. .TP -.BI WIFSIGNALED( status ) +.BI WIFSIGNALED( wstatus ) returns true if the child process was terminated by a signal. .TP -.BI WTERMSIG( status ) +.BI WTERMSIG( wstatus ) returns the number of the signal that caused the child process to terminate. This macro should be employed only if .B WIFSIGNALED returned true. .TP -.BI WCOREDUMP( status ) +.BI WCOREDUMP( wstatus ) returns true if the child produced a core dump. This macro should be employed only if .B WIFSIGNALED @@ -221,20 +219,20 @@ some UNIX implementations (e.g., AIX, SunOS). Only use this enclosed in #ifdef WCOREDUMP ... #endif. .TP -.BI WIFSTOPPED( status ) +.BI WIFSTOPPED( wstatus ) returns true if the child process was stopped by delivery of a signal; this is possible only if the call was done using .B WUNTRACED or when the child is being traced (see .BR ptrace (2)). .TP -.BI WSTOPSIG( status ) +.BI WSTOPSIG( wstatus ) returns the number of the signal which caused the child to stop. This macro should be employed only if .B WIFSTOPPED returned true. .TP -.BI WIFCONTINUED( status ) +.BI WIFCONTINUED( wstatus ) (since Linux 2.6.10) returns true if the child process was resumed by delivery of .BR SIGCONT . @@ -607,7 +605,7 @@ main(int argc, char *argv[]) { pid_t cpid, w; - int status; + int wstatus; cpid = fork(); if (cpid == \-1) { @@ -623,22 +621,22 @@ } else { /* Code executed by parent */ do { - w = waitpid(cpid, &status, WUNTRACED | WCONTINUED); + w = waitpid(cpid, &wstatus, WUNTRACED | WCONTINUED); if (w == \-1) { perror("waitpid"); exit(EXIT_FAILURE); } - if (WIFEXITED(status)) { - printf("exited, status=%d\\n", WEXITSTATUS(status)); - } else if (WIFSIGNALED(status)) { - printf("killed by signal %d\\n", WTERMSIG(status)); - } else if (WIFSTOPPED(status)) { - printf("stopped by signal %d\\n", WSTOPSIG(status)); - } else if (WIFCONTINUED(status)) { + if (WIFEXITED(wstatus)) { + printf("exited, status=%d\\n", WEXITSTATUS(wstatus)); + } else if (WIFSIGNALED(wstatus)) { + printf("killed by signal %d\\n", WTERMSIG(wstatus)); + } else if (WIFSTOPPED(wstatus)) { + printf("stopped by signal %d\\n", WSTOPSIG(wstatus)); + } else if (WIFCONTINUED(wstatus)) { printf("continued\\n"); } - } while (!WIFEXITED(status) && !WIFSIGNALED(status)); + } while (!WIFEXITED(wstatus) && !WIFSIGNALED(wstatus)); exit(EXIT_SUCCESS); } } @@ -656,11 +654,11 @@ .BR credentials (7), .BR signal (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/wait4.2 manpages-4.05/man2/wait4.2 --- manpages-4.04/man2/wait4.2 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man2/wait4.2 2016-03-15 03:47:39.000000000 +0000 @@ -30,7 +30,7 @@ .\" Rewrote much of this page, and removed much duplicated text, .\" replacing with pointers to wait.2 .\" -.TH WAIT4 2 2015-07-23 "Linux" "Linux Programmer's Manual" +.TH WAIT4 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME wait3, wait4 \- wait for process to change state, BSD style .SH SYNOPSIS @@ -40,10 +40,10 @@ .B #include .B #include .sp -.BI "pid_t wait3(int *" "status" ", int " options , +.BI "pid_t wait3(int *" "wstatus" ", int " options , .BI " struct rusage *" rusage ); .sp -.BI "pid_t wait4(pid_t " pid ", int *" status ", int " options , +.BI "pid_t wait4(pid_t " pid ", int *" wstatus ", int " options , .BI " struct rusage *" rusage ); .fi .sp @@ -54,15 +54,17 @@ .sp .ad l .BR wait3 (): -.RS 4 -_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 || -_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED -.RE + Since glibc 2.19: + _DEFAULT_SOURCE || _XOPEN_SOURCE\ >=\ 500 + Glibc 2.19 and earlier: + _BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 +.\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED .br .BR wait4 (): -.RS 4 -_BSD_SOURCE -.RE + Since glibc 2.19: + _DEFAULT_SOURCE + Glibc 2.19 and earlier: + _BSD_SOURCE .ad .SH DESCRIPTION These functions are obsolete; use @@ -88,13 +90,13 @@ call: .nf - wait3(status, options, rusage); + wait3(wstatus, options, rusage); .fi is equivalent to: .nf - waitpid(\-1, status, options); + waitpid(\-1, wstatus, options); .fi Similarly, the following @@ -102,13 +104,13 @@ call: .nf - wait4(pid, status, options, rusage); + wait4(pid, wstatus, options, rusage); .fi is equivalent to: .nf - waitpid(pid, status, options); + waitpid(pid, wstatus, options); .fi In other words, @@ -170,11 +172,11 @@ .BR wait (2), .BR signal (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man2/write.2 manpages-4.05/man2/write.2 --- manpages-4.04/man2/write.2 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man2/write.2 2016-03-15 03:47:39.000000000 +0000 @@ -36,7 +36,7 @@ .\" gave some examples of why this might occur. .\" Noted what happens if write() is interrupted by a signal. .\" -.TH WRITE 2 2015-07-23 "Linux" "Linux Programmer's Manual" +.TH WRITE 2 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME write \- write to a file descriptor .SH SYNOPSIS @@ -69,7 +69,7 @@ For a seekable file (i.e., one to which .BR lseek (2) may be applied, for example, a regular file) -writing takes place at the current file offset, +writing takes place at the file offset, and the file offset is incremented by the number of bytes actually written. If the file was @@ -170,7 +170,7 @@ .IR buf , the value specified in .IR count , -or the current file offset is not suitably aligned. +or the file offset is not suitably aligned. .TP .B EIO A low-level I/O error occurred while modifying the inode. @@ -281,11 +281,11 @@ .BR writev (2), .BR fwrite (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/a64l.3 manpages-4.05/man3/a64l.3 --- manpages-4.04/man3/a64l.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/a64l.3 2016-03-15 03:47:39.000000000 +0000 @@ -7,7 +7,7 @@ .\" .\" Corrected, aeb, 2002-05-30 .\" -.TH A64L 3 2015-08-08 "" "Linux Programmer's Manual" +.TH A64L 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME a64l, l64a \- convert between long and base-64 .SH SYNOPSIS @@ -27,8 +27,10 @@ .br .RS 4 .ad l -_SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 || -_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED +_XOPEN_SOURCE\ >=\ 500 +.\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED + || /* Glibc since 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _SVID_SOURCE .RE .ad .SH DESCRIPTION @@ -102,11 +104,11 @@ .\" .BR itoa (3), .BR strtoul (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/abort.3 manpages-4.05/man3/abort.3 --- manpages-4.04/man3/abort.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/abort.3 2016-03-15 03:47:39.000000000 +0000 @@ -93,11 +93,11 @@ .BR longjmp (3), .BR raise (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/abs.3 manpages-4.05/man3/abs.3 --- manpages-4.04/man3/abs.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/abs.3 2016-03-15 03:47:39.000000000 +0000 @@ -31,7 +31,7 @@ .\" Modified Sat Jul 24 21:45:37 1993, Rik Faith (faith@cs.unc.edu) .\" Modified Sat Dec 16 15:02:59 2000, Joseph S. Myers .\" -.TH ABS 3 2015-08-08 "GNU" "Linux Programmer's Manual" +.TH ABS 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME abs, labs, llabs, imaxabs \- compute the absolute value of an integer .SH SYNOPSIS @@ -57,11 +57,7 @@ .ad l .BR llabs (): .RS 4 -_XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L .RE .ad .SH DESCRIPTION @@ -145,11 +141,11 @@ .BR floor (3), .BR rint (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/acos.3 manpages-4.05/man3/acos.3 --- manpages-4.04/man3/acos.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/acos.3 2016-03-15 03:47:39.000000000 +0000 @@ -32,7 +32,7 @@ .\" Modified 2002-07-25 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.TH ACOS 3 2015-04-19 "" "Linux Programmer's Manual" +.TH ACOS 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME acos, acosf, acosl \- arc cosine function .SH SYNOPSIS @@ -55,11 +55,9 @@ .BR acosf (), .BR acosl (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .ad b .SH DESCRIPTION @@ -138,11 +136,11 @@ .BR sin (3), .BR tan (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/acosh.3 manpages-4.05/man3/acosh.3 --- manpages-4.04/man3/acosh.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/acosh.3 2016-03-15 03:47:39.000000000 +0000 @@ -32,7 +32,7 @@ .\" Modified 2002-07-25 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.TH ACOSH 3 2015-04-19 "" "Linux Programmer's Manual" +.TH ACOSH 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME acosh, acoshf, acoshl \- inverse hyperbolic cosine function .SH SYNOPSIS @@ -56,22 +56,19 @@ .ad l .BR acosh (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 || -_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || _XOPEN_SOURCE\ >=\ 500 +.\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .br .BR acoshf (), .BR acoshl (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .ad b .SH DESCRIPTION @@ -144,11 +141,11 @@ .BR sinh (3), .BR tanh (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/addseverity.3 manpages-4.05/man3/addseverity.3 --- manpages-4.04/man3/addseverity.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/addseverity.3 2016-03-15 03:47:39.000000000 +0000 @@ -6,7 +6,7 @@ .\" adapted glibc info page .\" .\" polished a little, aeb -.TH ADDSEVERITY 3 2015-03-02 "GNU" "Linux Programmer's Manual" +.TH ADDSEVERITY 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME addseverity \- introduce new severity classes .SH SYNOPSIS @@ -23,7 +23,10 @@ .in .sp .BR addseverity (): -_SVID_SOURCE + Since glibc 2.19: + _DEFAULT_SOURCE + Glibc 2.19 and earlier: + _SVID_SOURCE .SH DESCRIPTION This function allows the introduction of new severity classes which can be addressed by the @@ -82,11 +85,11 @@ .SH SEE ALSO .BR fmtmsg (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/adjtime.3 manpages-4.05/man3/adjtime.3 --- manpages-4.04/man3/adjtime.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/adjtime.3 2016-03-15 03:47:39.000000000 +0000 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH ADJTIME 3 2015-03-02 "Linux" "Linux Programmer's Manual" +.TH ADJTIME 3 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME adjtime \- correct the time to synchronize the system clock .SH SYNOPSIS @@ -38,7 +38,10 @@ .in .sp .BR adjtime (): -_BSD_SOURCE + Since glibc 2.19: + _DEFAULT_SOURCE + Glibc 2.19 and earlier: + _BSD_SOURCE .SH DESCRIPTION The .BR adjtime () @@ -158,11 +161,11 @@ .BR gettimeofday (2), .BR time (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/aio_cancel.3 manpages-4.05/man3/aio_cancel.3 --- manpages-4.04/man3/aio_cancel.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/aio_cancel.3 2016-03-15 03:47:39.000000000 +0000 @@ -138,11 +138,11 @@ .BR lio_listio (3), .BR aio (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/aio_error.3 manpages-4.05/man3/aio_error.3 --- manpages-4.04/man3/aio_error.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/aio_error.3 2016-03-15 03:47:39.000000000 +0000 @@ -106,11 +106,11 @@ .BR lio_listio (3), .BR aio (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/aio_fsync.3 manpages-4.05/man3/aio_fsync.3 --- manpages-4.04/man3/aio_fsync.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/aio_fsync.3 2016-03-15 03:47:39.000000000 +0000 @@ -125,11 +125,11 @@ .BR aio (7), .BR sigevent (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/aio_init.3 manpages-4.05/man3/aio_init.3 --- manpages-4.04/man3/aio_init.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/aio_init.3 2016-03-15 03:47:39.000000000 +0000 @@ -99,11 +99,11 @@ .SH SEE ALSO .BR aio (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/aio_read.3 manpages-4.05/man3/aio_read.3 --- manpages-4.04/man3/aio_read.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/aio_read.3 2016-03-15 03:47:39.000000000 +0000 @@ -21,7 +21,7 @@ .\" . .\" %%%LICENSE_END .\" -.TH AIO_READ 3 2015-03-02 "" "Linux Programmer's Manual" +.TH AIO_READ 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME aio_read \- asynchronous read .SH SYNOPSIS @@ -54,11 +54,11 @@ .I aiocb structure.) .LP -The data is read starting at the absolute file offset +The data is read starting at the absolute position .IR aiocbp\->aio_offset , -regardless of the current file offset. +regardless of the file offset. After the call, -the value of the current file offset is unspecified. +the value of the file offset is unspecified. .LP The "asynchronous" means that this call returns as soon as the request has been enqueued; the read may or may not have completed @@ -168,11 +168,11 @@ .BR lio_listio (3), .BR aio (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/aio_return.3 manpages-4.05/man3/aio_return.3 --- manpages-4.04/man3/aio_return.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/aio_return.3 2016-03-15 03:47:39.000000000 +0000 @@ -102,11 +102,11 @@ .BR lio_listio (3), .BR aio (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/aio_suspend.3 manpages-4.05/man3/aio_suspend.3 --- manpages-4.04/man3/aio_suspend.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/aio_suspend.3 2016-03-15 03:47:39.000000000 +0000 @@ -149,11 +149,11 @@ .BR aio (7), .BR time (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/aio_write.3 manpages-4.05/man3/aio_write.3 --- manpages-4.04/man3/aio_write.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/aio_write.3 2016-03-15 03:47:39.000000000 +0000 @@ -21,7 +21,7 @@ .\" . .\" %%%LICENSE_END .\" -.TH AIO_WRITE 3 2015-03-02 "" "Linux Programmer's Manual" +.TH AIO_WRITE 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME aio_write \- asynchronous write .SH SYNOPSIS @@ -57,15 +57,15 @@ If .B O_APPEND is not set, the data is written starting at the -absolute file offset +absolute position .IR aiocbp\->aio_offset , -regardless of the current file offset. +regardless of the file offset. If .B O_APPEND is set, data is written at the end of the file in the same order as .BR aio_write () calls are made. -After the call, the value of the current file offset is unspecified. +After the call, the value of the file offset is unspecified. .LP The "asynchronous" means that this call returns as soon as the request has been enqueued; the write may or may not have completed @@ -170,11 +170,11 @@ .BR lio_listio (3), .BR aio (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/alloca.3 manpages-4.05/man3/alloca.3 --- manpages-4.04/man3/alloca.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/alloca.3 2016-03-15 03:47:39.000000000 +0000 @@ -167,11 +167,11 @@ .BR longjmp (3), .BR malloc (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/argz_add.3 manpages-4.05/man3/argz_add.3 --- manpages-4.04/man3/argz_add.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/argz_add.3 2016-03-15 03:47:39.000000000 +0000 @@ -233,11 +233,11 @@ .SH SEE ALSO .BR envz_add (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/asin.3 manpages-4.05/man3/asin.3 --- manpages-4.04/man3/asin.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/asin.3 2016-03-15 03:47:39.000000000 +0000 @@ -32,7 +32,7 @@ .\" Modified 2002-07-25 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.TH ASIN 3 2015-04-19 "" "Linux Programmer's Manual" +.TH ASIN 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME asin, asinf, asinl \- arc sine function .SH SYNOPSIS @@ -57,11 +57,9 @@ .BR asinf (), .BR asinl (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .ad b .SH DESCRIPTION @@ -136,11 +134,11 @@ .BR sin (3), .BR tan (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/asinh.3 manpages-4.05/man3/asinh.3 --- manpages-4.04/man3/asinh.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/asinh.3 2016-03-15 03:47:39.000000000 +0000 @@ -32,7 +32,7 @@ .\" Modified 2002-07-27 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.TH ASINH 3 2015-04-19 "GNU" "Linux Programmer's Manual" +.TH ASINH 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME asinh, asinhf, asinhl \- inverse hyperbolic sine function .SH SYNOPSIS @@ -56,22 +56,19 @@ .ad l .BR asinh (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 || -_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || _XOPEN_SOURCE\ >=\ 500 +.\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE -.br + .BR asinhf (), .BR asinhl (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .ad b .SH DESCRIPTION @@ -129,11 +126,11 @@ .BR sinh (3), .BR tanh (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/asprintf.3 manpages-4.05/man3/asprintf.3 --- manpages-4.04/man3/asprintf.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/asprintf.3 2016-03-15 03:47:39.000000000 +0000 @@ -83,11 +83,11 @@ .BR malloc (3), .BR printf (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/assert.3 manpages-4.05/man3/assert.3 --- manpages-4.04/man3/assert.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/assert.3 2016-03-15 03:47:39.000000000 +0000 @@ -91,11 +91,11 @@ .BR assert_perror (3), .BR exit (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/assert_perror.3 manpages-4.05/man3/assert_perror.3 --- manpages-4.04/man3/assert_perror.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/assert_perror.3 2016-03-15 03:47:39.000000000 +0000 @@ -87,11 +87,11 @@ .BR exit (3), .BR strerror (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/atan2.3 manpages-4.05/man3/atan2.3 --- manpages-4.04/man3/atan2.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/atan2.3 2016-03-15 03:47:39.000000000 +0000 @@ -32,7 +32,7 @@ .\" Modified 2002-07-27 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.TH ATAN2 3 2015-04-19 "" "Linux Programmer's Manual" +.TH ATAN2 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME atan2, atan2f, atan2l \- arc tangent function of two variables .SH SYNOPSIS @@ -55,11 +55,9 @@ .BR atan2f (), .BR atan2l (): .RS -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .ad b .SH DESCRIPTION @@ -191,11 +189,11 @@ .BR sin (3), .BR tan (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/atan.3 manpages-4.05/man3/atan.3 --- manpages-4.04/man3/atan.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/atan.3 2016-03-15 03:47:39.000000000 +0000 @@ -32,7 +32,7 @@ .\" Modified 2002-07-27 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.TH ATAN 3 2015-04-19 "" "Linux Programmer's Manual" +.TH ATAN 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME atan, atanf, atanl \- arc tangent function .SH SYNOPSIS @@ -57,11 +57,9 @@ .BR atanf (), .BR atanl (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .ad b .SH DESCRIPTION @@ -122,11 +120,11 @@ .BR sin (3), .BR tan (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/atanh.3 manpages-4.05/man3/atanh.3 --- manpages-4.04/man3/atanh.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/atanh.3 2016-03-15 03:47:39.000000000 +0000 @@ -32,7 +32,7 @@ .\" Modified 2002-07-27 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.TH ATANH 3 2015-04-19 "" "Linux Programmer's Manual" +.TH ATANH 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME atanh, atanhf, atanhl \- inverse hyperbolic tangent function .SH SYNOPSIS @@ -56,22 +56,19 @@ .ad l .BR atanh (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 || -_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || _XOPEN_SOURCE\ >=\ 500 +.\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE -.br + .BR atanhf (), .BR atanhl (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .ad b .SH DESCRIPTION @@ -174,11 +171,11 @@ .BR sinh (3), .BR tanh (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/atexit.3 manpages-4.05/man3/atexit.3 --- manpages-4.04/man3/atexit.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/atexit.3 2016-03-15 03:47:39.000000000 +0000 @@ -179,11 +179,11 @@ .BR exit (3), .BR on_exit (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/atof.3 manpages-4.05/man3/atof.3 --- manpages-4.04/man3/atof.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/atof.3 2016-03-15 03:47:39.000000000 +0000 @@ -75,11 +75,11 @@ .BR strtol (3), .BR strtoul (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/atoi.3 manpages-4.05/man3/atoi.3 --- manpages-4.04/man3/atoi.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/atoi.3 2016-03-15 03:47:39.000000000 +0000 @@ -30,7 +30,7 @@ .\" Modified Sat Jul 24 21:38:42 1993, Rik Faith (faith@cs.unc.edu) .\" Modified Sun Dec 17 18:35:06 2000, Joseph S. Myers .\" -.TH ATOI 3 2015-08-08 "GNU" "Linux Programmer's Manual" +.TH ATOI 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME atoi, atol, atoll \- convert a string to an integer .SH SYNOPSIS @@ -52,11 +52,8 @@ .ad l .BR atoll (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +__ISOC99_SOURCE || + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .ad .SH DESCRIPTION @@ -124,11 +121,11 @@ .BR strtol (3), .BR strtoul (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/backtrace.3 manpages-4.05/man3/backtrace.3 --- manpages-4.04/man3/backtrace.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/backtrace.3 2016-03-15 03:47:39.000000000 +0000 @@ -24,7 +24,7 @@ .\" .\" References: .\" glibc manual and source -.TH BACKTRACE 3 2015-03-02 GNU "Linux Programmer's Manual" +.TH BACKTRACE 3 2016-03-15 GNU "Linux Programmer's Manual" .SH NAME backtrace, backtrace_symbols, backtrace_symbols_fd \- support for application self-debugging @@ -211,15 +211,16 @@ #include #include +#define BT_BUF_SIZE 100 + void myfunc3(void) { int j, nptrs; -#define SIZE 100 - void *buffer[100]; + void *buffer[BT_BUF_SIZE]; char **strings; - nptrs = backtrace(buffer, SIZE); + nptrs = backtrace(buffer, BT_BUF_SIZE); printf("backtrace() returned %d addresses\\n", nptrs); /* The call backtrace_symbols_fd(buffer, nptrs, STDOUT_FILENO) @@ -270,11 +271,11 @@ .BR dlopen (3), .BR malloc (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/basename.3 manpages-4.05/man3/basename.3 --- manpages-4.04/man3/basename.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/basename.3 2016-03-15 03:47:39.000000000 +0000 @@ -106,7 +106,7 @@ and .BR basename () for different paths: -.sp +.RS .TS lb lb lb l l l l. @@ -118,6 +118,7 @@ \&. . . \&.. . .. .TE +.RE .SH RETURN VALUE Both .BR dirname () @@ -191,11 +192,11 @@ .BR basename (1), .BR dirname (1) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/bcmp.3 manpages-4.05/man3/bcmp.3 --- manpages-4.04/man3/bcmp.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/bcmp.3 2016-03-15 03:47:39.000000000 +0000 @@ -85,11 +85,11 @@ .BR strncasecmp (3), .BR strncmp (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/bcopy.3 manpages-4.05/man3/bcopy.3 --- manpages-4.04/man3/bcopy.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/bcopy.3 2016-03-15 03:47:39.000000000 +0000 @@ -84,11 +84,11 @@ .BR strcpy (3), .BR strncpy (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/bindresvport.3 manpages-4.05/man3/bindresvport.3 --- manpages-4.04/man3/bindresvport.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/bindresvport.3 2016-03-15 03:47:39.000000000 +0000 @@ -40,7 +40,10 @@ .SH DESCRIPTION .LP .BR bindresvport () -is used to bind a socket descriptor to a privileged anonymous IP port, +is used to bind the socket referred to by the +file descriptor +.I sockfd +to a privileged anonymous IP port, that is, a port number arbitrarily selected from the range 512 to 1023. .\" Glibc actually starts searching with a port # in the range 600 to 1023 @@ -124,11 +127,11 @@ .BR bind (2), .BR getsockname (2) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/bsd_signal.3 manpages-4.05/man3/bsd_signal.3 --- manpages-4.04/man3/bsd_signal.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/bsd_signal.3 2016-03-15 03:47:39.000000000 +0000 @@ -109,11 +109,11 @@ .BR sysv_signal (3), .BR signal (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/bsearch.3 manpages-4.05/man3/bsearch.3 --- manpages-4.04/man3/bsearch.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/bsearch.3 2016-03-15 03:47:39.000000000 +0000 @@ -145,11 +145,11 @@ .BR qsort (3), .BR tsearch (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/bstring.3 manpages-4.05/man3/bstring.3 --- manpages-4.04/man3/bstring.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/bstring.3 2016-03-15 03:47:39.000000000 +0000 @@ -92,11 +92,11 @@ .BR memmove (3), .BR memset (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/btowc.3 manpages-4.05/man3/btowc.3 --- manpages-4.04/man3/btowc.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/btowc.3 2016-03-15 03:47:39.000000000 +0000 @@ -82,11 +82,11 @@ .BR mbtowc (3), .BR wctob (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/btree.3 manpages-4.05/man3/btree.3 --- manpages-4.04/man3/btree.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/btree.3 2016-03-15 03:47:39.000000000 +0000 @@ -253,11 +253,11 @@ .IR "The Art of Computer Programming Vol. 3: Sorting and Searching" , D.E. Knuth, 1968, pp 471-480. .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/byteorder.3 manpages-4.05/man3/byteorder.3 --- manpages-4.04/man3/byteorder.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/byteorder.3 2016-03-15 03:47:39.000000000 +0000 @@ -100,11 +100,11 @@ .BR gethostbyname (3), .BR getservent (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/bzero.3 manpages-4.05/man3/bzero.3 --- manpages-4.04/man3/bzero.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/bzero.3 2016-03-15 03:47:39.000000000 +0000 @@ -70,11 +70,11 @@ .BR memset (3), .BR swab (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/cabs.3 manpages-4.05/man3/cabs.3 --- manpages-4.04/man3/cabs.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/cabs.3 2016-03-15 03:47:39.000000000 +0000 @@ -50,11 +50,11 @@ .BR hypot (3), .BR complex (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/cacos.3 manpages-4.05/man3/cacos.3 --- manpages-4.04/man3/cacos.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/cacos.3 2016-03-15 03:47:39.000000000 +0000 @@ -87,11 +87,11 @@ .BR clog (3), .BR complex (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/cacosh.3 manpages-4.05/man3/cacosh.3 --- manpages-4.04/man3/cacosh.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/cacosh.3 2016-03-15 03:47:39.000000000 +0000 @@ -89,11 +89,11 @@ .BR cimag (3), .BR complex (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/canonicalize_file_name.3 manpages-4.05/man3/canonicalize_file_name.3 --- manpages-4.04/man3/canonicalize_file_name.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/canonicalize_file_name.3 2016-03-15 03:47:39.000000000 +0000 @@ -88,11 +88,11 @@ .BR readlink (2), .BR realpath (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/carg.3 manpages-4.05/man3/carg.3 --- manpages-4.04/man3/carg.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/carg.3 2016-03-15 03:47:39.000000000 +0000 @@ -78,11 +78,11 @@ .BR cabs (3), .BR complex (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/casin.3 manpages-4.05/man3/casin.3 --- manpages-4.04/man3/casin.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/casin.3 2016-03-15 03:47:39.000000000 +0000 @@ -53,11 +53,11 @@ .BR csin (3), .BR complex (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/casinh.3 manpages-4.05/man3/casinh.3 --- manpages-4.04/man3/casinh.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/casinh.3 2016-03-15 03:47:39.000000000 +0000 @@ -55,11 +55,11 @@ .BR csinh (3), .BR complex (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/catan.3 manpages-4.05/man3/catan.3 --- manpages-4.04/man3/catan.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/catan.3 2016-03-15 03:47:39.000000000 +0000 @@ -84,11 +84,11 @@ .BR ctan (3), .BR complex (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/catanh.3 manpages-4.05/man3/catanh.3 --- manpages-4.04/man3/catanh.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/catanh.3 2016-03-15 03:47:39.000000000 +0000 @@ -86,11 +86,11 @@ .BR ctanh (3), .BR complex (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/catgets.3 manpages-4.05/man3/catgets.3 --- manpages-4.04/man3/catgets.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/catgets.3 2016-03-15 03:47:39.000000000 +0000 @@ -99,11 +99,11 @@ .BR catopen (3), .BR setlocale (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/catopen.3 manpages-4.05/man3/catopen.3 --- manpages-4.04/man3/catopen.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/catopen.3 2016-03-15 03:47:39.000000000 +0000 @@ -207,11 +207,11 @@ .BR catgets (3), .BR setlocale (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/cbrt.3 manpages-4.05/man3/cbrt.3 --- manpages-4.04/man3/cbrt.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/cbrt.3 2016-03-15 03:47:39.000000000 +0000 @@ -27,7 +27,7 @@ .\" Modified 2002-07-27 Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.TH CBRT 3 2015-04-19 "GNU" "Linux Programmer's Manual" +.TH CBRT 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME cbrt, cbrtf, cbrtl \- cube root function .SH SYNOPSIS @@ -52,21 +52,18 @@ .BR cbrt (): .br .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 || -_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || _XOPEN_SOURCE\ >=\ 500 +.\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .BR cbrtf (), .BR cbrtl (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .ad b .SH DESCRIPTION @@ -107,11 +104,11 @@ .BR pow (3), .BR sqrt (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/ccos.3 manpages-4.05/man3/ccos.3 --- manpages-4.04/man3/ccos.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/ccos.3 2016-03-15 03:47:39.000000000 +0000 @@ -52,11 +52,11 @@ .BR ctan (3), .BR complex (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/ccosh.3 manpages-4.05/man3/ccosh.3 --- manpages-4.04/man3/ccosh.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/ccosh.3 2016-03-15 03:47:39.000000000 +0000 @@ -37,11 +37,11 @@ .BR ctanh (3), .BR complex (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/ceil.3 manpages-4.05/man3/ceil.3 --- manpages-4.04/man3/ceil.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/ceil.3 2016-03-15 03:47:39.000000000 +0000 @@ -24,7 +24,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH CEIL 3 2015-04-19 "" "Linux Programmer's Manual" +.TH CEIL 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME ceil, ceilf, ceill \- ceiling function: smallest integral value not less than argument @@ -50,11 +50,9 @@ .BR ceilf (), .BR ceill (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .ad .SH DESCRIPTION @@ -132,11 +130,11 @@ .BR round (3), .BR trunc (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/cexp2.3 manpages-4.05/man3/cexp2.3 --- manpages-4.04/man3/cexp2.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/cexp2.3 2016-03-15 03:47:39.000000000 +0000 @@ -31,11 +31,11 @@ .BR clog10 (3), .BR complex (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/cexp.3 manpages-4.05/man3/cexp.3 --- manpages-4.04/man3/cexp.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/cexp.3 2016-03-15 03:47:39.000000000 +0000 @@ -53,11 +53,11 @@ .BR cpow (3), .BR complex (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/cfree.3 manpages-4.05/man3/cfree.3 --- manpages-4.04/man3/cfree.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/cfree.3 2016-03-15 03:47:39.000000000 +0000 @@ -21,7 +21,7 @@ .\" . .\" %%%LICENSE_END .\" -.TH CFREE 3 2015-03-02 "" "Linux Programmer's Manual" +.TH CFREE 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME cfree \- free allocated memory .SH SYNOPSIS @@ -48,7 +48,10 @@ .in .sp .BR cfree (): -_BSD_SOURCE || _SVID_SOURCE + Since glibc 2.19: + _DEFAULT_SOURCE + Glibc 2.19 and earlier: + _BSD_SOURCE || _SVID_SOURCE .SH DESCRIPTION This function should never be used. Use @@ -129,11 +132,11 @@ .SH SEE ALSO .BR malloc (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/cimag.3 manpages-4.05/man3/cimag.3 --- manpages-4.04/man3/cimag.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/cimag.3 2016-03-15 03:47:39.000000000 +0000 @@ -52,11 +52,11 @@ .BR creal (3), .BR complex (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/clearenv.3 manpages-4.05/man3/clearenv.3 --- manpages-4.04/man3/clearenv.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/clearenv.3 2016-03-15 03:47:39.000000000 +0000 @@ -23,7 +23,7 @@ .\" %%%LICENSE_END .\" .\" Additions, aeb, 2001-10-17. -.TH CLEARENV 3 2015-07-23 "Linux" "Linux Programmer's Manual" +.TH CLEARENV 3 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME clearenv \- clear the environment .SH SYNOPSIS @@ -39,7 +39,8 @@ .in .sp .BR clearenv (): -_SVID_SOURCE || _BSD_SOURCE + /* Glibc since 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _SVID_SOURCE || _BSD_SOURCE .SH DESCRIPTION The .BR clearenv () @@ -47,6 +48,10 @@ pairs and sets the value of the external variable .I environ to NULL. +After this call, new variables can be added to the environment using +.BR putenv (3) +and +.BR setenv (3). .SH RETURN VALUE The .BR clearenv () @@ -84,16 +89,32 @@ and rejected .BR clearenv (). .SH NOTES -Used in security-conscious applications. -If it is unavailable -the assignment +On systems where +.BR clearenv () +is unavailable, the assignment .nf environ = NULL; .fi will probably do. -.LP + +The +.BR clearenv () +function may be useful in security-conscious applications that want to +precisely control the environment that is passed to programs +executed using +.BR exec (3). +The application would do this by first clearing the environment +and then adding select environment variables. + +Note that the main effect of +.BR clearenv () +is to adjust the value of the pointer +.BR environ (7); +this function does not erase the contents of the buffers +containing the environment definitions. + The DG/UX and Tru64 man pages write: If .I environ has been modified by anything other than the @@ -113,11 +134,11 @@ .BR unsetenv (3), .BR environ (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/clock.3 manpages-4.05/man3/clock.3 --- manpages-4.04/man3/clock.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/clock.3 2016-03-15 03:47:39.000000000 +0000 @@ -112,11 +112,11 @@ .BR getrusage (2), .BR times (2) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/clock_getcpuclockid.3 manpages-4.05/man3/clock_getcpuclockid.3 --- manpages-4.04/man3/clock_getcpuclockid.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/clock_getcpuclockid.3 2016-03-15 03:47:39.000000000 +0000 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH CLOCK_GETCPUCLOCKID 3 2015-08-08 "Linux" "Linux Programmer's Manual" +.TH CLOCK_GETCPUCLOCKID 3 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME clock_getcpuclockid \- obtain ID of a process CPU-time clock .SH SYNOPSIS @@ -43,7 +43,7 @@ .sp .BR clock_getcpuclockid (): .RS 4 -_XOPEN_SOURCE\ >=\ 600 || _POSIX_C_SOURCE\ >=\ 200112L +_POSIX_C_SOURCE\ >=\ 200112L .RE .ad .SH DESCRIPTION @@ -164,11 +164,11 @@ .BR pthread_getcpuclockid (3), .BR time (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/clog10.3 manpages-4.05/man3/clog10.3 --- manpages-4.04/man3/clog10.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/clog10.3 2016-03-15 03:47:39.000000000 +0000 @@ -4,7 +4,7 @@ .\" Distributed under GPL .\" %%%LICENSE_END .\" -.TH CLOG10 3 2015-03-02 "" "Linux Programmer's Manual" +.TH CLOG10 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME clog10, clog10f, clog10l \- base-10 logarithm of a complex number .SH SYNOPSIS @@ -22,8 +22,14 @@ .SH DESCRIPTION The call .I clog10(z) -is equivalent to -.IR clog(z)/log(10) . +is equivalent to: + + clog(z)/log(10) + +or equally: + + log10(cabs(c)) + I * carg(c) / log(10) + The other functions perform the same task for .I float and @@ -50,7 +56,7 @@ .TE .SH CONFORMING TO These functions are GNU extensions. -It is reserved for future use in C99. +The identifiers are reserved for future use in C99 and C11. .SH SEE ALSO .BR cabs (3), .BR cexp (3), @@ -58,11 +64,11 @@ .BR clog2 (3), .BR complex (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/clog2.3 manpages-4.05/man3/clog2.3 --- manpages-4.04/man3/clog2.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/clog2.3 2016-03-15 03:47:39.000000000 +0000 @@ -43,11 +43,11 @@ .BR clog10 (3), .BR complex (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/clog.3 manpages-4.05/man3/clog.3 --- manpages-4.04/man3/clog.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/clog.3 2016-03-15 03:47:39.000000000 +0000 @@ -65,11 +65,11 @@ .BR clog2 (3), .BR complex (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/closedir.3 manpages-4.05/man3/closedir.3 --- manpages-4.04/man3/closedir.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/closedir.3 2016-03-15 03:47:39.000000000 +0000 @@ -87,11 +87,11 @@ .BR seekdir (3), .BR telldir (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/cmsg.3 manpages-4.05/man3/cmsg.3 --- manpages-4.04/man3/cmsg.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/cmsg.3 2016-03-15 03:47:39.000000000 +0000 @@ -8,7 +8,7 @@ .\" %%%LICENSE_END .\" .\" $Id: cmsg.3,v 1.8 2000/12/20 18:10:31 ak Exp $ -.TH CMSG 3 2015-05-07 "Linux" "Linux Programmer's Manual" +.TH CMSG 3 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME CMSG_ALIGN, CMSG_SPACE, CMSG_NXTHDR, CMSG_FIRSTHDR \- access ancillary data .SH SYNOPSIS @@ -28,10 +28,12 @@ .sp .nf struct cmsghdr { - socklen_t cmsg_len; /* data byte count, including header */ - int cmsg_level; /* originating protocol */ - int cmsg_type; /* protocol-specific type */ - /* followed by unsigned char cmsg_data[]; */ + size_t cmsg_len; /* Data byte count, including header + (type is socklen_t in POSIX) */ + int cmsg_level; /* Originating protocol */ + int cmsg_type; /* Protocol-specific type */ +/* followed by + unsigned char cmsg_data[]; */ }; .fi .SH DESCRIPTION @@ -223,11 +225,11 @@ .PP RFC\ 2292 .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/confstr.3 manpages-4.05/man3/confstr.3 --- manpages-4.04/man3/confstr.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/confstr.3 2016-03-15 03:47:39.000000000 +0000 @@ -165,11 +165,11 @@ .BR pathconf (3) .BR system (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/conj.3 manpages-4.05/man3/conj.3 --- manpages-4.04/man3/conj.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/conj.3 2016-03-15 03:47:39.000000000 +0000 @@ -50,11 +50,11 @@ .BR csqrt (3), .BR complex (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/copysign.3 manpages-4.05/man3/copysign.3 --- manpages-4.04/man3/copysign.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/copysign.3 2016-03-15 03:47:39.000000000 +0000 @@ -28,7 +28,7 @@ .\" 386BSD man pages .\" Modified 1993-07-24 by Rik Faith (faith@cs.unc.edu) .\" Modified 2002-08-10 by Walter Harms (walter.harms@informatik.uni-oldenburg.de) -.TH COPYSIGN 3 2015-04-19 "GNU" "Linux Programmer's Manual" +.TH COPYSIGN 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME copysign, copysignf, copysignl \- copy sign of a number .SH SYNOPSIS @@ -54,11 +54,9 @@ .BR copysignf (), .BR copysignl (): .RS 4 -_SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .ad b .SH DESCRIPTION @@ -112,11 +110,11 @@ .SH SEE ALSO .BR signbit (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/cos.3 manpages-4.05/man3/cos.3 --- manpages-4.04/man3/cos.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/cos.3 2016-03-15 03:47:39.000000000 +0000 @@ -31,7 +31,7 @@ .\" Modified 1993-07-24 by Rik Faith (faith@cs.unc.edu) .\" Modified 2002-07-27 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) -.TH COS 3 2015-04-19 "" "Linux Programmer's Manual" +.TH COS 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME cos, cosf, cosl \- cosine function .SH SYNOPSIS @@ -56,11 +56,9 @@ .BR cosf (), .BR cosl (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .ad .SH DESCRIPTION @@ -137,11 +135,11 @@ .BR sincos (3), .BR tan (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/cosh.3 manpages-4.05/man3/cosh.3 --- manpages-4.04/man3/cosh.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/cosh.3 2016-03-15 03:47:39.000000000 +0000 @@ -33,7 +33,7 @@ .\" Modified 2002-07-27 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.TH COSH 3 2015-04-19 "" "Linux Programmer's Manual" +.TH COSH 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME cosh, coshf, coshl \- hyperbolic cosine function .SH SYNOPSIS @@ -58,11 +58,9 @@ .BR coshf (), .BR coshl (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .ad .SH DESCRIPTION @@ -147,11 +145,11 @@ .BR sinh (3), .BR tanh (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/cpow.3 manpages-4.05/man3/cpow.3 --- manpages-4.04/man3/cpow.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/cpow.3 2016-03-15 03:47:39.000000000 +0000 @@ -51,11 +51,11 @@ .BR pow (3), .BR complex (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/cproj.3 manpages-4.05/man3/cproj.3 --- manpages-4.04/man3/cproj.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/cproj.3 2016-03-15 03:47:39.000000000 +0000 @@ -55,11 +55,11 @@ .BR cabs (3), .BR complex (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/CPU_SET.3 manpages-4.05/man3/CPU_SET.3 --- manpages-4.04/man3/CPU_SET.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/CPU_SET.3 2016-03-15 03:47:39.000000000 +0000 @@ -229,7 +229,7 @@ .BR CPU_EQUAL () and .BR CPU_EQUAL_S () -return nonzero if the two CPU sets are equal; otherwise it returns 0. +return nonzero if the two CPU sets are equal; otherwise they return 0. .BR CPU_ALLOC () returns a pointer on success, or NULL on failure. @@ -362,11 +362,11 @@ .BR pthread_setaffinity_np (3), .BR cpuset (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/creal.3 manpages-4.05/man3/creal.3 --- manpages-4.04/man3/creal.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/creal.3 2016-03-15 03:47:39.000000000 +0000 @@ -52,11 +52,11 @@ .BR cimag (3), .BR complex (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/crypt.3 manpages-4.05/man3/crypt.3 --- manpages-4.04/man3/crypt.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/crypt.3 2016-03-15 03:47:39.000000000 +0000 @@ -126,8 +126,6 @@ .I salt has the wrong format. .TP -.B -.TP .B ENOSYS The .BR crypt () @@ -259,11 +257,11 @@ .BR getpass (3), .BR passwd (5) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/csin.3 manpages-4.05/man3/csin.3 --- manpages-4.04/man3/csin.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/csin.3 2016-03-15 03:47:39.000000000 +0000 @@ -52,11 +52,11 @@ .BR ctan (3), .BR complex (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/csinh.3 manpages-4.05/man3/csinh.3 --- manpages-4.04/man3/csinh.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/csinh.3 2016-03-15 03:47:39.000000000 +0000 @@ -52,11 +52,11 @@ .BR ctanh (3), .BR complex (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/csqrt.3 manpages-4.05/man3/csqrt.3 --- manpages-4.04/man3/csqrt.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/csqrt.3 2016-03-15 03:47:39.000000000 +0000 @@ -48,11 +48,11 @@ .BR cexp (3), .BR complex (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/ctan.3 manpages-4.05/man3/ctan.3 --- manpages-4.04/man3/ctan.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/ctan.3 2016-03-15 03:47:39.000000000 +0000 @@ -52,11 +52,11 @@ .BR csin (3), .BR complex (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/ctanh.3 manpages-4.05/man3/ctanh.3 --- manpages-4.04/man3/ctanh.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/ctanh.3 2016-03-15 03:47:39.000000000 +0000 @@ -53,11 +53,11 @@ .BR csinh (3), .BR complex (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/ctermid.3 manpages-4.05/man3/ctermid.3 --- manpages-4.04/man3/ctermid.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/ctermid.3 2016-03-15 03:47:39.000000000 +0000 @@ -23,7 +23,7 @@ .\" %%%LICENSE_END .\" .\" Modified Sat Jul 24 19:51:06 1993 by Rik Faith (faith@cs.unc.edu) -.TH CTERMID 3 2015-08-08 "GNU" "Linux Programmer's Manual" +.TH CTERMID 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME ctermid \- get controlling terminal name .SH SYNOPSIS @@ -41,8 +41,7 @@ .in .sp .BR ctermid (): -_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _POSIX_SOURCE -.\" From : _XOPEN_SOURCE +_POSIX_C_SOURCE .SH DESCRIPTION .BR ctermid () returns a string which is the pathname for the current @@ -83,11 +82,11 @@ .SH SEE ALSO .BR ttyname (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/ctime.3 manpages-4.05/man3/ctime.3 --- manpages-4.04/man3/ctime.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/ctime.3 2016-03-15 03:47:39.000000000 +0000 @@ -32,7 +32,7 @@ .\" Modified 2001-12-13, joey, aeb .\" Modified 2004-11-16, mtk .\" -.TH CTIME 3 2015-04-19 "" "Linux Programmer's Manual" +.TH CTIME 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME asctime, ctime, gmtime, localtime, mktime, asctime_r, ctime_r, gmtime_r, localtime_r \- transform date and time to broken-down time or ASCII @@ -70,8 +70,8 @@ .BR gmtime_r (), .BR localtime_r (): .RS -_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _BSD_SOURCE || -_SVID_SOURCE || _POSIX_SOURCE +_POSIX_C_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .ad .SH DESCRIPTION @@ -405,11 +405,11 @@ .BR tzset (3), .BR time (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/daemon.3 manpages-4.05/man3/daemon.3 --- manpages-4.04/man3/daemon.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/daemon.3 2016-03-15 03:47:39.000000000 +0000 @@ -33,7 +33,7 @@ .\" .\" @(#)daemon.3 8.1 (Berkeley) 6/9/93 .\" Added mentioning of glibc weirdness wrt unistd.h. 5/11/98, Al Viro -.TH DAEMON 3 2015-12-05 "GNU" "Linux Programmer's Manual" +.TH DAEMON 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME daemon \- run in the background .SH SYNOPSIS @@ -47,7 +47,15 @@ .in .sp .BR daemon (): -_BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE\ <\ 500) +.nf + Since glibc 2.21: +.\" commit 266865c0e7b79d4196e2cc393693463f03c90bd8 + _DEFAULT_SOURCE + In glibc 2.19 and 2.20: + _DEFAULT_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE\ <\ 500) + Up to and including glibc 2.19: + _BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE\ <\ 500) +.fi .SH DESCRIPTION The .BR daemon () @@ -138,11 +146,11 @@ .BR fork (2), .BR setsid (2) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/dbopen.3 manpages-4.05/man3/dbopen.3 --- manpages-4.04/man3/dbopen.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/dbopen.3 2016-03-15 03:47:39.000000000 +0000 @@ -560,11 +560,11 @@ .IR "LIBTP: Portable, Modular Transactions for UNIX" , Margo Seltzer, Michael Olson, USENIX proceedings, Winter 1992. .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/des_crypt.3 manpages-4.05/man3/des_crypt.3 --- manpages-4.04/man3/des_crypt.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/des_crypt.3 2016-03-15 03:47:40.000000000 +0000 @@ -153,11 +153,11 @@ .BR crypt (3), .BR xcrypt (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/difftime.3 manpages-4.05/man3/difftime.3 --- manpages-4.04/man3/difftime.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/difftime.3 2016-03-15 03:47:40.000000000 +0000 @@ -80,11 +80,11 @@ .BR gmtime (3), .BR localtime (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/dirfd.3 manpages-4.05/man3/dirfd.3 --- manpages-4.04/man3/dirfd.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/dirfd.3 2016-03-15 03:47:40.000000000 +0000 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH DIRFD 3 2015-12-05 "Linux" "Linux Programmer's Manual" +.TH DIRFD 3 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME dirfd \- get directory stream file descriptor .SH SYNOPSIS @@ -42,12 +42,8 @@ .RS 4 .PD 0 .ad l -_BSD_SOURCE || _SVID_SOURCE -.br -|| /* Since glibc 2.10: */ -.RS 4 -(_POSIX_C_SOURCE\ >=\ 200809L || _XOPEN_SOURCE\ >=\ 700) -.RE +/* Since glibc 2.10: */ _POSIX_C_SOURCE\ >=\ 200809L + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .PD .RE .ad @@ -57,7 +53,7 @@ returns the file descriptor associated with the directory stream .IR dirp . .LP -This descriptor is the one used internally by the directory stream. +This file descriptor is the one used internally by the directory stream. As a result, it is useful only for functions which do not depend on or alter the file position, such as .BR fstat (2) @@ -110,11 +106,11 @@ .BR seekdir (3), .BR telldir (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/div.3 manpages-4.05/man3/div.3 --- manpages-4.04/man3/div.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/div.3 2016-03-15 03:47:40.000000000 +0000 @@ -31,7 +31,7 @@ .\" Modified 1993-07-24, Rik Faith (faith@cs.unc.edu) .\" Modified 2002-08-10, 2003-11-01 Walter Harms, aeb .\" -.TH DIV 3 2015-08-08 "" "Linux Programmer's Manual" +.TH DIV 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME div, ldiv, lldiv, imaxdiv \- compute quotient and remainder of an integer division @@ -58,11 +58,7 @@ .sp .BR lldiv (): .RS 4 -_XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L .RE .ad .SH DESCRIPTION @@ -122,11 +118,11 @@ .BR abs (3), .BR remainder (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/dladdr.3 manpages-4.05/man3/dladdr.3 --- manpages-4.04/man3/dladdr.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/dladdr.3 2016-03-15 03:47:40.000000000 +0000 @@ -183,7 +183,6 @@ (or .BR ELF32_ST_BIND() on 32-bit platforms), which yields one of the following values: - .in +4n .TS lb lb @@ -225,7 +224,6 @@ .I info->dli_saddr fields are set to NULL. - If the address specified in .I addr could not be matched to a shared object, then these functions return 0. @@ -291,11 +289,11 @@ .BR dlsym (3), .BR ld.so (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/dlerror.3 manpages-4.05/man3/dlerror.3 --- manpages-4.04/man3/dlerror.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/dlerror.3 2016-03-15 03:47:40.000000000 +0000 @@ -90,11 +90,11 @@ .BR dlopen (3), .BR dlsym (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/dlinfo.3 manpages-4.05/man3/dlinfo.3 --- manpages-4.04/man3/dlinfo.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/dlinfo.3 2016-03-15 03:47:40.000000000 +0000 @@ -334,11 +334,11 @@ .BR dlsym (3), .BR ld.so (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/dl_iterate_phdr.3 manpages-4.05/man3/dl_iterate_phdr.3 --- manpages-4.04/man3/dl_iterate_phdr.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/dl_iterate_phdr.3 2016-03-15 03:47:40.000000000 +0000 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH DL_ITERATE_PHDR 3 2015-07-23 "GNU" "Linux Programmer's Manual" +.TH DL_ITERATE_PHDR 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME dl_iterate_phdr \- walk through list of shared objects .SH SYNOPSIS @@ -82,6 +82,26 @@ ELF program headers for this object */ ElfW(Half) dlpi_phnum; /* # of items in \fIdlpi_phdr\fP */ + + /* The following fields were added in glibc 2.4, after the first + version of this structure was available. Check the \fIsize\fP + argument passed to the dl_iterate_phdr callback to determine + whether or not each later member is available. */ + + unsigned long long int dlpi_adds; + /* Incremented when a new object may + have been added */ + unsigned long long int dlpi_subs; + /* Incremented when an object may + have been removed */ + size_t dlpi_tls_modid; + /* If there is a PT_TLS segment, its module + ID as used in TLS relocations, else zero */ + void *dlpi_tls_data; + /* The address of the calling thread's instance + of this module's PT_TLS segment, if it has + one and it has been allocated in the calling + thread, otherwise a null pointer */ }; .fi .in @@ -191,6 +211,13 @@ .I size argument provides a mechanism for the callback function to discover whether it is running on a system with added fields. + +The first object visited by +.IR callback +is the main program. +For the main program, the +.I dlpi_name +field will be an empty string. .SH EXAMPLE The following program displays a list of pathnames of the shared objects it has loaded. @@ -237,11 +264,11 @@ .IR "Executable and Linking Format Specification" , available at various locations online. .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/dlopen.3 manpages-4.05/man3/dlopen.3 --- manpages-4.04/man3/dlopen.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/dlopen.3 2016-03-15 03:47:40.000000000 +0000 @@ -597,11 +597,11 @@ gcc info pages, ld info pages .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/dlsym.3 manpages-4.05/man3/dlsym.3 --- manpages-4.04/man3/dlsym.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/dlsym.3 2016-03-15 03:47:40.000000000 +0000 @@ -148,11 +148,11 @@ .BR dlopen (3), .BR ld.so (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/drand48.3 manpages-4.05/man3/drand48.3 --- manpages-4.04/man3/drand48.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/drand48.3 2016-03-15 03:47:40.000000000 +0000 @@ -27,7 +27,7 @@ .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified Sat Jul 24 19:46:03 1993 by Rik Faith (faith@cs.unc.edu) -.TH DRAND48 3 2015-12-28 "" "Linux Programmer's Manual" +.TH DRAND48 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME drand48, erand48, lrand48, nrand48, mrand48, jrand48, srand48, seed48, lcong48 \- generate uniformly distributed pseudo-random numbers @@ -70,7 +70,9 @@ .\" .BR srand48 (), .\" .BR seed48 (), .\" .BR lcong48 (): -_SVID_SOURCE || _XOPEN_SOURCE +_XOPEN_SOURCE + || /* Glibc since 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _SVID_SOURCE .ad b .SH DESCRIPTION These functions generate pseudo-random numbers using the linear congruential @@ -276,11 +278,11 @@ .BR rand (3), .BR random (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/drand48_r.3 manpages-4.05/man3/drand48_r.3 --- manpages-4.04/man3/drand48_r.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/drand48_r.3 2016-03-15 03:47:40.000000000 +0000 @@ -24,7 +24,7 @@ .\" .\" Created 2004-10-31. Text taken from a page by Walter Harms, 2003-09-08 .\" -.TH DRAND48_R 3 2015-03-02 "GNU" "Linux Programmer's Manual" +.TH DRAND48_R 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME drand48_r, erand48_r, lrand48_r, nrand48_r, mrand48_r, jrand48_r, srand48_r, seed48_r, lcong48_r @@ -78,7 +78,8 @@ .\" .BR srand48_r (), .\" .BR seed48_r (), .\" .BR lcong48_r (): -_SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE + /* Glibc since 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _SVID_SOURCE || _BSD_SOURCE .ad b .SH DESCRIPTION These functions are the reentrant analogs of the functions described in @@ -124,11 +125,11 @@ .BR rand (3), .BR random (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/duplocale.3 manpages-4.05/man3/duplocale.3 --- manpages-4.04/man3/duplocale.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/duplocale.3 2016-03-15 03:47:40.000000000 +0000 @@ -97,7 +97,6 @@ to the value returned by the following call: loc = uselocale((locale_t) 0); - .IP This technique is necessary, because the above .BR uselocale (3) @@ -186,11 +185,11 @@ .BR locale (5), .BR locale (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/dysize.3 manpages-4.05/man3/dysize.3 --- manpages-4.04/man3/dysize.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/dysize.3 2016-03-15 03:47:40.000000000 +0000 @@ -23,7 +23,7 @@ .\" %%%LICENSE_END .\" .\" aeb: some corrections -.TH DYSIZE 3 2015-03-02 "GNU" "Linux Programmer's Manual" +.TH DYSIZE 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME dysize \- get number of days for a given year .SH SYNOPSIS @@ -37,7 +37,10 @@ .in .sp .BR dysize (): -_BSD_SOURCE || _SVID_SOURCE + Since glibc 2.19: + _DEFAULT_SOURCE + Glibc 2.19 and earlier: + _BSD_SOURCE || _SVID_SOURCE .SH DESCRIPTION The function returns 365 for a normal year and 366 for a leap year. The calculation for leap year is based on: @@ -69,11 +72,11 @@ .SH SEE ALSO .BR strftime (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/ecvt.3 manpages-4.05/man3/ecvt.3 --- manpages-4.04/man3/ecvt.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/ecvt.3 2016-03-15 03:47:40.000000000 +0000 @@ -29,7 +29,7 @@ .\" Modified Sat Jul 24 19:40:39 1993 by Rik Faith (faith@cs.unc.edu) .\" Modified Fri Jun 25 12:10:47 1999 by Andries Brouwer (aeb@cwi.nl) .\" -.TH ECVT 3 2015-03-02 "" "Linux Programmer's Manual" +.TH ECVT 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME ecvt, fcvt \- convert a floating-point number to a string .SH SYNOPSIS @@ -54,15 +54,14 @@ .TP 4 Since glibc 2.12: .nf -_SVID_SOURCE || - (_XOPEN_SOURCE\ >=\ 500 || - _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED) && - !(_POSIX_C_SOURCE\ >=\ 200112L || _XOPEN_SOURCE\ >=\ 600) +(_XOPEN_SOURCE\ >=\ 500) ! (_POSIX_C_SOURCE\ >=\ 200112L) + || /* Glibc since 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _SVID_SOURCE .fi .TP 4 Before glibc 2.12: -_SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 || -_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED +_SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 +.\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED .PD .RE .ad b @@ -147,11 +146,11 @@ .BR setlocale (3), .BR sprintf (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/ecvt_r.3 manpages-4.05/man3/ecvt_r.3 --- manpages-4.04/man3/ecvt_r.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/ecvt_r.3 2016-03-15 03:47:40.000000000 +0000 @@ -27,7 +27,7 @@ .\" .\" Corrected return types; from Fabian; 2004-10-05 .\" -.TH ECVT_R 3 2015-03-02 "GNU" "Linux Programmer's Manual" +.TH ECVT_R 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME ecvt_r, fcvt_r, qecvt_r, qfcvt_r \- convert a floating-point number to a string .SH SYNOPSIS @@ -58,7 +58,8 @@ .BR qecvt_r (), .BR qfcvt_r (): .RS 4 -_SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 +/* Glibc since 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _SVID_SOURCE || _BSD_SOURCE .RE .ad b .SH DESCRIPTION @@ -113,11 +114,11 @@ .BR qecvt (3), .BR sprintf (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/encrypt.3 manpages-4.05/man3/encrypt.3 --- manpages-4.04/man3/encrypt.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/encrypt.3 2016-03-15 03:47:40.000000000 +0000 @@ -205,11 +205,11 @@ .BR ecb_crypt (3), .\" .BR fcrypt (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/end.3 manpages-4.05/man3/end.3 --- manpages-4.04/man3/end.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/end.3 2016-03-15 03:47:40.000000000 +0000 @@ -111,11 +111,11 @@ .BR sbrk (2), .BR elf (5) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/endian.3 manpages-4.05/man3/endian.3 --- manpages-4.04/man3/endian.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/endian.3 2016-03-15 03:47:40.000000000 +0000 @@ -25,14 +25,13 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH ENDIAN 3 2010-09-10 "GNU" "Linux Programmer's Manual" +.TH ENDIAN 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME htobe16, htole16, be16toh, le16toh, htobe32, htole32, be32toh, le32toh, htobe64, htole64, be64toh, le64toh \- convert values between host and big-/little-endian byte order .SH SYNOPSIS .nf -.BR "#define _BSD_SOURCE" " /* See feature_test_macros(7) */" .B #include .BI "uint16_t htobe16(uint16_t " host_16bits ); @@ -50,6 +49,30 @@ .BI "uint64_t be64toh(uint64_t " big_endian_64bits ); .BI "uint64_t le64toh(uint64_t " little_endian_64bits ); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR htobe16 (), +.BR htole16 (), +.BR be16toh (), +.BR le16toh (), +.BR htobe32 (), +.BR htole32 (), +.BR be32toh (), +.BR le32toh (), +.BR htobe64 (), +.BR htole64 (), +.BR be64toh (), +.BR le64toh (): +.nf + Since glibc 2.19: + _DEFAULT_SOURCE + In glibc up to and including 2.19: + _BSD_SOURCE +.fi .SH DESCRIPTION These functions convert the byte encoding of integer values from the byte order that the current CPU (the "host") uses, @@ -151,11 +174,11 @@ .SH SEE ALSO .BR byteorder (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/envz_add.3 manpages-4.05/man3/envz_add.3 --- manpages-4.04/man3/envz_add.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/envz_add.3 2016-03-15 03:47:40.000000000 +0000 @@ -163,11 +163,11 @@ .SH SEE ALSO .BR argz_add (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/erf.3 manpages-4.05/man3/erf.3 --- manpages-4.04/man3/erf.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/erf.3 2016-03-15 03:47:40.000000000 +0000 @@ -32,7 +32,7 @@ .\" Modified 2002-07-27 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.TH ERF 3 2015-04-19 "GNU" "Linux Programmer's Manual" +.TH ERF 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME erf, erff, erfl, \- error function .SH SYNOPSIS @@ -54,21 +54,17 @@ .ad l .BR erf (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L || _XOPEN_SOURCE + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .br .BR erff (), .BR erfl (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .ad b .SH DESCRIPTION @@ -146,11 +142,11 @@ .BR erfc (3), .BR exp (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/erfc.3 manpages-4.05/man3/erfc.3 --- manpages-4.04/man3/erfc.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/erfc.3 2016-03-15 03:47:40.000000000 +0000 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH ERFC 3 2015-04-19 "GNU" "Linux Programmer's Manual" +.TH ERFC 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME erfc, erfcf, erfcl \- complementary error function .SH SYNOPSIS @@ -45,21 +45,17 @@ .ad l .BR erfc (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L || _XOPEN_SOURCE + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .br .BR erfcf (), .BR erfcl (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600|| _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .ad b .SH DESCRIPTION @@ -153,11 +149,11 @@ .BR erf (3), .BR exp (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/err.3 manpages-4.05/man3/err.3 --- manpages-4.04/man3/err.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/err.3 2016-03-15 03:47:40.000000000 +0000 @@ -183,11 +183,11 @@ .BR printf (3), .BR strerror (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/errno.3 manpages-4.05/man3/errno.3 --- manpages-4.04/man3/errno.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/errno.3 2016-03-15 03:47:40.000000000 +0000 @@ -28,7 +28,7 @@ .\" 2006-02-09 Kurt Wall, mtk .\" Added non-POSIX errors .\" -.TH ERRNO 3 2015-12-28 "" "Linux Programmer's Manual" +.TH ERRNO 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME errno \- number of last error .SH SYNOPSIS @@ -324,6 +324,10 @@ .TP .B ENOENT No such file or directory (POSIX.1) + +Typically, this error results when a specified pathname does not exist, +or one of the components in the directory prefix of a pathname does not exist, +or the specified pathname is a dangling symbolic link. .TP .B ENOEXEC Exec format error (POSIX.1) @@ -550,11 +554,11 @@ .BR perror (3), .BR strerror (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/error.3 manpages-4.05/man3/error.3 --- manpages-4.04/man3/error.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/error.3 2016-03-15 03:47:40.000000000 +0000 @@ -162,11 +162,11 @@ .BR program_invocation_name (3), .BR strerror (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/ether_aton.3 manpages-4.05/man3/ether_aton.3 --- manpages-4.04/man3/ether_aton.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/ether_aton.3 2016-03-15 03:47:40.000000000 +0000 @@ -157,11 +157,11 @@ .SH SEE ALSO .BR ethers (5) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/euidaccess.3 manpages-4.05/man3/euidaccess.3 --- manpages-4.04/man3/euidaccess.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/euidaccess.3 2016-03-15 03:47:40.000000000 +0000 @@ -116,11 +116,11 @@ .BR credentials (7), .BR path_resolution (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/exec.3 manpages-4.05/man3/exec.3 --- manpages-4.04/man3/exec.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/exec.3 2016-03-15 03:47:40.000000000 +0000 @@ -38,7 +38,7 @@ .\" Modified, 24 Jun 2004, Michael Kerrisk .\" Added note on casting NULL .\" -.TH EXEC 3 2015-04-19 "GNU" "Linux Programmer's Manual" +.TH EXEC 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME execl, execlp, execle, execv, execvp, execvpe \- execute a file .SH SYNOPSIS @@ -268,13 +268,14 @@ .BR fork (2), .BR ptrace (2), .BR fexecve (3), +.BR system (3), .BR environ (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/exit.3 manpages-4.05/man3/exit.3 --- manpages-4.04/man3/exit.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/exit.3 2016-03-15 03:47:40.000000000 +0000 @@ -199,11 +199,11 @@ .BR on_exit (3), .BR tmpfile (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/exp10.3 manpages-4.05/man3/exp10.3 --- manpages-4.04/man3/exp10.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/exp10.3 2016-03-15 03:47:40.000000000 +0000 @@ -100,11 +100,11 @@ .BR log10 (3), .BR sqrt (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/exp2.3 manpages-4.05/man3/exp2.3 --- manpages-4.04/man3/exp2.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/exp2.3 2016-03-15 03:47:40.000000000 +0000 @@ -33,7 +33,7 @@ .\" Modified 2002-07-27 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.TH EXP2 3 2015-04-19 "" "Linux Programmer's Manual" +.TH EXP2 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME exp2, exp2f, exp2l \- base-2 exponential function .SH SYNOPSIS @@ -59,10 +59,7 @@ .BR exp2f (), .BR exp2l (): .RS 4 -_XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L .RE .ad b .SH DESCRIPTION @@ -113,11 +110,11 @@ .BR exp10 (3), .BR sqrt (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/exp.3 manpages-4.05/man3/exp.3 --- manpages-4.04/man3/exp.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/exp.3 2016-03-15 03:47:40.000000000 +0000 @@ -33,7 +33,7 @@ .\" Modified 2002-07-27 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.TH EXP 3 2015-04-19 "" "Linux Programmer's Manual" +.TH EXP 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME exp, expf, expl \- base-e exponential function .SH SYNOPSIS @@ -58,11 +58,9 @@ .BR expf (), .BR expl (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .ad b .SH DESCRIPTION @@ -149,13 +147,14 @@ .BR cexp (3), .BR exp10 (3), .BR exp2 (3), +.BR expm1 (3), .BR sqrt (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/expm1.3 manpages-4.05/man3/expm1.3 --- manpages-4.04/man3/expm1.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/expm1.3 2016-03-15 03:47:40.000000000 +0000 @@ -27,7 +27,7 @@ .\" Modified 2002-07-27 Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.TH EXPM1 3 2015-04-19 "" "Linux Programmer's Manual" +.TH EXPM1 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME expm1, expm1f, expm1l \- exponential minus 1 .SH SYNOPSIS @@ -51,22 +51,19 @@ .ad l .BR expm1 (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 || -_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || _XOPEN_SOURCE\ >=\ 500 +.\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .br .BR expm1f (), .BR expm1l (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .ad b .SH DESCRIPTION @@ -184,11 +181,11 @@ .BR log (3), .BR log1p (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/fabs.3 manpages-4.05/man3/fabs.3 --- manpages-4.04/man3/fabs.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/fabs.3 2016-03-15 03:47:40.000000000 +0000 @@ -29,7 +29,7 @@ .\" Modified Sat Jul 24 19:42:04 1993 by Rik Faith (faith@cs.unc.edu) .\" Added fabsl, fabsf, aeb, 2001-06-07 .\" -.TH FABS 3 2015-04-19 "" "Linux Programmer's Manual" +.TH FABS 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME fabs, fabsf, fabsl \- absolute value of floating-point number .SH SYNOPSIS @@ -54,11 +54,9 @@ .BR fabsf (), .BR fabsl (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .ad b .SH DESCRIPTION @@ -111,11 +109,11 @@ .BR labs (3), .BR rint (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/fclose.3 manpages-4.05/man3/fclose.3 --- manpages-4.04/man3/fclose.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/fclose.3 2016-03-15 03:47:40.000000000 +0000 @@ -118,11 +118,11 @@ .BR fopen (3), .BR setbuf (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/fcloseall.3 manpages-4.05/man3/fcloseall.3 --- manpages-4.04/man3/fcloseall.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/fcloseall.3 2016-03-15 03:47:40.000000000 +0000 @@ -77,11 +77,11 @@ .BR fopen (3), .BR setbuf (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/fdim.3 manpages-4.05/man3/fdim.3 --- manpages-4.04/man3/fdim.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/fdim.3 2016-03-15 03:47:40.000000000 +0000 @@ -6,7 +6,7 @@ .\" Distributed under GPL .\" %%%LICENSE_END .\" -.TH FDIM 3 2015-04-19 "" "Linux Programmer's Manual" +.TH FDIM 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME fdim, fdimf, fdiml \- positive difference .SH SYNOPSIS @@ -29,11 +29,7 @@ .BR fdimf (), .BR fdiml (): .RS 4 -_XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L .RE .ad .SH DESCRIPTION @@ -97,11 +93,11 @@ .SH SEE ALSO .BR fmax (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/fenv.3 manpages-4.05/man3/fenv.3 --- manpages-4.04/man3/fenv.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/fenv.3 2016-03-15 03:47:40.000000000 +0000 @@ -354,11 +354,11 @@ .SH SEE ALSO .BR math_error (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/ferror.3 manpages-4.05/man3/ferror.3 --- manpages-4.04/man3/ferror.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/ferror.3 2016-03-15 03:47:40.000000000 +0000 @@ -41,7 +41,7 @@ .\" Converted for Linux, Mon Nov 29 14:24:40 1993, faith@cs.unc.edu .\" Added remark on EBADF for fileno, aeb, 2001-03-22 .\" -.TH FERROR 3 2015-03-02 "" "Linux Programmer's Manual" +.TH FERROR 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME clearerr, feof, ferror, fileno \- check and reset stream status .SH SYNOPSIS @@ -61,7 +61,7 @@ .in .sp .BR fileno (): -_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _POSIX_SOURCE +_POSIX_C_SOURCE .SH DESCRIPTION The function .BR clearerr () @@ -89,7 +89,7 @@ .BR fileno () examines the argument .I stream -and returns its integer descriptor. +and returns its integer file descriptor. .PP For nonlocking counterparts, see .BR unlocked_stdio (3). @@ -136,11 +136,11 @@ .BR stdio (3), .BR unlocked_stdio (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/fexecve.3 manpages-4.05/man3/fexecve.3 --- manpages-4.04/man3/fexecve.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/fexecve.3 2016-03-15 03:47:40.000000000 +0000 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH FEXECVE 3 2015-07-23 "Linux" "Linux Programmer's Manual" +.TH FEXECVE 3 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME fexecve \- execute program specified via file descriptor .SH SYNOPSIS @@ -43,7 +43,7 @@ .RS 4 .TP 4 Since glibc 2.10: -_XOPEN_SOURCE\ >=\ 700 || _POSIX_C_SOURCE\ >=\ 200809L +_POSIX_C_SOURCE\ >=\ 200809L .TP Before glibc 2.10: _GNU_SOURCE @@ -179,11 +179,11 @@ .BR execve (2), .BR execveat (2) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/fflush.3 manpages-4.05/man3/fflush.3 --- manpages-4.04/man3/fflush.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/fflush.3 2016-03-15 03:47:40.000000000 +0000 @@ -130,11 +130,11 @@ .BR setbuf (3), .BR unlocked_stdio (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/ffs.3 manpages-4.05/man3/ffs.3 --- manpages-4.04/man3/ffs.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/ffs.3 2016-03-15 03:47:40.000000000 +0000 @@ -30,7 +30,7 @@ .\" .\" Modified 2003 Walter Harms (walter.harms@informatik.uni-oldenburg.de) .\" -.TH FFS 3 2015-08-08 "GNU" "Linux Programmer's Manual" +.TH FFS 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME ffs, ffsl, ffsll \- find first bit set in a word .SH SYNOPSIS @@ -57,8 +57,9 @@ .RS 4 .TP 4 Since glibc 2.12: -_SVID_SOURCE || _BSD_SOURCE || -_POSIX_C_SOURCE\ >=\ 200809L || _XOPEN_SOURCE\ >=\ 700 || +_POSIX_C_SOURCE\ >=\ 200809L + || /* Glibc since 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .TP Before glibc 2.12: none @@ -117,11 +118,11 @@ .SH SEE ALSO .BR memchr (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/fgetc.3 manpages-4.05/man3/fgetc.3 --- manpages-4.04/man3/fgetc.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/fgetc.3 2016-03-15 03:47:40.000000000 +0000 @@ -166,11 +166,11 @@ .BR unlocked_stdio (3), .BR feature_test_macros (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/fgetgrent.3 manpages-4.05/man3/fgetgrent.3 --- manpages-4.04/man3/fgetgrent.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/fgetgrent.3 2016-03-15 03:47:40.000000000 +0000 @@ -27,7 +27,7 @@ .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified Sat Jul 24 19:38:44 1993 by Rik Faith (faith@cs.unc.edu) -.TH FGETGRENT 3 2015-12-05 "GNU" "Linux Programmer's Manual" +.TH FGETGRENT 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME fgetgrent \- get group file entry .SH SYNOPSIS @@ -45,7 +45,10 @@ .in .sp .BR fgetgrent (): -_SVID_SOURCE + Since glibc 2.19: + _DEFAULT_SOURCE + Glibc 2.19 and earlier: + _SVID_SOURCE .SH DESCRIPTION The .BR fgetgrent () @@ -122,11 +125,11 @@ .BR setgrent (3), .BR group (5) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/fgetpwent.3 manpages-4.05/man3/fgetpwent.3 --- manpages-4.04/man3/fgetpwent.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/fgetpwent.3 2016-03-15 03:47:40.000000000 +0000 @@ -30,7 +30,7 @@ .\" Modified Sat Jul 24 19:37:37 1993 by Rik Faith (faith@cs.unc.edu) .\" Modified Mon May 27 22:40:48 1996 by Martin Schulze (joey@linux.de) .\" -.TH FGETPWENT 3 2015-12-05 "GNU" "Linux Programmer's Manual" +.TH FGETPWENT 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME fgetpwent \- get password file entry .SH SYNOPSIS @@ -48,7 +48,10 @@ .in .sp .BR fgetpwent (): -_SVID_SOURCE + Since glibc 2.19: + _DEFAULT_SOURCE + Glibc 2.19 and earlier: + _SVID_SOURCE .SH DESCRIPTION The .BR fgetpwent () @@ -128,11 +131,11 @@ .BR setpwent (3), .BR passwd (5) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/fgetwc.3 manpages-4.05/man3/fgetwc.3 --- manpages-4.04/man3/fgetwc.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/fgetwc.3 2016-03-15 03:47:40.000000000 +0000 @@ -103,11 +103,11 @@ .BR ungetwc (3), .BR unlocked_stdio (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/fgetws.3 manpages-4.05/man3/fgetws.3 --- manpages-4.04/man3/fgetws.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/fgetws.3 2016-03-15 03:47:40.000000000 +0000 @@ -86,11 +86,11 @@ .BR fgetwc (3), .BR unlocked_stdio (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/finite.3 manpages-4.05/man3/finite.3 --- manpages-4.04/man3/finite.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/finite.3 2016-03-15 03:47:40.000000000 +0000 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH FINITE 3 2015-03-02 "" "Linux Programmer's Manual" +.TH FINITE 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME finite, finitef, finitel, isinf, isinff, isinfl, isnan, isnanf, isnanl \- BSD floating-point classification functions @@ -59,32 +59,34 @@ .BR finitef (), .BR finitel (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE +/* Glibc since 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .BR isinf (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE; -.br -or -.I cc\ -std=c99 +_XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE + || /* Glibc since 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .br .BR isinff (), .BR isinfl (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE +/* Glibc since 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .BR isnan (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE || _ISOC99_SOURCE; -.br -or -.I cc\ -std=c99 +_XOPEN_SOURCE || _ISOC99_SOURCE + || /* Glibc since 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .BR isnanf (), .BR isnanl (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 +_XOPEN_SOURCE\ >=\ 600 + || /* Glibc since 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .ad b .SH DESCRIPTION @@ -163,11 +165,11 @@ .SH SEE ALSO .BR fpclassify (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/flockfile.3 manpages-4.05/man3/flockfile.3 --- manpages-4.04/man3/flockfile.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/flockfile.3 2016-03-15 03:47:40.000000000 +0000 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH FLOCKFILE 3 2015-08-08 "" "Linux Programmer's Manual" +.TH FLOCKFILE 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME flockfile, ftrylockfile, funlockfile \- lock FILE for stdio .SH SYNOPSIS @@ -44,8 +44,8 @@ .sp All functions shown above: .RS 4 -_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _BSD_SOURCE || -_SVID_SOURCE || _POSIX_SOURCE +_POSIX_C_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .ad b .SH DESCRIPTION @@ -147,11 +147,11 @@ .SH SEE ALSO .BR unlocked_stdio (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/floor.3 manpages-4.05/man3/floor.3 --- manpages-4.04/man3/floor.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/floor.3 2016-03-15 03:47:40.000000000 +0000 @@ -24,7 +24,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH FLOOR 3 2015-04-19 "" "Linux Programmer's Manual" +.TH FLOOR 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME floor, floorf, floorl \- largest integral value not greater than argument .SH SYNOPSIS @@ -49,11 +49,9 @@ .BR floorf (), .BR floorl (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .ad .SH DESCRIPTION @@ -122,11 +120,11 @@ .BR round (3), .BR trunc (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/fma.3 manpages-4.05/man3/fma.3 --- manpages-4.04/man3/fma.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/fma.3 2016-03-15 03:47:40.000000000 +0000 @@ -9,7 +9,7 @@ .\" Modified 2004-11-15, Added further text on FLT_ROUNDS .\" as suggested by AEB and Fabian Kreutz .\" -.TH FMA 3 2015-04-19 "" "Linux Programmer's Manual" +.TH FMA 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME fma, fmaf, fmal \- floating-point multiply and add .SH SYNOPSIS @@ -35,11 +35,7 @@ .BR fmaf (), .BR fmal (): .RS 4 -_XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L .RE .ad .SH DESCRIPTION @@ -171,11 +167,11 @@ .BR remainder (3), .BR remquo (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/fmax.3 manpages-4.05/man3/fmax.3 --- manpages-4.04/man3/fmax.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/fmax.3 2016-03-15 03:47:40.000000000 +0000 @@ -6,7 +6,7 @@ .\" Distributed under GPL .\" %%%LICENSE_END .\" -.TH FMAX 3 2015-04-19 "" "Linux Programmer's Manual" +.TH FMAX 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME fmax, fmaxf, fmaxl \- determine maximum of two floating-point numbers .SH SYNOPSIS @@ -30,11 +30,7 @@ .BR fmaxf (), .BR fmaxl (): .RS 4 -_XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L .RE .ad .SH DESCRIPTION @@ -74,11 +70,11 @@ .SH SEE ALSO .BR fmin (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/fmemopen.3 manpages-4.05/man3/fmemopen.3 --- manpages-4.04/man3/fmemopen.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/fmemopen.3 2016-03-15 03:47:40.000000000 +0000 @@ -1,26 +1,17 @@ -.\" Copyright 2005 walter harms (walter.harms@informatik.uni-oldenburg.de), -.\" and Copyright 2005, 2012 Michael Kerrisk +.\" Copyright 2005, 2012, 2016 Michael Kerrisk .\" .\" %%%LICENSE_START(GPL_NOVERSION_ONELINE) .\" Distributed under the GPL. .\" %%%LICENSE_END .\" -.\" 2008-12-04, Petr Baudis : Document open_wmemstream() -.\" -.TH FMEMOPEN 3 2015-03-29 "GNU" "Linux Programmer's Manual" +.TH FMEMOPEN 3 2016-03-11 "GNU" "Linux Programmer's Manual" .SH NAME -fmemopen, open_memstream, open_wmemstream \- open memory as stream +fmemopen \- open memory as stream .SH SYNOPSIS .nf .B #include .BI "FILE *fmemopen(void *"buf ", size_t "size ", const char *" mode ");" - -.BI "FILE *open_memstream(char **" ptr ", size_t *" sizeloc ); - -.B #include - -.BI "FILE *open_wmemstream(wchar_t **" ptr ", size_t *" sizeloc ); .fi .sp .in -4n @@ -28,15 +19,13 @@ .BR feature_test_macros (7)): .in .sp -.BR fmemopen (), -.BR open_memstream (), -.BR open_wmemstream (): +.BR fmemopen (): .PD 0 .ad l .RS 4 .TP 4 Since glibc 2.10: -_XOPEN_SOURCE\ >=\ 700 || _POSIX_C_SOURCE\ >=\ 200809L +_POSIX_C_SOURCE\ >=\ 200809L .TP Before glibc 2.10: _GNU_SOURCE @@ -51,29 +40,67 @@ The stream allows I/O to be performed on the string or memory buffer pointed to by .IR buf . -This buffer must be at least -.I size -bytes long. -.PP -The argument + +The .I mode -is the same as for -.BR fopen (3). +argument specifies the semantics of I/O on the stream, +and is one of the following: +.TP 8 +.I r +The stream is opened for reading. +.TP +.I w +The stream is opened for writing. +.TP +.I a +Append; open the stream for writing, +with the initial buffer position set to the first null byte. +.TP +.I r+ +Open the stream for reading and writing. +.TP +.I w+ +Open the stream for reading and writing. +The buffer contents are truncated +(i.e., \(aq\\0\(aq is placed in the first byte of the buffer). +.TP +.I a+ +Append; open the stream for reading and writing, +with the initial buffer position set to the first null byte. +.PP +The stream maintains the notion of a current position, +the location where the next I/O operation will be performed. +The current position is implicitly updated by I/O operations. +It can be explicitly updated using +.BR fseek (3), +and determined using +.BR ftell (3). +In all modes other than append, +the initial position is set to the start of the buffer. +In append mode, if no null byte is found within the buffer, +then the initial position is +.IR size+1 . +.PP If -.I mode -specifies an append mode, then the initial file position is set to -the location of the first null byte (\(aq\\0\(aq) in the buffer; -otherwise the initial file position is set to the start of the buffer. -Since glibc 2.9, -the letter \(aqb\(aq may be specified as the second character in -.IR mode . -This provides "binary" mode: -writes don't implicitly add a terminating null byte, and -.BR fseek (3) -.B SEEK_END -is relative to the end of the buffer (i.e., the value specified by the +.I buf +is specified as NULL, then +.BR fmemopen () +allocates a buffer of .I size -argument), rather than the current string length. +bytes. +This is useful for an application that wants to write data to +a temporary buffer and then read it back again. +The initial position is set to the start of the buffer. +The buffer is automatically freed when the stream is closed. +Note that the caller has no way to obtain a pointer to the +temporary buffer allocated by this call (but see +.BR open_memstream (3)). +.PP +If +.I buf +is not NULL, then it should point to a buffer of at least +.I len +bytes allocated by the caller. .PP When a stream that has been opened for writing is flushed .RB ( fflush (3)) @@ -87,16 +114,29 @@ counts that byte) to allow for this. +In a stream opened for reading, +null bytes (\(aq\\0\(aq) in the buffer do not cause read +operations to return an end-of-file indication. +A read from the buffer will indicate end-of-file +only when the current buffer position advances +.I size +bytes past the start of the buffer. + +Write operations take place either at the current position +(for modes other than append), or at the current size of the stream +(for append modes). + Attempts to write more than .I size bytes to the buffer result in an error. -(By default, such errors will be visible only when the +By default, such errors will be visible +(by the absence of data) only when the .I stdio buffer is flushed. Disabling buffering with the following call may be useful to detect errors at the time of an output operation: - setbuf(stdream, NULL); + setbuf(stream, NULL); Alternatively, the caller can explicitly set .I buf @@ -104,86 +144,15 @@ of the buffer's size, using: setbuffer(stream, buf, size); - +.\" .\" See http://sourceware.org/bugzilla/show_bug.cgi?id=1995 .\" and .\" http://sources.redhat.com/ml/libc-alpha/2006-04/msg00064.html -.PP -In a stream opened for reading, -null bytes (\(aq\\0\(aq) in the buffer do not cause read -operations to return an end-of-file indication. -A read from the buffer will indicate end-of-file -only when the file pointer advances -.I size -bytes past the start of the buffer. -.PP -If -.I buf -is specified as NULL, then -.BR fmemopen () -dynamically allocates a buffer -.I size -bytes long. -This is useful for an application that wants to write data to -a temporary buffer and then read it back again. -The buffer is automatically freed when the stream is closed. -Note that the caller has no way to obtain a pointer to the -temporary buffer allocated by this call (but see -.BR open_memstream () -below). - -The -.BR open_memstream () -function opens a stream for writing to a buffer. -The buffer -is dynamically allocated (as with -.BR malloc (3)), -and automatically grows as required. -After closing the stream, the caller should -.BR free (3) -this buffer. - -When the stream is closed -.RB ( fclose (3)) -or flushed -.RB ( fflush (3)), -the locations pointed to by -.I ptr -and -.I sizeloc -are updated to contain, respectively, a pointer to the buffer and the -current size of the buffer. -These values remain valid only as long as the caller -performs no further output on the stream. -If further output is performed, then the stream -must again be flushed before trying to access these variables. - -A null byte is maintained at the end of the buffer. -This byte is -.I not -included in the size value stored at -.IR sizeloc . - -The stream's file position can be changed with -.BR fseek (3) -or -.BR fseeko (3). -Moving the file position past the end -of the data already written fills the intervening space with -zeros. - -The -.BR open_wmemstream () -is similar to -.BR open_memstream (), -but operates on wide characters instead of bytes. +.\" .SH RETURN VALUE -Upon successful completion -.BR fmemopen (), -.BR open_memstream () -and -.BR open_wmemstream () -return a +Upon successful completion, +.BR fmemopen () +returns a .I FILE pointer. Otherwise, NULL is returned and @@ -191,11 +160,7 @@ is set to indicate the error. .SH VERSIONS .BR fmemopen () -and -.BR open_memstream () -were already available in glibc 1.0.x. -.BR open_wmemstream () -is available since glibc 2.4. +was already available in glibc 1.0.x. .SH ATTRIBUTES For an explanation of the terms used in this section, see .BR attributes (7). @@ -205,18 +170,14 @@ l l l. Interface Attribute Value T{ -.BR fopenmem (), -.br -.BR open_memstream (), -.br -.BR open_wmemstream +.BR fmemopen (), T} Thread safety MT-Safe .TE .SH CONFORMING TO POSIX.1-2008. -These functions are not specified in POSIX.1-2001, -and are not widely available on other systems. +This function is not specified in POSIX.1-2001, +and is not widely available on other systems. POSIX.1-2008 specifies that \(aqb\(aq in .IR mode @@ -227,38 +188,68 @@ thus permitting the glibc treatment of \(aqb\(aq. .SH NOTES There is no file descriptor associated with the file stream -returned by these functions +returned by this function (i.e., .BR fileno (3) will return an error if called on the returned stream). -.SH BUGS -In glibc before version 2.7, seeking past the end of a stream created by -.BR open_memstream () -does not enlarge the buffer; instead the + +With version 2.22, binary mode (see below) was removed, +many longstanding bugs in the implementation of +.BR fmemopen () +were fixed, and a new versioned symbol was created for this interface. +.\" +.SS Binary mode +From version 2.9 to 2.21, the glibc implementation of +.BR fmemopen () +supported a "binary" mode, +enabled by specifying the letter \(aqb\(aq as the second character in +.IR mode . +In this mode, +writes don't implicitly add a terminating null byte, and .BR fseek (3) -call fails, returning \-1. -.\" http://sourceware.org/bugzilla/show_bug.cgi?id=1996 +.B SEEK_END +is relative to the end of the buffer (i.e., the value specified by the +.I size +argument), rather than the current string length. -If +An API bug afflicted the implementation of binary mode: +to specify binary mode, the \(aqb\(aq must be the +.I second +character in +.IR mode . +Thus, for example, "wb+" has the desired effect, but "w+b" does not. +This is inconsistent with the treatment of +.\" http://sourceware.org/bugzilla/show_bug.cgi?id=12836 +.IR mode +by +.BR fopen (3). + +Binary mode was removed in glibc 2.22; a \(aqb\(aq specified in +.I mode +has no effect. +.SH BUGS +In versions of glibc before 2.22, if .I size is specified as zero, .BR fmemopen () fails with the error .BR EINVAL . -.\" FIXME . http://sourceware.org/bugzilla/show_bug.cgi?id=11216 +.\" http://sourceware.org/bugzilla/show_bug.cgi?id=11216 It would be more consistent if this case successfully created -a stream that then returned end of file on the first attempt at reading. -Furthermore, POSIX.1-2008 does not specify a failure for this case. +a stream that then returned end-of-file on the first attempt at reading; +since version 2.22, the glibc implementation provides that behavior. -Specifying append mode ("a" or "a+") for +In versions of glibc before 2.22, +specifying append mode ("a" or "a+") for .BR fmemopen () -sets the initial file position to the first null byte, but -.\" FIXME . http://sourceware.org/bugzilla/show_bug.cgi?id=13152 -(if the file offset is reset to a location other than +sets the initial buffer position to the first null byte, but +.\" http://sourceware.org/bugzilla/show_bug.cgi?id=13152 +(if the current position is reset to a location other than the end of the stream) does not force subsequent writes to append at the end of the stream. +This bug is fixed in glibc 2.22. -If the +In versions of glibc before 2.22, if the .I mode argument to .BR fmemopen () @@ -267,25 +258,30 @@ argument does not cover a null byte in .IR buf , then, according to POSIX.1-2008, -the initial file position should be set to +the initial buffer position should be set to the next byte after the end of the buffer. However, in this case the glibc -.\" FIXME . http://sourceware.org/bugzilla/show_bug.cgi?id=13151 +.\" http://sourceware.org/bugzilla/show_bug.cgi?id=13151 .BR fmemopen () -sets the file position to \-1. +sets the buffer position to \-1. +This bug is fixed in glibc 2.22. -To specify binary mode for -.BR fmemopen () -the \(aqb\(aq must be the -.I second -character in -.IR mode . -Thus, for example, "wb+" has the desired effect, but "w+b" does not. -This is inconsistent with the treatment of -.\" FIXME . http://sourceware.org/bugzilla/show_bug.cgi?id=12836 -.IR mode -by -.BR fopen (3). +In versions of glibc before 2.22, +.\" https://sourceware.org/bugzilla/show_bug.cgi?id=14292 +when a call to +.BR fseek (3) +with a +.I whence +value of +.B SEEK_END +was performed on a stream created by +.BR fmemopen (), +the +.I offset +was +.IR subtracted +from the end-of-stream position, instead of being added. +This bug is fixed in glibc 2.22. The glibc 2.9 addition of "binary" mode for .BR fmemopen () @@ -298,7 +294,7 @@ The program below uses .BR fmemopen () to open an input buffer, and -.BR open_memstream () +.BR open_memstream (3) to open a dynamically sized output buffer. The program scans its input string (taken from the program's first command-line argument) reading integers, @@ -331,7 +327,7 @@ char *ptr; if (argc != 2) { - fprintf(stderr, "Usage: %s \\n", argv[0]); + fprintf(stderr, "Usage: %s \(aq...\(aq\\n", argv[0]); exit(EXIT_FAILURE); } @@ -352,22 +348,26 @@ if (s == \-1) handle_error("fprintf"); } + fclose(in); fclose(out); + printf("size=%zu; ptr=%s\\n", size, ptr); + free(ptr); exit(EXIT_SUCCESS); } .fi .SH SEE ALSO .BR fopen (3), -.BR fopencookie (3) +.BR fopencookie (3), +.BR open_memstream (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/fmin.3 manpages-4.05/man3/fmin.3 --- manpages-4.04/man3/fmin.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/fmin.3 2016-03-15 03:47:40.000000000 +0000 @@ -6,7 +6,7 @@ .\" Distributed under GPL .\" %%%LICENSE_END .\" -.TH FMIN 3 2015-04-19 "" "Linux Programmer's Manual" +.TH FMIN 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME fmin, fminf, fminl \- determine minimum of two floating-point numbers .SH SYNOPSIS @@ -30,11 +30,7 @@ .BR fminf (), .BR fminl (): .RS 4 -_XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L .RE .ad .SH DESCRIPTION @@ -74,11 +70,11 @@ .SH SEE ALSO .BR fmax (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/fmod.3 manpages-4.05/man3/fmod.3 --- manpages-4.04/man3/fmod.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/fmod.3 2016-03-15 03:47:40.000000000 +0000 @@ -32,7 +32,7 @@ .\" Modified 2002-07-27 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.TH FMOD 3 2015-04-19 "" "Linux Programmer's Manual" +.TH FMOD 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME fmod, fmodf, fmodl \- floating-point remainder function .SH SYNOPSIS @@ -57,11 +57,9 @@ .BR fmodf (), .BR fmodl (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .ad .SH DESCRIPTION @@ -173,11 +171,11 @@ .SH SEE ALSO .BR remainder (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/fmtmsg.3 manpages-4.05/man3/fmtmsg.3 --- manpages-4.04/man3/fmtmsg.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/fmtmsg.3 2016-03-15 03:47:40.000000000 +0000 @@ -326,11 +326,11 @@ .BR addseverity (3), .BR perror (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/fnmatch.3 manpages-4.05/man3/fnmatch.3 --- manpages-4.04/man3/fnmatch.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/fnmatch.3 2016-03-15 03:47:40.000000000 +0000 @@ -143,11 +143,11 @@ .BR wordexp (3), .BR glob (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/fopen.3 manpages-4.05/man3/fopen.3 --- manpages-4.04/man3/fopen.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/fopen.3 2016-03-15 03:47:40.000000000 +0000 @@ -41,7 +41,7 @@ .\" Modified, aeb, 960421, 970806 .\" Modified, joey, aeb, 2002-01-03 .\" -.TH FOPEN 3 2015-08-08 "GNU" "Linux Programmer's Manual" +.TH FOPEN 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME fopen, fdopen, freopen \- stream open functions .SH SYNOPSIS @@ -61,7 +61,7 @@ .in .sp .BR fdopen (): -_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _POSIX_SOURCE +_POSIX_C_SOURCE .SH DESCRIPTION The .BR fopen () @@ -362,13 +362,14 @@ .BR fclose (3), .BR fileno (3), .BR fmemopen (3), -.BR fopencookie (3) +.BR fopencookie (3), +.BR open_memstream (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/fopencookie.3 manpages-4.05/man3/fopencookie.3 --- manpages-4.04/man3/fopencookie.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/fopencookie.3 2016-03-15 03:47:40.000000000 +0000 @@ -452,11 +452,11 @@ .BR fopen (3), .BR fseek (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/fpathconf.3 manpages-4.05/man3/fpathconf.3 --- manpages-4.04/man3/fpathconf.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/fpathconf.3 2016-03-15 03:47:40.000000000 +0000 @@ -198,11 +198,11 @@ .BR confstr (3), .BR sysconf (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/fpclassify.3 manpages-4.05/man3/fpclassify.3 --- manpages-4.04/man3/fpclassify.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/fpclassify.3 2016-03-15 03:47:40.000000000 +0000 @@ -7,7 +7,7 @@ .\" This was done with the help of the glibc manual. .\" .\" 2004-10-31, aeb, corrected -.TH FPCLASSIFY 3 2015-08-08 "" "Linux Programmer's Manual" +.TH FPCLASSIFY 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME fpclassify, isfinite, isnormal, isnan, isinf \- floating-point classification macros @@ -40,27 +40,20 @@ .BR isfinite (), .BR isnormal (): .RS 4 -_XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L .RE .BR isnan (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || _XOPEN_SOURCE + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .BR isinf (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .ad .SH DESCRIPTION @@ -153,11 +146,11 @@ .BR isgreater (3), .BR signbit (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/fpurge.3 manpages-4.05/man3/fpurge.3 --- manpages-4.04/man3/fpurge.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/fpurge.3 2016-03-15 03:47:40.000000000 +0000 @@ -96,11 +96,11 @@ .BR setbuf (3), .BR stdio_ext (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/fputwc.3 manpages-4.05/man3/fputwc.3 --- manpages-4.04/man3/fputwc.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/fputwc.3 2016-03-15 03:47:40.000000000 +0000 @@ -101,11 +101,11 @@ .BR fputws (3), .BR unlocked_stdio (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/fputws.3 manpages-4.05/man3/fputws.3 --- manpages-4.04/man3/fputws.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/fputws.3 2016-03-15 03:47:40.000000000 +0000 @@ -74,11 +74,11 @@ .BR fputwc (3), .BR unlocked_stdio (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/fread.3 manpages-4.05/man3/fread.3 --- manpages-4.04/man3/fread.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/fread.3 2016-03-15 03:47:40.000000000 +0000 @@ -120,11 +120,11 @@ .BR ferror (3), .BR unlocked_stdio (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/frexp.3 manpages-4.05/man3/frexp.3 --- manpages-4.04/man3/frexp.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/frexp.3 2016-03-15 03:47:40.000000000 +0000 @@ -30,7 +30,7 @@ .\" Modified 2002-07-27 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.TH FREXP 3 2015-04-19 "" "Linux Programmer's Manual" +.TH FREXP 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME frexp, frexpf, frexpl \- convert floating-point number to fractional and integral components @@ -56,11 +56,9 @@ .BR frexpf (), .BR frexpl (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .ad .SH DESCRIPTION @@ -159,11 +157,11 @@ .BR ldexp (3), .BR modf (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/fseek.3 manpages-4.05/man3/fseek.3 --- manpages-4.04/man3/fseek.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/fseek.3 2016-03-15 03:47:40.000000000 +0000 @@ -190,11 +190,11 @@ .BR lseek (2), .BR fseeko (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/fseeko.3 manpages-4.05/man3/fseeko.3 --- manpages-4.04/man3/fseeko.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/fseeko.3 2016-03-15 03:47:40.000000000 +0000 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH FSEEKO 3 2015-08-08 "" "Linux Programmer's Manual" +.TH FSEEKO 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME fseeko, ftello \- seek to or report file position .SH SYNOPSIS @@ -45,8 +45,7 @@ .br .RS 4 .ad l -_FILE_OFFSET_BITS\ ==\ 64 || -_POSIX_C_SOURCE\ >=\ 200112L || _XOPEN_SOURCE\ >=\ 600 +_FILE_OFFSET_BITS\ ==\ 64 || _POSIX_C_SOURCE\ >=\ 200112L .br (defining the obsolete _LARGEFILE_SOURCE macro also works) .RE @@ -118,11 +117,11 @@ .SH SEE ALSO .BR fseek (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/ftime.3 manpages-4.05/man3/ftime.3 --- manpages-4.04/man3/ftime.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/ftime.3 2016-03-15 03:47:40.000000000 +0000 @@ -108,11 +108,11 @@ .BR gettimeofday (2), .BR time (2) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/ftok.3 manpages-4.05/man3/ftok.3 --- manpages-4.04/man3/ftok.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/ftok.3 2016-03-15 03:47:40.000000000 +0000 @@ -117,11 +117,11 @@ .BR stat (2), .BR svipc (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/fts.3 manpages-4.05/man3/fts.3 --- manpages-4.04/man3/fts.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/fts.3 2016-03-15 03:47:40.000000000 +0000 @@ -37,7 +37,7 @@ .\" .\" 2007-12-08, mtk, Converted from mdoc to man macros .\" -.TH FTS 3 2015-07-23 "Linux" "Linux Programmer's Manual" +.TH FTS 3 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME fts, fts_open, fts_read, fts_children, fts_set, fts_close \- \ traverse a file hierarchy @@ -794,11 +794,14 @@ .SH CONFORMING TO 4.4BSD. .SH BUGS -All of the APIs described in this man page are not safe when compiling -a program using the LFS APIs (e.g., when compiling with -.IR -D_FILE_OFFSET_BITS=64 ). +In versions of glibc before 2.23, +.\" Fixed by commit 8b7b7f75d91f7bac323dd6a370aeb3e9c5c4a7d5 .\" https://sourceware.org/bugzilla/show_bug.cgi?id=15838 .\" https://sourceware.org/bugzilla/show_bug.cgi?id=11460 +all of the APIs described in this man page are not safe when compiling +a program using the LFS APIs (e.g., when compiling with +.IR -D_FILE_OFFSET_BITS=64 ). +.\" .\" The following statement is years old, and seems no closer to .\" being true -- mtk .\" The @@ -813,11 +816,11 @@ .BR ftw (3), .BR qsort (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/ftw.3 manpages-4.05/man3/ftw.3 --- manpages-4.04/man3/ftw.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/ftw.3 2016-03-15 03:47:40.000000000 +0000 @@ -454,11 +454,11 @@ .BR fts (3), .BR readdir (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/futimes.3 manpages-4.05/man3/futimes.3 --- manpages-4.04/man3/futimes.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/futimes.3 2016-03-15 03:47:40.000000000 +0000 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH FUTIMES 3 2015-03-02 "Linux" "Linux Programmer's Manual" +.TH FUTIMES 3 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME futimes, lutimes \- change file timestamps .SH SYNOPSIS @@ -41,7 +41,10 @@ .sp .BR futimes (), .BR lutimes (): -_BSD_SOURCE + Since glibc 2.19: + _DEFAULT_SOURCE + Glibc 2.19 and earlier: + _BSD_SOURCE .SH DESCRIPTION .BR futimes () changes the access and modification times of a file in the same way as @@ -111,11 +114,11 @@ .BR utimensat (2), .BR symlink (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/fwide.3 manpages-4.05/man3/fwide.3 --- manpages-4.04/man3/fwide.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/fwide.3 2016-03-15 03:47:40.000000000 +0000 @@ -13,7 +13,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH FWIDE 3 2015-08-08 "GNU" "Linux Programmer's Manual" +.TH FWIDE 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME fwide \- set and determine the orientation of a FILE stream .SH SYNOPSIS @@ -33,10 +33,7 @@ .RS 4 _XOPEN_SOURCE\ >=\ 500 || _ISOC99_SOURCE || .br -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_POSIX_C_SOURCE\ >=\ 200112L .RE .ad .SH DESCRIPTION @@ -97,11 +94,11 @@ .BR fprintf (3), .BR fwprintf (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/gamma.3 manpages-4.05/man3/gamma.3 --- manpages-4.04/man3/gamma.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/gamma.3 2016-03-15 03:47:40.000000000 +0000 @@ -6,7 +6,7 @@ .\" .\" Modified 2003-11-18, aeb: historical remarks .\" -.TH GAMMA 3 2015-03-02 "GNU" "Linux Programmer's Manual" +.TH GAMMA 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME gamma, gammaf, gammal \- (logarithm of the) gamma function .SH SYNOPSIS @@ -28,13 +28,16 @@ .ad l .BR gamma (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE +_XOPEN_SOURCE + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .BR gammaf (), .BR gammal (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 -.\" Also seems to work: -std=c99 -D_XOPEN_SOURCE +_XOPEN_SOURCE >= 600 || (_XOPEN_SOURCE && _ISOC99_SOURCE) + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .ad b .SH DESCRIPTION @@ -78,7 +81,8 @@ .TE .SH CONFORMING TO Because of historical variations in behavior across systems, -this function is not specified in any standard. +this function is not specified in any recent standard. +It was documented in SVID 2. .SH NOTES .SS History 4.2BSD had a @@ -113,11 +117,11 @@ .BR signgam (3), .BR tgamma (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/gcvt.3 manpages-4.05/man3/gcvt.3 --- manpages-4.04/man3/gcvt.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/gcvt.3 2016-03-15 03:47:40.000000000 +0000 @@ -27,7 +27,7 @@ .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified Sat Jul 24 19:32:25 1993 by Rik Faith (faith@cs.unc.edu) -.TH GCVT 3 2015-03-29 "" "Linux Programmer's Manual" +.TH GCVT 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME gcvt \- convert a floating-point number to a string .SH SYNOPSIS @@ -49,15 +49,14 @@ .TP 4 Since glibc 2.12: .nf -_SVID_SOURCE || - (_XOPEN_SOURCE\ >=\ 500 || - _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED) && - !(_POSIX_C_SOURCE\ >=\ 200112L || _XOPEN_SOURCE\ >=\ 600) +(_XOPEN_SOURCE\ >=\ 500) ! (_POSIX_C_SOURCE\ >=\ 200112L) + || /* Glibc since 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _SVID_SOURCE .fi .TP 4 Before glibc 2.12: -_SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 || -_XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED +_SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 +.\" || _XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED .RE .PD .ad b @@ -101,11 +100,11 @@ .BR fcvt (3), .BR sprintf (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/getaddrinfo.3 manpages-4.05/man3/getaddrinfo.3 --- manpages-4.04/man3/getaddrinfo.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/getaddrinfo.3 2016-03-15 03:47:40.000000000 +0000 @@ -41,7 +41,7 @@ .\" FIXME . glibc's 2.9 NEWS file documents DCCP and UDP-lite support .\" and is SCTP support now also there? .\" -.TH GETADDRINFO 3 2015-07-23 "GNU" "Linux Programmer's Manual" +.TH GETADDRINFO 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME getaddrinfo, freeaddrinfo, gai_strerror \- network address and service translation @@ -69,9 +69,8 @@ .BR getaddrinfo (), .BR freeaddrinfo (), .BR gai_strerror (): -.RS 4 -_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _POSIX_SOURCE -.RE + Since glibc 2.22: _POSIX_C_SOURCE >= 201112L + Glibc 2.21 and earlier: _POSIX_C_SOURCE .ad b .SH DESCRIPTION Given @@ -232,7 +231,7 @@ .BR IN6ADDR_ANY_INIT for IPv6 address). The wildcard address is used by applications (typically servers) -that intend to accept connections on any of the hosts's network addresses. +that intend to accept connections on any of the host's network addresses. If .I node is not NULL, then the @@ -854,11 +853,11 @@ .BR hostname (7), .BR ip (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/getaddrinfo_a.3 manpages-4.05/man3/getaddrinfo_a.3 --- manpages-4.04/man3/getaddrinfo_a.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/getaddrinfo_a.3 2016-03-15 03:47:40.000000000 +0000 @@ -621,11 +621,11 @@ .BR ip (7), .BR sigevent (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/getauxval.3 manpages-4.05/man3/getauxval.3 --- manpages-4.04/man3/getauxval.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/getauxval.3 2016-03-15 03:47:40.000000000 +0000 @@ -247,11 +247,11 @@ .BR vdso (7), .BR ld-linux.so (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/getcontext.3 manpages-4.05/man3/getcontext.3 --- manpages-4.04/man3/getcontext.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/getcontext.3 2016-03-15 03:47:40.000000000 +0000 @@ -205,11 +205,11 @@ .BR makecontext (3), .BR sigsetjmp (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/getcwd.3 manpages-4.05/man3/getcwd.3 --- manpages-4.04/man3/getcwd.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/getcwd.3 2016-03-15 03:47:40.000000000 +0000 @@ -29,7 +29,7 @@ .\" Modified Mon Dec 11 13:32:51 MET 2000 by aeb .\" Modified Thu Apr 22 03:49:15 CEST 2002 by Roger Luethi .\" -.TH GETCWD 3 2015-04-19 "GNU" "Linux Programmer's Manual" +.TH GETCWD 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME getcwd, getwd, get_current_dir_name \- get current working directory .SH SYNOPSIS @@ -60,15 +60,14 @@ .TP 4 Since glibc 2.12: .nf -_BSD_SOURCE || - (_XOPEN_SOURCE\ >=\ 500 || - _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED) && - !(_POSIX_C_SOURCE\ >=\ 200809L || _XOPEN_SOURCE\ >=\ 700) +(_XOPEN_SOURCE\ >=\ 500) && ! (_POSIX_C_SOURCE\ >=\ 200809L) + || /* Glibc since 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE .TP 4 .fi Before glibc 2.12: -_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 || -_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED +_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 +.\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED .PD .RE .ad b @@ -280,6 +279,7 @@ to return is usually a faster and more reliable alternative when sufficiently many file descriptors are available, especially on platforms other than Linux. .SH SEE ALSO +.BR pwd (1), .BR chdir (2), .BR fchdir (2), .BR open (2), @@ -287,11 +287,11 @@ .BR free (3), .BR malloc (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/getdate.3 manpages-4.05/man3/getdate.3 --- manpages-4.04/man3/getdate.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/getdate.3 2016-03-15 03:47:40.000000000 +0000 @@ -27,7 +27,7 @@ .\" Modified, 2001-12-26, aeb .\" 2008-09-07, mtk, Various rewrites; added an example program. .\" -.TH GETDATE 3 2015-08-08 "" "Linux Programmer's Manual" +.TH GETDATE 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME getdate, getdate_r \- convert a date-plus-time string to broken-down time .SH SYNOPSIS @@ -49,8 +49,8 @@ .BR getdate (): .ad l .RS 4 -_XOPEN_SOURCE\ >=\ 500 || -_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED +_XOPEN_SOURCE\ >=\ 500 +.\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED .RE .br .BR getdate_r (): @@ -323,11 +323,11 @@ .BR strftime (3), .BR strptime (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/getdirentries.3 manpages-4.05/man3/getdirentries.3 --- manpages-4.04/man3/getdirentries.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/getdirentries.3 2016-03-15 03:47:40.000000000 +0000 @@ -24,7 +24,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH GETDIRENTRIES 3 2015-03-02 "GNU" "Linux Programmer's Manual" +.TH GETDIRENTRIES 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME getdirentries \- get directory entries in a filesystem-independent format .SH SYNOPSIS @@ -39,7 +39,10 @@ .in .sp .BR getdirentries (): -_BSD_SOURCE || _SVID_SOURCE + Since glibc 2.19: + _DEFAULT_SOURCE + Glibc 2.19 and earlier: + _BSD_SOURCE || _SVID_SOURCE .SH DESCRIPTION Read directory entries from the directory specified by .I fd @@ -85,11 +88,11 @@ .BR lseek (2), .BR open (2) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/getdtablesize.3 manpages-4.05/man3/getdtablesize.3 --- manpages-4.04/man3/getdtablesize.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/getdtablesize.3 2016-03-15 03:47:40.000000000 +0000 @@ -24,9 +24,9 @@ .\" .\" Modified 2002-04-15 by Roger Luethi and aeb .\" -.TH GETDTABLESIZE 3 2015-03-02 "Linux" "Linux Programmer's Manual" +.TH GETDTABLESIZE 3 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME -getdtablesize \- get descriptor table size +getdtablesize \- get file descriptor table size .SH SYNOPSIS .B #include .sp @@ -44,13 +44,14 @@ .TP 4 Since glibc 2.12: .nf -_BSD_SOURCE || - !(_POSIX_C_SOURCE\ >=\ 200112L || _XOPEN_SOURCE\ >=\ 600) +/* Glibc since 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE + || ! (_POSIX_C_SOURCE\ >=\ 200112L) .TP 4 .fi Before glibc 2.12: -_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 || -_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED +_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 +.\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED .PD .RE .ad b @@ -105,11 +106,11 @@ .BR getrlimit (2), .BR open (2) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/getenv.3 manpages-4.05/man3/getenv.3 --- manpages-4.04/man3/getenv.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/getenv.3 2016-03-15 03:47:40.000000000 +0000 @@ -148,11 +148,11 @@ .BR capabilities (7), .BR environ (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/getfsent.3 manpages-4.05/man3/getfsent.3 --- manpages-4.04/man3/getfsent.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/getfsent.3 2016-03-15 03:47:40.000000000 +0000 @@ -161,11 +161,11 @@ .BR getmntent (3), .BR fstab (5) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/getgrent.3 manpages-4.05/man3/getgrent.3 --- manpages-4.04/man3/getgrent.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/getgrent.3 2016-03-15 03:47:40.000000000 +0000 @@ -27,7 +27,7 @@ .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified Sat Jul 24 19:29:54 1993 by Rik Faith (faith@cs.unc.edu) -.TH GETGRENT 3 2015-12-28 "" "Linux Programmer's Manual" +.TH GETGRENT 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME getgrent, setgrent, endgrent \- get group file entry .SH SYNOPSIS @@ -51,17 +51,19 @@ .ad l .BR setgrent (): .RS 4 -_SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 || -_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED || -.br -/* Since glibc 2.12: */ _POSIX_C_SOURCE\ >=\ 200809L +_XOPEN_SOURCE\ >=\ 500 +.\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED + || /* Glibc since 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .sp .BR getgrent (), .BR endgrent (): .RS 4 -_SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 || -_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED +_XOPEN_SOURCE\ >=\ 500 +.\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED + || /* Since glibc 2.12: */ _POSIX_C_SOURCE\ >=\ 200809L + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .PD .ad b @@ -135,7 +137,8 @@ The error may correct itself, retrying later is suggested. .TP .B EINTR -A signal was caught. +A signal was caught; see +.BR signal (7). .TP .B EIO I/O error. @@ -206,11 +209,11 @@ .BR putgrent (3), .BR group (5) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/getgrent_r.3 manpages-4.05/man3/getgrent_r.3 --- manpages-4.04/man3/getgrent_r.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/getgrent_r.3 2016-03-15 03:47:40.000000000 +0000 @@ -21,7 +21,7 @@ .\" . .\" %%%LICENSE_END .\" -.TH GETGRENT_R 3 2015-07-23 "GNU" "Linux Programmer's Manual" +.TH GETGRENT_R 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME getgrent_r, fgetgrent_r \- get group file entry reentrantly .SH SYNOPSIS @@ -47,7 +47,10 @@ .\" FIXME . The FTM requirements seem inconsistent here. File a glibc bug? .br .BR fgetgrent_r (): -_SVID_SOURCE + Since glibc 2.19: + _DEFAULT_SOURCE + Glibc 2.19 and earlier: + _SVID_SOURCE .SH DESCRIPTION The functions .BR getgrent_r () @@ -217,11 +220,11 @@ .BR putgrent (3), .BR group (5) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/getgrnam.3 manpages-4.05/man3/getgrnam.3 --- manpages-4.04/man3/getgrnam.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/getgrnam.3 2016-03-15 03:47:40.000000000 +0000 @@ -30,7 +30,7 @@ .\" Modified 1993-07-24 by Rik Faith (faith@cs.unc.edu) .\" Modified 2003-11-15 by aeb .\" -.TH GETGRNAM 3 2015-12-28 "" "Linux Programmer's Manual" +.TH GETGRNAM 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME getgrnam, getgrnam_r, getgrgid, getgrgid_r \- get group file entry .SH SYNOPSIS @@ -60,8 +60,8 @@ .BR getgrnam_r (), .BR getgrgid_r (): .RS 4 -_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _BSD_SOURCE || -_SVID_SOURCE || _POSIX_SOURCE +_POSIX_C_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .ad b .SH DESCRIPTION @@ -182,7 +182,8 @@ was not found. .TP .B EINTR -A signal was caught. +A signal was caught; see +.BR signal (7). .TP .B EIO I/O error. @@ -258,11 +259,11 @@ .BR setgrent (3), .BR group (5) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/getgrouplist.3 manpages-4.05/man3/getgrouplist.3 --- manpages-4.04/man3/getgrouplist.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/getgrouplist.3 2016-03-15 03:47:40.000000000 +0000 @@ -26,7 +26,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH GETGROUPLIST 3 2015-03-02 "GNU" "Linux Programmer's Manual" +.TH GETGROUPLIST 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME getgrouplist \- get list of groups to which a user belongs .SH SYNOPSIS @@ -42,7 +42,10 @@ .in .sp .BR getgrouplist (): -_BSD_SOURCE + Since glibc 2.19: + _DEFAULT_SOURCE + Glibc 2.19 and earlier: + _BSD_SOURCE .SH DESCRIPTION The .BR getgrouplist () @@ -206,11 +209,11 @@ .BR group (5), .BR passwd (5) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/gethostbyname.3 manpages-4.05/man3/gethostbyname.3 --- manpages-4.04/man3/gethostbyname.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/gethostbyname.3 2016-03-15 03:47:40.000000000 +0000 @@ -35,7 +35,7 @@ .\" Modified 2002-08-05, Michael Kerrisk .\" Modified 2004-10-31, Andries Brouwer .\" -.TH GETHOSTBYNAME 3 2015-07-23 "" "Linux Programmer's Manual" +.TH GETHOSTBYNAME 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME gethostbyname, gethostbyaddr, sethostent, gethostent, endhostent, h_errno, @@ -100,6 +100,11 @@ .BR gethostbyname_r (), .BR gethostbyname2_r (): .RS 4 +.TP 4 +Since glibc 2.19: +_DEFAULT_SOURCE +.TP 4 +Glibc versions up to and including 2.19: _BSD_SOURCE || _SVID_SOURCE .RE @@ -107,7 +112,10 @@ .BR hstrerror (): .RS 4 .TP 4 -Since glibc 2.8: +Since glibc 2.19: +_DEFAULT_SOURCE +.TP 4 +Glibc 2.8 to 2.19: _BSD_SOURCE || _SVID_SOURCE .TP Before glibc 2.8: @@ -117,9 +125,11 @@ .BR h_errno : .RS 4 .TP 4 -Since glibc 2.12: -_BSD_SOURCE || _SVID_SOURCE || - (_POSIX_C_SOURCE < 200809L && _XOPEN_SOURCE < 700) +Since glibc 2.19 +_DEFAULT_SOURCE || _POSIX_C_SOURCE < 200809L +.TP 4 +Glibc 2.12 to 2.19: +_BSD_SOURCE || _SVID_SOURCE || _POSIX_C_SOURCE < 200809L .TP Before glibc 2.12: none @@ -230,7 +240,7 @@ .RB ( nsswitch.conf(5)) configured sources, failing that, a local name server .RB ( named (8)). - +.\" .SS Historical The .BR nsswitch.conf (5) @@ -538,11 +548,11 @@ .BR named (8) .\" .BR resolv+ (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/gethostid.3 manpages-4.05/man3/gethostid.3 --- manpages-4.04/man3/gethostid.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/gethostid.3 2016-03-15 03:47:40.000000000 +0000 @@ -26,7 +26,7 @@ .\" %%%LICENSE_END .\" .\" Modified Tue Oct 22 00:22:35 EDT 1996 by Eric S. Raymond -.TH GETHOSTID 3 2015-08-08 "Linux" "Linux Programmer's Manual" +.TH GETHOSTID 3 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME gethostid, sethostid \- get or set the unique identifier of the current host .SH SYNOPSIS @@ -45,13 +45,19 @@ .br .BR gethostid (): .RS 4 -_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 || -_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED +_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 +.\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED .RE .BR sethostid (): -.RS 4 -_BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE\ <\ 500) -.RE +.nf + Since glibc 2.21: +.\" commit 266865c0e7b79d4196e2cc393693463f03c90bd8 + _DEFAULT_SOURCE + In glibc 2.19 and 2.20: + _DEFAULT_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE\ <\ 500) + Up to and including glibc 2.19: + _BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE\ <\ 500) +.fi .ad b .SH DESCRIPTION .BR gethostid () @@ -142,11 +148,11 @@ .BR hostid (1), .BR gethostbyname (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/getifaddrs.3 manpages-4.05/man3/getifaddrs.3 --- manpages-4.04/man3/getifaddrs.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/getifaddrs.3 2016-03-15 03:47:40.000000000 +0000 @@ -327,11 +327,11 @@ .BR packet (7), .BR ifconfig (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/getipnodebyname.3 manpages-4.05/man3/getipnodebyname.3 --- manpages-4.04/man3/getipnodebyname.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/getipnodebyname.3 2016-03-15 03:47:40.000000000 +0000 @@ -269,11 +269,11 @@ .BR inet_ntop (3), .BR inet_pton (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/getline.3 manpages-4.05/man3/getline.3 --- manpages-4.04/man3/getline.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/getline.3 2016-03-15 03:47:40.000000000 +0000 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH GETLINE 3 2015-03-29 "GNU" "Linux Programmer's Manual" +.TH GETLINE 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME getline, getdelim \- delimited string input .SH SYNOPSIS @@ -48,7 +48,7 @@ .RS 4 .TP 4 Since glibc 2.10: -_POSIX_C_SOURCE\ >=\ 200809L || _XOPEN_SOURCE\ >=\ 700 +_POSIX_C_SOURCE\ >=\ 200809L .TP Before glibc 2.10: _GNU_SOURCE @@ -190,11 +190,11 @@ .BR fread (3), .BR scanf (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/getloadavg.3 manpages-4.05/man3/getloadavg.3 --- manpages-4.04/man3/getloadavg.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/getloadavg.3 2016-03-15 03:47:40.000000000 +0000 @@ -31,16 +31,28 @@ .\" .\" 2007-12-08, mtk, Converted from mdoc to man macros .\" -.TH GETLOADAVG 3 2015-03-02 "Linux" "Linux Programmer's Manual" +.TH GETLOADAVG 3 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME getloadavg \- get system load averages .SH SYNOPSIS .nf -.BR "#define _BSD_SOURCE" " /* See feature_test_macros(7) */" .B #include .sp .BI "int getloadavg(double " loadavg[] ", int " nelem ); .fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR getloadavg (): +.nf + Since glibc 2.19: + _DEFAULT_SOURCE + In glibc up to and including 2.19: + _BSD_SOURCE +.fi .SH DESCRIPTION The .BR getloadavg () @@ -82,11 +94,11 @@ .BR uptime (1), .BR proc (5) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/getlogin.3 manpages-4.05/man3/getlogin.3 --- manpages-4.04/man3/getlogin.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/getlogin.3 2016-03-15 03:47:40.000000000 +0000 @@ -240,11 +240,11 @@ .BR getuid (2), .BR utmp (5) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/getmntent.3 manpages-4.05/man3/getmntent.3 --- manpages-4.04/man3/getmntent.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/getmntent.3 2016-03-15 03:47:40.000000000 +0000 @@ -29,7 +29,7 @@ .\" Modified Sat Jul 24 21:46:57 1993 by Rik Faith (faith@cs.unc.edu) .\" Modified 961109, 031115, aeb .\" -.TH GETMNTENT 3 2015-05-07 "" "Linux Programmer's Manual" +.TH GETMNTENT 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME getmntent, setmntent, addmntent, endmntent, hasmntopt, getmntent_r \- get filesystem descriptor file entry @@ -61,7 +61,10 @@ .in .sp .BR getmntent_r (): -_BSD_SOURCE || _SVID_SOURCE + Since glibc 2.19: + _DEFAULT_SOURCE + Glibc 2.19 and earlier: + _BSD_SOURCE || _SVID_SOURCE .SH DESCRIPTION These routines are used to access the filesystem description file .I /etc/fstab @@ -246,11 +249,11 @@ .BR fstab (5), .BR mount (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/getnameinfo.3 manpages-4.05/man3/getnameinfo.3 --- manpages-4.04/man3/getnameinfo.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/getnameinfo.3 2016-03-15 03:47:40.000000000 +0000 @@ -7,7 +7,7 @@ .\" 2004-12-14, mtk, Added EAI_OVERFLOW error .\" 2004-12-14 Fixed description of error return .\" -.TH GETNAMEINFO 3 2015-07-23 "GNU" "Linux Programmer's Manual" +.TH GETNAMEINFO 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME getnameinfo \- address-to-name translation in protocol-independent manner .SH SYNOPSIS @@ -15,7 +15,7 @@ .B #include .B #include .sp -.BI "int getnameinfo(const struct sockaddr *" "sa" ", socklen_t " "salen" , +.BI "int getnameinfo(const struct sockaddr *" "addr" ", socklen_t " "addrlen" , .BI " char *" "host" ", socklen_t " "hostlen" , .BI " char *" "serv" ", socklen_t " "servlen" ", int " "flags" ); .fi @@ -27,7 +27,8 @@ .in .sp .BR getnameinfo (): -_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _POSIX_SOURCE + Since glibc 2.22: _POSIX_C_SOURCE >= 201112L + Glibc 2.21 and earlier: _POSIX_C_SOURCE .ad b .SH DESCRIPTION The @@ -53,7 +54,7 @@ or .IR sockaddr_in6 ) of size -.I salen +.I addrlen that holds the input IP address and port number. The arguments .I host @@ -232,12 +233,15 @@ .in Since glibc 2.8, -these definitions are exposed only if one of the feature test macros -.BR _BSD_SOURCE , -.BR _SVID_SOURCE , +these definitions are exposed only if suitable +feature test macros are defined, namely: +.BR _GNU_SOURCE , +.BR _DEFAULT_SOURCE +(since glibc 2.19), +or (in glibc versions up to and including 2.19) +.BR _BSD_SOURCE or -.BR _GNU_SOURCE -is defined. +.BR _SVID_SOURCE . .PP The former is the constant .B MAXDNAME @@ -261,11 +265,11 @@ .in +4n .nf -struct sockaddr *sa; /* input */ -socklen_t len; /* input */ +struct sockaddr *addr; /* input */ +socklen_t addrlen; /* input */ char hbuf[NI_MAXHOST], sbuf[NI_MAXSERV]; -if (getnameinfo(sa, len, hbuf, sizeof(hbuf), sbuf, +if (getnameinfo(addr, addrlen, hbuf, sizeof(hbuf), sbuf, sizeof(sbuf), NI_NUMERICHOST | NI_NUMERICSERV) == 0) printf("host=%s, serv=%s\en", hbuf, sbuf); .fi @@ -276,11 +280,11 @@ .in +4n .nf -struct sockaddr *sa; /* input */ -socklen_t len; /* input */ +struct sockaddr *addr; /* input */ +socklen_t addrlen; /* input */ char hbuf[NI_MAXHOST]; -if (getnameinfo(sa, len, hbuf, sizeof(hbuf), +if (getnameinfo(addr, addrlen, hbuf, sizeof(hbuf), NULL, 0, NI_NAMEREQD)) printf("could not resolve hostname"); else @@ -326,11 +330,11 @@ .UR http://www.usenix.org\:/publications\:/library\:/proceedings\:/usenix2000\:/freenix\:/metzprotocol.html .UE . .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/getnetent.3 manpages-4.05/man3/getnetent.3 --- manpages-4.04/man3/getnetent.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/getnetent.3 2016-03-15 03:47:40.000000000 +0000 @@ -210,11 +210,11 @@ .br RFC\ 1101 .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/getnetent_r.3 manpages-4.05/man3/getnetent_r.3 --- manpages-4.04/man3/getnetent_r.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/getnetent_r.3 2016-03-15 03:47:40.000000000 +0000 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH GETNETENT_R 3 2015-07-23 "GNU" "Linux Programmer's Manual" +.TH GETNETENT_R 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME getnetent_r, getnetbyname_r, getnetbyaddr_r \- get network entry (reentrant) @@ -55,9 +55,10 @@ .BR getnetent_r (), .BR getnetbyname_r (), .BR getnetbyaddr_r (): -.RS 4 -_BSD_SOURCE || _SVID_SOURCE -.RE + Since glibc 2.19: + _DEFAULT_SOURCE + Glibc 2.19 and earlier: + _BSD_SOURCE || _SVID_SOURCE .ad b .SH DESCRIPTION The @@ -161,11 +162,11 @@ .BR getnetent (3), .BR networks (5) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/get_nprocs_conf.3 manpages-4.05/man3/get_nprocs_conf.3 --- manpages-4.04/man3/get_nprocs_conf.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/get_nprocs_conf.3 2016-03-15 03:47:40.000000000 +0000 @@ -102,11 +102,11 @@ .fi .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/getopt.3 manpages-4.05/man3/getopt.3 --- manpages-4.04/man3/getopt.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/getopt.3 2016-03-15 03:47:40.000000000 +0000 @@ -526,11 +526,11 @@ .BR getopt (1), .BR getsubopt (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/getpass.3 manpages-4.05/man3/getpass.3 --- manpages-4.04/man3/getpass.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/getpass.3 2016-03-15 03:47:40.000000000 +0000 @@ -21,7 +21,7 @@ .\" . .\" %%%LICENSE_END .\" -.TH GETPASS 3 2015-03-02 "Linux" "Linux Programmer's Manual" +.TH GETPASS 3 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME getpass \- get a password .SH SYNOPSIS @@ -41,10 +41,9 @@ .TP 4 Since glibc 2.2.2: .nf -_BSD_SOURCE || - (_XOPEN_SOURCE\ >=\ 500 || - _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED) && - !(_POSIX_C_SOURCE\ >=\ 200112L || _XOPEN_SOURCE\ >=\ 600) +_XOPEN_SOURCE && ! (_POSIX_C_SOURCE\ >=\ 200112L) + || /* Glibc since 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE .fi .TP 4 Before glibc 2.2.2: @@ -166,11 +165,11 @@ .SH SEE ALSO .BR crypt (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/get_phys_pages.3 manpages-4.05/man3/get_phys_pages.3 --- manpages-4.04/man3/get_phys_pages.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/get_phys_pages.3 2016-03-15 03:47:40.000000000 +0000 @@ -97,11 +97,11 @@ .SH SEE ALSO .BR sysconf (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/getprotoent.3 manpages-4.05/man3/getprotoent.3 --- manpages-4.04/man3/getprotoent.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/getprotoent.3 2016-03-15 03:47:40.000000000 +0000 @@ -196,11 +196,11 @@ .BR getservent (3), .BR protocols (5) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/getprotoent_r.3 manpages-4.05/man3/getprotoent_r.3 --- manpages-4.04/man3/getprotoent_r.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/getprotoent_r.3 2016-03-15 03:47:40.000000000 +0000 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH GETPROTOENT_R 3 2015-07-23 "GNU" "Linux Programmer's Manual" +.TH GETPROTOENT_R 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME getprotoent_r, getprotobyname_r, getprotobynumber_r \- get protocol entry (reentrant) @@ -52,9 +52,10 @@ .BR getprotoent_r (), .BR getprotobyname_r (), .BR getprotobynumber_r (): -.RS 4 -_BSD_SOURCE || _SVID_SOURCE -.RE + Since glibc 2.19: + _DEFAULT_SOURCE + Glibc 2.19 and earlier: + _BSD_SOURCE || _SVID_SOURCE .ad b .SH DESCRIPTION The @@ -255,11 +256,11 @@ .BR getprotoent (3), .BR protocols (5) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/getpt.3 manpages-4.05/man3/getpt.3 --- manpages-4.04/man3/getpt.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/getpt.3 2016-03-15 03:47:40.000000000 +0000 @@ -65,11 +65,11 @@ .BR ptmx (4), .BR pty (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/getpw.3 manpages-4.05/man3/getpw.3 --- manpages-4.04/man3/getpw.3 2015-12-29 12:51:45.000000000 +0000 +++ manpages-4.05/man3/getpw.3 2016-03-15 03:47:40.000000000 +0000 @@ -135,11 +135,11 @@ .BR setpwent (3), .BR passwd (5) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/getpwent.3 manpages-4.05/man3/getpwent.3 --- manpages-4.04/man3/getpwent.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/getpwent.3 2016-03-15 03:47:40.000000000 +0000 @@ -30,7 +30,7 @@ .\" Modified Sat Jul 24 19:22:14 1993 by Rik Faith (faith@cs.unc.edu) .\" Modified Mon May 27 21:37:47 1996 by Martin Schulze (joey@linux.de) .\" -.TH GETPWENT 3 2015-12-28 "GNU" "Linux Programmer's Manual" +.TH GETPWENT 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME getpwent, setpwent, endpwent \- get password file entry .SH SYNOPSIS @@ -55,8 +55,10 @@ .BR setpwent (), .BR endpwent (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 || -_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED +_XOPEN_SOURCE\ >=\ 500 +.\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED + || /* Glibc since 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .ad b .SH DESCRIPTION @@ -125,7 +127,8 @@ .SH ERRORS .TP .B EINTR -A signal was caught. +A signal was caught; see +.BR signal (7). .TP .B EIO I/O error. @@ -196,11 +199,11 @@ .BR putpwent (3), .BR passwd (5) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/getpwent_r.3 manpages-4.05/man3/getpwent_r.3 --- manpages-4.04/man3/getpwent_r.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/getpwent_r.3 2016-03-15 03:47:40.000000000 +0000 @@ -21,7 +21,7 @@ .\" . .\" %%%LICENSE_END .\" -.TH GETPWENT_R 3 2015-07-23 "GNU" "Linux Programmer's Manual" +.TH GETPWENT_R 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME getpwent_r, fgetpwent_r \- get passwd file entry reentrantly .SH SYNOPSIS @@ -43,10 +43,16 @@ .in .sp .BR getpwent_r (), -_BSD_SOURCE || _SVID_SOURCE + Since glibc 2.19: + _DEFAULT_SOURCE + Glibc 2.19 and earlier: + _BSD_SOURCE || _SVID_SOURCE .br .BR fgetpwent_r (): -_SVID_SOURCE + Since glibc 2.19: + _DEFAULT_SOURCE + Glibc 2.19 and earlier: + _SVID_SOURCE .SH DESCRIPTION The functions .BR getpwent_r () @@ -214,11 +220,11 @@ .BR putpwent (3), .BR passwd (5) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/getpwnam.3 manpages-4.05/man3/getpwnam.3 --- manpages-4.04/man3/getpwnam.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/getpwnam.3 2016-03-15 03:47:40.000000000 +0000 @@ -34,7 +34,7 @@ .\" Modified 2003-11-15 by aeb .\" 2008-11-07, mtk, Added an example program for getpwnam_r(). .\" -.TH GETPWNAM 3 2015-12-28 "GNU" "Linux Programmer's Manual" +.TH GETPWNAM 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME getpwnam, getpwnam_r, getpwuid, getpwuid_r \- get password file entry .SH SYNOPSIS @@ -64,8 +64,8 @@ .BR getpwnam_r (), .BR getpwuid_r (): .RS 4 -_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _BSD_SOURCE || -_SVID_SOURCE || _POSIX_SOURCE +_POSIX_C_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .ad b .SH DESCRIPTION @@ -188,7 +188,8 @@ was not found. .TP .B EINTR -A signal was caught. +A signal was caught; see +.BR signal (7). .TP .B EIO I/O error. @@ -339,11 +340,11 @@ .BR setpwent (3), .BR passwd (5) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/getrpcent.3 manpages-4.05/man3/getrpcent.3 --- manpages-4.04/man3/getrpcent.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/getrpcent.3 2016-03-15 03:47:40.000000000 +0000 @@ -133,11 +133,11 @@ .BR rpcinfo (8), .BR ypserv (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/getrpcent_r.3 manpages-4.05/man3/getrpcent_r.3 --- manpages-4.04/man3/getrpcent_r.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/getrpcent_r.3 2016-03-15 03:47:40.000000000 +0000 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH GETRPCENT_R 3 2015-07-23 "GNU" "Linux Programmer's Manual" +.TH GETRPCENT_R 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME getrpcent_r, getrpcbyname_r, getrpcbynumber_r \- get RPC entry (reentrant) @@ -52,9 +52,10 @@ .BR getrpcent_r (), .BR getrpcbyname_r (), .BR getrpcbynumber_r (): -.RS 4 -_BSD_SOURCE || _SVID_SOURCE -.RE + Since glibc 2.19: + _DEFAULT_SOURCE + Glibc 2.19 and earlier: + _BSD_SOURCE || _SVID_SOURCE .ad b .SH DESCRIPTION The @@ -150,11 +151,11 @@ .BR getrpcent (3), .BR rpc (5) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/getrpcport.3 manpages-4.05/man3/getrpcport.3 --- manpages-4.04/man3/getrpcport.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/getrpcport.3 2016-03-15 03:47:40.000000000 +0000 @@ -52,11 +52,11 @@ Not in POSIX.1. Present on the BSDs, Solaris, and many other systems. .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/gets.3 manpages-4.05/man3/gets.3 --- manpages-4.04/man3/gets.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/gets.3 2016-03-15 03:47:40.000000000 +0000 @@ -119,11 +119,11 @@ .BR unlocked_stdio (3), .BR feature_test_macros (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/getservent.3 manpages-4.05/man3/getservent.3 --- manpages-4.04/man3/getservent.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/getservent.3 2016-03-15 03:47:40.000000000 +0000 @@ -213,11 +213,11 @@ .BR getservent_r (3), .BR services (5) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/getservent_r.3 manpages-4.05/man3/getservent_r.3 --- manpages-4.04/man3/getservent_r.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/getservent_r.3 2016-03-15 03:47:40.000000000 +0000 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH GETSERVENT_R 3 2015-07-23 "GNU" "Linux Programmer's Manual" +.TH GETSERVENT_R 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME getservent_r, getservbyname_r, getservbyport_r \- get service entry (reentrant) @@ -52,9 +52,10 @@ .BR getservent_r (), .BR getservbyname_r (), .BR getservbyport_r (): -.RS 4 -_BSD_SOURCE || _SVID_SOURCE -.RE + Since glibc 2.19: + _DEFAULT_SOURCE + Glibc 2.19 and earlier: + _BSD_SOURCE || _SVID_SOURCE .ad b .SH DESCRIPTION The @@ -257,11 +258,11 @@ .BR getservent (3), .BR services (5) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/getspnam.3 manpages-4.05/man3/getspnam.3 --- manpages-4.04/man3/getspnam.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/getspnam.3 2016-03-15 03:47:40.000000000 +0000 @@ -5,7 +5,7 @@ .\" Distributed under GPL .\" %%%LICENSE_END .\" -.TH GETSPNAM 3 2015-12-05 "GNU" "Linux Programmer's Manual" +.TH GETSPNAM 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME getspnam, getspnam_r, getspent, getspent_r, setspent, endspent, fgetspent, fgetspent_r, sgetspent, sgetspent_r, putspent, @@ -65,9 +65,10 @@ .BR getspnam_r (), .BR fgetspent_r (), .BR sgetspent_r (): -.RS 4 -_BSD_SOURCE || _SVID_SOURCE -.RE + Since glibc 2.19: + _DEFAULT_SOURCE + Glibc 2.19 and earlier: + _BSD_SOURCE || _SVID_SOURCE .ad b .SH DESCRIPTION Long ago it was considered safe to have encrypted passwords openly @@ -319,11 +320,11 @@ .BR getpwnam_r (3), .BR shadow (5) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/getsubopt.3 manpages-4.05/man3/getsubopt.3 --- manpages-4.04/man3/getsubopt.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/getsubopt.3 2016-03-15 03:47:40.000000000 +0000 @@ -22,7 +22,7 @@ .\" SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. .\" %%%LICENSE_END .\" -.TH GETSUBOPT 3 2015-08-08 "GNU" "Linux Programmer's Manual" +.TH GETSUBOPT 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME getsubopt \- parse suboption arguments from a string .SH SYNOPSIS @@ -40,10 +40,10 @@ .ad l .RS 4 .PD 0 -_XOPEN_SOURCE\ >= 500 || -_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED +_XOPEN_SOURCE\ >= 500 +.\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED .br -|| /* Since glibc 2.12: */ _POSIX_C_SOURCE\ >=\ 200809L + || /* Since glibc 2.12: */ _POSIX_C_SOURCE\ >=\ 200809L .PD .RE .ad @@ -239,11 +239,11 @@ .SH SEE ALSO .BR getopt (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/getttyent.3 manpages-4.05/man3/getttyent.3 --- manpages-4.04/man3/getttyent.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/getttyent.3 2016-03-15 03:47:40.000000000 +0000 @@ -95,11 +95,11 @@ .BR ttyname (3), .BR ttyslot (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/getumask.3 manpages-4.05/man3/getumask.3 --- manpages-4.04/man3/getumask.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/getumask.3 2016-03-15 03:47:40.000000000 +0000 @@ -63,11 +63,11 @@ .SH SEE ALSO .BR umask (2) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/getusershell.3 manpages-4.05/man3/getusershell.3 --- manpages-4.04/man3/getusershell.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/getusershell.3 2016-03-15 03:47:40.000000000 +0000 @@ -27,7 +27,7 @@ .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified Sat Jul 24 19:17:53 1993 by Rik Faith (faith@cs.unc.edu) -.TH GETUSERSHELL 3 2015-03-02 "GNU" "Linux Programmer's Manual" +.TH GETUSERSHELL 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME getusershell, setusershell, endusershell \- get permitted user shells .SH SYNOPSIS @@ -50,9 +50,15 @@ .BR getusershell (), .BR setusershell (), .BR endusershell (): -.RS 4 -_BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE\ <\ 500) -.RE +.nf + Since glibc 2.21: +.\" commit 266865c0e7b79d4196e2cc393693463f03c90bd8 + _DEFAULT_SOURCE + In glibc 2.19 and 2.20: + _DEFAULT_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE\ <\ 500) + Up to and including glibc 2.19: + _BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE\ <\ 500) +.fi .ad b .SH DESCRIPTION The @@ -110,11 +116,11 @@ .SH SEE ALSO .BR shells (5) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/getutent.3 manpages-4.05/man3/getutent.3 --- manpages-4.04/man3/getutent.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/getutent.3 2016-03-15 03:47:40.000000000 +0000 @@ -28,7 +28,7 @@ .\" Modified Thu Jul 25 14:43:46 MET DST 1996 by Michael Haardt .\" .\" -.TH GETUTENT 3 2015-08-08 "" "Linux Programmer's Manual" +.TH GETUTENT 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME getutent, getutid, getutline, pututline, setutent, endutent, utmpname \- access utmp file entries @@ -270,8 +270,6 @@ Glibc adds reentrant versions .sp .nf -.BR "#define _GNU_SOURCE" " /* or _SVID_SOURCE or _BSD_SOURCE; -.RB "\& see " feature_test_macros "(7) */" .B #include .sp .BI "int getutent_r(struct utmp *" ubuf ", struct utmp **" ubufp ); @@ -283,6 +281,20 @@ .BI " struct utmp *" ubuf ", struct utmp **" ubufp ); .fi .sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR getutent_r (), +.BR getutid_r (), +.BR getutline_r (): +.nf + _GNU_SOURCE + || /* since glibc 2.19: */ _DEFAULT_SOURCE + || /* glibc <= 2.19: */ _SVID_SOURCE || _BSD_SOURCE +.fi +.sp These functions are GNU extensions, analogs of the functions of the same name without the _r suffix. The @@ -347,11 +359,11 @@ .BR getutmp (3), .BR utmp (5) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/getutmp.3 manpages-4.05/man3/getutmp.3 --- manpages-4.04/man3/getutmp.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/getutmp.3 2016-03-15 03:47:40.000000000 +0000 @@ -84,11 +84,11 @@ .BR getutent (3), .BR utmp (5) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/getw.3 manpages-4.05/man3/getw.3 --- manpages-4.04/man3/getw.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/getw.3 2016-03-15 03:47:40.000000000 +0000 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH GETW 3 2015-03-02 "GNU" "Linux Programmer's Manual" +.TH GETW 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME getw, putw \- input and output of words (ints) .SH SYNOPSIS @@ -46,10 +46,9 @@ .RS 4 .TP 4 Since glibc 2.3.3: -_SVID_SOURCE || _BSD_SOURCE || -.br -(_XOPEN_SOURCE && - !(_POSIX_C_SOURCE\ >=\ 200112L || _XOPEN_SOURCE\ >=\ 600)) +_XOPEN_SOURCE && ! (_POSIX_C_SOURCE\ >=\ 200112L) + || /* Glibc since 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .TP Before glibc 2.3.3: _SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE @@ -104,11 +103,11 @@ .BR getc (3), .BR putc (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/getwchar.3 manpages-4.05/man3/getwchar.3 --- manpages-4.04/man3/getwchar.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/getwchar.3 2016-03-15 03:47:40.000000000 +0000 @@ -84,11 +84,11 @@ .BR fgetwc (3), .BR unlocked_stdio (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/glob.3 manpages-4.05/man3/glob.3 --- manpages-4.04/man3/glob.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/glob.3 2016-03-15 03:47:40.000000000 +0000 @@ -362,11 +362,11 @@ .BR wordexp (3), .BR glob (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/gnu_get_libc_version.3 manpages-4.05/man3/gnu_get_libc_version.3 --- manpages-4.04/man3/gnu_get_libc_version.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/gnu_get_libc_version.3 2016-03-15 03:47:40.000000000 +0000 @@ -89,11 +89,11 @@ .SH SEE ALSO .BR confstr (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/grantpt.3 manpages-4.05/man3/grantpt.3 --- manpages-4.04/man3/grantpt.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/grantpt.3 2016-03-15 03:47:40.000000000 +0000 @@ -82,11 +82,11 @@ .BR pts (4), .BR pty (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/group_member.3 manpages-4.05/man3/group_member.3 --- manpages-4.04/man3/group_member.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/group_member.3 2016-03-15 03:47:40.000000000 +0000 @@ -60,11 +60,11 @@ .BR getgrouplist (3), .BR group (5) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/gsignal.3 manpages-4.05/man3/gsignal.3 --- manpages-4.04/man3/gsignal.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/gsignal.3 2016-03-15 03:47:40.000000000 +0000 @@ -24,7 +24,7 @@ .\" .\" This replaces an earlier man page written by Walter Harms .\" . -.TH GSIGNAL 3 2015-07-23 "" "Linux Programmer's Manual" +.TH GSIGNAL 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME gsignal, ssignal \- software signal facility .SH SYNOPSIS @@ -45,7 +45,10 @@ .sp .BR gsignal (), .BR ssignal (): -_SVID_SOURCE + Since glibc 2.19: + _DEFAULT_SOURCE + Glibc 2.19 and earlier: + _SVID_SOURCE .SH DESCRIPTION Don't use these functions under Linux. Due to a historical mistake, under Linux these functions are @@ -121,11 +124,11 @@ .BR signal (2), .BR raise (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/hash.3 manpages-4.05/man3/hash.3 --- manpages-4.04/man3/hash.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/hash.3 2016-03-15 03:47:40.000000000 +0000 @@ -169,11 +169,11 @@ .IR "A New Hash Package for UNIX" , Margo Seltzer, USENIX Proceedings, Winter 1991. .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/hsearch.3 manpages-4.05/man3/hsearch.3 --- manpages-4.04/man3/hsearch.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/hsearch.3 2016-03-15 03:47:40.000000000 +0000 @@ -354,11 +354,11 @@ .BR malloc (3), .BR tsearch (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/hypot.3 manpages-4.05/man3/hypot.3 --- manpages-4.04/man3/hypot.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/hypot.3 2016-03-15 03:47:40.000000000 +0000 @@ -30,7 +30,7 @@ .\" Modified 2002-07-27 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.TH HYPOT 3 2015-03-29 "" "Linux Programmer's Manual" +.TH HYPOT 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME hypot, hypotf, hypotl \- Euclidean distance function .SH SYNOPSIS @@ -54,21 +54,18 @@ .ad l .BR hypot (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || _XOPEN_SOURCE + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .br .BR hypotf (), .BR hypotl (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .ad b .SH DESCRIPTION @@ -179,11 +176,11 @@ .BR cabs (3), .BR sqrt (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/iconv.3 manpages-4.05/man3/iconv.3 --- manpages-4.04/man3/iconv.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/iconv.3 2016-03-15 03:47:40.000000000 +0000 @@ -189,11 +189,11 @@ .BR iconv_open (3), .BR iconvconfig (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/iconv_close.3 manpages-4.05/man3/iconv_close.3 --- manpages-4.04/man3/iconv_close.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/iconv_close.3 2016-03-15 03:47:40.000000000 +0000 @@ -55,11 +55,11 @@ .BR iconv (3), .BR iconv_open (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/iconv_open.3 manpages-4.05/man3/iconv_open.3 --- manpages-4.04/man3/iconv_open.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/iconv_open.3 2016-03-15 03:47:40.000000000 +0000 @@ -122,11 +122,11 @@ .BR iconv (3), .BR iconv_close (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/if_nameindex.3 manpages-4.05/man3/if_nameindex.3 --- manpages-4.04/man3/if_nameindex.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/if_nameindex.3 2016-03-15 03:47:40.000000000 +0000 @@ -167,11 +167,11 @@ .BR if_nametoindex (3), .BR ifconfig (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/if_nametoindex.3 manpages-4.05/man3/if_nametoindex.3 --- manpages-4.04/man3/if_nametoindex.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/if_nametoindex.3 2016-03-15 03:47:40.000000000 +0000 @@ -104,11 +104,11 @@ .BR if_nameindex (3), .BR ifconfig (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/ilogb.3 manpages-4.05/man3/ilogb.3 --- manpages-4.04/man3/ilogb.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/ilogb.3 2016-03-15 03:47:40.000000000 +0000 @@ -26,7 +26,7 @@ .\" .\" Inspired by a page by Walter Harms created 2002-08-10 .\" -.TH ILOGB 3 2015-04-19 "" "Linux Programmer's Manual" +.TH ILOGB 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME ilogb, ilogbf, ilogbl \- get integer exponent of a floating-point value .SH SYNOPSIS @@ -48,23 +48,19 @@ .ad l .BR ilogb (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 || -_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED || -_ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || _XOPEN_SOURCE\ >=\ 500 +.\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .br .BR ilogbf (), .BR ilogbl (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .ad b .SH DESCRIPTION @@ -170,11 +166,11 @@ .BR logb (3), .BR significand (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/index.3 manpages-4.05/man3/index.3 --- manpages-4.04/man3/index.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/index.3 2016-03-15 03:47:40.000000000 +0000 @@ -94,11 +94,11 @@ .BR strstr (3), .BR strtok (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/inet.3 manpages-4.05/man3/inet.3 --- manpages-4.04/man3/inet.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/inet.3 2016-03-15 03:47:40.000000000 +0000 @@ -39,7 +39,7 @@ .\" Add discussion of Classful Addressing, noting that it is obsolete. .\" Added an EXAMPLE program. .\" -.TH INET 3 2015-08-08 "GNU" "Linux Programmer's Manual" +.TH INET 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME inet_aton, inet_addr, inet_network, inet_ntoa, inet_makeaddr, inet_lnaof, inet_netof \- Internet address manipulation routines @@ -71,7 +71,12 @@ .sp .BR inet_aton (), .BR inet_ntoa (): -_BSD_SOURCE || _SVID_SOURCE +.nf + Since glibc 2.19: + _DEFAULT_SOURCE + In glibc up to and including 2.19: + _BSD_SOURCE || _BSD_SOURCE +.fi .SH DESCRIPTION .BR inet_aton () converts the Internet host address \fIcp\fP from the @@ -335,11 +340,11 @@ .BR hosts (5), .BR networks (5) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/inet_net_pton.3 manpages-4.05/man3/inet_net_pton.3 --- manpages-4.04/man3/inet_net_pton.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/inet_net_pton.3 2016-03-15 03:47:40.000000000 +0000 @@ -391,11 +391,11 @@ .BR inet (3), .BR networks (5) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/inet_ntop.3 manpages-4.05/man3/inet_ntop.3 --- manpages-4.04/man3/inet_ntop.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/inet_ntop.3 2016-03-15 03:47:40.000000000 +0000 @@ -133,11 +133,11 @@ .BR inet (3), .BR inet_pton (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/inet_pton.3 manpages-4.05/man3/inet_pton.3 --- manpages-4.04/man3/inet_pton.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/inet_pton.3 2016-03-15 03:47:40.000000000 +0000 @@ -229,11 +229,11 @@ .BR inet (3), .BR inet_ntop (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/INFINITY.3 manpages-4.05/man3/INFINITY.3 --- manpages-4.04/man3/INFINITY.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/INFINITY.3 2016-03-15 03:47:40.000000000 +0000 @@ -102,11 +102,11 @@ .BR fpclassify (3), .BR math_error (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/infnan.3 manpages-4.05/man3/infnan.3 --- manpages-4.04/man3/infnan.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/infnan.3 2016-03-15 03:47:40.000000000 +0000 @@ -90,11 +90,11 @@ This obsolete function was provided in libc4 and libc5, but is not available in glibc2. .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/initgroups.3 manpages-4.05/man3/initgroups.3 --- manpages-4.04/man3/initgroups.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/initgroups.3 2016-03-15 03:47:40.000000000 +0000 @@ -29,7 +29,7 @@ .\" Modified 1993-07-24 by Rik Faith .\" Modified 2004-10-10 by aeb .\" -.TH INITGROUPS 3 2015-03-29 "GNU" "Linux Programmer's Manual" +.TH INITGROUPS 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME initgroups \- initialize the supplementary group access list .SH SYNOPSIS @@ -46,7 +46,10 @@ .in .sp .BR initgroups (): -_BSD_SOURCE + Since glibc 2.19: + _DEFAULT_SOURCE + Glibc 2.19 and earlier: + _BSD_SOURCE .SH DESCRIPTION The .BR initgroups () @@ -105,11 +108,11 @@ .BR setgroups (2), .BR credentials (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/insque.3 manpages-4.05/man3/insque.3 --- manpages-4.04/man3/insque.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/insque.3 2016-03-15 03:47:40.000000000 +0000 @@ -33,7 +33,7 @@ .\" mtk, 2010-09-09: Noted glibc 2.4 bug, added info on circular .\" lists, added example program .\" -.TH INSQUE 3 2015-08-08 "" "Linux Programmer's Manual" +.TH INSQUE 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME insque, remque \- insert/remove an item from a queue .SH SYNOPSIS @@ -54,8 +54,10 @@ .BR insque (), .BR remque (): .RS 4 -_SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 || -_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED +_XOPEN_SOURCE\ >=\ 500 +.\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED + || /* Glibc since 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _SVID_SOURCE .RE .ad .SH DESCRIPTION @@ -256,11 +258,11 @@ } .fi .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/intro.3 manpages-4.05/man3/intro.3 --- manpages-4.04/man3/intro.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/intro.3 2016-03-15 03:47:40.000000000 +0000 @@ -108,11 +108,11 @@ .BR signal (7), .BR standards (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/isalpha.3 manpages-4.05/man3/isalpha.3 --- manpages-4.04/man3/isalpha.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/isalpha.3 2016-03-15 03:47:40.000000000 +0000 @@ -27,7 +27,7 @@ .\" Modified Sat Sep 2 21:52:01 1995 by Jim Van Zandt .\" Modified Mon May 27 22:55:26 1996 by Martin Schulze (joey@linux.de) .\" -.TH ISALPHA 3 2015-03-02 "GNU" "Linux Programmer's Manual" +.TH ISALPHA 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME isalnum, isalpha, isascii, isblank, iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace, isupper, isxdigit, @@ -78,17 +78,14 @@ .ad l .BR isascii (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE -.br +_XOPEN_SOURCE + || /* Glibc since 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _SVID_SOURCE .RE .BR isblank (): .RS 4 -_XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L .RE .BR isalnum_l (), @@ -344,11 +341,11 @@ .BR ascii (7), .BR locale (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/isalpha_l.3 manpages-4.05/man3/isalpha_l.3 --- manpages-4.04/man3/isalpha_l.3 1970-01-01 00:00:00.000000000 +0000 +++ manpages-4.05/man3/isalpha_l.3 2016-03-15 03:47:38.000000000 +0000 @@ -0,0 +1 @@ +.so man3/isalpha.3 diff -Nru manpages-4.04/man3/isatty.3 manpages-4.05/man3/isatty.3 --- manpages-4.04/man3/isatty.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/isatty.3 2016-03-15 03:47:40.000000000 +0000 @@ -77,11 +77,11 @@ .BR fstat (2), .BR ttyname (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/isfdtype.3 manpages-4.05/man3/isfdtype.3 --- manpages-4.04/man3/isfdtype.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/isfdtype.3 2016-03-15 03:47:40.000000000 +0000 @@ -102,11 +102,11 @@ .SH SEE ALSO .BR fstat (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/isgreater.3 manpages-4.05/man3/isgreater.3 --- manpages-4.04/man3/isgreater.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/isgreater.3 2016-03-15 03:47:40.000000000 +0000 @@ -7,7 +7,7 @@ .\" 2002-07-27 Walter Harms .\" this was done with the help of the glibc manual .\" -.TH ISGREATER 3 2015-08-08 "" "Linux Programmer's Manual" +.TH ISGREATER 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME isgreater, isgreaterequal, isless, islessequal, islessgreater, isunordered \- floating-point relational tests without exception for NaN @@ -38,15 +38,11 @@ .ad l All functions described here: .RS -_XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L .RE .ad b .SH DESCRIPTION -The normal relation operations (like +The normal relational operations (like .BR < , "less than") will fail if one of the operands is NaN. @@ -152,11 +148,11 @@ .BR fpclassify (3), .BR isnan (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/iswalnum.3 manpages-4.05/man3/iswalnum.3 --- manpages-4.04/man3/iswalnum.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/iswalnum.3 2016-03-15 03:47:40.000000000 +0000 @@ -88,11 +88,11 @@ .BR isalnum (3), .BR iswctype (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/iswalpha.3 manpages-4.05/man3/iswalpha.3 --- manpages-4.04/man3/iswalpha.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/iswalpha.3 2016-03-15 03:47:40.000000000 +0000 @@ -92,11 +92,11 @@ .BR isalpha (3), .BR iswctype (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/iswblank.3 manpages-4.05/man3/iswblank.3 --- manpages-4.04/man3/iswblank.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/iswblank.3 2016-03-15 03:47:40.000000000 +0000 @@ -13,7 +13,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH ISWBLANK 3 2015-08-08 "GNU" "Linux Programmer's Manual" +.TH ISWBLANK 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME iswblank \- test for whitespace wide character .SH SYNOPSIS @@ -31,11 +31,7 @@ .ad l .BR iswblank (): .RS -_XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L .RE .ad .SH DESCRIPTION @@ -91,11 +87,11 @@ .BR isblank (3), .BR iswctype (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/iswcntrl.3 manpages-4.05/man3/iswcntrl.3 --- manpages-4.04/man3/iswcntrl.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/iswcntrl.3 2016-03-15 03:47:40.000000000 +0000 @@ -76,11 +76,11 @@ .BR iscntrl (3), .BR iswctype (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/iswctype.3 manpages-4.05/man3/iswctype.3 --- manpages-4.04/man3/iswctype.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/iswctype.3 2016-03-15 03:47:40.000000000 +0000 @@ -90,11 +90,11 @@ .BR iswxdigit (3), .BR wctype (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/iswdigit.3 manpages-4.05/man3/iswdigit.3 --- manpages-4.04/man3/iswdigit.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/iswdigit.3 2016-03-15 03:47:40.000000000 +0000 @@ -91,11 +91,11 @@ .BR isdigit (3), .BR iswctype (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/iswgraph.3 manpages-4.05/man3/iswgraph.3 --- manpages-4.04/man3/iswgraph.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/iswgraph.3 2016-03-15 03:47:40.000000000 +0000 @@ -84,11 +84,11 @@ .BR isgraph (3), .BR iswctype (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/iswlower.3 manpages-4.05/man3/iswlower.3 --- manpages-4.04/man3/iswlower.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/iswlower.3 2016-03-15 03:47:40.000000000 +0000 @@ -102,11 +102,11 @@ .BR iswctype (3), .BR towlower (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/iswprint.3 manpages-4.05/man3/iswprint.3 --- manpages-4.04/man3/iswprint.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/iswprint.3 2016-03-15 03:47:40.000000000 +0000 @@ -70,11 +70,11 @@ .BR isprint (3), .BR iswctype (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/iswpunct.3 manpages-4.05/man3/iswpunct.3 --- manpages-4.04/man3/iswpunct.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/iswpunct.3 2016-03-15 03:47:40.000000000 +0000 @@ -86,11 +86,11 @@ .BR ispunct (3), .BR iswctype (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/iswspace.3 manpages-4.05/man3/iswspace.3 --- manpages-4.04/man3/iswspace.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/iswspace.3 2016-03-15 03:47:40.000000000 +0000 @@ -78,11 +78,11 @@ .BR isspace (3), .BR iswctype (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/iswupper.3 manpages-4.05/man3/iswupper.3 --- manpages-4.04/man3/iswupper.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/iswupper.3 2016-03-15 03:47:40.000000000 +0000 @@ -96,11 +96,11 @@ .BR iswctype (3), .BR towupper (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/iswxdigit.3 manpages-4.05/man3/iswxdigit.3 --- manpages-4.04/man3/iswxdigit.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/iswxdigit.3 2016-03-15 03:47:40.000000000 +0000 @@ -83,11 +83,11 @@ .BR iswctype (3), .BR isxdigit (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/j0.3 manpages-4.05/man3/j0.3 --- manpages-4.04/man3/j0.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/j0.3 2016-03-15 03:47:40.000000000 +0000 @@ -33,7 +33,7 @@ .\" Modified 2004-11-12 as per suggestion by Fabian Kreutz/AEB .\" 2008-07-24, mtk, moved yxx() material into separate y0.3 page .\" -.TH J0 3 2015-04-19 "" "Linux Programmer's Manual" +.TH J0 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME j0, j0f, j0l, j1, j1f, j1l, jn, jnf, jnl \- Bessel functions of the first kind @@ -72,7 +72,9 @@ .BR j1 (), .BR jn (): .RS 4 -_SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE +_XOPEN_SOURCE + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _SVID_SOURCE || _BSD_SOURCE .RE .br .BR j0f (), @@ -82,8 +84,10 @@ .BR jnf (), .BR jnl (): .RS 4 -_SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE\ >=\ 600 -.\" Also seems to work: -std=c99 -D_XOPEN_SOURCE +_XOPEN_SOURCE \ >=\ 600 + || (_ISOC99_SOURCE && _XOPEN_SOURCE) + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _SVID_SOURCE || _BSD_SOURCE .RE .ad b .SH DESCRIPTION @@ -196,11 +200,11 @@ .SH SEE ALSO .BR y0 (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/key_setsecret.3 manpages-4.05/man3/key_setsecret.3 --- manpages-4.04/man3/key_setsecret.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/key_setsecret.3 2016-03-15 03:47:40.000000000 +0000 @@ -89,11 +89,11 @@ .SH SEE ALSO .BR crypt (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/ldexp.3 manpages-4.05/man3/ldexp.3 --- manpages-4.04/man3/ldexp.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/ldexp.3 2016-03-15 03:47:40.000000000 +0000 @@ -31,7 +31,7 @@ .\" Modified 1993-07-24 by Rik Faith (faith@cs.unc.edu) .\" Modified 2004-10-31 by aeb .\" -.TH LDEXP 3 2015-04-19 "" "Linux Programmer's Manual" +.TH LDEXP 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME ldexp, ldexpf, ldexpl \- multiply floating-point number by integral power of 2 .SH SYNOPSIS @@ -56,11 +56,9 @@ .BR ldexpf (), .BR ldexpl (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .ad .SH DESCRIPTION @@ -150,11 +148,11 @@ .BR modf (3), .BR scalbln (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/lgamma.3 manpages-4.05/man3/lgamma.3 --- manpages-4.04/man3/lgamma.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/lgamma.3 2016-03-15 03:47:40.000000000 +0000 @@ -8,7 +8,7 @@ .\" .\" based on glibc infopages .\" -.TH LGAMMA 3 2015-04-19 "" "Linux Programmer's Manual" +.TH LGAMMA 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME lgamma, lgammaf, lgammal, lgamma_r, lgammaf_r, lgammal_r, signgam \- log gamma function @@ -41,31 +41,30 @@ .ad l .BR lgamma (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L || _XOPEN_SOURCE + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .br .BR lgammaf (), .BR lgammal (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .BR lgamma_r (), .BR lgammaf_r (), .BR lgammal_r (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE +/* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .IR signgam : .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE +_XOPEN_SOURCE + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .ad b .SH DESCRIPTION @@ -180,11 +179,11 @@ .SH SEE ALSO .BR tgamma (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/lio_listio.3 manpages-4.05/man3/lio_listio.3 --- manpages-4.04/man3/lio_listio.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/lio_listio.3 2016-03-15 03:47:40.000000000 +0000 @@ -21,7 +21,7 @@ .\" . .\" %%%LICENSE_END .\" -.TH LIO_LISTIO 3 2015-03-02 "" "Linux Programmer's Manual" +.TH LIO_LISTIO 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME lio_listio \- initiate a list of I/O requests .SH SYNOPSIS @@ -172,7 +172,8 @@ was .BR LIO_WAIT and a signal -was caught before all I/O operations completed. +was caught before all I/O operations completed; see +.BR signal (7). (This may even be one of the signals used for asynchronous I/O completion notification.) .TP @@ -238,11 +239,11 @@ .BR aio_write (3), .BR aio (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/localeconv.3 manpages-4.05/man3/localeconv.3 --- manpages-4.04/man3/localeconv.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/localeconv.3 2016-03-15 03:47:40.000000000 +0000 @@ -90,11 +90,11 @@ .BR strftime (3), .BR locale (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/lockf.3 manpages-4.05/man3/lockf.3 --- manpages-4.04/man3/lockf.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/lockf.3 2016-03-15 03:47:40.000000000 +0000 @@ -25,7 +25,7 @@ .\" Added section stuff, aeb, 2002-04-22. .\" Corrected include file, drepper, 2003-06-15. .\" -.TH LOCKF 3 2015-08-08 "GNU" "Linux Programmer's Manual" +.TH LOCKF 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME lockf \- apply, test or remove a POSIX lock on an open file .SH SYNOPSIS @@ -41,8 +41,10 @@ .BR lockf (): .ad l .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 || -_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED +_XOPEN_SOURCE\ >=\ 500 +.\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED + || /* Glibc since 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .ad .SH DESCRIPTION @@ -181,11 +183,11 @@ is called .IR mandatory.txt ) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/log10.3 manpages-4.05/man3/log10.3 --- manpages-4.04/man3/log10.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/log10.3 2016-03-15 03:47:40.000000000 +0000 @@ -33,7 +33,7 @@ .\" Modified 2002-07-27 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.TH LOG10 3 2015-04-19 "" "Linux Programmer's Manual" +.TH LOG10 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME log10, log10f, log10l \- base-10 logarithmic function .SH SYNOPSIS @@ -58,11 +58,9 @@ .BR log10f (), .BR log10l (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .ad .SH DESCRIPTION @@ -113,11 +111,11 @@ .BR log2 (3), .BR sqrt (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/log1p.3 manpages-4.05/man3/log1p.3 --- manpages-4.04/man3/log1p.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/log1p.3 2016-03-15 03:47:40.000000000 +0000 @@ -26,7 +26,7 @@ .\" .\" Modified 2002-07-27 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) -.TH LOG1P 3 2015-04-19 "" "Linux Programmer's Manual" +.TH LOG1P 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME log1p, log1pf, log1pl \- logarithm of 1 plus argument .SH SYNOPSIS @@ -50,22 +50,19 @@ .ad l .BR log1p (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 || -_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || _XOPEN_SOURCE\ >=\ 500 +.\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .br .BR log1pf (), .BR log1pl (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .ad b .SH DESCRIPTION @@ -160,11 +157,11 @@ .BR expm1 (3), .BR log (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/log2.3 manpages-4.05/man3/log2.3 --- manpages-4.04/man3/log2.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/log2.3 2016-03-15 03:47:40.000000000 +0000 @@ -33,7 +33,7 @@ .\" Modified 2002-07-27 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.TH LOG2 3 2015-04-19 "" "Linux Programmer's Manual" +.TH LOG2 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME log2, log2f, log2l \- base-2 logarithmic function .SH SYNOPSIS @@ -59,10 +59,7 @@ .BR log2f (), .BR log2l (): .RS 4 -_XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L .RE .ad b .SH DESCRIPTION @@ -114,11 +111,11 @@ .BR log10 (3), .BR sqrt (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/log.3 manpages-4.05/man3/log.3 --- manpages-4.04/man3/log.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/log.3 2016-03-15 03:47:40.000000000 +0000 @@ -33,7 +33,7 @@ .\" Modified 2002-07-27 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.TH LOG 3 2015-04-19 "" "Linux Programmer's Manual" +.TH LOG 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME log, logf, logl \- natural logarithmic function .SH SYNOPSIS @@ -58,11 +58,9 @@ .BR logf (), .BR logl (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .ad .SH DESCRIPTION @@ -159,11 +157,11 @@ .BR log2 (3), .BR sqrt (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/logb.3 manpages-4.05/man3/logb.3 --- manpages-4.04/man3/logb.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/logb.3 2016-03-15 03:47:40.000000000 +0000 @@ -26,7 +26,7 @@ .\" .\" Inspired by a page by Walter Harms created 2002-08-10 .\" -.TH LOGB 3 2015-04-19 "" "Linux Programmer's Manual" +.TH LOGB 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME logb, logbf, logbl \- get exponent of a floating-point value .SH SYNOPSIS @@ -48,22 +48,19 @@ .ad l .BR logb (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 || -_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || _XOPEN_SOURCE\ >=\ 500 +.\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .br .BR logbf (), .BR logbl (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .ad b .SH DESCRIPTION @@ -160,11 +157,11 @@ .BR ilogb (3), .BR log (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/login.3 manpages-4.05/man3/login.3 --- manpages-4.04/man3/login.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/login.3 2016-03-15 03:47:40.000000000 +0000 @@ -166,11 +166,11 @@ .BR getutent (3), .BR utmp (5) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/longjmp.3 manpages-4.05/man3/longjmp.3 --- manpages-4.04/man3/longjmp.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/longjmp.3 2016-03-15 03:47:38.000000000 +0000 @@ -1,158 +1 @@ -.\" Written by Michael Haardt, Fri Nov 25 14:51:42 MET 1994 -.\" -.\" %%%LICENSE_START(GPLv2+_DOC_FULL) -.\" This is free documentation; you can redistribute it and/or -.\" modify it under the terms of the GNU General Public License as -.\" published by the Free Software Foundation; either version 2 of -.\" the License, or (at your option) any later version. -.\" -.\" The GNU General Public License's references to "object code" -.\" and "executables" are to be interpreted as the output of any -.\" document formatting or typesetting system, including -.\" intermediate and printed output. -.\" -.\" This manual is distributed in the hope that it will be useful, -.\" but WITHOUT ANY WARRANTY; without even the implied warranty of -.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -.\" GNU General Public License for more details. -.\" -.\" You should have received a copy of the GNU General Public -.\" License along with this manual; if not, see -.\" . -.\" %%%LICENSE_END -.\" -.\" Added siglongjmp, Sun Mar 2 22:03:05 EST 1997, jrv@vanzandt.mv.com -.\" Modifications, Sun Feb 26 14:39:45 1995, faith@cs.unc.edu -.\" " -.TH LONGJMP 3 2015-08-08 "" "Linux Programmer's Manual" -.SH NAME -longjmp, siglongjmp \- nonlocal jump to a saved stack context -.SH SYNOPSIS -.nf -.B #include - -.BI "void longjmp(jmp_buf " env ", int " val ); - -.BI "void siglongjmp(sigjmp_buf " env ", int " val ); -.fi -.sp -.in -4n -Feature Test Macro Requirements for glibc (see -.BR feature_test_macros (7)): -.in -.sp -.BR siglongjmp (): -_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _POSIX_C_SOURCE -.SH DESCRIPTION -.BR longjmp () -and -.BR setjmp (3) -are useful for dealing with errors -and interrupts encountered in a low-level subroutine of a program. -.BR longjmp () -restores the environment saved by the last call of -.BR setjmp (3) -with the corresponding -.I env -argument. -After -.BR longjmp () -is completed, program execution continues as if the -corresponding call of -.BR setjmp (3) -had just returned the value -.IR val . -.BR longjmp () -cannot cause 0 to be returned. -If -.BR longjmp () -is invoked with a second argument of 0, 1 will be returned instead. -.P -.BR siglongjmp () -is similar to -.BR longjmp () -except for the type of -its -.I env -argument. -If, and only if, the -.BR sigsetjmp (3) -call that set this -.I env -used a nonzero -.I savesigs -flag, -.BR siglongjmp () -also restores the signal mask that was saved by -.BR sigsetjmp (3). -.SH RETURN VALUE -These functions never return. -.SH ATTRIBUTES -For an explanation of the terms used in this section, see -.BR attributes (7). -.TS -allbox; -lbw23 lb lb -l l l. -Interface Attribute Value -T{ -.BR longjmp (), -.BR siglongjmp () -T} Thread safety MT-Safe -.TE - -.SH CONFORMING TO -.BR longjmp (): -POSIX.1-2001, POSIX.1-2008, C89, C99. - -.BR siglongjmp (): -POSIX.1-2001, POSIX.1-2008. -.SH NOTES -POSIX does not specify whether -.BR longjmp () -will restore the signal context (see -.BR setjmp (3) -for some more details). -If you want to portably save and restore signal masks, use -.BR sigsetjmp (3) -and -.BR siglongjmp (). -.P -The values of automatic variables are unspecified after a call to -.BR longjmp () -if they meet all the following criteria: -.IP \(bu 3 -they are local to the function that made the corresponding -.BR setjmp (3) -call; -.IP \(bu -their values are changed between the calls to -.BR setjmp (3) -and -.BR longjmp (); -and -.IP \(bu -they are not declared as -.IR volatile . -.P -Analogous remarks apply for -.BR siglongjmp (). -.P -.BR longjmp () -and -.BR siglongjmp () -make programs hard to -understand and maintain. -If possible, an alternative should be used. -.SH SEE ALSO -.BR setjmp (3), -.BR sigsetjmp (3) -.SH COLOPHON -This page is part of release 4.04 of the Linux -.I man-pages -project. -A description of the project, -information about reporting bugs, -and the latest version of this page, -can be found at -\%http://www.kernel.org/doc/man\-pages/. +.so man3/setjmp.3 diff -Nru manpages-4.04/man3/lrint.3 manpages-4.05/man3/lrint.3 --- manpages-4.04/man3/lrint.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/lrint.3 2016-03-15 03:47:40.000000000 +0000 @@ -24,7 +24,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH LRINT 3 2015-04-19 "" "Linux Programmer's Manual" +.TH LRINT 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME lrint, lrintf, lrintl, llrint, llrintf, llrintl \- round to nearest integer .SH SYNOPSIS @@ -54,11 +54,7 @@ .ad l All functions shown above: .RS 4 -_XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L .RE .ad .SH DESCRIPTION @@ -135,11 +131,11 @@ .BR rint (3), .BR round (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/lround.3 manpages-4.05/man3/lround.3 --- manpages-4.04/man3/lround.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/lround.3 2016-03-15 03:47:40.000000000 +0000 @@ -24,7 +24,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH LROUND 3 2015-04-19 "" "Linux Programmer's Manual" +.TH LROUND 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME lround, lroundf, lroundl, llround, llroundf, llroundl \- round to nearest integer, away from zero @@ -55,11 +55,7 @@ .ad l All functions shown above: .RS 4 -_XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L .RE .ad .SH DESCRIPTION @@ -138,11 +134,11 @@ .BR rint (3), .BR round (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/lsearch.3 manpages-4.05/man3/lsearch.3 --- manpages-4.04/man3/lsearch.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/lsearch.3 2016-03-15 03:47:40.000000000 +0000 @@ -101,11 +101,11 @@ .BR hsearch (3), .BR tsearch (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/lseek64.3 manpages-4.05/man3/lseek64.3 --- manpages-4.04/man3/lseek64.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/lseek64.3 2016-03-15 03:47:40.000000000 +0000 @@ -177,11 +177,11 @@ .BR llseek (2), .BR lseek (2) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/makecontext.3 manpages-4.05/man3/makecontext.3 --- manpages-4.04/man3/makecontext.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/makecontext.3 2016-03-15 03:47:40.000000000 +0000 @@ -239,11 +239,11 @@ .BR getcontext (3), .BR sigsetjmp (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/makedev.3 manpages-4.05/man3/makedev.3 --- manpages-4.04/man3/makedev.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/makedev.3 2016-03-15 03:47:40.000000000 +0000 @@ -23,12 +23,11 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH MAKEDEV 3 2015-03-02 "Linux" "Linux Programmer's Manual" +.TH MAKEDEV 3 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME makedev, major, minor \- manage a device number .SH SYNOPSIS .nf -.BR "#define _BSD_SOURCE" " /* See feature_test_macros(7) */" .B #include .BI "dev_t makedev(unsigned int " maj ", unsigned int " min ); @@ -36,6 +35,16 @@ .BI "unsigned int major(dev_t " dev ); .BI "unsigned int minor(dev_t " dev ); .fi +.sp +.BR makedev (), +.BR major (), +.BR minor (): +.nf + Since glibc 2.19: + _DEFAULT_SOURCE + In glibc up to and including 2.19: + _BSD_SOURCE +.fi .SH DESCRIPTION A device ID consists of two parts: a major ID, identifying the class of the device, @@ -95,11 +104,11 @@ .BR mknod (2), .BR stat (2) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/mallinfo.3 manpages-4.05/man3/mallinfo.3 --- manpages-4.04/man3/mallinfo.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/mallinfo.3 2016-03-15 03:47:40.000000000 +0000 @@ -302,11 +302,11 @@ .BR malloc_trim (3), .BR mallopt (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/malloc.3 manpages-4.05/man3/malloc.3 --- manpages-4.04/man3/malloc.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/malloc.3 2016-03-15 03:47:40.000000000 +0000 @@ -314,11 +314,11 @@ .BR mtrace (3), .BR posix_memalign (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/malloc_get_state.3 manpages-4.05/man3/malloc_get_state.3 --- manpages-4.04/man3/malloc_get_state.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/malloc_get_state.3 2016-03-15 03:47:40.000000000 +0000 @@ -126,11 +126,11 @@ .BR malloc (3), .BR mallopt (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/malloc_hook.3 manpages-4.05/man3/malloc_hook.3 --- manpages-4.04/man3/malloc_hook.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/malloc_hook.3 2016-03-15 03:47:40.000000000 +0000 @@ -140,11 +140,11 @@ .BR mcheck (3), .BR mtrace (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/malloc_info.3 manpages-4.05/man3/malloc_info.3 --- manpages-4.04/man3/malloc_info.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/malloc_info.3 2016-03-15 03:47:40.000000000 +0000 @@ -273,11 +273,11 @@ .BR mallopt (3), .BR open_memstream (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/malloc_stats.3 manpages-4.05/man3/malloc_stats.3 --- manpages-4.04/man3/malloc_stats.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/malloc_stats.3 2016-03-15 03:47:40.000000000 +0000 @@ -78,11 +78,11 @@ .BR malloc_info (3), .BR mallopt (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/malloc_trim.3 manpages-4.05/man3/malloc_trim.3 --- manpages-4.04/man3/malloc_trim.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/malloc_trim.3 2016-03-15 03:47:40.000000000 +0000 @@ -93,11 +93,11 @@ .BR malloc (3), .BR mallopt (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/malloc_usable_size.3 manpages-4.05/man3/malloc_usable_size.3 --- manpages-4.04/man3/malloc_usable_size.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/malloc_usable_size.3 2016-03-15 03:47:40.000000000 +0000 @@ -74,11 +74,11 @@ .SH SEE ALSO .BR malloc (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/mallopt.3 manpages-4.05/man3/mallopt.3 --- manpages-4.04/man3/mallopt.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/mallopt.3 2016-03-15 03:47:40.000000000 +0000 @@ -330,7 +330,7 @@ (when the parameter is set low) and wasting unused memory at the top of the heap (when the parameter is set high). - +.\" .SS Environment variables A number of environment variables can be defined to modify some of the same parameters as are controlled by @@ -605,11 +605,11 @@ .BR mtrace (3), .BR posix_memalign (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/matherr.3 manpages-4.05/man3/matherr.3 --- manpages-4.04/man3/matherr.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/matherr.3 2016-03-15 03:47:40.000000000 +0000 @@ -24,12 +24,11 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH MATHERR 3 2015-03-02 "Linux" "Linux Programmer's Manual" +.TH MATHERR 3 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME matherr \- SVID math library exception handling .SH SYNOPSIS .nf -.BR "#define _SVID_SOURCE" " /* See feature_test_macros(7) */" .B #include .BI "int matherr(struct exception *" exc ); @@ -37,6 +36,21 @@ .B extern _LIB_VERSION_TYPE _LIB_VERSION; .fi .sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): + +.in +.ad l +.BR significand (), +.BR significandf (), +.BR significandl (): +.RS 4 +/* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _SVID_SOURCE +.RE +.ad b +.sp Link with \fI\-lm\fP. .SH DESCRIPTION The System V Interface Definition (SVID) specifies that various @@ -439,11 +453,11 @@ .BR math_error (7), .BR standards (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/MB_CUR_MAX.3 manpages-4.05/man3/MB_CUR_MAX.3 --- manpages-4.04/man3/MB_CUR_MAX.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/MB_CUR_MAX.3 2016-03-15 03:47:40.000000000 +0000 @@ -42,11 +42,11 @@ .BR wcstombs (3), .BR wctomb (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/mblen.3 manpages-4.05/man3/mblen.3 --- manpages-4.04/man3/mblen.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/mblen.3 2016-03-15 03:47:40.000000000 +0000 @@ -113,11 +113,11 @@ .SH SEE ALSO .BR mbrlen (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/MB_LEN_MAX.3 manpages-4.05/man3/MB_LEN_MAX.3 --- manpages-4.04/man3/MB_LEN_MAX.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/MB_LEN_MAX.3 2016-03-15 03:47:40.000000000 +0000 @@ -50,11 +50,11 @@ .SH SEE ALSO .BR MB_CUR_MAX (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/mbrlen.3 manpages-4.05/man3/mbrlen.3 --- manpages-4.04/man3/mbrlen.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/mbrlen.3 2016-03-15 03:47:40.000000000 +0000 @@ -125,11 +125,11 @@ .SH SEE ALSO .BR mbrtowc (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/mbrtowc.3 manpages-4.05/man3/mbrtowc.3 --- manpages-4.04/man3/mbrtowc.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/mbrtowc.3 2016-03-15 03:47:40.000000000 +0000 @@ -195,11 +195,11 @@ .BR mbsinit (3), .BR mbsrtowcs (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/mbsinit.3 manpages-4.05/man3/mbsinit.3 --- manpages-4.04/man3/mbsinit.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/mbsinit.3 2016-03-15 03:47:40.000000000 +0000 @@ -109,11 +109,11 @@ .BR mbsrtowcs (3), .BR wcsrtombs (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/mbsnrtowcs.3 manpages-4.05/man3/mbsnrtowcs.3 --- manpages-4.04/man3/mbsnrtowcs.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/mbsnrtowcs.3 2016-03-15 03:47:40.000000000 +0000 @@ -12,7 +12,7 @@ .\" Dinkumware C library reference http://www.dinkumware.com/ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" -.TH MBSNRTOWCS 3 2015-04-19 "GNU" "Linux Programmer's Manual" +.TH MBSNRTOWCS 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME mbsnrtowcs \- convert a multibyte string to a wide-character string .SH SYNOPSIS @@ -34,7 +34,7 @@ .RS 4 .TP 4 Since glibc 2.10: -_XOPEN_SOURCE\ >=\ 700 || _POSIX_C_SOURCE\ >=\ 200809L +_POSIX_C_SOURCE\ >=\ 200809L .TP Before glibc 2.10: _GNU_SOURCE @@ -192,11 +192,11 @@ .BR mbsinit (3), .BR mbsrtowcs (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/mbsrtowcs.3 manpages-4.05/man3/mbsrtowcs.3 --- manpages-4.04/man3/mbsrtowcs.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/mbsrtowcs.3 2016-03-15 03:47:40.000000000 +0000 @@ -156,11 +156,11 @@ .BR mbsnrtowcs (3), .BR mbstowcs (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/mbstowcs.3 manpages-4.05/man3/mbstowcs.3 --- manpages-4.04/man3/mbstowcs.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/mbstowcs.3 2016-03-15 03:47:40.000000000 +0000 @@ -232,11 +232,11 @@ .BR wctomb (3), .BR wcstombs (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/mbtowc.3 manpages-4.05/man3/mbtowc.3 --- manpages-4.04/man3/mbtowc.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/mbtowc.3 2016-03-15 03:47:40.000000000 +0000 @@ -145,11 +145,11 @@ .BR wctomb (3), .BR wcstombs (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/mcheck.3 manpages-4.05/man3/mcheck.3 --- manpages-4.04/man3/mcheck.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/mcheck.3 2016-03-15 03:47:40.000000000 +0000 @@ -79,7 +79,7 @@ If the system detects an inconsistency in the heap, the caller-supplied function pointed to by .I abortfunc -is invoked with a single argument argument, +is invoked with a single argument, .IR mstatus , that indicates what type of inconsistency was detected. If @@ -227,11 +227,11 @@ .BR mallopt (3), .BR mtrace (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/memccpy.3 manpages-4.05/man3/memccpy.3 --- manpages-4.04/man3/memccpy.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/memccpy.3 2016-03-15 03:47:40.000000000 +0000 @@ -88,11 +88,11 @@ .BR strcpy (3), .BR strncpy (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/memchr.3 manpages-4.05/man3/memchr.3 --- manpages-4.04/man3/memchr.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/memchr.3 2016-03-15 03:47:40.000000000 +0000 @@ -159,11 +159,11 @@ .BR strstr (3), .BR wmemchr (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/memcmp.3 manpages-4.05/man3/memcmp.3 --- manpages-4.04/man3/memcmp.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/memcmp.3 2016-03-15 03:47:40.000000000 +0000 @@ -95,11 +95,11 @@ .BR strncmp (3), .BR wmemcmp (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/memcpy.3 manpages-4.05/man3/memcpy.3 --- manpages-4.04/man3/memcpy.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/memcpy.3 2016-03-15 03:47:40.000000000 +0000 @@ -115,11 +115,11 @@ .BR strncpy (3), .BR wmemcpy (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/memfrob.3 manpages-4.05/man3/memfrob.3 --- manpages-4.04/man3/memfrob.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/memfrob.3 2016-03-15 03:47:40.000000000 +0000 @@ -75,11 +75,11 @@ .SH SEE ALSO .BR strfry (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/memmem.3 manpages-4.05/man3/memmem.3 --- manpages-4.04/man3/memmem.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/memmem.3 2016-03-15 03:47:40.000000000 +0000 @@ -98,11 +98,11 @@ .SH SEE ALSO .BR strstr (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/memmove.3 manpages-4.05/man3/memmove.3 --- manpages-4.04/man3/memmove.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/memmove.3 2016-03-15 03:47:40.000000000 +0000 @@ -81,11 +81,11 @@ .BR strncpy (3), .BR wmemmove (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/mempcpy.3 manpages-4.05/man3/mempcpy.3 --- manpages-4.04/man3/mempcpy.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/mempcpy.3 2016-03-15 03:47:40.000000000 +0000 @@ -89,11 +89,11 @@ .BR memmove (3), .BR wmemcpy (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/memset.3 manpages-4.05/man3/memset.3 --- manpages-4.04/man3/memset.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/memset.3 2016-03-15 03:47:40.000000000 +0000 @@ -70,11 +70,11 @@ .BR swab (3), .BR wmemset (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/mkdtemp.3 manpages-4.05/man3/mkdtemp.3 --- manpages-4.04/man3/mkdtemp.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/mkdtemp.3 2016-03-15 03:47:40.000000000 +0000 @@ -23,7 +23,7 @@ .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END -.TH MKDTEMP 3 2015-03-02 "GNU" "Linux Programmer's Manual" +.TH MKDTEMP 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME mkdtemp \- create a unique temporary directory .SH SYNOPSIS @@ -43,15 +43,15 @@ .ad l .RS 4 .PD 0 -_BSD_SOURCE +/* Since glibc 2.19: */ _DEFAULT_SOURCE +.br +|| /* Glibc 2.19 and earlier: */ _BSD_SOURCE .br || /* Since glibc 2.10: */ -.RS 4 -(_POSIX_C_SOURCE\ >=\ 200809L || _XOPEN_SOURCE\ >=\ 700) +_POSIX_C_SOURCE\ >=\ 200809L .ad .PD .RE -.RE .SH DESCRIPTION The .BR mkdtemp () @@ -108,11 +108,11 @@ .BR tmpfile (3), .BR tmpnam (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/mkfifo.3 manpages-4.05/man3/mkfifo.3 --- manpages-4.04/man3/mkfifo.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/mkfifo.3 2016-03-15 03:47:40.000000000 +0000 @@ -25,7 +25,7 @@ .\" .\" changed section from 2 to 3, aeb, 950919 .\" -.TH MKFIFO 3 2015-03-02 "GNU" "Linux Programmer's Manual" +.TH MKFIFO 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME mkfifo, mkfifoat \- make a FIFO special file (a named pipe) .SH SYNOPSIS @@ -52,7 +52,7 @@ .RS 4 .TP 4 Since glibc 2.10: -_XOPEN_SOURCE\ >=\ 700 || _POSIX_C_SOURCE\ >=\ 200809L +_POSIX_C_SOURCE\ >=\ 200809L .TP Before glibc 2.10: _ATFILE_SOURCE @@ -210,11 +210,11 @@ .BR write (2), .BR fifo (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/mkstemp.3 manpages-4.05/man3/mkstemp.3 --- manpages-4.04/man3/mkstemp.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/mkstemp.3 2016-03-15 03:47:40.000000000 +0000 @@ -32,7 +32,7 @@ .\" Modified 990328, aeb .\" 2008-06-19, mtk, Added mkostemp(); various other changes .\" -.TH MKSTEMP 3 2015-03-02 "GNU" "Linux Programmer's Manual" +.TH MKSTEMP 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME mkstemp, mkostemp, mkstemps, mkostemps \- create a unique temporary file .SH SYNOPSIS @@ -57,10 +57,10 @@ .ad l .RS 4 .PD 0 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 || -_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED -.br -|| /* Since glibc 2.12: */ _POSIX_C_SOURCE\ >=\ 200112L +_XOPEN_SOURCE\ >=\ 500 +.\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED + || /* Since glibc 2.12: */ _POSIX_C_SOURCE\ >=\ 200112L + || /* Glibc versions <= 2.19: */ _SVID_SOURCE || _BSD_SOURCE .PD .RE .ad b @@ -69,7 +69,8 @@ _GNU_SOURCE .br .BR mkstemps (): -_BSD_SOURCE || _SVID_SOURCE + /* Glibc since 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _SVID_SOURCE || _BSD_SOURCE .br .BR mkostemps (): _GNU_SOURCE @@ -253,11 +254,11 @@ .BR tmpfile (3), .BR tmpnam (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/mktemp.3 manpages-4.05/man3/mktemp.3 --- manpages-4.04/man3/mktemp.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/mktemp.3 2016-03-15 03:47:40.000000000 +0000 @@ -31,7 +31,7 @@ .\" (prompted by Scott Burkett ) .\" Modified Sun Mar 28 23:44:38 1999 by Andries Brouwer (aeb@cwi.nl) .\" -.TH MKTEMP 3 2015-08-08 "GNU" "Linux Programmer's Manual" +.TH MKTEMP 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME mktemp \- make a unique temporary filename .SH SYNOPSIS @@ -52,14 +52,13 @@ .RS 4 .TP 4 Since glibc 2.12: -_BSD_SOURCE || _SVID_SOURCE || - (_XOPEN_SOURCE\ >=\ 500 || - _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED) && - !(_POSIX_C_SOURCE\ >=\ 200112L || _XOPEN_SOURCE\ >=\ 600) +(_XOPEN_SOURCE\ >=\ 500) && ! (_POSIX_C_SOURCE\ >=\ 200112L) + || /* Glibc since 2.19: */ _DEFAULT_SOURCE + || /* Glibc <= 2.19: */ _SVID_SOURCE || _BSD_SOURCE .TP Before glibc 2.12: -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 || -_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED +_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 +.\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED .RE .PD .ad b @@ -136,11 +135,11 @@ .BR tmpfile (3), .BR tmpnam (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/modf.3 manpages-4.05/man3/modf.3 --- manpages-4.04/man3/modf.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/modf.3 2016-03-15 03:47:40.000000000 +0000 @@ -30,7 +30,7 @@ .\" Modified 2002-07-27 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.TH MODF 3 2015-04-19 "" "Linux Programmer's Manual" +.TH MODF 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME modf, modff, modfl \- extract signed integral and fractional values from floating-point number @@ -56,11 +56,9 @@ .BR modf (), .BR modfl (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .ad .SH DESCRIPTION @@ -113,11 +111,11 @@ .BR frexp (3), .BR ldexp (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/mpool.3 manpages-4.05/man3/mpool.3 --- manpages-4.04/man3/mpool.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/mpool.3 2016-03-15 03:47:40.000000000 +0000 @@ -233,11 +233,11 @@ .BR hash (3), .BR recno (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/mq_close.3 manpages-4.05/man3/mq_close.3 --- manpages-4.04/man3/mq_close.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/mq_close.3 2016-03-15 03:47:40.000000000 +0000 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH MQ_CLOSE 3 2015-08-08 "Linux" "Linux Programmer's Manual" +.TH MQ_CLOSE 3 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME mq_close \- close a message queue descriptor .SH SYNOPSIS @@ -53,7 +53,7 @@ .SH ERRORS .TP .B EBADF -The descriptor specified in +The message queue descriptor specified in .I mqdes is invalid. .SH ATTRIBUTES @@ -83,11 +83,11 @@ .BR mq_unlink (3), .BR mq_overview (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/mq_getattr.3 manpages-4.05/man3/mq_getattr.3 --- manpages-4.04/man3/mq_getattr.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/mq_getattr.3 2016-03-15 03:47:40.000000000 +0000 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH MQ_GETATTR 3 2015-08-08 "Linux" "Linux Programmer's Manual" +.TH MQ_GETATTR 3 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME mq_getattr, mq_setattr \- get/set message queue attributes .SH SYNOPSIS @@ -42,7 +42,7 @@ and .BR mq_setattr () respectively retrieve and modify attributes of the message queue -referred to by the descriptor +referred to by the message queue descriptor .IR mqdes . .BR mq_getattr () @@ -126,7 +126,7 @@ .SH ERRORS .TP .B EBADF -The descriptor specified in +The message queue descriptor specified in .I mqdes is invalid. .TP @@ -242,11 +242,11 @@ .BR mq_unlink (3), .BR mq_overview (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/mq_notify.3 manpages-4.05/man3/mq_notify.3 --- manpages-4.04/man3/mq_notify.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/mq_notify.3 2016-03-15 03:47:40.000000000 +0000 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH MQ_NOTIFY 3 2015-07-23 "Linux" "Linux Programmer's Manual" +.TH MQ_NOTIFY 3 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME mq_notify \- register for notification when a message is available .SH SYNOPSIS @@ -38,7 +38,7 @@ .BR mq_notify () allows the calling process to register or unregister for delivery of an asynchronous notification when a new message arrives on -the empty message queue referred to by the descriptor +the empty message queue referred to by the message queue descriptor .IR mqdes . The @@ -140,7 +140,7 @@ .SH ERRORS .TP .B EBADF -The descriptor specified in +The message queue descriptor specified in .I mqdes is invalid. .TP @@ -285,11 +285,11 @@ .BR mq_overview (7), .BR sigevent (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/mq_open.3 manpages-4.05/man3/mq_open.3 --- manpages-4.04/man3/mq_open.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/mq_open.3 2016-03-15 03:47:40.000000000 +0000 @@ -290,11 +290,11 @@ .BR mq_unlink (3), .BR mq_overview (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/mq_receive.3 manpages-4.05/man3/mq_receive.3 --- manpages-4.04/man3/mq_receive.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/mq_receive.3 2016-03-15 03:47:40.000000000 +0000 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH MQ_RECEIVE 3 2015-08-08 "Linux" "Linux Programmer's Manual" +.TH MQ_RECEIVE 3 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME mq_receive, mq_timedreceive \- receive a message from a message queue .SH SYNOPSIS @@ -51,13 +51,13 @@ .sp .BR mq_timedreceive (): .RS 4 -_XOPEN_SOURCE\ >=\ 600 || _POSIX_C_SOURCE\ >=\ 200112L +_POSIX_C_SOURCE\ >=\ 200112L .RE .ad .SH DESCRIPTION .BR mq_receive () removes the oldest message with the highest priority from -the message queue referred to by the descriptor +the message queue referred to by the message queue descriptor .IR mqdes , and places it in the buffer pointed to by .IR msg_ptr . @@ -127,7 +127,7 @@ .IR mqdes . .TP .B EBADF -The descriptor specified in +The file descriptor specified in .I mqdes was invalid. .TP @@ -183,11 +183,11 @@ .BR mq_overview (7), .BR time (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/mq_send.3 manpages-4.05/man3/mq_send.3 --- manpages-4.04/man3/mq_send.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/mq_send.3 2016-03-15 03:47:40.000000000 +0000 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH MQ_SEND 3 2015-08-08 "Linux" "Linux Programmer's Manual" +.TH MQ_SEND 3 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME mq_send, mq_timedsend \- send a message to a message queue .SH SYNOPSIS @@ -51,14 +51,14 @@ .sp .BR mq_timedsend (): .RS 4 -_XOPEN_SOURCE\ >=\ 600 || _POSIX_C_SOURCE\ >=\ 200112L +_POSIX_C_SOURCE\ >=\ 200112L .RE .ad .SH DESCRIPTION .BR mq_send () adds the message pointed to by .I msg_ptr -to the message queue referred to by the descriptor +to the message queue referred to by the message queue descriptor .IR mqdes . The .I msg_len @@ -132,7 +132,7 @@ .IR mqdes . .TP .B EBADF -The descriptor specified in +The file descriptor specified in .I mqdes was invalid. .TP @@ -188,11 +188,11 @@ .BR mq_overview (7), .BR time (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/mq_unlink.3 manpages-4.05/man3/mq_unlink.3 --- manpages-4.04/man3/mq_unlink.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/mq_unlink.3 2016-03-15 03:47:40.000000000 +0000 @@ -82,11 +82,11 @@ .BR mq_send (3), .BR mq_overview (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/mtrace.3 manpages-4.05/man3/mtrace.3 --- manpages-4.04/man3/mtrace.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/mtrace.3 2016-03-15 03:47:40.000000000 +0000 @@ -190,11 +190,11 @@ .BR malloc_hook (3), .BR mcheck (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/nan.3 manpages-4.05/man3/nan.3 --- manpages-4.04/man3/nan.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/nan.3 2016-03-15 03:47:40.000000000 +0000 @@ -8,7 +8,7 @@ .\" .\" Corrections by aeb .\" -.TH NAN 3 2015-04-19 "GNU" "Linux Programmer's Manual" +.TH NAN 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME nan, nanf, nanl \- return 'Not a Number' .SH SYNOPSIS @@ -32,11 +32,7 @@ .BR nanf (), .BR nanl (): .RS 4 -_XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L .RE .ad .SH DESCRIPTION @@ -95,11 +91,11 @@ .BR strtod (3), .BR math_error (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/netlink.3 manpages-4.05/man3/netlink.3 --- manpages-4.04/man3/netlink.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/netlink.3 2016-03-15 03:47:40.000000000 +0000 @@ -92,11 +92,11 @@ .BR libnetlink (3), .BR netlink (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/newlocale.3 manpages-4.05/man3/newlocale.3 --- manpages-4.04/man3/newlocale.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/newlocale.3 2016-03-15 03:47:40.000000000 +0000 @@ -247,7 +247,6 @@ The format and language of the output will be affected by the .B LC_TIME setting. - .PP The following shell sessions show some example runs of this program. @@ -379,11 +378,11 @@ .BR locale (5), .BR locale (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/nextafter.3 manpages-4.05/man3/nextafter.3 --- manpages-4.04/man3/nextafter.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/nextafter.3 2016-03-15 03:47:40.000000000 +0000 @@ -8,7 +8,7 @@ .\" .\" Based on glibc infopages .\" -.TH NEXTAFTER 3 2015-04-19 "GNU" "Linux Programmer's Manual" +.TH NEXTAFTER 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME nextafter, nextafterf, nextafterl, nexttoward, nexttowardf, nexttowardl \- floating-point number manipulation @@ -37,23 +37,19 @@ .ad l .BR nextafter (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 || -_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED || -_ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || _XOPEN_SOURCE\ >=\ 500 +.\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .br .BR nextafterf (), .BR nextafterl (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .br .BR nexttoward (), @@ -61,10 +57,7 @@ .BR nexttowardl (): .RS 4 _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_POSIX_C_SOURCE\ >=\ 200112L .RE .ad b .SH DESCRIPTION @@ -207,11 +200,11 @@ .SH SEE ALSO .BR nearbyint (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/nl_langinfo.3 manpages-4.05/man3/nl_langinfo.3 --- manpages-4.04/man3/nl_langinfo.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/nl_langinfo.3 2016-03-15 03:47:40.000000000 +0000 @@ -205,11 +205,11 @@ .br The GNU C Library Reference Manual .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/ntp_adjtime.3 manpages-4.05/man3/ntp_adjtime.3 --- manpages-4.04/man3/ntp_adjtime.3 1970-01-01 00:00:00.000000000 +0000 +++ manpages-4.05/man3/ntp_adjtime.3 2016-03-15 03:47:38.000000000 +0000 @@ -0,0 +1 @@ +.so man2/adjtimex.2 diff -Nru manpages-4.04/man3/ntp_gettime.3 manpages-4.05/man3/ntp_gettime.3 --- manpages-4.04/man3/ntp_gettime.3 1970-01-01 00:00:00.000000000 +0000 +++ manpages-4.05/man3/ntp_gettime.3 2016-03-15 03:47:40.000000000 +0000 @@ -0,0 +1,158 @@ +.\" Copyright (c) 2016 by Michael Kerrisk +.\" +.\" %%%LICENSE_START(VERBATIM) +.\" Permission is granted to make and distribute verbatim copies of this +.\" manual provided the copyright notice and this permission notice are +.\" preserved on all copies. +.\" +.\" Permission is granted to copy and distribute modified versions of this +.\" manual under the conditions for verbatim copying, provided that the +.\" entire resulting derived work is distributed under the terms of a +.\" permission notice identical to this one. +.\" +.\" Since the Linux kernel and libraries are constantly changing, this +.\" manual page may be incorrect or out-of-date. The author(s) assume no +.\" responsibility for errors or omissions, or for damages resulting from +.\" the use of the information contained herein. The author(s) may not +.\" have taken the same level of care in the production of this manual, +.\" which is licensed free of charge, as they might when working +.\" professionally. +.\" +.\" Formatted or processed versions of this manual, if unaccompanied by +.\" the source, must acknowledge the copyright and authors of this work. +.\" %%%LICENSE_END +.\" +.TH NTP_GETTIME 3 2016-03-06 "Linux" "Linux Programmer's Manual" +.SH NAME +ntp_gettime, ntp_gettimex \- get time parameters (NTP daemon interface) +.SH SYNOPSIS +.nf +.B #include + +.BI "int ntp_gettime(struct ntptimeval *" ntv ); + +.BI "int ntp_gettimex(struct ntptimeval *" ntv ); +.fi +.SH DESCRIPTION +Both of these APIs return information to the caller via the +.I ntv +argument, a structure of the following type: + +.in +4n +.nf +struct ntptimeval { + struct timeval time; /* Current time */ + long int maxerror; /* Maximum error */ + long int esterror; /* Estimated error */ + long int tai; /* TAI offset */ + + /* Further padding bytes allowing for future expansion */ +}; +.fi +.in + +The fields of this structure are as follows: +.TP +.I time +The current time, expressed as a +.I timeval +structure: + +.in +4n +.nf +struct timeval { + time_t tv_sec; /* Seconds since the Epoch */ + suseconds_t tv_usec; /* Microseconds */ +}; + +.fi +.in +.TP +.I maxerror +Maximum error, in microseconds. +This value can be initialized by +.BR ntp_adjtime (3), +and is increased periodically (on Linux: each second), +but is clamped to an upper limit (the kernel constant +.BR NTP_PHASE_MAX , +with a value of 16,000). +.TP +.I esterror +Estimated error, in microseconds. +This value can be set via +.BR ntp_adjtime (3) +to contain an estimate of the difference between the system clock +and the true time. +This value is not used inside the kernel. +.TP +.I tai +TAI (Atomic International Time) offset. +.PP +.BR ntp_gettime () +returns an +.I ntptimeval +structure in which the +.IR time , +.IR maxerror , +and +.IR esterror +fields are filled in. +.PP +.BR ntp_gettimex () +performs the same task as +.BR ntp_gettime (), +but also returns information in the +.I tai +field. +.SH RETURN VALUE +The return values for +.BR ntp_gettime () +and +.BR ntp_gettimex () +are as for +.BR adjtimex (2). +Given a correct pointer argument, these functions always succeed. +.\" FIXME . the info page incorrectly describes the return values. +.SH ATTRIBUTES +For an explanation of the terms used in this section, see +.BR attributes (7). +.TS +allbox; +lbw30 lb lb +l l l. +Interface Attribute Value +T{ +.BR ntp_gettime (), +.BR ntp_gettimex () +T} Thread safety MT-Safe +.TE +.SH VERSIONS +The +.BR ntp_gettime () +function is available since glibc 2.1. +The +.BR ntp_gettimex () +function is available since glibc 2.12. +.SH CONFORMING TO +.BR ntp_gettime () +is described in the NTP Kernel Application Program Interface. +.BR ntp_gettimex () +is a GNU extension. +.SH SEE ALSO +.BR adjtimex (2) +.BR ntp_adjtime (3), +.BR time (7) + +.ad l +.UR http://www.slac.stanford.edu/comp/unix/\:package/\:rtems/\:src/\:ssrlApps/\:ntpNanoclock/\:api.htm +NTP "Kernel Application Program Interface" +.UE +.SH COLOPHON +This page is part of release 4.05 of the Linux +.I man-pages +project. +A description of the project, +information about reporting bugs, +and the latest version of this page, +can be found at +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/ntp_gettimex.3 manpages-4.05/man3/ntp_gettimex.3 --- manpages-4.04/man3/ntp_gettimex.3 1970-01-01 00:00:00.000000000 +0000 +++ manpages-4.05/man3/ntp_gettimex.3 2016-03-15 03:47:38.000000000 +0000 @@ -0,0 +1 @@ +.so man3/ntp_gettime.3 diff -Nru manpages-4.04/man3/offsetof.3 manpages-4.05/man3/offsetof.3 --- manpages-4.04/man3/offsetof.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/offsetof.3 2016-03-15 03:47:40.000000000 +0000 @@ -101,11 +101,11 @@ } .fi .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/on_exit.3 manpages-4.05/man3/on_exit.3 --- manpages-4.04/man3/on_exit.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/on_exit.3 2016-03-15 03:47:40.000000000 +0000 @@ -28,7 +28,7 @@ .\" 386BSD man pages .\" Modified 1993-04-02, David Metcalfe .\" Modified 1993-07-25, Rik Faith (faith@cs.unc.edu) -.TH ON_EXIT 3 2015-05-07 "GNU" "Linux Programmer's Manual" +.TH ON_EXIT 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME on_exit \- register a function to be called at normal process termination .SH SYNOPSIS @@ -44,7 +44,10 @@ .in .sp .BR on_exit (): -_BSD_SOURCE || _SVID_SOURCE + Since glibc 2.19: + _DEFAULT_SOURCE + Glibc 2.19 and earlier: + _BSD_SOURCE || _SVID_SOURCE .SH DESCRIPTION The .BR on_exit () @@ -102,11 +105,11 @@ .BR atexit (3), .BR exit (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/opendir.3 manpages-4.05/man3/opendir.3 --- manpages-4.04/man3/opendir.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/opendir.3 2016-03-15 03:47:40.000000000 +0000 @@ -29,7 +29,7 @@ .\" Modified Sat Jul 24 18:46:01 1993 by Rik Faith (faith@cs.unc.edu) .\" Modified 11 June 1995 by Andries Brouwer (aeb@cwi.nl) .\" 2007-07-30 Ulrich Drepper : document fdopendir(). -.TH OPENDIR 3 2015-12-28 "GNU" "Linux Programmer's Manual" +.TH OPENDIR 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME opendir, fdopendir \- open a directory .SH SYNOPSIS @@ -53,7 +53,7 @@ .RS 4 .TP 4 Since glibc 2.10: -_XOPEN_SOURCE\ >=\ 700 || _POSIX_C_SOURCE\ >=\ 200809L +_POSIX_C_SOURCE\ >=\ 200809L .TP Before glibc 2.10: _GNU_SOURCE @@ -134,6 +134,9 @@ .BR fdopendir () is specified in POSIX.1-2008. .SH NOTES +Filename entries can be read from a directory stream using +.BR readdir (3). + The underlying file descriptor of the directory stream can be obtained using .BR dirfd (3). @@ -160,11 +163,11 @@ .BR seekdir (3), .BR telldir (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/open_memstream.3 manpages-4.05/man3/open_memstream.3 --- manpages-4.04/man3/open_memstream.3 2015-12-29 12:51:43.000000000 +0000 +++ manpages-4.05/man3/open_memstream.3 2016-03-15 03:47:40.000000000 +0000 @@ -1 +1,154 @@ -.so man3/fmemopen.3 +.\" Copyright 2005, 2012, 2016 Michael Kerrisk +.\" +.\" %%%LICENSE_START(GPL_NOVERSION_ONELINE) +.\" Distributed under the GPL. +.\" %%%LICENSE_END +.\" +.\" 2008-12-04, Petr Baudis : Document open_wmemstream() +.\" +.TH OPEN_MEMSTREAM 3 2016-03-15 "GNU" "Linux Programmer's Manual" +.SH NAME +open_memstream, open_wmemstream \- open a dynamic memory buffer stream +.SH SYNOPSIS +.nf +.B #include + +.BI "FILE *open_memstream(char **" ptr ", size_t *" sizeloc ); + +.B #include + +.BI "FILE *open_wmemstream(wchar_t **" ptr ", size_t *" sizeloc ); +.fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.in +.sp +.BR open_memstream (), +.BR open_wmemstream (): +.PD 0 +.ad l +.RS 4 +.TP 4 +Since glibc 2.10: +_POSIX_C_SOURCE\ >=\ 200809L +.TP +Before glibc 2.10: +_GNU_SOURCE +.RE +.ad +.PD +.SH DESCRIPTION +The +.BR open_memstream () +function opens a stream for writing to a memory buffer. +The function dynamically allocates the buffer, +and the buffer automatically grows as needed. +Initially, the buffer has a size of zero. +After closing the stream, the caller should +.BR free (3) +this buffer. + +The locations pointed to by +.IR ptr +and +.I sizeloc +are used to report, respectively, +the current location and the size of the buffer. +The locations referred to by these pointers are updated +each time the stream is flushed +.RB ( fflush (3)) +and when the stream is closed +.RB ( fclose (3)). +These values remain valid only as long as the caller +performs no further output on the stream. +If further output is performed, then the stream +must again be flushed before trying to access these values. + +A null byte is maintained at the end of the buffer. +This byte is +.I not +included in the size value stored at +.IR sizeloc . + +The stream maintains the notion of a current position, +which is initially zero (the start of the buffer). +Each write operation implicitly adjusts the buffer position. +The stream's buffer position can be explicitly changed with +.BR fseek (3) +or +.BR fseeko (3). +Moving the buffer position past the end +of the data already written fills the intervening space with +null characters. + +The +.BR open_wmemstream () +is similar to +.BR open_memstream (), +but operates on wide characters instead of bytes. +.SH RETURN VALUE +Upon successful completion, +.BR open_memstream () +and +.BR open_wmemstream () +return a +.I FILE +pointer. +Otherwise, NULL is returned and +.I errno +is set to indicate the error. +.SH VERSIONS +.BR open_memstream () +was already available in glibc 1.0.x. +.BR open_wmemstream () +is available since glibc 2.4. +.SH ATTRIBUTES +For an explanation of the terms used in this section, see +.BR attributes (7). +.TS +allbox; +lb lb lb +l l l. +Interface Attribute Value +T{ +.BR open_memstream (), +.br +.BR open_wmemstream +T} Thread safety MT-Safe +.TE + +.SH CONFORMING TO +POSIX.1-2008. +These functions are not specified in POSIX.1-2001, +and are not widely available on other systems. +.SH NOTES +There is no file descriptor associated with the file stream +returned by these functions +(i.e., +.BR fileno (3) +will return an error if called on the returned stream). +.SH BUGS +In glibc before version 2.7, seeking past the end of a stream created by +.BR open_memstream () +does not enlarge the buffer; instead the +.BR fseek (3) +call fails, returning \-1. +.\" http://sourceware.org/bugzilla/show_bug.cgi?id=1996 +.SH EXAMPLE +See +.BR fmemopen (3). +.SH SEE ALSO +.BR fmemopen (3), +.BR fopen (3), +.BR setbuf (3) +.SH COLOPHON +This page is part of release 4.05 of the Linux +.I man-pages +project. +A description of the project, +information about reporting bugs, +and the latest version of this page, +can be found at +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/openpty.3 manpages-4.05/man3/openpty.3 --- manpages-4.04/man3/openpty.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/openpty.3 2016-03-15 03:47:40.000000000 +0000 @@ -197,11 +197,11 @@ .BR ttyname (3), .BR pty (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/open_wmemstream.3 manpages-4.05/man3/open_wmemstream.3 --- manpages-4.04/man3/open_wmemstream.3 2015-12-29 12:51:43.000000000 +0000 +++ manpages-4.05/man3/open_wmemstream.3 2016-03-15 03:47:38.000000000 +0000 @@ -1 +1 @@ -.so man3/fmemopen.3 +.so man3/open_memstream.3 diff -Nru manpages-4.04/man3/perror.3 manpages-4.05/man3/perror.3 --- manpages-4.04/man3/perror.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/perror.3 2016-03-15 03:47:40.000000000 +0000 @@ -28,7 +28,7 @@ .\" (msmith@falcon.mercer.peachnet.edu) and various other changes. .\" Modified 1996-05-16 by Martin Schulze (joey@infodrom.north.de) .\" -.TH PERROR 3 2015-07-23 "" "Linux Programmer's Manual" +.TH PERROR 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME perror \- print a system error message .SH SYNOPSIS @@ -51,7 +51,10 @@ .sp .IR sys_errlist , .IR sys_nerr : -_BSD_SOURCE + Since glibc 2.19: + _DEFAULT_SOURCE + Glibc 2.19 and earlier: + _BSD_SOURCE .SH DESCRIPTION The .BR perror () @@ -84,7 +87,9 @@ .IR sys_errlist "[]." The use of .IR sys_errlist "[]" -is nowadays deprecated. +is nowadays deprecated; use +.BR strerror (3) +instead When a system call fails, it usually returns \-1 and sets the variable @@ -98,7 +103,7 @@ serves to translate this error code into human-readable form. Note that .I errno -is undefined after a successful sysme call or library function call: +is undefined after a successful system call or library function call: this call may well change this variable, even though it succeeds, for example because it internally used some other library function that failed. Thus, if a failing call is not immediately followed by a call to @@ -150,11 +155,11 @@ .BR error (3), .BR strerror (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/popen.3 manpages-4.05/man3/popen.3 --- manpages-4.04/man3/popen.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/popen.3 2016-03-15 03:47:40.000000000 +0000 @@ -37,7 +37,7 @@ .\" Modified Sat May 18 20:37:44 1996 by Martin Schulze (joey@linux.de) .\" Modified 7 May 1998 by Joseph S. Myers (jsm28@cam.ac.uk) .\" -.TH POPEN 3 2015-08-08 "GNU" "Linux Programmer's Manual" +.TH POPEN 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME popen, pclose \- pipe stream to or from a process .SH SYNOPSIS @@ -58,7 +58,8 @@ .BR popen (), .BR pclose (): .RS 4 -_POSIX_C_SOURCE\ >=\ 2 || _XOPEN_SOURCE || _BSD_SOURCE || _SVID_SOURCE +_POSIX_C_SOURCE\ >=\ 2 + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .ad b .SH DESCRIPTION @@ -224,11 +225,11 @@ .BR stdio (3), .BR system (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/posix_fallocate.3 manpages-4.05/man3/posix_fallocate.3 --- manpages-4.04/man3/posix_fallocate.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/posix_fallocate.3 2016-03-15 03:47:40.000000000 +0000 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH POSIX_FALLOCATE 3 2015-12-05 "GNU" "Linux Programmer's Manual" +.TH POSIX_FALLOCATE 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME posix_fallocate \- allocate file space .SH SYNOPSIS @@ -40,14 +40,14 @@ .sp .BR posix_fallocate (): .RS 4 -_XOPEN_SOURCE\ >=\ 600 || _POSIX_C_SOURCE\ >=\ 200112L +_POSIX_C_SOURCE\ >=\ 200112L .RE .ad .SH DESCRIPTION The function .BR posix_fallocate () ensures that disk space is allocated for the file referred to by the -descriptor +file descriptor .I fd for the bytes in the range starting at .I offset @@ -98,6 +98,9 @@ .B ESPIPE .I fd refers to a pipe. +.TP +.B EINTR +A signal was caught during execution. .SH VERSIONS .BR posix_fallocate () is available since glibc 2.1.94. @@ -181,11 +184,11 @@ .BR lseek (2), .BR posix_fadvise (2) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/posix_madvise.3 manpages-4.05/man3/posix_madvise.3 --- manpages-4.04/man3/posix_madvise.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/posix_madvise.3 2016-03-15 03:47:40.000000000 +0000 @@ -17,7 +17,7 @@ .\" . .\" %%%LICENSE_END .\" -.TH POSIX_MADVISE 3 2015-02-03 Linux "Linux Programmer's Manual" +.TH POSIX_MADVISE 3 2016-03-15 Linux "Linux Programmer's Manual" .SH NAME posix_madvise \- give advice about patterns of memory usage .SH SYNOPSIS @@ -36,7 +36,7 @@ .br .RS 4 .ad l -_POSIX_C_SOURCE >= 200112L || _XOPEN_SOURCE >= 600 +_POSIX_C_SOURCE >= 200112L .RE .ad .SH DESCRIPTION @@ -133,11 +133,11 @@ .BR madvise (2), .BR posix_fadvise (2) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/posix_memalign.3 manpages-4.05/man3/posix_memalign.3 --- manpages-4.04/man3/posix_memalign.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/posix_memalign.3 2016-03-15 03:47:40.000000000 +0000 @@ -26,7 +26,7 @@ .\" 2001-10-11, 2003-08-22, aeb, added some details .\" 2012-03-23, Michael Kerrisk .\" Document pvalloc() and aligned_alloc() -.TH POSIX_MEMALIGN 3 2015-08-08 "GNU" "Linux Programmer's Manual" +.TH POSIX_MEMALIGN 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME posix_memalign, aligned_alloc, memalign, valloc, pvalloc \- allocate aligned memory .SH SYNOPSIS @@ -50,7 +50,7 @@ .sp .ad l .BR posix_memalign (): -_POSIX_C_SOURCE\ >=\ 200112L || _XOPEN_SOURCE\ >=\ 600 +_POSIX_C_SOURCE\ >=\ 200112L .sp .BR aligned_alloc (): _ISOC11_SOURCE @@ -62,16 +62,15 @@ .TP 4 Since glibc 2.12: .nf -_BSD_SOURCE || - (_XOPEN_SOURCE\ >=\ 500 || - _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED) && - !(_POSIX_C_SOURCE\ >=\ 200112L || _XOPEN_SOURCE\ >=\ 600) +(_XOPEN_SOURCE\ >=\ 500) && !(_POSIX_C_SOURCE\ >=\ 200112L) + || /* Glibc since 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _SVID_SOURCE || _BSD_SOURCE .br .fi .TP Before glibc 2.12: -_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 || -_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED +_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 +.\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED .ad b .br (The (nonstandard) header file @@ -152,9 +151,15 @@ next section on failure. The value of .I errno -is indeterminate after a call to -.BR posix_memalign (). -.SH ERRORS +is not set. +On Linux (and other systems), +.BR posix_memalign () +does not modify +.I memptr +on failure. +A requirement standardizing this behavior was added in POSIX.1-2016. +.\" http://austingroupbugs.net/view.php?id=520 +.SH "ERRORS" .TP .B EINVAL The @@ -297,11 +302,11 @@ .BR free (3), .BR malloc (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/posix_openpt.3 manpages-4.05/man3/posix_openpt.3 --- manpages-4.04/man3/posix_openpt.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/posix_openpt.3 2016-03-15 03:47:40.000000000 +0000 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH POSIX_OPENPT 3 2015-08-08 "" "Linux Programmer's Manual" +.TH POSIX_OPENPT 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME posix_openpt \- open a pseudoterminal device .SH SYNOPSIS @@ -63,7 +63,7 @@ On success, .BR posix_openpt () returns a nonnegative file descriptor which is the lowest -numbered unused descriptor. +numbered unused file descriptor. On failure, \-1 is returned, and .I errno is set to indicate the error. @@ -122,11 +122,11 @@ .BR pts (4), .BR pty (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/posix_spawn.3 manpages-4.05/man3/posix_spawn.3 --- manpages-4.04/man3/posix_spawn.3 1970-01-01 00:00:00.000000000 +0000 +++ manpages-4.05/man3/posix_spawn.3 2016-03-15 03:47:40.000000000 +0000 @@ -0,0 +1,816 @@ +.\" Copyright (c) 2009 Bill O. Gallmeister (bgallmeister@gmail.com) +.\" and Copyright 2010 Michael Kerrisk +.\" +.\" %%%LICENSE_START(VERBATIM) +.\" Permission is granted to make and distribute verbatim copies of this +.\" manual provided the copyright notice and this permission notice are +.\" preserved on all copies. +.\" +.\" Permission is granted to copy and distribute modified versions of this +.\" manual under the conditions for verbatim copying, provided that the +.\" entire resulting derived work is distributed under the terms of a +.\" permission notice identical to this one. +.\" +.\" Since the Linux kernel and libraries are constantly changing, this +.\" manual page may be incorrect or out-of-date. The author(s) assume no +.\" responsibility for errors or omissions, or for damages resulting from +.\" the use of the information contained herein. The author(s) may not +.\" have taken the same level of care in the production of this manual, +.\" which is licensed free of charge, as they might when working +.\" professionally. +.\" +.\" Formatted or processed versions of this manual, if unaccompanied by +.\" the source, must acknowledge the copyright and authors of this work. +.\" %%%LICENSE_END +.\" +.\" References consulted: +.\" Linux glibc source code +.\" POSIX 1003.1-2004 documentation +.\" (http://www.opengroup.org/onlinepubs/009695399) +.\" +.TH POSIX_SPAWN 3 2016-03-15 "GNU" "Linux Programmer's Manual" +.SH NAME +posix_spawn, posix_spawnp \- spawn a process +.SH SYNOPSIS +.nf +.B #include + +.BI "int posix_spawn(pid_t *" pid ", const char *" path , +.BI " const posix_spawn_file_actions_t *" file_actions , +.BI " const posix_spawnattr_t *" attrp , +.BI " char *const " argv[] ", char *const " envp[] ); + +.BI "int posix_spawnp(pid_t *" pid ", const char *" file , +.BI " const posix_spawn_file_actions_t *" file_actions , +.BI " const posix_spawnattr_t *" attrp , +.BI " char *const " argv[] ", char *const " envp[] ); +.fi +.SH DESCRIPTION +The +.BR posix_spawn () +and +.BR posix_spawnp () +functions are used to create a new child process that executes +a specified file. +These functions were specified by POSIX to provide a standardized method +of creating new processes on machines that lack the capability +to support the +.BR fork (2) +system call. +These machines are generally small, embedded systems lacking MMU support. + +The +.BR posix_spawn () +and +.BR posix_spawnp () +functions provide the functionality of a combined +.BR fork (2) +and +.BR exec (3), +with some optional housekeeping steps in the child process before the +.BR exec (3). +These functions are not meant to replace the +.BR fork (2) +and +.BR execve (2) +system calls. +In fact, they provide only a subset of the functionality +that can be achieved by using the system calls. + +The only difference between +.BR posix_spawn () +and +.BR posix_spawnp () +is the manner in which they specify the file to be executed by +the child process. +With +.BR posix_spawn (), +the executable file is specified as a pathname +(which can be absolute or relative). +With +.BR posix_spawnp (), +the executable file is specified as a simple filename; +the system searches for this file in the list of directories specified by +.BR PATH +(in the same way as for +.BR execvp (3)). +For the remainder of this page, the discussion is phrased in terms of +.BR posix_spawn (), +with the understanding that +.BR posix_spawn () +differs only on the point just described. + +The remaining arguments to these two functions are as follows: +.IP * 3 +The +.I pid +argument points to a buffer that is used to return the process ID +of the new child process. +.IP * +The +.I file_actions +argument points to a +.I "spawn file actions object" +that specifies file-related actions to be performed in the child +between the +.BR fork (2) +and +.BR exec (3) +steps. +This object is initialized and populated before the +.BR posix_spawn () +call using +.BR posix_spawn_file_actions_init (3) +and the +.BR posix_spawn_file_actions_* () +functions. +.IP * +The +.I attrp +argument points to an +.I attributes objects +that specifies various attributes of the created child process. +This object is initialized and populated before the +.BR posix_spawn () +call using +.BR posix_spawnattr_init (3) +and the +.BR posix_spawnattr_* () +functions. +.IP * +The +.I argv +and +.I envp +arguments specify the argument list and environment for the program +that is executed in the child process, as for +.BR execve (2). +.PP +Below, the functions are described in terms of a three-step process: the +.BR fork() +step, the +.RB pre- exec () +step (executed in the child), +and the +.BR exec () +step (executed in the child). +.SS fork() step +The +.BR posix_spawn () +function commences by calling +.BR fork (2), +or possibly +.BR vfork (2) +(see below). + +The PID of the new child process is placed in +.IR *pid . +The +.BR posix_spawn () +function then returns control to the parent process. + +Subsequently, the parent can use one of the system calls described in +.BR wait (2) +to check the status of the child process. +If the child fails in any of the housekeeping steps described below, +or fails to execute the desired file, +it exits with a status of 127. + +The child process is created using +.BR vfork (2) +instead of +.BR fork (2) +when either of the following is true: +.IP * 3 +the +.I spawn-flags +element of the attributes object pointed to by +.I attrp +contains the GNU-specific flag +.BR POSIX_SPAWN_USEVFORK ; +or +.IP * +.I file_actions +is NULL and the +.I spawn-flags +element of the attributes object pointed to by +.I attrp +does \fInot\fP contain +.BR POSIX_SPAWN_SETSIGMASK , +.BR POSIX_SPAWN_SETSIGDEF , +.BR POSIX_SPAWN_SETSCHEDPARAM , +.BR POSIX_SPAWN_SETSCHEDULER , +.BR POSIX_SPAWN_SETPGROUP , +or +.BR POSIX_SPAWN_RESETIDS . +.LP +In other words, +.BR vfork (2) +is used if the caller requests it, +or if there is no cleanup expected in the child before it +.BR exec (3)s +the requested file. + +.SS pre-exec() step: housekeeping +In between the +.BR fork (2) +and the +.BR exec (3), +a child process may need to perform a set of housekeeping actions. +The +.BR posix_spawn () +and +.BR posix_spawnp () +functions support a small, well-defined set of system tasks that the child +process can accomplish before it executes the executable file. +These operations are controlled by the attributes object pointed to by +.IR attrp +and the file actions object pointed to by +.IR file_actions . +In the child, processing is done in the following sequence: +.IP 1. 3 +Process attribute actions: signal mask, signal default handlers, +scheduling algorithm and parameters, +process group, and effective user and group IDs +are changed as specified by the attributes object pointed to by +.IR attrp . +.IP 2. +File actions, as specified in the +.I file_actions +argument, +are performed in the order that they were specified using calls to the +.BR posix_spawn_file_actions_add* () +functions. +.IP 3. +File descriptors with the +.B FD_CLOEXEC +flag set are closed. +.LP +All process attributes in the child, +other than those affected by attributes specified in the +object pointed to by +.IR attrp +and the file actions in the object pointed to by +.IR file_actions , +will be affected as though the child was created with +.BR fork (2) +and it executed the program with +.BR execve (2). + +The process attributes actions are defined by the attributes object +pointed to by +.IR attrp . +The +.I spawn-flags +attribute (set using +.BR posix_spawnattr_setflags (3)) +controls the general actions that occur, +and other attributes in the object specify values +to be used during those actions. +.LP +The effects of the flags that may be specified in +.IR spawn-flags +are as follows: +.TP 8 +.B POSIX_SPAWN_SETSIGMASK +Set the signal mask to the signal set specified in the +.I spawn-sigmask +attribute +.\" FIXME . +.\" (see +.\" .BR posix_spawnattr_setsigmask (3)) +of the object pointed to by +.IR attrp . +If the +.B POSIX_SPAWN_SETSIGMASK +flag is not set, then the child inherits the parent's signal mask. +.TP +.B POSIX_SPAWN_SETSIGDEF +Reset the disposition of all signals in the set specified in the +.I spawn-sigdefault +attribute +.\" FIXME . +.\" (see +.\" .BR posix_spawnattr_setsigdefault (3)) +of the object pointed to by +.IR attrp +to the default. +For the treatment of the dispositions of signals not specified in the +.I spawn-sigdefault +attribute, or the treatment when +.B POSIX_SPAWN_SETSIGDEF +is not specified, see +.BR execve (2). +.TP +.B POSIX_SPAWN_SETSCHEDPARAM +.\" (POSIX_PRIORITY_SCHEDULING only) +If this flag is set, and the +.B POSIX_SPAWN_SETSCHEDULER +flag is not set, then set the scheduling parameters +to the parameters specified in the +.I spawn-schedparam +attribute +.\" FIXME . +.\" (see +.\" .BR posix_spawnattr_setschedparam (3)) +of the object pointed to by +.IR attrp . +.TP +.B POSIX_SPAWN_SETSCHEDULER +Set the scheduling policy algorithm and parameters of the child, +as follows: +.RS +.IP * 3 +The scheduling policy is set to the value specified in the +.I spawn-schedpolicy +attribute +.\" FIXME . +.\" (see +.\" .BR posix_spawnattr_setpolicy (3)) +of the object pointed to by +.IR attrp . +.IP * +The scheduling parameters are set to the value specified in the +.I spawn-schedparam +attribute +.\" FIXME . +.\" (see +.\" .BR posix_spawnattr_setschedparam (3)) +of the object pointed to by +.IR attrp +(but see BUGS). +.LP +If the +.B POSIX_SPAWN_SETSCHEDPARAM +and +.B POSIX_SPAWN_SETSCHEDPOLICY +flags are not specified, +the child inherits the corresponding scheduling attributes from the parent. +.RE +.TP +.B POSIX_SPAWN_RESETIDS +If this flag is set, +reset the effective UID and GID to the +real UID and GID of the parent process. +If this flag is not set, +then the child retains the effective UID and GID of the parent. +In either case, if the set-user-ID and set-group-ID permission +bits are enabled on the executable file, their effect will override +the setting of the effective UID and GID (se +.BR execve (2)). +.TP +.B POSIX_SPAWN_SETPGROUP +Set the process group to the value specified in the +.I spawn-pgroup +attribute +.\" FIXME . +.\" (see +.\" .BR posix_spawnattr_setpgroup (3)) +of the object pointed to by +.IR attrp . +If the +.I spawn-pgroup +attribute has the value 0, +the child's process group ID is made the same as its process ID. +If the +.B POSIX_SPAWN_SETPGROUP +flag is not set, the child inherits the parent's process group ID. +.LP +If +.I attrp +is NULL, then the default behaviors described above for each flag apply. +.\" mtk: I think we probably don't want to say the following, since it +.\" could lead people to do the wrong thing +.\" The POSIX standard tells you to call +.\" this function to de-initialize the attributes object pointed to by +.\" .I attrp +.\" when you are done with it; +.\" however, on Linux systems this operation is a no-op. + +The +.I file_actions +argument specifies a sequence of file operations +that are performed in the child process after +the general processing described above, and before it performs the +.BR exec (3). +If +.I file_actions +is NULL, then no special action is taken, and standard +.BR exec (3) +semantics apply--file descriptors open before the exec +remain open in the new process, +except those for which the +.B FD_CLOEXEC +flag has been set. +File locks remain in place. +.LP +If +.I file_actions +is not NULL, then it contains an ordered set of requests to +.BR open (2), +.BR close (2), +and +.BR dup2 (2) +files. +These requests are added to the +.I file_actions +by +.BR posix_spawn_file_actions_addopen (3), +.BR posix_spawn_file_actions_addclose (3), +and +.BR posix_spawn_file_actions_adddup2 (3). +The requested operations are performed in the order they were added to +.IR file_actions . +.\" FIXME . I think the following is best placed in the +.\" posix_spawn_file_actions_adddup2(3) page, and a similar statement is +.\" also needed in posix_spawn_file_actions_addclose(3) +.\" Note that you can specify file descriptors in +.\" .I posix_spawn_file_actions_adddup2 (3) +.\" which would not be usable if you called +.\" .BR dup2 (2) +.\" at that time--i.e., file descriptors that are opened or +.\" closed by the earlier operations +.\" added to +.\" .I file_actions . + +If any of the housekeeping actions fails +(due to bogus values being passed or other reasons why signal handling, +process scheduling, process group ID functions, +and file descriptor operations might fail), +the child process exits with exit value 127. +.SS exec() step +Once the child has successfully forked and performed +all requested pre-exec steps, +the child runs the requested executable. +.LP +The child process takes its environment from the +.I envp +argument, which is interpreted as if it had been passed to +.BR execve (2). +The arguments to the created process come from the +.I argv +argument, which is processed as for +.BR execve (2). +.SH RETURN VALUE +Upon successful completion, +.BR posix_spawn () +and +.BR posix_spawnp () +place the PID of the child process in +.IR pid , +and return 0. +If there is an error before or during the +.BR fork (2), +then no child is created, +the contents of +.IR *pid +are unspecified, +and these functions return an error number as described below. + +Even when these functions return a success status, +the child process may still fail for a plethora of reasons related to its +pre-\fBexec\fR() initialization. +In addition, the +.BR exec (3) +may fail. +In all of these cases, the child process will exit with the exit value of 127. +.SH ERRORS +The +.BR posix_spawn () +and +.BR posix_spawnp () +functions fail only in the case where the underlying +.BR fork (2) +or +.BR vfork (2) +call fails; in these cases, these functions return an error number, +which will be one of the errors described for +.BR fork (2) +or +.BR vfork (2). +.LP +In addition, these functions fail if: +.TP +.B ENOSYS +Function not supported on this system. +.SH NOTES +The housekeeping activities in the child are controlled by +the objects pointed to by +.I attrp +(for non-file actions) and +.I file_actions +In POSIX parlance, the +.I posix_spawnattr_t +and +.I posix_spawn_file_actions_t +data types are referred to as objects, +and their elements are not specified by name. +Portable programs should initialize these objects using +only the POSIX-specified functions. +(In other words, +although these objects may be implemented as structures containing fields, +portable programs must avoid dependence on such implementation details.) + +According to POSIX, it unspecified whether fork handlers established with +.BR pthread_atfork (3) +are called when +.BR posix_spawn () +is invoked. +On glibc, +.\" Tested on glibc 2.12 +fork handlers are called only if the child is created using +.BR fork (2). + +There is no "posix_fspawn" function (i.e., a function that is to +.BR posix_spawn () +as +.BR fexecve (3) +is to +.BR execve (2)). +However, this functionality can be obtained by specifying the +.I path +argument as one of the files in the caller's +.IR /proc/self/fd +directory. +.SH VERSIONS +The +.BR posix_spawn () +and +.BR posix_spawnp () +functions are available since glibc 2.2. +.SH CONFORMING TO +.LP +POSIX.1-2001, POSIX.1-2008. +.\" FIXME . This piece belongs in spawnattr_setflags(3) +.\" The +.\" .B POSIX_SPAWN_USEVFORK +.\" flag is a GNU extension; the +.\" .B _GNU_SOURCE +.\" feature test macro must be defined (before including any header files) +.\" to obtain the definition of this constant. +.SH BUGS +POSIX.1 says that when +.B POSIX_SPAWN_SETSCHEDULER +is specified in +.IR spawn-flags , +then the +.B POSIX_SPAWN_SETSCHEDPARAM +(if present) is ignored. +However, before glibc 2.14, calls to +.BR posix_spawn () +failed with an error if +.\" http://sourceware.org/bugzilla/show_bug.cgi?id=12052 +.BR POSIX_SPAWN_SETSCHEDULER +was specified without also specifying +.BR POSIX_SPAWN_SETSCHEDPARAM . +.SH EXAMPLE +The program below demonstrates the use of various functions in the +POSIX spawn API. +The program accepts command-line attributes that can be used +to create file actions and attributes objects. +The remaining command-line arguments are used as the executable name +and command-line arguments of the program that is executed in the child. + +In the first run, the +.BR date (1) +command is executed in the child, and the +.BR posix_spawn () +call employs no file actions or attributes objects. +.sp +.in +4 +.nf +$ \fB./a.out date\fP +PID of child: 7634 +Tue Feb 1 19:47:50 CEST 2011 +Child status: exited, status=0 +.fi +.in +.sp +In the next run, the +.I \-c +command-line option is used to create a file actions object that closes +standard output in the child. +Consequently, +.BR date (1) +fails when trying to perform output and exits with a status of 1. +.sp +.in +4 +.nf +$ \fB./a.out -c date\fP +PID of child: 7636 +date: write error: Bad file descriptor +Child status: exited, status=1 +.fi +.in +.sp +In the next run, the +.I \-s +command-line option is used to create an attributes object that +specifies that all (blockable) signals in the child should be blocked. +Consequently, trying to kill child with the default signal sent by +.BR kill (1) +(i.e., +.BR SIGTERM ) +fails, because that signal is blocked. +Therefore, to kill the child, +.BR SIGKILL +is necessary +.RB ( SIGKILL +can't be blocked). +.sp +.in +4 +.nf +$ \fB./a.out -s sleep 60 &\fP +[1] 7637 +$ PID of child: 7638 + +$ \fBkill 7638\fP +$ \fBkill -KILL 7638\fP +$ Child status: killed by signal 9 +[1]+ Done ./a.out -s sleep 60 +.fi +.in +.sp +When we try to execute a nonexistent command in the child, the +.BR exec (3) +fails and the child exits with a status of 127. +.sp +.in +4 +.nf +$ \fB./a.out xxxxx +PID of child: 10190 +Child status: exited, status=127 +.fi +.in +.SS Program source +.nf +#include +#include +#include +#include +#include +#include +#include + +#define errExit(msg) do { perror(msg); \\ + exit(EXIT_FAILURE); } while (0) + +#define errExitEN(en, msg) \\ + do { errno = en; perror(msg); \\ + exit(EXIT_FAILURE); } while (0) + +char **environ; + +int +main(int argc, char *argv[]) +{ + pid_t child_pid; + int s, opt, status; + sigset_t mask; + posix_spawnattr_t attr; + posix_spawnattr_t *attrp; + posix_spawn_file_actions_t file_actions; + posix_spawn_file_actions_t *file_actionsp; + + /* Parse command\-line options, which can be used to specify an + attributes object and file actions object for the child. */ + + attrp = NULL; + file_actionsp = NULL; + + while ((opt = getopt(argc, argv, "sc")) != \-1) { + switch (opt) { + case \(aqc\(aq: /* \-c: close standard output in child */ + + /* Create a file actions object and add a "close" + action to it */ + + s = posix_spawn_file_actions_init(&file_actions); + if (s != 0) + errExitEN(s, "posix_spawn_file_actions_init"); + + s = posix_spawn_file_actions_addclose(&file_actions, + STDOUT_FILENO); + if (s != 0) + errExitEN(s, "posix_spawn_file_actions_addclose"); + + file_actionsp = &file_actions; + break; + + case \(aqs\(aq: /* \-s: block all signals in child */ + + /* Create an attributes object and add a "set signal mask" + action to it */ + + s = posix_spawnattr_init(&attr); + if (s != 0) + errExitEN(s, "posix_spawnattr_init"); + s = posix_spawnattr_setflags(&attr, POSIX_SPAWN_SETSIGMASK); + if (s != 0) + errExitEN(s, "posix_spawnattr_setflags"); + + sigfillset(&mask); + s = posix_spawnattr_setsigmask(&attr, &mask); + if (s != 0) + errExitEN(s, "posix_spawnattr_setsigmask"); + + attrp = &attr; + break; + } + } + + /* Spawn the child. The name of the program to execute and the + command\-line arguments are taken from the command\-line arguments + of this program. The environment of the program execed in the + child is made the same as the parent\(aqs environment. */ + + s = posix_spawnp(&child_pid, argv[optind], file_actionsp, attrp, + &argv[optind], environ); + if (s != 0) + errExitEN(s, "posix_spawn"); + + /* Destroy any objects that we created earlier */ + + if (attrp != NULL) { + s = posix_spawnattr_destroy(attrp); + if (s != 0) + errExitEN(s, "posix_spawnattr_destroy"); + } + + if (file_actionsp != NULL) { + s = posix_spawn_file_actions_destroy(file_actionsp); + if (s != 0) + errExitEN(s, "posix_spawn_file_actions_destroy"); + } + + printf("PID of child: %ld\\n", (long) child_pid); + + /* Monitor status of the child until it terminates */ + + do { + s = waitpid(child_pid, &status, WUNTRACED | WCONTINUED); + if (s == \-1) + errExit("waitpid"); + + printf("Child status: "); + if (WIFEXITED(status)) { + printf("exited, status=%d\\n", WEXITSTATUS(status)); + } else if (WIFSIGNALED(status)) { + printf("killed by signal %d\\n", WTERMSIG(status)); + } else if (WIFSTOPPED(status)) { + printf("stopped by signal %d\\n", WSTOPSIG(status)); + } else if (WIFCONTINUED(status)) { + printf("continued\\n"); + } + } while (!WIFEXITED(status) && !WIFSIGNALED(status)); + + exit(EXIT_SUCCESS); +} +.fi +.SH SEE ALSO +.nh \" Disable hyphenation +.ad l +.BR close (2), +.BR dup2 (2), +.BR execl (2), +.BR execlp (2), +.BR fork (2), +.BR open (2), +.BR sched_setparam (2), +.BR sched_setscheduler (2), +.BR setpgid (2), +.BR setuid (2), +.BR sigaction (2), +.BR sigprocmask (2), +.BR posix_spawn_file_actions_addclose (3), +.BR posix_spawn_file_actions_adddup2 (3), +.BR posix_spawn_file_actions_addopen (3), +.BR posix_spawn_file_actions_destroy (3), +.BR posix_spawn_file_actions_init (3), +.BR posix_spawnattr_destroy (3), +.BR posix_spawnattr_getflags (3), +.BR posix_spawnattr_getpgroup (3), +.BR posix_spawnattr_getschedparam (3), +.BR posix_spawnattr_getschedpolicy (3), +.BR posix_spawnattr_getsigdefault (3), +.BR posix_spawnattr_getsigmask (3), +.BR posix_spawnattr_init (3), +.BR posix_spawnattr_setflags (3), +.BR posix_spawnattr_setpgroup (3), +.BR posix_spawnattr_setschedparam (3), +.BR posix_spawnattr_setschedpolicy (3), +.BR posix_spawnattr_setsigdefault (3), +.BR posix_spawnattr_setsigmask (3), +.BR pthread_atfork (3), +.BR , +Base Definitions volume of POSIX.1-2001, +.I http://www.opengroup.org/unix/online.html +.SH COLOPHON +This page is part of release 4.05 of the Linux +.I man-pages +project. +A description of the project, +information about reporting bugs, +and the latest version of this page, +can be found at +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/posix_spawnp.3 manpages-4.05/man3/posix_spawnp.3 --- manpages-4.04/man3/posix_spawnp.3 1970-01-01 00:00:00.000000000 +0000 +++ manpages-4.05/man3/posix_spawnp.3 2016-03-15 03:47:38.000000000 +0000 @@ -0,0 +1 @@ +.so man3/posix_spawn.3 diff -Nru manpages-4.04/man3/pow10.3 manpages-4.05/man3/pow10.3 --- manpages-4.04/man3/pow10.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/pow10.3 2016-03-15 03:47:40.000000000 +0000 @@ -66,11 +66,11 @@ .BR exp10 (3), .BR pow (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/pow.3 manpages-4.05/man3/pow.3 --- manpages-4.04/man3/pow.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/pow.3 2016-03-15 03:47:40.000000000 +0000 @@ -32,7 +32,7 @@ .\" Modified 1995-08-14 by Arnt Gulbrandsen .\" Modified 2002-07-27 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) -.TH POW 3 2015-04-19 "" "Linux Programmer's Manual" +.TH POW 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME pow, powf, powl \- power functions .SH SYNOPSIS @@ -57,11 +57,9 @@ .BR powf (), .BR powl (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .ad .SH DESCRIPTION @@ -393,11 +391,11 @@ .BR cpow (3), .BR sqrt (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/__ppc_get_timebase.3 manpages-4.05/man3/__ppc_get_timebase.3 --- manpages-4.04/man3/__ppc_get_timebase.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/__ppc_get_timebase.3 2016-03-15 03:47:40.000000000 +0000 @@ -111,11 +111,11 @@ .BR time (2), .BR usleep (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/__ppc_set_ppr_med.3 manpages-4.05/man3/__ppc_set_ppr_med.3 --- manpages-4.04/man3/__ppc_set_ppr_med.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/__ppc_set_ppr_med.3 2016-03-15 03:47:40.000000000 +0000 @@ -120,11 +120,11 @@ .IR "Power ISA, Book\ II - Section\ 3.1 (Program Priority Registers)" .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/__ppc_yield.3 manpages-4.05/man3/__ppc_yield.3 --- manpages-4.04/man3/__ppc_yield.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/__ppc_yield.3 2016-03-15 03:47:40.000000000 +0000 @@ -83,11 +83,11 @@ .IR "Power ISA, Book\ II - Section\ 3.2 (""or"" architecture)" .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/printf.3 manpages-4.05/man3/printf.3 --- manpages-4.04/man3/printf.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/printf.3 2016-03-15 03:47:40.000000000 +0000 @@ -31,7 +31,7 @@ .\" 2000-07-26 jsm28@hermes.cam.ac.uk - three small fixes .\" 2000-10-16 jsm28@hermes.cam.ac.uk - more fixes .\" -.TH PRINTF 3 2015-08-08 "GNU" "Linux Programmer's Manual" +.TH PRINTF 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME printf, fprintf, dprintf, sprintf, snprintf, vprintf, vfprintf, vdprintf, vsprintf, vsnprintf \- formatted output conversion @@ -70,11 +70,8 @@ .BR snprintf (), .BR vsnprintf (): .RS 4 -_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I "cc -std=c99" +_XOPEN_SOURCE\ >=\ 500 || _ISOC99_SOURCE || + || /* Glibc versions <= 2.19: */ _BSD_SOURCE .RE .sp .BR dprintf (), @@ -83,7 +80,7 @@ .RS 4 .TP 4 Since glibc 2.10: -_XOPEN_SOURCE\ >=\ 700 || _POSIX_C_SOURCE\ >=\ 200809L +_POSIX_C_SOURCE\ >=\ 200809L .TP Before glibc 2.10: _GNU_SOURCE @@ -678,7 +675,7 @@ The C99 standard specifies "[\-]inf" or "[\-]infinity" for infinity, and a string starting with "nan" for NaN, in the case of .B f -conversion, and "[\-]INF" or "[\-]INFINITY" or "NAN*" in the case of +conversion, and "[\-]INF" or "[\-]INFINITY" or "NAN" in the case of .B F conversion.) .TP @@ -1159,11 +1156,11 @@ .BR wprintf (3), .BR locale (5) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/profil.3 manpages-4.05/man3/profil.3 --- manpages-4.04/man3/profil.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/profil.3 2016-03-15 03:47:40.000000000 +0000 @@ -25,7 +25,7 @@ .\" Modified Fri Jun 23 01:35:19 1995 Andries Brouwer .\" (prompted by Bas V. de Bakker ) .\" Corrected (and moved to man3), 980612, aeb -.TH PROFIL 3 2015-07-23 "Linux" "Linux Programmer's Manual" +.TH PROFIL 3 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME profil \- execution time profile .SH SYNOPSIS @@ -42,7 +42,15 @@ .in .sp .BR profil (): -_BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE\ <\ 500) +.nf + Since glibc 2.21: +.\" commit 266865c0e7b79d4196e2cc393693463f03c90bd8 + _DEFAULT_SOURCE + In glibc 2.19 and 2.20: + _DEFAULT_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE\ <\ 500) + Up to and including glibc 2.19: + _BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE\ <\ 500) +.fi .SH DESCRIPTION This routine provides a means to find out in what areas your program spends most of its time. @@ -98,11 +106,11 @@ .BR sigaction (2), .BR signal (2) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/program_invocation_name.3 manpages-4.05/man3/program_invocation_name.3 --- manpages-4.04/man3/program_invocation_name.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/program_invocation_name.3 2016-03-15 03:47:41.000000000 +0000 @@ -63,11 +63,11 @@ .SH SEE ALSO .BR proc (5) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/psignal.3 manpages-4.05/man3/psignal.3 --- manpages-4.04/man3/psignal.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/psignal.3 2016-03-15 03:47:41.000000000 +0000 @@ -27,7 +27,7 @@ .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified Sat Jul 24 18:45:17 1993 by Rik Faith (faith@cs.unc.edu) -.TH PSIGNAL 3 2015-07-23 "GNU" "Linux Programmer's Manual" +.TH PSIGNAL 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME psignal, psiginfo \- print signal message .SH SYNOPSIS @@ -46,13 +46,19 @@ .in .sp .BR psignal (): -_SVID_SOURCE || _BSD_SOURCE + Since glibc 2.19: + _DEFAULT_SOURCE + Glibc 2.19 and earlier: + _BSD_SOURCE || _SVID_SOURCE .br .BR psiginfo (): -_XOPEN_SOURCE\ >=\ 700 || _POSIX_C_SOURCE\ >=\ 200809L +_POSIX_C_SOURCE\ >=\ 200809L .br .IR sys_siglist : -_BSD_SOURCE + Since glibc 2.19: + _DEFAULT_SOURCE + Glibc 2.19 and earlier: + _BSD_SOURCE .SH DESCRIPTION The .BR psignal () @@ -130,11 +136,11 @@ .BR strsignal (3), .BR signal (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/pthread_attr_init.3 manpages-4.05/man3/pthread_attr_init.3 --- manpages-4.04/man3/pthread_attr_init.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/pthread_attr_init.3 2016-03-15 03:47:41.000000000 +0000 @@ -325,11 +325,11 @@ .BR pthread_getattr_np (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/pthread_attr_setaffinity_np.3 manpages-4.05/man3/pthread_attr_setaffinity_np.3 --- manpages-4.04/man3/pthread_attr_setaffinity_np.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/pthread_attr_setaffinity_np.3 2016-03-15 03:47:41.000000000 +0000 @@ -136,11 +136,11 @@ .BR cpuset (7), .BR pthreads (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/pthread_attr_setdetachstate.3 manpages-4.05/man3/pthread_attr_setdetachstate.3 --- manpages-4.04/man3/pthread_attr_setdetachstate.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/pthread_attr_setdetachstate.3 2016-03-15 03:47:41.000000000 +0000 @@ -128,11 +128,11 @@ .BR pthread_join (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/pthread_attr_setguardsize.3 manpages-4.05/man3/pthread_attr_setguardsize.3 --- manpages-4.04/man3/pthread_attr_setguardsize.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/pthread_attr_setguardsize.3 2016-03-15 03:47:41.000000000 +0000 @@ -177,11 +177,11 @@ .BR pthread_create (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/pthread_attr_setinheritsched.3 manpages-4.05/man3/pthread_attr_setinheritsched.3 --- manpages-4.04/man3/pthread_attr_setinheritsched.3 2015-12-29 12:51:46.000000000 +0000 +++ manpages-4.05/man3/pthread_attr_setinheritsched.3 2016-03-15 03:47:41.000000000 +0000 @@ -154,11 +154,11 @@ .BR pthreads (7), .BR sched (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/pthread_attr_setschedparam.3 manpages-4.05/man3/pthread_attr_setschedparam.3 --- manpages-4.04/man3/pthread_attr_setschedparam.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/pthread_attr_setschedparam.3 2016-03-15 03:47:41.000000000 +0000 @@ -139,11 +139,11 @@ .BR pthreads (7), .BR sched (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/pthread_attr_setschedpolicy.3 manpages-4.05/man3/pthread_attr_setschedpolicy.3 --- manpages-4.04/man3/pthread_attr_setschedpolicy.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/pthread_attr_setschedpolicy.3 2016-03-15 03:47:41.000000000 +0000 @@ -127,11 +127,11 @@ .BR pthreads (7), .BR sched (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/pthread_attr_setscope.3 manpages-4.05/man3/pthread_attr_setscope.3 --- manpages-4.04/man3/pthread_attr_setscope.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/pthread_attr_setscope.3 2016-03-15 03:47:41.000000000 +0000 @@ -153,11 +153,11 @@ .BR pthread_create (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/pthread_attr_setstack.3 manpages-4.05/man3/pthread_attr_setstack.3 --- manpages-4.04/man3/pthread_attr_setstack.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/pthread_attr_setstack.3 2016-03-15 03:47:41.000000000 +0000 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH PTHREAD_ATTR_SETSTACK 3 2015-08-08 "Linux" "Linux Programmer's Manual" +.TH PTHREAD_ATTR_SETSTACK 3 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME pthread_attr_setstack, pthread_attr_getstack \- set/get stack attributes in thread attributes object @@ -48,7 +48,7 @@ .BR pthread_attr_getstack (), .BR pthread_attr_setstack (): .RS 4 -_POSIX_C_SOURCE\ >=\ 200112L || _XOPEN_SOURCE\ >=\ 600 +_POSIX_C_SOURCE\ >=\ 200112L .RE .ad b .SH DESCRIPTION @@ -178,11 +178,11 @@ .BR pthread_create (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/pthread_attr_setstackaddr.3 manpages-4.05/man3/pthread_attr_setstackaddr.3 --- manpages-4.04/man3/pthread_attr_setstackaddr.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/pthread_attr_setstackaddr.3 2016-03-15 03:47:41.000000000 +0000 @@ -127,11 +127,11 @@ .BR pthread_create (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/pthread_attr_setstacksize.3 manpages-4.05/man3/pthread_attr_setstacksize.3 --- manpages-4.04/man3/pthread_attr_setstacksize.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/pthread_attr_setstacksize.3 2016-03-15 03:47:41.000000000 +0000 @@ -129,11 +129,11 @@ .BR pthread_create (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/pthread_cancel.3 manpages-4.05/man3/pthread_cancel.3 --- manpages-4.04/man3/pthread_cancel.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/pthread_cancel.3 2016-03-15 03:47:41.000000000 +0000 @@ -249,11 +249,11 @@ .BR pthread_testcancel (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/pthread_cleanup_push.3 manpages-4.05/man3/pthread_cleanup_push.3 --- manpages-4.04/man3/pthread_cleanup_push.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/pthread_cleanup_push.3 2016-03-15 03:47:41.000000000 +0000 @@ -333,11 +333,11 @@ .BR pthread_testcancel (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/pthread_cleanup_push_defer_np.3 manpages-4.05/man3/pthread_cleanup_push_defer_np.3 --- manpages-4.04/man3/pthread_cleanup_push_defer_np.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/pthread_cleanup_push_defer_np.3 2016-03-15 03:47:41.000000000 +0000 @@ -121,11 +121,11 @@ .BR pthread_testcancel (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/pthread_create.3 manpages-4.05/man3/pthread_create.3 --- manpages-4.04/man3/pthread_create.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/pthread_create.3 2016-03-15 03:47:41.000000000 +0000 @@ -400,11 +400,11 @@ .BR pthread_self (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/pthread_detach.3 manpages-4.05/man3/pthread_detach.3 --- manpages-4.04/man3/pthread_detach.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/pthread_detach.3 2016-03-15 03:47:41.000000000 +0000 @@ -115,11 +115,11 @@ .BR pthread_join (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/pthread_equal.3 manpages-4.05/man3/pthread_equal.3 --- manpages-4.04/man3/pthread_equal.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/pthread_equal.3 2016-03-15 03:47:41.000000000 +0000 @@ -70,11 +70,11 @@ .BR pthread_self (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/pthread_exit.3 manpages-4.05/man3/pthread_exit.3 --- manpages-4.04/man3/pthread_exit.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/pthread_exit.3 2016-03-15 03:47:41.000000000 +0000 @@ -119,11 +119,11 @@ .BR pthread_join (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/pthread_getattr_np.3 manpages-4.05/man3/pthread_getattr_np.3 --- manpages-4.04/man3/pthread_getattr_np.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/pthread_getattr_np.3 2016-03-15 03:47:41.000000000 +0000 @@ -372,11 +372,11 @@ .BR pthread_create (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/pthread_getcpuclockid.3 manpages-4.05/man3/pthread_getcpuclockid.3 --- manpages-4.04/man3/pthread_getcpuclockid.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/pthread_getcpuclockid.3 2016-03-15 03:47:41.000000000 +0000 @@ -188,11 +188,11 @@ .BR pthreads (7), .BR time (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/pthread_join.3 manpages-4.05/man3/pthread_join.3 --- manpages-4.04/man3/pthread_join.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/pthread_join.3 2016-03-15 03:47:41.000000000 +0000 @@ -145,11 +145,11 @@ .BR pthread_tryjoin_np (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/pthread_kill.3 manpages-4.05/man3/pthread_kill.3 --- manpages-4.04/man3/pthread_kill.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/pthread_kill.3 2016-03-15 03:47:41.000000000 +0000 @@ -123,11 +123,11 @@ .BR pthreads (7), .BR signal (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/pthread_kill_other_threads_np.3 manpages-4.05/man3/pthread_kill_other_threads_np.3 --- manpages-4.04/man3/pthread_kill_other_threads_np.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/pthread_kill_other_threads_np.3 2016-03-15 03:47:41.000000000 +0000 @@ -82,11 +82,11 @@ .BR pthread_setcanceltype (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/pthread_rwlockattr_setkind_np.3 manpages-4.05/man3/pthread_rwlockattr_setkind_np.3 --- manpages-4.04/man3/pthread_rwlockattr_setkind_np.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/pthread_rwlockattr_setkind_np.3 2016-03-15 03:47:41.000000000 +0000 @@ -130,11 +130,11 @@ .SH SEE ALSO .BR pthreads (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/pthread_self.3 manpages-4.05/man3/pthread_self.3 --- manpages-4.04/man3/pthread_self.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/pthread_self.3 2016-03-15 03:47:41.000000000 +0000 @@ -90,11 +90,11 @@ .BR pthread_equal (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/pthread_setaffinity_np.3 manpages-4.05/man3/pthread_setaffinity_np.3 --- manpages-4.04/man3/pthread_setaffinity_np.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/pthread_setaffinity_np.3 2016-03-15 03:47:41.000000000 +0000 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH PTHREAD_SETAFFINITY_NP 3 2015-03-02 "Linux" "Linux Programmer's Manual" +.TH PTHREAD_SETAFFINITY_NP 3 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME pthread_setaffinity_np, pthread_getaffinity_np \- set/get CPU affinity of a thread @@ -218,6 +218,7 @@ .fi .SH SEE ALSO .BR sched_setaffinity (2), +.BR CPU_SET (3). .BR pthread_attr_setaffinity_np (3), .BR pthread_self (3), .BR sched_getcpu (3), @@ -225,11 +226,11 @@ .BR pthreads (7), .BR sched (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/pthread_setcancelstate.3 manpages-4.05/man3/pthread_setcancelstate.3 --- manpages-4.04/man3/pthread_setcancelstate.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/pthread_setcancelstate.3 2016-03-15 03:47:41.000000000 +0000 @@ -206,11 +206,11 @@ .BR pthread_testcancel (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/pthread_setconcurrency.3 manpages-4.05/man3/pthread_setconcurrency.3 --- manpages-4.04/man3/pthread_setconcurrency.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/pthread_setconcurrency.3 2016-03-15 03:47:41.000000000 +0000 @@ -114,11 +114,11 @@ .BR pthread_attr_setscope (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/pthread_setname_np.3 manpages-4.05/man3/pthread_setname_np.3 --- manpages-4.04/man3/pthread_setname_np.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/pthread_setname_np.3 2016-03-15 03:47:41.000000000 +0000 @@ -218,11 +218,11 @@ .BR pthread_create (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/pthread_setschedparam.3 manpages-4.05/man3/pthread_setschedparam.3 --- manpages-4.04/man3/pthread_setschedparam.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/pthread_setschedparam.3 2016-03-15 03:47:41.000000000 +0000 @@ -458,11 +458,11 @@ .BR pthreads (7), .BR sched (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/pthread_setschedprio.3 manpages-4.05/man3/pthread_setschedprio.3 --- manpages-4.04/man3/pthread_setschedprio.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/pthread_setschedprio.3 2016-03-15 03:47:41.000000000 +0000 @@ -115,11 +115,11 @@ .BR pthreads (7), .BR sched (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/pthread_sigmask.3 manpages-4.05/man3/pthread_sigmask.3 --- manpages-4.04/man3/pthread_sigmask.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/pthread_sigmask.3 2016-03-15 03:47:41.000000000 +0000 @@ -174,11 +174,11 @@ .BR pthreads (7), .BR signal (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/pthread_sigqueue.3 manpages-4.05/man3/pthread_sigqueue.3 --- manpages-4.04/man3/pthread_sigqueue.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/pthread_sigqueue.3 2016-03-15 03:47:41.000000000 +0000 @@ -124,11 +124,11 @@ .BR pthreads (7), .BR signal (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/pthread_testcancel.3 manpages-4.05/man3/pthread_testcancel.3 --- manpages-4.04/man3/pthread_testcancel.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/pthread_testcancel.3 2016-03-15 03:47:41.000000000 +0000 @@ -78,11 +78,11 @@ .BR pthread_setcancelstate (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/pthread_tryjoin_np.3 manpages-4.05/man3/pthread_tryjoin_np.3 --- manpages-4.04/man3/pthread_tryjoin_np.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/pthread_tryjoin_np.3 2016-03-15 03:47:41.000000000 +0000 @@ -160,11 +160,11 @@ .BR pthread_join (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/pthread_yield.3 manpages-4.05/man3/pthread_yield.3 --- manpages-4.04/man3/pthread_yield.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/pthread_yield.3 2016-03-15 03:47:41.000000000 +0000 @@ -76,11 +76,11 @@ .BR pthreads (7), .BR sched (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/ptsname.3 manpages-4.05/man3/ptsname.3 --- manpages-4.04/man3/ptsname.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/ptsname.3 2016-03-15 03:47:41.000000000 +0000 @@ -113,11 +113,11 @@ .BR pts (4), .BR pty (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/putenv.3 manpages-4.05/man3/putenv.3 --- manpages-4.04/man3/putenv.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/putenv.3 2016-03-15 03:47:41.000000000 +0000 @@ -33,7 +33,7 @@ .\" Modified Mon Oct 11 11:11:11 1999 by Andries Brouwer (aeb@cwi.nl) .\" Modified Wed Nov 10 00:02:26 1999 by Andries Brouwer (aeb@cwi.nl) .\" Modified Sun May 20 22:17:20 2001 by Andries Brouwer (aeb@cwi.nl) -.TH PUTENV 3 2015-08-08 "GNU" "Linux Programmer's Manual" +.TH PUTENV 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME putenv \- change or add an environment variable .SH SYNOPSIS @@ -50,7 +50,9 @@ .in .sp .BR putenv (): -_SVID_SOURCE || _XOPEN_SOURCE +_XOPEN_SOURCE + || /* Glibc since 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _SVID_SOURCE .SH DESCRIPTION The .BR putenv () @@ -134,11 +136,11 @@ .BR unsetenv (3), .BR environ (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/putgrent.3 manpages-4.05/man3/putgrent.3 --- manpages-4.04/man3/putgrent.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/putgrent.3 2016-03-15 03:47:41.000000000 +0000 @@ -60,11 +60,11 @@ .BR getgrent (3), .BR group (5) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/putpwent.3 manpages-4.05/man3/putpwent.3 --- manpages-4.04/man3/putpwent.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/putpwent.3 2016-03-15 03:47:41.000000000 +0000 @@ -27,7 +27,7 @@ .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified Sat Jul 24 18:43:46 1993 by Rik Faith (faith@cs.unc.edu) -.TH PUTPWENT 3 2015-05-07 "GNU" "Linux Programmer's Manual" +.TH PUTPWENT 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME putpwent \- write a password file entry .SH SYNOPSIS @@ -45,7 +45,10 @@ .in .sp .BR putpwent (): -_SVID_SOURCE + Since glibc 2.19: + _DEFAULT_SOURCE + Glibc 2.19 and earlier: + _SVID_SOURCE .SH DESCRIPTION The .BR putpwent () @@ -103,11 +106,11 @@ .BR getpwuid (3), .BR setpwent (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/puts.3 manpages-4.05/man3/puts.3 --- manpages-4.04/man3/puts.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/puts.3 2016-03-15 03:47:41.000000000 +0000 @@ -138,11 +138,11 @@ .BR scanf (3), .BR unlocked_stdio (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/putwchar.3 manpages-4.05/man3/putwchar.3 --- manpages-4.04/man3/putwchar.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/putwchar.3 2016-03-15 03:47:41.000000000 +0000 @@ -88,11 +88,11 @@ .BR fputwc (3), .BR unlocked_stdio (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/qecvt.3 manpages-4.05/man3/qecvt.3 --- manpages-4.04/man3/qecvt.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/qecvt.3 2016-03-15 03:47:41.000000000 +0000 @@ -25,7 +25,7 @@ .\" This replaces an earlier man page written by Walter Harms .\" . .\" -.TH QECVT 3 2015-03-02 "GNU" "Linux Programmer's Manual" +.TH QECVT 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME qecvt, qfcvt, qgcvt \- convert a floating-point number to a string .SH SYNOPSIS @@ -59,7 +59,7 @@ .\" glibc 2.10 to glibc 2.17 .\" _SVID_SOURCE || (_XOPEN_SOURCE >= 500 || .\" (_XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED) && -.\" ! (_POSIX_C_SOURCE >= 200809L || _XOPEN_SOURCE >= 700)) +.\" ! (_POSIX_C_SOURCE >= 200809L)) .\" Before glibc 2.10: .\" _SVID_SOURCE || _XOPEN_SOURCE >= 500 || .\" (_XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED) @@ -117,11 +117,11 @@ .BR gcvt (3), .BR sprintf (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/qsort.3 manpages-4.05/man3/qsort.3 --- manpages-4.04/man3/qsort.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/qsort.3 2016-03-15 03:47:41.000000000 +0000 @@ -163,11 +163,11 @@ .BR strcmp (3), .BR versionsort (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/queue.3 manpages-4.05/man3/queue.3 --- manpages-4.04/man3/queue.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/queue.3 2016-03-15 03:47:41.000000000 +0000 @@ -1219,9 +1219,7 @@ CIRCLEQ_REMOVE(&head, head.cqh_first, entries); .Ed .Sh CONFORMING TO -Not in POSIX.1-2001 or POSIX.1-2008. -.SH CONFORMING TO -Not in POSIX.1. +Not in POSIX.1, POSIX.1-2001 or POSIX.1-2008. Present on the BSDs. .Nm queue functions first appeared in @@ -1229,11 +1227,11 @@ .\" .Sh SEE ALSO .\" .Xr tree 3 .Sh COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .Em man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/raise.3 manpages-4.05/man3/raise.3 --- manpages-4.04/man3/raise.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/raise.3 2016-03-15 03:47:41.000000000 +0000 @@ -94,11 +94,11 @@ .BR pthread_kill (3), .BR signal (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/rand.3 manpages-4.05/man3/rand.3 --- manpages-4.04/man3/rand.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/rand.3 2016-03-15 03:47:41.000000000 +0000 @@ -38,7 +38,7 @@ .\" Modified 2003-11-15, aeb, added rand_r .\" 2010-09-13, mtk, added example program .\" -.TH RAND 3 2015-03-02 "" "Linux Programmer's Manual" +.TH RAND 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME rand, rand_r, srand \- pseudo-random number generator .SH SYNOPSIS @@ -58,7 +58,7 @@ .in .sp .BR rand_r (): -_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _POSIX_SOURCE +_POSIX_C_SOURCE .SH DESCRIPTION The .BR rand () @@ -232,11 +232,11 @@ .BR drand48 (3), .BR random (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/random.3 manpages-4.05/man3/random.3 --- manpages-4.04/man3/random.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/random.3 2016-03-15 03:47:41.000000000 +0000 @@ -30,7 +30,7 @@ .\" Modified Sat Jul 24 18:13:39 1993 by Rik Faith (faith@cs.unc.edu) .\" Modified Sun Aug 20 21:47:07 2000, aeb .\" -.TH RANDOM 3 2015-08-08 "GNU" "Linux Programmer's Manual" +.TH RANDOM 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME random, srandom, initstate, setstate \- random number generator .SH SYNOPSIS @@ -57,8 +57,10 @@ .BR initstate (), .BR setstate (): .RS 4 -_SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 || -_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED +_XOPEN_SOURCE\ >=\ 500 +.\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED + || /* Glibc since 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _SVID_SOURCE || _BSD_SOURCE .RE .ad .SH DESCRIPTION @@ -208,11 +210,11 @@ .BR random_r (3), .BR srand (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/random_r.3 manpages-4.05/man3/random_r.3 --- manpages-4.04/man3/random_r.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/random_r.3 2016-03-15 03:47:41.000000000 +0000 @@ -23,7 +23,7 @@ .\" %%%LICENSE_END .\" .\" -.TH RANDOM_R 3 2015-12-28 "GNU" "Linux Programmer's Manual" +.TH RANDOM_R 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME random_r, srandom_r, initstate_r, setstate_r \- reentrant random number generator @@ -52,7 +52,8 @@ .BR initstate_r (), .BR setstate_r (): .RS 4 -_SVID_SOURCE || _BSD_SOURCE +/* Glibc since 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _SVID_SOURCE || _BSD_SOURCE .RE .ad b .SH DESCRIPTION @@ -154,11 +155,11 @@ .BR rand (3), .BR random (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/rcmd.3 manpages-4.05/man3/rcmd.3 --- manpages-4.04/man3/rcmd.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/rcmd.3 2016-03-15 03:47:41.000000000 +0000 @@ -40,7 +40,7 @@ .\" .\" 2007-12-08, mtk, Converted from mdoc to man macros .\" -.TH RCMD 3 2015-07-23 "Linux" "Linux Programmer's Manual" +.TH RCMD 3 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME rcmd, rresvport, iruserok, ruserok, rcmd_af, rresvport_af, iruserok_af, ruserok_af \- routines for returning a @@ -88,7 +88,10 @@ .BR iruserok_af (), .BR ruserok (), .BR ruserok_af (): -_BSD_SOURCE + Since glibc 2.19: + _DEFAULT_SOURCE + Glibc 2.19 and earlier: + _BSD_SOURCE .SH DESCRIPTION The .BR rcmd () @@ -98,7 +101,7 @@ The .BR rresvport () function -returns a descriptor to a socket +returns a file descriptor to a socket with an address in the privileged port space. The .BR iruserok () @@ -138,7 +141,7 @@ If .I fd2p is nonzero, then an auxiliary channel to a control -process will be set up, and a descriptor for it will be placed +process will be set up, and a file descriptor for it will be placed in .IR *fd2p . The control process will return diagnostic @@ -200,8 +203,8 @@ service is allowed. .PP If this file does not exist, is not a regular file, is owned by anyone -other than the user or the superuser, or is writable by anyone other -than the owner, the check automatically fails. +other than the user or the superuser, is writable by anyone other +than the owner, or is hardlinked anywhere, the check automatically fails. Zero is returned if the machine name is listed in the .IR hosts.equiv file, or the host and remote username are found in the @@ -316,11 +319,11 @@ .BR rlogind (8), .BR rshd (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/readdir.3 manpages-4.05/man3/readdir.3 --- manpages-4.04/man3/readdir.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/readdir.3 2016-03-15 03:47:41.000000000 +0000 @@ -1,4 +1,5 @@ .\" Copyright (C) 1993 David Metcalfe (david@prism.demon.co.uk) +.\" and Copyright (C) 2008, 2016 Michael Kerrisk .\" .\" %%%LICENSE_START(VERBATIM) .\" Permission is granted to make and distribute verbatim copies of this @@ -31,33 +32,16 @@ .\" Modified 22 July 1996 by Andries Brouwer (aeb@cwi.nl) .\" 2007-07-30 Ulrich Drepper , mtk: .\" Rework discussion of nonstandard structure fields. -.\" 2008-09-11, mtk, Document readdir_r(). .\" -.TH READDIR 3 2015-08-08 "" "Linux Programmer's Manual" +.TH READDIR 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME -readdir, readdir_r \- read a directory +readdir \- read a directory .SH SYNOPSIS .nf .B #include .sp .BI "struct dirent *readdir(DIR *" dirp ); -.sp -.BI "int readdir_r(DIR *" dirp ", struct dirent *" entry \ -", struct dirent **" result ); .fi -.sp -.in -4n -Feature Test Macro Requirements for glibc (see -.BR feature_test_macros (7)): -.ad l -.in -.sp -.BR readdir_r (): -.RS 4 -_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _BSD_SOURCE || -_SVID_SOURCE || _POSIX_SOURCE -.RE -.ad b .SH DESCRIPTION The .BR readdir () @@ -67,55 +51,116 @@ It returns NULL on reaching the end of the directory stream or if an error occurred. .PP -On Linux, the +In the glibc implementation, the .I dirent structure is defined as follows: .PP .in +4n .nf struct dirent { - ino_t d_ino; /* inode number */ - off_t d_off; /* not an offset; see NOTES */ - unsigned short d_reclen; /* length of this record */ - unsigned char d_type; /* type of file; not supported + ino_t d_ino; /* Inode number */ + off_t d_off; /* Not an offset; see below */ + unsigned short d_reclen; /* Length of this record */ + unsigned char d_type; /* Type of file; not supported by all filesystem types */ - char d_name[256]; /* filename */ + char d_name[256]; /* Null-terminated filename */ }; .fi .in .PP The only fields in the .I dirent -structure that are mandated by POSIX.1 are: -.IR d_name [], -of unspecified size, with at most -.B NAME_MAX -characters preceding the terminating null byte (\(aq\\0\(aq); -and (as an XSI extension) +structure that are mandated by POSIX.1 are +.IR d_name +and .IR d_ino . The other fields are unstandardized, and not present on all systems; see NOTES below for some further details. + +The fields of the +.I dirent +structure are as follows: +.TP +.I d_ino +This is the inode number of the file. +.TP +.I d_off +The value returned in +.I d_off +is the same as would be returned by calling +.BR telldir (3) +at the current position in the directory stream. +Be aware that despite its type and name, the +.I d_off +field is seldom any kind of directory offset on modern filesystems. +.\" https://lwn.net/Articles/544298/ +Applications should treat this field as an opaque value, +making no assumptions about its contents; see also +.BR telldir (3). +.TP +.I d_reclen +This is the size (in bytes) of the returned record. +This may not match the size of the structure definition shown above; +see NOTES. +.TP +.I d_type +This field contains a value indicating the file type, +making it possible to avoid the expense of calling +.BR lstat (2) +if further actions depend on the type of the file. +.IP +When a suitable feature test macro is defined +.RB ( _DEFAULT_SOURCE +on glibc versions since 2.19, or +.BR _BSD_SOURCE +on glibc versions 2.19 and earlier), +glibc defines the following macro constants for the value returned in +.IR d_type : +.RS +.TP 12 +.B DT_BLK +This is a block device. +.TP +.B DT_CHR +This is a character device. +.TP +.B DT_DIR +This is a directory. +.TP +.B DT_FIFO +This is a named pipe (FIFO). +.TP +.B DT_LNK +This is a symbolic link. +.TP +.B DT_REG +This is a regular file. +.TP +.B DT_SOCK +This is a UNIX domain socket. +.TP +.B DT_UNKNOWN +The file type could not be determined. +.RE +.IP +Currently, +.\" kernel 2.6.27 +.\" The same sentence is in getdents.2 +only some filesystems (among them: Btrfs, ext2, ext3, and ext4) +have full support for returning the file type in +.IR d_type . +All applications must properly handle a return of +.BR DT_UNKNOWN . +.TP +.I d_name +This field contains the null terminated filename. +.IR "See NOTES" . .PP The data returned by .BR readdir () may be overwritten by subsequent calls to .BR readdir () for the same directory stream. - -The -.BR readdir_r () -function is a reentrant version of -.BR readdir (). -It reads the next directory entry from the directory stream -.IR dirp , -and returns it in the caller-allocated buffer pointed to by -.IR entry . -(See NOTES for information on allocating this buffer.) -A pointer to the returned item is placed in -.IR *result ; -if the end of the directory stream was encountered, -then NULL is instead returned in -.IR *result . .SH RETURN VALUE On success, .BR readdir () @@ -125,21 +170,20 @@ (This structure may be statically allocated; do not attempt to .BR free (3) it.) + If the end of the directory stream is reached, NULL is returned and .I errno is not changed. If an error occurs, NULL is returned and .I errno is set appropriately. - -The -.BR readdir_r () -function returns 0 on success. -On error, it returns a positive error number (listed under ERRORS). -If the end of the directory stream is reached, -.BR readdir_r () -returns 0, and returns NULL in -.IR *result . +To distinguish end of stream and from an error, set +.I errno +to zero before calling +.BR readdir () +and then check the value of +.I errno +if NULL is returned. .SH ERRORS .TP .B EBADF @@ -155,19 +199,48 @@ T{ .BR readdir () T} Thread safety MT-Unsafe race:dirstream -T{ -.BR readdir_r () -T} Thread safety MT-Safe .TE + +.PP +In the current POSIX.1 specification (POSIX.1-2008), +.BR readdir () +is not required to be thread-safe. +However, in modern implementations (including the glibc implementation), +concurrent calls to +.BR readdir () +that specify different directory streams are thread-safe. +In cases where multiple threads must read from the same directory stream, +using +.BR readdir () +with external synchronization is still preferable to the use of the deprecated +.BR readdir_r (3) +function. +It is expected that a future version of POSIX.1 +.\" FIXME . +.\" http://www.austingroupbugs.net/view.php?id=696 +will require that +.BR readdir () +be thread-safe when concurrently employed on different directory streams. .SH CONFORMING TO POSIX.1-2001, POSIX.1-2008, SVr4, 4.3BSD. .SH NOTES +A directory stream is opened using +.BR opendir (3). + +The order in which filenames are read by successive calls to +.BR readdir () +depends on the filesystem implementation; +it us unlikely that the names will be sorted in any fashion. + Only the fields .I d_name -and +and (as an XSI extension) .I d_ino are specified in POSIX.1. .\" POSIX.1-2001, POSIX.1-2008 +Other than Linux, the +.I d_type +field is available mainly only on BSD systems. The remaining fields are available on many, but not all systems. Under glibc, programs can check for the availability of the fields not defined @@ -178,97 +251,53 @@ or .B _DIRENT_HAVE_D_TYPE are defined. +.\" +.SS The d_name field +The +.I dirent +structure definition shown above is taken from the glibc headers, +and shows the +.I d_name +field with a fixed size. -The value returned in -.I d_off -is the same as would be returned by calling -.BR telldir (3) -at the current position in the directory stream. -Be aware that despite its type and name, the -.I d_off -field is seldom any kind of directory offset on modern filesystems. -.\" https://lwn.net/Articles/544298/ -Applications should treat this field as an opaque value, -making no assumptions about its contents; see also -.BR telldir (3). - -Other than Linux, the -.I d_type -field is available mainly only on BSD systems. -This field makes it possible to avoid the expense of calling -.BR lstat (2) -if further actions depend on the type of the file. -If the -.B _BSD_SOURCE -feature test macro is defined, -then glibc defines the following macro constants -for the value returned in -.IR d_type : -.TP 12 -.B DT_BLK -This is a block device. -.TP -.B DT_CHR -This is a character device. -.TP -.B DT_DIR -This is a directory. -.TP -.B DT_FIFO -This is a named pipe (FIFO). -.TP -.B DT_LNK -This is a symbolic link. -.TP -.B DT_REG -This is a regular file. -.TP -.B DT_SOCK -This is a UNIX domain socket. -.TP -.B DT_UNKNOWN -The file type is unknown. -.\" The glibc manual says that on some systems this is the only -.\" value returned -.PP -If the file type could not be determined, the value -.B DT_UNKNOWN -is returned in -.IR d_type . +.IR Warning : +applications should avoid any dependence on the size of the +.I d_name +field. +POSIX defines it as +.IR "char\ d_name[]", +a character array of unspecified size, with at most +.B NAME_MAX +characters preceding the terminating null byte (\(aq\\0\(aq). -Currently, -.\" kernel 2.6.27 -.\" The same sentence is in getdents.2 -only some filesystems (among them: Btrfs, ext2, ext3, and ext4) -have full support for returning the file type in -.IR d_type . -All applications must properly handle a return of -.BR DT_UNKNOWN . +POSIX.1 explicitly notes that this field should not be used as an lvalue. +The standard also notes that the use of +.I sizeof(d_name) +is incorrect; use +.IR strlen(d_name) +instead. +(On some systems, this field is defined as +.IR char\ d_name[1] !) +By implication, the use +.IR "sizeof(struct dirent)" +to capture the size of record including the size of +.IR d_name +is also incorrect. -Since POSIX.1 does not specify the size of the -.I d_name -field, and other nonstandard fields may precede that field within the -.I dirent -structure, portable applications that use -.BR readdir_r () -should allocate the buffer whose address is passed in -.IR entry -as follows: -.in +4n -.nf +Note that while the call -name_max = pathconf(dirpath, _PC_NAME_MAX); -if (name_max == \-1) /* Limit not defined, or error */ - name_max = 255; /* Take a guess */ -len = offsetof(struct dirent, d_name) + name_max + 1; -entryp = malloc(len); + fpathconf(fd, _PC_NAME_MAX) -.fi -.in -(POSIX.1 requires that +returns the value 255 for most filesystems, +on some filesystems (e.g., CIFS, Windows SMB servers), +the null-terminated filename that is (correctly) returned in .I d_name -is the last field in a -.IR "struct dirent" .) +can actually exceed this size. +In such cases, the +.I d_reclen +field will contain a value that exceeds the size of the glibc +.I dirent +structure shown above. .SH SEE ALSO .BR getdents (2), .BR read (2), @@ -277,16 +306,17 @@ .BR ftw (3), .BR offsetof (3), .BR opendir (3), +.BR readdir_r (3), .BR rewinddir (3), .BR scandir (3), .BR seekdir (3), .BR telldir (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/readdir_r.3 manpages-4.05/man3/readdir_r.3 --- manpages-4.04/man3/readdir_r.3 2015-12-29 12:51:43.000000000 +0000 +++ manpages-4.05/man3/readdir_r.3 2016-03-15 03:47:41.000000000 +0000 @@ -1 +1,167 @@ -.so man3/readdir.3 +.\" Copyright (C) 2008, 2016 Michael Kerrisk +.\" and Copyright (C) 2016 Florian Weimer +.\" +.\" %%%LICENSE_START(VERBATIM) +.\" Permission is granted to make and distribute verbatim copies of this +.\" manual provided the copyright notice and this permission notice are +.\" preserved on all copies. +.\" +.\" Permission is granted to copy and distribute modified versions of this +.\" manual under the conditions for verbatim copying, provided that the +.\" entire resulting derived work is distributed under the terms of a +.\" permission notice identical to this one. +.\" +.\" Since the Linux kernel and libraries are constantly changing, this +.\" manual page may be incorrect or out-of-date. The author(s) assume no +.\" responsibility for errors or omissions, or for damages resulting from +.\" the use of the information contained herein. The author(s) may not +.\" have taken the same level of care in the production of this manual, +.\" which is licensed free of charge, as they might when working +.\" professionally. +.\" +.\" Formatted or processed versions of this manual, if unaccompanied by +.\" the source, must acknowledge the copyright and authors of this work. +.\" %%%LICENSE_END +.\" +.TH READDIR_R 3 2016-03-01 "" "Linux Programmer's Manual" +.SH NAME +readdir_r \- read a directory +.SH SYNOPSIS +.nf +.B #include +.sp +.BI "int readdir_r(DIR *" dirp ", struct dirent *" entry \ +", struct dirent **" result ); +.fi +.sp +.in -4n +Feature Test Macro Requirements for glibc (see +.BR feature_test_macros (7)): +.ad l +.in +.sp +.BR readdir_r (): +.RS 4 +_POSIX_C_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE +.RE +.ad b +.SH DESCRIPTION +This function is deprecated; use +.BR readdir (3) +instead. + +The +.BR readdir_r () +function was invented as a reentrant version of +.BR readdir (3). +It reads the next directory entry from the directory stream +.IR dirp , +and returns it in the caller-allocated buffer pointed to by +.IR entry . +For details of the +.IR dirent +structure, see +.BR readir (3). + +A pointer to the returned buffer is placed in +.IR *result ; +if the end of the directory stream was encountered, +then NULL is instead returned in +.IR *result . + +It is recommended that applications use +.BR readdir () +instead of +.BR readdir_r (). +Furthermore, since version 2.24, glibc deprecates +.BR readdir_r (). +The reasons are as follows: +.IP * 3 +On systems where +.BR NAME_MAX +is undefined, calling +.BR readdir_r () +may be unsafe because the interface does not allow the caller to specify +the length of the buffer used for the returned directory entry. +.IP * +On some systems, +.BR readdir_r () +can't read directory entries with very long names. +When the glibc implementation encounters such a name, +.BR readdir_r () +fails with the error +.B ENAMETOOLONG +.IR "after the final directory entry has been read" . +On some other systems, +.BR readdir_r () +may return a success status, but the returned +.IR d_name +field may not be null terminated or may be truncated. +.IP * +In the current POSIX.1 specification (POSIX.1-2008), +.BR readdir (3) +is not required to be thread-safe. +However, in modern implementations (including the glibc implementation), +concurrent calls to +.BR readdir (3) +that specify different directory streams are thread-safe. +Therefore, the use of +.BR readdir_r () +is generally unnecessary in multithreaded programs. +In cases where multiple threads must read from the same directory stream, +using +.BR readdir (3) +with external synchronization is still preferable to the use of +.BR readdir_r (), +for the reasons given in the points above. +.IP * +It is expected that a future version of POSIX.1 +.\" FIXME . +.\" http://www.austingroupbugs.net/view.php?id=696 +will make +.BR readdir_r () +obsolete, and require that +.BR readdir () +be thread-safe when concurrently employed on different directory streams. +.SH RETURN VALUE +The +.BR readdir_r () +function returns 0 on success. +On error, it returns a positive error number (listed under ERRORS). +If the end of the directory stream is reached, +.BR readdir_r () +returns 0, and returns NULL in +.IR *result . +.SH ERRORS +.TP +.B EBADF +Invalid directory stream descriptor \fIdirp\fP. +.TP +.B ENAMETOOLONG +A directory entry whose name was too long to be read was encountered. +.SH ATTRIBUTES +For an explanation of the terms used in this section, see +.BR attributes (7). +.TS +allbox; +lb lb lb +l l l. +Interface Attribute Value +T{ +.BR readdir_r () +T} Thread safety MT-Safe +.TE +.SH CONFORMING TO +POSIX.1-2001, POSIX.1-2008. +.SH SEE ALSO +.BR readdir (3) +.SH COLOPHON +This page is part of release 4.05 of the Linux +.I man-pages +project. +A description of the project, +information about reporting bugs, +and the latest version of this page, +can be found at +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/realpath.3 manpages-4.05/man3/realpath.3 --- manpages-4.04/man3/realpath.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/realpath.3 2016-03-15 03:47:41.000000000 +0000 @@ -25,7 +25,7 @@ .\" Rewritten old page, 990824, aeb@cwi.nl .\" 2004-12-14, mtk, added discussion of resolved_path == NULL .\" -.TH REALPATH 3 2015-04-19 "" "Linux Programmer's Manual" +.TH REALPATH 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME realpath \- return the canonicalized absolute pathname .SH SYNOPSIS @@ -44,8 +44,10 @@ .BR realpath (): .ad l .RS 4 -_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 || -_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED +_XOPEN_SOURCE\ >=\ 500 +.\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED + || /* Glibc since 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE .RE .ad .SH DESCRIPTION @@ -244,11 +246,11 @@ .BR pathconf (3), .BR sysconf (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/recno.3 manpages-4.05/man3/recno.3 --- manpages-4.04/man3/recno.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/recno.3 2016-03-15 03:47:41.000000000 +0000 @@ -231,11 +231,11 @@ Michael Stonebraker, Heidi Stettner, Joseph Kalash, Antonin Guttman, Nadene Lynn, Memorandum No. UCB/ERL M82/32, May 1982. .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/re_comp.3 manpages-4.05/man3/re_comp.3 --- manpages-4.04/man3/re_comp.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/re_comp.3 2016-03-15 03:47:41.000000000 +0000 @@ -87,11 +87,11 @@ .BR regex (7), GNU regex manual .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/regex.3 manpages-4.05/man3/regex.3 --- manpages-4.04/man3/regex.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/regex.3 2016-03-15 03:47:41.000000000 +0000 @@ -329,11 +329,11 @@ The glibc manual section, .I "Regular Expression Matching" .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/remainder.3 manpages-4.05/man3/remainder.3 --- manpages-4.04/man3/remainder.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/remainder.3 2016-03-15 03:47:41.000000000 +0000 @@ -34,7 +34,7 @@ .\" (walter.harms@informatik.uni-oldenburg.de) .\" Modified 2003-11-18, 2004-10-05 aeb .\" -.TH REMAINDER 3 2015-04-19 "" "Linux Programmer's Manual" +.TH REMAINDER 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME drem, dremf, dreml, remainder, remainderf, remainderl \- \ floating-point remainder function @@ -63,30 +63,27 @@ .ad l .BR remainder (): .RS 4 -_SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 || -_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED || -_ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || _XOPEN_SOURCE\ >=\ 500 +.\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .br .BR remainderf (), .BR remainderl (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .br .BR drem (), .BR dremf (), .BR dreml (): .RS 4 -_SVID_SOURCE || _BSD_SOURCE +/* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .ad b .SH DESCRIPTION @@ -235,11 +232,11 @@ .BR fmod (3), .BR remquo (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/remove.3 manpages-4.05/man3/remove.3 --- manpages-4.04/man3/remove.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/remove.3 2016-03-15 03:47:41.000000000 +0000 @@ -102,11 +102,11 @@ .BR mkfifo (3), .BR symlink (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/remquo.3 manpages-4.05/man3/remquo.3 --- manpages-4.04/man3/remquo.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/remquo.3 2016-03-15 03:47:41.000000000 +0000 @@ -9,7 +9,7 @@ .\" based on glibc infopages .\" polished, aeb .\" -.TH REMQUO 3 2015-04-19 "GNU" "Linux Programmer's Manual" +.TH REMQUO 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME remquo, remquof, remquol \- remainder and part of quotient .SH SYNOPSIS @@ -35,11 +35,7 @@ .BR remquof (), .BR remquol (): .RS 4 -_XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L .RE .ad .SH DESCRIPTION @@ -142,11 +138,11 @@ .BR logb (3), .BR remainder (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/resolver.3 manpages-4.05/man3/resolver.3 --- manpages-4.04/man3/resolver.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/resolver.3 2016-03-15 03:47:41.000000000 +0000 @@ -78,9 +78,8 @@ .BI " const unsigned char *" comp_dn ", char *" exp_dn , .BI " int " length ); .fi - +.\" .SS Deprecated - .nf .B extern struct __res_state _res; @@ -396,7 +395,7 @@ .BR RES_DNSRCH and .BR RES_NOIP6DOTINT . - +.\" .SH RETURN VALUE The .BR res_ninit () @@ -467,11 +466,11 @@ The GNU C library source file .IR resolv/README . .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/rewinddir.3 manpages-4.05/man3/rewinddir.3 --- manpages-4.04/man3/rewinddir.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/rewinddir.3 2016-03-15 03:47:41.000000000 +0000 @@ -72,11 +72,11 @@ .BR seekdir (3), .BR telldir (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/rexec.3 manpages-4.05/man3/rexec.3 --- manpages-4.04/man3/rexec.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/rexec.3 2016-03-15 03:47:41.000000000 +0000 @@ -38,12 +38,11 @@ .\" .\" 2013-06-21, mtk, Converted from mdoc to man macros .\" -.TH REXEC 3 2015-03-02 "Linux" "Linux Programmer's Manual" +.TH REXEC 3 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME rexec, rexec_af \- return stream to a remote command .SH SYNOPSIS .nf -.BR "#define _BSD_SOURCE" " /* See feature_test_macros(7) */" .B #include .sp .BI "int rexec(char **" ahost ", int " inport ", const char *" user ", " @@ -53,6 +52,15 @@ .BI " const char *" passwd ", const char *" cmd ", int *" fd2p , .BI " sa_family_t " af ); .fi +.sp +.BR rexec (), +.BR rexec_af (): +.nf + Since glibc 2.19: + _DEFAULT_SOURCE + In glibc up to and including 2.19: + _BSD_SOURCE +.fi .SH DESCRIPTION This interface is obsoleted by .BR rcmd (3). @@ -98,7 +106,7 @@ If .I fd2p is nonzero, then an auxiliary channel to a control -process will be setup, and a descriptor for it will be placed +process will be setup, and a file descriptor for it will be placed in .IR *fd2p . The control process will return diagnostic @@ -174,11 +182,11 @@ .BR rcmd (3), .BR rexecd (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/rint.3 manpages-4.05/man3/rint.3 --- manpages-4.04/man3/rint.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/rint.3 2016-03-15 03:47:41.000000000 +0000 @@ -24,7 +24,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH RINT 3 2015-04-19 "" "Linux Programmer's Manual" +.TH RINT 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME nearbyint, nearbyintf, nearbyintl, rint, rintf, rintl \- round to nearest integer @@ -57,30 +57,24 @@ .BR nearbyintf (), .BR nearbyintl (): .RS 4 -_XOPEN_SOURCE\ >=\ 600 || _POSIX_C_SOURCE\ >=\ 200112L || _ISOC99_SOURCE; -.br -or -.I cc\ -std=c99 +_POSIX_C_SOURCE\ >=\ 200112L || _ISOC99_SOURCE .RE .br .BR rint (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 || -_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || _XOPEN_SOURCE\ >=\ 500 +.\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .br .BR rintf (), .BR rintl (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .ad b .SH DESCRIPTION @@ -170,11 +164,11 @@ .BR round (3), .BR trunc (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/round.3 manpages-4.05/man3/round.3 --- manpages-4.04/man3/round.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/round.3 2016-03-15 03:47:41.000000000 +0000 @@ -24,7 +24,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH ROUND 3 2015-04-19 "" "Linux Programmer's Manual" +.TH ROUND 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME round, roundf, roundl \- round to nearest integer, away from zero .SH SYNOPSIS @@ -50,11 +50,7 @@ .BR roundf (), .BR roundl (): .RS 4 -_XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L .RE .ad .SH DESCRIPTION @@ -130,11 +126,11 @@ .BR rint (3), .BR trunc (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/rpc.3 manpages-4.05/man3/rpc.3 --- manpages-4.04/man3/rpc.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/rpc.3 2016-03-15 03:47:41.000000000 +0000 @@ -8,7 +8,7 @@ .\" .\" 2007-12-30, mtk, Convert function prototypes to modern C syntax .\" -.TH RPC 3 2015-07-23 "" "Linux Programmer's Manual" +.TH RPC 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME rpc \- library routines for remote procedure calls .SH SYNOPSIS AND DESCRIPTION @@ -714,7 +714,7 @@ .IP Similar to .BR svc_fdset , -but limited to 32 descriptors. +but limited to 32 file descriptors. This interface is obsoleted by .BR svc_fdset . .LP @@ -773,7 +773,7 @@ .IP Similar to .BR svc_getreqset (), -but limited to 32 descriptors. +but limited to 32 file descriptors. This interface is obsoleted by .BR svc_getreqset (). .LP @@ -923,8 +923,8 @@ .BI " unsigned int " recvsize ); .fi .IP -Create a service on top of any open descriptor. -Typically, this descriptor is a connected socket for a stream protocol such +Create a service on top of any open file descriptor. +Typically, this file descriptor is a connected socket for a stream protocol such as TCP. .I sendsize and @@ -1229,11 +1229,11 @@ RFC\ 1050, Sun Microsystems, Inc., USC-ISI. .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/rpmatch.3 manpages-4.05/man3/rpmatch.3 --- manpages-4.04/man3/rpmatch.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/rpmatch.3 2016-03-15 03:47:41.000000000 +0000 @@ -26,7 +26,7 @@ .\" .\" 2006-05-19, mtk, various edits and example program .\" -.TH RPMATCH 3 2015-07-23 "GNU" "Linux Programmer's Manual" +.TH RPMATCH 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME rpmatch \- determine if the answer to a question is affirmative or negative .SH SYNOPSIS @@ -42,7 +42,10 @@ .in .sp .BR rpmatch (): -_SVID_SOURCE + Since glibc 2.19: + _DEFAULT_SOURCE + Glibc 2.19 and earlier: + _SVID_SOURCE .SH DESCRIPTION .BR rpmatch () handles a user response to yes or no questions, with @@ -161,11 +164,11 @@ .BR regcomp (3), .BR setlocale (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/rtime.3 manpages-4.05/man3/rtime.3 --- manpages-4.04/man3/rtime.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/rtime.3 2016-03-15 03:47:41.000000000 +0000 @@ -143,11 +143,11 @@ .\" .BR rdate (1), .BR inetd (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/rtnetlink.3 manpages-4.05/man3/rtnetlink.3 --- manpages-4.04/man3/rtnetlink.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/rtnetlink.3 2016-03-15 03:47:41.000000000 +0000 @@ -123,11 +123,11 @@ .BR netlink (7), .BR rtnetlink (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/scalb.3 manpages-4.05/man3/scalb.3 --- manpages-4.04/man3/scalb.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/scalb.3 2016-03-15 03:47:41.000000000 +0000 @@ -24,7 +24,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH SCALB 3 2015-03-02 "" "Linux Programmer's Manual" +.TH SCALB 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME scalb, scalbf, scalbl \- multiply floating-point number by integral power of radix (OBSOLETE) @@ -47,14 +47,18 @@ .ad l .BR scalb (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 || -_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED +_XOPEN_SOURCE\ >=\ 500 +.\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .br .BR scalbf (), .BR scalbl (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 +_XOPEN_SOURCE\ >=\ 600 + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .ad b .SH DESCRIPTION @@ -215,11 +219,11 @@ .BR ldexp (3), .BR scalbln (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/scalbln.3 manpages-4.05/man3/scalbln.3 --- manpages-4.04/man3/scalbln.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/scalbln.3 2016-03-15 03:47:41.000000000 +0000 @@ -24,7 +24,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH SCALBLN 3 2015-04-19 "" "Linux Programmer's Manual" +.TH SCALBLN 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME scalbn, scalbnf, scalbnl, scalbln, scalblnf, scalblnl \- multiply floating-point number by integral power of radix @@ -55,22 +55,17 @@ .BR scalblnf (), .BR scalblnl (): .RS -_XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || /* Since glibc 2.19: */ _DEFAULT_SOURCE .RE .br .BR scalbn (), .BR scalbnf (), .BR scalbnl (): .RS -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .ad b .SH DESCRIPTION @@ -197,11 +192,11 @@ .BR ldexp (3), .BR scalb (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/scandir.3 manpages-4.05/man3/scandir.3 --- manpages-4.04/man3/scandir.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/scandir.3 2016-03-15 03:47:41.000000000 +0000 @@ -59,7 +59,7 @@ .\" . .\" %%%LICENSE_END .\" -.TH SCANDIR 3 2015-04-19 "GNU" "Linux Programmer's Manual" +.TH SCANDIR 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME scandir, scandirat, alphasort, versionsort \- scan a directory for matching entries @@ -101,12 +101,8 @@ .RS 4 .PD 0 .ad b -_BSD_SOURCE || _SVID_SOURCE -.br -|| /* Since glibc 2.10: */ -.RS 4 -(_POSIX_C_SOURCE\ >=\ 200809L || _XOPEN_SOURCE\ >=\ 700) -.RE +/* Since glibc 2.10: */ _POSIX_C_SOURCE\ >=\ 200809L + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .PD .RE .sp @@ -293,7 +289,7 @@ to match the standard. .SH EXAMPLE .nf -#define _SVID_SOURCE +#define _DEFAULT_SOURCE /* print files in current directory in reverse order */ #include @@ -327,11 +323,11 @@ .BR strverscmp (3), .BR telldir (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/scanf.3 manpages-4.05/man3/scanf.3 --- manpages-4.04/man3/scanf.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/scanf.3 2016-03-15 03:47:41.000000000 +0000 @@ -49,7 +49,7 @@ .\" Add ERRORS section. .\" Document the 'a' and 'm' modifiers for dynamic string allocation. .\" -.TH SCANF 3 2015-04-19 "GNU" "Linux Programmer's Manual" +.TH SCANF 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME scanf, fscanf, sscanf, vscanf, vsscanf, vfscanf \- input format conversion .SH SYNOPSIS @@ -77,11 +77,7 @@ .BR vsscanf (), .BR vfscanf (): .RS 4 -_XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I "cc -std=c99" +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L .ad .RE .SH DESCRIPTION @@ -761,11 +757,11 @@ .BR strtol (3), .BR strtoul (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/sched_getcpu.3 manpages-4.05/man3/sched_getcpu.3 --- manpages-4.04/man3/sched_getcpu.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/sched_getcpu.3 2016-03-15 03:47:41.000000000 +0000 @@ -108,11 +108,11 @@ .BR getcpu (2), .BR sched (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/seekdir.3 manpages-4.05/man3/seekdir.3 --- manpages-4.04/man3/seekdir.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/seekdir.3 2016-03-15 03:47:41.000000000 +0000 @@ -28,7 +28,7 @@ .\" 386BSD man pages .\" Modified Sat Jul 24 18:25:21 1993 by Rik Faith (faith@cs.unc.edu) .\" -.TH SEEKDIR 3 2015-08-08 "" "Linux Programmer's Manual" +.TH SEEKDIR 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME seekdir \- set the position of the next readdir() call in the directory stream. @@ -45,7 +45,9 @@ .in .sp .BR seekdir (): -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE + _XOPEN_SOURCE + || /* Glibc since 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .SH DESCRIPTION The .BR seekdir () @@ -96,11 +98,11 @@ .BR scandir (3), .BR telldir (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/sem_close.3 manpages-4.05/man3/sem_close.3 --- manpages-4.04/man3/sem_close.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/sem_close.3 2016-03-15 03:47:41.000000000 +0000 @@ -78,11 +78,11 @@ .BR sem_wait (3), .BR sem_overview (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/sem_destroy.3 manpages-4.05/man3/sem_destroy.3 --- manpages-4.04/man3/sem_destroy.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/sem_destroy.3 2016-03-15 03:47:41.000000000 +0000 @@ -89,11 +89,11 @@ .BR sem_wait (3), .BR sem_overview (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/sem_getvalue.3 manpages-4.05/man3/sem_getvalue.3 --- manpages-4.04/man3/sem_getvalue.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/sem_getvalue.3 2016-03-15 03:47:41.000000000 +0000 @@ -85,11 +85,11 @@ .BR sem_wait (3), .BR sem_overview (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/sem_init.3 manpages-4.05/man3/sem_init.3 --- manpages-4.04/man3/sem_init.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/sem_init.3 2016-03-15 03:47:41.000000000 +0000 @@ -117,11 +117,11 @@ .BR sem_wait (3), .BR sem_overview (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/sem_open.3 manpages-4.05/man3/sem_open.3 --- manpages-4.04/man3/sem_open.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/sem_open.3 2016-03-15 03:47:41.000000000 +0000 @@ -190,11 +190,11 @@ .BR sem_wait (3), .BR sem_overview (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/sem_post.3 manpages-4.05/man3/sem_post.3 --- manpages-4.04/man3/sem_post.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/sem_post.3 2016-03-15 03:47:41.000000000 +0000 @@ -84,11 +84,11 @@ .BR sem_wait (3), .BR sem_overview (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/sem_unlink.3 manpages-4.05/man3/sem_unlink.3 --- manpages-4.04/man3/sem_unlink.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/sem_unlink.3 2016-03-15 03:47:41.000000000 +0000 @@ -80,11 +80,11 @@ .BR sem_wait (3), .BR sem_overview (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/sem_wait.3 manpages-4.05/man3/sem_wait.3 --- manpages-4.04/man3/sem_wait.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/sem_wait.3 2016-03-15 03:47:41.000000000 +0000 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH SEM_WAIT 3 2015-08-08 "Linux" "Linux Programmer's Manual" +.TH SEM_WAIT 3 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME sem_wait, sem_timedwait, sem_trywait \- lock a semaphore .SH SYNOPSIS @@ -45,7 +45,7 @@ .in .sp .BR sem_timedwait (): -_POSIX_C_SOURCE\ >=\ 200112L || _XOPEN_SOURCE\ >=\ 600 +_POSIX_C_SOURCE\ >=\ 200112L .SH DESCRIPTION .BR sem_wait () decrements (locks) the semaphore pointed to by @@ -280,11 +280,11 @@ .BR sem_overview (7), .BR time (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/setaliasent.3 manpages-4.05/man3/setaliasent.3 --- manpages-4.04/man3/setaliasent.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/setaliasent.3 2016-03-15 03:47:41.000000000 +0000 @@ -172,11 +172,11 @@ .\" Yellow Pages .\" newaliases, postalias .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/setbuf.3 manpages-4.05/man3/setbuf.3 --- manpages-4.04/man3/setbuf.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/setbuf.3 2016-03-15 03:47:41.000000000 +0000 @@ -45,7 +45,7 @@ .\" Correction, 2000-03-03, Andreas Jaeger .\" Added return value for setvbuf, aeb, .\" -.TH SETBUF 3 2015-05-07 "Linux" "Linux Programmer's Manual" +.TH SETBUF 3 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME setbuf, setbuffer, setlinebuf, setvbuf \- stream buffering operations .SH SYNOPSIS @@ -69,7 +69,10 @@ .sp .BR setbuffer (), .BR setlinebuf (): -_BSD_SOURCE + Since glibc 2.19: + _DEFAULT_SOURCE + Glibc 2.19 and earlier: + _BSD_SOURCE .SH DESCRIPTION The three types of buffering available are unbuffered, block buffered, and line buffered. @@ -212,6 +215,7 @@ } .fi .SH SEE ALSO +.BR stdbuf (1), .BR fclose (3), .BR fflush (3), .BR fopen (3), @@ -220,11 +224,11 @@ .BR printf (3), .BR puts (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/setenv.3 manpages-4.05/man3/setenv.3 --- manpages-4.04/man3/setenv.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/setenv.3 2016-03-15 03:47:41.000000000 +0000 @@ -34,7 +34,7 @@ .\" Noted nonstandard behavior of setenv() if name contains '=' .\" 2005-08-12, mtk, glibc 2.3.4 fixed the "name contains '='" bug .\" -.TH SETENV 3 2015-08-08 "GNU" "Linux Programmer's Manual" +.TH SETENV 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME setenv \- change or add an environment variable .SH SYNOPSIS @@ -55,7 +55,8 @@ .BR setenv (), .BR unsetenv (): .RS 4 -_BSD_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L || _XOPEN_SOURCE\ >=\ 600 +_POSIX_C_SOURCE\ >=\ 200112L + || /* Glibc versions <= 2.19: */ _BSD_SOURCE .RE .ad b .SH DESCRIPTION @@ -169,11 +170,11 @@ .BR putenv (3), .BR environ (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/__setfpucw.3 manpages-4.05/man3/__setfpucw.3 --- manpages-4.04/man3/__setfpucw.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/__setfpucw.3 2016-03-15 03:47:41.000000000 +0000 @@ -63,11 +63,11 @@ .br .I .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/setjmp.3 manpages-4.05/man3/setjmp.3 --- manpages-4.04/man3/setjmp.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/setjmp.3 2016-03-15 03:47:41.000000000 +0000 @@ -1,4 +1,4 @@ -.\" Written by Michael Haardt, Fri Nov 25 14:51:42 MET 1994 +.\" Copyright (C) 2016 Michael Kerrisk .\" .\" %%%LICENSE_START(GPLv2+_DOC_FULL) .\" This is free documentation; you can redistribute it and/or @@ -24,16 +24,18 @@ .\" Added sigsetjmp, Sun Mar 2 22:03:05 EST 1997, jrv@vanzandt.mv.com .\" Modifications, Sun Feb 26 14:39:45 1995, faith@cs.unc.edu .\" " -.TH SETJMP 3 2015-08-08 "" "Linux Programmer's Manual" +.TH SETJMP 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME -setjmp, sigsetjmp \- save stack context for nonlocal goto +setjmp, sigsetjmp, longjmp, siglongjmp \- performing a nonlocal goto .SH SYNOPSIS .B #include .sp .nf .BI "int setjmp(jmp_buf " env ); - .BI "int sigsetjmp(sigjmp_buf " env ", int " savesigs ); + +.BI "void longjmp(jmp_buf " env ", int " val ); +.BI "void siglongjmp(sigjmp_buf " env ", int " val ); .fi .sp .in -4n @@ -42,75 +44,129 @@ .in .sp .BR setjmp (): -see NOTES. + see NOTES. .br .BR sigsetjmp (): -_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _POSIX_C_SOURCE +_POSIX_C_SOURCE .SH DESCRIPTION +The functions described on this page are used for performing "nonlocal gotos": +transferring execution from one function to a predetermined location +in another function. +The .BR setjmp () -and -.BR longjmp (3) -are useful for dealing with errors -and interrupts encountered in a low-level subroutine of a program. +function dynamically establishes the target to which control +will later be transferred, and +.BR longjmp () +performs the transfer of execution. + +The .BR setjmp () -saves the stack context/environment in -.I env -for -later use by -.BR longjmp (3). -The stack context will be invalidated -if the function which called +function saves various information about the calling environment +(typically, the stack pointer, the instruction pointer, +possibly the values of other registers and the signal mask) +in the buffer +.IR env +for later use by +.BR longjmp (). +In this case, .BR setjmp () -returns. -.P +returns 0. + +The +.BR longjmp () +function uses the information saved in +.IR env +to transfer control back to the point where +.BR setjmp () +was called and to restore ("rewind") the stack to its state at the time of the +.BR setjmp () +call. +In addition, and depending on the implementation (see NOTES), +the values of some other registers and the process signal mask +may be restored to their state at the time of the +.BR setjmp () +call. + +Following a successful +.BR longjmp (), +execution continues as if +.BR setjmp () +had returned for a second time. +This "fake" return can be distinguished from a true +.BR setjmp () +call because the "fake" return returns the value provided in +.IR val . +If the programmer mistakenly passes the value 0 in +.IR val , +the "fake" return will instead return 1. + +.SS sigsetjmp() and siglongjmp() .BR sigsetjmp () -is similar to -.BR setjmp (). -If, and only if, +and +.BR siglongjmp () +also perform nonlocal gotos, but provide predictable handling of +the process signal mask. + +If, and only if, the .I savesigs -is nonzero, -the process's current signal mask is saved in +argument provided to +.BR sigsetjmp () +is nonzero, the process's current signal mask is saved in .I env and will be restored if a -.BR siglongjmp (3) +.BR siglongjmp () is later performed with this .IR env . .SH RETURN VALUE .BR setjmp () and .BR sigsetjmp () -return 0 if returning directly, and -nonzero when returning from -.BR longjmp (3) +return 0 when called directly; +on the "fake" return that occurs after +.BR longjmp () +or +.BR siglongjmp (), +the nonzero value specified in +.I val +is returned. + +The +.BR longjmp () or -.BR siglongjmp (3) -using the saved context. +.BR siglongjmp () +functions do not return. .SH ATTRIBUTES For an explanation of the terms used in this section, see .BR attributes (7). .TS allbox; -lbw21 lb lb +lbw23 lb lb l l l. Interface Attribute Value T{ .BR setjmp (), .BR sigsetjmp () T} Thread safety MT-Safe +T{ +.BR longjmp (), +.BR siglongjmp () +T} Thread safety MT-Safe .TE .SH CONFORMING TO -.BR setjmp (): +.BR setjmp (), +.BR longjmp (): POSIX.1-2001, POSIX.1-2008, C89, C99. -.BR sigsetjmp (): +.BR sigsetjmp (), +.BR siglongjmp (): POSIX.1-2001, POSIX.1-2008. .SH NOTES POSIX does not specify whether .BR setjmp () will save the signal mask (to be later restored during -.BR longjmp (3)). +.BR longjmp (). In System V it will not. In 4.3BSD it will, and there is a function @@ -125,7 +181,7 @@ .BR _POSIX_SOURCE , .BR _POSIX_C_SOURCE , .BR _XOPEN_SOURCE , -.BR _XOPEN_SOURCE_EXTENDED , +.\" .BR _XOPEN_SOURCE_EXTENDED , .BR _GNU_SOURCE , or .B _SVID_SOURCE @@ -142,26 +198,139 @@ .I savesigs argument. -If you want to portably save and restore signal masks, use +.BR setjmp () +and +.BR longjmp (3) +can be useful for dealing with errors inside deeply nested function calls +or to allow a signal handler to pass control to +a specific point in the program, +rather than returning to the point where the handler interrupted +the main program. +In the latter case, +if you want to portably save and restore signal masks, use .BR sigsetjmp () and -.BR siglongjmp (3). +.BR siglongjmp (). +See also the discussion of program readability below. + +The compiler may optimize variables into registers, and +.BR longjmp () +may restore the values of other registers in addition to the +stack pointer and program counter. +Consequently, the values of automatic variables are unspecified +after a call to +.BR longjmp () +if they meet all the following criteria: +.IP \(bu 3 +they are local to the function that made the corresponding +.BR setjmp (3) +call; +.IP \(bu +their values are changed between the calls to +.BR setjmp (3) +and +.BR longjmp (); +and +.IP \(bu +they are not declared as +.IR volatile . .P +Analogous remarks apply for +.BR siglongjmp (). +.\" +.SS Nonlocal gotos and program readability +While it can be abused, +the traditional C "goto" statement at least has the benefit that lexical cues +(the goto statement and the target label) +allow the programmer to easily perceive the flow of control. +Nonlocal gotos provide no such cues: multiple +.BR setjmp () +calls might employ the same +.IR jmp_buf +variable so that the content of the variable may change +over the lifetime of the application. +Consequently, the programmer may be forced to perform detailed +reading of the code to determine the dynamic target of a particular +.BR longjmp () +call. +(To make the programmer's life easier, each +.BR setjmp () +call should employ a unique +.IR jmp_buf +variable.) + +Adding further difficulty, the .BR setjmp () and -.BR sigsetjmp () -make programs hard to understand -and maintain. -If possible, an alternative should be used. +.BR longjmp () +calls may not even be in the same source code module. + +In summary, nonlocal gotos can make programs harder to understand +and maintain, and an alternative should be used if possible. +.\" +.SS Caveats +If the function which called +.BR setjmp () +returns before +.BR longjmp () +is called, the behavior is undefined. +Some kind of subtle or unsubtle chaos is sure to result. + +If, in a multithreaded program, a +.BR longjmp () +call employs an +.I env +buffer that was initialized by a call to +.BR setjmp () +in a different thread, the behavior is undefined. +.\" +.\" The following statement appeared in versions up to POSIX.1-2008 TC1, +.\" but is set to be removed in POSIX.1-2008 TC2: +.\" +.\" According to POSIX.1, if a +.\" .BR longjmp () +.\" call is performed from a nested signal handler +.\" (i.e., from a handler that was invoked in response to a signal that was +.\" generated while another signal was already in the process of being +.\" handled), the behavior is undefined. + +POSIX.1-2008 Technical Corrigendum 2 adds +.\" http://austingroupbugs.net/view.php?id=516#c1195 +.BR longjmp () +and +.BR siglongjmp () +to the list of async-signal-safe functions. +However, the standard recommends avoiding the use of these functions +from signal handlers and goes on to point out that +if these functions are called from a signal handler that interrupted +a call to a non-async-signal-safe function (or some equivalent, +such as the steps equivalent to +.BR exit (3) +that occur upon a return from the initial call to +.IR main ()), +the behavior is undefined if the program subsequently makes a call to +a non-async-signal-safe function. +The only way of avoiding undefined behavior is to ensure one of the following: +.IP * 3 +After long jumping from the signal handler, +the program does not call any non-async-signal-safe functions +and does not return from the initial call to +.IR main (). +.IP * +Any signal whose handler performs a long jump must be blocked during +.I every +call to a non-async-signal-safe function and +no non-async-signal-safe functions are called after +returning from the initial call to +.IR main (). .SH SEE ALSO -.BR longjmp (3), -.BR siglongjmp (3) +.BR signal (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/setlocale.3 manpages-4.05/man3/setlocale.3 --- manpages-4.04/man3/setlocale.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/setlocale.3 2016-03-15 03:47:41.000000000 +0000 @@ -198,11 +198,11 @@ .BR charsets (7), .BR locale (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/setlogmask.3 manpages-4.05/man3/setlogmask.3 --- manpages-4.04/man3/setlogmask.3 2015-12-29 12:51:47.000000000 +0000 +++ manpages-4.05/man3/setlogmask.3 2016-03-15 03:47:41.000000000 +0000 @@ -93,11 +93,11 @@ .BR openlog (3), .BR syslog (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/setnetgrent.3 manpages-4.05/man3/setnetgrent.3 --- manpages-4.04/man3/setnetgrent.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/setnetgrent.3 2016-03-15 03:47:41.000000000 +0000 @@ -7,7 +7,7 @@ .\" based on glibc infopages .\" polished - aeb .\" -.TH SETNETGRENT 3 2015-04-19 "GNU" "Linux Programmer's Manual" +.TH SETNETGRENT 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME setnetgrent, endnetgrent, getnetgrent, getnetgrent_r, innetgr \- handle network group entries @@ -39,7 +39,10 @@ .BR getnetgrent (), .BR getnetgrent_r (), .BR innetgr (): -_BSD_SOURCE || _SVID_SOURCE + Since glibc 2.19: + _DEFAULT_SOURCE + Glibc 2.19 and earlier: + _BSD_SOURCE || _SVID_SOURCE .ad b .SH DESCRIPTION The @@ -153,11 +156,11 @@ .BR setprotoent (3), .BR setservent (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/shm_open.3 manpages-4.05/man3/shm_open.3 --- manpages-4.04/man3/shm_open.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/shm_open.3 2016-03-15 03:47:41.000000000 +0000 @@ -298,11 +298,11 @@ .BR umask (2), .BR shm_overview (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/siginterrupt.3 manpages-4.05/man3/siginterrupt.3 --- manpages-4.04/man3/siginterrupt.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/siginterrupt.3 2016-03-15 03:47:41.000000000 +0000 @@ -28,7 +28,7 @@ .\" 386BSD man pages .\" Modified Sun Jul 25 10:40:51 1993 by Rik Faith (faith@cs.unc.edu) .\" Modified Sun Apr 14 16:20:34 1996 by Andries Brouwer (aeb@cwi.nl) -.TH SIGINTERRUPT 3 2015-03-02 "" "Linux Programmer's Manual" +.TH SIGINTERRUPT 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME siginterrupt \- allow signals to interrupt system calls .SH SYNOPSIS @@ -46,10 +46,10 @@ .BR siginterrupt (): .ad l .RS 4 -_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 || -_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED -.br -|| /* Since glibc 2.12: */ _POSIX_C_SOURCE\ >=\ 200809L +_XOPEN_SOURCE\ >=\ 500 +.\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED + || /* Since glibc 2.12: */ _POSIX_C_SOURCE\ >=\ 200809L + || /* Glibc versions <= 2.19: */ _BSD_SOURCE .RE .ad .SH DESCRIPTION @@ -108,11 +108,11 @@ .SH SEE ALSO .BR signal (2) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/siglongjmp.3 manpages-4.05/man3/siglongjmp.3 --- manpages-4.04/man3/siglongjmp.3 2015-12-29 12:51:43.000000000 +0000 +++ manpages-4.05/man3/siglongjmp.3 2016-03-15 03:47:38.000000000 +0000 @@ -1 +1 @@ -.so man3/longjmp.3 +.so man3/setjmp.3 diff -Nru manpages-4.04/man3/signbit.3 manpages-4.05/man3/signbit.3 --- manpages-4.04/man3/signbit.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/signbit.3 2016-03-15 03:47:41.000000000 +0000 @@ -8,7 +8,7 @@ .\" .\" Based on glibc infopages, copyright Free Software Foundation .\" -.TH SIGNBIT 3 2015-08-08 "GNU" "Linux Programmer's Manual" +.TH SIGNBIT 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME signbit \- test sign of a real floating-point number .SH SYNOPSIS @@ -26,11 +26,7 @@ .ad l .BR signbit (): .RS 4 -_XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L .RE .ad .SH DESCRIPTION @@ -77,11 +73,11 @@ .SH SEE ALSO .BR copysign (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/significand.3 manpages-4.05/man3/significand.3 --- manpages-4.04/man3/significand.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/significand.3 2016-03-15 03:47:41.000000000 +0000 @@ -6,7 +6,7 @@ .\" .\" heavily based on glibc infopages, copyright Free Software Foundation .\" -.TH SIGNIFICAND 3 2015-04-19 "GNU" "Linux Programmer's Manual" +.TH SIGNIFICAND 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME significand, significandf, significandl \- get mantissa of floating-point number @@ -31,7 +31,8 @@ .BR significandf (), .BR significandl (): .RS 4 -_SVID_SOURCE || _BSD_SOURCE +/* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .ad b .SH DESCRIPTION @@ -73,11 +74,11 @@ .BR ilogb (3), .BR scalb (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/sigpause.3 manpages-4.05/man3/sigpause.3 --- manpages-4.04/man3/sigpause.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/sigpause.3 2016-03-15 03:47:41.000000000 +0000 @@ -67,7 +67,7 @@ .\" marking in glibc manual is more detailed. .\" sigpause: MT-Unsafe race:sigprocmask/!bsd!linux .\" glibc manual says /!linux!bsd indicate the preceding marker only applies -./" when the underlying kernel is neither Linux nor a BSD kernel. +.\" when the underlying kernel is neither Linux nor a BSD kernel. .\" So, it is safety in Linux kernel. T} Thread safety MT-Safe .TE @@ -131,11 +131,11 @@ .BR sigvec (3), .BR feature_test_macros (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/sigqueue.3 manpages-4.05/man3/sigqueue.3 --- manpages-4.04/man3/sigqueue.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/sigqueue.3 2016-03-15 03:47:41.000000000 +0000 @@ -172,11 +172,11 @@ .BR sigwait (3), .BR signal (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/sigset.3 manpages-4.05/man3/sigset.3 --- manpages-4.04/man3/sigset.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/sigset.3 2016-03-15 03:47:41.000000000 +0000 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH SIGSET 3 2015-08-08 "Linux" "Linux Programmer's Manual" +.TH SIGSET 3 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME sigset, sighold, sigrelse, sigignore \- System V signal API .SH SYNOPSIS @@ -51,8 +51,8 @@ .BR sigignore (): .br .RS 4 -_XOPEN_SOURCE\ >=\ 500 || -_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED +_XOPEN_SOURCE\ >=\ 500 +.\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED .RE .ad .SH DESCRIPTION @@ -290,11 +290,11 @@ .BR sigvec (3), .BR signal (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/sigsetops.3 manpages-4.05/man3/sigsetops.3 --- manpages-4.04/man3/sigsetops.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/sigsetops.3 2016-03-15 03:47:41.000000000 +0000 @@ -28,7 +28,7 @@ .\" 2007-10-26 mdw added wording that a sigset_t must be initialized .\" prior to use .\" -.TH SIGSETOPS 3 2015-08-08 "Linux" "Linux Programmer's Manual" +.TH SIGSETOPS 3 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME sigemptyset, sigfillset, sigaddset, sigdelset, sigismember \- POSIX signal set operations @@ -57,7 +57,7 @@ .BR sigdelset (), .BR sigismember (): .RS 4 -_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _POSIX_SOURCE +_POSIX_C_SOURCE .RE .ad b .SH DESCRIPTION @@ -161,7 +161,7 @@ See .BR nptl (7) for details. - +.\" .SS Glibc extensions If the .B _GNU_SOURCE @@ -206,11 +206,11 @@ .BR sigprocmask (2), .BR sigsuspend (2) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/sigvec.3 manpages-4.05/man3/sigvec.3 --- manpages-4.04/man3/sigvec.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/sigvec.3 2016-03-15 03:47:41.000000000 +0000 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH SIGVEC 3 2015-03-02 "Linux" "Linux Programmer's Manual" +.TH SIGVEC 3 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME sigvec, sigblock, sigsetmask, siggetmask, sigmask \- BSD signal API .SH SYNOPSIS @@ -45,7 +45,10 @@ .in .sp All functions shown above: -_BSD_SOURCE + Since glibc 2.19: + _DEFAULT_SOURCE + Glibc 2.19 and earlier: + _BSD_SOURCE .SH DESCRIPTION These functions are provided in glibc as a compatibility interface for programs that make use of the historical BSD signal API. @@ -283,11 +286,11 @@ .BR sigset (3), .BR signal (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/sigwait.3 manpages-4.05/man3/sigwait.3 --- manpages-4.04/man3/sigwait.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/sigwait.3 2016-03-15 03:47:41.000000000 +0000 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH SIGWAIT 3 2015-08-08 "Linux" "Linux Programmer's Manual" +.TH SIGWAIT 3 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME sigwait \- wait for a signal .SH SYNOPSIS @@ -40,7 +40,7 @@ .sp .ad l .BR sigwait (): -_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _POSIX_SOURCE +_POSIX_C_SOURCE .ad b .SH DESCRIPTION The @@ -115,11 +115,11 @@ .BR sigsetops (3), .BR signal (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/sin.3 manpages-4.05/man3/sin.3 --- manpages-4.04/man3/sin.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/sin.3 2016-03-15 03:47:41.000000000 +0000 @@ -32,7 +32,7 @@ .\" Modified 2002-07-27 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.TH SIN 3 2015-04-19 "" "Linux Programmer's Manual" +.TH SIN 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME sin, sinf, sinl \- sine function .SH SYNOPSIS @@ -57,11 +57,9 @@ .BR sinf (), .BR sinl (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .ad .SH DESCRIPTION @@ -141,11 +139,11 @@ .BR sincos (3), .BR tan (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/sincos.3 manpages-4.05/man3/sincos.3 --- manpages-4.04/man3/sincos.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/sincos.3 2016-03-15 03:47:41.000000000 +0000 @@ -94,11 +94,11 @@ .BR sin (3), .BR tan (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/sinh.3 manpages-4.05/man3/sinh.3 --- manpages-4.04/man3/sinh.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/sinh.3 2016-03-15 03:47:41.000000000 +0000 @@ -33,7 +33,7 @@ .\" Modified 2002-07-27 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.TH SINH 3 2015-04-19 "" "Linux Programmer's Manual" +.TH SINH 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME sinh, sinhf, sinhl \- hyperbolic sine function .SH SYNOPSIS @@ -58,11 +58,9 @@ .BR sinhf (), .BR sinhl (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .ad .SH DESCRIPTION @@ -148,11 +146,11 @@ .BR csinh (3), .BR tanh (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/sleep.3 manpages-4.05/man3/sleep.3 --- manpages-4.04/man3/sleep.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/sleep.3 2016-03-15 03:47:41.000000000 +0000 @@ -23,7 +23,7 @@ .\" %%%LICENSE_END .\" .\" Modified Sat Jul 24 18:16:02 1993 by Rik Faith (faith@cs.unc.edu) -.TH SLEEP 3 2015-08-08 "GNU" "Linux Programmer's Manual" +.TH SLEEP 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME sleep \- sleep for the specified number of seconds .SH SYNOPSIS @@ -72,16 +72,17 @@ .B SIGALRM while sleeping will cause undefined results. .SH SEE ALSO +.BR sleep (1), .BR alarm (2), .BR nanosleep (2), .BR signal (2), .BR signal (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/sockatmark.3 manpages-4.05/man3/sockatmark.3 --- manpages-4.04/man3/sockatmark.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/sockatmark.3 2016-03-15 03:47:41.000000000 +0000 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH SOCKATMARK 3 2015-08-08 "Linux" "Linux Programmer's Manual" +.TH SOCKATMARK 3 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME sockatmark \- determine whether socket is at out-of-band mark .SH SYNOPSIS @@ -37,7 +37,7 @@ .sp .ad l .BR sockatmark (): -_POSIX_C_SOURCE\ >=\ 200112L || _XOPEN_SOURCE\ >=\ 600 +_POSIX_C_SOURCE\ >=\ 200112L .ad b .SH DESCRIPTION .BR sockatmark () @@ -149,11 +149,11 @@ .BR send (2), .BR tcp (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/sqrt.3 manpages-4.05/man3/sqrt.3 --- manpages-4.04/man3/sqrt.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/sqrt.3 2016-03-15 03:47:41.000000000 +0000 @@ -31,7 +31,7 @@ .\" Modified 1993-07-24 by Rik Faith (faith@cs.unc.edu) .\" Modified 2002-07-27 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) -.TH SQRT 3 2015-04-19 "" "Linux Programmer's Manual" +.TH SQRT 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME sqrt, sqrtf, sqrtl \- square root function .SH SYNOPSIS @@ -56,11 +56,9 @@ .BR sqrtf (), .BR sqrtl (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .ad .SH DESCRIPTION @@ -128,11 +126,11 @@ .BR csqrt (3), .BR hypot (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/statvfs.3 manpages-4.05/man3/statvfs.3 --- manpages-4.04/man3/statvfs.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/statvfs.3 2016-03-15 03:47:41.000000000 +0000 @@ -27,7 +27,7 @@ .\" .\" Modified 2004-06-23 by Michael Kerrisk .\" -.TH STATVFS 3 2015-08-08 "Linux" "Linux Programmer's Manual" +.TH STATVFS 3 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME statvfs, fstatvfs \- get filesystem statistics .SH SYNOPSIS @@ -151,7 +151,8 @@ points to an invalid address. .TP .B EINTR -This call was interrupted by a signal. +This call was interrupted by a signal; see +.BR signal (7). .TP .B EIO An I/O error occurred while reading from the filesystem. @@ -254,11 +255,11 @@ .SH SEE ALSO .BR statfs (2) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/stdarg.3 manpages-4.05/man3/stdarg.3 --- manpages-4.04/man3/stdarg.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/stdarg.3 2016-03-15 03:47:41.000000000 +0000 @@ -344,11 +344,11 @@ } .fi .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/stdin.3 manpages-4.05/man3/stdin.3 --- manpages-4.04/man3/stdin.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/stdin.3 2016-03-15 03:47:41.000000000 +0000 @@ -158,11 +158,11 @@ .BR fopen (3), .BR stdio (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/stdio.3 manpages-4.05/man3/stdio.3 --- manpages-4.04/man3/stdio.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/stdio.3 2016-03-15 03:47:41.000000000 +0000 @@ -255,11 +255,11 @@ .BR stdout (3), .BR unlocked_stdio (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/stdio_ext.3 manpages-4.05/man3/stdio_ext.3 --- manpages-4.04/man3/stdio_ext.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/stdio_ext.3 2016-03-15 03:47:41.000000000 +0000 @@ -159,11 +159,11 @@ .BR flockfile (3), .BR fpurge (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/stpcpy.3 manpages-4.05/man3/stpcpy.3 --- manpages-4.04/man3/stpcpy.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/stpcpy.3 2016-03-15 03:47:41.000000000 +0000 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH STPCPY 3 2015-03-02 "GNU" "Linux Programmer's Manual" +.TH STPCPY 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME stpcpy \- copy a string returning a pointer to its end .SH SYNOPSIS @@ -43,7 +43,7 @@ .RS 4 .TP 4 Since glibc 2.10: -_XOPEN_SOURCE\ >=\ 700 || _POSIX_C_SOURCE\ >=\ 200809L +_POSIX_C_SOURCE\ >=\ 200809L .TP Before glibc 2.10: _GNU_SOURCE @@ -129,11 +129,11 @@ .BR string (3), .BR wcpcpy (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/stpncpy.3 manpages-4.05/man3/stpncpy.3 --- manpages-4.04/man3/stpncpy.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/stpncpy.3 2016-03-15 03:47:41.000000000 +0000 @@ -11,7 +11,7 @@ .\" GNU glibc-2 source code and manual .\" .\" Corrected, aeb, 990824 -.TH STPNCPY 3 2015-03-02 "GNU" "Linux Programmer's Manual" +.TH STPNCPY 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME stpncpy \- copy a fixed-size string, returning a pointer to its end .SH SYNOPSIS @@ -32,7 +32,7 @@ .RS 4 .TP 4 Since glibc 2.10: -_XOPEN_SOURCE\ >=\ 700 || _POSIX_C_SOURCE\ >=\ 200809L +_POSIX_C_SOURCE\ >=\ 200809L .TP Before glibc 2.10: _GNU_SOURCE @@ -108,11 +108,11 @@ .BR strncpy (3), .BR wcpncpy (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/strcasecmp.3 manpages-4.05/man3/strcasecmp.3 --- manpages-4.04/man3/strcasecmp.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/strcasecmp.3 2016-03-15 03:47:41.000000000 +0000 @@ -123,11 +123,11 @@ .BR wcscasecmp (3), .BR wcsncasecmp (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/strcat.3 manpages-4.05/man3/strcat.3 --- manpages-4.04/man3/strcat.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/strcat.3 2016-03-15 03:47:41.000000000 +0000 @@ -189,11 +189,11 @@ .BR wcscat (3), .BR wcsncat (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/strchr.3 manpages-4.05/man3/strchr.3 --- manpages-4.04/man3/strchr.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/strchr.3 2016-03-15 03:47:41.000000000 +0000 @@ -139,11 +139,11 @@ .BR wcschr (3), .BR wcsrchr (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/strcmp.3 manpages-4.05/man3/strcmp.3 --- manpages-4.04/man3/strcmp.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/strcmp.3 2016-03-15 03:47:41.000000000 +0000 @@ -102,11 +102,11 @@ .BR wcscmp (3), .BR wcsncmp (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/strcoll.3 manpages-4.05/man3/strcoll.3 --- manpages-4.04/man3/strcoll.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/strcoll.3 2016-03-15 03:47:41.000000000 +0000 @@ -99,11 +99,11 @@ .BR string (3), .BR strxfrm (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/strcpy.3 manpages-4.05/man3/strcpy.3 --- manpages-4.04/man3/strcpy.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/strcpy.3 2016-03-15 03:47:41.000000000 +0000 @@ -241,11 +241,11 @@ .BR wcscpy (3), .BR wcsncpy (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/strdup.3 manpages-4.05/man3/strdup.3 --- manpages-4.04/man3/strdup.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/strdup.3 2016-03-15 03:47:41.000000000 +0000 @@ -28,7 +28,7 @@ .\" 386BSD man pages .\" Modified Sun Jul 25 10:41:34 1993 by Rik Faith (faith@cs.unc.edu) .\" Modified Wed Oct 17 01:12:26 2001 by John Levon -.TH STRDUP 3 2015-03-29 "GNU" "Linux Programmer's Manual" +.TH STRDUP 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME strdup, strndup, strdupa, strndupa \- duplicate a string .SH SYNOPSIS @@ -53,17 +53,17 @@ .sp .BR strdup (): .RS 4 -_SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 || -_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED -.br -|| /* Since glibc 2.12: */ _POSIX_C_SOURCE\ >=\ 200809L +_XOPEN_SOURCE\ >=\ 500 +.\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED + || /* Since glibc 2.12: */ _POSIX_C_SOURCE\ >=\ 200809L + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .PP .BR strndup (): .RS 4 .TP 4 Since glibc 2.10: -_POSIX_C_SOURCE\ >=\ 200809L || _XOPEN_SOURCE\ >=\ 700 +_POSIX_C_SOURCE\ >=\ 200809L .TP Before glibc 2.10: _GNU_SOURCE @@ -156,11 +156,11 @@ .BR string (3), .BR wcsdup (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/strerror.3 manpages-4.05/man3/strerror.3 --- manpages-4.04/man3/strerror.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/strerror.3 2016-03-15 03:47:41.000000000 +0000 @@ -36,7 +36,7 @@ .\" 2005-12-13, mtk, Substantial rewrite of strerror_r() description .\" Addition of extra material on portability and standards. .\" -.TH STRERROR 3 2015-03-02 "" "Linux Programmer's Manual" +.TH STRERROR 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME strerror, strerror_r, strerror_l \- return string describing error number .SH SYNOPSIS @@ -64,7 +64,7 @@ .RS 4 The XSI-compliant version is provided if: .br -(_POSIX_C_SOURCE\ >=\ 200112L || _XOPEN_SOURCE\ >=\ 600) && !\ _GNU_SOURCE +(_POSIX_C_SOURCE\ >=\ 200112L) && ! \ _GNU_SOURCE .br Otherwise, the GNU-specific version is provided. .RE @@ -108,7 +108,7 @@ otherwise the GNU-specific version is provided. If no feature test macros are explicitly defined, then (since glibc 2.4) -.B _POSIX_SOURCE +.B _POSIX_C_SOURCE is defined by default with the value 200112L, so that the XSI-compliant version of .BR strerror_r () @@ -260,11 +260,11 @@ .BR strsignal (3), .BR locale (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/strerror_l.3 manpages-4.05/man3/strerror_l.3 --- manpages-4.04/man3/strerror_l.3 1970-01-01 00:00:00.000000000 +0000 +++ manpages-4.05/man3/strerror_l.3 2016-03-15 03:47:38.000000000 +0000 @@ -0,0 +1 @@ +.so man3/strerror.3 diff -Nru manpages-4.04/man3/strfmon.3 manpages-4.05/man3/strfmon.3 --- manpages-4.04/man3/strfmon.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/strfmon.3 2016-03-15 03:47:41.000000000 +0000 @@ -62,7 +62,6 @@ (see .BR duplocale (3)) or is not a valid locale object handle. - .PP Ordinary characters in .I format @@ -218,11 +217,11 @@ .BR sprintf (3), .BR locale (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/strfry.3 manpages-4.05/man3/strfry.3 --- manpages-4.04/man3/strfry.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/strfry.3 2016-03-15 03:47:41.000000000 +0000 @@ -75,11 +75,11 @@ .BR memfrob (3), .BR string (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/strftime.3 manpages-4.05/man3/strftime.3 --- manpages-4.04/man3/strftime.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/strftime.3 2016-03-15 03:47:41.000000000 +0000 @@ -34,7 +34,7 @@ .\" 2005-11-22 mtk, added Glibc Notes covering optional 'flag' and .\" 'width' components of conversion specifications. .\" -.TH STRFTIME 3 2015-03-02 "GNU" "Linux Programmer's Manual" +.TH STRFTIME 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME strftime \- format date and time .SH SYNOPSIS @@ -56,6 +56,12 @@ .I s of size .IR max . +The broken-down time structure +.I tm +is defined in +.IR . +See also +.BR ctime (3). .\" FIXME . POSIX says: Local timezone information is used as though .\" strftime() called tzset(). But this doesn't appear to be the case .PP @@ -74,28 +80,43 @@ to .IR s . However, the characters -of conversion specifications are replaced as follows: +of conversion specifications are replaced as shown in the list below. +In this list, the field(s) employed from the +.I tm +structure are also shown. .TP .B %a The abbreviated name of the day of the week according to the current locale. +(Calculated from +.IR tm_wday .) .TP .B %A The full name of the day of the week according to the current locale. +(Calculated from +.IR tm_wday .) .TP .B %b The abbreviated month name according to the current locale. +(Calculated from +.IR tm_mon .) .TP .B %B The full month name according to the current locale. +(Calculated from +.IR tm_mon .) .TP .B %c The preferred date and time representation for the current locale. .TP .B %C The century number (year/100) as a 2-digit integer. (SU) +(Calculated from +.IR tm_year .) .TP .B %d The day of the month as a decimal number (range 01 to 31). +(Calculated from +.IR tm_mday .) .TP .B %D Equivalent to @@ -112,6 +133,8 @@ .BR %d , the day of the month as a decimal number, but a leading zero is replaced by a space. (SU) +(Calculated from +.IR tm_mday .) .TP .B %E Modifier: use alternative format, see below. (SU) @@ -129,11 +152,21 @@ .BR %Y , except that if the ISO week number belongs to the previous or next year, that year is used instead. (TZ) +(Calculated from +.IR tm_year , +.IR tm_yday , +and +.IR tm_wday .) .TP .B %g Like .BR %G , but without century, that is, with a 2-digit year (00-99). (TZ) +(Calculated from +.IR tm_year , +.IR tm_yday , +and +.IR tm_wday .) .TP .B %h Equivalent to @@ -142,18 +175,26 @@ .TP .B %H The hour as a decimal number using a 24-hour clock (range 00 to 23). +(Calculated from +.IR tm_hour .) .TP .B %I The hour as a decimal number using a 12-hour clock (range 01 to 12). +(Calculated from +.IR tm_hour .) .TP .B %j The day of the year as a decimal number (range 001 to 366). +(Calculated from +.IR tm_yday .) .TP .B %k The hour (24-hour clock) as a decimal number (range 0 to 23); single digits are preceded by a blank. (See also .BR %H .) +(Calculated from +.IR tm_hour .) (TZ) .TP .B %l @@ -161,13 +202,19 @@ single digits are preceded by a blank. (See also .BR %I .) +(Calculated from +.IR tm_hour .) (TZ) .TP .B %m The month as a decimal number (range 01 to 12). +(Calculated from +.IR tm_mon .) .TP .B %M The minute as a decimal number (range 00 to 59). +(Calculated from +.IR tm_min .) .TP .B %n A newline character. (SU) @@ -179,12 +226,17 @@ Either "AM" or "PM" according to the given time value, or the corresponding strings for the current locale. Noon is treated as "PM" and midnight as "AM". +(Calculated from +.IR tm_hour .) .TP .B %P Like .B %p but in lowercase: "am" or "pm" or a corresponding -string for the current locale. (GNU) +string for the current locale. +(Calculated from +.IR tm_hour .) +(GNU) .TP .B %r The time in a.m. or p.m. notation. @@ -202,10 +254,14 @@ .TP .B %s The number of seconds since the Epoch, 1970-01-01 00:00:00 +0000 (UTC). (TZ) +(Calculated from +.IR mktime(tm) .) .TP .B %S The second as a decimal number (range 00 to 60). (The range is up to 60 to allow for occasional leap seconds.) +(Calculated from +.IR tm_sec .) .TP .B %t A tab character. (SU) @@ -219,6 +275,8 @@ The day of the week as a decimal, range 1 to 7, Monday being 1. See also .BR %w . +(Calculated from +.IR tm_wday .) (SU) .TP .B %U @@ -229,6 +287,10 @@ .B %V and .BR %W . +(Calculated from +.IR tm_yday +and +.IR tm_wday .) .TP .B %V The ISO\ 8601 week number (see NOTES) of the current year as a decimal number, @@ -238,16 +300,27 @@ .B %U and .BR %W . +(Calculated from +.IR tm_year , +.IR tm_yday , +and +.IR tm_wday .) (SU) .TP .B %w The day of the week as a decimal, range 0 to 6, Sunday being 0. See also .BR %u . +(Calculated from +.IR tm_wday .) .TP .B %W The week number of the current year as a decimal number, range 00 to 53, starting with the first Monday as the first day of week 01. +(Calculated from +.IR tm_yday +and +.IR tm_wday .) .TP .B %x The preferred date representation for the current locale without the time. @@ -257,9 +330,13 @@ .TP .B %y The year as a decimal number without a century (range 00 to 99). +(Calculated from +.IR tm_year ) .TP .B %Y The year as a decimal number including the century. +(Calculated from +.IR tm_year ) .TP .B %z The @@ -317,13 +394,6 @@ modifier is to use alternative numeric symbols (say, roman numerals), and that of the E modifier is to use a locale-dependent alternative representation. -.PP -The broken-down time structure -.I tm -is defined in -.IR . -See also -.BR ctime (3). .SH RETURN VALUE Provided that the result string, including the terminating null byte, does not exceed @@ -584,11 +654,11 @@ .BR sprintf (3), .BR strptime (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/string.3 manpages-4.05/man3/string.3 --- manpages-4.04/man3/string.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/string.3 2016-03-15 03:47:41.000000000 +0000 @@ -231,11 +231,11 @@ .BR strtok (3), .BR strxfrm (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/strlen.3 manpages-4.05/man3/strlen.3 --- manpages-4.04/man3/strlen.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/strlen.3 2016-03-15 03:47:41.000000000 +0000 @@ -27,7 +27,7 @@ .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified Sat Jul 24 18:02:26 1993 by Rik Faith (faith@cs.unc.edu) -.TH STRLEN 3 2015-08-08 "GNU" "Linux Programmer's Manual" +.TH STRLEN 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME strlen \- calculate the length of a string .SH SYNOPSIS @@ -39,13 +39,13 @@ .SH DESCRIPTION The .BR strlen () -function calculates the length of the string +function calculates the length of the string pointed to by .IR s , excluding the terminating null byte (\(aq\\0\(aq). .SH RETURN VALUE The .BR strlen () -function returns the number of bytes in the string +function returns the number of characters in the string pointed to by .IR s . .SH ATTRIBUTES For an explanation of the terms used in this section, see @@ -60,18 +60,18 @@ T} Thread safety MT-Safe .TE .SH CONFORMING TO -POSIX.1-2001, POSIX.1-2008, C89, C99, SVr4, 4.3BSD. +POSIX.1-2001, POSIX.1-2008, C89, C99, C11, SVr4, 4.3BSD. .SH SEE ALSO .BR string (3), .BR strnlen (3), .BR wcslen (3), .BR wcsnlen (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/strnlen.3 manpages-4.05/man3/strnlen.3 --- manpages-4.04/man3/strnlen.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/strnlen.3 2016-03-15 03:47:41.000000000 +0000 @@ -10,7 +10,7 @@ .\" References consulted: .\" GNU glibc-2 source code and manual .\" -.TH STRNLEN 3 2015-03-02 "GNU" "Linux Programmer's Manual" +.TH STRNLEN 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME strnlen \- determine the length of a fixed-size string .SH SYNOPSIS @@ -31,7 +31,7 @@ .RS 4 .TP 4 Since glibc 2.10: -_XOPEN_SOURCE\ >=\ 700 || _POSIX_C_SOURCE\ >=\ 200809L +_POSIX_C_SOURCE\ >=\ 200809L .TP Before glibc 2.10: _GNU_SOURCE @@ -41,7 +41,7 @@ .SH DESCRIPTION The .BR strnlen () -function returns the number of bytes in the string +function returns the number of characters in the string pointed to by .IR s , excluding the terminating null byte (\(aq\\0\(aq), @@ -51,7 +51,7 @@ .BR strnlen () looks only at the first .I maxlen -bytes at +characters in the string pointed to by .I s and never beyond .IR s+maxlen . @@ -64,9 +64,9 @@ .IR maxlen , or .I maxlen -if there is no null byte (\(aq\\0\(aq) among the first +if there is no null terminating (\(aq\\0\(aq) among the first .I maxlen -bytes pointed to by +characters pointed to by .IR s . .SH ATTRIBUTES For an explanation of the terms used in this section, see @@ -85,11 +85,11 @@ .SH SEE ALSO .BR strlen (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/strpbrk.3 manpages-4.05/man3/strpbrk.3 --- manpages-4.04/man3/strpbrk.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/strpbrk.3 2016-03-15 03:47:41.000000000 +0000 @@ -79,11 +79,11 @@ .BR strtok (3), .BR wcspbrk (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/strptime.3 manpages-4.05/man3/strptime.3 --- manpages-4.04/man3/strptime.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/strptime.3 2016-03-15 03:47:41.000000000 +0000 @@ -445,11 +445,11 @@ .BR setlocale (3), .BR strftime (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/strsep.3 manpages-4.05/man3/strsep.3 --- manpages-4.04/man3/strsep.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/strsep.3 2016-03-15 03:47:41.000000000 +0000 @@ -30,7 +30,7 @@ .\" Modified Mon Jan 20 12:04:18 1997 by Andries Brouwer (aeb@cwi.nl) .\" Modified Tue Jan 23 20:23:07 2001 by Andries Brouwer (aeb@cwi.nl) .\" -.TH STRSEP 3 2015-03-02 "GNU" "Linux Programmer's Manual" +.TH STRSEP 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME strsep \- extract token from string .SH SYNOPSIS @@ -46,7 +46,10 @@ .in .sp .BR strsep (): -_BSD_SOURCE + Since glibc 2.19: + _DEFAULT_SOURCE + Glibc 2.19 and earlier: + _BSD_SOURCE .SH DESCRIPTION If .I *stringp @@ -119,11 +122,11 @@ .BR strstr (3), .BR strtok (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/strsignal.3 manpages-4.05/man3/strsignal.3 --- manpages-4.04/man3/strsignal.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/strsignal.3 2016-03-15 03:47:41.000000000 +0000 @@ -27,7 +27,7 @@ .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified Sat Jul 24 17:59:03 1993 by Rik Faith (faith@cs.unc.edu) -.TH STRSIGNAL 3 2015-05-07 "GNU" "Linux Programmer's Manual" +.TH STRSIGNAL 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME strsignal \- return string describing signal .SH SYNOPSIS @@ -50,7 +50,7 @@ .RS 4 .TP 4 Since glibc 2.10: -_XOPEN_SOURCE\ >=\ 700 || _POSIX_C_SOURCE\ >=\ 200809L +_POSIX_C_SOURCE\ >=\ 200809L .TP Before glibc 2.10: _GNU_SOURCE @@ -101,11 +101,11 @@ .BR psignal (3), .BR strerror (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/strspn.3 manpages-4.05/man3/strspn.3 --- manpages-4.04/man3/strspn.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/strspn.3 2016-03-15 03:47:41.000000000 +0000 @@ -99,11 +99,11 @@ .BR wcscspn (3), .BR wcsspn (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/strstr.3 manpages-4.05/man3/strstr.3 --- manpages-4.04/man3/strstr.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/strstr.3 2016-03-15 03:47:41.000000000 +0000 @@ -110,11 +110,11 @@ .BR strtok (3), .BR wcsstr (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/strtod.3 manpages-4.05/man3/strtod.3 --- manpages-4.04/man3/strtod.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/strtod.3 2016-03-15 03:47:41.000000000 +0000 @@ -42,7 +42,7 @@ .\" (michael@cantor.informatik.rwth-aachen.de) .\" Added strof, strtold, aeb, 2001-06-07 .\" -.TH STRTOD 3 2015-08-08 "Linux" "Linux Programmer's Manual" +.TH STRTOD 3 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME strtod, strtof, strtold \- convert ASCII string to floating-point number .SH SYNOPSIS @@ -63,11 +63,7 @@ .BR strtof (), .BR strtold (): .RS 4 -_XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L .RE .ad .SH DESCRIPTION @@ -214,11 +210,11 @@ .BR strtol (3), .BR strtoul (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/strtoimax.3 manpages-4.05/man3/strtoimax.3 --- manpages-4.04/man3/strtoimax.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/strtoimax.3 2016-03-15 03:47:41.000000000 +0000 @@ -77,11 +77,11 @@ .BR strtoul (3), .BR wcstoimax (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/strtok.3 manpages-4.05/man3/strtok.3 --- manpages-4.04/man3/strtok.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/strtok.3 2016-03-15 03:47:41.000000000 +0000 @@ -29,7 +29,7 @@ .\" 2005-11-17, mtk: Substantial parts rewritten .\" 2013-05-19, mtk: added much further detail on the operation of strtok() .\" -.TH STRTOK 3 2015-08-08 "GNU" "Linux Programmer's Manual" +.TH STRTOK 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME strtok, strtok_r \- extract tokens from strings .SH SYNOPSIS @@ -48,15 +48,15 @@ .sp .ad l .BR strtok_r (): -_SVID_SOURCE || _BSD_SOURCE || _POSIX_C_SOURCE\ >=\ 1 || -_XOPEN_SOURCE || _POSIX_SOURCE +_POSIX_C_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .ad b .SH DESCRIPTION The .BR strtok () function breaks a string into a sequence of zero or more nonempty tokens. On the first call to -.BR strtok () +.BR strtok (), the string to be parsed should be specified in .IR str . @@ -283,11 +283,11 @@ .BR strstr (3), .BR wcstok (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/strtol.3 manpages-4.05/man3/strtol.3 --- manpages-4.04/man3/strtol.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/strtol.3 2016-03-15 03:47:41.000000000 +0000 @@ -28,7 +28,7 @@ .\" 386BSD man pages .\" Modified Sun Jul 25 10:53:39 1993 by Rik Faith (faith@cs.unc.edu) .\" Added correction due to nsd@bbc.com (Nick Duffek) - aeb, 950610 -.TH STRTOL 3 2015-08-08 "GNU" "Linux Programmer's Manual" +.TH STRTOL 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME strtol, strtoll, strtoq \- convert a string to a long integer .SH SYNOPSIS @@ -49,11 +49,8 @@ .ad l .BR strtoll (): .RS 4 -_XOPEN_SOURCE\ >=\ 600 || _BSD_SOURCE || _SVID_SOURCE || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE + || /* Glibc versions <= 2.19: */ _SVID_SOURCE || _BSD_SOURCE .RE .ad .SH DESCRIPTION @@ -304,11 +301,11 @@ .BR strtod (3), .BR strtoul (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/strtoul.3 manpages-4.05/man3/strtoul.3 --- manpages-4.04/man3/strtoul.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/strtoul.3 2016-03-15 03:47:41.000000000 +0000 @@ -30,7 +30,7 @@ .\" Fixed typo, aeb, 950823 .\" 2002-02-22, joey, mihtjel: Added strtoull() .\" -.TH STRTOUL 3 2015-08-08 "GNU" "Linux Programmer's Manual" +.TH STRTOUL 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME strtoul, strtoull, strtouq \- convert a string to an unsigned long integer .SH SYNOPSIS @@ -52,11 +52,8 @@ .ad l .BR strtoull (): .RS 4 -_XOPEN_SOURCE\ >=\ 600 || _BSD_SOURCE || _SVID_SOURCE || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || + || /* Glibc versions <= 2.19: */ _SVID_SOURCE || _BSD_SOURCE .RE .ad .SH DESCRIPTION @@ -232,11 +229,11 @@ .BR strtod (3), .BR strtol (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/strverscmp.3 manpages-4.05/man3/strverscmp.3 --- manpages-4.04/man3/strverscmp.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/strverscmp.3 2016-03-15 03:47:41.000000000 +0000 @@ -114,11 +114,11 @@ .BR strcmp (3), .BR strcoll (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/strxfrm.3 manpages-4.05/man3/strxfrm.3 --- manpages-4.04/man3/strxfrm.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/strxfrm.3 2016-03-15 03:47:41.000000000 +0000 @@ -106,11 +106,11 @@ .BR strcoll (3), .BR string (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/swab.3 manpages-4.05/man3/swab.3 --- manpages-4.04/man3/swab.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/swab.3 2016-03-15 03:47:41.000000000 +0000 @@ -86,11 +86,11 @@ .SH SEE ALSO .BR bstring (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/sysconf.3 manpages-4.05/man3/sysconf.3 --- manpages-4.04/man3/sysconf.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/sysconf.3 2016-03-15 03:47:41.000000000 +0000 @@ -336,7 +336,6 @@ .BR sysconf () T} Thread safety MT-Safe env .TE - .SH CONFORMING TO POSIX.1-2001, POSIX.1-2008. .SH BUGS @@ -358,11 +357,11 @@ .BR pathconf (3), .BR posixoptions (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/syslog.3 manpages-4.05/man3/syslog.3 --- manpages-4.04/man3/syslog.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/syslog.3 2016-03-15 03:47:41.000000000 +0000 @@ -33,7 +33,7 @@ .\" Modified 13 Dec 2001, Martin Schulze .\" Modified 3 Jan 2002, Michael Kerrisk .\" -.TH SYSLOG 3 2015-02-21 "Linux" "Linux Programmer's Manual" +.TH SYSLOG 3 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME closelog, openlog, syslog, vsyslog \- send messages to the system logger .SH SYNOPSIS @@ -53,10 +53,13 @@ .in .sp .BR vsyslog (): -_BSD_SOURCE + Since glibc 2.19: + _DEFAULT_SOURCE + Glibc 2.19 and earlier: + _BSD_SOURCE .SH DESCRIPTION .BR closelog () -closes the descriptor being used to write to the system logger. +closes the file descriptor being used to write to the system logger. The use of .BR closelog () is optional. @@ -333,11 +336,11 @@ .BR syslog.conf (5), .BR syslogd (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/system.3 manpages-4.05/man3/system.3 --- manpages-4.04/man3/system.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/system.3 2016-03-15 03:47:41.000000000 +0000 @@ -28,7 +28,7 @@ .\" Modified 14 May 2001, 23 Sep 2001 by aeb .\" 2004-12-20, mtk .\" -.TH SYSTEM 3 2015-08-08 "" "Linux Programmer's Manual" +.TH SYSTEM 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME system \- execute a shell command .SH SYNOPSIS @@ -101,8 +101,8 @@ the macros described in .BR waitpid (2). (i.e., -.BR WIFEXITED () -.BR WEXITSTATUS () +.BR WIFEXITED (), +.BR WEXITSTATUS (), and so on). .PP .BR system () @@ -213,18 +213,19 @@ where a shell could not be executed in the child process. .SH SEE ALSO .BR sh (1), +.BR fork (2), +.BR execve (2), .BR sigaction (2), .BR sigprocmask (2), -.BR fork (2), .BR wait (2), .BR exec (3), .BR signal (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/sysv_signal.3 manpages-4.05/man3/sysv_signal.3 --- manpages-4.04/man3/sysv_signal.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/sysv_signal.3 2016-03-15 03:47:41.000000000 +0000 @@ -102,11 +102,11 @@ .BR bsd_signal (3), .BR signal (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/tan.3 manpages-4.05/man3/tan.3 --- manpages-4.04/man3/tan.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/tan.3 2016-03-15 03:47:41.000000000 +0000 @@ -32,7 +32,7 @@ .\" Modified 2002-07-27 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.TH TAN 3 2015-04-19 "" "Linux Programmer's Manual" +.TH TAN 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME tan, tanf, tanl \- tangent function .SH SYNOPSIS @@ -57,11 +57,9 @@ .BR tanf (), .BR tanl (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .ad .SH DESCRIPTION @@ -165,11 +163,11 @@ .BR ctan (3), .BR sin (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/tanh.3 manpages-4.05/man3/tanh.3 --- manpages-4.04/man3/tanh.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/tanh.3 2016-03-15 03:47:41.000000000 +0000 @@ -32,7 +32,7 @@ .\" Modified 2002-07-27 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.TH TANH 3 2015-04-19 "" "Linux Programmer's Manual" +.TH TANH 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME tanh, tanhf, tanhl \- hyperbolic tangent function .SH SYNOPSIS @@ -57,11 +57,9 @@ .BR tanhf (), .BR tanhl (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .RE .ad .SH DESCRIPTION @@ -124,11 +122,11 @@ .BR ctanh (3), .BR sinh (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/tcgetpgrp.3 manpages-4.05/man3/tcgetpgrp.3 --- manpages-4.04/man3/tcgetpgrp.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/tcgetpgrp.3 2016-03-15 03:47:41.000000000 +0000 @@ -135,11 +135,11 @@ .BR setsid (2), .BR credentials (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/tcgetsid.3 manpages-4.05/man3/tcgetsid.3 --- manpages-4.04/man3/tcgetsid.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/tcgetsid.3 2016-03-15 03:47:41.000000000 +0000 @@ -85,11 +85,11 @@ .SH SEE ALSO .BR getsid (2) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/telldir.3 manpages-4.05/man3/telldir.3 --- manpages-4.04/man3/telldir.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/telldir.3 2016-03-15 03:47:41.000000000 +0000 @@ -27,7 +27,7 @@ .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified Sat Jul 24 17:48:42 1993 by Rik Faith (faith@cs.unc.edu) -.TH TELLDIR 3 2015-08-08 "" "Linux Programmer's Manual" +.TH TELLDIR 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME telldir \- return current location in directory stream .SH SYNOPSIS @@ -43,7 +43,9 @@ .in .sp .BR telldir (): -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE + _XOPEN_SOURCE + || /* Glibc since 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .SH DESCRIPTION The .BR telldir () @@ -107,11 +109,11 @@ .BR scandir (3), .BR seekdir (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/tempnam.3 manpages-4.05/man3/tempnam.3 --- manpages-4.04/man3/tempnam.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/tempnam.3 2016-03-15 03:47:41.000000000 +0000 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH TEMPNAM 3 2015-03-02 "" "Linux Programmer's Manual" +.TH TEMPNAM 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME tempnam \- create a name for a temporary file .SH SYNOPSIS @@ -38,7 +38,10 @@ .in .sp .BR tempnam (): -_BSD_SOURCE || _SVID_SOURCE + Since glibc 2.19: + _DEFAULT_SOURCE + Glibc 2.19 and earlier: + _BSD_SOURCE || _SVID_SOURCE .SH DESCRIPTION .I "Never use this function." Use @@ -183,11 +186,11 @@ .BR tmpfile (3), .BR tmpnam (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/termios.3 manpages-4.05/man3/termios.3 --- manpages-4.04/man3/termios.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/termios.3 2016-03-15 03:47:41.000000000 +0000 @@ -37,7 +37,7 @@ .\" Enhanced the discussion of "raw" mode for cfmakeraw(). .\" Document CMSPAR. .\" -.TH TERMIOS 3 2015-12-05 "Linux" "Linux Programmer's Manual" +.TH TERMIOS 3 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME termios, tcgetattr, tcsetattr, tcsendbreak, tcdrain, tcflush, tcflow, cfmakeraw, cfgetospeed, cfgetispeed, cfsetispeed, cfsetospeed, cfsetspeed \- @@ -81,7 +81,10 @@ .sp .BR cfsetspeed (), .BR cfmakeraw (): -_BSD_SOURCE + Since glibc 2.19: + _DEFAULT_SOURCE + Glibc 2.19 and earlier: + _BSD_SOURCE .SH DESCRIPTION The termios functions describe a general terminal interface that is provided to control asynchronous communications ports. @@ -728,11 +731,26 @@ then only as many bytes as requested are read, and the remaining characters will be available for a future .BR read (2). +.IP * 2 +The maximum line length is 4096 chars +(including the terminating newline character); +lines longer than 4096 chars are truncated. +After 4095 characters, input processing (e.g., +.B ISIG +and +.B ECHO* +processing) continues, but any input data after 4095 characters up to +(but not including) any terminating newline is discarded. +This ensures that the terminal can always receive +more input until at least one line can be read. .PP In noncanonical mode input is available immediately (without the user having to type a line-delimiter character), no input processing is performed, and line editing is disabled. +The read buffer will only accept 4095 chars; this provides the +necessary space for a newline char if the input mode is switched +to canonical. The settings of MIN .RI ( c_cc[VMIN] ) and TIME @@ -1069,15 +1087,16 @@ .BR stty (1), .BR tput (1), .BR tset (1), +.BR tty (1), .BR console_ioctl (4), .BR tty_ioctl (4), .BR setserial (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/tgamma.3 manpages-4.05/man3/tgamma.3 --- manpages-4.04/man3/tgamma.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/tgamma.3 2016-03-15 03:47:41.000000000 +0000 @@ -10,7 +10,7 @@ .\" Modified 2004-11-15, fixed error noted by Fabian Kreutz .\" .\" -.TH TGAMMA 3 2015-04-19 "GNU" "Linux Programmer's Manual" +.TH TGAMMA 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME tgamma, tgammaf, tgammal \- true gamma function .SH SYNOPSIS @@ -34,11 +34,8 @@ .BR tgammaf (), .BR tgammal (): .RS 4 -_XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || +_POSIX_C_SOURCE\ >=\ 200112L .RE .ad .SH DESCRIPTION @@ -205,11 +202,11 @@ .BR gamma (3), .BR lgamma (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/timegm.3 manpages-4.05/man3/timegm.3 --- manpages-4.04/man3/timegm.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/timegm.3 2016-03-15 03:47:41.000000000 +0000 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH TIMEGM 3 2015-03-02 "GNU" "Linux Programmer's Manual" +.TH TIMEGM 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME timegm, timelocal \- inverses of gmtime and localtime .SH SYNOPSIS @@ -41,7 +41,10 @@ .sp .BR timelocal (), .BR timegm (): -_BSD_SOURCE || _SVID_SOURCE + Since glibc 2.19: + _DEFAULT_SOURCE + Glibc 2.19 and earlier: + _BSD_SOURCE || _SVID_SOURCE .SH DESCRIPTION The functions .BR timelocal () @@ -51,6 +54,13 @@ .BR localtime (3) and .BR gmtime (3). +Both functions take a broken-down time and convert it to calendar time +(seconds since the Epoch, 1970-01-01 00:00:00 +0000, UTC). +The difference between the two functions is that +.BR timelocal () +takes the local timezone into account when doing the conversion, while +.BR timegm () +takes the input value to be Coordinated Universal Time (UTC). .SH ATTRIBUTES For an explanation of the terms used in this section, see .BR attributes (7). @@ -67,62 +77,24 @@ .SH CONFORMING TO These functions are nonstandard GNU extensions that are also present on the BSDs. -Avoid their use; see NOTES. +Avoid their use. .SH NOTES The .BR timelocal () function is equivalent to the POSIX standard function .BR mktime (3). There is no reason to ever use it. -.LP -For a portable version of -.BR timegm (), -set the -.B TZ -environment variable to UTC, call -.BR mktime (3) -and restore the value of -.BR TZ . -Something like - -.in +4n -.nf -#include -#include - -time_t -my_timegm(struct tm *tm) -{ - time_t ret; - char *tz; - - tz = getenv("TZ"); - if (tz) - tz = strdup(tz); - setenv("TZ", "", 1); - tzset(); - ret = mktime(tm); - if (tz) { - setenv("TZ", tz, 1); - free(tz); - } else - unsetenv("TZ"); - tzset(); - return ret; -} -.fi -.in .SH SEE ALSO .BR gmtime (3), .BR localtime (3), .BR mktime (3), .BR tzset (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/timeradd.3 manpages-4.05/man3/timeradd.3 --- manpages-4.04/man3/timeradd.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/timeradd.3 2016-03-15 03:47:41.000000000 +0000 @@ -24,7 +24,7 @@ .\" .\" 2007-07-31, mtk, Created .\" -.TH TIMERADD 3 2010-02-25 "Linux" "Linux Programmer's Manual" +.TH TIMERADD 3 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME timeradd, timersub, timercmp, timerclear, timerisset \- timeval operations .SH SYNOPSIS @@ -50,7 +50,10 @@ .in .sp All functions shown above: -_BSD_SOURCE + Since glibc 2.19: + _DEFAULT_SOURCE + Glibc 2.19 and earlier: + _BSD_SOURCE .SH DESCRIPTION The macros are provided to operate on .I timeval @@ -151,11 +154,11 @@ .BR gettimeofday (2), .BR time (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/tmpfile.3 manpages-4.05/man3/tmpfile.3 --- manpages-4.04/man3/tmpfile.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/tmpfile.3 2016-03-15 03:47:41.000000000 +0000 @@ -28,7 +28,7 @@ .\" 386BSD man pages .\" Modified Sat Jul 24 17:46:57 1993 by Rik Faith (faith@cs.unc.edu) .\" Modified 2001-11-17, aeb -.TH TMPFILE 3 2015-12-28 "" "Linux Programmer's Manual" +.TH TMPFILE 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME tmpfile \- create a temporary file .SH SYNOPSIS @@ -62,7 +62,8 @@ Unable to generate a unique filename. .TP .B EINTR -The call was interrupted by a signal. +The call was interrupted by a signal; see +.BR signal (7). .TP .B EMFILE The per-process limit on the number of open file descriptors has been reached. @@ -113,11 +114,11 @@ .BR tempnam (3), .BR tmpnam (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/tmpnam.3 manpages-4.05/man3/tmpnam.3 --- manpages-4.04/man3/tmpnam.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/tmpnam.3 2016-03-15 03:47:41.000000000 +0000 @@ -24,7 +24,7 @@ .\" .\" 2003-11-15, aeb, added tmpnam_r .\" -.TH TMPNAM 3 2015-03-02 "" "Linux Programmer's Manual" +.TH TMPNAM 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME tmpnam, tmpnam_r \- create a name for a temporary file .SH SYNOPSIS @@ -157,16 +157,7 @@ .fi .sp apparently as a warning not to use NULL. -A few systems implement it. -To get a glibc prototype for this function from -.IR , -define -.B _SVID_SOURCE -or -.B _BSD_SOURCE -(before including -.I any -header file). +A few systems implement it and an implementation is provided in glibc. .SH BUGS Never use this function. Use @@ -180,11 +171,11 @@ .BR tempnam (3), .BR tmpfile (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/toascii.3 manpages-4.05/man3/toascii.3 --- manpages-4.04/man3/toascii.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/toascii.3 2016-03-15 03:47:41.000000000 +0000 @@ -24,7 +24,7 @@ .\" .\" Added BUGS section, aeb, 950919 .\" -.TH TOASCII 3 2015-03-02 "GNU" "Linux Programmer's Manual" +.TH TOASCII 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME toascii \- convert character to ASCII .SH SYNOPSIS @@ -40,7 +40,9 @@ .in .sp .BR toascii (): -_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE +_XOPEN_SOURCE + || /* Glibc since 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _SVID_SOURCE || _BSD_SOURCE .SH DESCRIPTION .BR toascii () converts @@ -77,11 +79,11 @@ .BR tolower (3), .BR toupper (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/toupper.3 manpages-4.05/man3/toupper.3 --- manpages-4.04/man3/toupper.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/toupper.3 2016-03-15 03:47:41.000000000 +0000 @@ -76,7 +76,7 @@ If .I c -is a uppercase letter, +is an uppercase letter, .BR tolower () returns its lowercase equivalent, if a lowercase representation exists in the current locale. @@ -158,11 +158,11 @@ .BR towupper (3), .BR locale (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/towctrans.3 manpages-4.05/man3/towctrans.3 --- manpages-4.04/man3/towctrans.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/towctrans.3 2016-03-15 03:47:41.000000000 +0000 @@ -78,11 +78,11 @@ .BR towupper (3), .BR wctrans (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/towlower.3 manpages-4.05/man3/towlower.3 --- manpages-4.04/man3/towlower.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/towlower.3 2016-03-15 03:47:41.000000000 +0000 @@ -127,11 +127,11 @@ .BR towupper (3), .BR locale (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/towupper.3 manpages-4.05/man3/towupper.3 --- manpages-4.04/man3/towupper.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/towupper.3 2016-03-15 03:47:41.000000000 +0000 @@ -127,11 +127,11 @@ .BR towlower (3), .BR locale (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/trunc.3 manpages-4.05/man3/trunc.3 --- manpages-4.04/man3/trunc.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/trunc.3 2016-03-15 03:47:41.000000000 +0000 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH TRUNC 3 2015-04-19 "" "Linux Programmer's Manual" +.TH TRUNC 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME trunc, truncf, truncl \- round to integer, toward zero .SH SYNOPSIS @@ -48,11 +48,7 @@ .BR truncf (), .BR truncl (): .RS 4 -_XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L .RE .ad .SH DESCRIPTION @@ -105,11 +101,11 @@ .BR rint (3), .BR round (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/tsearch.3 manpages-4.05/man3/tsearch.3 --- manpages-4.04/man3/tsearch.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/tsearch.3 2016-03-15 03:47:41.000000000 +0000 @@ -313,11 +313,11 @@ .BR lsearch (3), .BR qsort (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/ttyname.3 manpages-4.05/man3/ttyname.3 --- manpages-4.04/man3/ttyname.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/ttyname.3 2016-03-15 03:47:41.000000000 +0000 @@ -93,11 +93,11 @@ .BR ctermid (3), .BR isatty (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/ttyslot.3 manpages-4.05/man3/ttyslot.3 --- manpages-4.04/man3/ttyslot.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/ttyslot.3 2016-03-15 03:47:41.000000000 +0000 @@ -25,7 +25,7 @@ .\" This replaces an earlier man page written by Walter Harms .\" . .\" -.TH TTYSLOT 3 2015-03-02 "GNU" "Linux Programmer's Manual" +.TH TTYSLOT 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME ttyslot \- find the slot of the current user's terminal in some file .SH SYNOPSIS @@ -43,9 +43,13 @@ .ad l .BR ttyslot (): .RS 4 -_BSD_SOURCE || +Since glibc 2.20: + _BSD_SOURCE || + _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_\ <\ 500 .br -_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_\ <\ 500\ &&\ _XOPEN_SOURCE_EXTENDED +Glibc 2.19 and earlier: + _DEFAULT_SOURCE || + _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_\ <\ 500 .RE .ad b .SH DESCRIPTION @@ -160,11 +164,11 @@ .BR ttyname (3), .BR utmp (5) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/tzset.3 manpages-4.05/man3/tzset.3 --- manpages-4.04/man3/tzset.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/tzset.3 2016-03-15 03:47:41.000000000 +0000 @@ -30,7 +30,7 @@ .\" Modified 2001-11-13, aeb .\" Modified 2004-12-01 mtk and Martin Schulze .\" -.TH TZSET 3 2015-12-28 "" "Linux Programmer's Manual" +.TH TZSET 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME tzset, tzname, timezone, daylight \- initialize time conversion information .SH SYNOPSIS @@ -50,16 +50,16 @@ .in .sp .BR tzset (): -_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _POSIX_SOURCE +_POSIX_C_SOURCE .br .IR tzname : -_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _POSIX_SOURCE -.br -.IR timezone : -_SVID_SOURCE || _XOPEN_SOURCE +_POSIX_C_SOURCE .br +.IR timezone , .IR daylight : -_SVID_SOURCE || _XOPEN_SOURCE +_XOPEN_SOURCE + || /* Glibc since 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _SVID_SOURCE .SH DESCRIPTION The .BR tzset () @@ -115,7 +115,6 @@ .RS .RI [ + | - ] hh [ :mm [ :ss ]] .RE -.sp .PP The \fIdst\fP string and \fIoffset\fP specify the name and offset for the corresponding daylight saving timezone. @@ -239,11 +238,11 @@ .BR getenv (3), .BR tzfile (5) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/ualarm.3 manpages-4.05/man3/ualarm.3 --- manpages-4.04/man3/ualarm.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/ualarm.3 2016-03-15 03:47:41.000000000 +0000 @@ -21,7 +21,7 @@ .\" . .\" %%%LICENSE_END .\" -.TH UALARM 3 2015-03-02 "" "Linux Programmer's Manual" +.TH UALARM 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME ualarm \- schedule signal after given number of microseconds .SH SYNOPSIS @@ -43,15 +43,14 @@ .TP 4 Since glibc 2.12: .nf -_BSD_SOURCE || - (_XOPEN_SOURCE\ >=\ 500 || - _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED) && - !(_POSIX_C_SOURCE\ >=\ 200809L || _XOPEN_SOURCE\ >=\ 700) +(_XOPEN_SOURCE\ >=\ 500) && ! (_POSIX_C_SOURCE\ >=\ 200809L) + || /* Glibc since 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE .TP 4 .fi Before glibc 2.12: -_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 || -_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED +_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 +.\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED .PD .RE .ad b @@ -84,7 +83,8 @@ .SH ERRORS .TP .B EINTR -Interrupted by a signal. +Interrupted by a signal; see +.BR signal (7). .TP .B EINVAL \fIusecs\fP or \fIinterval\fP is not smaller than 1000000. @@ -160,11 +160,11 @@ .BR usleep (3), .BR time (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/ulimit.3 manpages-4.05/man3/ulimit.3 --- manpages-4.04/man3/ulimit.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/ulimit.3 2016-03-15 03:47:41.000000000 +0000 @@ -99,11 +99,11 @@ .BR setrlimit (2), .BR sysconf (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/undocumented.3 manpages-4.05/man3/undocumented.3 --- manpages-4.04/man3/undocumented.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/undocumented.3 2016-03-15 03:47:41.000000000 +0000 @@ -29,7 +29,7 @@ .\" .TH UNDOCUMENTED 3 2015-05-07 "Linux" "Linux Programmer's Manual" .SH NAME -none \- undocumented library functions +undocumented \- undocumented library functions .SH SYNOPSIS Undocumented library functions .SH DESCRIPTION @@ -177,11 +177,11 @@ .BR yp_unbind (3), .BR yp_update (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/ungetwc.3 manpages-4.05/man3/ungetwc.3 --- manpages-4.04/man3/ungetwc.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/ungetwc.3 2016-03-15 03:47:41.000000000 +0000 @@ -98,11 +98,11 @@ .SH SEE ALSO .BR fgetwc (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/unlocked_stdio.3 manpages-4.05/man3/unlocked_stdio.3 --- manpages-4.04/man3/unlocked_stdio.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/unlocked_stdio.3 2016-03-15 03:47:41.000000000 +0000 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH UNLOCKED_STDIO 3 2015-08-08 "" "Linux Programmer's Manual" +.TH UNLOCKED_STDIO 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME getc_unlocked, getchar_unlocked, putc_unlocked, putchar_unlocked \- nonlocking stdio functions @@ -73,8 +73,8 @@ .BR putc_unlocked (), .BR putchar_unlocked (): .RS 4 -_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _POSIX_SOURCE || -_BSD_SOURCE || _SVID_SOURCE +_POSIX_C_SOURCE + || /* Glibc versions <= 2.19: */ _SVID_SOURCE || _BSD_SOURCE .RE .sp .BR clearerr_unlocked (), @@ -87,7 +87,8 @@ .BR fread_unlocked (), .BR fwrite_unlocked (): .RS 4 -_BSD_SOURCE || _SVID_SOURCE +/* Glibc since 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _SVID_SOURCE || _BSD_SOURCE .RE .sp .BR fgets_unlocked (), @@ -178,11 +179,11 @@ .BR flockfile (3), .BR stdio (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/unlockpt.3 manpages-4.05/man3/unlockpt.3 --- manpages-4.04/man3/unlockpt.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/unlockpt.3 2016-03-15 03:47:41.000000000 +0000 @@ -64,11 +64,11 @@ .BR pts (4), .BR pty (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/updwtmp.3 manpages-4.05/man3/updwtmp.3 --- manpages-4.04/man3/updwtmp.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/updwtmp.3 2016-03-15 03:47:41.000000000 +0000 @@ -97,11 +97,11 @@ .BR getutxent (3), .BR wtmp (5) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/uselocale.3 manpages-4.05/man3/uselocale.3 --- manpages-4.04/man3/uselocale.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/uselocale.3 2016-03-15 03:47:41.000000000 +0000 @@ -124,11 +124,11 @@ .BR locale (5), .BR locale (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/usleep.3 manpages-4.05/man3/usleep.3 --- manpages-4.04/man3/usleep.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/usleep.3 2016-03-15 03:47:41.000000000 +0000 @@ -30,7 +30,7 @@ .\" Modified 2001-04-01 by aeb .\" Modified 2003-07-23 by aeb .\" -.TH USLEEP 3 2015-03-02 "" "Linux Programmer's Manual" +.TH USLEEP 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME usleep \- suspend execution for microsecond intervals .SH SYNOPSIS @@ -52,15 +52,14 @@ .TP 4 Since glibc 2.12: .nf -_BSD_SOURCE || - (_XOPEN_SOURCE\ >=\ 500 || - _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED) && - !(_POSIX_C_SOURCE\ >=\ 200809L || _XOPEN_SOURCE\ >=\ 700) +(_XOPEN_SOURCE\ >=\ 500) && ! (_POSIX_C_SOURCE\ >=\ 200809L) + || /* Glibc since 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _BSD_SOURCE .TP 4 .fi Before glibc 2.12: -_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 || -_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED +_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 +.\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED .PD .RE .ad b @@ -161,11 +160,11 @@ .BR ualarm (3), .BR time (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/wcpcpy.3 manpages-4.05/man3/wcpcpy.3 --- manpages-4.04/man3/wcpcpy.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/wcpcpy.3 2016-03-15 03:47:41.000000000 +0000 @@ -12,7 +12,7 @@ .\" Dinkumware C library reference http://www.dinkumware.com/ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" -.TH WCPCPY 3 2015-03-02 "GNU" "Linux Programmer's Manual" +.TH WCPCPY 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME wcpcpy \- copy a wide-character string, returning a pointer to its end .SH SYNOPSIS @@ -33,7 +33,7 @@ .RS 4 .TP 4 Since glibc 2.10: -_XOPEN_SOURCE\ >=\ 700 || _POSIX_C_SOURCE\ >=\ 200809L +_POSIX_C_SOURCE\ >=\ 200809L .TP Before glibc 2.10: _GNU_SOURCE @@ -82,11 +82,11 @@ .BR strcpy (3), .BR wcscpy (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/wcpncpy.3 manpages-4.05/man3/wcpncpy.3 --- manpages-4.04/man3/wcpncpy.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/wcpncpy.3 2016-03-15 03:47:41.000000000 +0000 @@ -12,7 +12,7 @@ .\" Dinkumware C library reference http://www.dinkumware.com/ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" -.TH WCPNCPY 3 2015-03-02 "GNU" "Linux Programmer's Manual" +.TH WCPNCPY 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME wcpncpy \- copy a fixed-size string of wide characters, returning a pointer to its end @@ -34,7 +34,7 @@ .RS 4 .TP 4 Since glibc 2.10: -_XOPEN_SOURCE\ >=\ 700 || _POSIX_C_SOURCE\ >=\ 200809L +_POSIX_C_SOURCE\ >=\ 200809L .TP Before glibc 2.10: _GNU_SOURCE @@ -108,11 +108,11 @@ .BR stpncpy (3), .BR wcsncpy (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/wcrtomb.3 manpages-4.05/man3/wcrtomb.3 --- manpages-4.04/man3/wcrtomb.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/wcrtomb.3 2016-03-15 03:47:41.000000000 +0000 @@ -136,11 +136,11 @@ .BR mbsinit (3), .BR wcsrtombs (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/wcscasecmp.3 manpages-4.05/man3/wcscasecmp.3 --- manpages-4.04/man3/wcscasecmp.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/wcscasecmp.3 2016-03-15 03:47:41.000000000 +0000 @@ -12,7 +12,7 @@ .\" Dinkumware C library reference http://www.dinkumware.com/ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" -.TH WCSCASECMP 3 2015-03-02 "GNU" "Linux Programmer's Manual" +.TH WCSCASECMP 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME wcscasecmp \- compare two wide-character strings, ignoring case .SH SYNOPSIS @@ -33,7 +33,7 @@ .RS 4 .TP 4 Since glibc 2.10: -_XOPEN_SOURCE\ >=\ 700 || _POSIX_C_SOURCE\ >=\ 200809L +_POSIX_C_SOURCE\ >=\ 200809L .TP Before glibc 2.10: _GNU_SOURCE @@ -107,11 +107,11 @@ .BR strcasecmp (3), .BR wcscmp (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/wcscat.3 manpages-4.05/man3/wcscat.3 --- manpages-4.04/man3/wcscat.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/wcscat.3 2016-03-15 03:47:41.000000000 +0000 @@ -65,11 +65,11 @@ .BR wcscpy (3), .BR wcsncat (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/wcschr.3 manpages-4.05/man3/wcschr.3 --- manpages-4.04/man3/wcschr.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/wcschr.3 2016-03-15 03:47:41.000000000 +0000 @@ -65,11 +65,11 @@ .BR wcsstr (3), .BR wmemchr (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/wcscmp.3 manpages-4.05/man3/wcscmp.3 --- manpages-4.04/man3/wcscmp.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/wcscmp.3 2016-03-15 03:47:41.000000000 +0000 @@ -75,11 +75,11 @@ .BR wcscasecmp (3), .BR wmemcmp (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/wcscpy.3 manpages-4.05/man3/wcscpy.3 --- manpages-4.04/man3/wcscpy.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/wcscpy.3 2016-03-15 03:47:41.000000000 +0000 @@ -67,11 +67,11 @@ .BR wcsdup (3), .BR wmemcpy (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/wcscspn.3 manpages-4.05/man3/wcscspn.3 --- manpages-4.04/man3/wcscspn.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/wcscspn.3 2016-03-15 03:47:41.000000000 +0000 @@ -77,11 +77,11 @@ .BR wcspbrk (3), .BR wcsspn (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/wcsdup.3 manpages-4.05/man3/wcsdup.3 --- manpages-4.04/man3/wcsdup.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/wcsdup.3 2016-03-15 03:47:41.000000000 +0000 @@ -12,7 +12,7 @@ .\" Dinkumware C library reference http://www.dinkumware.com/ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" -.TH WCSDUP 3 2015-03-02 "GNU" "Linux Programmer's Manual" +.TH WCSDUP 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME wcsdup \- duplicate a wide-character string .SH SYNOPSIS @@ -33,7 +33,7 @@ .RS 4 .TP 4 Since glibc 2.10: -_XOPEN_SOURCE\ >=\ 700 || _POSIX_C_SOURCE\ >=\ 200809L +_POSIX_C_SOURCE\ >=\ 200809L .TP Before glibc 2.10: _GNU_SOURCE @@ -89,11 +89,11 @@ .BR strdup (3), .BR wcscpy (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/wcslen.3 manpages-4.05/man3/wcslen.3 --- manpages-4.04/man3/wcslen.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/wcslen.3 2016-03-15 03:47:41.000000000 +0000 @@ -56,11 +56,11 @@ .SH SEE ALSO .BR strlen (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/wcsncasecmp.3 manpages-4.05/man3/wcsncasecmp.3 --- manpages-4.04/man3/wcsncasecmp.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/wcsncasecmp.3 2016-03-15 03:47:41.000000000 +0000 @@ -12,7 +12,7 @@ .\" Dinkumware C library reference http://www.dinkumware.com/ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" -.TH WCSNCASECMP 3 2015-03-02 "GNU" "Linux Programmer's Manual" +.TH WCSNCASECMP 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME wcsncasecmp \- compare two fixed-size wide-character strings, ignoring case .SH SYNOPSIS @@ -33,7 +33,7 @@ .RS 4 .TP 4 Since glibc 2.10: -_XOPEN_SOURCE\ >=\ 700 || _POSIX_C_SOURCE\ >=\ 200809L +_POSIX_C_SOURCE\ >=\ 200809L .TP Before glibc 2.10: _GNU_SOURCE @@ -112,11 +112,11 @@ .BR strncasecmp (3), .BR wcsncmp (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/wcsncat.3 manpages-4.05/man3/wcsncat.3 --- manpages-4.04/man3/wcsncat.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/wcsncat.3 2016-03-15 03:47:41.000000000 +0000 @@ -66,11 +66,11 @@ .BR strncat (3), .BR wcscat (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/wcsncmp.3 manpages-4.05/man3/wcsncmp.3 --- manpages-4.04/man3/wcsncmp.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/wcsncmp.3 2016-03-15 03:47:41.000000000 +0000 @@ -88,11 +88,11 @@ .BR strncmp (3), .BR wcsncasecmp (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/wcsncpy.3 manpages-4.05/man3/wcsncpy.3 --- manpages-4.04/man3/wcsncpy.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/wcsncpy.3 2016-03-15 03:47:41.000000000 +0000 @@ -83,11 +83,11 @@ .SH SEE ALSO .BR strncpy (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/wcsnlen.3 manpages-4.05/man3/wcsnlen.3 --- manpages-4.04/man3/wcsnlen.3 2015-12-29 12:51:48.000000000 +0000 +++ manpages-4.05/man3/wcsnlen.3 2016-03-15 03:47:41.000000000 +0000 @@ -12,7 +12,7 @@ .\" Dinkumware C library reference http://www.dinkumware.com/ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" -.TH WCSNLEN 3 2015-03-02 "GNU" "Linux Programmer's Manual" +.TH WCSNLEN 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME wcsnlen \- determine the length of a fixed-size wide-character string .SH SYNOPSIS @@ -33,7 +33,7 @@ .RS 4 .TP 4 Since glibc 2.10: -_XOPEN_SOURCE\ >=\ 700 || _POSIX_C_SOURCE\ >=\ 200809L +_POSIX_C_SOURCE\ >=\ 200809L .TP Before glibc 2.10: _GNU_SOURCE @@ -97,11 +97,11 @@ .BR strnlen (3), .BR wcslen (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/wcsnrtombs.3 manpages-4.05/man3/wcsnrtombs.3 --- manpages-4.04/man3/wcsnrtombs.3 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man3/wcsnrtombs.3 2016-03-15 03:47:41.000000000 +0000 @@ -12,7 +12,7 @@ .\" Dinkumware C library reference http://www.dinkumware.com/ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" -.TH WCSNRTOMBS 3 2015-04-19 "GNU" "Linux Programmer's Manual" +.TH WCSNRTOMBS 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME wcsnrtombs \- convert a wide-character string to a multibyte string .SH SYNOPSIS @@ -34,7 +34,7 @@ .RS 4 .TP 4 Since glibc 2.10: -_XOPEN_SOURCE\ >=\ 700 || _POSIX_C_SOURCE\ >=\ 200809L +_POSIX_C_SOURCE\ >=\ 200809L .TP Before glibc 2.10: _GNU_SOURCE @@ -188,11 +188,11 @@ .BR mbsinit (3), .BR wcsrtombs (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/wcspbrk.3 manpages-4.05/man3/wcspbrk.3 --- manpages-4.04/man3/wcspbrk.3 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man3/wcspbrk.3 2016-03-15 03:47:41.000000000 +0000 @@ -65,11 +65,11 @@ .BR wcschr (3), .BR wcscspn (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/wcsrchr.3 manpages-4.05/man3/wcsrchr.3 --- manpages-4.04/man3/wcsrchr.3 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man3/wcsrchr.3 2016-03-15 03:47:41.000000000 +0000 @@ -62,11 +62,11 @@ .BR strrchr (3), .BR wcschr (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/wcsrtombs.3 manpages-4.05/man3/wcsrtombs.3 --- manpages-4.04/man3/wcsrtombs.3 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man3/wcsrtombs.3 2016-03-15 03:47:41.000000000 +0000 @@ -156,11 +156,11 @@ .BR wcsnrtombs (3), .BR wcstombs (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/wcsspn.3 manpages-4.05/man3/wcsspn.3 --- manpages-4.04/man3/wcsspn.3 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man3/wcsspn.3 2016-03-15 03:47:41.000000000 +0000 @@ -75,11 +75,11 @@ .BR strspn (3), .BR wcscspn (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/wcsstr.3 manpages-4.05/man3/wcsstr.3 --- manpages-4.04/man3/wcsstr.3 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man3/wcsstr.3 2016-03-15 03:47:41.000000000 +0000 @@ -71,11 +71,11 @@ .BR strstr (3), .BR wcschr (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/wcstoimax.3 manpages-4.05/man3/wcstoimax.3 --- manpages-4.04/man3/wcstoimax.3 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man3/wcstoimax.3 2016-03-15 03:47:41.000000000 +0000 @@ -70,11 +70,11 @@ .BR wcstol (3), .BR wcstoul (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/wcstok.3 manpages-4.05/man3/wcstok.3 --- manpages-4.04/man3/wcstok.3 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man3/wcstok.3 2016-03-15 03:47:41.000000000 +0000 @@ -112,11 +112,11 @@ .BR strtok (3), .BR wcschr (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/wcstombs.3 manpages-4.05/man3/wcstombs.3 --- manpages-4.04/man3/wcstombs.3 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man3/wcstombs.3 2016-03-15 03:47:41.000000000 +0000 @@ -120,11 +120,11 @@ .BR wcsrtombs (3) .BR wctom (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/wcswidth.3 manpages-4.05/man3/wcswidth.3 --- manpages-4.04/man3/wcswidth.3 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man3/wcswidth.3 2016-03-15 03:47:41.000000000 +0000 @@ -69,11 +69,11 @@ .BR iswprint (3), .BR wcwidth (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/wctob.3 manpages-4.05/man3/wctob.3 --- manpages-4.04/man3/wctob.3 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man3/wctob.3 2016-03-15 03:47:41.000000000 +0000 @@ -83,11 +83,11 @@ .BR wcrtomb (3), .BR wctomb (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/wctomb.3 manpages-4.05/man3/wctomb.3 --- manpages-4.04/man3/wctomb.3 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man3/wctomb.3 2016-03-15 03:47:41.000000000 +0000 @@ -115,11 +115,11 @@ .BR wcrtomb (3), .BR wcstombs (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/wctrans.3 manpages-4.05/man3/wctrans.3 --- manpages-4.04/man3/wctrans.3 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man3/wctrans.3 2016-03-15 03:47:41.000000000 +0000 @@ -83,11 +83,11 @@ .SH SEE ALSO .BR towctrans (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/wctype.3 manpages-4.05/man3/wctype.3 --- manpages-4.04/man3/wctype.3 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man3/wctype.3 2016-03-15 03:47:41.000000000 +0000 @@ -95,11 +95,11 @@ .SH SEE ALSO .BR iswctype (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/wcwidth.3 manpages-4.05/man3/wcwidth.3 --- manpages-4.04/man3/wcwidth.3 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man3/wcwidth.3 2016-03-15 03:47:41.000000000 +0000 @@ -73,11 +73,11 @@ .BR iswprint (3), .BR wcswidth (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/wmemchr.3 manpages-4.05/man3/wmemchr.3 --- manpages-4.04/man3/wmemchr.3 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man3/wmemchr.3 2016-03-15 03:47:41.000000000 +0000 @@ -66,11 +66,11 @@ .BR memchr (3), .BR wcschr (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/wmemcmp.3 manpages-4.05/man3/wmemcmp.3 --- manpages-4.04/man3/wmemcmp.3 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man3/wmemcmp.3 2016-03-15 03:47:41.000000000 +0000 @@ -85,11 +85,11 @@ .BR memcmp (3), .BR wcscmp (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/wmemcpy.3 manpages-4.05/man3/wmemcpy.3 --- manpages-4.04/man3/wmemcpy.3 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man3/wmemcpy.3 2016-03-15 03:47:41.000000000 +0000 @@ -69,11 +69,11 @@ .BR wmemmove (3), .BR wmempcpy (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/wmemmove.3 manpages-4.05/man3/wmemmove.3 --- manpages-4.04/man3/wmemmove.3 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man3/wmemmove.3 2016-03-15 03:47:41.000000000 +0000 @@ -65,11 +65,11 @@ .BR memmove (3), .BR wmemcpy (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/wmemset.3 manpages-4.05/man3/wmemset.3 --- manpages-4.04/man3/wmemset.3 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man3/wmemset.3 2016-03-15 03:47:41.000000000 +0000 @@ -57,11 +57,11 @@ .SH SEE ALSO .BR memset (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/wordexp.3 manpages-4.05/man3/wordexp.3 --- manpages-4.04/man3/wordexp.3 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man3/wordexp.3 2016-03-15 03:47:41.000000000 +0000 @@ -248,11 +248,11 @@ .BR fnmatch (3), .BR glob (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/wprintf.3 manpages-4.05/man3/wprintf.3 --- manpages-4.04/man3/wprintf.3 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man3/wprintf.3 2016-03-15 03:47:41.000000000 +0000 @@ -13,7 +13,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH WPRINTF 3 2015-08-08 "GNU" "Linux Programmer's Manual" +.TH WPRINTF 3 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME wprintf, fwprintf, swprintf, vwprintf, vfwprintf, vswprintf \- formatted wide-character output conversion @@ -49,10 +49,7 @@ .\" .BR vswprintf (): _XOPEN_SOURCE\ >=\ 500 || _ISOC99_SOURCE || .br -_POSIX_C_SOURCE\ >=\ 200112L; -.br -or -.I cc\ -std=c99 +_POSIX_C_SOURCE\ >=\ 200112L .RE .ad .SH DESCRIPTION @@ -276,11 +273,11 @@ .BR snprintf (3) .\" .BR wscanf (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/xcrypt.3 manpages-4.05/man3/xcrypt.3 --- manpages-4.04/man3/xcrypt.3 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man3/xcrypt.3 2016-03-15 03:47:41.000000000 +0000 @@ -86,11 +86,11 @@ .SH SEE ALSO .BR cbc_crypt (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/xdr.3 manpages-4.05/man3/xdr.3 --- manpages-4.04/man3/xdr.3 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man3/xdr.3 2016-03-15 03:47:41.000000000 +0000 @@ -621,11 +621,11 @@ USC-ISI. .RE .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man3/y0.3 manpages-4.05/man3/y0.3 --- manpages-4.04/man3/y0.3 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man3/y0.3 2016-03-15 03:47:41.000000000 +0000 @@ -33,7 +33,7 @@ .\" Modified 2004-11-12 as per suggestion by Fabian Kreutz/AEB .\" 2008-07-24, mtk, created this page, based on material from j0.3. .\" -.TH Y0 3 2015-04-19 "" "Linux Programmer's Manual" +.TH Y0 3 2016-03-15 "" "Linux Programmer's Manual" .SH NAME y0, y0f, y0l, y1, y1f, y1l, yn, ynf, ynl \- Bessel functions of the second kind @@ -72,7 +72,9 @@ .BR y1 (), .BR yn (): .RS 4 -_SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE +_XOPEN_SOURCE + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _SVID_SOURCE || _BSD_SOURCE .RE .br .BR y0f (), @@ -82,8 +84,10 @@ .BR ynf (), .BR ynl (): .RS 4 -_SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE\ >=\ 600 -.\" Also seems to work: -std=c99 -D_XOPEN_SOURCE +_XOPEN_SOURCE \ >=\ 600 + || (_ISOC99_SOURCE && _XOPEN_SOURCE) + || /* Since glibc 2.19: */ _DEFAULT_SOURCE + || /* Glibc versions <= 2.19: */ _SVID_SOURCE || _BSD_SOURCE .RE .ad b .SH DESCRIPTION @@ -277,11 +281,11 @@ .SH SEE ALSO .BR j0 (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man4/cciss.4 manpages-4.05/man4/cciss.4 --- manpages-4.04/man4/cciss.4 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man4/cciss.4 2016-03-15 03:47:41.000000000 +0000 @@ -368,11 +368,11 @@ .\" Charles White, Francis Wiran .\" and probably some other people. .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man4/console.4 manpages-4.05/man4/console.4 --- manpages-4.04/man4/console.4 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man4/console.4 2016-03-15 03:47:41.000000000 +0000 @@ -110,11 +110,11 @@ .BR resizecons (8), .BR setfont (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man4/console_codes.4 manpages-4.05/man4/console_codes.4 --- manpages-4.04/man4/console_codes.4 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man4/console_codes.4 2016-03-15 03:47:41.000000000 +0000 @@ -653,11 +653,11 @@ .BR console_ioctl (4), .BR charsets (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man4/console_ioctl.4 manpages-4.05/man4/console_ioctl.4 --- manpages-4.04/man4/console_ioctl.4 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man4/console_ioctl.4 2016-03-15 03:47:41.000000000 +0000 @@ -124,7 +124,6 @@ Set text/graphics mode. .I argp is one of these: - .TS l l. KD_TEXT 0x00 @@ -366,7 +365,6 @@ .I long which is set to one of these: - .TS l l. K_RAW 0x00 @@ -389,7 +387,6 @@ .I long which is set to one of these: - .TS l l l. K_METABIT 0x03 set high order bit @@ -571,7 +568,6 @@ which is set to the mode of the active vt. .I mode is set to one of these values: - .TS l l. VT_AUTO auto vt switching @@ -871,11 +867,11 @@ .IR /usr/include/linux/kd.h , .I /usr/include/linux/vt.h .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man4/cpuid.4 manpages-4.05/man4/cpuid.4 --- manpages-4.04/man4/cpuid.4 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man4/cpuid.4 2016-03-15 03:47:41.000000000 +0000 @@ -94,11 +94,11 @@ Intel Corporation, Intel Processor Identification and the CPUID Instruction, Application note 485. .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man4/dsp56k.4 manpages-4.05/man4/dsp56k.4 --- manpages-4.04/man4/dsp56k.4 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man4/dsp56k.4 2016-03-15 03:47:41.000000000 +0000 @@ -119,11 +119,11 @@ .UE , DSP56000/DSP56001 Digital Signal Processor User's Manual .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man4/fd.4 manpages-4.05/man4/fd.4 --- manpages-4.04/man4/fd.4 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man4/fd.4 2016-03-15 03:47:41.000000000 +0000 @@ -220,11 +220,11 @@ .BR mount (8), .BR setfdprm (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man4/full.4 manpages-4.05/man4/full.4 --- manpages-4.04/man4/full.4 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man4/full.4 2016-03-15 03:47:41.000000000 +0000 @@ -63,11 +63,11 @@ .BR null (4), .BR zero (4) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man4/hd.4 manpages-4.05/man4/hd.4 --- manpages-4.04/man4/hd.4 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man4/hd.4 2016-03-15 03:47:41.000000000 +0000 @@ -108,11 +108,11 @@ .BR sd (4), .BR mount (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man4/hpsa.4 manpages-4.05/man4/hpsa.4 --- manpages-4.04/man4/hpsa.4 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man4/hpsa.4 2016-03-15 03:47:41.000000000 +0000 @@ -195,11 +195,11 @@ .\" Don Brace, Steve Cameron, Tom Lawler, Mike Miller, Scott Teel .\" and probably some other people. .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man4/initrd.4 manpages-4.05/man4/initrd.4 --- manpages-4.04/man4/initrd.4 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man4/initrd.4 2016-03-15 03:47:41.000000000 +0000 @@ -482,11 +482,11 @@ in the Linux kernel source tree, the LILO documentation, the LOADLIN documentation, the SYSLINUX documentation .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man4/intro.4 manpages-4.05/man4/intro.4 --- manpages-4.04/man4/intro.4 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man4/intro.4 2016-03-15 03:47:41.000000000 +0000 @@ -38,11 +38,11 @@ .SH SEE ALSO .BR standards (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man4/lirc.4 manpages-4.05/man4/lirc.4 --- manpages-4.04/man4/lirc.4 1970-01-01 00:00:00.000000000 +0000 +++ manpages-4.05/man4/lirc.4 2016-03-15 03:47:41.000000000 +0000 @@ -0,0 +1,467 @@ +.TH LIRC 4 "Aug 2015" "Linux" "Linux Programmer's Manual" + + +.\" Copyright (c) 2015, Alec Leamas +.\" +.\" %%%LICENSE_START(GPLv2+_DOC_FULL) +.\" This is free documentation; you can redistribute it and/or +.\" modify it under the terms of the GNU General Public License as +.\" published by the Free Software Foundation; either version 2 of +.\" the License, or (at your option) any later version. +.\" +.\" The GNU General Public License's references to "object code" +.\" and "executables" are to be interpreted as the output of any +.\" document formatting or typesetting system, including +.\" intermediate and printed output. +.\" +.\" This manual is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public +.\" License along with this manual; if not, see +.\" . +.\" %%%LICENSE_END +.SH NAME +lirc \- lirc devices +.SH DESCRIPTION +.P +The +.B /dev/lirc* +character devices provide a low-level +bi-directional interface to infra-red (IR) remotes. +When receiving data, the driver works in two different modes depending +on the underlying hardware. +.P +Some hardware (typically TV-cards) decodes the IR signal internally +and just provides decoded button presses as integer values. +Drivers for this kind of hardware work in +.BR LIRC_MODE_LIRCCODE +mode. +Such hardware usually does not support sending IR signals. +Furthermore, it usually only works with a specific remote which is +bundled with, for example, a TV-card. +.P +Other hardware provides a stream of pulse/space durations. +Such drivers work in +.BR LIRC_MODE_MODE2 +mode. +Sometimes, this kind of hardware also supports +sending IR data. +Such hardware can be used with (almost) any kind of remote. +.P +The \fBLIRC_GET_REC_MODE\fR ioctl (see below) allows probing for the +mode. +.\" +.SS Reading input with the LIRC_MODE_MODE2 drivers +.P +In the \fBLIRC_MODE_MODE2 mode\fR, the data returned by +.BR read (2) +provides 32-bit values representing a space or a pulse duration, by +convention typed as +.IR lirc_t . +The time of the duration (microseconds) is encoded in the lower 24 bits. +The upper 8 bit reflects the type of package: +.TP 4 +.BR LIRC_MODE2_SPACE . +Value reflects a space duration (microseconds). +.TP 4 +.BR LIRC_MODE2_PULSE . +Value reflects a pulse duration (microseconds). +.TP 4 +.BR LIRC_MODE2_FREQUENCY . +Value reflects a frequency (Hz); see the +.B LIRC_SET_MEASURE_CARRIER_MODE +ioctl. +.TP 4 +.BR LIRC_MODE2_TIMEOUT . +The package reflects a timeout; see the +.B LIRC_SET_REC_TIMEOUT_REPORTS +ioctl. +.\" +.SS Reading input with the +.B LIRC_MODE_LIRCCODE +drivers +.P +In the \fBLIRC_MODE_LIRCCODE\fR +mode, the data returned by +.BR read (2) +reflects decoded button presses. +The length of each packet can be retrieved using +the \fBLIRC_GET_LENGTH\fR ioctl. +Reads must be done in blocks matching +the bit count returned by the \fBLIRC_GET_LENGTH\fR ioctl, rounded +up so it matches full bytes. +.\" +.SS Sending data +.P +When sending data, only the \fBLIRC_MODE_PULSE\fR +mode is supported. +The data written to the character device using +.BR write (2) +is a pulse/space sequence of integer values. +Pulses and spaces are only marked implicitly by their position. +The data must start and end with a pulse, thus it must always include +an odd number of samples. +The +.BR write (2) +function blocks until the data has been transmitted by the +hardware. +If more data is provided than the hardware can send, the +.BR write (2) +call fails with the error +.BR EINVAL +.\" +.SH SUPPORTED IOCTL COMMANDS +.P +.nf +#include /* But see BUGS */ +int ioctl(int fd, int cmd, ...); +.fi +.P +The following ioctls can be used to probe or change specific lirc +hardware settings. +Many require a third argument, usually an +.IR int . +referred to below as +.IR val . +.P +In general, each driver should have a default set of settings. +The driver implementation is expected to re-apply the default settings +when the device is closed by userspace, so that every application +opening the device can rely on working with the default settings +initially. +.\" +.SS Always Supported Commands +.P +\fI/dev/lirc*\fR devices always support the following commands: +.TP 4 +.BR LIRC_GET_FEATURES " (\fIvoid\fP)" +Returns a bit mask of combined features bits; see FEATURES. +Some drivers have dynamic features which are not updated until after an +.I init() +command. +.TP +.BR LIRC_GET_REC_MODE +Return the receive mode, which will be one of: +.RS 4 +.TP +.BR LIRC_MODE_MODE2 " (\fIvoid\fP)" +The driver returns a sequence of pulse/space durations. +.TP +.BR LIRC_MODE_LIRCCODE +The driver returns integer values, each of which represents a decoded +button press. +.RE +.P +If a device returns an error code for +.BR LIRC_GET_REC_MODE , +it is safe to assume it is not a lirc device. +.\" +.SS Optional Commands +.P +Some lirc devices support commands listed below. +Unless otherwise stated, these fail with the error \fBENOIOCTLCMD\fR +or with the error \fBENOSYS\fR if the operation +isn't supported, or with the error \fBEINVAL\fR if the operation +failed. +.TP +.BR LIRC_SET_REC_MODE " (\fIint\fP)" +Set the receive mode. +.IR val +is either +.BR LIRC_MODE_LIRCCODE +or +.BR LIRC_MODE_MODE2 . +.TP +.BR LIRC_GET_LENGTH " (\fIvoid\fP)" +Return the length of the returned codes for +.BR LIRC_MODE_LIRCCODE -type +drivers, otherwise fail with the error +.BR ENOIOCTLCMD . +.TP +.BR LIRC_GET_SEND_MODE " (\fIvoid\fP)" +Return the send mode. +Currently, only +.BR LIRC_MODE_PULSE +is supported. +.TP +.BR LIRC_SET_SEND_MODE " (\fIint\fP)" +Set the send mode. +Currently serves no purpose since only +.BR LIRC_MODE_PULSE +is supported. +.TP +.BR LIRC_SET_SEND_CARRIER " (\fIint\fP)" +Set the modulation frequency. +The argument is the frequency (Hz). +.TP +.BR SET_SEND_DUTY_CYCLE " (\fIint\fP)" +Set the carrier duty cycle. +.I val +is a number in the range [0,100] which +describes the pulse width as a percentage of the total cycle. +Currently, no special meaning is defined for 0 or 100, but the values +are reserved for future use. +.TP +.BR LIRC_GET_MIN_TIMEOUT " (\fIvoid\fP)", " "\ +LIRC_GET_MAX_TIMEOUT " (\fIvoid\fP)" +Some devices have internal timers that can be used to detect when +there's no IR activity for a long time. +This can help +.BR lircd (8) +in detecting that an IR signal is finished and can speed up the +decoding process. +These operations +return integer values with the minimum/maximum timeout that can be +set (microseconds). +Some devices have a fixed timeout. +For such drivers, +.BR LIRC_GET_MIN_TIMEOUT +and +.BR LIRC_GET_MAX_TIMEOUT +will return the same value. +.TP +.BR LIRC_SET_REC_TIMEOUT " (\fIint\fP)" +Set the integer value for IR inactivity timeout (microseconds). +To be accepted, the value must be within the limits defined by +.BR LIRC_GET_MIN_TIMEOUT +and +.BR LIRC_GET_MAX_TIMEOUT . +A value of 0 (if supported by the hardware) disables all hardware +timeouts and data should be reported as soon as possible. +If the exact value cannot be set, then the next possible value +.I greater +than the given value should be set. +.TP +.BR LIRC_SET_REC_TIMEOUT_REPORTS " (\fIint\fP)" +Enable +.RI ( val +is 1) or disable +.RI ( val +is 0) timeout packages in +.BR LIRC_MODE_MODE2 . +By default, timeout reports should be turned off. +.TP +.BR LIRC_SET_REC_CARRIER " (\fIint\fP)" +Set the receive carrier frequency (Hz). +.TP +.BR LIRC_SET_REC_CARRIER_RANGE " (\fIint\fP)" +After opening device, the first use of this operation +sets the lower bound of the carrier range, +and the second use sets the upper bound (Hz). +.TP +.BR LIRC_SET_MEASURE_CARRIER_MODE " (\fIint\fP)" +Enable +.RI ( val +is 1) or disable +.RI ( val +is 0) the measure mode. +If enabled, from the next key press on, the driver will send +.BR LIRC_MODE2_FREQUENCY +packets. +By default this should be turned off. +.TP +.BR LIRC_GET_REC_RESOLUTION " (\fIvoid\fP)" +Return the driver resolution (microseconds). +.TP +.BR LIRC_GET_MIN_FILTER_PULSE " (\fIvoid\fP)", " " \ +LIRC_GET_MAX_FILTER_PULSE " (\fIvoid\fP)" +Some devices are able to filter out spikes in the incoming signal +using given filter rules. +These ioctls return the hardware capabilities that describe the bounds +of the possible filters. +Filter settings depend on the IR protocols that are expected. +.BR lircd (8) +derives the settings from all protocols definitions found in its +.BR lircd.conf (5) +config file. +.TP +.BR LIRC_GET_MIN_FILTER_SPACE " (\fIvoid\fP)", " " \ +LIRC_GET_MAX_FILTER_SPACE " (\fIvoid\fP)" +See +.BR LIRC_GET_MIN_FILTER_PULSE . +.TP +.BR LIRC_SET_REC_FILTER " (\fIint\fP)" +Pulses/spaces shorter than this (microseconds) are filtered out by +hardware. +.TP +.BR LIRC_SET_REC_FILTER_PULSE " (\fIint\fP)", " " \ +LIRC_SET_REC_FILTER_SPACE " (\fIint\fP)" +Pulses/spaces shorter than this (microseconds) are filtered out by +hardware. +If filters cannot be set independently for pulse/space, the +corresponding ioctls must return an error and +.BR LIRC_SET_REC_FILTER +should be used instead. +.TP +.BR LIRC_SET_TRANSMITTER_MASK +Enable the set of transmitters specified in +.IR val , +which contains a bit mask where each enabled transmitter is a 1. +The first transmitter is encoded by the least significant bit, and so on. +When an invalid bit mask is given, for example a bit is set even +though the device does not have so many transmitters, +this operation returns the +number of available transmitters and does nothing otherwise. +.TP +.BR LIRC_SET_WIDEBAND_RECEIVER " (\fIint\fP)" +Some devices are equipped with a special wide band receiver which is +intended to be used to learn the output of an existing remote. +This ioctl can be used to enable +.RI ( val +equals 1) or disable +.RI ( val +equals 0) this functionality. +This might be useful for devices that otherwise have narrow band +receivers that prevent them to be used with certain remotes. +Wide band receivers may also be more precise. +On the other hand its disadvantage usually is reduced range of +reception. +.IP +Note: wide band receiver may be implicitly enabled if you enable +carrier reports. +In that case, it will be disabled as soon as you disable carrier reports. +Trying to disable a wide band receiver while carrier reports are active +will do nothing. +.TP +.BR LIRC_SETUP_START " (\fIvoid\fP), " LIRC_SETUP_END " (\fIvoid\fP)" +Setting of several driver parameters can be optimized by bracketing +the actual ioctl calls +.BR LIRC_SETUP_START +and +.BR LIRC_SETUP_END . +When a driver receives a +.BR LIRC_SETUP_START +ioctl, it can choose to not commit further setting changes to the +hardware until a +.BR LIRC_SETUP_END +is received. +But this is open to the driver implementation and every driver +must also handle parameter changes which are not encapsulated by +.BR LIRC_SETUP_START +and +.BR LIRC_SETUP_END . +Drivers can also choose to ignore these ioctls. +.TP +.BR LIRC_NOTIFY_DECODE " (\fIvoid\fP)" +This ioctl is called by +.BR lircd (8) +whenever a successful decoding of an incoming IR signal is possible. +This can be used by supporting hardware to give visual user +feedback, for example by flashing an LED. +.\" +.SH FEATURES +.P +The features returned by +The +.BR LIRC_GET_FEATURES +ioctl returns a bit mask describing features of the driver. +The following bits may be returned in the mask: +.TP +.BR LIRC_CAN_REC_RAW +The driver is capable of receiving using +.BR LIRC_MODE_RAW . +.TP +.BR LIRC_CAN_REC_PULSE +The driver is capable of receiving using +.BR LIRC_MODE_PULSE . +.TP +.BR LIRC_CAN_REC_MODE2 +The driver is capable of receiving using +.BR LIRC_MODE_MODE2 . +.TP +.BR LIRC_CAN_REC_LIRCCODE +The driver is capable of receiving using +.BR LIRC_MODE_LIRCCODE . +.TP +.BR LIRC_CAN_SET_SEND_CARRIER +The driver supports changing the modulation frequency using +.BR LIRC_SET_SEND_CARRIER . +.TP +.BR LIRC_CAN_SET_SEND_DUTY_CYCLE +The driver supports changing the duty cycle using +.BR LIRC_SET_SEND_DUTY_CYCLE . +.TP +.BR LIRC_CAN_SET_TRANSMITTER_MASK +The driver supports changing the active transmitter(s) using +.BR LIRC_SET_TRANSMITTER_MASK . +.TP +.BR LIRC_CAN_SET_REC_CARRIER +The driver supports setting the receive carrier frequency using +.BR LIRC_SET_REC_CARRIER . +.TP +.BR LIRC_CAN_SET_REC_DUTY_CYCLE_RANGE +The driver supports +.BR LIRC_SET_REC_DUTY_CYCLE_RANGE . +.TP +.BR LIRC_CAN_SET_REC_CARRIER_RANGE +The driver supports +.BR LIRC_SET_REC_CARRIER_RANGE . +.TP +.BR LIRC_CAN_GET_REC_RESOLUTION +The driver supports +.BR LIRC_GET_REC_RESOLUTION . +.TP +.BR LIRC_CAN_SET_REC_TIMEOUT +The driver supports +.BR LIRC_SET_REC_TIMEOUT . +.TP +.BR LIRC_CAN_SET_REC_FILTER +The driver supports +.BR LIRC_SET_REC_FILTER . +.TP +.BR LIRC_CAN_MEASURE_CARRIER +The driver supports measuring of the modulation frequency using +.BR LIRC_SET_MEASURE_CARRIER_MODE . +.TP +.BR LIRC_CAN_USE_WIDEBAND_RECEIVER +The driver supports learning mode using +.BR LIRC_SET_WIDEBAND_RECEIVER . +.TP +.BR LIRC_CAN_NOTIFY_DECODE +The driver supports +.BR LIRC_NOTIFY_DECODE . +.TP +.BR LIRC_CAN_SEND_RAW +The driver supports sending using +.BR LIRC_MODE_RAW . +.TP +.BR LIRC_CAN_SEND_PULSE +The driver supports sending using +.BR LIRC_MODE_PULSE . +.TP +.BR LIRC_CAN_SEND_MODE2 +The driver supports sending using +.BR LIRC_MODE_MODE2 . +.TP +.BR LIRC_CAN_SEND_LIRCCODE +The driver supports sending. +(This is uncommon, since +.BR LIRCCODE +drivers reflect hardware like TV-cards which usually dos not support +sending.) +.\" +.SH BUGS +Using these devices requires the kernel source header file +.IR lirc.h . +This file is not (yet) publicly exported by kernel headers. +.\" FIXME . https://bugzilla.kernel.org/show_bug.cgi?id=3D75751. +For the time being, the file is bundled in the lirc package; see +.UR http://www.lirc.org +.UE . +.\" +.SH SEE ALSO +.BR lircd (8) +.P +https://www.kernel.org/doc/htmldocs/media_api/lirc_dev.html +.SH COLOPHON +This page is part of release 4.05 of the Linux +.I man-pages +project. +A description of the project, +information about reporting bugs, +and the latest version of this page, +can be found at +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man4/loop.4 manpages-4.05/man4/loop.4 --- manpages-4.04/man4/loop.4 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man4/loop.4 2016-03-15 03:47:41.000000000 +0000 @@ -238,7 +238,6 @@ .SS Program source \& .nf - #include #include #include @@ -293,11 +292,11 @@ .BR losetup (8), .BR mount (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man4/lp.4 manpages-4.05/man4/lp.4 --- manpages-4.04/man4/lp.4 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man4/lp.4 2016-03-15 03:47:41.000000000 +0000 @@ -139,11 +139,11 @@ .BR lpcntl (8), .BR tunelp (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man4/mem.4 manpages-4.05/man4/mem.4 --- manpages-4.04/man4/mem.4 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man4/mem.4 2016-03-15 03:47:41.000000000 +0000 @@ -96,11 +96,11 @@ .BR mknod (1), .BR ioperm (2) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man4/mouse.4 manpages-4.05/man4/mouse.4 --- manpages-4.04/man4/mouse.4 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man4/mouse.4 2016-03-15 03:47:41.000000000 +0000 @@ -185,11 +185,11 @@ .BR ttyS (4), .BR gpm (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man4/msr.4 manpages-4.05/man4/msr.4 --- manpages-4.04/man4/msr.4 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man4/msr.4 2016-03-15 03:47:41.000000000 +0000 @@ -57,11 +57,11 @@ Software Developer's Manual Volume 3B Appendix B, for an overview of the Intel CPU MSRs. .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man4/null.4 manpages-4.05/man4/null.4 --- manpages-4.04/man4/null.4 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man4/null.4 2016-03-15 03:47:41.000000000 +0000 @@ -70,11 +70,11 @@ .BR mknod (1), .BR full (4) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man4/pts.4 manpages-4.05/man4/pts.4 --- manpages-4.04/man4/pts.4 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man4/pts.4 2016-03-15 03:47:41.000000000 +0000 @@ -5,7 +5,7 @@ .\" Redistribute and revise at will. .\" %%%LICENSE_END .\" -.TH PTS 4 2002-10-09 "Linux" "Linux Programmer's Manual" +.TH PTS 4 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME ptmx, pts \- pseudoterminal master and slave .SH DESCRIPTION @@ -25,7 +25,7 @@ Each file descriptor obtained by opening .IR /dev/ptmx is an independent PTM with its own associated PTS, whose path can -be found by passing the descriptor to +be found by passing the file descriptor to .BR ptsname (3). .PP Before opening the pseudoterminal slave, you must pass the master's file @@ -37,7 +37,7 @@ Once both the pseudoterminal master and slave are open, the slave provides processes with an interface that is identical to that of a real terminal. .PP -Data written to the slave is presented on the master descriptor as input. +Data written to the slave is presented on the master file descriptor as input. Data written to the master is presented to the slave as input. .PP In practice, pseudoterminals are used for implementing terminal emulators @@ -78,11 +78,11 @@ .BR unlockpt (3), .BR pty (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man4/ram.4 manpages-4.05/man4/ram.4 --- manpages-4.04/man4/ram.4 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man4/ram.4 2016-03-15 03:47:41.000000000 +0000 @@ -45,11 +45,11 @@ .BR mknod (1), .BR mount (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man4/random.4 manpages-4.05/man4/random.4 --- manpages-4.04/man4/random.4 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man4/random.4 2016-03-15 03:47:41.000000000 +0000 @@ -332,11 +332,11 @@ .br RFC\ 1750, "Randomness Recommendations for Security" .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man4/rtc.4 manpages-4.05/man4/rtc.4 --- manpages-4.04/man4/rtc.4 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man4/rtc.4 2016-03-15 03:47:41.000000000 +0000 @@ -342,11 +342,11 @@ .I Documentation/rtc.txt in the Linux kernel source tree .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man4/sd.4 manpages-4.05/man4/sd.4 --- manpages-4.04/man4/sd.4 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man4/sd.4 2016-03-15 03:47:41.000000000 +0000 @@ -135,11 +135,11 @@ .\".SH SEE ALSO .\".BR scsi (4) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man4/sk98lin.4 manpages-4.05/man4/sk98lin.4 --- manpages-4.04/man4/sk98lin.4 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man4/sk98lin.4 2016-03-15 03:47:41.000000000 +0000 @@ -600,11 +600,11 @@ .BR insmod (8), .BR modprobe (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man4/st.4 manpages-4.05/man4/st.4 --- manpages-4.04/man4/st.4 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man4/st.4 2016-03-15 03:47:41.000000000 +0000 @@ -22,7 +22,7 @@ .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END -.TH ST 4 2010-09-04 "Linux" "Linux Programmer's Manual" +.TH ST 4 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME st \- SCSI tape device .SH SYNOPSIS @@ -941,16 +941,6 @@ The solution is to tell the software to use larger transfers (often telling it to use larger blocks). If this is not possible, direct transfers can be disabled. -.\" .SH COPYRIGHT -.\" Copyright \(co 1995 Robert K. Nichols. -.\" .br -.\" Copyright \(co 1999-2005 Kai M\(:akisara. -.\" .PP -.\" %%%LICENSE_START(VERBATIM) -.\" Permission is granted to make and distribute verbatim copies of this -.\" manual provided the copyright notice and this permission notice are -.\" preserved on all copies. -.\" Additional permissions are contained in the header of the source file. .SH SEE ALSO .BR mt (1) .PP @@ -962,11 +952,11 @@ the most recent information about the driver and its configuration possibilities .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man4/tty.4 manpages-4.05/man4/tty.4 --- manpages-4.04/man4/tty.4 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man4/tty.4 2016-03-15 03:47:41.000000000 +0000 @@ -83,11 +83,11 @@ .BR agetty (8), .BR mingetty (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man4/tty_ioctl.4 manpages-4.05/man4/tty_ioctl.4 --- manpages-4.04/man4/tty_ioctl.4 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man4/tty_ioctl.4 2016-03-15 03:47:41.000000000 +0000 @@ -5,7 +5,7 @@ .\" Distributed under GPL .\" %%%LICENSE_END .\" -.TH TTY_IOCTL 4 2015-12-05 "Linux" "Linux Programmer's Manual" +.TH TTY_IOCTL 4 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME tty_ioctl \- ioctls for terminals and serial lines .SH SYNOPSIS @@ -542,6 +542,7 @@ } .fi .SH SEE ALSO +.BR ldattach (1), .BR ioctl (2), .BR termios (3), .BR console_ioctl (4), @@ -561,11 +562,11 @@ .\" TIOCSERSETMULTI const struct serial_multiport_struct * .\" TIOCGSERIAL, TIOCSSERIAL (see above) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man4/ttyS.4 manpages-4.05/man4/ttyS.4 --- manpages-4.04/man4/ttyS.4 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man4/ttyS.4 2016-03-15 03:47:41.000000000 +0000 @@ -53,11 +53,11 @@ .BR mingetty (8), .BR setserial (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man4/vcs.4 manpages-4.05/man4/vcs.4 --- manpages-4.04/man4/vcs.4 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man4/vcs.4 2016-03-15 03:47:41.000000000 +0000 @@ -107,13 +107,12 @@ newline characters, so some processing may be required, like in - old \-w 81 /dev/vcs3 | lpr + fold \-w 81 /dev/vcs3 | lpr or (horrors) xetterm \-dump 3 \-file /proc/self/fd/1 -.LP The .I /dev/vcsa0 device is used for Braille support. @@ -176,11 +175,11 @@ .BR ttyS (4), .BR gpm (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man4/wavelan.4 manpages-4.05/man4/wavelan.4 --- manpages-4.04/man4/wavelan.4 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man4/wavelan.4 2016-03-15 03:47:41.000000000 +0000 @@ -118,7 +118,7 @@ and standard deviation of the signal level. .SS Specific notes This driver will fail to detect some -.B non-NCR/ATT&T/Lucent +.B non-NCR/AT&T/Lucent Wavelan cards. If this happens for you, you must look in the source code on how to add your card to the detection routine. @@ -143,11 +143,11 @@ .BR iwpriv (8), .BR iwspy (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man5/acct.5 manpages-4.05/man5/acct.5 --- manpages-4.04/man5/acct.5 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man5/acct.5 2016-03-15 03:47:41.000000000 +0000 @@ -177,11 +177,11 @@ .BR accton (8), .BR sa (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man5/charmap.5 manpages-4.05/man5/charmap.5 --- manpages-4.04/man5/charmap.5 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man5/charmap.5 2016-03-15 03:47:41.000000000 +0000 @@ -118,11 +118,11 @@ .BR locale (5), .BR charsets (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man5/core.5 manpages-4.05/man5/core.5 --- manpages-4.04/man5/core.5 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man5/core.5 2016-03-15 03:47:41.000000000 +0000 @@ -201,7 +201,9 @@ The default value in this file is "core". For backward compatibility, if .I /proc/sys/kernel/core_pattern -does not include "%p" and +does not include +.I %p +and .I /proc/sys/kernel/core_uses_pid (see below) is nonzero, then .PID will be appended to the core filename. @@ -353,7 +355,9 @@ .BR clone (2)) dumps core, then the process ID is always appended to the core filename, unless the process ID was already included elsewhere in the -filename via a %p specification in +filename via a +.I %p +specification in .IR /proc/sys/kernel/core_pattern . (This is primarily useful when employing the obsolete LinuxThreads implementation, @@ -463,11 +467,11 @@ .BR pthreads (7), .BR signal (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man5/dir_colors.5 manpages-4.05/man5/dir_colors.5 --- manpages-4.04/man5/dir_colors.5 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man5/dir_colors.5 2016-03-15 03:47:41.000000000 +0000 @@ -243,7 +243,6 @@ ISO 6429 color sequences are composed of sequences of numbers separated by semicolons. The most common codes are: -.sp .RS .TS l l. @@ -274,7 +273,6 @@ .PP .B ls uses the following defaults: -.sp .TS lb l l. NORMAL 0 Normal (nonfilename) text @@ -352,7 +350,6 @@ ^-notation can be used. The C-style notation includes the following characters: -.sp .RS .TS lb l. @@ -395,7 +392,6 @@ and .B RIGHTCODE definitions, which are used by ISO 6429 terminals are: -.sp .RS .TS lb l. @@ -413,11 +409,11 @@ .BR stty (1), .BR xterm (1) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man5/elf.5 manpages-4.05/man5/elf.5 --- manpages-4.04/man5/elf.5 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man5/elf.5 2016-03-15 03:47:41.000000000 +0000 @@ -32,7 +32,7 @@ .\" 2007-10-11, Mike Frysinger , various fixes .\" 2007-12-08, mtk, Converted from mdoc to man macros .\" -.TH ELF 5 2013-04-17 "Linux" "Linux Programmer's Manual" +.TH ELF 5 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME elf \- format of Executable and Linking Format (ELF) files .SH SYNOPSIS @@ -113,7 +113,7 @@ .in .PP (Note: The *BSD terminology is a bit different. -There +There, .I Elf64_Half is twice as large as @@ -161,8 +161,10 @@ .in .PP The fields have the following meanings: -.\" .Bl -tag -width "e_phentsize" -.TP 12 +.\" +.nr l1_indent 10 +.\" +.TP \n[l1_indent] .IR e_ident This array of bytes specifies how to interpret the file, independent of the processor or the file's remaining contents. @@ -172,9 +174,8 @@ and may contain values which start with the prefix .BR ELF . The following macros are defined: -.RS 12 -.\" .Bl -tag -width "EI_VERSION" \" EI_ABIVERSION -.TP 12 +.RS +.TP 9 .BR EI_MAG0 The first byte of the magic number. It must be filled with @@ -201,8 +202,7 @@ .TP .BR EI_CLASS The fifth byte identifies the architecture for this binary: -.RS 12 -.\" .Bl -tag -width "ELFCLASSNONE" -compact +.RS .TP 14 .PD 0 .BR ELFCLASSNONE @@ -217,14 +217,12 @@ This defines the 64-bit architecture. .PD .RE -.\" .El .TP .BR EI_DATA The sixth byte specifies the data encoding of the processor-specific data in the file. -Currently these encodings are supported: -.\" .Bl -tag -width "ELFDATA2LSB" -compact -.RS 12 +Currently, these encodings are supported: +.RS 9 .TP 14 .PD 0 .BR ELFDATANONE @@ -237,13 +235,12 @@ Two's complement, big-endian. .PD .RE -.\" .El .TP .PD 0 .BR EI_VERSION The seventh byte is the version number of the ELF specification: -.\" .Bl -tag -width "EV_CURRENT" -compact -.RS 12 + +.RS .TP 14 .BR EV_NONE Invalid version. @@ -261,59 +258,58 @@ and values that have platform-specific meanings; the interpretation of those fields is determined by the value of this byte. For example: -.\" .Bl -tag -width "ELFOSABI_STANDALONE" -compact -.RS 12 -.TP 20 +.RS +.TP 21 .PD 0 .BR ELFOSABI_NONE Same as ELFOSABI_SYSV .\" 0 .TP .BR ELFOSABI_SYSV -UNIX System V ABI. +UNIX System V ABI .\" 0 .\" synonym: ELFOSABI_NONE .TP .BR ELFOSABI_HPUX -HP-UX ABI. +HP-UX ABI .\" 1 .TP .BR ELFOSABI_NETBSD -NetBSD ABI. +NetBSD ABI .\" 2 .TP .BR ELFOSABI_LINUX -Linux ABI. +Linux ABI .\" 3 .\" .TP .\" .BR ELFOSABI_HURD -.\" Hurd ABI. +.\" Hurd ABI .\" 4 .\" .TP .\" .BR ELFOSABI_86OPEN -.\" 86Open Common IA32 ABI. +.\" 86Open Common IA32 ABI .\" 5 .TP .BR ELFOSABI_SOLARIS -Solaris ABI. +Solaris ABI .\" 6 .\" .TP .\" .BR ELFOSABI_MONTEREY -.\" Monterey project ABI. +.\" Monterey project ABI .\" Now replaced by .\" ELFOSABI_AIX .\" 7 .TP .BR ELFOSABI_IRIX -IRIX ABI. +IRIX ABI .\" 8 .TP .BR ELFOSABI_FREEBSD -FreeBSD ABI. +FreeBSD ABI .\" 9 .TP .BR ELFOSABI_TRU64 -TRU64 UNIX ABI. +TRU64 UNIX ABI .\" 10 .\" ELFOSABI_MODESTO .\" 11 @@ -321,13 +317,12 @@ .\" 12 .TP .BR ELFOSABI_ARM -ARM architecture ABI. +ARM architecture ABI .\" 97 .TP .BR ELFOSABI_STANDALONE -Stand-alone (embedded) ABI. +Stand-alone (embedded) ABI .\" 255 -.\" .El .PD .RE .TP @@ -361,14 +356,12 @@ The size of the .I e_ident array. -.\" .El .RE .TP .IR e_type This member of the structure identifies the object file type: -.RS 12 -.\" .Bl -tag -width "ET_NONE" -compact -.TP 12 +.RS +.TP 16 .PD 0 .BR ET_NONE An unknown type. @@ -386,73 +379,71 @@ A core file. .PD .RE -.\" .El .TP .IR e_machine This member specifies the required architecture for an individual file. For example: -.RS 12 -.\" .Bl -tag -width "EM_MIPS_RS4_BE" -compact -.TP 12 +.RS \n[l1_indent] +.TP 16 .PD 0 .BR EM_NONE -An unknown machine. +An unknown machine .\" 0 .TP .BR EM_M32 -AT&T WE 32100. +AT&T WE 32100 .\" 1 .TP .BR EM_SPARC -Sun Microsystems SPARC. +Sun Microsystems SPARC .\" 2 .TP .BR EM_386 -Intel 80386. +Intel 80386 .\" 3 .TP .BR EM_68K -Motorola 68000. +Motorola 68000 .\" 4 .TP .BR EM_88K -Motorola 88000. +Motorola 88000 .\" 5 .\" .TP .\" .BR EM_486 -.\" Intel 80486. +.\" Intel 80486 .\" 6 .TP .BR EM_860 -Intel 80860. +Intel 80860 .\" 7 .TP .BR EM_MIPS -MIPS RS3000 (big-endian only). +MIPS RS3000 (big-endian only) .\" 8 .\" EM_S370 .\" 9 .\" .TP .\" .BR EM_MIPS_RS4_BE -.\" MIPS RS4000 (big-endian only). Deprecated. +.\" MIPS RS4000 (big-endian only). Deprecated .\" 10 .\" EM_MIPS_RS3_LE (MIPS R3000 little-endian) .\" 10 .TP .BR EM_PARISC -HP/PA. +HP/PA .\" 15 .TP .BR EM_SPARC32PLUS -SPARC with enhanced instruction set. +SPARC with enhanced instruction set .\" 18 .TP .BR EM_PPC -PowerPC. +PowerPC .\" 20 .TP .BR EM_PPC64 -PowerPC 64-bit. +PowerPC 64-bit .\" 21 .TP .BR EM_S390 @@ -468,7 +459,7 @@ .\" 42 .TP .BR EM_SPARCV9 -SPARC v9 64-bit. +SPARC v9 64-bit .\" 43 .TP .BR EM_IA_64 @@ -480,32 +471,29 @@ .\" 62 .TP .BR EM_VAX -DEC Vax. +DEC Vax .\" 75 .\" EM_CRIS .\" 76 .\" .TP .\" .BR EM_ALPHA -.\" Compaq [DEC] Alpha. +.\" Compaq [DEC] Alpha .\" .TP .\" .BR EM_ALPHA_EXP -.\" Compaq [DEC] Alpha with enhanced instruction set. +.\" Compaq [DEC] Alpha with enhanced instruction set .PD .RE -.\" .El .TP .IR e_version This member identifies the file version: -.\" .Bl -tag -width "EV_CURRENT" -compact -.RS 12 -.TP 12 +.RS +.TP 16 .PD 0 .BR EV_NONE -Invalid version. +Invalid version .TP .BR EV_CURRENT -Current version. -.\" .El +Current version .PD .RE .TP @@ -528,7 +516,7 @@ .IR e_flags This member holds processor-specific flags associated with the file. Flag names take the form EF_`machine_flag'. -Currently no flags have been defined. +Currently, no flags have been defined. .TP .IR e_ehsize This member holds the ELF header's size in bytes. @@ -562,8 +550,7 @@ Otherwise, the .IR sh_info member of the initial entry contains the value zero. -.\" .Bl -tag -width "PN_XNUM" -.RS 12 +.RS \n[l1_indent] .TP 9 .BR PN_XNUM This is defined as 0xffff, the largest number @@ -571,7 +558,6 @@ can have, specifying where the actual number of program headers is assigned. .PD .RE -.\" .El .IP .TP .IR e_shentsize @@ -622,57 +608,6 @@ Otherwise, the .IR sh_link member of the initial entry in section header table contains the value zero. -.RS 12 -.\" .Bl -tag -width "SHN_LORESERVE" -.TP 14 -.BR SHN_UNDEF -This value marks an undefined, missing, irrelevant, or otherwise meaningless -section reference. -For example, a symbol -"defined" -relative to section number -.BR SHN_UNDEF -is an undefined symbol. -.TP -.BR SHN_LORESERVE -This value specifies the lower bound of the range of reserved indices. -.TP -.BR SHN_LOPROC -Values greater than or equal to -.BR SHN_HIPROC -are reserved for processor-specific semantics. -.TP -.BR SHN_HIPROC -Values less than or equal to -.BR SHN_LOPROC -are reserved for processor-specific semantics. -.TP -.BR SHN_ABS -This value specifies absolute values for the corresponding reference. -For -example, symbols defined relative to section number -.BR SHN_ABS -have absolute values and are not affected by relocation. -.TP -.BR SHN_COMMON -Symbols defined relative to this section are common symbols, such as Fortran -COMMON or unallocated C external variables. -.TP -.BR SHN_HIRESERVE -This value specifies the upper bound of the range of reserved -indices between -.BR SHN_LORESERVE -and -.BR SHN_HIRESERVE , -inclusive; the values do -not reference the section header table. -That is, the section header table -does -.I not -contain entries for the reserved indices. -.RE -.\" .El -.\" .El .PP An executable or shared object file's program header table is an array of structures, each describing a segment or other information the system needs @@ -727,13 +662,11 @@ in the location of the .IR p_flags member in the total struct. -.\" .Bl -tag -width "p_offset" -.TP 12 +.TP 10 .IR p_type -This member of the Phdr struct tells what kind of segment this array +This member of the structure indicates what kind of segment this array element describes or how to interpret the array element's information. -.\" .Bl -tag -width "PT_DYNAMIC" -.RS 12 +.RS 10 .TP 12 .BR PT_NULL The array element is unused and the other members' values are undefined. @@ -788,14 +721,9 @@ program. If it is present, it must precede any loadable segment entry. .TP -.BR PT_LOPROC -Values greater than or equal to -.BR PT_HIPROC -are reserved for processor-specific semantics. -.TP -.BR PT_HIPROC -Values less than or equal to -.BR PT_LOPROC +.BR PT_LOPROC ", " PT_HIPROC +Values in the inclusive range +.RB [ PT_LOPROC ", " PT_HIPROC ] are reserved for processor-specific semantics. .TP .BR PT_GNU_STACK @@ -803,7 +731,6 @@ stack via the flags set in the .IR p_flags member. -.\" .El .RE .TP .IR p_offset @@ -832,8 +759,7 @@ .TP .IR p_flags This member holds a bit mask of flags relevant to the segment: -.\" .Bl -tag -width "PF_X" -compact -.RS 12 +.RS \n[l1_indent] .TP .PD 0 .BR PF_X @@ -846,7 +772,6 @@ A readable segment. .PD .RE -.\" .El .IP A text segment commonly has the flags .BR PF_X @@ -854,7 +779,7 @@ .BR PF_R . A data segment commonly has .BR PF_X , -.BR PF_W +.BR PF_W , and .BR PF_R . .TP @@ -875,7 +800,6 @@ .IR p_offset , modulo .IR p_align . -.\" .El .PP A file's section header table lets one locate all the file's sections. The @@ -909,9 +833,7 @@ in other cases, each field in the initial entry is set to zero. An object file does not have sections for these special indices: -.\" .Bl -tag -width "SHN_LORESERVE" -.RS -.TP 14 +.TP .BR SHN_UNDEF This value marks an undefined, missing, irrelevant, or otherwise meaningless section reference. @@ -919,14 +841,9 @@ .BR SHN_LORESERVE This value specifies the lower bound of the range of reserved indices. .TP -.BR SHN_LOPROC -Values greater than or equal to -.BR SHN_HIPROC -are reserved for processor-specific semantics. -.TP -.BR SHN_HIPROC -Values less than or equal to -.BR SHN_LOPROC +.BR SHN_LOPROC ", " SHN_HIPROC +Values greater in the inclusive range +.RB [ SHN_LOPROC ", " SHN_HIPROC ] are reserved for processor-specific semantics. .TP .BR SHN_ABS @@ -950,8 +867,6 @@ inclusive. The section header table does not contain entries for the reserved indices. -.RE -.\" .El .PP The section header has the following structure: .in +4n @@ -990,8 +905,7 @@ .in .PP No real differences exist between the 32-bit and 64-bit section headers. -.\" .Bl -tag -width "sh_addralign" -.TP 10 +.TP \n[l1_indent] .IR sh_name This member specifies the name of the section. Its value is an index @@ -1000,8 +914,7 @@ .TP .IR sh_type This member categorizes the section's contents and semantics. -.\" .Bl -tag -width "SHT_PROGBITS" -.RS 10 +.RS \n[l1_indent] .TP 15 .BR SHT_NULL This value marks the section header as inactive. @@ -1081,15 +994,10 @@ .BR SHT_SYMTAB section. .TP -.BR SHT_LOPROC -This value up to and including -.BR SHT_HIPROC -is reserved for processor-specific semantics. -.TP -.BR SHT_HIPROC -This value down to and including -.BR SHT_LOPROC -is reserved for processor-specific semantics. +.BR SHT_LOPROC ", " SHT_HIPROC +Values in the inclusive range +.RB [ SHT_LOPROC ", " SHT_HIPROC ] +are reserved for processor-specific semantics. .TP .BR SHT_LOUSER This value specifies the lower bound of the range of indices reserved for @@ -1104,7 +1012,6 @@ .BR SHT_HIUSER may be used by the application, without conflicting with current or future system-defined section types. -.\" .El .RE .TP .IR sh_flags @@ -1118,8 +1025,7 @@ "off" or does not apply. Undefined attributes are set to zero. -.\" .Bl -tag -width "SHF_EXECINSTR" -compact -.RS 10 +.RS \n[l1_indent] .TP 15 .BR SHF_WRITE This section contains data that should be writable during process @@ -1139,7 +1045,6 @@ All bits included in this mask are reserved for processor-specific semantics. .RE -.\" .El .TP .IR sh_addr If this section appears in the memory image of a process, this member @@ -1193,11 +1098,9 @@ For such a section, this member gives the size in bytes for each entry. This member contains zero if the section does not hold a table of fixed-size entries. -.\" .El .PP Various sections hold program and control information: -.\" .Bl -tag -width ".shstrtab" -.TP 10 +.TP \n[l1_indent] .IR .bss This section holds uninitialized data that contributes to the program's memory image. @@ -1495,7 +1398,6 @@ .BR SHF_ALLOC and .BR SHF_EXECINSTR . -.\" .El .PP String table sections hold null-terminated character sequences, commonly called strings. @@ -1541,8 +1443,7 @@ .PP The 32-bit and 64-bit versions have the same members, just in a different order. -.\" .Bl -tag -width "st_value" -.TP 10 +.TP \n[l1_indent] .IR st_name This member holds an index into the object file's symbol string table, which holds character representations of the symbol names. @@ -1561,8 +1462,7 @@ .TP .IR st_info This member specifies the symbol's type and binding attributes: -.\" .Bl -tag -width "STT_SECTION" -.RS 10 +.RS \n[l1_indent] .TP 12 .BR STT_NOTYPE The symbol's type is not defined. @@ -1591,17 +1491,10 @@ .BR STB_LOCAL symbols of the file, if it is present. .TP -.BR STT_LOPROC -This value up to and including -.BR STT_HIPROC -is reserved for processor-specific semantics. -.TP -.BR STT_HIPROC -This value down to and including -.BR STT_LOPROC -is reserved for processor-specific semantics. -.\" .El -.\" .Bl -tag -width "STB_GLOBAL" +.BR STT_LOPROC ", " STT_HIPROC +Values in the inclusive range +.RB [ STT_LOPROC ", " STT_HIPROC ] +are reserved for processor-specific semantics. .TP .BR STB_LOCAL Local symbols are not visible outside the object file containing their @@ -1619,60 +1512,54 @@ Weak symbols resemble global symbols, but their definitions have lower precedence. .TP -.BR STB_LOPROC -This value up to and including -.BR STB_HIPROC -is reserved for processor-specific semantics. -.TP -.BR STB_HIPROC -This value down to and including -.BR STB_LOPROC -is reserved for processor-specific semantics. +.BR STB_LOPROC ", " STB_HIPROC +Values in the inclusive range +.RB [ STB_LOPROC ", " STB_HIPROC ] +are reserved for processor-specific semantics. +.RE .IP There are macros for packing and unpacking the binding and type fields: -.IP -.BR ELF32_ST_BIND (info) -or -.BR ELF64_ST_BIND (info) -extract a binding from an +.RS \n[l1_indent] +.TP +.BR ELF32_ST_BIND( \fIinfo\fP ) ", " ELF64_ST_BIND( \fIinfo\fP ) +Extract a binding from an .I st_info value. -.IP -.BR ELF32_ST_TYPE (info) -or -.BR ELF64_ST_TYPE (info) -.br -extract a type from an +.TP +.BR ELF32_ST_TYPE( \fIinfo ) ", " ELF64_ST_TYPE( \fIinfo\fP ) +Extract a type from an .I st_info value. -.IP -.BR ELF32_ST_INFO "(bind, type)" -or -.BR ELF64_ST_INFO "(bind, type)" -.br -convert a binding and a type into an +.TP +.BR ELF32_ST_INFO( \fIbind\fP ", " \fItype\fP ) ", " \ +ELF64_ST_INFO( \fIbind\fP ", " \fItype\fP ) +Convert a binding and a type into an .I st_info value. .RE -.\" .El .TP .IR st_other This member defines the symbol visibility. -.\" .Bl -tag -width "STV_PROTECTED" -.RS 10 +.RS \n[l1_indent] .TP 16 .PD 0 .BR STV_DEFAULT Default symbol visibility rules. +Global and weak symbols are available to other modules; +references in the local module can be interposed +by definitions in other modules. .TP .BR STV_INTERNAL Processor-specific hidden class. .TP .BR STV_HIDDEN -Symbol is unavailable in other modules. +Symbol is unavailable to other modules; +references in the local module always resolve to the local symbol +(i.e., the symbol can't be interposed by definitions in other modules). .TP .BR STV_PROTECTED -Not preemptible, not exported. +Symbol is available to other modules, +but references in the local module always resolve to the local symbol. .PD .PP There are macros for extracting the visibility type: @@ -1681,7 +1568,6 @@ or .BR ELF64_ST_VISIBILITY (other) .RE -.\" .El .TP .IR st_shndx Every symbol table entry is @@ -1689,7 +1575,6 @@ in relation to some section. This member holds the relevant section header table index. -.\" .El .PP Relocation is the process of connecting symbolic references with symbolic definitions. @@ -1740,8 +1625,7 @@ } Elf64_Rela; .fi .in -.\" .Bl -tag -width "r_offset" -.TP 12 +.TP \n[l1_indent] .IR r_offset This member gives the location at which to apply the relocation action. For a relocatable file, the value is the byte offset from the beginning @@ -1768,12 +1652,16 @@ .IR r_addend This member specifies a constant addend used to compute the value to be stored into the relocatable field. -.\" .El .PP -The .dynamic section contains a series of structures that hold relevant +The +.I .dynamic +section contains a series of structures that hold relevant dynamic linking information. -The d_tag member controls the interpretation -of d_un. +The +.I d_tag +member controls the interpretation +of +.IR d_un . .in +4n .nf @@ -1800,12 +1688,10 @@ extern Elf64_Dyn _DYNAMIC[]; .fi .in -.\" .Bl -tag -width "d_tag" -.TP 10 +.TP \n[l1_indent] .IR d_tag This member may have any of the following values: -.\" .Bl -tag -width "DT_SYMBOLIC" -.RS 10 +.RS \n[l1_indent] .TP 12 .BR DT_NULL Marks end of dynamic section @@ -1814,7 +1700,7 @@ String table offset to name of a needed library .TP .BR DT_PLTRELSZ -Size in bytes of PLT relocs +Size in bytes of PLT relocation entries .TP .BR DT_PLTGOT Address of PLT and/or GOT @@ -1829,13 +1715,13 @@ Address of symbol table .TP .BR DT_RELA -Address of Rela relocs table +Address of Rela relocation table .TP .BR DT_RELASZ -Size in bytes of Rela table +Size in bytes of the Rela relocation table .TP .BR DT_RELAENT -Size in bytes of a Rela table entry +Size in bytes of a Rela relocation table entry .TP .BR DT_STRSZ Size in bytes of string table @@ -1859,40 +1745,39 @@ Alert linker to search this shared object before the executable for symbols .TP .BR DT_REL -Address of Rel relocs table +Address of Rel relocation table .TP .BR DT_RELSZ -Size in bytes of Rel table +Size in bytes of Rel relocation table .TP .BR DT_RELENT Size in bytes of a Rel table entry .TP .BR DT_PLTREL -Type of reloc the PLT refers (Rela or Rel) +Type of relocation entry to which the PLT refers (Rela or Rel) .TP .BR DT_DEBUG Undefined use for debugging .TP .BR DT_TEXTREL -Absence of this indicates no relocs should apply to a nonwritable segment +Absence of this entry indicates that no relocation entries should +apply to a nonwritable segment .TP .BR DT_JMPREL -Address of reloc entries solely for the PLT +Address of relocation entries associated solely with the PLT .TP .BR DT_BIND_NOW -Instruct dynamic linker to process all relocs before transferring control to -the executable +Instruct dynamic linker to process all relocations +transferring control to the executable .TP .BR DT_RUNPATH String table offset to library search path .TP -.BR DT_LOPROC -Start of processor-specific semantics -.TP -.BR DT_HIPROC -End of processor-specific semantics +.BR DT_LOPROC ", " DT_HIPROC +Values in the inclusive range +.RB [ DT_LOPROC ", " DT_HIPROC ] +are reserved for processor-specific semantics .RE -.\" .El .TP .IR d_val This member represents integer values with various interpretations. @@ -1906,9 +1791,10 @@ relocation entries to fixup these addresses. .TP .I _DYNAMIC -Array containing all the dynamic structures in the .dynamic section. +Array containing all the dynamic structures in the +.I .dynamic +section. This is automatically populated by the linker. -.\" .El .SH NOTES .\" OpenBSD .\" ELF support first appeared in @@ -1961,11 +1847,11 @@ .IR "System V Application Binary Interface AMD64 Architecture Processor Supplement" . .PP .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man5/filesystems.5 manpages-4.05/man5/filesystems.5 --- manpages-4.04/man5/filesystems.5 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man5/filesystems.5 2016-03-15 03:47:41.000000000 +0000 @@ -49,7 +49,7 @@ .BR mount (8). Below a short description of the available or historically available -filesystems in Linux kernel +filesystems in the Linux kernel. See kernel documentation for a comprehensive description of all options and limitations. .TP 10 @@ -213,11 +213,11 @@ .BR mkfs (8), .BR mount (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man5/ftpusers.5 manpages-4.05/man5/ftpusers.5 --- manpages-4.04/man5/ftpusers.5 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man5/ftpusers.5 2016-03-15 03:47:41.000000000 +0000 @@ -51,11 +51,11 @@ .BR proftpd (8), .BR wuftpd (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man5/gai.conf.5 manpages-4.05/man5/gai.conf.5 --- manpages-4.04/man5/gai.conf.5 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man5/gai.conf.5 2016-03-15 03:47:41.000000000 +0000 @@ -16,7 +16,7 @@ .\" . .\" %%%LICENSE_END .\" -.TH GAI.CONF 5 2013-02-13 "Linux" "Linux Programmer's Manual" +.TH GAI.CONF 5 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME gai.conf \- getaddrinfo(3) configuration file .SH DESCRIPTION @@ -71,6 +71,11 @@ Changing these defaults should hardly ever be necessary. .SH FILES \fI/etc/gai.conf\fR +.SH VERSIONS +The +.I gai.conf +.\" Added in 2006 +file is supported by glibc since version 2.5. .SH EXAMPLE The default table according to RFC\ 3484 would be specified with the following configuration file: @@ -94,11 +99,11 @@ .BR getaddrinfo (3), RFC\ 3484 .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man5/group.5 manpages-4.05/man5/group.5 --- manpages-4.04/man5/group.5 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man5/group.5 2016-03-15 03:47:41.000000000 +0000 @@ -23,7 +23,7 @@ .\" %%%LICENSE_END .\" .\" Modified Sat Jul 24 17:06:03 1993 by Rik Faith (faith@cs.unc.edu) -.TH GROUP 5 2010-10-21 "Linux" "Linux Programmer's Manual" +.TH GROUP 5 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME group \- user group file .SH DESCRIPTION @@ -59,17 +59,22 @@ .I /etc/group up-to-date. .SH SEE ALSO +.BR chgrp (1), +.BR gpasswd (1), +.BR groups (1), .BR login (1), .BR newgrp (1), +.BR sg (1), .BR getgrent (3), .BR getgrnam (3), -.BR passwd (5) +.BR passwd (5), +.BR gshadow (5) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man5/host.conf.5 manpages-4.05/man5/host.conf.5 --- manpages-4.04/man5/host.conf.5 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man5/host.conf.5 2016-03-15 03:47:41.000000000 +0000 @@ -211,11 +211,11 @@ .BR hostname (7), .BR named (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man5/hosts.5 manpages-4.05/man5/hosts.5 --- manpages-4.04/man5/hosts.5 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man5/hosts.5 2016-03-15 03:47:41.000000000 +0000 @@ -135,11 +135,11 @@ .\" This manual page was written by Manoj Srivastava , .\" for the Debian GNU/Linux system. .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man5/hosts.equiv.5 manpages-4.05/man5/hosts.equiv.5 --- manpages-4.04/man5/hosts.equiv.5 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man5/hosts.equiv.5 2016-03-15 03:47:41.000000000 +0000 @@ -5,13 +5,13 @@ .\" %%%LICENSE_END .TH HOSTS.EQUIV 5 2015-07-23 "Linux" "Linux Programmer's Manual" .SH NAME -/etc/hosts.equiv \- list of hosts and users that are granted "trusted" +hosts.equiv \- list of hosts and users that are granted "trusted" .B r command access to your system .SH DESCRIPTION -The -.B hosts.equiv -file allows or denies hosts and users to use +The file +.I /etc/hosts.equiv +allows or denies hosts and users to use the \fBr\fP-commands (e.g., .BR rlogin , .BR rsh , @@ -172,11 +172,11 @@ .BR rlogind (8), .BR rshd (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man5/intro.5 manpages-4.05/man5/intro.5 --- manpages-4.04/man5/intro.5 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man5/intro.5 2016-03-15 03:47:41.000000000 +0000 @@ -38,11 +38,11 @@ .SH SEE ALSO .BR standards (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man5/issue.5 manpages-4.05/man5/issue.5 --- manpages-4.04/man5/issue.5 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man5/issue.5 2016-03-15 03:47:41.000000000 +0000 @@ -43,11 +43,11 @@ .BR agetty (8), .BR mingetty (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man5/locale.5 manpages-4.05/man5/locale.5 --- manpages-4.04/man5/locale.5 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man5/locale.5 2016-03-15 03:47:41.000000000 +0000 @@ -22,7 +22,7 @@ .\" 2008-06-17 Petr Baudis .\" LC_TIME: Describe first_weekday and first_workday .\" -.TH LOCALE 5 2015-07-23 "Linux" "Linux User Manual" +.TH LOCALE 5 2016-03-15 "Linux" "Linux User Manual" .SH NAME locale \- describes a locale definition file .SH DESCRIPTION @@ -114,7 +114,7 @@ See .BR locale (7) for a more detailed description of each category. - +.\" .SS LC_ADDRESS The definition starts with the string .I LC_ADDRESS @@ -199,7 +199,6 @@ information is taken from a Romanized version string of the entity. .RE - .TP .I country_name followed by the country name in the language of the current document @@ -573,10 +572,14 @@ .I tel followed by the telephone number (in international format) of the organization that maintains this document. +As of glibc 2.24, this keyword is deprecated in favor of +other contact methods. .TP .I fax followed by the fax number (in international format) of the organization that maintains this document. +As of glibc 2.24, this keyword is deprecated in favor of +other contact methods. .TP .I language followed by the name of the language to which this document applies. @@ -1338,11 +1341,11 @@ .BR unicode (7), .BR utf-8 (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man5/motd.5 manpages-4.05/man5/motd.5 --- manpages-4.04/man5/motd.5 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man5/motd.5 2016-03-15 03:47:41.000000000 +0000 @@ -43,11 +43,11 @@ .BR login (1), .BR issue (5) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man5/networks.5 manpages-4.05/man5/networks.5 --- manpages-4.04/man5/networks.5 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man5/networks.5 2016-03-15 03:47:41.000000000 +0000 @@ -78,11 +78,11 @@ .BR netstat (8), .BR route (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man5/nologin.5 manpages-4.05/man5/nologin.5 --- manpages-4.04/man5/nologin.5 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man5/nologin.5 2016-03-15 03:47:41.000000000 +0000 @@ -39,11 +39,11 @@ .BR login (1), .BR shutdown (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man5/nscd.conf.5 manpages-4.05/man5/nscd.conf.5 --- manpages-4.04/man5/nscd.conf.5 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man5/nscd.conf.5 2016-03-15 03:47:41.000000000 +0000 @@ -19,7 +19,7 @@ .\" .TH NSCD.CONF 5 2014-02-07 "GNU" "Linux Programmer's Manual" .SH NAME -/etc/nscd.conf \- name service cache daemon configuration file +nscd.conf \- name service cache daemon configuration file .SH DESCRIPTION The file .I /etc/nscd.conf @@ -242,11 +242,11 @@ .\" .B nscd .\" was written by Thorsten Kukuk and Ulrich Drepper. .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man5/nss.5 manpages-4.05/man5/nss.5 --- manpages-4.04/man5/nss.5 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man5/nss.5 2016-03-15 03:47:41.000000000 +0000 @@ -110,11 +110,11 @@ .SH SEE ALSO \fInsswitch.conf\fR .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man5/nsswitch.conf.5 manpages-4.05/man5/nsswitch.conf.5 --- manpages-4.04/man5/nsswitch.conf.5 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man5/nsswitch.conf.5 2016-03-15 03:47:41.000000000 +0000 @@ -22,7 +22,7 @@ .\" . .\" %%%LICENSE_END .\" -.TH NSSWITCH.CONF 5 2015-12-05 "Linux" "Linux Programmer's Manual" +.TH NSSWITCH.CONF 5 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME nsswitch.conf \- Name Service Switch configuration file .SH DESCRIPTION @@ -260,16 +260,22 @@ .RE .SS Compatibility mode (compat) The NSS "compat" service is similar to "files" except that it -additionally permits special entries in -.I /etc/passwd +additionally permits special entries in corresponding files for granting users or members of netgroups access to the system. The following entries are valid in this mode: .RS 4 +.LP +For +.B passwd +and +.B shadow +databases: +.RS 4 .TP 12 .BI + user Include the specified .I user -from the NIS passwd map. +from the NIS passwd/shadow map. .TP .BI +@ netgroup Include all users in the given @@ -278,7 +284,7 @@ .BI \- user Exclude the specified .I user -from the NIS passwd map. +from the NIS passwd/shadow map. .TP .BI \-@ netgroup Exclude all users in the given @@ -286,11 +292,33 @@ .TP .B + Include every user, except previously excluded ones, from the -NIS passwd map. +NIS passwd/shadow map. +.RE +.LP +For +.B group +database: +.RS 4 +.TP 12 +.BI + group +Include the specified +.I group +from the NIS group map. +.TP +.BI \- group +Exclude the specified +.I group +from the NIS group map. +.TP +.B + +Include every group, except previously excluded ones, from the +NIS group map. +.RE .RE .LP By default, the source is "nis", but this may be -overridden by specifying "nisplus" as the source for the pseudo-databases +overridden by specifying any NSS service except "compat" itself +as the source for the pseudo-databases .BR passwd_compat , .BR group_compat , and @@ -399,11 +427,11 @@ .BR getent (1), .BR nss (5) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man5/passwd.5 manpages-4.05/man5/passwd.5 --- manpages-4.04/man5/passwd.5 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man5/passwd.5 2016-03-15 03:47:42.000000000 +0000 @@ -171,11 +171,11 @@ .BR group (5), .BR shadow (5) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man5/proc.5 manpages-4.05/man5/proc.5 --- manpages-4.04/man5/proc.5 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man5/proc.5 2016-03-15 03:47:42.000000000 +0000 @@ -52,7 +52,7 @@ .\" to see what information could be imported from that file .\" into this file. .\" -.TH PROC 5 2015-12-05 "Linux" "Linux Programmer's Manual" +.TH PROC 5 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME proc \- process information pseudo-filesystem .SH DESCRIPTION @@ -619,7 +619,7 @@ The contents of each file can be read to obtain information about the corresponding file descriptor. The content depends on the type of file referred to by the -corresponding descriptor. +corresponding file descriptor. For regular files and directories, we see something like: .in +4n @@ -632,25 +632,42 @@ .fi .in -The +The fields are as follows: +.RS +.TP .I pos -field is a decimal number showing the current file offset. -The +This is a decimal number showing the file offset. +.TP .I flags -field is an octal number that displays the +This is an octal number that displays the file access mode and file status flags (see .BR open (2)). -The +If the close-on-exec file descriptor flag is set, then +.I flags +will also include the value +.BR O_CLOEXEC . + +Before Linux 3.1, +.\" commit 1117f72ea0217ba0cc19f05adbbd8b9a397f5ab7 +this field incorrectly displayed the setting of +.B O_CLOEXEC +at the time the file was opened, +rather than the current setting of the close-on-exec flag. +.TP +.I .I mnt_id -field, present since Linux 3.15, +This field, present since Linux 3.15, .\" commit 49d063cb353265c3af701bab215ac438ca7df36d is the ID of the mount point containing this file. See the description of .IR /proc/[pid]/mountinfo . - +.RE +.IP For eventfd file descriptors (see .BR eventfd (2)), -we see the following fields: +we see (since Linux 3.8) +.\" commit cbac5542d48127b546a23d816380a7926eee1c25 +the following fields: .in +4n .nf @@ -666,7 +683,9 @@ For epoll file descriptors (see .BR epoll (7)), -we see the following fields: +we see (since Linux 3.8) +.\" commit 138d22b58696c506799f8de759804083ff9effae +the following fields: .in +4n .nf @@ -697,7 +716,9 @@ For signalfd file descriptors (see .BR signalfd (2)), -we see the following fields: +we see (since Linux 3.8) +.\" commit 138d22b58696c506799f8de759804083ff9effae +the following fields: .in +4n .nf @@ -717,19 +738,102 @@ .BR SIGQUIT ; see .BR signal (7).) -.\" FIXME -.\" Certain file types include additional info; see -.\" Documentation/filesystems/proc.txt -.\" -.\" Especially interesting is this: -.\" -.\" commit ab49bdecc3ebb46ab661f5f05d5c5ea9606406c6 -.\" Author: Cyrill Gorcunov -.\" Date: Mon Dec 17 16:05:06 2012 -0800 -.\" -.\" Basically, the /proc/PID/fdinfo/ entry for an inotify FD -.\" includes the file handles for all watched FDs -.\" + +For inotify file descriptors (see +.BR inotify (7)), +we see (since Linux 3.8) +the following fields: + +.in +4n +.nf +pos: 0 +flags: 00 +mnt_id: 11 +inotify wd:2 ino:7ef82a sdev:800001 mask:800afff ignored_mask:0 fhandle-bytes:8 fhandle-type:1 f_handle:2af87e00220ffd73 +inotify wd:1 ino:192627 sdev:800001 mask:800afff ignored_mask:0 fhandle-bytes:8 fhandle-type:1 f_handle:27261900802dfd73 +.fi +.in + +Each of the lines beginning with "inotify" displays information about +one file or directory that is being monitored. +The fields in this line are as follows: +.RS +.TP +.I wd +A watch descriptor number (in decimal). +.TP +.I ino +The inode number of the target file (in hexadecimal). +.TP +.I sdev +The ID of the device where the target file resides (in hexadecimal). +.TP +.I mask +The mask of events being monitored for the target file (in hexadecimal). +.RE +.IP +If the kernel was built with exportfs support, the path to the target +file is exposed as a file handle, via three hexadecimal fields: +.IR fhandle-bytes , +.IR fhandle-type , +and +.IR f_handle . + +For fanotify file descriptors (see +.BR fanotify (7)), +we see (since Linux 3.8) +the following fields: + +.in +4n +.nf +pos: 0 +flags: 02 +mnt_id: 11 +fanotify flags:0 event-flags:88002 +fanotify ino:19264f sdev:800001 mflags:0 mask:1 ignored_mask:0 fhandle-bytes:8 fhandle-type:1 f_handle:4f261900a82dfd73 +.fi +.in + +The fourth line displays information defined when the fanotify group +was created via +.BR fanotify_init (2): +.RS +.TP +.I flags +The +.I flags +argument given to +.BR fanotify_init (2) +(expressed in hexadecimal). +.TP +.I event-flags +The +.I event_f_flags +argument given to +.BR fanotify_init (2) +(expressed in hexadecimal). +.RE +.IP +Each additional line shown in the file contains information +about one of the marks in the fanotify group. +Most of these fields are as for inotify, except: +.RS +.TP +.I mflags +The flags associated with the mark +(expressed in hexadecimal). +.TP +.I mask +The events mask for this mark +(expressed in hexadecimal). +.TP +.I ignored_mask +The mask of events that are ignored for this mark +(expressed in hexadecimal). +.RE +.IP +For details on these fields, see +.BR fanotify_mark (2). .TP .IR /proc/[pid]/io " (since kernel 2.6.20)" .\" commit 7c3ab7381e79dfc7db14a67c6f4f3285664e1ec2 @@ -859,7 +963,6 @@ .in +4n .nf -.RB lrw\-\-\-\-\-\-\-. 1 root root 64 Apr 16 21:33 7fc075d2f000\-7fc075e6f000 \-> /dev/zero (deleted) .fi @@ -1048,7 +1151,7 @@ .RE .IP Parsers should ignore all unrecognized optional fields. -Currently the possible optional fields are: +Currently, the possible optional fields are: .RS 12 .TP 18 shared:X @@ -1134,7 +1237,6 @@ .BR setns (2). For more information, see .BR namespaces (7). - .TP .IR /proc/[pid]/numa_maps " (since Linux 2.6.14)" See @@ -2563,6 +2665,10 @@ The sum of .IR LowFree + HighFree . .TP +.IR MemAvailable " %lu (since Linux 3.14)" +An estimate of how much memory is available for starting new +applications, without swapping. +.TP .IR Buffers " %lu" Relatively temporary storage for raw disk blocks that shouldn't get tremendously large (20MB or so). @@ -2748,6 +2854,14 @@ (\fBCONFIG_TRANSPARENT_HUGEPAGE\fP is required.) Non-file backed huge pages mapped into user-space page tables. .TP +.IR CmaTotal " %lu (since Linux 3.1)" +Total CMA (Contiguous Memory Allocator) pages. +(\fBCONFIG_CMA\fP is required.) +.TP +.IR CmaFree " %lu (since Linux 3.1)" +Free CMA (Contiguous Memory Allocator) pages. +(\fBCONFIG_CMA\fP is required.) +.TP .IR HugePages_Total " %lu" (\fBCONFIG_HUGETLB_PAGE\fP is required.) The size of the pool of huge pages. @@ -2776,6 +2890,33 @@ .IR Hugepagesize " %lu" (\fBCONFIG_HUGETLB_PAGE\fP is required.) The size of huge pages. +.TP +.IR DirectMap4k " %lu (since Linux 2.6.27)" +Number of bytes of RAM linearly mapped by kernel in 4kB pages. +(x86.) +.TP +.IR DirectMap4M " %lu (since Linux 2.6.27)" +Number of bytes of RAM linearly mapped by kernel in 4MB pages. +(x86 with +.BR CONFIG_X86_64 +or +.BR CONFIG_X86_PAE +enabled.) +.TP +.IR DirectMap2M " %lu (since Linux 2.6.27)" +Number of bytes of RAM linearly mapped by kernel in 2MB pages. +(x86 with neither +.BR CONFIG_X86_64 +nor +.BR CONFIG_X86_PAE +enabled.) +.TP +.IR DirectMap1G " %lu (since Linux 2.6.27)" +(x86 with +.BR CONFIG_X86_64 +and +.B CONFIG_X86_DIRECT_GBPAGES +enabled.) .RE .TP .I /proc/modules @@ -4742,7 +4883,6 @@ 1, 4911 kworker/u16:0 mod_delayed_work_on (delayed_work_timer_fn) 1D, 2522 kworker/0:0 queue_delayed_work_on (delayed_work_timer_fn) 1029 total events, 583.333 events/sec - .fi .RE .IP @@ -5535,11 +5675,11 @@ and .IR Documentation/sysctl/vm.txt . .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man5/protocols.5 manpages-4.05/man5/protocols.5 --- manpages-4.04/man5/protocols.5 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man5/protocols.5 2016-03-15 03:47:42.000000000 +0000 @@ -84,11 +84,11 @@ .UR http://www.iana.org\:/assignments\:/protocol-numbers .UE .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man5/repertoiremap.5 manpages-4.05/man5/repertoiremap.5 --- manpages-4.04/man5/repertoiremap.5 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man5/repertoiremap.5 2016-03-15 03:47:42.000000000 +0000 @@ -71,11 +71,11 @@ .BR charmap (5), .BR locale (5) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man5/resolv.conf.5 manpages-4.05/man5/resolv.conf.5 --- manpages-4.04/man5/resolv.conf.5 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man5/resolv.conf.5 2016-03-15 03:47:42.000000000 +0000 @@ -322,11 +322,11 @@ .br Name Server Operations Guide for BIND .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man5/rpc.5 manpages-4.05/man5/rpc.5 --- manpages-4.04/man5/rpc.5 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man5/rpc.5 2016-03-15 03:47:42.000000000 +0000 @@ -80,11 +80,11 @@ .SH SEE ALSO .BR getrpcent (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man5/securetty.5 manpages-4.05/man5/securetty.5 --- manpages-4.04/man5/securetty.5 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man5/securetty.5 2016-03-15 03:47:42.000000000 +0000 @@ -53,11 +53,11 @@ .BR login.defs (5), .BR pam_securetty (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man5/services.5 manpages-4.05/man5/services.5 --- manpages-4.04/man5/services.5 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man5/services.5 2016-03-15 03:47:42.000000000 +0000 @@ -220,11 +220,11 @@ Assigned Numbers RFC, most recently RFC\ 1700, (AKA STD0002). .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man5/shells.5 manpages-4.05/man5/shells.5 --- manpages-4.04/man5/shells.5 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man5/shells.5 2016-03-15 03:47:42.000000000 +0000 @@ -57,11 +57,11 @@ .BR chsh (1), .BR getusershell (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man5/slabinfo.5 manpages-4.05/man5/slabinfo.5 --- manpages-4.04/man5/slabinfo.5 2015-12-29 12:51:49.000000000 +0000 +++ manpages-4.05/man5/slabinfo.5 2016-03-15 03:47:42.000000000 +0000 @@ -33,7 +33,7 @@ .\" .TH SLABINFO 5 2007-09-30 "" "Linux Programmer's Manual" .SH NAME -/proc/slabinfo \- kernel slab allocator statistics +slabinfo \- kernel slab allocator statistics .SH SYNOPSIS .B cat /proc/slabinfo .SH DESCRIPTION @@ -133,11 +133,11 @@ .B CONFIG_SLAB kernel configuration option is enabled. .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man5/termcap.5 manpages-4.05/man5/termcap.5 --- manpages-4.04/man5/termcap.5 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man5/termcap.5 2016-03-15 03:47:42.000000000 +0000 @@ -472,11 +472,11 @@ .BR termcap (3), .BR terminfo (5) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man5/ttytype.5 manpages-4.05/man5/ttytype.5 --- manpages-4.04/man5/ttytype.5 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man5/ttytype.5 2016-03-15 03:47:42.000000000 +0000 @@ -70,11 +70,11 @@ .BR agetty (8), .BR mingetty (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man5/tzfile.5 manpages-4.05/man5/tzfile.5 --- manpages-4.04/man5/tzfile.5 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man5/tzfile.5 2016-03-15 03:47:42.000000000 +0000 @@ -193,7 +193,6 @@ information file. .SS Summary of the timezone information file format \& -.sp 2 .RS .nf Four-byte value section @@ -226,7 +225,7 @@ Newline character .fi .RE - +.\" .SH SEE ALSO .BR ctime (3), .BR tzset (3), @@ -235,11 +234,11 @@ .I timezone/tzfile.h in the glibc source tree .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man5/utmp.5 manpages-4.05/man5/utmp.5 --- manpages-4.04/man5/utmp.5 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man5/utmp.5 2016-03-15 03:47:42.000000000 +0000 @@ -27,7 +27,7 @@ .\" Modified 1996-07-20 by Michael Haardt .\" Modified 1997-07-02 by Nicolás Lichtmaier .\" Modified 2004-10-31 by aeb, following Gwenole Beauchesne -.TH UTMP 5 2014-08-19 "Linux" "Linux Programmer's Manual" +.TH UTMP 5 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME utmp, wtmp \- login records .SH SYNOPSIS @@ -338,8 +338,10 @@ .SH SEE ALSO .BR ac (1), .BR date (1), +.BR init (1), .BR last (1), .BR login (1), +.BR lslogins (1), .BR utmpdump (1), .BR who (1), .BR getutent (3), @@ -347,14 +349,13 @@ .BR login (3), .BR logout (3), .BR logwtmp (3), -.BR updwtmp (3), -.BR init (1) +.BR updwtmp (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man6/intro.6 manpages-4.05/man6/intro.6 --- manpages-4.04/man6/intro.6 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man6/intro.6 2016-03-15 03:47:42.000000000 +0000 @@ -35,11 +35,11 @@ conditions. Note that these can be different from page to page! .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/aio.7 manpages-4.05/man7/aio.7 --- manpages-4.04/man7/aio.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/aio.7 2016-03-15 03:47:42.000000000 +0000 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH AIO 7 2015-12-05 "Linux" "Linux Programmer's Manual" +.TH AIO 7 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME aio \- POSIX asynchronous I/O overview .SH DESCRIPTION @@ -282,12 +282,14 @@ static void /* Handler for I/O completion signal */ aioSigHandler(int sig, siginfo_t *si, void *ucontext) { - write(STDOUT_FILENO, "I/O completion signal received\\n", 31); + if (si->si_code == SI_ASYNCIO) { + write(STDOUT_FILENO, "I/O completion signal received\\n", 31); - /* The corresponding ioRequest structure would be available as - struct ioRequest *ioReq = si\->si_value.sival_ptr; - and the file descriptor would then be available via - ioReq\->aiocbp\->aio_fildes */ + /* The corresponding ioRequest structure would be available as + struct ioRequest *ioReq = si\->si_value.sival_ptr; + and the file descriptor would then be available via + ioReq\->aiocbp\->aio_fildes */ + } } int @@ -467,11 +469,11 @@ .UR https://www.kernel.org/doc/ols/2003/ols2003-pages-351-366.pdf .UE .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/armscii-8.7 manpages-4.05/man7/armscii-8.7 --- manpages-4.04/man7/armscii-8.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/armscii-8.7 2016-03-15 03:47:42.000000000 +0000 @@ -138,11 +138,11 @@ .BR charsets (7), .BR utf-8 (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/arp.7 manpages-4.05/man7/arp.7 --- manpages-4.04/man7/arp.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/arp.7 2016-03-15 03:47:42.000000000 +0000 @@ -308,11 +308,11 @@ algorithms used. Linux 2.2+ IPv4 ARP uses the IPv6 algorithms when applicable. .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/ascii.7 manpages-4.05/man7/ascii.7 --- manpages-4.04/man7/ascii.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/ascii.7 2016-03-15 03:47:42.000000000 +0000 @@ -201,11 +201,11 @@ .BR iso_8859-9 (7), .BR utf-8 (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/attributes.7 manpages-4.05/man7/attributes.7 --- manpages-4.04/man7/attributes.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/attributes.7 2016-03-15 03:47:42.000000000 +0000 @@ -98,7 +98,7 @@ .\" but does document which functions are presently AC-Safe. .\" This documentation is provided for use .\" by the GNU C Library developers. - +.\" .\" Just like signal handlers, cancellation cleanup routines must configure .\" the floating point environment they require. .\" The routines cannot assume a floating point environment, @@ -345,7 +345,7 @@ this specific cause for the function to be regarded as MT-Unsafe. If no other cause for that remains, the function can then be safely called after other threads are started. - +.\" .\" Functions marked with .\" .I init .\" as an AS-Unsafe or AC-Unsafe feature use the GNU C Library internal @@ -386,7 +386,7 @@ the objects are passed to the functions by users; in others, they are used by the functions to return values to users; in others, they are not even exposed to users. - +.\" .\" We consider access to objects passed as (indirect) arguments to .\" functions to be data race free. .\" The assurance of data race free objects @@ -563,7 +563,7 @@ temporary signal; blocking that signal before the call and resetting its handler afterwards is recommended. - +.\" .\" There is no safe way to guarantee the original signal handler is .\" restored in case of asynchronous cancellation, .\" therefore so-marked functions are also AC-Unsafe. @@ -609,7 +609,7 @@ The caller may use a single mutex for simplicity, or use one mutex per terminal, even if referenced by different file descriptors. - +.\" .\" Functions marked with .\" .I term .\" as an AC-Safety issue are supposed to @@ -656,7 +656,6 @@ and so the locale can be considered effectively constant in these contexts, which makes the former safe. - .\" Should the locking strategy suggested under @code{const} be used, .\" failure to guard locale uses is not as fatal as data races in .\" general: unguarded uses will @emph{not} follow dangling pointers or @@ -883,11 +882,11 @@ .SH SEE ALSO .BR pthreads (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/boot.7 manpages-4.05/man7/boot.7 --- manpages-4.04/man7/boot.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/boot.7 2016-03-15 03:47:42.000000000 +0000 @@ -228,11 +228,11 @@ .BR runlevel (8), .BR shutdown (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/bootparam.7 manpages-4.05/man7/bootparam.7 --- manpages-4.04/man7/bootparam.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/bootparam.7 2016-03-15 03:47:42.000000000 +0000 @@ -182,7 +182,6 @@ The 'rw' option tells the kernel to mount the root filesystem read/write. This is the default. - .TP .B "'resume=...'" This tells the kernel the location of the suspend-to-disk data that you want the machine to resume from after hibernation. @@ -677,11 +676,11 @@ For up-to-date information, see the kernel source file .IR Documentation/kernel-parameters.txt . .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/capabilities.7 manpages-4.05/man7/capabilities.7 --- manpages-4.04/man7/capabilities.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/capabilities.7 2016-03-15 03:47:42.000000000 +0000 @@ -45,7 +45,7 @@ .\" other capabilities where the permitted or inheritable bit is set. .\" 2011-09-07, mtk/Serge hallyn: Add CAP_SYSLOG .\" -.TH CAPABILITIES 7 2015-12-05 "Linux" "Linux Programmer's Manual" +.TH CAPABILITIES 7 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME capabilities \- overview of Linux capabilities .SH DESCRIPTION @@ -108,7 +108,6 @@ .BR open_by_handle_at (2). .RE .PD - .TP .B CAP_FOWNER .PD 0 @@ -832,7 +831,7 @@ denotes the value of a thread capability set before the .BR execve (2) .IP P' -denotes the value of a capability set after the +denotes the value of a thread capability set after the .BR execve (2) .IP F denotes a file capability set @@ -843,6 +842,42 @@ A privileged file is one that has capabilities or has the set-user-ID or set-group-ID bit set. .\" +.SS Safety checking for capability-dumb binaries +A capability-dumb binary is an application that has been +marked to have file capabilities, but has not been converted to use the +.BR libcap (3) +API to manipulate its capabilities. +(In other words, this is a traditional set-user-ID-root program +that has been switched to use file capabilities, +but whose code has not been modified to understand capabilities.) +For such applications, +the effective capability bit is set on the file, +so that the file permitted capabilities are automatically +enabled in the process effective set when executing the file. +The kernel recognizes a file which has the effective capability bit set +as capability-dumb for the purpose of the check described here. + +When executing a capability-dumb binary, +the kernel checks if the process obtained all permitted capabilities +that were specified in the file permitted set, +after the capability transformations described above have been performed. +(The typical reason why this might +.I not +occur is that the capability bounding set masked out some +of the capabilities in the file permitted set.) +If the process did not obtain the full set of +file permitted capabilities, then +.BR execve (2) +fails with the error +.BR EPERM . +This prevents possible security risks that could arise when +a capability-dumb application is executed with less privilege that it needs. +Note that, by definition, +the application could not itself recognize this problem, +since it does not employ the +.BR libcap (3) +API. +.\" .SS Capabilities and execution of programs by root In order to provide an all-powerful .I root @@ -1094,10 +1129,10 @@ .TP .B SECBIT_NO_SETUID_FIXUP Setting this flag stops the kernel from adjusting capability sets when -the threads's effective and filesystem UIDs are switched between +the thread's effective and filesystem UIDs are switched between zero and nonzero values. (See the subsection -.IR "Effect of User ID Changes on Capabilities" .) +.IR "Effect of user ID changes on capabilities" .) .TP .B SECBIT_NOROOT If this bit is set, then the kernel does not grant capabilities @@ -1122,7 +1157,7 @@ .BR SECBIT_NO_SETUID_FIXUP_LOCKED , .BR SECBIT_NOROOT_LOCKED , and -.BR SECBIT_NO_CAP_AMBIENT_RAISE . +.BR SECBIT_NO_CAP_AMBIENT_RAISE_LOCKED . .PP The .I securebits @@ -1174,7 +1209,7 @@ .\" commit 5915eb53861c5776cfec33ca4fcc1fd20d66dd27 removed .\" CONFIG_SECURITY_CAPABILITIES capabilities were an optional kernel component, -and can be enabled/disabled via the +and could be enabled/disabled via the .B CONFIG_SECURITY_CAPABILITIES kernel configuration option. @@ -1252,11 +1287,11 @@ .I include/linux/capability.h in the Linux kernel source tree .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/charsets.7 manpages-4.05/man7/charsets.7 --- manpages-4.04/man7/charsets.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/charsets.7 2016-03-15 03:47:42.000000000 +0000 @@ -335,11 +335,11 @@ .BR unicode (7), .BR utf-8 (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/complex.7 manpages-4.05/man7/complex.7 --- manpages-4.04/man7/complex.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/complex.7 2016-03-15 03:47:42.000000000 +0000 @@ -80,11 +80,11 @@ .BR ctan (3), .BR ctanh (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/cp1251.7 manpages-4.05/man7/cp1251.7 --- manpages-4.04/man7/cp1251.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/cp1251.7 2016-03-15 03:47:42.000000000 +0000 @@ -183,11 +183,11 @@ .BR koi8-u (7), .BR utf-8 (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/cp1252.7 manpages-4.05/man7/cp1252.7 --- manpages-4.04/man7/cp1252.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/cp1252.7 2016-03-15 03:47:42.000000000 +0000 @@ -173,11 +173,11 @@ .BR iso_8859-15 (7), .BR utf-8 (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/cpuset.7 manpages-4.05/man7/cpuset.7 --- manpages-4.04/man7/cpuset.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/cpuset.7 2016-03-15 03:47:42.000000000 +0000 @@ -1504,11 +1504,11 @@ .IR Documentation/cpusets.txt in the Linux kernel source tree .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/credentials.7 manpages-4.05/man7/credentials.7 --- manpages-4.04/man7/credentials.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/credentials.7 2016-03-15 03:47:42.000000000 +0000 @@ -24,7 +24,7 @@ .\" .\" 2007-06-13 Creation .\" -.TH CREDENTIALS 7 2015-03-29 "Linux" "Linux Programmer's Manual" +.TH CREDENTIALS 7 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME credentials \- process identifiers .SH DESCRIPTION @@ -307,7 +307,11 @@ .SH SEE ALSO .BR bash (1), .BR csh (1), +.BR groups (1), +.BR id (1), .BR ps (1), +.BR sg (1), +.BR su (1), .BR access (2), .BR execve (2), .BR faccessat (2), @@ -333,6 +337,8 @@ .BR initgroups (3), .BR tcgetpgrp (3), .BR tcsetpgrp (3), +.BR group (3), +.BR passwd (3), .BR capabilities (7), .BR namespaces (7), .BR path_resolution (7), @@ -342,11 +348,11 @@ .BR user_namespaces (7), .BR unix (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/ddp.7 manpages-4.05/man7/ddp.7 --- manpages-4.04/man7/ddp.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/ddp.7 2016-03-15 03:47:42.000000000 +0000 @@ -252,11 +252,11 @@ .BR capabilities (7), .BR socket (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/environ.7 manpages-4.05/man7/environ.7 --- manpages-4.04/man7/environ.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/environ.7 2016-03-15 03:47:42.000000000 +0000 @@ -31,7 +31,7 @@ .\" Modified Wed Jan 24 06:37:24 2001 by Eric S. Raymond (esr@thyrsus.com) .\" Modified Thu Dec 13 23:53:27 2001 by Martin Schulze .\" -.TH ENVIRON 7 2014-08-19 "Linux" "Linux Programmer's Manual" +.TH ENVIRON 7 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME environ \- user environment .SH SYNOPSIS @@ -53,6 +53,11 @@ This array of strings is made available to the process by the .BR exec (3) call that started the process. +When a child process is created via +.BR fork (2), +it inherits a +.I copy +of its parent's environment. By convention the strings in .I environ @@ -124,14 +129,38 @@ .\" The user's preferred utility to browse URLs. Sequence of colon-separated .\" browser commands. See http://www.catb.org/~esr/BROWSER/ . .PP -Further names may be placed in the environment by the +Names may be placed in the shell's environment by the .I export -command and "name=value" in +command in .BR sh (1), or by the .I setenv command if you use .BR csh (1). + +The initial environment of the shell is populated in various ways, +such as definitions from +.IR /etc/environment +that are processed by +.BR pam_env (8) +for all users at login time (on systems that employ +.BR pam (8)). +In addition, various shell initialization scripts, such as the system-wide +.IR /etc/profile +script and per-user initializations script may include commands +that add variables to the shell's environment; +see the manual page of your preferred shell for details. + +Bourne-style shells support the syntax + + NAME=value command + +to create an environment variable definition only in the scope +of the process that executes +.IR command . +Multiple variable definitions, separated by white space, may precede +.IR command . + Arguments may also be placed in the environment at the point of an .BR exec (3). @@ -204,8 +233,6 @@ may specify the desired printer to use. See .BR lpr (1). -.LP -Etc. .SH BUGS Clearly there is a security risk here. Many a system command has been @@ -256,17 +283,18 @@ .BR clearenv (3), .BR exec (3), .BR getenv (3), +.BR pam_env (3), .BR putenv (3), .BR setenv (3), .BR unsetenv (3), .BR locale (7), .BR ld.so (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/epoll.7 manpages-4.05/man7/epoll.7 --- manpages-4.04/man7/epoll.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/epoll.7 2016-03-15 03:47:42.000000000 +0000 @@ -18,7 +18,7 @@ .\" .\" Davide Libenzi .\" -.TH EPOLL 7 2015-04-19 "Linux" "Linux Programmer's Manual" +.TH EPOLL 7 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME epoll \- I/O event notification facility .SH SYNOPSIS @@ -288,7 +288,7 @@ for (n = 0; n < nfds; ++n) { if (events[n].data.fd == listen_sock) { conn_sock = accept(listen_sock, - (struct sockaddr *) &local, &addrlen); + (struct sockaddr *) &addr, &addrlen); if (conn_sock == \-1) { perror("accept"); exit(EXIT_FAILURE); @@ -351,19 +351,19 @@ .BR dup2 (2), .BR fcntl (2) .BR F_DUPFD ) -descriptor to the same +file descriptor to the same .B epoll instance. -.\" But a descriptor duplicated by fork(2) can't be added to the +.\" But a file descriptor duplicated by fork(2) can't be added to the .\" set, because the [file *, fd] pair is already in the epoll set. .\" That is a somewhat ugly inconsistency. On the one hand, a child process .\" cannot add the duplicate file descriptor to the epoll set. (In every -.\" other case that I can think of, descriptors duplicated by fork have -.\" similar semantics to descriptors duplicated by dup() and friends.) On +.\" other case that I can think of, file descriptors duplicated by fork have +.\" similar semantics to file descriptors duplicated by dup() and friends.) On .\" the other hand, the very fact that the child has a duplicate of the -.\" descriptor means that even if the parent closes its descriptor, then -.\" epoll_wait() in the parent will continue to receive notifications for -.\" that descriptor because of the duplicated descriptor in the child. +.\" file descriptor means that even if the parent closes its file descriptor, +.\" then epoll_wait() in the parent will continue to receive notifications for +.\" that file descriptor because of the duplicated file descriptor in the child. .\" .\" See http://thread.gmane.org/gmane.linux.kernel/596462/ .\" "epoll design problems with common fork/exec patterns" @@ -434,7 +434,7 @@ Yes, but be aware of the following point. A file descriptor is a reference to an open file description (see .BR open (2)). -Whenever a descriptor is duplicated via +Whenever a file descriptor is duplicated via .BR dup (2), .BR dup2 (2), .BR fcntl (2) @@ -449,7 +449,7 @@ .B epoll set only after all the file descriptors referring to the underlying open file description have been closed -(or before if the descriptor is explicitly removed using +(or before if the file descriptor is explicitly removed using .BR epoll_ctl (2) .BR EPOLL_CTL_DEL ). This means that even after a file descriptor that is part of an @@ -574,6 +574,15 @@ .IR kqueue , and Solaris has .IR /dev/poll . +.SH NOTES +The set of file descriptors that is being monitored via +an epoll file descriptor can be viewed via the entry for +the epoll file descriptor in the process's +.IR /proc/[pid]/fdinfo +directory. +See +.BR proc (5) +for further details. .SH SEE ALSO .BR epoll_create (2), .BR epoll_create1 (2), @@ -582,11 +591,11 @@ .BR poll (2), .BR select (2) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/fanotify.7 manpages-4.05/man7/fanotify.7 --- manpages-4.04/man7/fanotify.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/fanotify.7 2016-03-15 03:47:42.000000000 +0000 @@ -22,7 +22,7 @@ .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END -.TH FANOTIFY 7 2015-12-28 "Linux" "Linux Programmer's Manual" +.TH FANOTIFY 7 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME fanotify \- monitoring filesystem events .SH DESCRIPTION @@ -388,8 +388,8 @@ .I fd of process .IR pid . -See the kernel source file -.I Documentation/filesystems/proc.txt +See +.BR proc (5) for details. .SH ERRORS In addition to the usual errors for @@ -761,11 +761,11 @@ .BR fanotify_mark (2), .BR inotify (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/feature_test_macros.7 manpages-4.05/man7/feature_test_macros.7 --- manpages-4.04/man7/feature_test_macros.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/feature_test_macros.7 2016-03-15 03:47:42.000000000 +0000 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH FEATURE_TEST_MACROS 7 2015-03-29 "Linux" "Linux Programmer's Manual" +.TH FEATURE_TEST_MACROS 7 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME feature_test_macros \- feature test macros .SH SYNOPSIS @@ -122,10 +122,76 @@ feature test macro can be used to expose the function declaration, and that macro is not defined by default. .SS Feature test macros understood by glibc -The following paragraphs explain how feature test macros are handled +The paragraphs below explain how feature test macros are handled in Linux glibc 2.\fIx\fP, .I x > 0. + +First, though a summary of a few details for the impatient: +.IP * 3 +The macros that you most likely need to use in modern source code are +.BR _POSIX_C_SOURCE +(for definitions from various versions of POSIX.1), +.BR _XOPEN_SOURCE +(for definitions from various versions of SUS), +.BR _GNU_SOURCE +(for GNU and/or Linux specific stuff), and +.BR _DEFAULT_SOURCE +(to get definitions that would normally be provided by default). +.IP * +Certain macros are defined with default values. +Thus, although one or more macros may be indicated as being +required in the SYNOPSIS of a man page, +it may not be necessary to define them explicitly. +Full details of the defaults are given later in this man page. +.IP * +Defining +.BR _XOPEN_SOURCE +with a value of 600 or greater produces the same effects as defining +.BR _POSIX_C_SOURCE +with a value of 200112L or greater. +Where one sees +.RS +.nf + + _POSIX_C_SOURCE >= 200112L + +.fi +.RE +.IP +in the feature test macro requirements in the SYNOPSIS of a man page, +it is implicit that the following has the same effect: +.RS +.nf + + _XOPEN_SOURCE >= 600 + +.fi +.RE +.IP * +Defining +.BR _XOPEN_SOURCE +with a value of 700 or greater produces the same effects as defining +.BR _POSIX_C_SOURCE +with a value of 200809L or greater. +Where one sees +.RS +.nf + + _POSIX_C_SOURCE >= 200809L + +.fi +.RE +.IP +in the feature test macro requirements in the SYNOPSIS of a man page, +it is implicit that the following has the same effect: +.RS +.nf + + _XOPEN_SOURCE >= 700 + +.fi +.RE .\" The details in glibc 2.0 are simpler, but combining a .\" a description of them with the details in later glibc versions .\" would make for a complicated description. @@ -161,9 +227,11 @@ .IP \(bu (Since glibc 2.3.3) The value 200112L or greater additionally exposes definitions corresponding -to the POSIX.1-2001 base specification (excluding the XSI extension) -and also causes C95 (since glibc 2.12) and -C99 (since glibc 2.10) features to be exposed. +to the POSIX.1-2001 base specification (excluding the XSI extension). +This value also causes C95 (since glibc 2.12) and +C99 (since glibc 2.10) features to be exposed +(in other words, the equivalent of defining +.BR _ISOC99_SOURCE ). .IP \(bu (Since glibc 2.10) The value 200809L or greater additionally exposes definitions corresponding @@ -174,6 +242,10 @@ Defining this obsolete macro with any value is equivalent to defining .B _POSIX_C_SOURCE with the value 1. + +Since this macro is obsolete, +its usage is generally not documented when discussing +feature test macro requirements in the man pages. .TP .B _XOPEN_SOURCE Defining this macro causes header files to expose definitions as follows: @@ -233,15 +305,32 @@ is defined with the value 200809L. .RE .RE +.IP +In addition, defining +.BR _XOPEN_SOURCE +with a value of 500 or greater produces the same effects as defining +.BR _XOPEN_SOURCE_EXTENDED . .TP .B _XOPEN_SOURCE_EXTENDED -If this macro is defined, and +If this macro is defined, +.I and .B _XOPEN_SOURCE is defined, then expose definitions corresponding to the XPG4v2 (SUSv1) UNIX extensions (UNIX 95). -This macro is also implicitly defined if +Defining +.B _XOPEN_SOURCE +with a value of 500 or more also produces the same effect as defining +.BR _XOPEN_SOURCE_EXTENDED . +Use of +.BR _XOPEN_SOURCE_EXTENDED +in new source code should be avoided. + +Since defining .B _XOPEN_SOURCE -is defined with a value of 500 or more. +with a value of 500 or more has the same effect as defining +.BR _XOPEN_SOURCE_EXTENDED , +the latter (obsolete) feature test macro is generally not described in the +SYNOPSIS in man pages. .TP .BR _ISOC99_SOURCE " (since glibc 2.1.3)" Exposes declarations consistent with the ISO C99 standard. @@ -256,11 +345,19 @@ .B _ISOC99_SOURCE also exposes ISO C (1990) Amendment 1 ("C95") definitions. (The primary change in C95 was support for international character sets.) + +Invoking the C compiler with the option +.IR \-std=c99 +produces the same effects as defining this macro. .TP .BR _ISOC11_SOURCE " (since glibc 2.16)" Exposes declarations consistent with the ISO C11 standard. Defining this macro also enables C99 and C95 features (like .BR _ISOC99_SOURCE ). + +Invoking the C compiler with the option +.IR \-std=c11 +produces the same effects as defining this macro. .TP .B _LARGEFILE64_SOURCE Expose definitions for the alternative API specified by the @@ -381,13 +478,12 @@ without defining other individual macros or invoking the compiler in one of its "standard" modes has no effect. -The "default" definitions comprise those required by POSIX.1-2008 -as well as various definitions derived from BSD and System V. +The "default" definitions comprise those required by POSIX.1-2008 and ISO C99, +as well as various definitions originally derived from BSD and System V. On glibc 2.19 and earlier, these defaults were approximately equivalent to explicitly defining the following: cc \-D_BSD_SOURCE \-D_SVID_SOURCE \-D_POSIX_C_SOURCE=200809 - .TP .BR _ATFILE_SOURCE " (since glibc 2.4)" Defining this macro with any value causes header files to expose @@ -602,9 +698,9 @@ .BR _POSIX_SOURCE , and .BR _XOPEN_SOURCE . -.B _XOPEN_SOURCE_EXTENDED -was specified by XPG4v2 (aka SUSv1). +.B _XOPEN_SOURCE_EXTENDED +was specified by XPG4v2 (aka SUSv1), but is not present in SUSv2 and later. .B _FILE_OFFSET_BITS is not specified by any standard, but is employed on some other implementations. @@ -762,11 +858,11 @@ .I /usr/include/features.h .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/fifo.7 manpages-4.05/man7/fifo.7 --- manpages-4.04/man7/fifo.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/fifo.7 2016-03-15 03:47:42.000000000 +0000 @@ -72,11 +72,11 @@ .BR mkfifo (3), .BR pipe (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/futex.7 manpages-4.05/man7/futex.7 --- manpages-4.04/man7/futex.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/futex.7 2016-03-15 03:47:42.000000000 +0000 @@ -126,11 +126,11 @@ .UR ftp://ftp.kernel.org\:/pub\:/linux\:/kernel\:/people\:/rusty/ .UE . .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/glob.7 manpages-4.05/man7/glob.7 --- manpages-4.04/man7/glob.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/glob.7 2016-03-15 03:47:42.000000000 +0000 @@ -212,11 +212,11 @@ .BR locale (7), .BR regex (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/hier.7 manpages-4.05/man7/hier.7 --- manpages-4.04/man7/hier.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/hier.7 2016-03-15 03:47:42.000000000 +0000 @@ -649,11 +649,11 @@ The Filesystem Hierarchy Standard .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/hostname.7 manpages-4.05/man7/hostname.7 --- manpages-4.04/man7/hostname.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/hostname.7 2016-03-15 03:47:42.000000000 +0000 @@ -91,11 +91,11 @@ .\" Hostname appeared in .\" 4.2BSD. .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/icmp.7 manpages-4.05/man7/icmp.7 --- manpages-4.04/man7/icmp.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/icmp.7 2016-03-15 03:47:42.000000000 +0000 @@ -129,7 +129,6 @@ Bit definitions (see the Linux kernel source file .IR include/linux/icmp.h ): - .RS 12 .TS l l. @@ -199,11 +198,11 @@ .PP RFC\ 792 for a description of the ICMP protocol. .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/inotify.7 manpages-4.05/man7/inotify.7 --- manpages-4.04/man7/inotify.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/inotify.7 2016-03-15 03:47:42.000000000 +0000 @@ -24,7 +24,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH INOTIFY 7 2015-05-07 "Linux" "Linux Programmer's Manual" +.TH INOTIFY 7 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME inotify \- monitoring filesystem events .SH DESCRIPTION @@ -131,7 +131,7 @@ .I cookie is a unique integer that connects related events. -Currently this is used only for rename events, and +Currently, this is used only for rename events, and allows the resulting pair of .B IN_MOVED_FROM and @@ -616,6 +616,14 @@ one directory to another, events will be produced in the correct order on the inotify file descriptor. +The set of watch descriptors that is being monitored via +an inotify file descriptor can be viewed via the entry for +the inotify file descriptor in the process's +.IR /proc/[pid]/fdinfo +directory. +See +.BR proc (5) +for further details. The .B FIONREAD .BR ioctl (2) @@ -1062,11 +1070,11 @@ .IR Documentation/filesystems/inotify.txt in the Linux kernel source tree .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/intro.7 manpages-4.05/man7/intro.7 --- manpages-4.04/man7/intro.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/intro.7 2016-03-15 03:47:42.000000000 +0000 @@ -41,11 +41,11 @@ .SH SEE ALSO .BR standards (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/ip.7 manpages-4.05/man7/ip.7 --- manpages-4.04/man7/ip.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/ip.7 2016-03-15 03:47:42.000000000 +0000 @@ -33,7 +33,7 @@ .\" commit 76e21053b5bf33a07c76f99d27a74238310e3c71 .\" Author: Erich E. Hoover .\" -.TH IP 7 2015-05-07 "Linux" "Linux Programmer's Manual" +.TH IP 7 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME ip \- Linux IPv4 protocol implementation .SH SYNOPSIS @@ -338,6 +338,16 @@ This option can be used multiple times to allow receiving data from more than one source. .TP +.BR IP_BIND_ADDRESS_NO_PORT " (since Linux 4.2)" +.\" commit 90c337da1524863838658078ec34241f45d8394d +Inform the kernel to not reserve an ephemeral port when using +.BR bind (2) +with a port number of 0. +The port will later be automatically chosen at +.BR connect (2) +time, +in a way that allows sharing a source port as long as the 4-tuple is unique. +.TP .BR IP_BLOCK_SOURCE " (since Linux 2.4.22 / 2.5.68)" Stop receiving multicast data from a specific source in a given group. This is valid only after the application has subscribed @@ -1306,11 +1316,11 @@ RFC\ 1122 for the IPv4 host requirements. RFC\ 1812 for the IPv4 router requirements. .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/ipv6.7 manpages-4.05/man7/ipv6.7 --- manpages-4.04/man7/ipv6.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/ipv6.7 2016-03-15 03:47:42.000000000 +0000 @@ -422,11 +422,11 @@ Linux tries to be compliant to this. RFC\ 2460: IPv6 specification. .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/iso_8859-10.7 manpages-4.05/man7/iso_8859-10.7 --- manpages-4.04/man7/iso_8859-10.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/iso_8859-10.7 2016-03-15 03:47:42.000000000 +0000 @@ -164,11 +164,11 @@ .BR charsets (7), .BR utf-8 (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/iso_8859-11.7 manpages-4.05/man7/iso_8859-11.7 --- manpages-4.04/man7/iso_8859-11.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/iso_8859-11.7 2016-03-15 03:47:42.000000000 +0000 @@ -161,11 +161,11 @@ .BR charsets (7), .BR utf-8 (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/iso_8859-13.7 manpages-4.05/man7/iso_8859-13.7 --- manpages-4.04/man7/iso_8859-13.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/iso_8859-13.7 2016-03-15 03:47:42.000000000 +0000 @@ -164,11 +164,11 @@ .BR charsets (7), .BR utf-8 (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/iso_8859-14.7 manpages-4.05/man7/iso_8859-14.7 --- manpages-4.04/man7/iso_8859-14.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/iso_8859-14.7 2016-03-15 03:47:42.000000000 +0000 @@ -164,11 +164,11 @@ .BR charsets (7), .BR utf-8 (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/iso_8859-15.7 manpages-4.05/man7/iso_8859-15.7 --- manpages-4.04/man7/iso_8859-15.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/iso_8859-15.7 2016-03-15 03:47:42.000000000 +0000 @@ -166,11 +166,11 @@ .BR iso_8859-1 (7), .BR utf-8 (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/iso_8859-16.7 manpages-4.05/man7/iso_8859-16.7 --- manpages-4.04/man7/iso_8859-16.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/iso_8859-16.7 2016-03-15 03:47:42.000000000 +0000 @@ -165,11 +165,11 @@ .BR iso_8859-3 (7), .BR utf-8 (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/iso_8859-1.7 manpages-4.05/man7/iso_8859-1.7 --- manpages-4.04/man7/iso_8859-1.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/iso_8859-1.7 2016-03-15 03:47:42.000000000 +0000 @@ -167,11 +167,11 @@ .BR iso_8859-15 (7), .BR utf-8 (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/iso_8859-2.7 manpages-4.05/man7/iso_8859-2.7 --- manpages-4.04/man7/iso_8859-2.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/iso_8859-2.7 2016-03-15 03:47:42.000000000 +0000 @@ -169,11 +169,11 @@ .BR iso_8859-16 (7), .BR utf-8 (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/iso_8859-3.7 manpages-4.05/man7/iso_8859-3.7 --- manpages-4.04/man7/iso_8859-3.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/iso_8859-3.7 2016-03-15 03:47:42.000000000 +0000 @@ -157,11 +157,11 @@ .BR charsets (7), .BR utf-8 (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/iso_8859-4.7 manpages-4.05/man7/iso_8859-4.7 --- manpages-4.04/man7/iso_8859-4.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/iso_8859-4.7 2016-03-15 03:47:42.000000000 +0000 @@ -164,11 +164,11 @@ .BR charsets (7), .BR utf-8 (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/iso_8859-5.7 manpages-4.05/man7/iso_8859-5.7 --- manpages-4.04/man7/iso_8859-5.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/iso_8859-5.7 2016-03-15 03:47:42.000000000 +0000 @@ -168,11 +168,11 @@ .BR koi8-u (7), .BR utf-8 (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/iso_8859-6.7 manpages-4.05/man7/iso_8859-6.7 --- manpages-4.04/man7/iso_8859-6.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/iso_8859-6.7 2016-03-15 03:47:42.000000000 +0000 @@ -120,11 +120,11 @@ .BR charsets (7), .BR utf-8 (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/iso_8859-7.7 manpages-4.05/man7/iso_8859-7.7 --- manpages-4.04/man7/iso_8859-7.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/iso_8859-7.7 2016-03-15 03:47:42.000000000 +0000 @@ -168,11 +168,11 @@ .BR charsets (7), .BR utf-8 (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/iso_8859-8.7 manpages-4.05/man7/iso_8859-8.7 --- manpages-4.04/man7/iso_8859-8.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/iso_8859-8.7 2016-03-15 03:47:42.000000000 +0000 @@ -132,11 +132,11 @@ .BR charsets (7), .BR utf-8 (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/iso_8859-9.7 manpages-4.05/man7/iso_8859-9.7 --- manpages-4.04/man7/iso_8859-9.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/iso_8859-9.7 2016-03-15 03:47:42.000000000 +0000 @@ -164,11 +164,11 @@ .BR charsets (7), .BR utf-8 (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/koi8-r.7 manpages-4.05/man7/koi8-r.7 --- manpages-4.04/man7/koi8-r.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/koi8-r.7 2016-03-15 03:47:42.000000000 +0000 @@ -186,11 +186,11 @@ .BR koi8-u (7), .BR utf-8 (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/koi8-u.7 manpages-4.05/man7/koi8-u.7 --- manpages-4.04/man7/koi8-u.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/koi8-u.7 2016-03-15 03:47:42.000000000 +0000 @@ -192,11 +192,11 @@ .BR koi8-r (7), .BR utf-8 (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/libc.7 manpages-4.05/man7/libc.7 --- manpages-4.04/man7/libc.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/libc.7 2016-03-15 03:47:42.000000000 +0000 @@ -112,11 +112,11 @@ .BR standards (7), .BR vdso (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/locale.7 manpages-4.05/man7/locale.7 --- manpages-4.04/man7/locale.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/locale.7 2016-03-15 03:47:42.000000000 +0000 @@ -395,11 +395,11 @@ .BR unicode (7), .BR utf-8 (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/mailaddr.7 manpages-4.05/man7/mailaddr.7 --- manpages-4.04/man7/mailaddr.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/mailaddr.7 2016-03-15 03:47:42.000000000 +0000 @@ -125,11 +125,11 @@ RFC\ 2822 (Internet Message Format) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/man.7 manpages-4.05/man7/man.7 --- manpages-4.04/man7/man.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/man.7 2016-03-15 03:47:42.000000000 +0000 @@ -570,11 +570,11 @@ .BR mdoc (7), .BR mdoc.samples (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/man-pages.7 manpages-4.05/man7/man-pages.7 --- manpages-4.04/man7/man-pages.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/man-pages.7 2016-03-15 03:47:42.000000000 +0000 @@ -601,7 +601,7 @@ For example: .SS Unicode under Linux - +.\" .SS Indentation of structure definitions, shell session logs, and so on When structure definitions, shell session logs, and so on are included in running text, indent them by 4 spaces (i.e., a block enclosed by @@ -913,11 +913,11 @@ .BR man (7), .BR mdoc (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/math_error.7 manpages-4.05/man7/math_error.7 --- manpages-4.04/man7/math_error.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/math_error.7 2016-03-15 03:47:42.000000000 +0000 @@ -265,11 +265,11 @@ .I "info libc" .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/mdoc.7 manpages-4.05/man7/mdoc.7 --- manpages-4.04/man7/mdoc.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/mdoc.7 2016-03-15 03:47:42.000000000 +0000 @@ -431,11 +431,11 @@ .Xr man 7 , .Xr man-pages 7 .Sh COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .Em man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/mdoc.samples.7 manpages-4.05/man7/mdoc.samples.7 --- manpages-4.04/man7/mdoc.samples.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/mdoc.samples.7 2016-03-15 03:47:42.000000000 +0000 @@ -2955,11 +2955,11 @@ .Xr groff_mdoc 7 , .Xr mdoc 7 .Sh COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .Em man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/mq_overview.7 manpages-4.05/man7/mq_overview.7 --- manpages-4.04/man7/mq_overview.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/mq_overview.7 2016-03-15 03:47:42.000000000 +0000 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH MQ_OVERVIEW 7 2015-08-08 "Linux" "Linux Programmer's Manual" +.TH MQ_OVERVIEW 7 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME mq_overview \- overview of POSIX message queues .SH DESCRIPTION @@ -74,8 +74,8 @@ .BR fork (2), a child inherits copies of its parent's message queue descriptors, and these descriptors refer to the same open message queue descriptions -as the corresponding descriptors in the parent. -Corresponding descriptors in the two processes share the flags +as the corresponding message queue descriptors in the parent. +Corresponding message queue descriptors in the two processes share the flags .RI ( mq_flags ) that are associated with the open message queue description. @@ -336,14 +336,20 @@ .B SIGNO Signal number to be used for .BR SIGEV_SIGNAL . -.SS Polling message queue descriptors -On Linux, a message queue descriptor is actually a file descriptor, -and can be monitored using +.SS Linux implementation of message queue descriptors +On Linux, a message queue descriptor is actually a file descriptor. +(POSIX does not require such an implementation.) +This means that a message queue descriptor can be monitored using .BR select (2), .BR poll (2), or .BR epoll (7). This is not portable. + +The close-on-exec flag (see +.BR open (2)) +is automatically set on the file descriptor returned by +.BR mq_open (2). .SS IPC namespaces For a discussion of the interaction of System V IPC objects and IPC namespaces, see @@ -402,11 +408,11 @@ .BR epoll (7), .BR namespaces (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/namespaces.7 manpages-4.05/man7/namespaces.7 --- manpages-4.04/man7/namespaces.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/namespaces.7 2016-03-15 03:47:42.000000000 +0000 @@ -24,7 +24,7 @@ .\" %%%LICENSE_END .\" .\" -.TH NAMESPACES 7 2014-09-21 "Linux" "Linux Programmer's Manual" +.TH NAMESPACES 7 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME namespaces \- overview of Linux namespaces .SH DESCRIPTION @@ -362,6 +362,7 @@ See .BR user_namespaces (7). .SH SEE ALSO +.BR lsns (1), .BR nsenter (1), .BR readlink (1), .BR unshare (1), @@ -375,11 +376,11 @@ .BR user_namespaces (7), .BR switch_root (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/netdevice.7 manpages-4.05/man7/netdevice.7 --- manpages-4.04/man7/netdevice.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/netdevice.7 2016-03-15 03:47:42.000000000 +0000 @@ -376,11 +376,11 @@ .BR ip (7), .BR rtnetlink (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/netlink.7 manpages-4.05/man7/netlink.7 --- manpages-4.04/man7/netlink.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/netlink.7 2016-03-15 03:47:42.000000000 +0000 @@ -194,7 +194,6 @@ NLM_F_ACK:Request for an acknowledgment on success. NLM_F_ECHO:Echo this request. .TE -.sp 1 .\" No right adjustment for text blocks in tables .TS tab(:); @@ -487,11 +486,11 @@ RFC 3549 "Linux Netlink as an IP Services Protocol" .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/nptl.7 manpages-4.05/man7/nptl.7 --- manpages-4.04/man7/nptl.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/nptl.7 2016-03-15 03:47:42.000000000 +0000 @@ -131,11 +131,11 @@ .BR signal (7), .BR standards (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/numa.7 manpages-4.05/man7/numa.7 --- manpages-4.04/man7/numa.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/numa.7 2016-03-15 03:47:42.000000000 +0000 @@ -189,11 +189,11 @@ .BR cpuset (7), .BR numactl (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/operator.7 manpages-4.05/man7/operator.7 --- manpages-4.04/man7/operator.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/operator.7 2016-03-15 03:47:42.000000000 +0000 @@ -63,11 +63,11 @@ .fi .\" .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/packet.7 manpages-4.05/man7/packet.7 --- manpages-4.04/man7/packet.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/packet.7 2016-03-15 03:47:42.000000000 +0000 @@ -656,11 +656,11 @@ and .BR PACKET_TX_RING . .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/path_resolution.7 manpages-4.05/man7/path_resolution.7 --- manpages-4.04/man7/path_resolution.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/path_resolution.7 2016-03-15 03:47:42.000000000 +0000 @@ -124,7 +124,6 @@ was reworked to eliminate the use of recursion, so that the only limit that remains is the maximum of 40 resolutions for the entire pathname. - .SS Step 3: find the final entry The lookup of the final component of the pathname goes just like that of all other components, as described in the previous step, @@ -258,11 +257,11 @@ .BR credentials (7), .BR symlink (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/pid_namespaces.7 manpages-4.05/man7/pid_namespaces.7 --- manpages-4.04/man7/pid_namespaces.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/pid_namespaces.7 2016-03-15 03:47:42.000000000 +0000 @@ -363,11 +363,11 @@ .BR user_namespaces (7), .BR switch_root (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/pipe.7 manpages-4.05/man7/pipe.7 --- manpages-4.04/man7/pipe.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/pipe.7 2016-03-15 03:47:42.000000000 +0000 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH PIPE 7 2015-12-05 "Linux" "Linux Programmer's Manual" +.TH PIPE 7 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME pipe \- overview of pipes and FIFOs .SH DESCRIPTION @@ -143,7 +143,7 @@ See .BR fcntl (2) for more information. - +.\" .SS PIPE_BUF POSIX.1 says that .BR write (2)s @@ -227,10 +227,11 @@ .B O_ASYNC flag for the read end of a pipe causes a signal .RB ( SIGIO -by default) to be generated when new input becomes available on the pipe -(see +by default) to be generated when new input becomes available on the pipe. +The target for delivery of signals must be set using the .BR fcntl (2) -for details). +.B F_SETOWN +command. On Linux, .B O_ASYNC is supported for pipes and FIFOs only since kernel 2.6. @@ -241,6 +242,7 @@ Portable applications should avoid reliance on bidirectional pipe semantics. .SH SEE ALSO +.BR mkfifo (1), .BR dup (2), .BR fcntl (2), .BR open (2), @@ -254,11 +256,11 @@ .BR epoll (7), .BR fifo (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/posixoptions.7 manpages-4.05/man7/posixoptions.7 --- manpages-4.04/man7/posixoptions.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/posixoptions.7 2016-03-15 03:47:42.000000000 +0000 @@ -855,11 +855,11 @@ .BR sysconf (3), .BR standards (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/pthreads.7 manpages-4.05/man7/pthreads.7 --- manpages-4.04/man7/pthreads.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/pthreads.7 2016-03-15 03:47:42.000000000 +0000 @@ -934,11 +934,11 @@ and .BR pthread_testcancel (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/pty.7 manpages-4.05/man7/pty.7 --- manpages-4.04/man7/pty.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/pty.7 2016-03-15 03:47:42.000000000 +0000 @@ -166,11 +166,11 @@ .BR tty (4), .BR tty_ioctl (4) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/raw.7 manpages-4.05/man7/raw.7 --- manpages-4.04/man7/raw.7 2015-12-29 12:51:50.000000000 +0000 +++ manpages-4.05/man7/raw.7 2016-03-15 03:47:42.000000000 +0000 @@ -286,11 +286,11 @@ .I header file for the IP protocol. .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/regex.7 manpages-4.05/man7/regex.7 --- manpages-4.04/man7/regex.7 2015-12-29 12:51:51.000000000 +0000 +++ manpages-4.05/man7/regex.7 2016-03-15 03:47:42.000000000 +0000 @@ -290,11 +290,11 @@ .PP POSIX.2, section 2.8 (Regular Expression Notation). .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/rtld-audit.7 manpages-4.05/man7/rtld-audit.7 --- manpages-4.04/man7/rtld-audit.7 2015-12-29 12:51:51.000000000 +0000 +++ manpages-4.05/man7/rtld-audit.7 2016-03-15 03:47:42.000000000 +0000 @@ -605,11 +605,11 @@ .BR ld.so (8), .BR ldconfig (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/rtnetlink.7 manpages-4.05/man7/rtnetlink.7 --- manpages-4.04/man7/rtnetlink.7 2015-12-29 12:51:51.000000000 +0000 +++ manpages-4.05/man7/rtnetlink.7 2016-03-15 03:47:42.000000000 +0000 @@ -463,11 +463,11 @@ .BR ip (7), .BR netlink (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/sched.7 manpages-4.05/man7/sched.7 --- manpages-4.04/man7/sched.7 2015-12-29 12:51:51.000000000 +0000 +++ manpages-4.05/man7/sched.7 2016-03-15 03:47:42.000000000 +0000 @@ -699,11 +699,11 @@ and .IR Documentation/scheduler/sched-nice-design.txt .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/sem_overview.7 manpages-4.05/man7/sem_overview.7 --- manpages-4.04/man7/sem_overview.7 2015-12-29 12:51:51.000000000 +0000 +++ manpages-4.05/man7/sem_overview.7 2016-03-15 03:47:42.000000000 +0000 @@ -158,11 +158,11 @@ .BR sem_wait (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/shm_overview.7 manpages-4.05/man7/shm_overview.7 --- manpages-4.04/man7/shm_overview.7 2015-12-29 12:51:51.000000000 +0000 +++ manpages-4.05/man7/shm_overview.7 2016-03-15 03:47:42.000000000 +0000 @@ -123,11 +123,11 @@ .BR shm_unlink (3), .BR sem_overview (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/sigevent.7 manpages-4.05/man7/sigevent.7 --- manpages-4.04/man7/sigevent.7 2015-12-29 12:51:51.000000000 +0000 +++ manpages-4.05/man7/sigevent.7 2016-03-15 03:47:42.000000000 +0000 @@ -138,11 +138,11 @@ .BR aio (7), .BR pthreads (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/signal.7 manpages-4.05/man7/signal.7 --- manpages-4.04/man7/signal.7 2015-12-29 12:51:51.000000000 +0000 +++ manpages-4.05/man7/signal.7 2016-03-15 03:47:42.000000000 +0000 @@ -43,7 +43,7 @@ .\" Added section on stop/cont signals interrupting syscalls. .\" 2008-10-05, mtk: various additions .\" -.TH SIGNAL 7 2015-12-05 "Linux" "Linux Programmer's Manual" +.TH SIGNAL 7 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME signal \- overview of signals .SH DESCRIPTION @@ -474,7 +474,14 @@ POSIX has the concept of "safe function". If a signal interrupts the execution of an unsafe function, and .I handler -calls an unsafe function, then the behavior of the program is undefined. +either calls an unsafe function or +.I handler +terminates via a call to +.BR longjmp () +or +.BR siglongjmp () +and the program subsequently calls an unsafe function, +then the behavior of the program is undefined. POSIX.1-2004 (also known as POSIX.1-2001 Technical Corrigendum 2) requires an implementation to guarantee that the following @@ -642,6 +649,8 @@ pthread_sigmask() .fi .in +.\" FIXME POSIX.1-2008 TC 2 looks set to add many more async-signal-safe +.\" functions .SS Interruption of system calls and library functions by signal handlers If a signal handler is invoked while a system call or library function call is blocked, then either: @@ -951,11 +960,11 @@ .BR pthreads (7), .BR sigevent (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/socket.7 manpages-4.05/man7/socket.7 --- manpages-4.04/man7/socket.7 2015-12-29 12:51:51.000000000 +0000 +++ manpages-4.05/man7/socket.7 2016-03-15 03:47:42.000000000 +0000 @@ -41,21 +41,17 @@ .\" SO_GET_FILTER (3.8) .\" commit a8fc92778080c845eaadc369a0ecf5699a03bef0 .\" Author: Pavel Emelyanov -.\" SO_LOCK_FILTER (3.9) -.\" commit d59577b6ffd313d0ab3be39cb1ab47e29bdc9182 -.\" Author: Vincent Bernat .\" SO_SELECT_ERR_QUEUE (3.10) .\" commit 7d4c04fc170087119727119074e72445f2bb192b .\" Author: Keller, Jacob E .\" SO_MAX_PACING_RATE (3.13) .\" commit 62748f32d501f5d3712a7c372bbb92abc7c62bc7 +.\" Author: Eric Dumazet .\" SO_BPF_EXTENSIONS (3.14) .\" commit ea02f9411d9faa3553ed09ce0ec9f00ceae9885e -.\" SO_ATTACH_BPF (3.19) -.\" and SO_DETACH_BPF as synonym for SO_DETACH_FILTER -.\" commit 89aa075832b0da4402acebd698d0411dcc82d03e +.\" Author: Michal Sekletar .\" -.TH SOCKET 7 2015-05-07 Linux "Linux Programmer's Manual" +.TH SOCKET 7 2016-03-15 Linux "Linux Programmer's Manual" .SH NAME socket \- Linux socket interface .SH SYNOPSIS @@ -188,7 +184,7 @@ Socket has enough send buffer space for writing new data. T} Read/Write:T{ -POLLIN| +POLLIN | .br POLLOUT T}:T{ @@ -305,6 +301,97 @@ the value 1 indicates that this is a listening socket. This socket option is read-only. .TP +.BR SO_ATTACH_FILTER " (since Linux 2.2), " SO_ATTACH_BPF " (since Linux 3.19)" +Attach a classic BPF +.RB ( SO_ATTACH_FILTER ) +or an extended BPF +.RB ( SO_ATTACH_BPF ) +program to the socket for use as a filter of incoming packets. +A packet will be dropped if the filter program returns zero. +If the filter program returns a +non-zero value which is less than the packet's data length, +the packet will be truncated to the length returned. +If the value returned by the filter is greater than or equal to the +packet's data length, the packet is allowed to proceed unmodified. + +The argument for +.BR SO_ATTACH_FILTER +is a +.I sock_fprog +structure, defined in +.IR : +.sp +.in +4n +.nf +struct sock_fprog { + unsigned short len; + struct sock_filter *filter; +}; +.fi +.in +.IP +The argument for +.BR SO_ATTACH_BPF +is a file descriptor returned by the +.BR bpf (2) +system call and must refer to a program of type +.BR BPF_PROG_TYPE_SOCKET_FILTER. + +These options may be set multiple times for a given socket, +each time replacing the previous filter program. +The classic and extended versions may be called on the same socket, +but the previous filter will always be replaced such that a socket +never has more than one filter defined. + +Both classic and extended BPF are explained in the kernel source file +.I Documentation/networking/filter.txt +.TP +.BR SO_ATTACH_REUSEPORT_CBPF ", " SO_ATTACH_REUSEPORT_EBPF +For use with the +.BR SO_REUSEPORT +option, these options allow the user to set a classic BPF +.RB ( SO_ATTACH_REUSEPORT_CBPF ) +or an extended BPF +.RB ( SO_ATTACH_REUSEPORT_EBPF ) +program which defines how packets are assigned to +the sockets in the reuseport group (that is, all sockets which have +.BR SO_REUSEPORT +set and are using the same local address to receive packets). + +The BPF program must return an index between 0 and N\-1 representing +the socket which should receive the packet +(where N is the number of sockets in the group). +If the BPF program returns an invalid index, +socket selection will fall back to the plain +.BR SO_REUSEPORT +mechanism. + +Sockets are numbered in the order in which they are added to the group +(that is, the order of +.BR bind (2) +calls for UDP sockets or the order of +.BR listen (2) +calls for TCP sockets). +New sockets added to a reuseport group will inherit the BPF program. +When a socket is removed from a reuseport group (via +.BR close (2)), +the last socket in the group will be moved into the closed socket's +position. + +These options may be set repeatedly at any time on any socket in the group +to replace the current BPF program used by all sockets in the group. + +.BR SO_ATTACH_REUSEPORT_CBPF +takes the same argument type as +.BR SO_ATTACH_FILTER +and +.BR SO_ATTACH_REUSEPORT_EBPF +takes the same argument type as +.BR SO_ATTACH_BPF. + +UDP support for this feature is available since Linux 4.5; +TCP support is available since Linux 4.6. +.TP .B SO_BINDTODEVICE Bind this socket to a particular device like \(lqeth0\(rq, as specified in the passed interface name. @@ -362,6 +449,15 @@ .B CAP_NET_ADMIN capability or an effective user ID of 0. .TP +.BR SO_DETACH_FILTER " (since Linux 2.2), " SO_DETACH_BPF " (since Linux 3.19)" +These two options, which are synonyms, +may be used to remove the classic or extended BPF +program attached to a socket with either +.BR SO_ATTACH_FILTER +or +.BR SO_ATTACH_BPF . +The option value is ignored. +.TP .BR SO_DOMAIN " (since Linux 2.6.32)" Retrieves the socket domain as an integer, returning a value such as .BR AF_INET6 . @@ -417,6 +513,34 @@ .BR exit (2), it always lingers in the background. .TP +.B SO_LOCK_FILTER +.\" commit d59577b6ffd313d0ab3be39cb1ab47e29bdc9182 +When set, this option will prevent +changing the filters associated with the socket. +These filters include any set using the socket options +.BR SO_ATTACH_FILTER, +.BR SO_ATTACH_BPF, +.BR SO_ATTACH_REUSEPORT_CBPF +and +.BR SO_ATTACH_REUSEPORT_EPBF . + +The typical use case is for a privileged process to set up a raw socket +(an operation that requires the +.BR CAP_NET_RAW +capability), apply a restrictive filter, set the +.BR SO_LOCK_FILTER +option, +and then either drop its privileges or pass the socket file descriptor +to an unprivileged process via a UNIX domain socket. + +Once the +.BR SO_LOCK_FILTER +option has been enabled, attempts to change or remove the filter +attached to a socket, or to disable the +.BR SO_LOCK_FILTER +option will fail with the error +.BR EPERM . +.TP .BR SO_MARK " (since Linux 2.6.25)" .\" commit 4a19ec5800fc3bb64e2d87c4d9fdd9e636086fe0 .\" and 914a9ab386a288d0f22252fc268ecbc048cdcbd5 @@ -500,7 +624,6 @@ Suppose a stream socket has the following queued input data: aabbccddeeff - .IP The following sequence of .BR recv (2) @@ -986,38 +1109,30 @@ option. Typically this difference is invisible, since, for example, a server program is designed to always set this option. -.SH BUGS -The -.B CONFIG_FILTER -socket options -.B SO_ATTACH_FILTER -and -.B SO_DETACH_FILTER -.\" FIXME Document SO_ATTACH_FILTER and SO_DETACH_FILTER -are not documented. -The suggested interface to use them is via the libpcap -library. .\" .SH AUTHORS .\" This man page was written by Andi Kleen. .SH SEE ALSO +.BR wireshark (1), .BR bpf (2), .BR connect (2), .BR getsockopt (2), .BR setsockopt (2), .BR socket (2), +.BR pcap (3), .BR capabilities (7), .BR ddp (7), .BR ip (7), .BR packet (7), .BR tcp (7), .BR udp (7), -.BR unix (7) +.BR unix (7), +.BR tcpdump (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/spufs.7 manpages-4.05/man7/spufs.7 --- manpages-4.04/man7/spufs.7 2015-12-29 12:51:51.000000000 +0000 +++ manpages-4.05/man7/spufs.7 2016-03-15 03:47:42.000000000 +0000 @@ -771,11 +771,11 @@ .I The Cell Broadband Engine Architecture (CBEA) specification .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/standards.7 manpages-4.05/man7/standards.7 --- manpages-4.04/man7/standards.7 2015-12-29 12:51:51.000000000 +0000 +++ manpages-4.05/man7/standards.7 2016-03-15 03:47:42.000000000 +0000 @@ -21,7 +21,7 @@ .\" . .\" %%%LICENSE_END .\" -.TH STANDARDS 7 2015-03-02 "Linux" "Linux Programmer's Manual" +.TH STANDARDS 7 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME standards \- C and UNIX Standards .SH DESCRIPTION @@ -236,9 +236,9 @@ Two Technical Corrigenda (minor fixes and improvements) of the original 2001 standard have occurred: -TC1 in 2003 (referred to as +TC1 in 2003 (also known as .IR POSIX.1-2003 ), -and TC2 in 2004 (referred to as +and TC2 in 2004 (also known as .IR POSIX.1-2004 ). .TP .B POSIX.1-2008, SUSv4 @@ -268,9 +268,14 @@ Technical Corrigendum 1 (minor fixes and improvements) of this standard was released in 2013 -(referred to as +(also known as .IR POSIX.1-2013 ). +.\" FIXME . change wording here once standard is released +Technical Corrigendum 2 of this standard is set to be released in 2016 +(also known as +.IR POSIX.1-2016 ). + Further information can be found on the Austin Group web site, .UR http://www.opengroup.org\:/austin/ .UE . @@ -280,11 +285,11 @@ .BR libc (7), .BR posixoptions (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/suffixes.7 manpages-4.05/man7/suffixes.7 --- manpages-4.04/man7/suffixes.7 2015-12-29 12:51:51.000000000 +0000 +++ manpages-4.05/man7/suffixes.7 2016-03-15 03:47:42.000000000 +0000 @@ -281,11 +281,11 @@ .BR file (1), .BR make (1) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/svipc.7 manpages-4.05/man7/svipc.7 --- manpages-4.04/man7/svipc.7 2015-12-29 12:51:51.000000000 +0000 +++ manpages-4.05/man7/svipc.7 2016-03-15 03:47:42.000000000 +0000 @@ -37,7 +37,7 @@ .\" * The only part that uniquely belongs in svipc(7) is perhaps .\" the discussion of ipc_perm. .\" -.TH SVIPC 7 2014-09-21 "Linux" "Linux Programmer's Manual" +.TH SVIPC 7 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME svipc \- System V interprocess communication mechanisms .SH SYNOPSIS @@ -245,7 +245,7 @@ struct sem { int semval; /* semaphore value */ - int sempid; /* PID for last operation */ + int sempid; /* PID of process that last modified */ .\" unsigned short semncnt; /* nr awaiting semval to increase */ .\" unsigned short semzcnt; /* nr awaiting semval = 0 */ }; @@ -256,8 +256,8 @@ Semaphore value: a nonnegative integer. .TP .I sempid -ID of the last process that performed a semaphore operation -on this semaphore. +PID of the last process that modified the value of +this semaphore. .\".TP .\".I semncnt .\"Number of processes suspended awaiting for @@ -336,6 +336,7 @@ .BR ipcmk (1), .BR ipcrm (1), .BR ipcs (1), +.BR lsipc (1), .BR ipc (2), .BR msgctl (2), .BR msgget (2), @@ -351,11 +352,11 @@ .BR ftok (3), .BR namespaces (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/symlink.7 manpages-4.05/man7/symlink.7 --- manpages-4.04/man7/symlink.7 2015-12-29 12:51:51.000000000 +0000 +++ manpages-4.05/man7/symlink.7 2016-03-15 03:47:42.000000000 +0000 @@ -34,7 +34,7 @@ .\" 2008-06-11, mtk, Taken from FreeBSD 6.2 and heavily edited for .\" specific Linux details, improved readability, and man-pages style. .\" -.TH SYMLINK 7 2015-08-08 "Linux" "Linux Programmer's Manual" +.TH SYMLINK 7 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME symlink \- symbolic link handling .SH DESCRIPTION @@ -104,6 +104,11 @@ 0777 (read, write, and execute for all user categories), .\" Linux does not currently implement an lchmod(2). and can't be changed. +(Note that there are some "magic" symbolic links in the +.I /proc +directory tree\(emfor example, the +.IR /proc/PID/fd/* +files\(emthat have different permissions.) .\" .\" The .\" 4.4BSD @@ -527,11 +532,11 @@ .BR lutimes (3), .BR path_resolution (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/tcp.7 manpages-4.05/man7/tcp.7 --- manpages-4.04/man7/tcp.7 2015-12-29 12:51:51.000000000 +0000 +++ manpages-4.05/man7/tcp.7 2016-03-15 03:47:42.000000000 +0000 @@ -75,6 +75,12 @@ .\" TCP_NOTSENT_LOWAT (3.12) .\" commit c9bee3b7fdecb0c1d070c7b54113b3bdfb9a3d36 .\" Author: Eric Dumazet +.\" TCP_CC_INFO (4.1) +.\" commit 6e9250f59ef9efb932c84850cd221f22c2a03c4a +.\" Author: Eric Dumazet +.\" TCP_SAVE_SYN, TCP_SAVED_SYN (4.2) +.\" commit cd8ae85299d54155702a56811b2e035e63064d3d +.\" Author: Eric Dumazet .\" .TH TCP 7 2015-12-05 "Linux" "Linux Programmer's Manual" .SH NAME @@ -1332,11 +1338,11 @@ .br RFC\ 2018 and RFC\ 2883 for SACK and extensions to SACK. .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/termio.7 manpages-4.05/man7/termio.7 --- manpages-4.04/man7/termio.7 2015-12-29 12:51:51.000000000 +0000 +++ manpages-4.05/man7/termio.7 2016-03-15 03:47:42.000000000 +0000 @@ -64,11 +64,11 @@ .BR tty (4), .BR tty_ioctl (4) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/time.7 manpages-4.05/man7/time.7 --- manpages-4.04/man7/time.7 2015-12-29 12:51:51.000000000 +0000 +++ manpages-4.05/man7/time.7 2016-03-15 03:47:42.000000000 +0000 @@ -25,7 +25,7 @@ .\" 2008-06-24, mtk: added some details about where jiffies come into .\" play; added section on high-resolution timers. .\" -.TH TIME 7 2012-10-28 "Linux" "Linux Programmer's Manual" +.TH TIME 7 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME time \- overview of time and timers .SH DESCRIPTION @@ -190,6 +190,7 @@ .nh .BR date (1), .BR time (1), +.BR timeout (1), .BR adjtimex (2), .BR alarm (2), .BR clock_gettime (2), @@ -209,6 +210,8 @@ .BR clock (3), .BR clock_getcpuclockid (3), .BR ctime (3), +.BR ntp_adjtime (3), +.BR ntp_gettime (3), .BR pthread_getcpuclockid (3), .BR sleep (3), .BR strftime (3), @@ -218,11 +221,11 @@ .BR rtc (4), .BR hwclock (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/udp.7 manpages-4.05/man7/udp.7 --- manpages-4.04/man7/udp.7 2015-12-29 12:51:51.000000000 +0000 +++ manpages-4.05/man7/udp.7 2016-03-15 03:47:42.000000000 +0000 @@ -265,11 +265,11 @@ .br RFC\ 1191 for a description of path MTU discovery. .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/udplite.7 manpages-4.05/man7/udplite.7 --- manpages-4.04/man7/udplite.7 2015-12-29 12:51:51.000000000 +0000 +++ manpages-4.05/man7/udplite.7 2016-03-15 03:47:42.000000000 +0000 @@ -154,11 +154,11 @@ .I Documentation/networking/udplite.txt in the Linux kernel source tree .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/unicode.7 manpages-4.05/man7/unicode.7 --- manpages-4.04/man7/unicode.7 2015-12-29 12:51:51.000000000 +0000 +++ manpages-4.05/man7/unicode.7 2016-03-15 03:47:42.000000000 +0000 @@ -26,9 +26,9 @@ .\" 2001-05-11 Markus Kuhn .\" Update .\" -.TH UNICODE 7 2014-06-13 "GNU" "Linux Programmer's Manual" +.TH UNICODE 7 2016-03-15 "GNU" "Linux Programmer's Manual" .SH NAME -Unicode \- universal character set +unicode \- universal character set .SH DESCRIPTION The international standard ISO 10646 defines the Universal Character Set (UCS). @@ -191,7 +191,7 @@ tells, how many positions (0\(en2) the cursor is advanced by the output of a character. .PP -.SS Private area +.SS Private Use Areas (PUA) In the Basic Multilingual Plane, the range 0xe000 to 0xf8ff will never be assigned to any characters by the standard and is reserved for private usage. @@ -205,6 +205,11 @@ itself is .I Documentation/unicode.txt in the Linux kernel sources. +.PP +Two other planes are reserved for private usage, plane 15 +(Supplementary Private Use Area-A, range 0xf0000 to 0xffffd) +and plane 16 (Supplementary Private Use Area-B, range +0x100000 to 0x10fffd). .SS Literature .IP * 3 Information technology \(em Universal Multiple-Octet Coded Character @@ -256,11 +261,11 @@ .BR charsets (7), .BR utf-8 (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/units.7 manpages-4.05/man7/units.7 --- manpages-4.04/man7/units.7 2015-12-29 12:51:51.000000000 +0000 +++ manpages-4.05/man7/units.7 2016-03-15 03:47:42.000000000 +0000 @@ -25,7 +25,7 @@ .\" .TH UNITS 7 2012-08-05 "Linux" "Linux Programmer's Manual" .SH NAME -units, kilo, kibi, mega, mebi, giga, gibi \- decimal and binary prefixes +units \- decimal and binary prefixes .SH DESCRIPTION .SS Decimal prefixes The SI system of units uses prefixes that indicate powers of ten. @@ -128,11 +128,11 @@ the MB are megabytes and the KiB are kibibytes. .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/unix.7 manpages-4.05/man7/unix.7 --- manpages-4.04/man7/unix.7 2015-12-29 12:51:51.000000000 +0000 +++ manpages-4.05/man7/unix.7 2016-03-15 03:47:42.000000000 +0000 @@ -1,8 +1,8 @@ -.\" This man page is Copyright (C) 1999 Andi Kleen . -.\" and Copyright (C) 2008-2014, Michael Kerrisk +.\" This man page is Copyright (C) 1999 Andi Kleen , +.\" Copyright (C) 2008-2014, Michael Kerrisk , +.\" and Copyright (C) 2016, Heinrich Schuchardt .\" .\" %%%LICENSE_START(VERBATIM_ONE_PARA) -.\" and Copyright (C) 2008, 2012 Michael Kerrisk .\" Permission is granted to distribute possibly modified copies .\" of this page provided the header is included verbatim, .\" and in case of nontrivial modification author and date @@ -17,7 +17,7 @@ .\" address that can appear in the sockaddr_un structure: pathname, .\" unnamed, and abstract. .\" -.TH UNIX 7 2015-05-07 "Linux" "Linux Programmer's Manual" +.TH UNIX 7 2016-03-15 "Linux" "Linux Programmer's Manual" .SH NAME unix \- sockets for local interprocess communication .SH SYNOPSIS @@ -49,7 +49,8 @@ sockets are always reliable and don't reorder datagrams); and (since Linux 2.6.4) .BR SOCK_SEQPACKET , -for a connection-oriented socket that preserves message boundaries +for a sequenced-packet socket that is connection-oriented, +preserves message boundaries, and delivers messages in the order that they were sent. UNIX domain sockets support passing file descriptors or process credentials @@ -618,9 +619,279 @@ pathname sockets follow the rules outlined above under .IR "Pathname sockets" . .SH EXAMPLE -See -.BR bind (2). +The following code demonstrates the use of sequenced-packet +sockets for local interprocess communication. +It consists of two programs. +The server program waits for a connection from the client program. +The client sends each of its command-line arguments in separate messages. +The server treats the incoming messages as integers and adds them up. +The client sends the command string "END". +The server sends back a message containing the sum of the client's integers. +The client prints the sum and exits. +The server waits for the next client to connect. +To stop the server, the client is called with the command-line argument "DOWN". +.PP +The following output was recorded while running the server in the background +and repeatedly executing the client. +Execution of the server program ends when it receives the "DOWN" command. +.SS Example output +.in +4n +.nf +$ \fB./server &\fP +[1] 25887 +$ \fB./client 3 4\fP +Result = 7 +$ \fB./client 11 \-5\fP +Result = 6 +$ \fB./client DOWN\fP +Result = 0 +[1]+ Done ./server +$ +.fi +.in +.SS Program source +.nf +/* + * File connection.h + */ + +#define SOCKET_NAME "/tmp/9Lq7BNBnBycd6nxy.socket" +#define BUFFER_SIZE 12 + +/* + * File server.c + */ + +#include +#include +#include +#include +#include +#include +#include "connection.h" + +int +main(int argc, char *argv[]) +{ + struct sockaddr_un name; + int down_flag = 0; + int ret; + int connection_socket; + int data_socket; + int result; + char buffer[BUFFER_SIZE]; + + /* + * In case the program exited inadvertently on the last run, + * remove the socket. + */ + + unlink(SOCKET_NAME); + + /* Create local socket. */ + + connection_socket = socket(AF_UNIX, SOCK_SEQPACKET, 0); + if (connection_socket == \-1) { + perror("socket"); + exit(EXIT_FAILURE); + } + + /* + * For portability clear the whole structure, since some + * implementations have additional (nonstandard) fields in + * the structure. + */ + + memset(&name, 0, sizeof(struct sockaddr_un)); + + /* Bind socket to socket name. */ + + name.sun_family = AF_UNIX; + strncpy(name.sun_path, SOCKET_NAME, sizeof(name.sun_path) \- 1); + + ret = bind(connection_socket, (const struct sockaddr *) &name, + sizeof(struct sockaddr_un)); + if (ret == \-1) { + perror("bind"); + exit(EXIT_FAILURE); + } + + /* + * Prepare for accepting connections. The backlog size is set + * to 20. So while one request is being processed other requests + * can be waiting. + */ + + ret = listen(connection_socket, 20); + if (ret == \-1) { + perror("listen"); + exit(EXIT_FAILURE); + } + + /* This is the main loop for handling connections. */ + + for (;;) { + + /* Wait for incoming connection. */ + + data_socket = accept(connection_socket, NULL, NULL); + if (ret == \-1) { + perror("accept"); + exit(EXIT_FAILURE); + } + + result = 0; + for(;;) { + + /* Wait for next data packet. */ + + ret = read(data_socket, buffer, BUFFER_SIZE); + if (ret == \-1) { + perror("read"); + exit(EXIT_FAILURE); + } + + /* Ensure buffer is 0\-terminated. */ + + buffer[BUFFER_SIZE \- 1] = 0; + + /* Handle commands. */ + + if (!strncmp(buffer, "DOWN", BUFFER_SIZE)) { + down_flag = 1; + break; + } + + if (!strncmp(buffer, "END", BUFFER_SIZE)) { + break; + } + + /* Add received summand. */ + result += atoi(buffer); + } + + /* Send result. */ + + sprintf(buffer, "%d", result); + ret = write(data_socket, buffer, BUFFER_SIZE); + + if (ret == \-1) { + perror("write"); + exit(EXIT_FAILURE); + } + + /* Close socket. */ + + close(data_socket); + + /* Quit on DOWN command. */ + + if (down_flag) { + break; + } + } + + close(connection_socket); + + /* Unlink the socket. */ + + unlink(SOCKET_NAME); + + exit(EXIT_SUCCESS); +} + +/* + * File client.c + */ + +#include +#include +#include +#include +#include +#include +#include +#include "connection.h" + +int +main(int argc, char *argv[]) +{ + struct sockaddr_un addr; + int i; + int ret; + int data_socket; + char buffer[BUFFER_SIZE]; + + /* Create local socket. */ + + data_socket = socket(AF_UNIX, SOCK_SEQPACKET, 0); + if (data_socket == \-1) { + perror("socket"); + exit(EXIT_FAILURE); + } + + /* + * For portability clear the whole structure, since some + * implementations have additional (nonstandard) fields in + * the structure. + */ + + memset(&addr, 0, sizeof(struct sockaddr_un)); + + /* Connect socket to socket address */ + + addr.sun_family = AF_UNIX; + strncpy(addr.sun_path, SOCKET_NAME, sizeof(addr.sun_path) \- 1); + + ret = connect (data_socket, (const struct sockaddr *) &addr, + sizeof(struct sockaddr_un)); + if (ret == \-1) { + fprintf(stderr, "The server is down.\\n"); + exit(EXIT_FAILURE); + } + + /* Send arguments. */ + + for (i = 1; i < argc; ++i) { + ret = write(data_socket, argv[i], strlen(argv[i]) + 1); + if (ret == \-1) { + perror("write"); + break; + } + } + + /* Request result. */ + + strcpy (buffer, "END"); + ret = write(data_socket, buffer, strlen(buffer) + 1); + if (ret == \-1) { + perror("write"); + exit(EXIT_FAILURE); + } + + /* Receive result. */ + + ret = read(data_socket, buffer, BUFFER_SIZE); + if (ret == \-1) { + perror("read"); + exit(EXIT_FAILURE); + } + + /* Ensure buffer is 0\-terminated. */ + + buffer[BUFFER_SIZE \- 1] = 0; + + printf("Result = %s\\n", buffer); + + /* Close socket. */ + + close(data_socket); + + exit(EXIT_SUCCESS); +} +.fi +.PP For an example of the use of .BR SCM_RIGHTS see @@ -636,11 +907,11 @@ .BR socket (7), .BR udp (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/uri.7 manpages-4.05/man7/uri.7 --- manpages-4.04/man7/uri.7 2015-12-29 12:51:51.000000000 +0000 +++ manpages-4.05/man7/uri.7 2016-03-15 03:47:42.000000000 +0000 @@ -713,11 +713,11 @@ IETF RFC\ 2255 .UE .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/user_namespaces.7 manpages-4.05/man7/user_namespaces.7 --- manpages-4.04/man7/user_namespaces.7 2015-12-29 12:51:51.000000000 +0000 +++ manpages-4.05/man7/user_namespaces.7 2016-03-15 03:47:42.000000000 +0000 @@ -1285,11 +1285,11 @@ The kernel source file .IR Documentation/namespaces/resource-control.txt . .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/utf-8.7 manpages-4.05/man7/utf-8.7 --- manpages-4.04/man7/utf-8.7 2015-12-29 12:51:51.000000000 +0000 +++ manpages-4.05/man7/utf-8.7 2016-03-15 03:47:42.000000000 +0000 @@ -227,11 +227,11 @@ .BR charsets (7), .BR unicode (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/vdso.7 manpages-4.05/man7/vdso.7 --- manpages-4.04/man7/vdso.7 2015-12-29 12:51:51.000000000 +0000 +++ manpages-4.05/man7/vdso.7 2016-03-15 03:47:42.000000000 +0000 @@ -12,7 +12,7 @@ .\" .TH VDSO 7 2015-12-28 "Linux" "Linux Programmer's Manual" .SH NAME -vDSO \- overview of the virtual ELF dynamic shared object +vdso \- overview of the virtual ELF dynamic shared object .SH SYNOPSIS .B #include @@ -133,7 +133,7 @@ You will frequently find it under the architecture-specific directory: find arch/$ARCH/ -name '*vdso*.so*' -o -name '*gate*.so*' - +.\" .SS vDSO names The name of the vDSO varies across architectures. It will often show up in things like glibc's @@ -538,11 +538,11 @@ .fi .in .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/x25.7 manpages-4.05/man7/x25.7 --- manpages-4.04/man7/x25.7 2015-12-29 12:51:51.000000000 +0000 +++ manpages-4.05/man7/x25.7 2016-03-15 03:47:42.000000000 +0000 @@ -125,11 +125,11 @@ .UR ftp://ftp.pspt.fi\:/pub\:/ham\:/linux\:/ax25\:/x25doc.tgz .UE . .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man7/xattr.7 manpages-4.05/man7/xattr.7 --- manpages-4.04/man7/xattr.7 2015-12-29 12:51:51.000000000 +0000 +++ manpages-4.05/man7/xattr.7 2016-03-15 03:47:42.000000000 +0000 @@ -27,7 +27,7 @@ .\" .TH XATTR 7 2015-05-01 "Linux" "Linux Programmer's Manual" .SH NAME -attr - Extended attributes +xattr - Extended attributes .SH DESCRIPTION Extended attributes are name:value pairs associated permanently with files and directories, similar to the environment strings associated @@ -195,11 +195,11 @@ .BR acl (5), .BR capabilities (7) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man8/iconvconfig.8 manpages-4.05/man8/iconvconfig.8 --- manpages-4.04/man8/iconvconfig.8 2015-12-29 12:51:51.000000000 +0000 +++ manpages-4.05/man8/iconvconfig.8 2016-03-15 03:47:42.000000000 +0000 @@ -101,11 +101,11 @@ .BR iconv (1), .BR iconv (3) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man8/intro.8 manpages-4.05/man8/intro.8 --- manpages-4.04/man8/intro.8 2015-12-29 12:51:51.000000000 +0000 +++ manpages-4.05/man8/intro.8 2016-03-15 03:47:42.000000000 +0000 @@ -47,11 +47,11 @@ conditions. Note that these can be different from page to page! .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man8/ldconfig.8 manpages-4.05/man8/ldconfig.8 --- manpages-4.04/man8/ldconfig.8 2015-12-29 12:51:51.000000000 +0000 +++ manpages-4.05/man8/ldconfig.8 2016-03-15 03:47:42.000000000 +0000 @@ -201,11 +201,11 @@ .BR ldd (1), .BR ld.so (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man8/ld.so.8 manpages-4.05/man8/ld.so.8 --- manpages-4.04/man8/ld.so.8 2015-12-29 12:51:51.000000000 +0000 +++ manpages-4.05/man8/ld.so.8 2016-03-15 03:47:42.000000000 +0000 @@ -578,11 +578,11 @@ .\" .\" In the above, (libc5) stands for David Engel's ld.so/ld-linux.so. .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man8/nscd.8 manpages-4.05/man8/nscd.8 --- manpages-4.04/man8/nscd.8 2015-12-29 12:51:51.000000000 +0000 +++ manpages-4.05/man8/nscd.8 2016-03-15 03:47:42.000000000 +0000 @@ -91,11 +91,11 @@ .\" .B nscd .\" was written by Thorsten Kukuk and Ulrich Drepper. .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man8/sln.8 manpages-4.05/man8/sln.8 --- manpages-4.04/man8/sln.8 2015-12-29 12:51:51.000000000 +0000 +++ manpages-4.05/man8/sln.8 2016-03-15 03:47:42.000000000 +0000 @@ -62,11 +62,11 @@ .BR ldconfig (8), .BR ld.so (8) .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man8/tzselect.8 manpages-4.05/man8/tzselect.8 --- manpages-4.04/man8/tzselect.8 2015-12-29 12:51:51.000000000 +0000 +++ manpages-4.05/man8/tzselect.8 2016-03-15 03:47:42.000000000 +0000 @@ -50,11 +50,11 @@ .BR zic (8) .\" @(#)tzselect.8 1.3 .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man8/zdump.8 manpages-4.05/man8/zdump.8 --- manpages-4.04/man8/zdump.8 2015-12-29 12:51:51.000000000 +0000 +++ manpages-4.05/man8/zdump.8 2016-03-15 03:47:42.000000000 +0000 @@ -58,11 +58,11 @@ .BR zic (8) .\" @(#)zdump.8 7.3 .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man8/zic.8 manpages-4.05/man8/zic.8 --- manpages-4.04/man8/zic.8 2015-12-29 12:51:51.000000000 +0000 +++ manpages-4.05/man8/zic.8 2016-03-15 03:47:42.000000000 +0000 @@ -422,11 +422,11 @@ .BR zdump (8) .\" @(#)zic.8 7.19 .SH COLOPHON -This page is part of release 4.04 of the Linux +This page is part of release 4.05 of the Linux .I man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at -\%http://www.kernel.org/doc/man\-pages/. +\%https://www.kernel.org/doc/man\-pages/. diff -Nru manpages-4.04/man-pages-4.04.Announce manpages-4.05/man-pages-4.04.Announce --- manpages-4.04/man-pages-4.04.Announce 2015-12-29 12:51:43.000000000 +0000 +++ manpages-4.05/man-pages-4.04.Announce 1970-01-01 00:00:00.000000000 +0000 @@ -1,62 +0,0 @@ -RELEASE -The Linux man page maintainer proudly announces. . . - - man-pages-4.04.tar.gz - man pages for Linux - -Differences from the previous manual pages release are listed in -the file "Changes". - -For further information, visit http://www.kernel.org/doc/man-pages/ - -POSIX PAGES -This package used to contains a copy of the POSIX 1003.1-2003 -man pages. The POSIX pages are now distributed in the separate -man-pages-posix package. - -THE PAGES -These pages are most of the section 2, 3, 4, 5, 7 man pages -for Linux. A few pages are provided in sections 1 and 8 for commands -that are not documented in other packages, and there are a few pages -in sections 5 and 8 for the timezone utilities. - -[The timezone pages were taken from -ftp://elsie.nci.nih.gov/pub/tzcode2001a.tar.gz.] -[The section 3 man pages for the db routines have been taken from -ftp://ftp.terra.net/pub/sleepycat/db.1.86.tar.gz.] -[The rpc man pages were taken from the 4.4BSD-Lite CDROM.] - -Here is a breakdown of what this distribution contains: - - Section 1 = user commands (intro, plus a few other pages) - Section 2 = system calls - Section 3 = libc calls - Section 4 = devices (e.g., hd, sd) - Section 5 = file formats and configuration files (e.g., wtmp, /etc/passwd) - Section 6 = games (intro only) - Section 7 = overviews, conventions, macro packages, etc. - Section 8 = system administration (intro, plus a few other pages) - - This package contains no, or very few, section 1, 6, and 8 man pages - because these should be distributed with the binaries they are written - for. Sometimes Section 9 is used for man pages describing parts of - the kernel. - - Note that only Section 2 is rather complete, but Section 3 contains - several hundred man pages. If you want to write some man pages, - or suggest improvements to existing pages, please visit - http://www.kernel.org/doc/man-pages/ . - - -Copyright information: - - These man pages are distributed under a variety of copyright licenses. - Although these licenses permit free distribution of the nroff sources - contained in this package, commercial distribution may impose other - requirements (e.g., acknowledgement of copyright or inclusion of the - raw nroff sources with the commercial distribution). - If you distribute these man pages commercially, it is your - responsibility to figure out your obligations. (For many man pages, - these obligations require you to distribute nroff sources with any - pre-formatted man pages that you provide.) Each file that contains - nroff source for a man page also contains the author(s) name, email - address, and copyright notice. diff -Nru manpages-4.04/man-pages-4.04.lsm manpages-4.05/man-pages-4.04.lsm --- manpages-4.04/man-pages-4.04.lsm 2015-12-29 12:51:43.000000000 +0000 +++ manpages-4.05/man-pages-4.04.lsm 1970-01-01 00:00:00.000000000 +0000 @@ -1,14 +0,0 @@ -Begin3 -Title: Section 2, 3, 4, 5 and 7 man pages for Linux -Version: 4.04.04.04 -Entered-date: 2015-12-29 -Description: Linux manual pages -Keywords: man pages -Author: several -Maintained-by: Michael Kerrisk -Primary-site: ftp://ftp.kernel.org/pub/linux/docs/man-pages - 2266k man-pages-4.04.tar.gz -Alternate-site: ftp://ftp.win.tue.nl/pub/linux-local/manpages -Copying-policy: several; the pages are all freely distributable as long as - nroff source is provided -End diff -Nru manpages-4.04/man-pages-4.05.Announce manpages-4.05/man-pages-4.05.Announce --- manpages-4.04/man-pages-4.05.Announce 1970-01-01 00:00:00.000000000 +0000 +++ manpages-4.05/man-pages-4.05.Announce 2016-03-15 03:47:38.000000000 +0000 @@ -0,0 +1,62 @@ +RELEASE +The Linux man page maintainer proudly announces. . . + + man-pages-4.05.tar.gz - man pages for Linux + +Differences from the previous manual pages release are listed in +the file "Changes". + +For further information, visit http://www.kernel.org/doc/man-pages/ + +POSIX PAGES +This package used to contains a copy of the POSIX 1003.1-2003 +man pages. The POSIX pages are now distributed in the separate +man-pages-posix package. + +THE PAGES +These pages are most of the section 2, 3, 4, 5, 7 man pages +for Linux. A few pages are provided in sections 1 and 8 for commands +that are not documented in other packages, and there are a few pages +in sections 5 and 8 for the timezone utilities. + +[The timezone pages were taken from +ftp://elsie.nci.nih.gov/pub/tzcode2001a.tar.gz.] +[The section 3 man pages for the db routines have been taken from +ftp://ftp.terra.net/pub/sleepycat/db.1.86.tar.gz.] +[The rpc man pages were taken from the 4.4BSD-Lite CDROM.] + +Here is a breakdown of what this distribution contains: + + Section 1 = user commands (intro, plus a few other pages) + Section 2 = system calls + Section 3 = libc calls + Section 4 = devices (e.g., hd, sd) + Section 5 = file formats and configuration files (e.g., wtmp, /etc/passwd) + Section 6 = games (intro only) + Section 7 = overviews, conventions, macro packages, etc. + Section 8 = system administration (intro, plus a few other pages) + + This package contains no, or very few, section 1, 6, and 8 man pages + because these should be distributed with the binaries they are written + for. Sometimes Section 9 is used for man pages describing parts of + the kernel. + + Note that only Section 2 is rather complete, but Section 3 contains + several hundred man pages. If you want to write some man pages, + or suggest improvements to existing pages, please visit + http://www.kernel.org/doc/man-pages/ . + + +Copyright information: + + These man pages are distributed under a variety of copyright licenses. + Although these licenses permit free distribution of the nroff sources + contained in this package, commercial distribution may impose other + requirements (e.g., acknowledgement of copyright or inclusion of the + raw nroff sources with the commercial distribution). + If you distribute these man pages commercially, it is your + responsibility to figure out your obligations. (For many man pages, + these obligations require you to distribute nroff sources with any + pre-formatted man pages that you provide.) Each file that contains + nroff source for a man page also contains the author(s) name, email + address, and copyright notice. diff -Nru manpages-4.04/man-pages-4.05.lsm manpages-4.05/man-pages-4.05.lsm --- manpages-4.04/man-pages-4.05.lsm 1970-01-01 00:00:00.000000000 +0000 +++ manpages-4.05/man-pages-4.05.lsm 2016-03-15 03:47:38.000000000 +0000 @@ -0,0 +1,14 @@ +Begin3 +Title: Section 2, 3, 4, 5 and 7 man pages for Linux +Version: 4.05 +Entered-date: 2015-03-15 +Description: Linux manual pages +Keywords: man pages +Author: several +Maintained-by: Michael Kerrisk +Primary-site: ftp://ftp.kernel.org/pub/linux/docs/man-pages + 2308k man-pages-4.05.tar.gz +Alternate-site: ftp://ftp.win.tue.nl/pub/linux-local/manpages +Copying-policy: several; the pages are all freely distributable as long as + nroff source is provided +End diff -Nru manpages-4.04/proj.man-pages.desc manpages-4.05/proj.man-pages.desc --- manpages-4.04/proj.man-pages.desc 2015-12-29 12:51:51.000000000 +0000 +++ manpages-4.05/proj.man-pages.desc 2016-03-15 03:47:42.000000000 +0000 @@ -1 +1 @@ -man-pages|Linux kernel and C library user-space interface documentation|https://www.kernel.org/doc/man-pages/|REPO|Git|https://www.kernel.org/doc/man-pages/index.html|https://www.kernel.org/doc/man-pages/reporting_bugs.html|2015-12-29 +man-pages|Linux kernel and C library user-space interface documentation|https://www.kernel.org/doc/man-pages/|REPO|Git|https://www.kernel.org/doc/man-pages/index.html|https://www.kernel.org/doc/man-pages/reporting_bugs.html|2016-03-15 diff -Nru manpages-4.04/proj.man-pages.pages manpages-4.05/proj.man-pages.pages --- manpages-4.04/proj.man-pages.pages 2015-12-29 12:51:51.000000000 +0000 +++ manpages-4.05/proj.man-pages.pages 2016-03-15 03:47:42.000000000 +0000 @@ -105,6 +105,7 @@ man2/acct.2 man2/fork.2 man2/capset.2 +man2/copy_file_range.2 man2/fdatasync.2 man2/kexec_load.2 man2/fstat.2 @@ -624,6 +625,7 @@ man3/getnetent.3 man3/vfwprintf.3 man3/setjmp.3 +man3/posix_spawn.3 man3/asctime.3 man3/wordfree.3 man3/getnameinfo.3 @@ -633,6 +635,7 @@ man3/logbf.3 man3/strxfrm.3 man3/ctanl.3 +man3/posix_spawnp.3 man3/key_gendes.3 man3/stdio.3 man3/setservent.3 @@ -824,11 +827,13 @@ man3/sem_open.3 man3/tgammaf.3 man3/envz.3 +man3/strerror_l.3 man3/pthread_setname_np.3 man3/sinf.3 man3/inet_network.3 man3/dysize.3 man3/fgetpwent.3 +man3/isalpha_l.3 man3/wprintf.3 man3/strtoull.3 man3/xdr_u_long.3 @@ -873,6 +878,7 @@ man3/fseeko.3 man3/res_nquerydomain.3 man3/signbit.3 +man3/ntp_gettime.3 man3/isnanf.3 man3/endrpcent.3 man3/fputc.3 @@ -1073,6 +1079,7 @@ man3/strchr.3 man3/trunc.3 man3/get_nprocs.3 +man3/ntp_adjtime.3 man3/xdrrec_endofrecord.3 man3/hdestroy_r.3 man3/ftw.3 @@ -1247,6 +1254,7 @@ man3/aio_read.3 man3/unsetenv.3 man3/bsearch.3 +man3/ntp_gettimex.3 man3/freeifaddrs.3 man3/LIST_EMPTY.3 man3/pthread_exit.3 @@ -2074,6 +2082,7 @@ man4/kmem.4 man4/fd.4 man4/tty_ioctl.4 +man4/lirc.4 man4/wavelan.4 man4/random.4 man4/loop-control.4