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

6484 Commits

Author SHA1 Message Date
Michael Kerrisk 724d21bbb8 random.4: Minor wording fixes 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-11-12 12:22:10 +01:00
Michael Kerrisk 311edc011a getrandom.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-11-12 12:22:10 +01:00
Michael Kerrisk c35966b125 getrandom.2: Note advantages of fact that getrandom() doesn't use file descriptors 
Inspired by Nikos Mavrogiannopoulos's post at
http://nmav.gnutls.org/2016/10/random-generator-linux.html

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-11-12 12:22:10 +01:00
Michael Kerrisk 2e1f8bfa17 getrandom.2, random.4: Consolidate and improve discussion on usage of randomness 
Currently, recommendations on how to consume randomness are
spread across both getrandom(2) and random(4) and the general
opinion seems to be that the text in getrandom(2) does a
somewhat better job. Consolidate the discussion to a single
page (getrandom(2)) and address some of the concerns
expressed about the existing text in random(4).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-11-12 12:22:10 +01:00
Michael Kerrisk b50a708ba6 wait.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-11-11 09:20:27 +01:00
Michael Kerrisk 68246229ba send.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-11-11 09:09:30 +01:00
Michael Kerrisk fcc4f4f456 perf_event_open.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-11-11 09:08:56 +01:00
Michael Kerrisk 3f06ade3af mmap.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-11-11 09:08:31 +01:00
Eugene Syromyatnikov 721381be5b quotactl.2: tfix 2016-11-10 20:28:38 +01:00
Michael Kerrisk 2e3cf491f1 utime.2, utimensat.2: SEE ALSO: add touch(1) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-11-10 11:23:38 +01:00
Michael Kerrisk e20370e4c2 unlink.2: SEE ALSO: add unlink(2) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-11-10 11:16:27 +01:00
Michael Kerrisk 792f20ea4a gethostname.2: SEE ALSO: add hostname(1) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-11-10 11:13:12 +01:00
Michael Kerrisk 0c28210ecb kill.2: SEE ALSO: add kill(1) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-11-10 11:13:12 +01:00
Michael Kerrisk 9bab77a4a4 chroot.2: SEE ALSO: add chroot(1) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-11-10 11:13:12 +01:00
Michael Kerrisk 1bf54566e6 chown.2: SEE ALSO: add chgrp(1) and chown(1) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-11-10 11:13:12 +01:00
Michael Kerrisk 3dd7a7eeea chmod.2: SEE ALSO: add chmod(1) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-11-10 11:05:49 +01:00
Michael Kerrisk 34e922812e mount.2: SEE ALSO: add mountpoint(1) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-11-10 09:11:01 +01:00
Michael Kerrisk 1ce611a3c2 adjtimex.2, clock_getres.2, gettimeofday.2: SEE ALSO: add hwclock(8) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-11-10 09:07:48 +01:00
Michael Kerrisk d097377b9d symlink.2: SEE ALSO: add namei(1) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-11-10 08:50:40 +01:00
Michael Kerrisk d38be90da1 quotactl.2: Minor tweaks to Eugene Syromyatnikov's patch 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-11-10 08:17:09 +01:00
Eugene Syromyatnikov 942627c949 quotactl.2: Describe Q_XQUOTASYNC, which is present but no-op in recent kernels 2016-11-10 08:13:50 +01:00
Heinrich Schuchardt 5d730f864a fanotify_mark.2: Mention FAN_Q_OVERFLOW 
To receive overflow events it is necessary to set this bit
in fanotify_mark().

Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
 2016-11-09 08:40:57 +01:00
Michael Kerrisk c73916154d ptrace.2: srcfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-11-09 01:49:25 +01:00
Michael Kerrisk 88f02af602 seccomp.2: NOTES: mention ptrace(PTRACE_SECCOMP_GET_FILTER) to dump seccomp filters 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-11-08 14:07:56 +01:00
Michael Kerrisk baf11d5c1d ptrace.2: Document PTRACE_SECCOMP_GET_FILTER 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-11-08 14:07:56 +01:00
Michael Kerrisk b8854baedb ptrace.2: ffix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-11-08 14:07:56 +01:00
Michael Kerrisk 5db5b78c7c bind.2: grfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-11-08 09:05:45 +01:00
Michael Kerrisk 4e07c70f90 fallocate.2, fcntl.2, lseek.2, madvise.2, memfd_create.2, mmap.2, remap_file_pages.2, swapon.2, proc.5, cgroups.7, shm_overview.7, user_namespaces.7: Fix cross references to new tmpfs(5) page 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-11-07 16:21:41 +01:00
Michael Kerrisk 78907e9eb9 madvise.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-11-07 14:29:44 +01:00
Michael Kerrisk 9871c08c1f mprotect.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-11-07 03:12:09 -07:00
Jann Horn 09481df399 seccomp.2: Document changed interaction with ptrace 
Signed-off-by: Jann Horn <jann@thejh.net>
 2016-11-06 13:19:55 -07:00
Michael Kerrisk bc1be43eef fcntl.2: F_GETPIPE_SZ allocates next power-of-2 multiple of requested size 
Add some detail about current implementation, since this helps
the user understand the effect of the user pipe limits added in
Linux 4.5 (described in pipe(7)).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-11-06 13:14:07 -07:00
Michael Kerrisk ef422cb6e1 fcntl.2: Add EPERM that occurs for F_SETPIPE_SZ when user pipe limit is reached 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-11-06 13:14:07 -07:00
Michael Kerrisk 8ef529f935 open.2: Document ENOMEM that occurs when opening FIFO because of pipe hard limit 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-11-06 13:14:07 -07:00
Michael Kerrisk 4288fe3225 pipe.2: Add ENFILE error for user pipe hard limit reached 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-11-06 13:14:06 -07:00
Michael Kerrisk 8fc9ce245d exit_group.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-11-06 13:06:45 -07:00
Michael Kerrisk aab65e59ef wait.2: On some architectures, waitpid() is a wrapper that calls wait4(). 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-11-05 11:47:52 -06:00
Michael Kerrisk c33144e666 pivot_root.2: srcfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-11-04 20:16:45 +01:00
Michael Kerrisk 498aad5099 kill.2, sigaction.2, signal.2, credentials.7, signal.7: Change section number from 2 to 3 in killpg() references 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-11-04 18:01:28 +01:00
Michael Kerrisk e1988469a6 killpg.2: New link to relocated killpg(3) page 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-11-04 18:01:28 +01:00
Michael Kerrisk ec1b4c4944 killpg.3: Move killpg.2 from section to to section 3 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-11-04 18:01:28 +01:00
Michael Kerrisk bc8bfd8ac8 ptrace.2: Document PTRACE_GET_THREAD_AREA and PTRACE_SET_THREAD_AREA 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-11-01 14:25:06 +01:00
Michael Kerrisk 02418dd0c7 ptrace.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-11-01 14:06:28 +01:00
Michael Kerrisk 65ba6523ea ptrace.2: srcfix: update FIXME details 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-11-01 14:02:13 +01:00
Michael Kerrisk 758b35dafe set_thread_area.2: ffix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-11-01 13:20:56 +01:00
Michael Kerrisk 30ed4712c7 chroot.2, dup.2, nfsservctl.2, utimensat.2, malloc_get_state.3, pthread_setaffinity_np.3, ddp.7, fifo.7, ip.7: Remove some out-of-date/obsolete/irrelevant FIXMEs 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-31 16:45:46 +01:00
Michael Kerrisk 7f52c459b7 sync_file_range.2: Fix description for ESPIPE error 
A file descriptor can't refer to a symbolic link.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-31 16:24:44 +01:00
Michael Kerrisk db0afb5464 mbind.2: Memory policy is a per-thread attribute, not a per-process attribute 
Reviewed-by: Christoph Lameter <cl@linux.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-31 13:00:42 +01:00
Dr. Tobias Quathamer ddd5c503e8 readlink.2: tfix 2016-10-31 12:55:58 +01:00
Jakub Wilk b01ae37b3f perf_event_open.2: tfix 
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
 2016-10-31 12:54:01 +01:00
Michael Kerrisk 61066e14ac futex.2: srcfix: Remove some more or less obsolete FIXMEs 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-31 02:41:30 +01:00
Michael Kerrisk 6756ea36fa sigaction.2: srcfix: FIXME tidy-up 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-29 13:43:30 +02:00
Michael Kerrisk 39b1555456 memfd_create.2: srcfix: FIXME tidy-up 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-29 13:43:30 +02:00
Michael Kerrisk 68c11e153d vmsplice.2: srcfix: FIXME tidy-up 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-29 13:34:58 +02:00
Michael Kerrisk eec5c0d0cc tkill.2: srcfix: FIXME tidy-up 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-29 13:34:58 +02:00
Michael Kerrisk cda56b8eed timerfd_create.2: srcfix: FIXME tidy-up 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-29 13:34:57 +02:00
Michael Kerrisk 3b1fdaf38f ptrace.2: srcfix: FIXME tidy-up 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-29 13:34:57 +02:00
Michael Kerrisk d316ef31cd get_robust_list.2: srcfix: FIXME tidy-up 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-29 13:34:57 +02:00
Michael Kerrisk 9915ea2349 futex.2: srcfix: FIXME tidy-up 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-29 13:34:57 +02:00
Michael Kerrisk badba3f644 adjtimex.2: srcfix: FIXME tidy-up 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-29 13:34:57 +02:00
Michael Kerrisk b913d16538 bpf.2: srcfix: FIXME tidy-up 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-29 13:31:50 +02:00
Michael Kerrisk b519015248 perf_event_open.2: srcfix: FIXME tidy-up 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-29 13:31:50 +02:00
Michael Kerrisk 3af37891fd move_pages.2: srcfix: FIXME tidy-up 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-29 13:31:50 +02:00
Michael Kerrisk 672156945d mount.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-29 13:31:50 +02:00
Michael Kerrisk 16a12791eb mount.2: srcfix: Remove obsolete FIXME 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-29 13:31:50 +02:00
Michael Kerrisk 1f3583c5c9 mbind.2: srcfix: FIXME tidy-up 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-29 13:31:50 +02:00
Vince Weaver c6e5df74f4 perf_event_open.2: Add PERF_SAMPLE_BRANCH_CALL branch sample type 
Linux 4.4 (c229bf9dc179d2023e185c0f705bdf68484c1e73) added
the PERF_SAMPLE_BRANCH_CALL branch sample type, which confusingly
is a direct-call only subset of what PERF_SAMPLE_BRANCH_ANY_CALL
provides.

Signed-off-by: Vince Weaver <vincent.weaver@maine.edu>
 2016-10-24 06:49:45 +02:00
Vince Weaver 988688f606 perf_event_open.2: Update time_shift sample code 
Linux 4.3 (b20112edeadf0b8a1416de061caa4beb11539902) improved
the accuracy of the clock/ns conversion routines.  As a result
the shift factor can now be 32.  This value is directly
exported in the perf_event_open() mmap page, and this
potentially breaks the sample code that shifts 1 left by
the shift value.

Add a cast in the sample code so that a proper 64-bit value
results from the shift.  This is the same change that was
made to the sample code in include/uapi/linux/perf_event.h
in Linux 4.4 (b9511cd761faafca7a1acc059e792c1399f9d7c6).

Signed-off-by: Vince Weaver <vincent.weaver@maine.edu>
 2016-10-21 08:44:15 +02:00
Michael Kerrisk dceb9af608 perf_event_open.2: srcfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-20 07:54:17 +02:00
Vince Weaver 9691959295 perf_event_open.2: Add cycles field in LBR records 
Linux 4.3 (71ef3c6b9d4665ee7afbbe4c208a98917dcfc32f)
added a cycles field to the PERF_SAMPLE_BRANCH_STACK
last branch records.

The kernel commit was a bit vague on this, but you can find
a few more details on this in the Intel Architectural Manual
vol3B.  The field indicates the number of core cycles elapsed
since the previous update to the LBR stack.

This feature is only found on Skylake and newer Intel chips,
as well as Intel Atom Goldmont chips.  I'm not sure if it's
worth adding this info to the manpage, as it seems a bit
specific and will probably get rapidly out of date.

Signed-off-by: Vince Weaver <vincent.weaver@maine.edu>
 2016-10-20 07:50:40 +02:00
Michael Kerrisk 54905b0fc3 perf_event_open.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-20 07:49:15 +02:00
Michael Kerrisk d5a24378f9 perf_event_open.2: Minor tweaks to Vince Weaver's patch 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-19 08:59:31 +02:00
Vince Weaver 9277a75d39 perf_event_open.2: PERF_RECORD_SWITCH support 
Linux 4.3 introduced two new record types for recording context
switches: PERF_RECORD_SWITCH and PERF_RECORD_SWITCH_CPU_WIDE.

The advantage over the existing tracepoint and software context
switch events is primarily that full switch in/out data can be
gathered even in the face of restrictive perf_event_paranoid
settings.

Signed-off-by: Vince Weaver <vincent.weaver@maine.edu>
 2016-10-19 08:53:47 +02:00
Michael Kerrisk 141efa1be5 perf_event_open.2: Minor wording tweaks to Vince Weaver's patch 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-18 08:16:55 +02:00
Vince Weaver ffbc7c0273 perf_event_open.2: Document PERF_RECORD_MISC_PROC_MAP_PARSE_TIMEOUT 
Linux 4.2 reserved a new bit from the misc field in
the perf_event_open() mmap sample buffer:
PERF_RECORD_MISC_PROC_MAP_PARSE_TIMEOUT

Despite being reserved in the public
include/uapi/linux/perf_event.h header file, this bit is never set
by the kernel. Rather, it is used internally by the user-space
"perf" utility to indicate that, when attempting to parse all of
the /proc/xxx/maps files for the sample, it ended up taking too
long so the scan was aborted.

Signed-off-by: Vince Weaver <vincent.weaver@maine.edu>
 2016-10-18 08:15:30 +02:00
Darrick J. Wong 2046b8ac01 ioctl_ficlonerange.2, ioctl_fideduperange.2: Clarify the behavior of the FIDEDUPERANGE ioctl 
Signed-off-by: Darrick J. Wong <darrick.wong@oracle.com>
 2016-10-18 08:08:43 +02:00
Darrick J. Wong 63a599c657 man2/fallocate.2: Document behavior with shared blocks 
Note that FALLOC_FL_UNSHARE may use CoW to unshare blocks to
guarantee that a disk write won't fail with ENOSPC.

Signed-off-by: Darrick J. Wong <darrick.wong@oracle.com>
 2016-10-18 08:05:34 +02:00
Michael Kerrisk 3e712e2a67 pkey_alloc.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-17 14:04:17 +02:00
Michael Kerrisk 31e0cc4430 mprotect.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-17 14:04:17 +02:00
Michael Kerrisk a398e76366 pkey_alloc.2: Add a pointer to example program in pkeys(7) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-17 14:04:17 +02:00
Michael Kerrisk 9e7d6be1f5 mprotect.2: Various tweaks to the text 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-17 14:04:17 +02:00
Michael Kerrisk f74aed0e62 mprotect.2: VERSIONS: note kernel version for pkey_mprotect() 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-17 14:04:17 +02:00
Michael Kerrisk 8f5484f8b6 mprotect.2: CONFORMING TO: note that pkey_mprotect() is Linux-specific 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-17 14:04:11 +02:00
Michael Kerrisk e956ced871 pkey_alloc.2: Reorganize text 
No content changes.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-17 14:04:11 +02:00
Michael Kerrisk b638d22097 pkey_alloc.2: Various tweaks to the text 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-17 14:04:11 +02:00
Michael Kerrisk 6fc107c1da pkey_mprotect.2: New link to mprotect(2) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-17 14:04:11 +02:00
Michael Kerrisk fb48371eeb pkey_free.2: New link to new pkey_alloc(2) page 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-17 14:04:11 +02:00
Michael Kerrisk 6075e4eb6b syscalls.2: Add pkey_alloc(), pkey_free(), and pkey_mprotect() 
New system calls in Linux 4.9.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-17 14:04:11 +02:00
Dave Hansen bc2983d6d6 sigaction.2: Further documentation of SEGV_PKUERR 
Signed-off-by: Dave Hansen <dave.hansen@linux.intel.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-17 12:51:10 +02:00
Dave Hansen d457be9d03 pkey_alloc.2: New page documenting pkey_alloc(2) and pkey_free(2) 
Signed-off-by: Dave Hansen <dave.hansen@linux.intel.com>
 2016-10-17 12:51:10 +02:00
Dave Hansen d800ae65d3 mprotect.2: Document pkey_mprotect() system call 
Signed-off-by: Dave Hansen <dave.hansen@linux.intel.com>
 2016-10-17 12:51:10 +02:00
Michael Kerrisk fc79d996c1 perf_event_open.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-17 11:17:42 +02:00
Michael Kerrisk 6831ba6b0f perf_event_open.2: Clarify the use of signals for capturing overflow events 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-10-17 11:17:42 +02:00
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