Commit Graph

16809 Commits

Author SHA1 Message Date
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
Michael Kerrisk c174eb6a07 cgroups.7: tfix: fix pathname of perf-record.txt kernel source file
Reported-by: Michael Hausenblas <michael.hausenblas@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-10-22 13:50:22 +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 2cf45b0d77 capabilities.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-10-19 10:53:38 +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 9227137a38 mallopt.3: Minor clarification for M_ARENA_MAX
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-10-19 08:46:15 +02:00
Michael Kerrisk 7655c1839d mallopt.3: Improve description of M_ARENA_TEST
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-10-18 18:03:49 +02:00
Michael Kerrisk 8d02a0ab04 mallopt.3: Correct the description of M_ARENA_MAX==0
Reported-by: Siddhesh Poyarekar <siddhesh@sourceware.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-10-18 17:53:29 +02:00
Michael Kerrisk 3bbab71ae8 capabilities.7: tfix + wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-10-18 10:46:54 +02:00
Michael Kerrisk de6a5c0501 capabilities.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-10-18 09:43:27 +02:00
Michael Kerrisk 8e81aad0dc mallopt.3: Document default value for M_ARENA_TEST
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-10-18 09:14:27 +02:00
Michael Kerrisk 19557f4043 mallopt.3: Document 0 as default value of M_ARENA_MAX and explain its meaning
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-10-18 08:56:19 +02:00
Michael Kerrisk b075133f9c mallopt.3: Minor fix: relocate some text
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-10-18 08:50:45 +02:00
Michael Kerrisk bf5c6199e3 mallopt.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-10-18 08:50:06 +02:00
Michael Kerrisk ba202ba07f mallopt.3: Note default value of M_PERTURB
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-10-18 08:45:16 +02:00
Michael Kerrisk 8d66586467 mallopt.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-10-18 08:41:13 +02:00
Michael Kerrisk bb70234f74 mallopt.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-10-18 08:36:18 +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 3b3d46e7cf pkeys.7: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-10-18 08:00:12 +02:00
Dave Hansen c92965c2be pkey.7: Add description of signal handling behavior
The signal behavior of pkeys is special compared to many other
processor and OS features.  Add a special section to describe
the behavior.

Signed-off-by: Dave Hansen <dave.hansen@linux.intel.com>
2016-10-18 07:58:52 +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 79a2a43713 pkeys.7: Note that SIGSEGV results if pkey restrictions are violated
And point to sigaction(2) for further details.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-10-17 14:04:11 +02:00
Michael Kerrisk 8bb4e76704 pkeys.7: Cosmetic changes to example program
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-10-17 14:04:11 +02:00
Michael Kerrisk 435f231ac9 pkeys.7: Various tweaks to the text
No changes to technical details.

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
Michael Kerrisk 2f05728103 proc.5: Add example ProtectionKey output for 'smaps' file
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-10-17 14:04:06 +02:00
Dave Hansen be729d667d proc.5: Describe new ProtectionKey 'smaps' field
Signed-off-by: Dave Hansen <dave.hansen@linux.intel.com>
2016-10-17 14:03:28 +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
Dave Hansen 452f54946f pkeys.7: New page with overview of Memory Protection Keys
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