LDP
/
man-pages
mirror of https://github.com/mkerrisk/man-pages
0
1
Fork 0
Code Releases Activity
16,890 Commits 1 Branch 197 Tags 93 MiB
Commit Graph

6491 Commits

Author SHA1 Message Date
Michael Kerrisk 4b3a5f018a perf_event_open.2: Minor wording fixes 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-17 11:17:35 +02:00
Michael Kerrisk edb3e31604 perf_event_open.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-17 10:54:57 +02:00
Michael Kerrisk 4af2757220 perf_event_open.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-17 10:53:31 +02:00
Michael Kerrisk 7a10da70f2 perf_event_open.2: ffix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-17 08:44:55 +02:00
Michael Kerrisk 4199d3a14b perf_event_open.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-17 08:37:37 +02:00
Dave Hansen 46012ba3ff perf_event_open.2: PERF_RECORD_LOST_SAMPLES record type 
Linux 4.2 added a new record type: PERF_RECORD_LOST_SAMPLES
It is generated when hardware samples (currently only Intel PEBS)
are lost.

Signed-off-by: Vince Weaver <vincent.weaver@maine.edu>
 2016-10-17 08:35:42 +02:00
Vince Weaver dde354c979 perf_event_open.2: PERF_SAMPLE_BRANCH_IND_JUMP branch_sample_type 
Linux 4.2 added a new branch_sample_type: PERF_SAMPLE_BRANCH_IND_JUMP

Signed-off-by: Vince Weaver <vincent.weaver@maine.edu>
 2016-10-15 09:12:53 +02:00
Michael Kerrisk 5d73bc3fe4 perf_event_open.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-14 12:54:42 +02:00
Michael Kerrisk dc9ec146ab perf_event_open.2: ffix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-14 12:46:12 +02:00
Michael Kerrisk 974cb9565b perf_event_open.2: ffix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-14 12:37:58 +02:00
Michael Kerrisk 5dd3feec96 perf_event_open.2: Minor tweaks to Vince Weaver's patch 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-14 12:35:43 +02:00
Vince Weaver fd133d5dc4 perf_event_open.2: Document sample_max_stack and /proc/sys/kernel/perf_event_max_stack 
Linux 4.8 added a new sample_max_stack parameter, as well as
/proc/sys/kernel/perf_event_max_stack which limits it and a new
EOVERFLOW error return.

Signed-off-by: Vince Weaver <vincent.weaver@maine.edu>
 2016-10-14 12:31:59 +02:00
Michael Kerrisk ca8b1e32a9 clone.2: Minor wording fix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-13 16:53:32 +02:00
Michael Kerrisk b5da2f9178 clone.2: The CLONE_*_SETTID operations store TID before return to user space 
CLONE_PARENT_SETTID and CLONE_CHILD_SETTID store the new
TID before clone() returns to user space

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-13 15:48:37 +02:00
Michael Kerrisk 4ba5392d3b clone.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-13 15:46:44 +02:00
Michael Kerrisk 3cb972b3bb get_mempolicy.2: Note that 'addr' must be NULL when 'flags' is 0 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-13 09:58:34 +02:00
Michael Kerrisk bafd3d1f0f get_mempolicy.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-13 09:56:55 +02:00
Michael Kerrisk c5ae834f01 get_mempolicy.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-13 09:40:44 +02:00
Michael Kerrisk dedc639c67 get_mempolicy.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-13 09:40:21 +02:00
Michael Kerrisk 8831d4641d mbind.2, set_mempolicy.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-13 09:38:59 +02:00
Michael Kerrisk d0749cdf78 set_mempolicy.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-13 09:22:30 +02:00
Michael Kerrisk 3f87f45fd7 mbind.2: Reformat list of mode values 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-13 09:20:39 +02:00
Michael Kerrisk b763062b2b mbind.2, set_mempolicy.2: wfix: "ids" --> "IDs" 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-13 09:16:52 +02:00
Michael Kerrisk e3b2c608de mbind.2: ffix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-13 09:16:23 +02:00
Michael Kerrisk 8ca0c84dc8 mbind.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-13 09:15:46 +02:00
Michael Kerrisk f5a936f4d7 mbind.2, set_mempolicy.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-13 09:15:19 +02:00
Michael Kerrisk da451626cf set_mempolicy.2: Reformat list of modes 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-13 09:10:59 +02:00
Michael Kerrisk bdf71bd391 set_mempolicy.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-13 09:05:58 +02:00
Michael Kerrisk 4b00657234 mbind.2, set_mempolicy.2: Add kernel version for MPOL_LOCAL 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-13 09:04:40 +02:00
Michael Kerrisk 5fcb90fd09 set_mempolicy.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-13 08:52:46 +02:00
Michael Kerrisk c24b889526 mbind.2: Minor wording fix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-13 08:48:07 +02:00
Michael Kerrisk 70f4be2cbd mbind.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-13 08:45:15 +02:00
Michael Kerrisk 6065b90636 open.2: ubifs supports O_TMPFILE starting with Linux 4.9 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-13 08:00:25 +02:00
Michael Kerrisk 511db268c6 mbind.2: srcfix: remove a FIXME 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-13 07:57:24 +02:00
Michael Kerrisk f64cc74595 killpg.2, crypt.3, mbsinit.3, printf.3, rpc.3, ulimit.3, wprintf.3, xdr.3, fd.4, elf.5, group.5: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-12 16:03:38 +02:00
Michael Kerrisk c0649ed51d mbind.2, set_mempolicy.2: Minor tweaks to Piotr Kwapulinski's patch 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-12 09:49:31 +02:00
Michael Kerrisk 5e38e258ec mbind.2, set_mempolicy.2: srcfix: rewarp source lines 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-12 09:46:56 +02:00
Piotr Kwapulinski a2b94599f4 set_mempolicy.2,mbind.2: Add MPOL_LOCAL NUMA memory policy documentation 
The MPOL_LOCAL mode has been implemented by
Peter Zijlstra <a.p.zijlstra@chello.nl>
(commit: 479e2802d09f1e18a97262c4c6f8f17ae5884bd8).
Add the documentation for this mode.

Reviewed-by: Christoph Lameter <cl@linux.com>
Signed-off-by: Piotr Kwapulinski <kwapulinski.piotr@gmail.com>
 2016-10-12 09:40:43 +02:00
Michael Kerrisk 77483b7c9b posix_fadvise.2: tfix 
Reported-by: Marcos Mello <marcosfrm@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-12 09:26:28 +02:00
Michael Kerrisk 2433365bde clone.2: tfix 
Reported-by: Elliott Hughes <enh@google.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-08 20:19:16 +02:00
Michael Kerrisk ac64534c7f Removed trailing white space at end of lines 2016-10-08 14:08:24 +02:00
Michael Kerrisk b8efb41432 memusage.1, memusagestat.1, pldd.1, accept.2, adjtimex.2, arch_prctl.2, bdflush.2, bpf.2, close.2, epoll_ctl.2, epoll_wait.2, execve.2, execveat.2, fanotify_init.2, fanotify_mark.2, fcntl.2, fsync.2, get_kernel_syms.2, getdomainname.2, getgroups.2, gethostname.2, getrandom.2, getrlimit.2, getrusage.2, getsid.2, getunwind.2, io_getevents.2, ioctl_fat.2, kexec_load.2, killpg.2, listxattr.2, lseek.2, madvise.2, memfd_create.2, mknod.2, mlock.2, modify_ldt.2, msgctl.2, msgget.2, msgop.2, readlink.2, readv.2, reboot.2, recvmmsg.2, rename.2, request_key.2, restart_syscall.2, sched_setaffinity.2, sched_setattr.2, sched_setparam.2, seccomp.2, select_tut.2, semctl.2, semget.2, semop.2, set_thread_area.2, seteuid.2, setgid.2, setpgid.2, setresuid.2, setreuid.2, setsid.2, setuid.2, shmctl.2, shmget.2, shmop.2, sigaction.2, sigprocmask.2, stat.2, symlink.2, syscall.2, sysctl.2, unlink.2, bindresvport.3, byteorder.3, dlopen.3, endian.3, error.3, ffs.3, fmemopen.3, getcwd.3, getlogin.3, getnetent.3, getprotoent.3, getservent.3, getumask.3, getutent.3, glob.3, isalpha.3, lio_listio.3, login.3, mbsinit.3, mbstowcs.3, mbtowc.3, mkstemp.3, nextup.3, ntp_gettime.3, posix_fallocate.3, posix_spawn.3, pthread_join.3, pthread_rwlockattr_setkind_np.3, random.3, rcmd.3, realpath.3, resolver.3, setjmp.3, setnetgrent.3, sigvec.3, strerror.3, strverscmp.3, system.3, toupper.3, towlower.3, towupper.3, wcstombs.3, wordexp.3, cciss.4, loop.4, mouse.4, random.4, core.5, group.5, hosts.5, resolv.conf.5, ascii.7, environ.7, epoll.7, glob.7, ip.7, mq_overview.7, packet.7, pipe.7, raw.7, sched.7, signal.7, socket.7, symlink.7, ld.so.8, sln.8: tstamp 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-08 14:08:23 +02:00
Michael Kerrisk 914ab99576 keyctl.2: Revert "keyctl.2: updates regarding command usage, return values and error codes" 
This reverts commit 8ec6a2110b.

This patch was accidentally applied in master. The patch needs
more work before it can be released.
 2016-10-08 14:08:23 +02:00
Michael Kerrisk 750653a812 getrusage.2, madvise.2, memfd_create.2, mlock.2, mount.2, getauxval.3, core.5, capabilities.7, pid_namespaces.7, symlink.7, user_namespaces.7: Consistently use /proc/[pid] (not /proc/PID) 
Reported-by: Mike Frysinger <vapier@gentoo.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-07 22:47:23 +02:00
Nikola Forró 85976da34f adjtimex.2: Fix kernel version references 
ADJ_SETOFFSET mode was added in 2.6.39:
$ git tag --contains 094aa1881fdc1b8889b442eb3511b31f3ec2b762 | head -n 1
v2.6.39

ADJ_MICRO and ADJ_NANO modes were added in 2.6.26:
$ git tag --contains eea83d896e318bda54be2d2770d2c5d6668d11db | head -n 1
v2.6.26

Signed-off-by: Nikola Forró <nforro@redhat.com>
 2016-10-07 16:37:53 +02:00
Michael Kerrisk 760b892c1b nanosleep.2: wfix: rework some text around historical behavior 
Referring to "current" Linux 2.4 kernels is strange...

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-07 09:13:58 +02:00
Michael Kerrisk bdcb70566a nanosleep.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-07 09:13:58 +02:00
Michael Kerrisk 3a03cb85b0 getunwind.2: Simplify text referring to vdso(7) 
The detail given here is redundant, since this info is also
in vdso(7).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-07 09:13:58 +02:00
Bill Pemberton 175b0eec24 semctl.2: wfix: CONFORMING TO: change a POSIX.1-2001 to POSIX.1-2008 
The section had POSIX.1-2001 listed twice in a row instead of
POSIX.1-2001 and POSIX.1-2008

Signed-off-by: Bill Pemberton <wfp5p@worldbroken.com>
 2016-10-07 09:13:58 +02:00
Michael Kerrisk bd79a35ae9 open.2: F2FS support for O_TMPFILE was added in Linux 3.16 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-07 09:13:57 +02:00
Eugene Syromyatnikov 8ec6a2110b keyctl.2: updates regarding command usage, return values and error codes 
Hello.

I've drafted some updates to the keyctl.2 man page while preparing test
for strace syscall decoder. It is focused mostly on description of argument
format used in various commands and return values/error codes.
Information is based on Documentation/security/keys.txt,
include/uapi/linux/keyctl.h, and source code and comments in
security/keys/ (mostly comments from security/keys/keyctl.c).
Hope you find it useful.
 2016-10-07 09:13:57 +02:00
Michael Kerrisk 2a15a76bba clone.2: Document raw syscall interfaces on various other architectures 
Reported-by: Josh Triplett <josh@joshtriplett.org>
Reviewed-by: Josh Triplett <josh@joshtriplett.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-07 09:13:57 +02:00
Michael Kerrisk fda554706b clone.2: Change types for 'ptid' and 'ctid' in syscall prototypes 
These types changed from 'void *' to 'int *' back in Linux 3.8.
The new types are closer to reality, so just update the page
without discussing the history.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-07 09:13:44 +02:00
Keno Fischer dd6d3d2e5f clone.2: Adjust syscall prototype and expand CLONE_SETTLS description 
The prototype for the system call was added in kernel commit
81f10dad, but looking at the kernel's fork.c, I believe the
relevant definition is

SYSCALL_DEFINE5(clone, unsigned long, clone_flags,
                unsigned long, newsp,
                int __user *, parent_tidptr,
                int __user *, child_tidptr,
                unsigned long, tls)

so the last argument is the tls argument, not a pt_regs argument.
I stumbled upon this while trying to understand CLONE_SETTLS, so
I expanded that description a little to cover other architectures.

Reviewed-by: Josh Triplett <josh@joshtriplett.org>
 2016-09-25 21:00:52 +02:00
Michael Kerrisk cf0588ad39 execve.2: Note that real UID, real GID, and supplementary GIDs are unchanged 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-22 10:52:37 +02:00
Michael Kerrisk a9eb4a803e fork.2: ffix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-22 10:47:03 +02:00
Michael Kerrisk 5a1fa66f9e fork.2: PID of new process also does not match any existing session ID 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-22 10:45:04 +02:00
Michael Kerrisk 869c706fbf quotactl.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-22 08:58:34 +02:00
Michael Kerrisk d38f98b6c2 quotactl.2: ffix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-22 08:49:57 +02:00
Michael Kerrisk 093b6f2026 quotactl.2: Tweaks to Eugene Syromyatnikov's patches 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-21 15:40:56 +02:00
Eugene Syromyatnikov 955ea4e7e1 quotactl.2: wfix 2016-09-21 14:56:03 +02:00
Eugene Syromyatnikov 90d79b64c8 quotactl.2: Updated information regarding XFS-specific quotactl subcommands 
Added information regarding structure definitions used for
XFS-specific subcommands, updated flag constants, added
information regarding ignored syscall arguments, added notes on
usage of kernel UAPI header.
 2016-09-21 14:55:30 +02:00
Eugene Syromyatnikov 2219bd3f59 quotactl.2: Updated information regarding disk quota flags 
Added information regarding DQF_SYS_FILE flag; updated definition
of V1_DQF_RSQUASH, which has been defined privately and defined
publicly as DQF_ROOT_SQUASH.
 2016-09-21 14:54:52 +02:00
Eugene Syromyatnikov b5b42cc585 quotactl.2: Additions regarding project quotas 
Added information regarding presence of project quotas.
 2016-09-21 14:54:37 +02:00
Michael Kerrisk a644bc4824 prctl.2: Simplify list of cases where "dumpable" attribute is reset 
Simplify list of cases that cause dumpable attribute to
reset to suid_dumpable: there were two lists that together
in effect had many duplicates.

Also some minor rewordings.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-21 12:46:10 +02:00
Michael Kerrisk 161946a262 prctl.2: Refer to proc(5) for effects of dumpability on ownership of /proc/PID/* 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-21 12:46:09 +02:00
Michael Kerrisk 982d8cf740 prctl.2: Minor fix: add a reference to ptrace(2) for PR_SET_DUMPABLE 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-21 12:46:09 +02:00
Mike Crowe c1a2cf47ee epoll_wait.2: Clarify that the timeout is measured against CLOCK_MONOTONIC 
The existing page left the choice of clock as ambiguous. My
reading of the kernel implementation is that CLOCK_MONOTONIC is
always used since ep_poll() calls schedule_hrtimeout_range(),
which calls schedule_hrtimeout_range_clock() passing
CLOCK_MONOTONIC.

References:
 http://lxr.free-electrons.com/source/fs/eventpoll.c?v=4.7#L1614
 http://lxr.free-electrons.com/source/kernel/time/hrtimer.c?v=4.7#L1785

The "measured against" terminology was borrowed from nanosleep.2.

I've checked all the way back to Linux v2.6.12 where the
calculation was done using jiffies so I think that this has
effectively always been true.

Signed-off-by: Mike Crowe <mac@mcrowe.com>
 2016-09-20 13:24:50 +02:00
Michael Kerrisk 8d82515260 futex.2: srcfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-16 17:27:52 +02:00
Michael Kerrisk 24493e9b2f bpf.2: srcfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-16 17:26:51 +02:00
Michael Kerrisk 4d543007c4 clone.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-16 17:23:09 +02:00
Michael Kerrisk 7f02887d29 execve.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-16 12:38:18 +02:00
Michael Kerrisk 4ab9f1db3d prctl.2: ERRORS: Add EACCES error for PR_SET_SECCOMP-SECCOMP_MODE_FILTER 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-16 12:35:45 +02:00
Michael Kerrisk d4748fad9f clone.2: EINVAL is generated by glibc wrapper for NULL 'fn' or 'child_stack' 
Clarify that this error is produced by the wrapper function, not
the underlying system call. In particular, the point is that the
raw system call can accommodate a NULL pointer for 'child_stack'.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-15 18:39:57 +02:00
Michael Kerrisk 47c906e5c4 open.2: Clarify user namespace capability requirements for O_NOATIME 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-12 20:34:22 +01:00
Michael Kerrisk 3294109d14 msgctl.2, msgget.2, msgop.2, semctl.2, semget.2, semop.2, shmctl.2, shmget.2, shmop.2: Note the user namespace requirements for CAP_IPC_OWNER 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-12 20:34:22 +01:00
Michael Kerrisk d4dabee19b chroot.2: Note user namespace requirements for CAP_SYS_CHROOT 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-12 20:34:21 +01:00
Michael Kerrisk c387fb9b2c setuid.2: Note user namespace requirements for CAP_SETUID 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-12 20:34:21 +01:00
Michael Kerrisk 36a62e0379 setreuid.2: Note user namespace requirements for CAP_SETUID and CAP_SETGID 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-12 16:54:36 +01:00
Michael Kerrisk fb03f4addc setresuid.2: Note user namespace requirements for CAP_SETUID 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-12 16:54:36 +01:00
Michael Kerrisk 6f22721ecb setgid.2: Note user namespace requirements for CAP_SETGID 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-12 16:54:36 +01:00
Michael Kerrisk 52f2c8fb7e setgid.2: ffix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-12 16:54:36 +01:00
Michael Kerrisk 1a54ad1eae seteuid.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-12 16:54:36 +01:00
Michael Kerrisk cdbc9e153d seteuid.2: Note user namespace requirements for CAP_SETUID and CAP_SETGID 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-12 16:54:36 +01:00
Michael Kerrisk 7127bd53ee setuid.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-12 16:54:36 +01:00
Michael Kerrisk 0e332aef5f setresuid.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-12 16:54:36 +01:00
Michael Kerrisk 02a0d14238 setgid.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-12 16:54:36 +01:00
Michael Kerrisk 67453c5afe kill.2: Minor wording fix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-12 16:54:36 +01:00
Michael Kerrisk 0a58b1ae5c kill.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-12 16:54:36 +01:00
Michael Kerrisk be8f12726e seccomp.2: CAP_SYS_ADMIN is required only in caller's user namespace 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-12 16:54:28 +01:00
Michael Kerrisk 32dbbd6416 getrlimit.2: Note user namespace semantics for CAP_SYS_RESOURCE 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-12 14:04:45 +01:00
Michael Kerrisk e31d1beb76 getgroups.2: Note user namespace requirements for CAP_SETGID 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-12 14:04:45 +01:00
Michael Kerrisk 2ff964df8f getdomainname.2: Note user namespace requirements for CAP_SYS_ADMIN 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-12 14:04:45 +01:00
Michael Kerrisk 6e87fb0b6e gethostname.2: Note user namespace requirements for CAP_SYS_ADMIN 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-12 14:04:45 +01:00
Michael Kerrisk af53fcb53e prctl.2: Note user namespace requirements for PR_CAPBSET_DROP CAP_SETPCAP 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-12 14:04:45 +01:00
Michael Kerrisk a0b4ac2c1c reboot.2: Note user namespace requirements around CAP_SYS_BOOT 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-12 14:04:45 +01:00
Michael Kerrisk 1090e3f079 sched_setaffinity.2: Note user namespace requirements for CAP_SYS_NICE 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-12 14:04:45 +01:00
Michael Kerrisk 097ccd1a89 kill.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-12 14:04:45 +01:00
Michael Kerrisk a354707257 kill.2: srcfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-12 14:04:45 +01:00
Michael Kerrisk 7de0791306 kill.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-12 14:04:45 +01:00
Michael Kerrisk 1b1ebece3c kill.2: Note the user namespace requirement for CAP_KILL 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-12 14:04:45 +01:00
Michael Kerrisk 6fee0ca3ba killpg.2: Refer reader to kill(2) for signal permission rules 
Rather than repeating details here, refer the reader to kill(2)
(so that the rules are in a canonical location, and need only
be edited in one place for future changes--see next commit).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-12 14:04:45 +01:00
Michael Kerrisk 40ff9e27dc fcntl.2: Note an important detail of F_SETOWN permission rules for signals 
F_SETOWN records the caller's credentials at the time of
the fcntl() call, and it is these saved credentials that
are used for subsequent permission checks.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-12 14:04:45 +01:00
Michael Kerrisk 81554da338 close.2: Add mention of the close-on-exec flag 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-12 13:54:38 +01:00
Michael Kerrisk cfa21a0b8f umask.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-12 07:39:40 +01:00
Michael Kerrisk ddf5e4ab24 open.2: Clarify the rules about how the group ID of a new file is determined 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-12 07:39:40 +01:00
Michael Kerrisk 40169a93c1 open.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-12 07:39:40 +01:00
Michael Kerrisk 7351ae87ea open.2: ffix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-12 07:39:40 +01:00
Michael Kerrisk 3d8af60347 getsid.2: Rework description to be somewhat clearer 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-12 07:39:40 +01:00
Michael Kerrisk 1986f06518 setsid.2: Refer to credentials(7) for details for details on controlling terminal 
Refer to credentials(7) for details of how a session obtains
a controlling terminal.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-12 07:39:40 +01:00
Michael Kerrisk a12db8121c getsid.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-12 07:39:39 +01:00
Michael Kerrisk ff437c946b getsid.2: Correct the definition of "session ID" 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-12 07:39:33 +01:00
Michael Kerrisk 343313da58 setpgid.2: Minor wording fix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-12 06:50:16 +01:00
Michael Kerrisk b40e567a40 setsid.2: Minor wording fixes 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-12 06:49:14 +01:00
Michael Kerrisk 7903f95f0a setpgid.2, setsid.2: Relocate some text on sessions and sessions leaders 
Some text that was in setpgid(2) is better placed in setsid(2).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-12 06:46:50 +01:00
Michael Kerrisk 1a7655042a setpgid.2: Add a reference to credentials(7) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-12 06:41:59 +01:00
Michael Kerrisk 318519daa3 execve.2: Mention use of 'environ' to access environment list 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-12 06:16:38 +01:00
Michael Kerrisk f9429ced31 execve.2: Minor clarification 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-12 06:13:05 +01:00
Michael Kerrisk af5b74504f execve.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-12 06:11:10 +01:00
Michael Kerrisk 0f37a0627f execve.2: Minor clarification 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-12 06:10:48 +01:00
Michael Kerrisk fc9db90e81 execve.2: ffix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-12 06:08:13 +01:00
Michael Kerrisk ce2ca8cc4f execve.2: Minor clarification 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-12 06:07:32 +01:00
Michael Kerrisk 8b4be846c7 fcntl.2: Make the description of the effect of close-on-exec a little clearer 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-12 06:00:04 +01:00
Michael Kerrisk fa1aa3502a close.2: Clarify discussion noting that close() does not flush buffer cache 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-12 05:53:36 +01:00
Michael Kerrisk f157f403de fcntl.2: Clarify that F_GETFD and F_GETFL return flags via the function result 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-12 05:48:47 +01:00
Michael Kerrisk 984baa3fb3 clone.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-09 07:23:21 +01:00
Michael Kerrisk 5e43063bdd readv.2: Clarify that RWF_DSYNC and RWF_SYNC apply only to data being written 
Reported-by: Christoph Hellwig <hch@lst.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-04 16:52:08 +12:00
Michael Kerrisk dae86017d7 readv.2: Document the pwritev2() RWF_SYNC and RWF_DSYNC flags 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-04 16:46:49 +12:00
Michael Kerrisk 5c3bbffbb0 rename.2: Minor wording fix 
The meaning of "when overwriting" is not clear. I believe what is
meant is that when an existing 'newpath' is replaced. However, we
can convey that meaning by eliding this text with the preceding
paragraph, so this patch does that.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-04 16:44:47 +12:00
Michael Kerrisk 84a3d76675 rename.2: Relocate some text text 
Relocate text noting that there may be a window when 'oldpath' and
'newpath' refer to the same file. Logically, this text appears to
belong near the text noting that an existing 'newpath' will be
atomically replaced.  (In ancient versions of the page, these two
pieces of text were closer together.)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-04 16:43:02 +12:00
Michael Kerrisk ae01f2b58b rename.2: Clarify that ERRORS may cause rename to fail (not to be nonatomic) 
The existing wording suggests that there are ERRORS that may cause
the operation to be nonatomic. The point is of course that there
are various restrictions on rename operations that may cause the
operation to fail.

Reported-by: Tim Savannah <kata198@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-09-04 16:43:02 +12:00
Michael Kerrisk cbac502be2 mlock.2: Minor tweaks to Sebastian Andrzej Siewior's patch 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-31 07:23:08 +12:00
Sebastian Andrzej Siewior fb08a0954e mlock.2: Document that fork() after mlock() may be a bad idea in a RT process 
fork() will remove the write PTE bit from the page table on each
VMA which will be copied via COW. As such, the memory is available
but marked read only in the page table and will fault on write
access.  This renders the previous mlock() operation almost
useless because in a multithreaded application a realtime thread
may block on mmap_sem while a thread with low priority is holding
the mmap_sem (for instance because it is allocating memory which
needs to be mapped in).

There is actually nothing we can do to mitigate the outcome. We could
add a warning to the kernel for people that are not yet aware of the
updated documentation.

Signed-off-by: Sebastian Andrzej Siewior <bigeasy@linutronix.de>
 2016-08-31 07:23:08 +12:00
Michael Kerrisk d695a48cdf stat.2: Tweak discussion of 'st_size' for /proc and /sys files 
As Mats points out, there appear to be no (or almost no) files
under /proc and /sys for which 'st_size' is meaningful.
(mtk: verified via some scripting over these directories.)

Reported-by: Mats Wichmann <mats@wichmann.us>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-31 07:19:00 +12:00
Michael Kerrisk 9dbc4adbce stat.2: Improve discussion of 'st_size' for /proc and /sys files 
Reported-by: Ursache Vladimir <f35f22fan@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-29 08:47:39 +12:00
Ruben Kerkhof 370f8e34c4 epoll_ctl.2: tfix 2016-08-29 07:26:46 +12:00
Ruben Kerkhof 7bf58d66ac epoll_ctl.2: tfix 2016-08-29 07:25:55 +12:00
Michael Kerrisk 6c79a020fa sigprocmask.2: Minor fixes to Keno Fischer's patch 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-28 17:48:12 +12:00
Keno Fischer 86d5ed87d3 sigprocmask.2: Expand/clarify libc/kernel sigset_t difference 
Expand and clarify libc/kernel sigset_t differences.  Also move
up the signature for rt_sigprocmask, similar to the way this is
done in clone.2.

Due to the history of sigprocmask, there are various notions of
what sigset_t refers to. This attempts to clarify the man page,
by giving the major instances different names:

- sigset_t is the glibc sigset_t (1024 bits)
- kernel_sigset_t is the kernel's sigset_t (64 bits)
- old_kernel_sigset_t is the pre-rt kernel's sigset_t (32 bits)

and explaining their difference in the NOTES. Even though the
sources do not refer to the various sigset_t's by these names, I
think it is important to be explicit, esp since sizeof(sigset_t)
would give an incorrect value for `sigsetsize` if written in a
source file that includes the libc headers.

Lastly, move the note on an incorrect `sigsetsize` causing
EINVAL up to the ERRORS section, so everything is in one place.
 2016-08-28 17:42:52 +12:00
Michael Kerrisk 49dba87f5c clone.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-24 11:47:52 +12:00
Michael Kerrisk db8ba2b415 clone.2: Make the implications of CLONE_FILES more explicit 
If CLONE_FILES is not set, the duplicated FDs nevertheless share
file offset and status flags via the open file description.

Reported-by: Elliott Hughes <enh@google.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-24 11:47:45 +12:00
Michael Kerrisk 6a459f6fee fcntl.2: Minor wording fix for F_DUPFD 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-24 11:29:35 +12:00
Michael Kerrisk 4529738e46 accept.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-23 19:45:16 +12:00
Michael Kerrisk ccdf8bc04f accept.2: Demote discussion of DECNet to NOTES 
DECNet ceased to be important long ago...

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-23 10:03:31 +12:00
Michael Kerrisk cb1bcdf28c accept.2: Mention epoll(7) alongside poll()/select() 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-23 10:01:58 +12:00
Michael Kerrisk 692b4bcca6 fanotify_init.2: Update BUGS information 
Patch 0b37e097a648aa71d4db1ad108001e95b69a2da4 was included
in Linux 3.18.

Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
 2016-08-22 07:18:24 +12:00
Michael Kerrisk cc6e4bf0cf readlink.2: Make example program handle links that report a size of zero 
Some "magic" symlinks created by the kernel (e.g., those under
/proc and /sys) report 'st_size' as zero. Modify the example
program to handle that possibility.

Reported-by: Ursache Vladimir <f35f22fan@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-20 15:27:13 +12:00
Michael Kerrisk e9979dff7c readlink.2: Emphasize that truncation of returned buffer generates no error 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-20 15:02:06 +12:00
Michael Kerrisk bf525e9050 mmap.2: Small improvement to description of MAP_SHARED 
See https://sourceware.org/bugzilla/show_bug.cgi?id=6887

Reported-by: Siward de Groot <siward@wanadoo.nl>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-17 08:09:28 +12:00
Michael Kerrisk 7b032b2398 open.2: Minor layout fix in ERRORS 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-17 08:09:28 +12:00
Michael Kerrisk f62ddda8a4 fcntl.2: ffix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-17 08:09:28 +12:00
Michael Kerrisk aa30354a3b select_tut.2: ffix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-12 07:14:42 +12:00
Michael Kerrisk a686506533 ptrace.2: ffix 
Reported-by: Sam Varshavchik <mrsam@courier-mta.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-12 07:14:42 +12:00
Peter Wu 3c3d1f83f9 select_tut.2: fix issues in example 
Avoid closing cfd if it is -1. Initialize buf1_avail, etc. to avoid
uninitialized memory access in the event that accept() fails. Remove
redundant setting of nfds. Fix tabs with spaces.

Do not try to read/write from/to file descriptors once an existing
connection is overwritten, the select() states are stale now.
Avoid writing zero bytes from the buffer and then closing the fd.

Signed-off-by: Peter Wu <peter@lekensteyn.nl>
 2016-08-12 07:14:42 +12:00
Jann Horn 423cb9f7ff mmap.2: Describe treatment of 'offset' for MAP_ANONYMOUS 
The manpage claimed that the offset argument is ignored, and when
I interpreted that as "I don't need to set that register when
doing the syscall", I got failures. I was able to spot two reasons
for that:

What I probably ran into:
At least on x86-64, sys_mmap (in arch/x86/kernel/sys_x86_64.c)
always checks that the offset is page-aligned, even for
MAP_ANONYMOUS.

Another one, could probably trigger on 32-bit x86:
In do_mmap(), there is a check to ensure that pgoff together with
the allocation length won't cause an overflow, even for
MAP_ANONYMOUS.

Document that userspace should pass in zero, since that's
probably what everyone is doing already. (It would also be
possible to describe the constraints on the offset more
carefully, but zero works, and nobody should need to pass in
anything else.)

Signed-off-by: Jann Horn <jann@thejh.net>
 2016-08-12 07:14:42 +12:00
Michael Kerrisk b6264ec7cd syscall.2: Eliminate groff "cannot adjust line" warnings 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-12 07:14:42 +12:00
Michael Kerrisk 3fd5b1e7d2 wait.2: Remove erroneous statement that waitpid() is implemented via wait4() 
There is a fallback to wait4(), but only if the kernel does
not provide a waitpid() system call.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:16 +10:00
Michael Kerrisk 3e752456ba gettid.2: Minor fix: remove self-reference from SEE ALSO 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:16 +10:00
Michael Kerrisk d9e64b422f fsync.2: SEE ALSO: add pwritev(2) 
Since Linux 4.7, pwritev() has flags related to I/O
integrity completion.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:16 +10:00
Michael Kerrisk ab57579b8b ioctl_fat.2: f 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:16 +10:00
Michael Kerrisk 9290904064 semop.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:16 +10:00
Michael Kerrisk 84e984416e set_thread_area.2: Add get_thread_area() to NAME 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:16 +10:00
Michael Kerrisk d1e268dbb7 readlink.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:15 +10:00
Michael Kerrisk a467eeaa1d getrlimit.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:15 +10:00
Michael Kerrisk cc849b73d1 readv.2: Add preadv2() and pwritev2() to NAME line 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:15 +10:00
Michael Kerrisk 1ed05a209a ioctl_fat.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:15 +10:00
Michael Kerrisk 41932d348d recvmmsg.2: Fix section ordering 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:15 +10:00
Michael Kerrisk 7993869b7c listxattr.2: Fix section ordering 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:15 +10:00
Michael Kerrisk 55e0165bf3 get_kernel_syms.2: Fix section ordering 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:15 +10:00
Michael Kerrisk 81036dab01 adjtimex.2: Fix section ordering 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:15 +10:00
Michael Kerrisk 59fc0ad145 sigaction.2: Fix order of SEE ALSO entries 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:13 +10:00
Michael Kerrisk 04fb29507b sched_setparam.2: Fix order of SEE ALSO entries 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:13 +10:00
Michael Kerrisk 0376872661 sched_setattr.2: Fix order of SEE ALSO entries 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:13 +10:00
Michael Kerrisk 2b8fb01a25 mount.2: Fix order of SEE ALSO entries 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:13 +10:00
Michael Kerrisk 3a4e05a126 madvise.2: Fix order of SEE ALSO entries 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:13 +10:00
Michael Kerrisk d8f1a35cb5 keyctl.2: Fix order of SEE ALSO entries 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:13 +10:00
Michael Kerrisk f5de7914ff keyctl.2: Minor rewording 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:13 +10:00
Michael Kerrisk 6a68ffd764 ioctl.2: Fix order of SEE ALSO entries 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:13 +10:00
Michael Kerrisk ac6cfaca07 sync.2: Fix order of SEE ALSO entries 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:13 +10:00
Michael Kerrisk a87041ac8f bdflush.2: Fix order of SEE ALSO entries 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:13 +10:00
Michael Kerrisk cbb57e7422 sysctl.2: Order ERRORS alphabetically 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:13 +10:00
Michael Kerrisk d07d4ef308 futex.2: Order ERRORS alphabetically 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:13 +10:00
Michael Kerrisk 6717ee8694 clone.2: Order ERRORS alphabetically 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:13 +10:00
Michael Kerrisk 3a0d6510d9 request_key.2: Order ERRORS alphabetically 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:13 +10:00
Michael Kerrisk 7071fdf85b process_vm_readv.2: Order ERRORS alphabetically 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:13 +10:00
Michael Kerrisk 038f51757a mmap.2: Order ERRORS alphabetically 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:12 +10:00
Michael Kerrisk b64516374f lseek.2: Order ERRORS alphabetically 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:12 +10:00
Michael Kerrisk 049d5a3c97 kexec_load.2: Order ERRORS alphabetically 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:12 +10:00
Michael Kerrisk 3a66db4afd io_getevents.2: Order ERRORS alphabetically 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:12 +10:00
Michael Kerrisk a998542722 ioctl_fideduperange.2: Order ERRORS alphabetically 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:12 +10:00
Michael Kerrisk b2d34da577 ioctl_ficlonerange.2: Order ERRORS alphabetically 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:12 +10:00
Michael Kerrisk 26c04bd0f4 getrandom.2: Order ERRORS alphabetically 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:12 +10:00
Michael Kerrisk 808397e39e epoll_ctl.2: Order ERRORS alphabetically 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:12 +10:00
Michael Kerrisk 6cedbd4c9f bpf.2: Order ERRORS alphabetically 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:12 +10:00
Michael Kerrisk b801426a5e add_key.2: Order ERRORS alphabetically 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:12 +10:00
Michael Kerrisk 9966360378 bpf.2: ffix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:12 +10:00
Michael Kerrisk bf7bc8b898 arch_prctl.2, execveat.2, fanotify_mark.2, fcntl.2, fork.2, madvise.2, mknod.2, mmap.2, modify_ldt.2, mount.2, open.2, prctl.2, ptrace.2, restart_syscall.2, seccomp.2, semop.2, set_thread_area.2, symlink.2, umount.2, unlink.2, error.3, getnetent.3, getprotoent.3, getservent.3, getutent.3, glob.3, login.3, setjmp.3, setnetgrent.3, wordexp.3, epoll.7: Remove section number from page self reference 
Fix places where pages refer to the function that they describe
and include a section number in that reference. Such references
cause some HTML-rendering tools to create self-references in the
page.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:12 +10:00
Michael Kerrisk 23298342de epoll_ctl.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:12 +10:00
Michael Kerrisk c46bf9ae19 wait.2: tfix 
Reported-by: Sloane Bernstein <sloane@cpanel.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-06 08:34:31 +10:00
Michael Kerrisk 9539ebc934 open.2: NOTES: kcmp() can be used to test if two FDs refer to the same OFD 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-28 10:31:51 +02:00
Michael Kerrisk 2e4eff1b1d kcmp.2: Add an example program 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-28 10:25:18 +02:00
Michael Kerrisk 79bdcc4a5c clone.2: Mention kcmp() under notes 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-28 09:34:52 +02:00
Michael Kerrisk c3a7b4e958 mount.2: wfix 2016-07-28 08:32:32 +02:00
Michael Kerrisk 2a0bd971fa stat.2: _BSD_SOURCE and _SVID_SOURCE no longer expose nanosecond timestamps 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-26 13:02:46 +02:00
Dr. Tobias Quathamer ccfe84ee2a getitimer.2: tfix 2016-07-24 21:02:09 +02:00
Dr. Tobias Quathamer c0d44cf5ae getitimer.2: tfix 2016-07-24 21:02:09 +02:00
Michael Kerrisk 8a2de39c05 umask.2: Provide a rationale for the existence of /proc/PID/status 'Umask' field 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-18 17:10:57 +02:00
Michael Kerrisk ac6c297c7b umask.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-18 17:05:14 +02:00
Michael Kerrisk 2ae96e8ae8 Removed trailing white space at end of lines 2016-07-17 18:10:19 +02:00
Michael Kerrisk 3df541c0e6 ldd.1, localedef.1, add_key.2, chroot.2, clone.2, fork.2, futex.2, get_mempolicy.2, get_robust_list.2, getitimer.2, getpriority.2, ioctl.2, ioctl_ficlonerange.2, ioctl_fideduperange.2, kcmp.2, kill.2, lookup_dcookie.2, mmap.2, mount.2, open.2, pciconfig_read.2, perf_event_open.2, prctl.2, process_vm_readv.2, ptrace.2, quotactl.2, recv.2, setfsgid.2, setfsuid.2, sysinfo.2, umask.2, umount.2, unshare.2, utimensat.2, wait.2, assert.3, fmax.3, fmin.3, getauxval.3, inet_pton.3, malloc_hook.3, memmem.3, mkdtemp.3, mktemp.3, printf.3, strcasecmp.3, strcat.3, strtoul.3, strxfrm.3, console_codes.4, console_ioctl.4, lirc.4, tty.4, vcs.4, charmap.5, elf.5, locale.5, proc.5, repertoiremap.5, utmp.5, capabilities.7, cgroup_namespaces.7, cgroups.7, charsets.7, cp1251.7, cp1252.7, credentials.7, feature_test_macros.7, iso_8859-1.7, iso_8859-15.7, iso_8859-5.7, koi8-r.7, koi8-u.7, man-pages.7, mount_namespaces.7, namespaces.7, netlink.7, pid_namespaces.7, unix.7, user_namespaces.7, utf-8.7: tstamp 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-17 18:10:19 +02:00
Darrick J. Wong e4fcb7bcc3 ioctl_ficlonerange.2: Mention a subtlety with length == 0 
Passing length == 0 to clonerange actually makes it clone
all the way to EOF.

Signed-off-by: Darrick J. Wong <darrick.wong@oracle.com>
 2016-07-16 12:25:12 +02:00
Michael Kerrisk a9562222f7 kill.2: Clarify the meaning if sig==0 
Reported-by: John Wiersba <jrw32982@yahoo.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-16 12:23:18 +02:00
Michael Kerrisk b5eb75f750 perf_event_open.2: srcfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-07 12:09:35 +02:00
Jann Horn 3eb9519282 perf_event_open.2: Document new perf_event_paranoid default 
Signed-off-by: Jann Horn <jann@thejh.net>
 2016-07-07 12:08:37 +02:00
Keno Fischer 4dc411ddbd perf_event_open.2: Add a note that dyn_size is omitted if size == 0 
The perf_output_sample_ustack in kernel/events/core.c only writes
a single 64 bit word if it can't dump the user registers. From the
current version of the man page, I would have expected two 64 bit
words (one for size, one for dyn_size). Change the man page to
make this behavior explicit.

Reviewed-by: Vince Weaver <vincent.weaver@maine.edu>
 2016-07-07 12:05:06 +02:00
Michael Kerrisk c082f385d4 futex.2: srcfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-07 10:12:58 +02:00
Michael Kerrisk a8fa059758 sysinfo.2: srcfix: change page license 
The license on the original versoin of this page is troublesome,
because of restrictions imposed by the clause that the page may be
modified "for the purpose of improving Linux or its documentation
efforts".

By now, I have rewritten all except trivial pieces of the page,
and the structure definitions in any case came from kernel header
files. So, I'm relicensing the page to the "verbatim" license.

See https://bugzilla.kernel.org/show_bug.cgi?id=118311

Reported-by: Tom Callaway <tcallawa@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-07 09:08:45 +02:00
Michael Kerrisk 641277ecc4 sysinfo.2: Rewrite and update various pieces 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-07 09:07:14 +02:00
Michael Kerrisk 00538c672b pciconfig_read.2: Change license to note that page may be modified 
Niki Rahimi, the author of this page, has agreed that it's okay
to change the license to note that the page can be modified.

See https://bugzilla.kernel.org/show_bug.cgi?id=118311

Reported-by: Tom Callaway <tcallawa@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-07 09:07:14 +02:00
Michael Kerrisk 0d8367f0f7 getitimer.2: Change license to note that page may be modified 
The page as originally written carried text that said the page may
be freely distributed but made no statement about modification.
In the 20+ years since it was first written, the page has in fact
seen repeated, sometimes substantial, modifications, and only a
small portion of the original text remains. One could I suppose
rewrite the last few pieces that remain from the original,
but as the largest contributor to the pages existing text,
I'm just going to relicense it to explicitly note that
modification is permitted. (I presume the failure by the
original author to grant permission to modify was simply an
oversight; certainly, the large number of people who have
changed the page have taken that to be the case.)

Reported-by: Tom Callaway <tcallawa@redhat.com>
See also https://bugzilla.kernel.org/show_bug.cgi?id=118311

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-07 08:13:13 +02:00
Michael Kerrisk b659d904b4 getitimer.2: Substantial rewrites to various parts of the page 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-05 12:44:39 +02:00
Michael Kerrisk 4acc2a5ff8 sysinfo.2: srcfix: remove request to add timestamp in source; we have Git nowadays 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-05 12:44:39 +02:00
Michael Kerrisk 0fa34fb396 utimensat.2: Note that the glibc wrapper disallows pathname==NULL 
Reported-by: Rob Landley <rob@landley.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-02 11:25:51 +02:00
Michael Kerrisk 2389c1e3c1 utimensat.2: Minor fix: reorder some text in NOTES 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-02 11:20:42 +02:00
Michael Kerrisk f69c2584a9 getpriority.2: Make discussion of RLIMIT_NICE more prominent 
The discussion of RLIMIT_NICE was hidden under the EPERM error,
where it was difficult to find. Place some relevant text in
DESCRIPTION.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-02 00:45:20 +02:00
Michael Kerrisk b8bc577b89 getpriority.2: Clarify equivalence between lower nice value and higher priority 
Reported-by: Robin Kuzmin <kuzmin.robin@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-02 00:36:43 +02:00
Michael Kerrisk 653c1fe2e2 getpriority.2: Note that getpriority()/setpriority deal with same attribute as nice(2) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-02 00:32:32 +02:00
Michael Kerrisk 659cc17f4f setfsgid.2, setfsuid.2: Note which glibc version stopped checking for truncation of the argument 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-02 00:15:24 +02:00
Michael Kerrisk dc439d82cb setfsgid.2, setfsuid.2: Move glibc wrapper notes to "C library/kernel differences" subsection 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-02 00:13:05 +02:00
Jann Horn de61071a21 setfsgid.2, setfsuid.2: Fix note about errors from the syscall wrapper 
See sysdeps/unix/sysv/linux/i386/setfsuid.c in glibc-2.2.1.
(This code is not present in modern glibc anymore.)

Signed-off-by: Jann Horn <jannh@google.com>
 2016-07-02 00:09:30 +02:00
Jakub Wilk 48235a56f3 syscalls.2: tfix 
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
 2016-07-01 20:56:11 +02:00
Michael Kerrisk e203673ac7 unshare.2: Add reference to mount_namespaces(7) under CLONE_NEWNS description 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-06-30 06:08:32 +02:00
Michael Kerrisk c212248c77 clone.2: Add reference to mount_namespaces(7) under CLONE_NEWNS description 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-06-30 06:08:32 +02:00
Michael Kerrisk 39b3f0058e clone.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-06-30 06:08:32 +02:00
Michael Kerrisk b7b798454a mount.2: Refer reader to mount_namespaces(7) for details on propagation types 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-06-30 06:08:32 +02:00
Michael Kerrisk a67271b0c9 umount.2: SEE ALSO: add mount_namespaces(7) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-06-30 06:08:31 +02:00
Michael Kerrisk 3077ac0f12 mount.2: SEE ALSO: s/namespaces(7)/mount_namespaces(7)/ 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-06-30 06:08:31 +02:00
Michael Kerrisk 028b5760e8 ptrace.2: Minor fixes after review by Kees Cook 
Reviewed-by: Kees Cook <keescook@chromium.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-06-29 07:06:30 +02:00
Michael Kerrisk e48ed83a6a ptrace.2: tfix 
Reported-by: Jann Horn <jann@thejh.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-06-29 07:06:30 +02:00
Michael Kerrisk d5765e275d ptrace.2: Note that user namespaces can be used to bypass Yama protections 
Cowrittten-by: Jann Horn <jann@thejh.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-06-29 07:06:30 +02:00
Michael Kerrisk e532361686 ptrace.2: Update Yama ptrace_scope documentation 
Reframe the discussion in terms of PTRACE_MODE_ATTACH checks,
and make a few other minor tweaks and additions.

Reviewed-by: Jann Horn <jann@thejh.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-06-29 07:06:30 +02:00
Michael Kerrisk 94b0464cc2 ptrace.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-06-29 07:06:30 +02:00
Michael Kerrisk b0459842ff ptrace.2: srcfix: add 2015 copyright notice for mtk 
(Yama ptrace_scope text added in 2015.)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-06-29 07:06:30 +02:00
Michael Kerrisk 00172d8d96 ptrace.2: Add an introductory paragraph to the Ptrace access mode checks" section 
Reported-by: Eric W. Biederman <ebiederm@xmission.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-06-29 07:06:29 +02:00
Michael Kerrisk 1c22e40a71 ptrace.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-06-29 07:06:29 +02:00
Michael Kerrisk 3224581342 ptrace.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-06-29 07:06:29 +02:00
Michael Kerrisk edb7368474 ptrace.2: Relocate text noting that PTRACE_MODE_* constants are kernel-internal 
(No content changes.)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-06-29 07:06:29 +02:00
Michael Kerrisk be26fa864f ptrace.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-06-29 07:06:29 +02:00
Michael Kerrisk bcd0d82dac ptrace.2: srcfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-06-29 07:06:29 +02:00
Stephen Smalley 3cd161fe57 ptrace.2: Describe PTRACE_MODE_NOAUDIT in more detail 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-06-29 07:06:29 +02:00