Commit Graph

16904 Commits

Author SHA1 Message Date
Michael Kerrisk 1f6cc4a614 sleep.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-13 09:13:10 +01:00
Michael Kerrisk f086b6aad1 clock_getres.2: Note POSIX.1 requirements re relative time services and CLOCK_REALTIME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-13 09:09:44 +01:00
Michael Kerrisk ff1203e5c2 exec.3: execl() and execle() were not async-signal-safe before glibc 2.24
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 12:53:05 +01:00
Michael Kerrisk aa30b3276d aio_suspend.3: Note that the glibc implementation is not async-signal-safe
See https://sourceware.org/bugzilla/show_bug.cgi?id=13172

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 12:53:05 +01:00
Michael Kerrisk 46fc35d52b sem_post.3, setjmp.3: SEE ALSO: add signal-safety(7)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 12:53:05 +01:00
Michael Kerrisk d077802826 fork.2, sigaction.2, signal.2: Amend cross references to point to signal-safety(7)
The discussion of async-signal-safe functions has moved
to a new page.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 12:53:05 +01:00
Michael Kerrisk 67557cd9d1 signal-safety.7: Note async-signal-safety problems caused by pthread_atfork()
See https://bugzilla.kernel.org/show_bug.cgi?id=25292

And there will likely be future changes as well.
Quoting http://www.opengroup.org/austin/aardvark/latest/xshbug3.txt:

    COMMENT                          Enhancement Request Number 15
    rajani.g.k:xxxxxx               Defect in XSH 2.4.3 (rdvk#  6)
    {GKRFORK012009}                   Thu, 8 Jan 2009 07:41:10 GMT

    [...]

    As per this section, XSH P1529, L49389-49402, it is possible
    that multithreaded libraries could be used by single threaded
    applications. In which case, atfork handlers are essential for
    the libraries to protect their internal state during fork. As
    explained further P1530, L49403-49404, pthread_atfork
    functions are mainly required to acquire/release mutex locks,
    for protecting the applications/libraries from fork() calls.
    C-library needs to as well have an atfork handler which
    acquires all the required locks to protect its memory state
    across fork().

    The acquire/release mutex calls themselves are aync-signal
    unsafe operations. Use of them makes pthread_atfork handlers
    async-signal unsafe which in turn makes fork() async-signal
    unsafe when called by an application which is multi threaded,
    or which is linked to a library which is multi threaded.

    Action:

    Need clarification with respect to
    1. Is it correct to list fork as an async-signal safe
    interface, in a multi threaded scenario?

    2. Can the implementation be allowed to not call the atfor
    handlers, when fork is called from a signal handler? If the
    atfork handlers are not going to be called when fork is called
    in the signal handler, then they can not be called, even if
    fork is called in the newly created child before exec.

    3. If only async-signal safe functions are to be called from
    pthread_atfork handlers, then how will multi-threaded librarie
    protect themselves by the fork calls, made by single threaded
    applications linked to them?

Reported-by: KASAKI Motohiro <kosaki.motohiro@jp.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 12:53:05 +01:00
Michael Kerrisk fb16ec3585 signal-safety.7: Note glibc deviations from POSIX requirements
See https://bugzilla.kernel.org/show_bug.cgi?id=25292

Reported-by: KASAKI Motohiro <kosaki.motohiro@jp.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 12:53:05 +01:00
Michael Kerrisk d1329af1f3 signal-safety.7, signal.7: Migrate discussion of async-signal-safe functions to new page
Also:
* add more detail on changes across standards
* provide proper section cross references in function references

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 12:53:05 +01:00
Michael Kerrisk 6eb174c60d Changes.old: tfix in 4.09 changes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 12:26:05 +01:00
Michael Kerrisk f9c14f17ba Start of man-pages-4.10: updating Changes and Changes.old 2016-12-12 11:50:11 +01:00
Michael Kerrisk 04628c150d Start of man-pages-4.10: updating .Announce and .lsm files 2016-12-12 11:50:11 +01:00
Michael Kerrisk 1d78d97864 Start of man-pages-4.10: renaming .Announce and .lsm files 2016-12-12 11:50:11 +01:00
Michael Kerrisk 298f02b1b9 Ready for 4.09 2016-12-12 10:47:25 +01:00
Michael Kerrisk 1b9d581944 Removed trailing white space at end of lines 2016-12-12 10:47:17 +01:00
Michael Kerrisk 4322b21be4 Changes: Expanded tabs 2016-12-12 10:47:17 +01:00
Michael Kerrisk 35deeb8703 bind.2, chmod.2, chown.2, chroot.2, clock_getres.2, clone.2, connect.2, dup.2, fallocate.2, get_mempolicy.2, getpeername.2, getpriority.2, getsockname.2, getsockopt.2, gettimeofday.2, ioctl_ficlonerange.2, ioctl_fideduperange.2, kill.2, mbind.2, mmap.2, mount.2, mprotect.2, nfsservctl.2, nice.2, open.2, perf_event_open.2, pipe.2, pkey_alloc.2, prctl.2, ptrace.2, quotactl.2, remap_file_pages.2, sched_setscheduler.2, set_mempolicy.2, signal.2, signalfd.2, swapon.2, sync_file_range.2, syscalls.2, timer_create.2, timerfd_create.2, utime.2, utimensat.2, wait.2, atof.3, ctime.3, errno.3, fclose.3, fflush.3, insque.3, malloc_get_state.3, mallopt.3, mbsnrtowcs.3, mq_close.3, mq_open.3, mq_receive.3, mq_send.3, printf.3, pthread_attr_init.3, pthread_create.3, pthread_setaffinity_np.3, ptsname.3, remainder.3, strtod.3, tgamma.3, timegm.3, tmpnam.3, ttyname.3, console_ioctl.4, elf.5, filesystems.5, proc.5, utmp.5, capabilities.7, cgroups.7, credentials.7, ddp.7, feature_test_macros.7, fifo.7, inotify.7, libc.7, mount_namespaces.7, namespaces.7, netlink.7, pid_namespaces.7, pkeys.7, shm_overview.7, standards.7, uri.7, user_namespaces.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 10:45:24 +01:00
Michael Kerrisk 4901a554d2 Changes: Ready for 4.09
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 10:41:39 +01:00
Michael Kerrisk 39902fbb59 fuse.4: srcfix: FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 10:35:43 +01:00
Michael Kerrisk faaf38b615 fuse.4: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 10:35:43 +01:00
Michael Kerrisk 4675c4ed93 filesystems.5: SEE ALSO: add fuse(4)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 10:35:43 +01:00
Michael Kerrisk 660bc76cdd fuse.4: Tweaks
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 10:35:43 +01:00
Keno Fischer 4085d7ab46 fuse.4: Address FIXMEs
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 10:35:43 +01:00
Michael Kerrisk ac3c78bdde fuse.4: Remove FUSE_* constant values
No need to show the values of the FUSE_* constants, I believe.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 10:35:43 +01:00
Michael Kerrisk 2949f098a3 fuse.4: Add list of undocumented messages
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 10:35:43 +01:00
Michael Kerrisk 0bc65f952c fuse.4: Add list of FOPEN_* flags
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 10:35:43 +01:00
Michael Kerrisk a2027c8fb7 fuse.4: srcfix: FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 10:35:43 +01:00
Michael Kerrisk 7099221801 fuse.4: Add SEE ALSO section
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 10:35:43 +01:00
Michael Kerrisk abf2a19d72 fuse.4: Add CONFORMING TO section
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 10:35:43 +01:00
Michael Kerrisk 996925d5ab fuse.4: Repair ENODEV description
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 10:35:43 +01:00
Michael Kerrisk 551e8425de fuse.4: srcfix: FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 10:35:43 +01:00
Michael Kerrisk f8fe67a15d fuse.4: srcfix: FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 10:35:43 +01:00
Michael Kerrisk 83b87d658b fuse.4: Small rewording in FUSE_INIT
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 10:35:43 +01:00
Michael Kerrisk 53c028d171 fuse.4: Repair wording in EINVAL error text
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 10:35:43 +01:00
Michael Kerrisk 3280cb6ba5 fuse.4: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 10:34:59 +01:00
Michael Kerrisk 5d69a98a99 fuse.4: fuse_entry_out: rework discussion of uniqueness of nodeid + generation
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 10:34:59 +01:00
Michael Kerrisk 7260a6e1e8 fuse.4: Various minor edits to Keno Fischer's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 10:34:59 +01:00
Michael Kerrisk 72e830cc18 fuse.4: srcfix: rewrap source lines
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 10:34:59 +01:00
Michael Kerrisk b03c828e1f fuse.4: Kill information about FUSE header license
I'd say this is fair use (many other man pages do the same).
So, no need to clutter the man page source with this information.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 10:34:59 +01:00
Keno Fischer 5963519cfe fuse.4: New page describing /dev/fuse
This is my writeup of a basic description of /dev/fuse after
playing with it for a few hours today. It is of course woefully
incomplete, and since I neither have a use case nor am working
on this code, I will not be in a position to expand it in the
near future. However, I'm hoping this could still serve as a
handy reference for others looking at this interface.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 10:34:59 +01:00
Michael Kerrisk e6f1b08f55 namespaces.7: Adjust example program to show device major and minor numbers
Reported-by: Eric W. Biederman <ebiederm@xmission.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 07:30:16 +01:00
Michael Kerrisk e0ff749f64 namespaces.7: Comparisons between fstat()ed files should be on st_dev+st_ino
The FDs returned by NS_GET_USERNS and NS_GET_PAREENT must be
tested by comparing to both the 'st_dev' and 'st_ino' fields
returned by fstat(2).

Reported-by: Eric W. Biederman <ebiederm@xmission.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 07:30:16 +01:00
Michael Kerrisk 58615b43fb namespaces.7: Add ENOTTY error() for ioctl namespace operations
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 07:30:16 +01:00
Michael Kerrisk 519949ecad namespaces.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 07:30:16 +01:00
Michael Kerrisk 57422589cf namespaces.7: Tweaks to text on ioctl() operations
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 07:30:16 +01:00
Michael Kerrisk 4f74d99615 mount_namespaces.7: Minor clean-up (note a forward reference in the text)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 07:30:16 +01:00
Michael Kerrisk 4bfc202622 mount_namespaces.7, user_namespaces.7: Migrate subsection on mount restrictions to mount_namespaces(7)
This section material in the user_namespaces(7) page was written
before the creation of the mount_namespaces(7) manual page.
Nowadays, this material properly belongs in the newer page.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 07:28:52 +01:00
Michael Kerrisk 466247eb67 mount_namespaces.7: SEE ALSO: add user_namespaces(7)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 07:27:23 +01:00
Michael Kerrisk 414908519d user_namespaces.7: Add reference to namespaces(7) for NS_GET_USERNS operation
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 07:27:23 +01:00
Michael Kerrisk 7af6863be7 user_namespaces.7: Add reference to namespaces(7) for NS_GET_PARENT operation
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 07:27:23 +01:00