man-pages-4.10 released

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



The Linux man-pages maintainer proudly announces:

    man-pages-4.10 - man pages for Linux

This release resulted from patches, bug reports, reviews, and comments
from over 40 contributors. The release sees a large number of changes:
over 600 commits changing around 160 pages. The changes include the
addition of 11 pages, significant rewrites of 3 other pages, and
enhancements to many other pages.

Tarball download:
    http://www.kernel.org/doc/man-pages/download.html
Git repository:
    https://git.kernel.org/cgit/docs/man-pages/man-pages.git/
Online changelog:
    http://man7.org/linux/man-pages/changelog.html#release_4.10

A short summary of the release is blogged at:
http://linux-man-pages.blogspot.com/2017/03/man-pages-410-is-released.html

The current version of the pages is browsable at:
http://man7.org/linux/man-pages/

You are receiving this message either because:

a) You contributed to the content of this release.

b) You are subscribed to linux-man@xxxxxxxxxxxxxxx or
libc-alpha@xxxxxxxxxxxxxx.

c) I have information (possibly inaccurate) that you are the maintainer
of a translation of the manual pages, or are the maintainer of the
manual pages set in a particular distribution, or have expressed
interest in helping with man-pages maintenance, or have otherwise
expressed interest in being notified about man-pages releases.
If you don't want to receive such messages from me, or you know of
some other translator or maintainer who may want to receive such
notifications, send me a message.

Cheers,

Michael

==================== 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@xxxxxxxxx>
Alex <psybin@xxxxxxxxxx>
Anders Thulin <anders@xxxxxxxxxxx>
Andreas Gruenbacher <agruenba@xxxxxxxxxx>
Brian Masney <masneyb@xxxxxxxxxxxxx>
Casey Schaufler <casey@xxxxxxxxxxxxxxxx>
David Howells <dhowells@xxxxxxxxxx>
Erik Kline <ekline@xxxxxxxxx>
Erik Roland van der Meer <ervdmeer@xxxxxxxxx>
Eugene Syromyatnikov <evgsyr@xxxxxxxxx>
Fabjan Sukalia <fsukalia@xxxxxxxxx>
Heinrich Schuchardt <xypron.glpk@xxxxxx>
Helmut Eller <eller.helmut@xxxxxxxxx>
Hugo Guiroux <hugo.guiroux@xxxxxxxxx>
Ian Jackson <ijackson@xxxxxxxxxxxxxxxxxxxxxx>
Jakub Wilk <jwilk@xxxxxxxxx>
Jann Horn <jannh@xxxxxxxxxx>
Jan Ziak <0xe2.0x9a.0x9b@xxxxxxxxx>
John Wiersba <jrw32982@xxxxxxxxx>
Jon Jensen <jon@xxxxxxxxxxxx>
Kai NODA <nodakai@xxxxxxxxx>
KASAKI Motohiro <kosaki.motohiro@xxxxxxxxxxxxxx>
Keno Fischer <keno@xxxxxxxxxxxxxxxxxx>
Kent Fredic <kentfredric@xxxxxxxxx>
Krzysztof Kulakowski <krzysztof.kulakowski@xxxxxxxxx>
Maik Zumstrull <maik@xxxxxxxxxxxxx>
Mat Martineau <mathew.j.martineau@xxxxxxxxxxxxxxx>
Michael Kerrisk <mtk.manpages@xxxxxxxxx>
Mike Frysinger <vapier@xxxxxxxxxxxx>
Nadav Har'El  <nyh@xxxxxxxxxxxxxxxxxxx>
Namhyung Kim <namhyung@xxxxxxxxx>
Nicolas Biscos <nicolas.biscos+man7@xxxxxxxxx>
Omar Sandoval <osandov@xxxxxxxxxxx>
Paul Fee <paul.f.fee@xxxxxxxxx>
Reverend Homer <mk.43.ecko@xxxxxxxxx>
Rob Landley <rob@xxxxxxxxxxx>
Sergey Polovko <sergey@xxxxxxxxxx>
Steven Luo <steven@xxxxxxxxxxxxx>
Tadeusz Struk <tadeusz.struk@xxxxxxxxx>
Vincent Bernat <vincent@xxxxxxxxx>
Vivenzio Pagliari <vivenzio.pagliari@xxxxxxxxx>
Wainer dos Santos Moschetta <wainersm@xxxxxxxxxxxxxxxxxx>
Willy Tarreau <w@xxxxxx>

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
            The behavior of MPOL_BIND changed in 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) can be used 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


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html



[Index of Archives]     [Kernel Documentation]     [Netdev]     [Linux Ethernet Bridging]     [Linux Wireless]     [Kernel Newbies]     [Security]     [Linux for Hams]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux RAID]     [Linux Admin]     [Samba]

  Powered by Linux