Commit Graph

7356 Commits

Author SHA1 Message Date
Michael Kerrisk 4ba0bbdef5 access.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-15 08:29:00 +02:00
Michael Kerrisk c63f06b5ff accept.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-15 08:26:42 +02:00
Michael Kerrisk 5355ff8241 open.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-14 14:14:13 +02:00
Michael Kerrisk 3d113fbfd7 signal.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-14 09:18:28 +02:00
Michael Kerrisk cc560d7743 signalfd.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-14 09:16:00 +02:00
Michael Kerrisk a539c872e1 readlink.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-14 00:08:50 +02:00
Michael Kerrisk f06a3f30fa readlink.2: Fix an off-by-one error in example code
An off-by-one error could trigger a buffer overflow in
some cases in the old code.
See https://bugzilla.kernel.org/show_bug.cgi?id=196483

Also some other cosmetic changes to the code (more comments,
better variable names).

Reported-by: Jason Noakes <jjnoakes@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-14 00:03:37 +02:00
Michael Kerrisk 928cf4522f chown.2: Update kernel version in note on support for grpid/nogrpid mount options
There has been no change since Linux 2.6.25, so update the
kernel version to 4.12.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-13 23:03:41 +02:00
Michael Kerrisk 009a7c83cc chown.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-13 23:00:20 +02:00
Michael Kerrisk 778ac6277e fcntl.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-13 22:56:15 +02:00
Michael Kerrisk a12f0259f8 pipe.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-13 22:35:43 +02:00
Michael Kerrisk 7c4dfcac5a ioctl_userfaultfd.2: wfix
Reported-by: Sam Varshavchik <mrsam@courier-mta.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-12 23:02:06 +02:00
Michael Kerrisk dcc5bd7fbd syscall.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-12 22:58:08 +02:00
Michael Kerrisk b791f86135 syscall.2: srcfix
Reported-by: Sam Varshavchik <mrsam@courier-mta.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-12 22:56:25 +02:00
NeilBrown 97a45d02e6 open.2: Improve O_PATH documentation
- fstatfs is now permitted.
- ioctl isn't, and is worth listing explicitly
- O_PATH allows an automount point to be opened with
  triggering the mount.

All tested

Signed-off-by: NeilBrown <neilb@suse.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-12 22:11:18 +02:00
Michael Kerrisk 2f2ab7445f umount.2: Minor tweaks to NeilBrown's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-12 22:06:32 +02:00
Michael Kerrisk 76218efa25 umount.2: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-12 22:04:19 +02:00
NeilBrown 23779c0533 umount.2: Restore mention of data loss with MNT_FORCE
Recent patch to description of MNT_FORCE incorrectly
dropped the mention of possible data loss.  Restore it.

Signed-off-by: NeilBrown <neilb@suse.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-12 22:00:49 +02:00
NeilBrown 7045e43809 umount.2: Revise MNT_FORCE description
MNT_FORCE does not allow a busy filesystem to be unmounted.  Only
MNT_DETACH allows that.  MNT_FORCE only tries to abort pending
transactions, in the hope that might help umount not to block,

Also, other filesystems than NFS support MNT_FORCE.

Signed-off-by: NeilBrown <neilb@suse.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-12 22:00:37 +02:00
Elliott Hughes 0f86e5b1be set_tid_address.2: Note that there's no glibc wrapper for set_tid_address()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-12 21:53:47 +02:00
Michael Kerrisk a568844159 select_tut.2: Clarify an ambiguity with respect to select() and EAGAIN
See https://bugzilla.kernel.org/show_bug.cgi?id=196345

Reported-by: Sergey Z. <zhurxx@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-22 09:44:17 +02:00
Douglas Caetano dos Santos 8f66cfd74a bpf.2: ffix
'\' must be escaped.

Signed-off-by: Douglas Caetano dos Santos <douglascs@taghos.com.br>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-22 09:19:54 +02:00
Michael Kerrisk f55a6d598d Changes, ldd.1, chown.2, epoll_wait.2, get_mempolicy.2, ioctl_getfsmap.2, madvise.2, membarrier.2, mount.2, pipe.2, readv.2, seccomp.2, sigaltstack.2, splice.2, tee.2, timer_create.2, vmsplice.2, acosh.3, asinh.3, atanh.3, bsd_signal.3, dl_iterate_phdr.3, dlsym.3, flockfile.3, fpathconf.3, ftw.3, getaddrinfo.3, getcontext.3, getgrent.3, if_nametoindex.3, malloc.3, nl_langinfo.3, posix_madvise.3, ptsname.3, rand.3, resolver.3, sigpause.3, sigwait.3, strtol.3, sysconf.3, ttyslot.3, unlocked_stdio.3, unlockpt.3, capabilities.7, cgroup_namespaces.7, inode.7, man.7, pipe.7, sigevent.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-13 14:22:45 +02:00
Michael Kerrisk e0ccee7f67 getpid.2: srcfix: add FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-13 07:45:13 +02:00
Michael Kerrisk abcf3b1db9 clone.2: Update BUGS to reflect fact that PID caching was removed in glibc 2.25
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-13 07:45:05 +02:00
Michael Kerrisk 9338d37b76 getpid.2: More tidy-ups in discussion of removal of getpid() PID caching
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-13 07:05:28 +02:00
Michael Kerrisk cd065c7aec getpid.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-12 21:23:01 +02:00
Michael Kerrisk 995865aa06 getpid.2: Minor tweaks to Carlos's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-12 21:22:24 +02:00
Carlos O'Donell 7693d1e5c0 getpid.2: Note that PID caching is removed as of glibc 2.25
Since glibc 2.25 the PID cache is removed.

Rationale given in the release notes:
https://sourceware.org/glibc/wiki/Release/2.25#pid_cache_removal
~~~
3.2.3. Calls to getpid are no longer cached

The PID cache used by glibc has been removed. In certain scenarios
the cache was not 100% reliable and because of that it was deemed
safer to remove the cache than to potentially return a wrong
answer.

Applications performing getpid() calls in a loop will see the
worst case performance degradation as the library call will
perform a system call at each invocation. Such application uses
were known to exist at least in OpenSSL (fork()-based PRNG
invalidation), but supporting the performance of that specific
invalidation mechanism was not judged to have sufficient value
against immediate and long-term benefits of removing the cache.

Functional reasons exist for the PID cache removal including
problems with PID namespaces, interoperability with raw system
calls (BZ#17214, Chrome: Issue 800183004), and improvements to
spawn (BZ#19957). Performance is actually increased in
pthread_create() with the removal of the cache since the
implementation no longer needs to perform an invalidation step.

Applications performing getpid() in a loop that need to do some
level of fork()-based invalidation can instead use
pthread_atfork() to register handlers to handle the invalidation.
There is work-in-progress to make pthread_atfork() available to
applications that do not link against libpthread.so (Provide
pthread_atfork() without libpthread.so).

Other kinds of invalidation are not supported and the glibc
community will actively look at a kernel assisted mechanism for
state management across fork(), vfork(), clone() and other
interfaces which can benefit from such semantics. It is the same
type of solution required for crypto PRNG reset across such API
calls.
~~~

Signed-off-by: Carlos O'Donell <carlos@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-12 21:18:06 +02:00
sulit c83ad1ade0 bpf.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-05 10:50:08 +02:00
Michael Kerrisk baaf65e88a seccomp.2: Minor tweaks to Mike's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-05 10:46:44 +02:00
Mike Frysinger 089761d56d seccomp(2): Expand SECCOMP_RET_KILL documentation
First clarify that the process cannot catch this SIGSYS signal.
While the text currently says that, it's easy (IMO) to read
ambiguously and that it's referring to default behavior (no
handler -> process exits).

Then add details regarding coredump behavior.  Before Linux 4.11,
there was no way to get coredumps from such crashes.  Now we can
at least get crashes from single threaded processes.

Signed-off-by: Mike Frysinger <vapier@chromium.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-05 10:41:53 +02:00
Eric Biggers b2210694c0 execve.2: tfix
Signed-off-by: Eric Biggers <ebiggers@google.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-05 10:40:29 +02:00
Michael Kerrisk a79107aefe madvise.2: Remove bogus text re POSIX_MADV_NOREUSE
There is a POSIX_FADV_NOREUSE for posix_fadvise(),
but no POSIX_MADV_NOREUSE for any API in POSIX.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-05 10:27:38 +02:00
Janne Snabb 3e3c1e2364 getrandom.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-05 10:20:04 +02:00
Michael Kerrisk 941d289252 open.2: Note some further advantages of the *at() APIs
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-27 08:54:09 +02:00
Michael Kerrisk 4084e9b949 request_key.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-25 12:12:49 +02:00
Michael Kerrisk 32f5f04482 readv.2: glibc 2.26 adds library support for preadv2() and pwritev2()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-19 15:35:06 +02:00
Michael Kerrisk 9b601b66a9 readv.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-19 15:34:47 +02:00
Michael Kerrisk cef01dbc3a ioctl.2: SEE ALSO: add ioctl_getfsmap(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:46:17 +02:00
Michael Kerrisk f17fab191b ioctl_getfsmap.2: ERRORS: order alphabetically
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:46:17 +02:00
Michael Kerrisk 47692d77fb ioctl_getfsmap.2: add VERSIONS section
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:46:17 +02:00
Michael Kerrisk 427245197d ioctl_getfsmap.2: Fix ordering of sections
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:46:17 +02:00
Michael Kerrisk 194721a4cf ioctl_getfsmap.2: Minor fixes to Darrick Wong's page
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:46:16 +02:00
Darrick J. Wong f0efd47a49 ioctl_getfsmap.2: Document the GETFSMAP ioctl
Document the new GETFSMAP ioctl that returns the physical layout of a
(disk-based) filesystem.

Signed-off-by: Darrick J. Wong <darrick.wong@oracle.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:46:16 +02:00
Michael Kerrisk 6a43458b0a wait.2: Note glibc 2.26 changes to feature test macro requirements for waitid()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:42:45 +02:00
Michael Kerrisk d4afcdb42d chmod.2: Note glibc 2.24 feature test macro requirements changes for fchmod()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:42:44 +02:00
Michael Kerrisk 7d34a794ee chmod.2: Put fchmod() feature test macro requirements in a more readable format
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:42:44 +02:00
Michael Kerrisk 6470bd2ae2 sigaction.2: Note feature test macro requirements for 'si_code' constants
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:42:36 +02:00
Michael Kerrisk 6210b7e977 sigaction.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:42:36 +02:00
Michael Kerrisk 6b94000d63 sigaction.2: Add a subheading for the description of 'si_code'
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:42:31 +02:00
Michael Kerrisk 8d4b857991 sigaction.2: TRAP_BRANCH and TRAP_HWBKPT are present only on IA64
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 08:03:30 +02:00
Michael Kerrisk 6c97eb40aa splice.2, tee.2, vmsplice.2: SEE ALSO: add pipe(7)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-14 13:23:20 +02:00
Michael Kerrisk d766983819 pipe.2: SEE ALSO: add tee(2) and vmsplice(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-14 13:21:04 +02:00
Michael Kerrisk be338b52ec splice.2: ERRORS: add EINVAL for case where both descriptors refer to same pipe
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-14 12:59:13 +02:00
Michael Kerrisk be050b69a0 splice.2: ERRORS: split EINVAL error cases
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-14 12:56:30 +02:00
Michael Kerrisk 94be92bfe7 epoll_wait.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-03 20:03:54 +02:00
Michael Kerrisk 11f57f4476 epoll_wait.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-03 20:03:04 +02:00
Michael Kerrisk 7e086953f6 syscalls.2: tfix
Reported-by: 石井大貴 <hiroki.ishii@miraclelinux.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-03 18:42:22 +02:00
Michael Kerrisk 2d5f2098a4 get_mempolicy.2: SYNOPSIS: fix return type of get_mempolicy()
See https://bugzilla.kernel.org/show_bug.cgi?id=97051

Reported-by: Nadav Har'El <nyh@math.technion.ac.il>
Reported-by: Andi Kleen <andi-bz.firstfloor.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-30 05:05:42 +02:00
Michael Kerrisk b758a50ab8 mmap.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-26 14:37:23 +02:00
Michael Kerrisk f1008f5f1d ioctl_userfaultfd.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-26 14:35:11 +02:00
Michael Kerrisk e710f10c36 sigaltstack.2: Note that specifying SS_ONSTACK in ss.ss_falgs decreases portability
In the Illumos source (which presumably mirrors its Solaris
ancestry), there is this check in the sigaltstack()
implementation:

               if (ss.ss_flags & ~SS_DISABLE)
                        return (set_errno(EINVAL));

And in the FreeBSD source we find similar:

                if ((ss->ss_flags & ~SS_DISABLE) != 0)
                        return (EINVAL);

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-23 15:22:33 +02:00
Michael Kerrisk 1f5002208f sigaltstack.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-23 15:21:09 +02:00
Michael Kerrisk bc2fcb73cd sigaltstack.2: ERRORS: update description of EINVAL error
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-22 20:35:57 +02:00
Michael Kerrisk 27009c9956 sigaltstack.2: Note buggy addition of ss.ss_flags==SS_ONSTACK
Note buggy addition of ss.ss_flags==SS_ONSTACK as a synonym
for ss_flags==0. No other implemenation does this, AFAIK.
And it was not needed :-(.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-22 20:27:53 +02:00
Michael Kerrisk 1614a08551 sigaltstack.2: Some minor reworking of the text
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-22 15:54:07 +02:00
Michael Kerrisk b3e2be839b sigaltstack.2: Specifying 'ss' returns the current settings without changing them
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-22 15:38:12 +02:00
Michael Kerrisk 5270d24e4f sigaltstack.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-22 15:12:56 +02:00
Michael Kerrisk 6635bc0197 sigaltstack.2: Give 'oss' argument a more meaningful name: 'old_ss'
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-22 15:06:04 +02:00
Michael Kerrisk eddeadede6 membarrier.2: Add ENOSYS error for 'nohz_full' CPU setting
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-22 14:47:10 +02:00
Michael Kerrisk efaf088ef7 timer_create.2: Document the CONFIG_POSIX_TIMERS option added in Linux 4.10
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-22 14:26:04 +02:00
Michael Kerrisk 547ee3197d mount.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-21 11:59:25 +02:00
Michael Kerrisk 9edbd6867b mount.2: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-21 11:57:58 +02:00
Michael Kerrisk a422236758 mount.2: Minor tweaks to NeilBrown's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-21 11:57:29 +02:00
Michael Kerrisk 0e1a971b94 mount.2: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-21 11:55:21 +02:00
NeilBrown c84a877924 mount.2: Revise description of MS_REMOUNT | MS_BIND
MS_REMOUNT|MS_BIND affect all per-mount-point
flag.  MS_RDONLY is only special because it,
uniquely, is both a per-mount-point flag *and* a
per-filesystem flag.

So the sections of per-mount-point flags and
MS_REMOUNT can usefully be clarified.

Signed-off-by: NeilBrown <neilb@suse.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-21 11:53:13 +02:00
Michael Kerrisk 991c24c881 epoll_wait.2: Clarify semantics of returned 'data' field
The returned 'data' is the 'data' most recently set via
epoll_ctl().

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-20 21:02:00 +02:00
Michael Kerrisk 1b564a4bbc epoll_wait.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-20 20:41:36 +02:00
Jakub Wilk 0fdca71834 sched_setaffinity.2: tfix
Remove duplicated word.

Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-13 13:13:18 +02:00
Michael Kerrisk bcaf6dc0e0 sched_setaffinity.2: Mention cpuset cgroups as a cause of EINVAL error
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-07 21:05:04 +02:00
Michael Kerrisk b9472299a6 chown.2: When file owner or group is changed, file capabilities are cleared
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-06 13:47:27 +02:00
Michael Kerrisk fbfbde8feb chown.2: Changes to file owner by root also clear set-UID and set-GID bits
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-06 13:42:46 +02:00
Michael Kerrisk 16ee728520 setns.2: Minor clarification of details for PID namespaces
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-06 13:29:09 +02:00
Michael Kerrisk 99cf16816c Removed trailing white space at end of lines 2017-05-03 19:28:59 +02:00
Michael Kerrisk 734882f4c4 _exit.2, alarm.2, chmod.2, clone.2, epoll_ctl.2, fcntl.2, fork.2, fsync.2, getdents.2, getpid.2, ioctl.2, ioctl_console.2, ioctl_list.2, ioctl_ns.2, ioctl_tty.2, ioctl_userfaultfd.2, kexec_load.2, lseek.2, mincore.2, mkdir.2, mknod.2, mmap.2, open.2, poll.2, posix_fadvise.2, prctl.2, rename.2, sched_setaffinity.2, select.2, select_tut.2, sigaction.2, signalfd.2, sigprocmask.2, sigwaitinfo.2, socketcall.2, stat.2, statx.2, syscalls.2, truncate.2, umask.2, unshare.2, userfaultfd.2, utime.2, utimensat.2, wait.2, bzero.3, cfree.3, exit.3, getentropy.3, grantpt.3, insque.3, shm_open.3, syslog.3, termios.3, ttyname.3, wcsdup.3, console_codes.4, tty.4, vcs.4, elf.5, nsswitch.conf.5, proc.5, slabinfo.5, tmpfs.5, bootparam.7, environ.7, hostname.7, inotify.7, mailaddr.7, man-pages.7, namespaces.7, pid_namespaces.7, pthreads.7, pty.7, sem_overview.7, signal.7, socket.7, tcp.7, termio.7, user_namespaces.7, xattr.7, ld.so.8, zdump.8: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-03 19:27:48 +02:00
Michael Kerrisk 94a8ebdab2 userfaultfd.2: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-02 22:27:07 +02:00
Jakub Wilk b5fe851595 socket.2, ip.7: tfix
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-02 22:16:46 +02:00
Michael Kerrisk f0ea168c3e ioctl_console.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-02 22:15:45 +02:00
Jakub Wilk c27131bcec ioctl_console.2: tfix
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-02 22:14:42 +02:00
Michael Kerrisk 522ab2ff6f userfaultfd.2: Add a few details on UFFD_EVENT_FORK
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-01 14:14:37 +02:00
Michael Kerrisk 265225c1e2 userfaultfd.2: Minor tweaks to Mike Rapoport's patches
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-01 13:32:56 +02:00
Michael Kerrisk 5191c68806 ioctl_userfaultfd.2: Minor tweaks to Mike Rapoport's patches
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-01 13:24:10 +02:00
Mike Rapoport be9021b1bb userfaultfd.2: Update VERSIONS section with 4.11 changes
Signed-off-by: Mike Rapoport <rppt@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-01 13:10:10 +02:00
Mike Rapoport 20050169e1 userfaultfd.2: Add note about asynchronous event delivery
Signed-off-by: Mike Rapoport <rppt@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-01 13:08:43 +02:00
Mike Rapoport 53004b3ba0 ioctl_userfaultfd.2: Add BUGS section
The features handshake is not quite convenient.
Elaborate about it in the BUGS section.

Signed-off-by: Mike Rapoport <rppt@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-01 13:05:26 +02:00
Mike Rapoport 337405ef74 ioctl_userfaultfd.2: UFFDIO_COPY: add ENOENT and ENOSPC description
Signed-off-by: Mike Rapoport <rppt@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-01 13:03:58 +02:00
Mike Rapoport 41e9e6485a ioctl_userfaultfd.2: Update description of shared memory areas
Signed-off-by: Mike Rapoport <rppt@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-01 13:03:05 +02:00
Michael Kerrisk 981ffc70eb syscalls.2: Update kernel version number
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-28 12:23:46 +02:00
Michael Kerrisk 2156a7330b syscalls.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-28 12:23:28 +02:00
Jakub Wilk 23db37908f userfaultfd.2: tfix
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-28 10:04:20 +02:00
Jakub Wilk 81bb12333c ioctl_userfaultfd.2: tfix
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-28 10:03:44 +02:00
Michael Kerrisk 42630fa9ae ioctl_userfaultfd.2: Minor fixes to Mike Rapoport's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-27 19:24:55 +02:00
Mike Rapoport 66487517a0 ioctl_userfaultfd.2: Start adding details about userfaultfd features
Signed-off-by: Mike Rapoport <rppt@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-27 19:20:52 +02:00
Michael Kerrisk c2b3668b37 userfaultfd.2: Minor tweaks to Mike Rapoport's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-27 19:19:20 +02:00
Michael Kerrisk 6c12d34e9f userfaultfd.2: Add kernel version numbers for UFFD_EVENT_* flags
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-27 18:01:54 +02:00
Mike Rapoport 5b1c4a1ed7 userfaultfd.2: Start documenting non-cooperative events
Signed-off-by: Mike Rapoport <rppt@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-27 17:36:39 +02:00
Michael Kerrisk 9a38b2cece stat.2: Give 'struct stat' argument a more meaningful name ('statbuf')
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-27 14:28:08 +02:00
Michael Kerrisk 15d1f5acb7 statx.2: Give final argument of call a more meaningful name ('statxbuf')
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-27 14:27:15 +02:00
Michael Kerrisk 09ff9f4adb statx.2: ERRORS: better description for EFAULT
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-27 14:26:31 +02:00
Michael Kerrisk 85dbf7cdd0 statx.2: Remove mention of pathname == NULL case
Kernel commit 1e2f82d1e9d12223b4cbd1feb3f2b5596f8049eb
removed the option to specify 'pathname' as NULL, since
this was redundant with AT_EMPTY_PATH + pathname == "".

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-27 14:20:52 +02:00
Michael Kerrisk 8560f2bf16 vfork.2: spfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-26 23:34:31 +02:00
Michael Kerrisk c859dfb59e statx.2: Minor fixes after notes from David Howells
Reported-by: David Howells <dhowells@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-26 21:09:00 +02:00
Michael Kerrisk fc31d73078 statx.2: Add stx_ino to list of structure feilds
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-26 14:28:16 +02:00
Michael Kerrisk 13470fd3ef statx.2: Reorder the list of structure fields to match the structure definition
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-26 14:28:16 +02:00
Michael Kerrisk aabbefb4d5 statx.2: Fixes from David Howells
Reported-by: David Howells <dhowells@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-26 14:28:16 +02:00
Michael Kerrisk 792570def1 userfaultfd.2: Minor fix-ups
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-26 09:19:08 +02:00
Mike Rapoport d28aadf6c3 usefaultfd.2: Add brief description of "non-cooperative" mode
Signed-off-by: Mike Rapoport <rppt@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-26 09:19:08 +02:00
Mike Rapoport 184481665f userfaultfd.2: Add Linux container migration use-case to NOTES
Signed-off-by: Mike Rapoport <rppt@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-26 09:19:08 +02:00
Michael Kerrisk 1a053be3c7 ioctl_userfaultfd.2: Minor fix-ups to Mike Rapoport's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-26 09:19:08 +02:00
Mike Rapoport 30dced3378 ioctl_userfaultfd.2: Update UFFDIO_API description
Signed-off-by: Mike Rapoport <rppt@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-26 09:19:08 +02:00
Mike Rapoport ba92d8b441 ioctl_userfaultfd.2: Describe memory types that can be used from 4.11
Signed-off-by: Mike Rapoport <rppt@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-26 09:19:08 +02:00
Mike Rapoport c3d5d9df5c userfaultfd.2: Describe memory types that can be used from 4.11
Signed-off-by: Mike Rapoport <rppt@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-26 09:19:08 +02:00
Michael Kerrisk 09f661dabf statx.2: 'tv_nsec' is nanoseconds *since* 'tv_sec'
Reported-by: Dmitry V. Levin <ldv@altlinux.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-26 09:19:03 +02:00
Michael Kerrisk 56a05af6df statx.2: Minor fixes
Reported-by: Silvan Jegen <s.jegen@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 21:39:56 +02:00
Michael Kerrisk 44bd71e02c mincore.2: SEE ALSO: add fincore(1)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 17:17:17 +02:00
Michael Kerrisk 4cb046d329 posix_fadvise.2: SEE ALSO: add fincore(1)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 17:15:48 +02:00
Andrew Clayton 23cae3f629 statx.2: tfix
Signed-off-by: Andrew Clayton <andrew@digital-domain.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 14:47:31 +02:00
Andrew Clayton 7ad5fb5de5 stat.2: tfix
Signed-off-by: Andrew Clayton <andrew@digital-domain.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 14:47:09 +02:00
Michael Kerrisk 20c8cd9a65 statx.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 13:05:15 +02:00
Michael Kerrisk 50c74bdb4e statx.2: srcfix: FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 13:03:27 +02:00
Michael Kerrisk a18cc179a7 ioctl_userfaultfd.2: Drop some unneeded text
From a conversation with Mike Rapoport:

What does "consistent" mean?
    Actually, I though I've copied this text from Andrea's docs,
    but now I've found out it was my wording and I really don't
    remember now what was my intention for "consistent" :) My
    guess is that I was thinking about atomicity of UFFDIO_COPY,
    or the fact that from the faulting thread perspective the
    page fault handling is the same whether it's done in kernel
    or via userfaultfd...  That said, maybe it'd be better just
    to drop "in a consistent way".

Reported-by: Mike Rapoport <rppt@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:40 +02:00
Michael Kerrisk a0f04ef10e ioctl_userfaultfd.2: srcfix: remove obsolete FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:40 +02:00
Michael Kerrisk be7979d754 ioctl_userfaultfd.2: Explain the use case for UFFDIO_WAKE
Reported-by: Mike Rapoport <rppt@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:40 +02:00
Michael Kerrisk d726ff4f8b ioctl_userfaultfd.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:40 +02:00
Michael Kerrisk 1c63cefda2 ioctl_userfaultfd.2: Note that UFFDIO_UNREGISTER address range must be compatible
Reported-by: Mike Rapoport <rppt@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:40 +02:00
Michael Kerrisk d87f377e4e ioctl_userfaultfd.2: Explain concept of "compatible" mapping for UFFDIO_REGISTER
Reported-by: Mike Rapoport <rppt@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:40 +02:00
Michael Kerrisk ef443f0771 ioctl_userfaultfd.2: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:40 +02:00
Michael Kerrisk 9428d7caed ioctl_userfaultfd.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:40 +02:00
Michael Kerrisk b38f1fa225 ioctl_userfaultfd.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:40 +02:00
Michael Kerrisk a440cc336a ioctl_userfaultfd.2: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:40 +02:00
Michael Kerrisk cd8389ff87 ioctl_userfaultfd.2: Add EFAULT errors
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:40 +02:00
Michael Kerrisk b4e9ab9131 ioctl_userfaultfd.2: srcfix: Remove FIXME
According to Mike Rapoport the description of the 'ioctls'
field is accurate.

Reported-by: Mike Rapoport <rppt@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:40 +02:00
Michael Kerrisk d33fa469cc ioctl_userfaultfd.2: Clarify the 'features' field usage for UFFDIO_API
Mike Rapoport notes that changes are coming in Linux 4.11.

Reported-by: Mike Rapoport <rppt@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:40 +02:00
Michael Kerrisk 7b8695f29c userfaultfd.2: Describe close() semantics for userfaultfd
Reported-by: Mike Rapoport <rppt@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:39 +02:00
Michael Kerrisk 1bf00323f5 userfaultfd.2: Note that O_NONBLOCK flag is required for poll() etc.
And better word the associated FIXME.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:39 +02:00
Michael Kerrisk 4f03f0cc36 userfaultfd.2: srcfix: remove a FIXME
According to Mike Rapoport, the details are correct,
"at least for the current upstream version. 4.11 will
have quite a few updates to userfaultfd."

Reported-by: Mike Rapoport <rppt@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:39 +02:00
Michael Kerrisk 53b95540ac ioctl_userfaultfd.2: srcfix: Improve FIXMEs
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:39 +02:00
Michael Kerrisk b4023444af userfaultfd.2: srcfix: improve FIXMEs
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:39 +02:00
Michael Kerrisk 00f4853c43 userfaultfd.2: wsfix
Signed-off-by: Michael Kerrisk <mtk@man7.org>
2017-04-25 12:56:39 +02:00
Michael Kerrisk de6943fab3 userfaultfd.2: Mention some use cases
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:39 +02:00
Michael Kerrisk 6d3e02a507 userfaultfd.2: SEE ALSO: add madvise(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:39 +02:00
Michael Kerrisk 7cb4a3d66e ioctl_userfaultfd.2: Add comments to structure definitions
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:39 +02:00
Michael Kerrisk b8838c257f ioctl_userfaultfd.2: Add pointer to EXAMPLE in userfaultfd(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:39 +02:00
Michael Kerrisk b07243abe1 userfaultfd.2: Add an example program
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:39 +02:00
Michael Kerrisk 3f894561c0 userfaultfd.2: Add a header file to the SYNOPSIS
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:39 +02:00
Michael Kerrisk 0289632060 userfaultfd.2: srcfix: FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:39 +02:00
Michael Kerrisk 058b32ac70 userfaultfd.2: Describe errors for read() on userfaultfd
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:39 +02:00
Michael Kerrisk 68a9e23c1f userfaultfd.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:39 +02:00
Michael Kerrisk 242c2b6b43 ioctl_userfaultfd.2: Add a few more EINVAL error cases/details
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:39 +02:00
Michael Kerrisk 66e11c1f8f ioctl_userfaultfd.2: Improve UFFDIO_WAKE description
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:39 +02:00
Michael Kerrisk 611ec3a39b ioctl_userfaultfd.2: Improve UFFDIO_ZEROPAGE description
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:39 +02:00
Michael Kerrisk 1dca8e3dc3 ioctl_userfaultfd.2: Improve UFFDIO_COPY description
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:39 +02:00
Michael Kerrisk e8a846ae66 ioctl_userfaultfd.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:39 +02:00
Michael Kerrisk 7b28502f1e ioctl_userfaultfd.2: srcfix: FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:39 +02:00
Michael Kerrisk 264a0a30ce ioctl_userfaultfd.2: Improve UFFDIO_REGISTER description
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:39 +02:00
Michael Kerrisk 1b945386ca ioctl_userfaultfd.2: Add kernel versions where each ioctl() first appeared
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:39 +02:00
Michael Kerrisk 52b794f147 ioctl_userfaultfd.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:39 +02:00
Michael Kerrisk a23c93d83c ioctl_userfaultfd.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:38 +02:00
Michael Kerrisk 9a3c219414 ioctl_userfaultfd.2: Improve the UFFDIO_API description
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:38 +02:00
Michael Kerrisk 405513d327 ioctl_userfaultfd.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:38 +02:00
Michael Kerrisk ffbc7efcc2 ioctl_userfaultfd.2: Add another EINVAL error for UFFDIO_API
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:38 +02:00
Michael Kerrisk 24fa87ffa1 ioctl_userfaultfd.2: Add some generic errors common to most/all of the ioctl() operations
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:38 +02:00
Michael Kerrisk 637512edfa ioctl_userfaultfd.2: Rework list of ioctl() operations as subsections
Mainly, this means that we drop one level of indentation, which is
useful, since the error lists also add a level of indentation,
and the text overall becomes a little overindented.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:38 +02:00
Michael Kerrisk fe905357af ioctl_userfaultfd.2: Rework intro text on type of ioctl() operations
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:38 +02:00
Michael Kerrisk 74bd6e931a ioctl_userfaultfd.2: Rework formatting of structures for each ioctl() operation
Trying to place structure names on the same line as the ioctl()
operation names makes the lines two busy. And, conventionally,
the space after a hanging-list constant name is optionally used
to indicate the kernel version number where the constant was
introduced..

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:38 +02:00
Michael Kerrisk 54e031a158 userfaultfd.2: Add information on reading userfaultfd events
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:38 +02:00
Michael Kerrisk 95f1d14991 userfaultfd.2: Add some overview notes on usage
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:38 +02:00
Michael Kerrisk 89bfeedfe9 syscalls.2: Fix kernel version for userfaultfd(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:38 +02:00
Michael Kerrisk 0da8f5c1f1 userfaultfd.2: Add VERSIONS section
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:38 +02:00
Michael Kerrisk 05a59f10f9 userfaultfd.2: srcfix: add FIXMEs
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:38 +02:00
Michael Kerrisk 13acca7011 mmap.2: SEE ALSO: add userfaultfd(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:38 +02:00
Michael Kerrisk b0fab7d7aa ioctl.2: SEE ALSO: add ioctl_userfaultfd(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:38 +02:00
Michael Kerrisk 97b6084bc3 ioctl_userfaultfd.2: New page describing ioctl(2) operations for userfaultfd
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:38 +02:00
Michael Kerrisk 6bc6d12409 userfaultfd.2: Split description of ioctl(2) operation off to a separate page
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:38 +02:00
Michael Kerrisk 0d84ae2f5e userfaultfd.2: Add some more detail for UFFDIO_API
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:38 +02:00
Michael Kerrisk 612d7e763d userfaultfd.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:38 +02:00
Michael Kerrisk 7134f2f4f7 userfaultfd.2: ffix
Reported-by: Andrea Arcangeli <aarcange@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:38 +02:00
Michael Kerrisk 269b235f77 userfaultfd.2: Add details for UFFDIO_WAKE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:38 +02:00
Michael Kerrisk 543ad56e76 userfaultfd.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:38 +02:00
Michael Kerrisk d53cfcc817 userfaultfd.2: Add an introductory section on the ioctl(2) operations
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:38 +02:00
Michael Kerrisk 46c15a0426 userfaultfd.2: Expand description of UFFDIO_UNREGISTER
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:38 +02:00
Michael Kerrisk 01dbb172a1 userfaultfd.2: Correct 'uffdio_range' structure: 'end' ==> 'len'
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:38 +02:00
Michael Kerrisk 5074d8466a userfaultfd.2: Note that UFFDIO_API must be the first ioctl(2)
And note that ioctl() fails with EINVAL if another ioctl(2)
is attempted before UFFDIO_API.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:37 +02:00
Michael Kerrisk a34fda4104 userfaultfd.2: srcfix: FIXME poll/epoll/select
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:37 +02:00
Michael Kerrisk 4aa7f5cf0d userfaultfd.2: Various edits to Mike Rapoport's new page
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:37 +02:00
Mike Rapoport bf9b515861 userfaultfd.2: New page describing userfaultfd(2) system call.
Reviewed-by: Andrea Arcangeli <aarcange@redhat.com>
Signed-off-by: Mike Rapoport <rppt@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:37 +02:00
Michael Kerrisk 175734a832 sched_setaffinity.2: SEE ALSO: add get_nprocs(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-24 21:08:57 +02:00
Michael Kerrisk 4846a5609f syscalls.2: Add membarrier(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-24 20:03:02 +02:00
Michael Kerrisk fd20b364e7 syscalls.2: Include deprecated getunwind(2) in list
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-24 19:59:46 +02:00
Alexander Alemayhu 029b613fba bpf.2: tfix
Signed-off-by: Alexander Alemayhu <alexander@alemayhu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-24 13:17:46 +02:00
Michael Kerrisk 1b206bd82f statx.2: Minor fix: ERRORS in alphabetical order
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-23 20:21:15 +02:00
Michael Kerrisk 790314d7ea statx.2: Minor edits
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-23 20:21:15 +02:00
Michael Kerrisk 393c5b58c3 statx.2: Clarify that the kernel does not reject invalid 'mask' values
And also explain why.

Reported-by: Andreas Dilger <adilger@dilger.ca>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-23 20:21:15 +02:00
Michael Kerrisk f4572b658c statx.2: Minor edit to STATX_* list
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-23 20:21:15 +02:00
Michael Kerrisk 7e43caf4db statx.2: Rework discussion of identification of target file
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-23 20:21:15 +02:00
Michael Kerrisk c8701bafb9 statx.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-23 20:21:15 +02:00
Michael Kerrisk 7a192d0df6 statx.2: Add CONFORMING TO section
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-23 20:21:15 +02:00
Michael Kerrisk f49a8cccd5 statx.2: statx() has no wrapper and must be called using syscall()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-23 20:21:15 +02:00
Michael Kerrisk e6fc15962c chmod.2, fsync.2, mkdir.2, mknod.2, open.2, truncate.2, umask.2, utime.2, utimensat.2: Add/replace references to inode(7)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-23 20:21:15 +02:00
Michael Kerrisk 3b363b623c getdents.2, open.2, stat.2, statx.2: SEE ALSO: add inode(7)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-23 20:21:15 +02:00
Michael Kerrisk 19cda35de9 statx.2: Remove information migrated to inode(7)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-23 20:21:14 +02:00
Michael Kerrisk 96dea201cd stat.2: Minor edits
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-23 20:21:14 +02:00
Michael Kerrisk e8ff4f53ab stat.2: Remove information migrated to inode(7) page
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-23 20:19:43 +02:00
Michael Kerrisk 835f429363 statx.2: Minor edits
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-23 20:19:43 +02:00
Michael Kerrisk 108cd6a3d0 statx.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-23 13:34:59 +02:00
Michael Kerrisk 46711e96c6 statx.2: spfix (American spelling)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-23 13:34:59 +02:00
Michael Kerrisk 77a09ad741 statx.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-23 13:34:59 +02:00
Michael Kerrisk ffe297ee2a statx.2: srcfix: rewrap source lines
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-23 13:34:59 +02:00
Michael Kerrisk 709f7bb642 statx.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-23 13:34:58 +02:00
Michael Kerrisk 14b5d02a46 statx.2: srcfix: rewrap source lines
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-23 13:34:58 +02:00
Michael Kerrisk 6a4667aaa3 statx.2: Minor wording and formatting fix-ups
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-23 13:34:58 +02:00
David Howells 9905e59b55 statx.2: New page describing statx(2) system call added in Linux 4.11
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-23 13:34:55 +02:00
Michael Kerrisk b3deaf0f74 stat.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-23 13:33:30 +02:00
David Howells 97ee9f3732 stat.2: ERRORS: correct description of ENOENT
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-23 13:30:35 +02:00
Michael Kerrisk fb00408109 syscalls.2: Linux 4.11 added statx()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-23 13:30:35 +02:00
Michael Kerrisk f6eae219d9 stat.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-21 22:01:55 +02:00
Michael Kerrisk 58441c4fc0 stat.2: Remove "Other systems" subsection
These details about other systems were added in 1999,
and were probably of limited use then, and even less today.
However, they do clutter the page, so remove them.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-21 22:01:40 +02:00
Michael Kerrisk 9152b8c9cf stat.2: Add some subsection headings to ease readability
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-21 15:29:28 +02:00
Michael Kerrisk 28f042cca7 stat.2: Minor list reordering
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-21 15:26:22 +02:00
Michael Kerrisk 78909f3e1d stat.2: DESCRIPTION: add list entries for 'st_uid' and 'st_gid'
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-21 15:23:55 +02:00
Michael Kerrisk d41bfb204e stat.2: DESCRIPTION: add a list entry for 'st_nlinks' field
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-21 15:20:59 +02:00
Michael Kerrisk cafa975264 stat.2: DESCRIPTION: add a list entry for 'st_ino'
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-21 15:19:33 +02:00
Michael Kerrisk c61617be60 stat.2: Add slightly expanded description oif 'st_ino' field
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-21 15:17:52 +02:00
Michael Kerrisk 53cb52e502 stat.2: Restructure filed descriptions as a hanging list
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-21 15:06:09 +02:00
Michael Kerrisk ba29187129 stat.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-21 14:44:25 +02:00
Michael Kerrisk bb0b0beecd ioctl_ns.2: Document the NS_GET_OWNER_UID operation added in Linux 4.11
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-21 12:32:01 +02:00
Michael Kerrisk a1a3cae896 ioctl_ns.2: ERRORS: document ENOTTY
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-21 12:20:05 +02:00
Michael Kerrisk 2546f8a637 ioctl_ns.2: Document the NS_GET_NSTYPE operation added in Linux 4.11
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-21 12:15:00 +02:00
Michael Kerrisk fedefd800e kexec_load.2, sched_setaffinity.2, bootparam.7: Documentation/kernel-parameters.txt is now in Documentation/admin-guide/
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-20 13:22:12 +02:00
Mike Frysinger 261c7e1d15 prctl(2): PR_SET_MM: Refine CONFIG_CHECKPOINT_RESTORE requirement
The Linux 3.10 release dropped the c/r requirement and opened it
up to all users.

Signed-off-by: Mike Frysinger <vapier@chromium.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-19 15:52:04 +02:00
Mike Frysinger 7e3236a5a0 prctl(2): PR_SET_MM: Document new PR_SET_MM_MAP{,_SIZE} helpers
Signed-off-by: Mike Frysinger <vapier@chromium.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-19 15:52:04 +02:00
Mike Frysinger a87d0921a7 prctl(2): PR_SET_MM: Document arg4/arg5 zero behavior
The kernel will immediately reject calls where arg4/arg5 are not
zero.  See kernel/sys.c:prctl_set_mm().

Signed-off-by: Mike Frysinger <vapier@chromium.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-19 15:52:04 +02:00
Michael Kerrisk d983a4c854 rename.2: Note that there is no glibc wrapper for renameat2()
Reported-by: Georg Sauthoff <mail@georg.so>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-19 15:52:04 +02:00
Michael Kerrisk 2f7a331e53 clone.2, unshare.2: Exceeding one of the limits in /proc/sys/user/* can cause ENOSPC
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-19 15:52:03 +02:00
Michael Kerrisk b5742eccf1 clone.2, unshare.2: Exceeding the maximum nested user namespace limit now gives ENOSPC
Formerly, if the limit of 32 nested user namespaces was exceeded,
the error EUSERS resulted. Starting with Linux 4.9, the error
is ENOSPC.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-19 15:52:03 +02:00
Michael Kerrisk b20e22aeb7 clone.2, unshare.2: CLONE_NEWPID yields ENOSPC if nesting limit of PID namespaces is reached
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-19 15:52:03 +02:00
Michael Kerrisk aa825b59ec clone.2: CLONE_NEWCGROUP by an unprivileged process also causes an EPERM error
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-19 15:52:03 +02:00
Michael Kerrisk 96580790f7 sigprocmask.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-16 20:57:52 +02:00
Michael Kerrisk b9ad845d01 sigprocmask.2: 'set' and 'oldset' can both be NULL
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-16 20:56:20 +02:00
Marcin Ślusarz b78969acbb stat.2: Tweak description of AT_EMPTY_PATH
Currently it says when dirfd is AT_FDCWD it can be something
other than directory, which doesn't make much sense. Just swap
the order of sentences.

Signed-off-by: Marcin Ślusarz <marcin.slusarz@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-10 16:19:15 +02:00
Cyril Hrubis 108e40cccb ioctl_list.2: BLKRASET/BLKRAGET take unsigned long
The BLKRASET/BLKRAGET ioctls() take unsigned long, if I pass int * to
the BLKRAGET ioctl on x86_64 (or on any other arch where sizeof(int) !=
sizeof(long)) the BLKRAGET ioctl will rewrite four bytes on the stack.

If you look at block/ioctl.c in kernel sources you can clearly see that
BLKRAGET ioctl calls put_long().

Compile following reproducer and run it as ./a.out /dev/sda, you can see
that the second member of the array will be zeroed. If you change the
array to have only one member you will see stack smashing trace.

I also wonder if it's OK to pass int value to ioctl() at all, the arg
value seems to be unsigned long in the syscall definition in fs/ioctl.c
and there does not seem to be any glibc magic around the syscall.

-------------------------8<----------------------------

static int fd;

int main(int argc, char *argv[])
{
	int ra[] = {100, 100};

	fd = open(argv[1], O_RDONLY);
	if (fd < 0) {
		perror("open");
		return 1;
	}

	ioctl(fd, BLKRAGET, ra);

	fprintf(stderr, "%i %i\n", ra[0], ra[1]);

	return 0;
}

-------------------------8<----------------------------

Reviewed-by: Arnd Bergmann <arnd@arndb.de>
Signed-off-by: Cyril Hrubis <chrubis@suse.cz>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-10 16:16:04 +02:00
Michael Kerrisk acf0d7db21 fcntl.2: File seals are not generally applicable to tmpfs(5) files
As far as I can see, file seals can be applied only to
memfd_create(2) file descriptors. This was checked by experiment
and by reading mm/shmem.c::shmem_get_inode((), where one finds
the following line that applies to all new shmem files:

                info->seals = F_SEAL_SEAL;

Only in the code of the memfd_create() system call is this
setting reversed (in mm/shmem.c::memfd_create):

        if (flags & MFD_ALLOW_SEALING)
                info->seals &= ~F_SEAL_SEAL;

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-10 13:47:50 +02:00
Michael Kerrisk 5c92cfd352 mmap.2: Remove ancient reference to flags that appear on some other systems
MAP_AUTOGROW, MAP_AUTORESRV, MAP_COPY, and MAP_LOCAL may have
appeared on some systems many years ago, but  the discussion here
mentions no details and the systems and flags probably ceased to
be relevant long ago. So, remove this text.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-10 13:47:50 +02:00
Michael Kerrisk a88f0e061a _exit.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-10 13:47:49 +02:00
Michael Kerrisk ccb3ff19e4 _exit.2: Only the least significant byte of exit status is passed to the parent
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-10 13:47:49 +02:00
Michael Kerrisk 661cfc7eca execve.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-10 13:47:49 +02:00
Michael Kerrisk 8b7365ac02 execve.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-10 13:47:49 +02:00
Michael Kerrisk 2a73d3e870 sigaction.2: Show the prototype of an SA_SIGINFO signal handler
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-10 13:47:49 +02:00
Michael Kerrisk 69ccc9f11d fcntl.2: Mention memfd_create() in the discussion of file seals
Give the reader a clue about what kinds of objects can
be employed with file seals.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-10 13:47:49 +02:00
Michael Kerrisk 967631f2c8 epoll_ctl.2: Give the reader a clue that the 'events' field can be zero
'events' specified as zero still allows EPOLLHUP and
EPOLLERR to be reported.

Reported-by: Nicolas Biscos <nicolas.biscos+man7@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-10 13:47:49 +02:00
Michael Kerrisk 25c2dd2f87 epoll_ctl.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-31 06:54:35 +02:00
Michael Kerrisk 0dea65b805 epoll_ctl.2: Defer to poll(2) for an explanation of EPOLLIN
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-31 06:54:35 +02:00
Michael Kerrisk 4258cf6d03 epoll_ctl.2: EPOLLERR is also set on write end of a pipe when the read end is closed
Reported-by: Nicolas Biscos <nicolas.biscos+man7@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-31 06:54:22 +02:00
Michael Kerrisk b3da9249db poll.2: POLLERR is also set on write end of a pipe when the read end is closed
Reported-by: Nicolas Biscos <nicolas.biscos+man7@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-31 06:54:17 +02:00
Michael Kerrisk d871cf8569 select.2: Refer to POLLPRI in poll(2) for info on exceptional conditions
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-30 17:30:38 +02:00
Michael Kerrisk cd2ea4b451 select.2: Give a hint that sets must be reinitialized if using select() in a loop
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-30 17:30:38 +02:00
Michael Kerrisk 47da6ce7fd select.2: Minor wording fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-30 17:30:38 +02:00
Michael Kerrisk e629dd7890 poll.2: Expand discussion of POLLPRI
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-29 12:30:50 +02:00
Michael Kerrisk 3352f57925 ioctl_tty.2: Packet mode state change events give POLLPRI events for poll(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-29 12:30:50 +02:00
Michael Kerrisk 4448aa21a4 ioctl_console.2: Note type of 'argp' for a various operations
For some commands, there was no clear statement about the type
of the 'argp' argument.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-29 12:30:50 +02:00
Michael Kerrisk e86f51acba ioctl_console.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-29 12:30:50 +02:00
Michael Kerrisk a9168840a2 ioctl.2, ioctl_console.2, select_tut.2, termios.3, tty.4, pty.7, termio.7: Change page cross-references from tty_ioctl(4) to ioctl_tty(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-29 12:30:50 +02:00
Michael Kerrisk a78f675264 ioctl_tty.2: Minor clean ups after page rename
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-29 12:29:44 +02:00
Michael Kerrisk 6d8d77ee88 ioctl_tty.2: Renamed from tty_ioctl(4)
All other ioctl(2) pages are in section 2. Make this
page consistent.
2017-03-29 12:29:44 +02:00
Michael Kerrisk d49a22201d ioctl.2, termios.3, console_codes.4, tty.4, tty_ioctl.4, vcs.4: Change page cross-references for console_ioctl(4) to ioctl_console(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-29 12:29:18 +02:00
Michael Kerrisk 693dc407a6 ioctl_console.2: Minor clean ups after page rename
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-29 07:11:54 +02:00
Michael Kerrisk 1f00fea7df ioctl_console.2: Renamed from console_ioctl.4
Most ioctl() man pages are in section 2, so move this one there
for consistency.
2017-03-29 07:11:21 +02:00
Michael Kerrisk 1804f37dea poll.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-29 06:49:17 +02:00
Michael Kerrisk ab264bff4f select.2: Show correspondence between select() and poll() readiness notifications
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-29 06:49:10 +02:00
Michael Kerrisk c5cd305ddd fork.2: SEE ALSO: add pthread_atfork(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-25 08:20:24 +01:00
Michael Kerrisk 1a116ea001 select.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-24 15:51:25 +01:00
Michael Kerrisk 3116bbe074 select.2: Move mislocated text describing the self-pipe text from BUGS to NOTES
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-24 15:38:12 +01:00
Michael Kerrisk 8b58a9d467 select.2: Linux select() is buggy wrt POSIX in its check for EBADF errors
Reported-by: Matthew Wilcox <willy@infradead.org>
Reported-by: Carlos O'Donell <carlos@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-24 15:32:32 +01:00
Dmitry V. Levin ad8c02ab2e sigprocmask.2: Do not specify an exact value of rt_sigprocmask's 4th argument
As sizeof(kernel_sigset_t) is not the same for all architectures,
it would be better not to mention any numbers as its value.

Signed-off-by: Dmitry V. Levin <ldv@altlinux.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-24 14:39:32 +01:00
Alexander Miller 86e5364425 getdtablesize.2, attr.5: Move .so directive to first line
Improves compatibility with the man and other dumb tools
that process man page files.

Signed-off-by: Alexander Miller <alex.miller@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-24 14:31:11 +01:00
Michael Kerrisk 56fbdd27e1 lseek.2: SEE ALSO: add fallocate(2)
Both of these pages discuss file holes.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-20 20:40:19 +01:00
Mike Frysinger f576fff526 socketcall(2): Document call argument
Signed-off-by: Mike Frysinger <vapier@gentoo.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-20 17:44:36 +01:00
Michael Kerrisk eb4aa52142 futex.2: Minor wording fix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-20 07:10:08 +01:00
Michael Kerrisk 94e460d409 prctl.2: Explain rationale for use of subreaper processes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-17 12:33:58 +01:00
Michael Kerrisk f0fb21d143 keyctl.2: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-17 06:59:25 +01:00
Jakub Wilk 34eba7348e keyctl.2: tfix
Remove duplicated word.

Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-17 06:56:33 +01:00
Michael Kerrisk 65c031fbbe epoll_create.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-17 06:54:32 +01:00
Michael Kerrisk 09c5121268 alarm.2: SEE ALSO: add timer_create(2) and timerfd_create(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-17 06:54:32 +01:00
Michael Kerrisk cbd17ac092 getpid.2: Mention init(1) and "subreapers" in discussion of parent PID
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-17 06:54:32 +01:00
Michael Kerrisk fbc639312f prctl.2: Improve description of PR_SET_CHILD_SUBREAPER
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-17 06:54:32 +01:00
Michael Kerrisk d59a75720f prctl.2: Note semantics of child_subreaper setting on fork() and exec()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-17 06:54:32 +01:00
Michael Kerrisk a98e03042a open.2: Minor wording fix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-17 06:54:32 +01:00
Michael Kerrisk 3f092cefb0 open.2: Add statx() to list of "at" calls in rationale discussion
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-17 06:54:27 +01:00
Michael Kerrisk cfbe21a4d1 wait.2: Orphaned children may be adopted by a "subreaper", rather by than PD 1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-15 12:46:35 +01:00