| ==================== Changes in man-pages-4.10 ==================== |
| |
| Released: 2017-03-13, Paris |
| |
| |
| 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: |
| |
| Adam Martindale <adam.john.martindale@gmail.com> |
| Alex <psybin@riseup.net> |
| Anders Thulin <anders@thulin.name> |
| Andreas Gruenbacher <agruenba@redhat.com> |
| Brian Masney <masneyb@onstation.org> |
| Casey Schaufler <casey@schaufler-ca.com> |
| David Howells <dhowells@redhat.com> |
| Erik Kline <ekline@gmail.com> |
| Erik Roland van der Meer <ervdmeer@gmail.com> |
| Eugene Syromyatnikov <evgsyr@gmail.com> |
| Fabjan Sukalia <fsukalia@gmail.com> |
| Heinrich Schuchardt <xypron.glpk@gmx.de> |
| Helmut Eller <eller.helmut@gmail.com> |
| Hugo Guiroux <hugo.guiroux@gmail.com> |
| Ian Jackson <ijackson@chiark.greenend.org.uk> |
| Jakub Wilk <jwilk@jwilk.net> |
| Jann Horn <jannh@google.com> |
| Jan Ziak <0xe2.0x9a.0x9b@gmail.com> |
| John Wiersba <jrw32982@yahoo.com> |
| Jon Jensen <jon@endpoint.com> |
| Kai NODA <nodakai@gmail.com> |
| KASAKI Motohiro <kosaki.motohiro@jp.fujitsu.com> |
| Keno Fischer <keno@juliacomputing.com> |
| Kent Fredic <kentfredric@gmail.com> |
| Krzysztof Kulakowski <krzysztof.kulakowski@intel.com> |
| Maik Zumstrull <maik@zumstrull.net> |
| Mat Martineau <mathew.j.martineau@linux.intel.com> |
| Michael Kerrisk <mtk.manpages@gmail.com> |
| Mike Frysinger <vapier@chromium.org> |
| Nadav Har'El <nyh@math.technion.ac.il> |
| Namhyung Kim <namhyung@gmail.com> |
| Nicolas Biscos <nicolas.biscos+man7@gmail.com> |
| Omar Sandoval <osandov@osandov.com> |
| Paul Fee <paul.f.fee@gmail.com> |
| Reverend Homer <mk.43.ecko@gmail.com> |
| Rob Landley <rob@landley.net> |
| Sergey Polovko <sergey@polovko.me> |
| Steven Luo <steven@steven676.net> |
| Tadeusz Struk <tadeusz.struk@intel.com> |
| Vincent Bernat <vincent@bernat.im> |
| Vivenzio Pagliari <vivenzio.pagliari@nokia.com> |
| Wainer dos Santos Moschetta <wainersm@linux.vnet.ibm.com> |
| Willy Tarreau <w@1wt.eu> |
| |
| Apologies if I missed anyone! |
| |
| |
| New and rewritten pages |
| ----------------------- |
| |
| add_key.2 |
| Michael Kerrisk [Eugene Syromyatnikov, David Howells] |
| Major improvements and additions |
| The page has doubled in length. |
| |
| ioctl_iflags.2 |
| Michael Kerrisk |
| New page describing inode flags and ioctl() operations |
| |
| ioctl_ns.2 |
| Michael Kerrisk |
| New page created by splitting ioctl(2) operations out of namespaces(7) |
| |
| keyctl.2 |
| Michael Kerrisk, Eugene Syromyatnikov [David Howells, Mat Martineau] |
| A vast number of additions and improvements |
| The page has gone from somewhat over 100 lines to well over |
| 1000 lines and now more or less documents the complete interface |
| provided by this system call. |
| |
| getentropy.3 |
| Michael Kerrisk |
| New page documenting getentropy(3) |
| getentropy(3) is added to glibc in version 2.25. |
| |
| keyrings.7 |
| David Howells |
| New page (written by David Howells) adopted from keyutils |
| Since this page documents kernel-user-space interfaces, |
| it makes sense to have it as part of man-pages, rather |
| than the keyutils package. |
| Michael Kerrisk [Eugene Syromyatnikov, David Howells] |
| Very many additions and improvements |
| Michael Kerrisk |
| Document /proc/keys |
| Michael Kerrisk |
| Document /proc/sys/kernel/keys/persistent_keyring_expiry |
| Michael Kerrisk |
| Document /proc/key-users |
| Michael Kerrisk |
| Document /proc/sys/kernel/keys/gc_delay |
| Michael Kerrisk |
| Document /proc files that define key quotas |
| |
| persistent-keyring.7 |
| Michael Kerrisk |
| New page (written by David Howells) adopted from keyutils |
| Since this page documents kernel-user-space interfaces, |
| it makes sense to have it as part of man-pages, rather |
| than the keyutils package. |
| Michael Kerrisk |
| Various clean-ups and additions |
| |
| process-keyring.7 |
| Michael Kerrisk |
| New page (written by David Howells) adopted from keyutils |
| Since this page documents kernel-user-space interfaces, |
| it makes sense to have it as part of man-pages, rather |
| than the keyutils package. |
| Michael Kerrisk |
| Various additions and improvements |
| |
| request_key.2 |
| Michael Kerrisk, Eugene Syromyatnikov [David Howells] |
| Very many additions and improvements |
| The page is now three times its former length. |
| |
| session-keyring.7 |
| Michael Kerrisk |
| New page (written by David Howells) adopted from keyutils |
| Since this page documents kernel-user-space interfaces, |
| it makes sense to have it as part of man-pages, rather |
| than the keyutils package. |
| Michael Kerrisk |
| Various reworking and additions |
| |
| signal-safety.7 |
| Michael Kerrisk |
| New page created by migrating the signal-safety discussion from |
| signal(7). Along the way some more details got added. |
| Michael Kerrisk [KASAKI Motohiro] |
| Note async-signal-safety problems caused by pthread_atfork() |
| See https://bugzilla.kernel.org/show_bug.cgi?id=25292 |
| Michael Kerrisk [KASAKI Motohiro] |
| Note glibc deviations from POSIX requirements |
| See https://bugzilla.kernel.org/show_bug.cgi?id=25292 |
| |
| thread-keyring.7 |
| Michael Kerrisk |
| New page (written by David Howells) adopted from keyutils |
| Since this page documents kernel-user-space interfaces, |
| it makes sense to have it as part of man-pages, rather |
| than the keyutils package. |
| Michael Kerrisk |
| Various rewordings and additions |
| |
| user-keyring.7 |
| Michael Kerrisk |
| New page (written by David Howells) adopted from keyutils |
| Since this page documents kernel-user-space interfaces, |
| it makes sense to have it as part of man-pages, rather |
| than the keyutils package. |
| Michael Kerrisk |
| Various reworking and improvements |
| |
| user-session-keyring.7 |
| Michael Kerrisk |
| New page (written by David Howells) adopted from keyutils |
| Since this page documents kernel-user-space interfaces, |
| it makes sense to have it as part of man-pages, rather |
| than the keyutils package. |
| Michael Kerrisk |
| Various rewordings and additions |
| |
| |
| Newly documented interfaces in existing pages |
| --------------------------------------------- |
| |
| bzero.3 |
| Michael Kerrisk |
| Document explicit_bzero() (new in glibc 2.25) |
| Also, reword the description of bzero somewhat. |
| |
| proc.5 |
| Michael Kerrisk |
| Document /proc/sys/vm/user_reserve_kbytes |
| Michael Kerrisk |
| Document /proc/sys/vm/admin_reserve_kbytes |
| Michael Kerrisk |
| Document /proc/sys/fs/mount-max |
| Michael Kerrisk |
| Document /proc/PID/status 'NoNewPrivs' field |
| |
| |
| New and changed links |
| --------------------- |
| |
| explicit_bzero.3 |
| Michael Kerrisk |
| New link to bzero.3 |
| |
| |
| Changes to individual pages |
| --------------------------- |
| |
| chmod.2 |
| Michael Kerrisk |
| ERRORS: add EPERM error for immutable/append-only file |
| |
| chown.2 |
| Michael Kerrisk |
| ERRORS: add EPERM error for immutable/append-only file |
| |
| chroot.2 |
| Michael Kerrisk |
| SEE ALSO: add switch_root(8) |
| |
| clock_getres.2 |
| Michael Kerrisk |
| Note POSIX.1 requirements re relative time services and CLOCK_REALTIME |
| |
| clone.2 |
| Michael Kerrisk |
| clone() does not execute fork handlers |
| |
| execve.2 |
| Michael Kerrisk |
| Rework text describing when effective IDs aren't transformed by execve() |
| Michael Kerrisk |
| File capabilities can be ignored for the same reasons as set-UID/set-GID |
| Michael Kerrisk |
| The 'no_new_privs' bit inhibits transformations of the effective IDs |
| |
| fork.2 |
| Michael Kerrisk |
| cgroup PIDs controller may also be trigger for EAGAIN error |
| |
| fsync.2 |
| Michael Kerrisk |
| SEE ALSO: add posix_fadvise(2) |
| |
| getrandom.2 |
| Michael Kerrisk |
| Remove getentropy(3) details and defer to new getentropy(3) page |
| Michael Kerrisk |
| Starting with glibc 2.25, getrandom() is now declared in <sys/random.h> |
| Michael Kerrisk |
| glibc support was added in version 2.25 |
| |
| getrlimit.2 |
| Michael Kerrisk |
| Document role of RLIMIT_NOFILE for FD passing over UNIX sockets |
| |
| getxattr.2 |
| listxattr.2 |
| Andreas Gruenbacher |
| Document E2BIG errors |
| |
| inotify_add_watch.2 |
| Michael Kerrisk |
| Note "inode" as a synonym for "filesystem object" |
| Consistent with clarifications just made in inotify(7). |
| |
| ioctl.2 |
| Michael Kerrisk |
| SEE ALSO: add ioctl_ns(2), ioctl_iflags(2) |
| |
| ioctl_fat.2 |
| Brian Masney |
| Correctly reference volume ID instead of volume label |
| |
| kcmp.2 |
| Michael Kerrisk |
| Mention the clone(2) flags relating to various kcmp() 'type' values |
| Michael Kerrisk |
| KCMP_FILE: note reasons why FDs may refer to same open file description |
| |
| link.2 |
| Michael Kerrisk |
| When using linkat() AT_EMPTY_PATH, 'olddirfd' must not be a directory |
| Michael Kerrisk |
| ERRORS: add EPERM for immutable/append-only files |
| Michael Kerrisk |
| Note limits where EMLINK is encountered on ext4 and Btrfs |
| |
| listxattr.2 |
| Michael Kerrisk |
| Eliminate extra E2BIG error text |
| Andreas' patch added a second description of E2BIG that |
| was (mostly) more detailed than the existing text. Combine |
| the two texts. |
| |
| lseek.2 |
| Michael Kerrisk |
| O_APPEND overrides the effect of lseek() when doing file writes |
| Michael Kerrisk |
| Remove ancient info about whence values and return values on old systems |
| Michael Kerrisk |
| Remove slightly bogus advice about race conditions |
| The page already (by now) contains a reference to open(2) |
| for a discussion of open file descriptions. Leave it at that, |
| since the reader can then deduce how things work. |
| |
| madvise.2 |
| Michael Kerrisk |
| Note that madvise() is generally about improving performance |
| |
| mbind.2 |
| Krzysztof Kulakowski [Michael Kerrisk] |
| Update MPOL_BIND description |
| Behavior of MPOL_BIND Linux 2.6.26. |
| |
| mincore.2 |
| Michael Kerrisk |
| SEE ALSO: add madvise(2), posix_fadvise(2), posix_madvise(3) |
| |
| mlock.2 |
| Michael Kerrisk |
| Note pre-4.9 bug in RLIMIT_MEMLOCK accounting for overlapping locks |
| Michael Kerrisk |
| SEE ALSO: add mincore(2) |
| |
| mmap.2 |
| Michael Kerrisk |
| mincore(2) can be used to discover which pages of a mapping are resident |
| |
| mount.2 |
| Michael Kerrisk [Rob Landley] |
| Refer to mount_namespaces(7) for details of default propagation type |
| |
| nanosleep.2 |
| Michael Kerrisk |
| Describe "creeping sleep" problem |
| nanosleep() has a problem if used in a program that catches |
| signals and those signals are delivered at a very high rate. |
| Describe the problem, and note that clock_nanosleep(2) |
| provides a solution. |
| Michael Kerrisk |
| BUGS: explicitly note that the Linux 2.4 bug was fixed in Linux 2.6 |
| |
| open.2 |
| Michael Kerrisk |
| Make it clear that O_APPEND implies atomicity |
| Michael Kerrisk |
| Clarify distinction between file creation flags and file status flags |
| Michael Kerrisk |
| Note ambiguity of ELOOP error when using O_NOFOLLOW |
| Michael Kerrisk |
| Restructure O_NOFOLLOW text for easier parsing |
| Michael Kerrisk |
| Clarify that O_NOFOLLOW is now in POSIX |
| |
| poll.2 |
| select.2 |
| Nicolas Biscos |
| Add a reference to the sigset discussion in sigprocmask(2) |
| A little while back, I added a note to sigprocmask.2 that |
| discussed the difference between the libc's and the kernel's |
| sigset_t structures. I added that note, because I saw this being |
| done wrong in a tool tracing system calls (causing subtle bugs). |
| As it turns out, the same bugs existed for ppoll and pselect, for |
| the same reason. I'm hoping by adding the reference here, future |
| writers of similar tools will find that discussion and not make |
| the same mistake. |
| |
| posix_fadvise.2 |
| Michael Kerrisk |
| Mention /proc/sys/vm/drop_caches |
| It may be helpful for the reader of this page to know about |
| /proc/sys/vm/drop_caches. |
| Michael Kerrisk |
| Reorganize some text |
| Details for various flags were hidden under NOTES. |
| Move them to DESCRIPTION, to make the details more |
| obvious. |
| Michael Kerrisk |
| One can use open(2) + mmap(2) + mincore(2) as a 'fincore' |
| Note that open(2) + mmap(2) + mincore(2) to get a view of which |
| pages of a file are currently cached. |
| Michael Kerrisk [Maik Zumstrull] |
| Note that POSIX_FADV_DONTNEED *may* try to write back dirty pages |
| Michael Kerrisk |
| SEE ALSO: mincore(2) |
| |
| prctl.2 |
| Michael Kerrisk |
| Clarify that the ambient capability set is per-thread |
| Keno Fischer |
| Be more precise in what causes dumpable to reset |
| Michael Kerrisk |
| The no_new_privs setting is per-thread (not per-process) |
| Michael Kerrisk |
| Mention /proc/PID/status 'NoNewPrivs' field |
| Michael Kerrisk |
| Add reference to seccomp(2) in discussion of PR_SET_NO_NEW_PRIVS |
| |
| ptrace.2 |
| Omar Sandoval |
| Clarify description of PTRACE_O_EXITKILL |
| |
| read.2 |
| Michael Kerrisk [Kai NODA] |
| Rework text in DESCRIPTION that talks about limits for 'count' |
| See https://bugzilla.kernel.org/show_bug.cgi?id=86061 |
| Michael Kerrisk [Steven Luo] |
| Remove crufty text about EINTR and partial read |
| Remove bogus text saying that POSIX permits partial read |
| to return -1/EINTR on interrupt by a signal handler. |
| That statement already ceased to be true in SUSv1 (1995)! |
| |
| See https://bugzilla.kernel.org/show_bug.cgi?id=193111 |
| |
| readv.2 |
| Michael Kerrisk |
| Remove generic advice about mixing stdio and syscalls on same file |
| There is nothing specific to readv()/writev() about this advice. |
| |
| recv.2 |
| Michael Kerrisk [Vincent Bernat] |
| Remove duplicate paragraph |
| man-pages-1.34 included changes that duplicated an existing |
| paragraph. Remove that duplicate. |
| Michael Kerrisk |
| SEE ALSO: add ip(7), ipv6(7), tcp(7), udp(7), unix(7) |
| |
| remap_file_pages.2 |
| Michael Kerrisk |
| remap_file_pages() has been replaced by a slower in-kernel emulation |
| |
| send.2 |
| Michael Kerrisk |
| SEE ALSO: add ipv6(7), socket(7), unix(7) |
| |
| setxattr.2 |
| Michael Kerrisk |
| ERRORS: add EPERM for immutable/append-only files |
| |
| signalfd.2 |
| Michael Kerrisk |
| signalfd() doesn't play well with helper programs spawned by libraries |
| See https://lwn.net/Articles/415684/. |
| Michael Kerrisk |
| signalfd can't be used to receive synchronously generated signals |
| Signals such as the SIGSEGV that results from an invalid |
| memory access can be caught only with a handler. |
| |
| stat.2 |
| Michael Kerrisk |
| EXAMPLE: extend program to also show ID of the containing device |
| Michael Kerrisk |
| NOTES: mention fstatat() AT_NO_AUTOMOUNT in discussion of automounting |
| |
| statfs.2 |
| Namhyung Kim |
| Add more filesystem types |
| Add missing magic numbers from /usr/include/linux/magic.h |
| |
| syscall.2 |
| Mike Frysinger |
| Add endian details with 64-bit splitting |
| Architectures that split 64-bit values across register pairs |
| usually do so according to their C ABI calling convention (which |
| means endianness). Add some notes to that effect, and change the |
| readahead example to show a little endian example (since that is |
| way more common than big endian). |
| |
| Also start a new list of syscalls that this issue does not apply |
| to. |
| Mike Frysinger |
| Note parisc handling of aligned register pairs |
| While parisc would normally have the same behavior as ARM/PowerPC, |
| they decide to write shim syscall stubs to unpack/realign rather |
| than expose the padding to userspace. |
| |
| tkill.2 |
| Jann Horn |
| Document EAGAIN error for real-time signals |
| |
| truncate.2 |
| Michael Kerrisk |
| Note use of ftruncate() for POSIX shared memory objects |
| |
| unlink.2 |
| Michael Kerrisk |
| ERRORS: add EPERM error for immutable/read-only files |
| |
| vfork.2 |
| Michael Kerrisk |
| Explain why the child should not call exit(3) |
| Michael Kerrisk |
| Another reason to use vfork() is to avoid overcommitting memory |
| Michael Kerrisk |
| Note some caveats re the use of vfork() |
| Inspired by Rich Felker's post at http://ewontfix.com/7/. |
| See also https://sourceware.org/bugzilla/show_bug.cgi?id=14749 and |
| See also https://sourceware.org/bugzilla/show_bug.cgi?id=14750. |
| Michael Kerrisk |
| SEE ALSO: add _exit(2) |
| |
| write.2 |
| Michael Kerrisk [Kai NODA] |
| Alert the reader that there is a limit on 'count' |
| See https://bugzilla.kernel.org/show_bug.cgi?id=86061 |
| |
| aio_suspend.3 |
| Michael Kerrisk |
| Note that the glibc implementation is not async-signal-safe |
| See https://sourceware.org/bugzilla/show_bug.cgi?id=13172 |
| |
| backtrace.3 |
| Michael Kerrisk |
| SEE ALSO: add addr2line(1) and gdb(1) |
| |
| bcmp.3 |
| bcopy.3 |
| bzero.3 |
| memccpy.3 |
| memchr.3 |
| memcmp.3 |
| memcpy.3 |
| memfrob.3 |
| memmem.3 |
| memmove.3 |
| memset.3 |
| Michael Kerrisk |
| SEE ALSO: add bstring(3) |
| |
| exec.3 |
| Michael Kerrisk |
| execl() and execle() were not async-signal-safe before glibc 2.24 |
| |
| fopen.3 |
| Michael Kerrisk [Helmut Eller] |
| Describe freopen() behavior for NULL pathname argument |
| See https://bugzilla.kernel.org/show_bug.cgi?id=191261 |
| Michael Kerrisk |
| Note the open(2) flags that correspond to the 'mode' argument |
| Michael Kerrisk |
| Change argument name: 'path' to 'pathname' |
| For consistency with open(2). |
| Michael Kerrisk |
| Add subsection headings for each function |
| |
| fts.3 |
| Michael Kerrisk |
| Use better argument name for fts_children() and fts_set() |
| Michael Kerrisk |
| Fix minor error in FTSENT structure definition |
| Michael Kerrisk |
| Improve explanation of 'fts_errno' |
| Michael Kerrisk |
| Give a hint that there are further fields in the FTSENT structure |
| Michael Kerrisk |
| Clarify meaning of zero as 'instr' value for fts_set() |
| |
| ftw.3 |
| Michael Kerrisk |
| Correctly handle use of stat info for FTW_NS in example program |
| Michael Kerrisk |
| Clarify that stat buffer is undefined for FTW_NS |
| |
| getline.3 |
| Michael Kerrisk |
| EXAMPLE: better error handling |
| Michael Kerrisk [Kent Fredic] |
| EXAMPLE: handle null bytes in input |
| Jann Horn |
| Document ENOMEM error case |
| see the error handling in libio/iogetdelim.c |
| Michael Kerrisk |
| EXAMPLE: specify file to be opened as command-line argument |
| Michael Kerrisk |
| Use better variable name in example program |
| |
| getmntent.3 |
| Michael Kerrisk [Anders Thulin] |
| Prefer '\\' as the escape to get a backslash |
| See https://bugzilla.kernel.org/show_bug.cgi?id=191611 |
| |
| getopt.3 |
| Michael Kerrisk |
| Reword discussion of error handling and reporting |
| The existing description was hard to understand. Break |
| it into a bullet list that separates out the details |
| in a manner that is easier to parse. |
| Michael Kerrisk |
| Correct details of use of <stdio.h> to get getopt() declaration |
| Michael Kerrisk [John Wiersba] |
| Remove some redundant text |
| |
| mq_open.3 |
| Michael Kerrisk [Adam Martindale] |
| Include definition of the 'mq_attr' structure in this man page |
| Make the reader's life a little easier by saving them from |
| having to refer to mq_getattr(3). |
| |
| mq_send.3 |
| Michael Kerrisk [Adam Martindale] |
| Refer to mq_overview(7) for details on range of message priority |
| |
| __ppc_set_ppr_med.3 |
| Wainer dos Santos Moschetta |
| Note need for _ARCH_PWR8 macro |
| The _ARCH_PWR8 macro must be defined to get the |
| __ppc_set_ppr_very_low() and __ppc_set_ppr_med_high() |
| definitions. |
| |
| printf.3 |
| Michael Kerrisk |
| Document nonstandard 'Z' modifier |
| Michael Kerrisk |
| Document 'q' length modifier |
| Michael Kerrisk [Erik Roland van der Meer] |
| Fix a small bug in example code |
| Move the second call to va_end(ap) to above the if-block that |
| precedes it, so that the va_list 'ap' will be cleaned up in |
| all cases. |
| Michael Kerrisk [Nadav Har'El] |
| As a nonstandard extension, GNU treats 'll' and 'L' as synonyms |
| See https://bugzilla.kernel.org/show_bug.cgi?id=190341. |
| Michael Kerrisk |
| Add references to setlocale(3) in discussions of locales |
| Michael Kerrisk |
| SEE ALSO: remove bogus self reference (dprintf(3)) |
| |
| random.3 |
| Michael Kerrisk |
| Relocate information of "optimal" value of initstate() 'n' argument |
| The information was a bit hidden in NOTES. |
| |
| random_r.3 |
| Michael Kerrisk [Jan Ziak] |
| 'buf.state' must be initialized to NULL before calling initstate_r() |
| See https://bugzilla.kernel.org/show_bug.cgi?id=192801. |
| Michael Kerrisk |
| Add some usage notes for setstate_r() |
| Michael Kerrisk |
| Note that 'buf' records a pointer to 'statebuf' |
| See https://sourceware.org/bugzilla/show_bug.cgi?id=3662. |
| Michael Kerrisk |
| Add BUGS section pointing out the weirdness of the initstate_r() API |
| |
| resolver.3 |
| Michael Kerrisk |
| RES_AAONLY, RES_PRIMARY, RES_NOCHECKNAME, RES_KEEPTSIG are deprecated |
| These options were never implemented; since glibc 2.25, they |
| are deprecated. |
| Michael Kerrisk |
| The RES_NOIP6DOTINT is removed in glibc 2.25 |
| Michael Kerrisk |
| Note that RES_BLAST was unimplemented and is now deprecated |
| Michael Kerrisk |
| RES_USE_INET6 is deprecated since glibc 2.25 |
| Michael Kerrisk |
| RES_USEBSTRING was removed in glibc 2.25 |
| |
| resolver.3 |
| resolv.conf.5 |
| Michael Kerrisk |
| Note that RES_USEBSTRING defaults to off |
| |
| scandir.3 |
| Michael Kerrisk [Ian Jackson] |
| Fix errors in example program |
| See http://bugs.debian.org/848231. |
| Michael Kerrisk |
| Improve logic of the example program |
| |
| scanf.3 |
| Michael Kerrisk |
| Document the quote (') modifier for decimal conversions |
| |
| sem_post.3 |
| setjmp.3 |
| Michael Kerrisk |
| SEE ALSO: add signal-safety(7) |
| |
| sem_wait.3 |
| Michael Kerrisk [Fabjan Sukalia] |
| Remove statement that SA_RESTART does not cause restarting |
| This has not been true since Linux 2.6.22. The description |
| of EINTR maintains a reference to signal(7), which explains |
| the historical details. |
| |
| See https://bugzilla.kernel.org/show_bug.cgi?id=192071 |
| |
| sleep.3 |
| Michael Kerrisk [Mike Frysiner] |
| Note that sleep() is implemented via nanosleep(2) |
| See https://bugzilla.kernel.org/show_bug.cgi?id=73371. |
| Michael Kerrisk [Mike Frysinger] |
| Note that sleep() sleeps for a real-time number of seconds |
| See https://bugzilla.kernel.org/show_bug.cgi?id=73371. |
| Michael Kerrisk |
| Convert BUGS text to "Portability notes" subsection |
| The existing text is not a bug, as such. |
| Michael Kerrisk |
| DESCRIPTION: minor reworking |
| |
| strerror.3 |
| Heinrich Schuchardt |
| Indicate reasonable buffer size for strerror_r() and strerror_l() |
| Add a hint which buffer size is needed for |
| strerror_r() and strerror_l(). |
| |
| strverscmp.3 |
| Michael Kerrisk [Vivenzio Pagliari] |
| Fix comparison error in example program |
| |
| system.3 |
| Michael Kerrisk |
| In the glibc implementation, fork handlers are not executed by system() |
| |
| random.4 |
| Michael Kerrisk [Jon Jensen] |
| Note that entropY-avail will be a number in the range 0..4096 |
| |
| core.5 |
| Michael Kerrisk |
| Clarify that dumping program's initial CWD is root directory |
| Michael Kerrisk |
| The target of core dump piping can also be a script |
| |
| filesystems.5 |
| Michael Kerrisk |
| SEE ALSO: add btrfs(5), nfs(5), tmpfs(5) |
| |
| intro.5 |
| Michael Kerrisk |
| Document the reality that by now Section 5 also covers filesystems |
| There are by now, from various filesystem projects, various |
| pages in Section 5 that document different filesystems. |
| Change intro(5) to reflect that. |
| |
| Documented after following: http://bugs.debian.org/847998 |
| |
| proc.5 |
| Mike Frysinger [Michael Kerrisk] |
| Clarify /proc/pid/environ behavior |
| /proc/pid/environ reflects process environment at |
| *start* of program execution; it is set at time of execve(2) |
| Michael Kerrisk |
| Add reference to slabinfo(5) in discussion of /proc/meminfo 'Slab' field |
| Michael Kerrisk |
| Add entries for "keys" files that refer reader to keyrings(7) |
| Michael Kerrisk |
| Remove duplicate /proc/[pid]/seccomp entry |
| Michael Kerrisk |
| Mention other system calls that create 'anon_inode' file descriptors |
| Mention a few other system calls that create file descriptors |
| that display an 'anon_inode' symlink in /proc/PID/fd |
| Michael Kerrisk |
| Add some detail on overcommit_memory value 1 |
| Michael Kerrisk |
| Add reference to vdso(7) in discussion of /proc/PID/maps |
| |
| resolv.conf.5 |
| Michael Kerrisk |
| ip6-bytestring was removed in glibc 2.25 |
| Michael Kerrisk |
| The ipc-dotint and no-ip6-dotint options were removed in glibc 2.25 |
| Michael Kerrisk |
| The 'inet6' option is deprecated since glibc 2.25 |
| |
| slabinfo.5 |
| Michael Kerrisk |
| SEE ALSO: add slabtop(1) |
| |
| capabilities.7 |
| Michael Kerrisk [Casey Schaufler] |
| Add subsection with notes to kernel developers |
| Provide some notes to kernel developers considering how to choose |
| which capability should govern a new kernel feature. |
| Michael Kerrisk |
| Further enhance the recommendation against new uses of CAP_SYS_ADMIN |
| Michael Kerrisk |
| Explicitly point from CAP_SYS_ADMIN to "Notes for kernel developers" |
| Michael Kerrisk |
| Add another case for CAP_DAC_READ_SEARCH |
| Michael Kerrisk |
| Refer to execve(2) for the reasons that file capabilities may be ignored |
| Michael Kerrisk |
| Document a new use of CAP_SYS_RESOURCE |
| Michael Kerrisk |
| Add some more operations governed by CAP_SYS_ADMIN |
| Michael Kerrisk |
| Adjust references to chattr(1) to point to ioctl_iflags(2) |
| |
| environ.7 |
| Michael Kerrisk |
| Mention prctl(2) PR_SET_MM_ENV_START and PR_SET_MM_ENV_END operations |
| |
| inotify.7 |
| Michael Kerrisk |
| Point out that inotify monitoring is inode based |
| |
| ip.7 |
| Michael Kerrisk |
| SEE ALSO: add ip(8) |
| |
| man.7 |
| uri.7 |
| Jakub Wilk |
| Use "www.kernel.org" in example URLs |
| Apparently www.kernelnotes.org is now a spam site. |
| |
| mount_namespaces.7 |
| Michael Kerrisk [Rob Landley] |
| Rework the discussion of defaults for mount propagation types |
| Add rather more detail. In particular, note the cases where the |
| default propagation type is MS_PRIVATE vs MS_SHARED. |
| |
| namespaces.7 |
| Michael Kerrisk |
| EXAMPLE: fix an error in shell session |
| Michael Kerrisk |
| EXAMPLE: rename the example program |
| Use a more generic name, since this program may be expanded |
| in various ways in the future. |
| Michael Kerrisk |
| SEE ALSO: add ip-netns(8) |
| Michael Kerrisk |
| Remove content split out into ioctl_ns(2) |
| |
| netlink.7 |
| Michael Kerrisk |
| NETLINK_IP6_FW went away in Linux 3.5 |
| Michael Kerrisk |
| NETLINK_W1 went away in Linux 2.6.18 |
| Michael Kerrisk |
| Add NETLINK_SCSITRANSPORT to list |
| Michael Kerrisk |
| Add NETLINK_RDMA to list |
| Michael Kerrisk |
| NETLINK_FIREWALL was removed in Linux 3.5 |
| Michael Kerrisk |
| NETLINK_NFLOG was removed in Linux 3.17 |
| Jakub Wilk |
| Update libnl homepage URL |
| The original URL is 404. |
| |
| pid_namespaces.7 |
| user_namespaces.7 |
| Michael Kerrisk |
| Adjust references to namespaces(7) to ioctl_ns(2) |
| |
| pid_namespaces.7 |
| Keno Fischer |
| CLONE_SIGHAND|CLONE_VM|CLONE_NEWPID is no longer disallowed |
| |
| pipe.7 |
| Michael Kerrisk |
| Since Linux 4.9, pipe-max-size is ceiling for the default pipe capacity |
| Michael Kerrisk |
| Clarify that default pipe capacity is 16 pages |
| The statement that the default pipe capacity is 65536 bytes |
| is accurate only on systems where the page size is 4096B. |
| See the use of PIPE_DEF_BUFFERS in the kernel source. |
| |
| random.7 |
| Michael Kerrisk |
| Mention getentropy(3) |
| Michael Kerrisk |
| SEE ALSO: add getentropy(3) |
| Michael Kerrisk |
| SEE ALSO: add getauxval(3) |
| A small hint to the reader that some random bytes arrive |
| in the auxiliary vector. |
| |
| signal.7 |
| Michael Kerrisk |
| SIGSYS: add reference to seccomp(2) |
| Michael Kerrisk |
| Change description of SIGSYS to "Bad system call" |
| This is the more typical definition. |
| Michael Kerrisk |
| SIGPIPE: add reference to pipe(7) |
| Michael Kerrisk |
| SIGXFSZ: add reference to setrlimit(2) |
| Michael Kerrisk |
| Add a name for SIGEMT |
| Michael Kerrisk |
| SIGXCPU: add reference to setrlimit(2) |
| Michael Kerrisk |
| Migrated signal-safety discussion to new signal-safet(7) page |
| |
| unix.7 |
| Michael Kerrisk [Sergey Polovko] |
| Since Linux 3.4, UNIX domain sockets support MSG_TRUNC |
| This was correctly noted in recv(2), but the unix(7) page |
| was not correspondingly updated for the Linux 3.4 change. |
| Michael Kerrisk [Willy Tarreau] |
| Document ETOOMANYREFS for SCM_RIGHTS send exceeding RLIMIT_NOFILE limit |
| |
| user_namespaces.7 |
| Michael Kerrisk |
| Change page cross reference: keyctl(2) ==> keyrings(7) |
| |
| ld.so.8 |
| Michael Kerrisk |
| LD_BIND_NOT has effect only for function symbols |
| Michael Kerrisk |
| Describe use of LD_DEBUG with LD_BIND_NOT |
| Michael Kerrisk |
| In secure mode, LD_AUDIT restricts the libraries that it will load |
| Michael Kerrisk |
| LD_AUDIT understands $ORIGIN, $LIB, and $PLATFORM |
| |