This is the mail archive of the mailing list for the glibc project.

Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

man-pages-5.03 released


The Linux man-pages maintainer proudly announces:

    man-pages-5.03 - man pages for Linux

This release resulted from patches, bug reports, reviews, and
comments from 45 people, with over 200 commits making changes
to around 80 pages.

Tarball download:
Git repository:
Online changelog:

A short summary of the release is blogged at:

The current version of the pages is browsable at:

You are receiving this message either because:

a) You contributed to the content of this release.

b) You are subscribed to or

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.



==================== Changes in man-pages-5.03 ====================

Released: 2019-10-11, Munich


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 Borowski <>
Aleksa Sarai <>
Alexey Budankov <>
Amir Goldstein <>
Andrew Clayton <>
Carlos O'Donell <>
Christian Brauner <>
Christopher M. Riedl <>
Daniel Colascione <>
Dave Carroll <>
Dave Chinner <>
Дилян Палаузов <>
Dmitry V. Levin <>
Don Brace <>
eponymous alias <>
Eric Biggers <>
Eric W. Biederman <>
Florian Weimer <>
Florin Blanaru <>
Gilbert Wu <>
Ingo Schwarze <>
Jakub Wilk <>
Kevin Barnett <>
Marko Myllynen <>
Matti Moell <>
Matti Möll <>
Matt Perricone <>
Michael Kerrisk <>
Mike Frysinger <>
Murthy Bhat <>
Nikola Forró <>
nilsocket <>
Paul Wise <>
Philipp Wendler <>
Raphael Moreira Zinsly <>
Rasmus Villemoes <>
Reid Priedhorsky <>
Rick Stanley <>
Rob Landley <>
Scott Benesh <>
Scott Teel <>
Shawn Anastasio <>
Simone Piccardi <>
Vincent Lefevre <>
Yang Xu <>

Apologies if I missed anyone!

New and rewritten pages

    Michael Kerrisk  [Christian Brauner, Florian Weimer, Daniel Colascione]
        New page documenting pidfd_open(2)

    Michael Kerrisk  [Florian Weimer, Christian Brauner]
        New page documenting pidfd_send_signal(2)

    Michael Kerrisk  [Eric W. Biederman, Reid Priedhorsky, Philipp Wendler]
        This page has been completely rewritten, adding a lot of missing
        details (including the use of pivot_root(".", ".")) and an example
        program.  In addition, the text prevaricating on whether or not
        pivot_root() might change the root and current working directories has
        been eliminated, and replaced with a simple description of the behavior
        of the system call, which has not changed for 19 years, and will not
        change in the future.  Many longstanding errors in the old version of
        the page have also been corrected.

    Michael Kerrisk
        New page with content migrated from namespaces(7)

    Michael Kerrisk
        New page with content migrated from namespaces(7)

Newly documented interfaces in existing pages

    Christian Brauner, Michael Kerrisk
        Document CLONE_PIDFD
            Add an entry for CLONE_PIDFD. This flag is available starting
            with kernel 5.2. If specified, a process file descriptor
            ("pidfd") referring to the child process will be returned in
            the ptid argument.

    Jakub Wilk
        Document FAN_MOVE_SELF

    Dmitry V. Levin  [Michael Kerrisk]

    Rob Landley
        Document REG_STARTEND

New and changed links

    Michael Kerrisk
        Add NEW link to resolver.3

Global changes

Various pages
    Michael Kerrisk
        SEE ALSO: correct list order

Various pages
    Michael Kerrisk
        Remove section number from references to function in its own page

Various pages
    Michael Kerrisk
        ERRORS: correct alphabetical order

Changes to individual pages

    Marko Myllynen
        Describe recently added options
            Describe few recently added options (present in glibc-2.29).

    Michael Kerrisk
        SEE ALSO: add pidfd_open(2)

    Amir Goldstein  [Dave Chinner]
        Kernel v5.3 updates

    Jakub Wilk
        Add kernel version numbers for some FAN_* constants

    Michael Kerrisk
        Add mention of UTS namespaces

    Michael Kerrisk  [Jakub Wilk]
        Mention UTS namespaces

    Matti Moell  [Matti Möll]
        Fix kernel version numbers for 'aio_rw_flags' flags

    Michael Kerrisk
        SEE ALSO: add pidfd_send_signal(2)

    Nikola Forró
        Fix EINVAL conditions
            Since introduction of MAP_SHARED_VALIDATE, in case flags contain
            both MAP_PRIVATE and MAP_SHARED, mmap() doesn't fail with EINVAL,
            it succeeds.

            The reason for that is that MAP_SHARED_VALIDATE is in fact equal
            to MAP_PRIVATE | MAP_SHARED.

    Michael Kerrisk  [Reid Priedhorsky]
        Describe the concept of "parent mounts"
    Michael Kerrisk
        NOTES: add subsection heading for /proc/[pid]/{mounts,mountinfo}
    Michael Kerrisk
        Rework the text on mount namespaces a little
            Eliminate the term "Per-process namespaces" and add a reference
            to mount_namespaces(7).

    Yang Xu  [Michael Kerrisk]
        Mark E2BIG as deprecated
            E2BIG was removed in 2.6.29, we should mark it as deprecated.

    Michael Kerrisk  [Alexey Budankov]
        SEE ALSO: add Documentation/admin-guide/perf-security.rst

    Michael Kerrisk
        Clarify that PR_GET_SPECULATION_CTRL returns value as function result
    Michael Kerrisk
        Clarify that PR_MCE_KILL_GET returns value via function result
    Michael Kerrisk
        Clarify that PR_GET_FP_MODE returns value as function result
    Michael Kerrisk
        RETURN VALUE: add some missing entries
            Note success return for PR_GET_SPECULATION_CTRL and PR_GET_FP_MODE.

    Michael Kerrisk
        Note that 'si_code' can't be specified as SI_KERNEL
    Michael Kerrisk
        The rules for 'si_code' don't apply when sending a signal to oneself
            The restriction on what values may be specified in 'si_code'
            apply only when sending a signal to a process other than the
            caller itself.
    Michael Kerrisk
        Rename 'uinfo' argument to 'info'
            This is more consistent with the naming in other pages
            that refer to a 'siginfo_t' structure.
    Michael Kerrisk
        SEE ALSO: add pidfd_send_signal(2)

    Michael Kerrisk
        RETURN VALUE: sched_getaffinity() syscall differs from the wrapper

    Mike Frysinger
        Fix CLONE_NEWNS restriction info

    Michael Kerrisk
        SEE ALSO: add pidfd_send_signal(2)

    Andrew Clayton, Michael Kerrisk
        Note about interactions with epoll & fork

    Michael Kerrisk  [Simone Piccardi]
        Clarify details of a case where an invalid 'mask' value may be rejected

    Shawn Anastasio
        Add information for powerpc64
    Michael Kerrisk  [Adam Borowski, Florin Blanaru]
        Update name of syscall instruction for riscv

    Michael Kerrisk
        Add fsconfig(), fsmount(), fsopen(), fspick(), move_mount(), open_tree()
    Michael Kerrisk  [(), Michael(), Kerrisk(),]
        Add new syscalls in 5.1
            Add io_uring_enter(), io_uring_register(), io_uring_setup(), and
    Michael Kerrisk
        Add clone3() and pidfd_open()

    Michael Kerrisk
        Replace reference to namespaces(7) with reference to uts_namespaces(7)

    Rasmus Villemoes
        Add some comments on EAGAIN/EWOULDBLOCK and EDEADLK/EDEADLOCK

    Michael Kerrisk  [Simone Piccardi]
        ENOSYS occurs only if the kernel provides no execveat() syscall
    Michael Kerrisk  [Simone Piccardi]
        ERRORS: add ENOENT

    Raphael Moreira Zinsly
        Add new cache geometry entries

    Vincent Lefevre
        Add detail on the first digit with the %e format

    Carlos O'Donell
        Describe issues with cancellation points in signal handlers

    Michael Kerrisk  [eponymous alias]
        Correct description of use of 'saveptr' argument in strtok_r()
    Michael Kerrisk  [eponymous alias]
        The caller should not modify 'saveptr' between strtok_r() calls
    Michael Kerrisk
        Add portability note for strtok_r() '*saveptr' value
            On some implementations, '*saveptr' must be NULL on first call
            to strtok_r().

    Murthy Bhat  [Don Brace, Kevin Barnett, Matt Perricone, Scott Benesh]
        Add sysfs entries
    Gilbert Wu  [Don Brace, Kevin Barnett, Matt Perricone, Scott Benesh]
        Add module param expose ld first
    Dave Carroll  [Don Brace, Kevin Barnett, Matt Perricone, Scott Benesh]
        Add module param to hide vsep

    Paul Wise
        Explain the new situation with argument splitting
            Things changed in Linux v5.3-rc3 commit 315c69261dd3 from
            splitting after template expansion to splitting beforehand.

    Nikola Forró
        Update information about search list
            Since glibc 2.26, the number of domains in the search list is
            no longer limited.

    Michael Kerrisk
        Relocate and enhance the text on semantic newlines
    Michael Kerrisk  [Paul Wise]
        Paragraphs should not be separated by blank lines

    Michael Kerrisk
        Explain how a namespace's mount point list is initialized
            Provide a more detailed explanation of the initialization of
            the mount point list in a new mount namespace.
    Michael Kerrisk  [Eric W. Biederman]
        Clarify description of "less privileged" mount namespaces
    Michael Kerrisk
        SEE ALSO: refer to example in pivot_root(2)
    Michael Kerrisk  [Eric W. Biederman]
        It may be desirable to disable propagation after creating a namespace
            After creating a new mount namespace, it may be desirable to
            disable mount propagation. Give the reader a more explicit
            hint about this.

    Michael Kerrisk
        Adjust references to namespaces(7) to ipc_namespaces(7)

    Michael Kerrisk
        Remove content migrated to new ipc_namespaces(7) page
    Michael Kerrisk
        Remove content migrated to uts_namespaces(7)
    Michael Kerrisk
        Include manual page references in the summary table of namespace types
            Make the page more compact by removing the stub subsections that
            list the manual pages for the namespace types. And while we're
            here, add an explanation of the table columns.

    Michael Kerrisk  [Rick Stanley]
        Prefix and postfix ++/-- have different precedences
            Harbison and Steele also agree on this.

    Michael Kerrisk
        Enhance the text on process-directed and thread-directed signals
            clone(2) has a good description of these concepts; borrow
            from it liberally.
    Michael Kerrisk
        SEE ALSO: add pidfd_send_signal(2)

    Michael Kerrisk
        Improve explanation of  meaning of ownership of nonuser namespaces

Michael Kerrisk
Linux man-pages maintainer;
Linux/UNIX System Programming Training:

Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]