Michael Kerrisk
These interfaces have per-thread semantics
- The page was previously fuzzy about whether the these interfaces
+ The page was previously fuzzy about whether these interfaces
have process-wide or per-thread semantics. (E.g., now the
page states that the calling *thread* (not process) is suspended
until the signal is delivered.)
pivot_root.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
+ 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
Global changes
--------------
-Varios pages
+Various pages
Michael Kerrisk
SEE ALSO: correct list order
user_namespaces.7
Michael Kerrisk
Improve explanation of meaning of ownership of nonuser namespaces
+
+
+==================== Changes in man-pages-5.04 ====================
+
+Released: 2019-11-19, 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:
+
+Andrew Price <anprice@redhat.com>
+Christian Brauner <christian.brauner@ubuntu.com>
+Florian Weimer <fweimer@redhat.com>
+Jakub Wilk <jwilk@jwilk.net>
+Jan Kara <jack@suse.cz>
+Jann Horn <jannh@google.com>
+Kenigbolo Meya Stephen <kenigbol@ut.ee>
+Marko Myllynen <myllynen@redhat.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mikael Magnusson <mikachu@gmail.com>
+Robert Edmonds <edmonds@debian.org>
+Silviu Popescu <silviupopescu1990@gmail.com>
+Torin Carey <torin@tcarey.uk>
+Witold Baryluk <witold.baryluk@gmail.com>
+Yang Xu <xuyang2018.jy@cn.fujitsu.com>
+
+Apologies if I missed anyone!
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+clone.2
+ Michael Kerrisk [Christian Brauner, Jakub Wilk]
+ Document clone3()
+
+wait.2
+ Michael Kerrisk
+ Add P_PIDFD for waiting on a child referred to by a PID file descriptor
+
+bpf-helpers.7
+ Michael Kerrisk
+ Refresh against kernel v5.4-rc7
+
+
+New and changed links
+---------------------
+
+clone3.2
+ Michael Kerrisk
+ New link to clone(2)
+
+
+Changes to individual pages
+---------------------------
+
+clone.2
+ Michael Kerrisk
+ Rename arguments for consistency with clone3()
+ Make the names of the clone() arguments the same as the fields
+ in the clone3() 'args' struct:
+
+ ctid ==> child_pid
+ ptid ==> parent_tid
+ newtls ==> tld
+ child_stack ==> stack
+ Michael Kerrisk
+ Consistently order paragraphs for CLONE_NEW* flags
+ Sometimes the descriptions of these flags mentioned the
+ corresponding section 7 namespace manual page and then the
+ required capabilities, and sometimes the order was the was
+ the reverse. Make it consistent.
+ Michael Kerrisk [Christian Brauner, Jann Horn]
+ EXAMPLE: Allocate child's stack using mmap(2) rather than malloc(3)
+ Christian Brauner suggested mmap(MAP_STACK), rather than
+ malloc(), as the canonical way of allocating a stack for the
+ child of clone(), and Jann Horn noted some reasons why
+ (MAP_STACK exists elsewhere, and mmap() returns a page-aligned
+ block of memory, which is useful if we want to set up a guard
+ page at the end of the stack).
+ Michael Kerrisk [Christian Brauner]
+ Tidy up the description of CLONE_DETACHED
+ The obsolete CLONE_DETACHED flag has never been properly
+ documented, but now the discussion CLONE_PIDFD also requires
+ mention of CLONE_DETACHED. So, properly document CLONE_DETACHED,
+ and mention its interactions with CLONE_PIDFD.
+ Michael Kerrisk [Christian Brauner]
+ Give the introductory paragraph a new coat of paint
+ Change the text in the introductory paragraph (which was written
+ 20 years ago) to reflect the fact that clone*() does more things
+ nowadays.
+ Michael Kerrisk
+ Remove wording that suggests CLONE_NEW* flags are for containers
+ These flags are used for implementing many other interesting
+ things by now.
+ Michael Kerrisk
+ Remove various details that are already covered in namespaces pages
+ Remove details of UTS, IPC, and network namespaces that are
+ already covered in the corresponding namespaces pages in section 7.
+
+clone.2
+proc.5
+ Michael Kerrisk
+ Adjust references to namespaces(7)
+ Adjust references to namespaces(7) to be references to pages
+ describing specific namespace types.
+
+fallocate.2
+ Andrew Price
+ Add gfs2 to the list of punch hole-capable filesystems
+
+ioctl_iflags.2
+ Michael Kerrisk [Robert Edmonds]
+ Emphasize that FS_IOC_GETFLAGS and FS_IOC_SETFLAGS argument is 'int *'
+
+ioctl_list.2
+ Michael Kerrisk
+ Add reference to ioctl(2) SEE ALSO section
+ The referenced section lists various pages that document ioctls.
+
+mmap.2
+ Michael Kerrisk
+ Note that MAP_STACK exists on some other systems
+ Michael Kerrisk
+ Some rewording of the description of MAP_STACK
+ Reword a little to allow for the fact that there are now
+ *two* reasons to consider using this flag.
+
+pidfd_open.2
+ Michael Kerrisk
+ Note the waitid() use case for PID file descriptors
+ Michael Kerrisk
+ Add a subsection header "Use cases for PID file descriptors"
+ Michael Kerrisk
+ Make it a little more explicit the CLONE_PIDFD returns a PID FD
+
+pivot_root.2
+ Michael Kerrisk
+ EXAMPLE: allocate stack using mmap() MAP_STACK rather than malloc()
+
+quotactl.2
+ Yang Xu [Jan Kara]
+ Add some details about Q_QUOTAON
+
+seccomp.2
+cgroups.7
+ Michael Kerrisk
+ Switch to "considerate language"
+
+select.2
+ Michael Kerrisk
+ POLLIN_SET/POLLOUT_SET/POLLEX_SET are now defined in terms of EPOLL*
+ Since kernel commit a9a08845e9acbd224e4ee466f5c1275ed50054e8, the
+ equivalence between select() and poll()/epoll is defined in terms
+ of the EPOLL* constants, rather than the POLL* constants.
+
+wait.2
+ Michael Kerrisk
+ waitid() can be used to wait on children in same process group as caller
+ Since Linux 5.4, idtype == P_PGID && id == 0 can be used to wait
+ on children in same process group as caller.
+ Michael Kerrisk
+ Clarify semantics of waitpid(0, ...)
+ As noted in kernel commit 821cc7b0b205c0df64cce59aacc330af251fa8f7,
+ threads create an ambiguity: what if the calling process's PGID
+ is changed by another thread while waitpid(0, ...) is blocked?
+ So, clarify that waitpid(0, ...) means wait for children whose
+ PGID matches the caller's PGID at the time of the call to
+ waitpid().
+
+getauxval.3
+ Michael Kerrisk [Witold Baryluk]
+ Clarify that AT_BASE_PLATFORM and AT_EXECFN return pointers to strings
+ See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=942207
+
+resolv.conf.5
+ Florian Weimer
+ Attempt clarify domain/search interaction
+ The domain directive is historic at this point; it should not
+ be used.
+
+netdevice.7
+ Michael Kerrisk [Silviu Popescu]
+ Small wording fix in description of SIOCGIFCONF
+ SIOCGIFCONF returns "network layer" addresses (not "transport
+ layer").
+
+uts_namespaces.7
+ Michael Kerrisk
+ Add a little more detail on scope of UTS namespaces
+
+
+==================== Changes in man-pages-5.05 ====================
+
+Released: 2020-02-09, 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:
+
+Adam Borowski <kilobyte@angband.pl>
+Adrian Reber <areber@redhat.com>
+Andy Lutomirski <luto@kernel.org>
+Antonin Décimo <antonin.decimo@gmail.com>
+Benjamin Peterson <benjamin@python.org>
+Brennan Vincent <brennan@materialize.io>
+Christian Brauner <christian.brauner@ubuntu.com>
+Colin Ian King <colin.king@canonical.com>
+Cyril Hrubis <chrubis@suse.cz>
+Daniel Colascione <dancol@google.com>
+Denys Vlasenko <dvlasenk@redhat.com>
+DJ Delorie <dj@redhat.com>
+Dmitry V. Levin <ldv@altlinux.org>
+Jakub Wilk <jwilk@jwilk.net>
+Jashank Jeremy <jashank@rulingia.com.au>
+Joel Fernandes <joel@joelfernandes.org>
+John Hubbard <jhubbard@nvidia.com>
+John Jones <jmjatlanta@gmail.com>
+Joseph C. Sible <josephcsible@gmail.com>
+kevin sztern <kevin.sztern@epita.fr>
+Marko Myllynen <myllynen@redhat.com>
+markus T Metzger <markus.t.metzger@intel.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Michal Hocko <mhocko@suse.com>
+Mike Frysinger <vapier@gentoo.org>
+Mike Salvatore <mike.salvatore@canonical.com>
+Mikhail Golubev <Mikhail.Golubev@opensynergy.com>
+Nick Shipp <ns@segbrk.com>
+Nikola Forró <nforro@redhat.com>
+Peter Gajdos <pgajdos@suse.cz>
+Petr Vorel <pvorel@suse.cz>
+Ponnuvel Palaniyappan <pponnuvel@gmail.com>
+Rich Felker <dalias@libc.org>
+Robin Kuzmin <kuzmin.robin@gmail.com>
+Samuel Thibault <samuel.thibault@ens-lyon.org>
+Sam Varshavchik <mrsam@courier-mta.com>
+Vegard Nossum <vegard.nossum@gmail.com>
+Weitian LI <liweitianux@live.com>
+Will <cassis@tricolore.lu>
+Yang Xu <xuyang2018.jy@cn.fujitsu.com>
+Yu Jian Wu <yujian.wu1@gmail.com>
+
+Apologies if I missed anyone!
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+clone.2
+ Adrian Reber [Christian Brauner, Michael Kerrisk]
+ Add clone3() set_tid information
+ Michael Kerrisk
+ Document CLONE_CLEAR_SIGHAND
+
+fcntl.2
+ Joel Fernandes [Michael Kerrisk]
+ Update manpage with new memfd F_SEAL_FUTURE_WRITE seal
+
+memfd_create.2
+ Joel Fernandes
+ Update manpage with new memfd F_SEAL_FUTURE_WRITE seal
+
+loop.4
+ Yang Xu
+ Document LOOP_SET_BLOCK_SIZE
+ Yang Xu
+ Document LOOP_SET_DIRECT_IO
+
+proc.5
+ Michael Kerrisk
+ Document /proc/sys/vm/unprivileged_userfaultfd
+
+
+Changes to individual pages
+---------------------------
+
+capget.2
+ Michael Kerrisk [Yang Xu]
+ Add missing details in EPERM error for setting inheritable capabilities
+
+clone.2
+ Michael Kerrisk
+ Note that CLONE_THREAD causes similar behavior to CLONE_PARENT
+ The introductory paragraphs note that "the calling process" is
+ normally synonymous with the "the parent process", except in the
+ case of CLONE_PARENT. The same is also true of CLONE_THREAD.
+ Christian Brauner [Michael Kerrisk]
+ Mention that CLONE_PARENT is off-limits for inits
+ Michael Kerrisk [Colin Ian King]
+ Add old EINVAL error for AArch64
+ Michael Kerrisk
+ ERRORS: add EINVAL for use of CLONE_PARENT by an init process
+
+futex.2
+ Ponnuvel Palaniyappan
+ Fix a bug in the example
+
+listen.2
+ Michael Kerrisk [Peter Gajdos]
+ The 'somaxconn' default value has increased to 4096
+
+modify_ldt.2
+set_thread_area.2
+ Andy Lutomirski [Markus T Metzger]
+ Fix type of base_addr
+
+move_pages.2
+ John Hubbard [Michal Hocko]
+ Remove ENOENT from the list of possible return values
+
+open.2
+ Adam Borowski
+ No need for /proc to make an O_TMPFILE file permanent
+ In the example snippet, we already have the fd, thus there's no
+ need to refer to the file by name. And, /proc/ might be not
+ mounted or not accessible.
+ Michael Kerrisk [Joseph C. Sible]
+ In O_TMPFILE example, describe alternative linkat() call
+ This was already shown in an earlier version of the page,
+ but Adam Borowski's patch replaced it with an alternative.
+ Probably, it is better to show both possibilities.
+
+perf_event_open.2
+ Daniel Colascione
+ Mention EINTR for perf_event_open
+
+ptrace.2
+ Denys Vlasenko
+ PTRACE_EVENT_STOP does not always report SIGTRAP
+
+quotactl.2
+ Michael Kerrisk
+ Don't show numeric values of Q_XQUOTAON XFS_QUOTA_?DQ_* flags
+ The programmer should not need to care about the numeric values,
+ and their inclusion is verbosity.
+ Yang Xu [Michael Kerrisk]
+ Add EINVAL error of Q_XQUOTARM operation
+
+stime.2
+ Michael Kerrisk
+ Note that stime() is deprecated
+
+syscall.2
+ Petr Vorel [Cyril Hrubis]
+ Update feature test macro requirements
+
+sysctl.2
+ Michael Kerrisk
+ This system call was removed in Linux 5.5; adjust the page accordingly
+
+userfaultfd.2
+ Yang Xu [Michael Kerrisk]
+ Add EPERM error
+
+cmsg.3
+ Rich Felker
+ Clarify alignment issues and correct method of accessing CMSG_DATA()
+ From an email by Rich Felker:
+
+ It came to my attention while reviewing possible breakage with
+ move to 64-bit time_t that some applications are dereferencing
+ data in socket control messages (particularly SCM_TIMESTAMP*)
+ in-place as the message type, rather than memcpy'ing it to
+ appropriate storage. This necessarily does not work and is not
+ supportable if the message contains data with greater alignment
+ requirement than the header. In particular, on 32-bit archs,
+ cmsghdr has size 12 and alignment 4, but struct timeval and
+ timespec may have alignment requirement 8.
+ Michael Kerrisk [Rich Felker]
+ Modify CMSG_DATA() example to use memcpy()
+ See previous patch to this page for rationale
+
+exit.3
+ Benjamin Peterson [Mike Frysinger]
+ Use hex for the status mask
+
+ftime.3
+ Michael Kerrisk
+ Note that this function is deprecated
+
+getpt.3
+ Samuel Thibault
+ Remove mention of O_NOCTTY
+ The glibc implementation of getpt has actually never been setting
+
+malloc.3
+ Vegard Nossum
+ Clarify realloc() return value
+ Petr Vorel
+ Remove duplicate _GNU_SOURCE
+
+console_codes.4
+ Adam Borowski
+ Document \e[90m to 97, 100 to 107
+ Adam Borowski
+ \e[21m is now underline
+ Since 65d9982d7e523a1a8e7c9af012da0d166f72fc56 (4.17), it follows
+ xterm rather than common sense and consistency, being the only
+ command 1..9 where N+20 doesn't undo what N did. As libvte
+ 0.51.90 got changed the same way, this behaviour will probably
+ stay.
+ Adam Borowski
+ Update \e[38m and \e[48m
+ Supported since cec5b2a97a11ade56a701e83044d0a2a984c67b4 (3.16).
+
+cgroups.7
+ Michael Kerrisk
+ The v2 freezer controller was added in Linux 5.2
+ Michael Kerrisk
+ Split discussion of cgroups.events file and v2 release notification
+ In preparation for adding a description of the "frozen" key.
+ Michael Kerrisk
+ Describe the cgroup.events "frozen" key
+ Michael Kerrisk
+ Improve the discussion of the advantages of v2 release notification
+
+inotify.7
+ Nick Shipp
+ Merge late perror() into fprintf() in example code
+
+netlink.7
+ Antonin Décimo
+ Fix alignment issue in example
+
+packet.7
+ kevin sztern [Michael Kerrisk]
+ Add missing tpacket_auxdata field (tp_vlan_tpid)
+
+rtnetlink.7
+ Antonin Décimo
+ ifa_index is an unsigned int
+
+tcp.7
+ Michael Kerrisk
+ tcp_low_latency is ignored since Linux 4.14
+
+unix.7
+ Michael Kerrisk
+ The PID sent with SCM_CREDENTIALS must match an existing process
+
+vsock.7
+ Mikhail Golubev [Michael Kerrisk]
+ Add missing structure element
+ The structure 'struct sockaddr_vm' has additional element
+ 'unsigned char svm_zero[]' since version v3.9-rc1.
+
+ldconfig.8
+ DJ Delorie
+ Document file filter and symlink pattern expectations
+
+
+==================== Changes in man-pages-5.06 ====================
+
+Released: 2020-04-11, 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:
+
+Alejandro Colomar <colomar.6.4.3@gmail.com>
+Aleksa Sarai <cyphar@cyphar.com>
+Alexander Miller <alex.miller@gmx.de>
+Andrea Arcangeli <aarcange@redhat.com>
+André Almeida <andrealmeid@collabora.com>
+Andrei Vagin <avagin@gmail.com>
+Andrew Micallef <andrew.micallef@live.com.au>
+Bart Van Assche <bvanassche@acm.org>
+Benjamin Peterson <benjamin@python.org>
+Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
+Christian Brauner <christian@brauner.io>
+devi R.K <devi.feb27@gmail.com>
+Dmitry Safonov <dima@arista.com>
+Eric Biggers <ebiggers@google.com>
+Eric Dumazet <eric.dumazet@gmail.com>
+Eric Rannaud <e@nanocritical.com>
+Eugene Syromyatnikov <evgsyr@gmail.com>
+Heinrich Schuchardt <xypron.glpk@gmx.de>
+Helge Deller <deller@gmx.de>
+Jakub Wilk <jwilk@jwilk.net>
+Jorgen Hansen <jhansen@vmware.com>
+Julia Suvorova <jusual@mail.ru>
+Keno Fischer <keno@juliacomputing.com>
+Krzysztof Małysa <varqox@gmail.com>
+Marc Lehmann <debian-reportbug@plan9.de>
+Matthew Bobrowski <mbobrowski@mbobrowski.org>
+Matthew Wilcox <willy@infradead.org>
+Michael Galassi <michael@galassi.us>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Michal Hocko <mhocko@kernel.org>
+Mike Christie <mchristi@redhat.com>
+Mike Frysinger <vapier@gentoo.org>
+Pablo M. Ronchi <pmronchi@yahoo.com.ar>
+Ricardo Biehl Pasquali <pasqualirb@gmail.com>
+Stefan Hajnoczi <stefanha@redhat.com>
+Stefano Garzarella <sgarzare@redhat.com>
+Thomas Gleixner <tglx@linutronix.de>
+Walter Harms <wharms@bfs.de>
+Zack Weinberg <zackw@panix.com>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+openat2.2
+ Aleksa Sarai [Michael Kerrisk]
+ Document new openat2(2) syscall
+
+pidfd_getfd.2
+ Michael Kerrisk [Christian Brauner]
+ New manual page documenting the pidfd_getfd() system call
+
+select.2
+ Michael Kerrisk
+ Rewrite DESCRIPTION
+ Improve structure and readability, at the same time incorporating
+ text and details that were formerly in select_tut(2). Also
+ move a few details in other parts of the page into DESCRIPTION.
+ Michael Kerrisk
+ Consolidate the discussion of pselect into a headed subsection
+ Michael Kerrisk
+ Consolidate historical glibc pselect() details under one subhead
+ Michael Kerrisk
+ Consolidate info on usleep() emulation in one place
+ Michael Kerrisk
+ Place the discussion of the self-pipe technique in a headed subsection
+ Michael Kerrisk
+ Note that FD_SET() and FD_CLR() do not return errors
+ Michael Kerrisk
+ Remove details of historical #include requirements
+ The POSIX situation has been the norm for a long time now,
+ and including ancient details overcomplicates the page.
+ Michael Kerrisk
+ Remove some ancient information about pre-POSIX types for 'timeout'
+
+select_tut.2
+ Michael Kerrisk
+ Eliminate duplication of info across select_tut.2 and select2
+ There was a lot of a duplication of info in SYNOPSIS, DESCRIPTION
+ RETURN VALUE, and SEE ALSO. Move all of the info to one place:
+ the select(2) page.
+
+sysvipc.7
+ Michael Kerrisk
+ Rewrite this page as just a summary of the System V IPC APIs
+ All of the other details in this page have by now been moved into
+ the relevant *ctl(2) pages.
+
+time_namespaces.7
+ Michael Kerrisk [Andrei Vagin, Dmitry Safonov, Thomas Gleixner]
+ New page documenting time namespaces
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+arch_prctl.2
+ Keno Fischer
+ Add ARCH_SET_CPUID subcommand
+
+clock_getres.2
+ Benjamin Peterson
+ Document CLOCK_TAI
+ Michael Kerrisk
+ Add CLOCK_REALTIME_ALARM and CLOCK_BOOTTIME_ALARM
+
+prctl.2
+ Mike Christie [Michal Hocko, Michael Kerrisk, Bart Van Assche]
+ Document PR_SETIO_FLUSHER/GET_IO_FLUSHER
+
+setns.2
+ Michael Kerrisk
+ Document CLONE_NEWTIME
+
+statx.2
+ Eric Biggers
+ Document STATX_ATTR_VERITY
+
+unshare.2
+ Michael Kerrisk
+ Document CLONE_NEWTIME
+
+socket.7
+ Ricardo Biehl Pasquali, Michael Kerrisk
+ Add description of SO_SELECT_ERR_QUEUE
+ Alejandro Colomar [Michael Kerrisk]
+ Document SO_TIMESTAMPNS
+
+
+Global changes
+--------------
+
+Various pages
+ Michael Kerrisk
+ Remove a few mentions of the ancient "Linux libc"
+
+Various pages
+ Michael Kerrisk
+ Global formatting fix: disfavor nonstandard .TP indents
+ In many cases, these don't improve readability, and (when stacked)
+ they sometimes have the side effect of sometimes forcing text
+ to be justified within a narrow column range.
+
+Various pages
+ Michael Kerrisk [Christian Brauner]
+ Fix clumsy wording around "nonnegative file descriptors"
+
+
+Changes to individual pages
+---------------------------
+
+clock_getres.2
+ Helge Deller [Michael Kerrisk]
+ Consecutive calls for CLOCK_MONOTONIC may return same value
+ Consecutive calls to clock_gettime(CLOCK_MONOTONIC) are guaranteed
+ to return MONOTONIC values, which means that they either return
+ the *SAME* time value like the last call, or a later (higher) time
+ value.
+ Eric Rannaud
+ Dynamic POSIX clock devices can return other errors
+ Michael Kerrisk
+ Improve description of CPU-time clocks
+ Michael Kerrisk
+ Add an example program
+ Michael Kerrisk
+ CLOCK_REALTIME_COARSE is not settable
+ Michael Kerrisk
+ Note that CPU-time clocks are not settable.
+ Explicitly note that CLOCK_PROCESS_CPUTIME_ID and
+ CLOCK_PROCESS_CPUTIME_ID are not settable.
+ Michael Kerrisk
+ Clarify that CLOCK_TAI is nonsettable
+ Michael Kerrisk
+ Clarify that CLOCK_MONOTONIC is system-wide
+ Michael Kerrisk
+ ERRORS: add EINVAL for attempt to set a nonsettable clock
+ Michael Kerrisk
+ Move text in BUGS to NOTES
+ The fact that CLOCK_PROCESS_CPUTIME_ID and
+ CLOCK_PROCESS_CPUTIME_ID are not settable isn't a bug,
+ since POSIX does allow the possibility that these clocks
+ are not settable.
+ Michael Kerrisk
+ SEE ALSO: add time_namespaces(7)
+
+clock_nanosleep.2
+ Michael Kerrisk
+ clock_nanosleep() can also sleep against CLOCK_TAI
+ Michael Kerrisk
+ clock_nanosleep() also supports CLOCK_BOOTTIME
+ Presumably (and from a quick glance at the source code)
+ since Linux 2.6.39, when CLOCK_BOOTTIME was introduced.
+
+clock_nanosleep.2
+timer_create.2
+timerfd_create.2
+ Michael Kerrisk
+ Add various missing errors
+ Mostly verified by testing and reading the code.
+
+ There is unfortunately quite a bit of inconsistency across API~s:
+
+ clock_gettime clock_settime clock_nanosleep timer_create timerfd_create
+
+ CLOCK_BOOTTIME y n (EINVAL) y y y
+ CLOCK_BOOTTIME_ALARM y n (EINVAL) y [1] y [1] y [1]
+ CLOCK_MONOTONIC y n (EINVAL) y y y
+ CLOCK_MONOTONIC_COARSE y n (EINVAL) n (ENOTSUP) n (ENOTSUP) n (EINVAL)
+ CLOCK_MONOTONIC_RAW y n (EINVAL) n (ENOTSUP) n (ENOTSUP) n (EINVAL)
+ CLOCK_REALTIME y y y y y
+ CLOCK_REALTIME_ALARM y n (EINVAL) y [1] y [1] y [1]
+ CLOCK_REALTIME_COARSE y n (EINVAL) n (ENOTSUP) n (ENOTSUP) n (EINVAL)
+ CLOCK_TAI y n (EINVAL) y y n (EINVAL)
+ CLOCK_PROCESS_CPUTIME_ID y n (EINVAL) y y n (EINVAL)
+ CLOCK_THREAD_CPUTIME_ID y n (EINVAL) n (EINVAL [2]) y n (EINVAL)
+ pthread_getcpuclockid() y n (EINVAL) y y n (EINVAL)
+
+ [1] The caller must have CAP_WAKE_ALARM, or the error EPERM results.
+
+ [2] This error is generated in the glibc wrapper.
+
+connect.2
+ Michael Kerrisk [Eric Dumazet]
+ Update the details on AF_UNSPEC
+ Update the details on AF_UNSPEC and circumstances in which
+ socket can be reconnected.
+
+dup.2
+ Michael Kerrisk
+ SEE ALSO: add pidfd_getfd(2)
+
+epoll_ctl.2
+ Michael Kerrisk
+ Various minor additions and clarifications
+
+epoll_wait.2
+ Michael Kerrisk
+ A few minor additions and rewrites
+
+execve.2
+ Michael Kerrisk
+ Add a subhead for the discussion of effect on process attributes
+ Michael Kerrisk
+ Explicitly note that argv[argc] == NULL in the new program
+ Michael Kerrisk
+ ERRORS: ENOENT does not occur for missing shared libraries
+ See http://sourceware.org/bugzilla/show_bug.cgi?id=12241.
+
+_exit.2
+ Michael Kerrisk
+ Clarify that raw _exit() system call terminates only the calling thread
+
+inotify_add_watch.2
+ Michael Kerrisk
+ EXAMPLE: add reference to example in inotify(7)
+
+io_submit.2
+ Julia Suvorova
+ Add IOCB_CMD_POLL opcode
+
+lseek.2
+ Michael Kerrisk [Matthew Wilcox]
+ ERRORS: ENXIO can also occur SEEK_DATA in middle of hole at end of file
+
+madvise.2
+ Michael Kerrisk [Andrea Arcangeli]
+ Incorporate some (ancient) comments about MADV_HUGEPAGE
+ Back in 2011, a mail from Andrea Arcangeli noted some details
+ that I never got round to incorporating into the manual page.
+
+mmap.2
+ Michael Kerrisk
+ Add a subhead for the 'flags' argument
+ Michael Kerrisk
+ Move some text hidden at the end of DESCRIPTION to NOTES
+
+msgctl.2
+ Michael Kerrisk
+ Add information on permission bits (based on sysvipc(7) text)
+ Michael Kerrisk
+ Copy information on 'msqid_ds' fields from sysvipc(7)
+
+open.2
+ Michael Kerrisk
+ Clarify that O_NOFOLLOW is relevant (only) for basename of 'pathname'
+ Aleksa Sarai
+ Add references to new openat2(2) page
+ Michael Kerrisk
+ Note EINVAL error for invalid character in basename of 'pathname'
+
+pidfd_open.2
+ Michael Kerrisk
+ Mention pidfd_getfd(2)
+
+poll.2
+ Michael Kerrisk
+ Add an example program
+ Michael Kerrisk
+ Mention epoll(7) in the introductory paragraph
+ Michael Kerrisk
+ Improve description of EFAULT error
+ Michael Kerrisk
+ Fix description of ENOMEM error
+
+select_tut.2
+ Michael Kerrisk
+ Adjust header file includes in example
+ Employ <sys/select.h>, rather than the historical header files.
+
+semctl.2
+ Michael Kerrisk
+ Copy information on 'semid_ds' fields from sysvipc(7)
+ Michael Kerrisk
+ Add a reference to the example in shmop(2)
+ Michael Kerrisk
+ Add information on permission bits (based on sysvipc(7) text)
+
+semget.2
+ Michael Kerrisk
+ EXAMPLE: add an example program
+
+semop.2
+ Michael Kerrisk
+ Add a reference to the semop(2) example in shmop(2)
+
+shmctl.2
+ Michael Kerrisk
+ Add information on permission bits (based on sysvipc(7) text)
+ Michael Kerrisk
+ Note that execute permission is not needed for shmat() SHM_EXEC
+ Michael Kerrisk
+ Copy information on 'shmid_ds' fields from sysvipc(7)
+ Michael Kerrisk
+ Some small improvements to the description of the 'shmid_ds' structure
+
+shmget.2
+ Michael Kerrisk
+ Add a reference to the example in shmop(2)
+
+shmop.2
+ Michael Kerrisk
+ EXAMPLE: add a pair of example programs
+ Add example programs demonstrating usage of shmget(2), shmat(2),
+ semget(2), semctl(2), and semop(2).
+
+sigaction.2
+signal.7
+ Zack Weinberg
+ Document kernel bugs in delivery of signals from CPU exceptions
+
+stat.2
+ Michael Kerrisk
+ Clarify definitions of timestamp fields
+ In particular, make it clear that atime and mtime relate to the
+ file *data*.
+
+syscalls.2
+ Michael Kerrisk
+ Add new Linux 5.6 system calls
+ Michael Kerrisk
+ Note that the 5.x series followed 4.20
+
+timer_create.2
+ Michael Kerrisk
+ timer_create(2) also supports CLOCK_TAI
+ Michael Kerrisk
+ Mention clock_getres(2) for further details on the various clocks
+
+timerfd_create.2
+ Michael Kerrisk [Thomas Gleixner]
+ Note a case where timerfd_settime() can fail with ECANCELED
+ Michael Kerrisk [devi R.K, Thomas Gleixner]
+ Negative changes to CLOCK_REALTIME may cause read() to return 0
+ Michael Kerrisk
+ Rework text for EINVAL for invalid clock ID
+ Michael Kerrisk
+ Refer reader to clock_getres(2) for further details on the clocks
+
+unshare.2
+ Michael Kerrisk
+ Add CLONE_NEWCGROUP and CLONE_NEWTIME to example program
+
+exit.3
+ Michael Kerrisk [Walter Harms]
+ Small improvement to the discussion of 'status' argument
+
+ftok.3
+ Michael Kerrisk
+ EXAMPLE: add a reference to the example in semget(2)
+
+getifaddrs.3
+ Michael Kerrisk [Michael Galassi]
+ EXAMPLE: remove unneeded loop variable
+
+nl_langinfo.3
+ Eugene Syromyatnikov
+ Document era-related locale elements
+ Eugene Syromyatnikov
+ Add information about AM/PM time format locale elements
+ Eugene Syromyatnikov
+ Mention the respective strftime(3) conversion specifications
+
+sem_init.3
+ Michael Kerrisk
+ Add references to example code in shm_open(3) and sem_wait(3)
+
+sem_post.3
+ Michael Kerrisk
+ Add a reference to code example code in shm_open(3)
+
+shm_open.3
+ Michael Kerrisk
+ EXAMPLE: add some example programs
+
+strcmp.3
+ Michael Kerrisk
+ Add an example program
+ Michael Kerrisk [Andrew Micallef, Walter Harms]
+ Rework text describing return value to be clearer
+ Michael Kerrisk
+ Note that the comparison is done using unsigned char
+ Michael Kerrisk
+ SEE ALSO: add ascii(7)
+
+strftime.3
+ Eugene Syromyatnikov [Michael Kerrisk]
+ Refer to the relevant nl_langinfo(3) items
+ Eugene Syromyatnikov
+ Expand %E and %O description
+ Eugene Syromyatnikov
+ Consistently document fall-back format string
+
+proc.5
+ Mike Frysinger
+ Clarify /proc/[pid]/cmdline mutability
+
+cgroups.7
+ Michael Kerrisk
+ Update list of cgroups v2 controllers
+ Update the list of cgroups v2 controllers (several controllers
+ were missing).
+ Michael Kerrisk
+ Add a subsection on cgroup v2 mount options and include 'nsdelegate'
+ Michael Kerrisk
+ Document the cgroups v2 'memory_localevents' mount option
+ Michael Kerrisk
+ SEE ALSO: add Documentation/admin-guide/cgroup-v2.rst
+
+namespaces.7
+ Michael Kerrisk
+ Add time namespaces information
+ Michael Kerrisk
+ Eliminate some superfluous info from display of /proc/PID/ns links
+
+path_resolution.7
+ Aleksa Sarai
+ Update to mention openat2(2) features
+
+socket.7
+ Michael Kerrisk
+ Note SCM message types for SO_TIMESTAMP and SO_TIMESTAMPNS
+
+tcp.7
+ Michael Kerrisk
+ SEE ALSO: mention Documentation/networking/ip-sysctl.txt
+
+time.7
+ Michael Kerrisk
+ Add small subsection on clocks and time namespaces
+
+unix.7
+ Heinrich Schuchardt
+ Correct example
+
+vsock.7
+ Stefano Garzarella [Jorgen Hansen, Stefan Hajnoczi]
+ Add VMADDR_CID_LOCAL description
projects / thirdparty / man-pages.git / blobdiff