msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
-"POT-Creation-Date: 2013-08-15 19:32+0900\n"
+"POT-Creation-Date: 2013-09-28 04:06+0900\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
msgstr ""
#. type: SH
-#: build/C/man2/arch_prctl.2:82 build/C/man2/futex.2:209 build/C/man2/get_robust_list.2:77 build/C/man2/getunwind.2:81 build/C/man2/kexec_load.2:114 build/C/man2/lookup_dcookie.2:43 build/C/man2/modify_ldt.2:98 build/C/man2/nfsservctl.2:51 build/C/man2/pciconfig_read.2:50 build/C/man2/perf_event_open.2:2026 build/C/man2/perfmonctl.2:190 build/C/man2/personality.2:57 build/C/man2/pivot_root.2:101 build/C/man2/process_vm_readv.2:209 build/C/man2/ptrace.2:1780 build/C/man2/quotactl.2:419 build/C/man2/sendfile.2:108 build/C/man2/set_tid_address.2:88 build/C/man2/splice.2:127 build/C/man2/tee.2:85 build/C/man2/vm86.2:54 build/C/man2/vmsplice.2:113
+#: build/C/man2/arch_prctl.2:82 build/C/man2/futex.2:214 build/C/man2/get_robust_list.2:77 build/C/man2/getunwind.2:81 build/C/man2/kexec_load.2:114 build/C/man2/lookup_dcookie.2:43 build/C/man2/modify_ldt.2:98 build/C/man2/nfsservctl.2:53 build/C/man2/pciconfig_read.2:50 build/C/man2/perf_event_open.2:2116 build/C/man2/perfmonctl.2:190 build/C/man2/personality.2:57 build/C/man2/pivot_root.2:101 build/C/man2/process_vm_readv.2:209 build/C/man2/ptrace.2:1780 build/C/man2/quotactl.2:419 build/C/man2/sendfile.2:108 build/C/man2/set_tid_address.2:88 build/C/man2/splice.2:127 build/C/man2/tee.2:85 build/C/man2/vm86.2:54 build/C/man2/vmsplice.2:113
#, no-wrap
msgid "RETURN VALUE"
msgstr ""
msgstr ""
#. type: SH
-#: build/C/man2/arch_prctl.2:88 build/C/man2/futex.2:234 build/C/man2/get_robust_list.2:84 build/C/man2/getunwind.2:88 build/C/man2/kexec_load.2:121 build/C/man2/lookup_dcookie.2:50 build/C/man2/modify_ldt.2:108 build/C/man2/pciconfig_read.2:77 build/C/man2/perf_event_open.2:2032 build/C/man2/personality.2:64 build/C/man2/pivot_root.2:105 build/C/man2/process_vm_readv.2:229 build/C/man2/ptrace.2:1801 build/C/man2/quotactl.2:427 build/C/man2/sendfile.2:115 build/C/man2/set_tid_address.2:91 build/C/man2/splice.2:142 build/C/man2/tee.2:100 build/C/man2/vm86.2:59 build/C/man2/vmsplice.2:122
+#: build/C/man2/arch_prctl.2:88 build/C/man2/futex.2:239 build/C/man2/get_robust_list.2:84 build/C/man2/getunwind.2:88 build/C/man2/kexec_load.2:121 build/C/man2/lookup_dcookie.2:50 build/C/man2/modify_ldt.2:108 build/C/man2/pciconfig_read.2:77 build/C/man2/perf_event_open.2:2122 build/C/man2/personality.2:64 build/C/man2/pivot_root.2:105 build/C/man2/process_vm_readv.2:229 build/C/man2/ptrace.2:1801 build/C/man2/quotactl.2:427 build/C/man2/sendfile.2:115 build/C/man2/set_tid_address.2:91 build/C/man2/splice.2:142 build/C/man2/tee.2:100 build/C/man2/vm86.2:59 build/C/man2/vmsplice.2:122
#, no-wrap
msgid "ERRORS"
msgstr ""
#. type: TP
-#: build/C/man2/arch_prctl.2:89 build/C/man2/futex.2:249 build/C/man2/get_robust_list.2:111 build/C/man2/lookup_dcookie.2:51 build/C/man2/modify_ldt.2:109 build/C/man2/process_vm_readv.2:251 build/C/man2/process_vm_readv.2:256 build/C/man2/ptrace.2:1805 build/C/man2/quotactl.2:428 build/C/man2/sendfile.2:125 build/C/man2/vm86.2:60
+#: build/C/man2/arch_prctl.2:89 build/C/man2/futex.2:254 build/C/man2/get_robust_list.2:111 build/C/man2/lookup_dcookie.2:51 build/C/man2/modify_ldt.2:109 build/C/man2/process_vm_readv.2:251 build/C/man2/process_vm_readv.2:256 build/C/man2/ptrace.2:1805 build/C/man2/quotactl.2:428 build/C/man2/sendfile.2:125 build/C/man2/vm86.2:60
#, no-wrap
msgid "B<EFAULT>"
msgstr ""
msgstr ""
#. type: TP
-#: build/C/man2/arch_prctl.2:93 build/C/man2/futex.2:261 build/C/man2/get_robust_list.2:88 build/C/man2/kexec_load.2:126 build/C/man2/lookup_dcookie.2:54 build/C/man2/modify_ldt.2:113 build/C/man2/pciconfig_read.2:78 build/C/man2/perf_event_open.2:2033 build/C/man2/personality.2:65 build/C/man2/pivot_root.2:114 build/C/man2/process_vm_readv.2:230 build/C/man2/process_vm_readv.2:241 build/C/man2/process_vm_readv.2:245 build/C/man2/ptrace.2:1816 build/C/man2/quotactl.2:434 build/C/man2/quotactl.2:501 build/C/man2/sendfile.2:128 build/C/man2/splice.2:147 build/C/man2/tee.2:101 build/C/man2/vmsplice.2:127
+#: build/C/man2/arch_prctl.2:93 build/C/man2/futex.2:266 build/C/man2/get_robust_list.2:88 build/C/man2/kexec_load.2:126 build/C/man2/lookup_dcookie.2:54 build/C/man2/modify_ldt.2:113 build/C/man2/pciconfig_read.2:78 build/C/man2/perf_event_open.2:2123 build/C/man2/personality.2:65 build/C/man2/pivot_root.2:114 build/C/man2/process_vm_readv.2:230 build/C/man2/process_vm_readv.2:241 build/C/man2/process_vm_readv.2:245 build/C/man2/ptrace.2:1816 build/C/man2/quotactl.2:434 build/C/man2/quotactl.2:501 build/C/man2/sendfile.2:128 build/C/man2/splice.2:147 build/C/man2/tee.2:101 build/C/man2/vmsplice.2:127
#, no-wrap
msgid "B<EINVAL>"
msgstr ""
msgstr ""
#. type: SH
-#: build/C/man2/arch_prctl.2:103 build/C/man2/futex.2:296 build/C/man2/getunwind.2:96 build/C/man2/kexec_load.2:142 build/C/man2/lookup_dcookie.2:78 build/C/man2/modify_ldt.2:130 build/C/man2/nfsservctl.2:56 build/C/man2/outb.2:87 build/C/man2/pciconfig_read.2:112 build/C/man2/perf_event_open.2:2051 build/C/man2/perfmonctl.2:199 build/C/man2/personality.2:68 build/C/man2/pivot_root.2:128 build/C/man2/process_vm_readv.2:279 build/C/man2/ptrace.2:1844 build/C/man2/sendfile.2:148 build/C/man2/set_tid_address.2:97 build/C/man2/splice.2:170 build/C/man2/tee.2:119 build/C/man2/vm86.2:73 build/C/man2/vmsplice.2:143
+#: build/C/man2/arch_prctl.2:103 build/C/man2/futex.2:301 build/C/man2/getunwind.2:96 build/C/man2/kexec_load.2:142 build/C/man2/lookup_dcookie.2:78 build/C/man2/modify_ldt.2:130 build/C/man2/nfsservctl.2:58 build/C/man2/outb.2:87 build/C/man2/pciconfig_read.2:112 build/C/man2/perf_event_open.2:2141 build/C/man2/perfmonctl.2:199 build/C/man2/personality.2:68 build/C/man2/pivot_root.2:128 build/C/man2/process_vm_readv.2:279 build/C/man2/ptrace.2:1844 build/C/man2/sendfile.2:148 build/C/man2/set_tid_address.2:97 build/C/man2/splice.2:170 build/C/man2/tee.2:119 build/C/man2/vm86.2:73 build/C/man2/vmsplice.2:143
#, no-wrap
msgid "CONFORMING TO"
msgstr ""
msgstr ""
#. type: SH
-#: build/C/man2/arch_prctl.2:107 build/C/man2/futex.2:298 build/C/man2/get_robust_list.2:119 build/C/man2/getunwind.2:99 build/C/man2/kexec_load.2:144 build/C/man2/lookup_dcookie.2:81 build/C/man2/modify_ldt.2:133 build/C/man2/perf_event_open.2:2056 build/C/man2/perfmonctl.2:202 build/C/man2/pivot_root.2:131 build/C/man2/process_vm_readv.2:281 build/C/man2/ptrace.2:1846 build/C/man2/sendfile.2:155 build/C/man2/splice.2:172 build/C/man2/tee.2:121 build/C/man2/vmsplice.2:145
+#: build/C/man2/arch_prctl.2:107 build/C/man2/futex.2:303 build/C/man2/get_robust_list.2:119 build/C/man2/getunwind.2:99 build/C/man2/kexec_load.2:144 build/C/man2/lookup_dcookie.2:81 build/C/man2/modify_ldt.2:133 build/C/man2/perf_event_open.2:2146 build/C/man2/perfmonctl.2:202 build/C/man2/pivot_root.2:131 build/C/man2/process_vm_readv.2:281 build/C/man2/ptrace.2:1846 build/C/man2/sendfile.2:155 build/C/man2/splice.2:172 build/C/man2/tee.2:121 build/C/man2/vmsplice.2:145
#, no-wrap
msgid "NOTES"
msgstr ""
msgstr ""
#. type: SH
-#: build/C/man2/arch_prctl.2:138 build/C/man2/futex.2:312 build/C/man2/get_robust_list.2:128 build/C/man2/getunwind.2:111 build/C/man2/kexec_load.2:159 build/C/man2/modify_ldt.2:136 build/C/man2/outb.2:96 build/C/man2/pciconfig_read.2:114 build/C/man2/perf_event_open.2:2176 build/C/man2/perfmonctl.2:205 build/C/man2/pivot_root.2:143 build/C/man2/process_vm_readv.2:331 build/C/man2/ptrace.2:2000 build/C/man2/quotactl.2:507 build/C/man2/sendfile.2:197 build/C/man2/set_tid_address.2:99 build/C/man2/splice.2:226 build/C/man2/tee.2:197 build/C/man2/vmsplice.2:154
+#: build/C/man2/arch_prctl.2:138 build/C/man2/futex.2:317 build/C/man2/get_robust_list.2:128 build/C/man2/getunwind.2:111 build/C/man2/kexec_load.2:159 build/C/man2/modify_ldt.2:136 build/C/man2/outb.2:96 build/C/man2/pciconfig_read.2:114 build/C/man2/perf_event_open.2:2266 build/C/man2/perfmonctl.2:205 build/C/man2/pivot_root.2:143 build/C/man2/process_vm_readv.2:331 build/C/man2/ptrace.2:2000 build/C/man2/quotactl.2:507 build/C/man2/sendfile.2:197 build/C/man2/set_tid_address.2:99 build/C/man2/splice.2:226 build/C/man2/tee.2:197 build/C/man2/vmsplice.2:154
#, no-wrap
msgid "SEE ALSO"
msgstr ""
msgstr ""
#. type: SH
-#: build/C/man2/arch_prctl.2:145 build/C/man2/futex.2:326 build/C/man2/get_robust_list.2:137 build/C/man2/getunwind.2:113 build/C/man2/kexec_load.2:162 build/C/man2/lookup_dcookie.2:88 build/C/man2/modify_ldt.2:138 build/C/man2/nfsservctl.2:58 build/C/man2/outb.2:99 build/C/man2/pciconfig_read.2:116 build/C/man2/perf_event_open.2:2182 build/C/man2/perfmonctl.2:209 build/C/man2/personality.2:72 build/C/man2/pivot_root.2:149 build/C/man2/process_vm_readv.2:334 build/C/man2/ptrace.2:2014 build/C/man2/quotactl.2:512 build/C/man2/sendfile.2:203 build/C/man2/set_tid_address.2:102 build/C/man2/splice.2:230 build/C/man2/tee.2:200 build/C/man2/vm86.2:76 build/C/man2/vmsplice.2:157
+#: build/C/man2/arch_prctl.2:145 build/C/man2/futex.2:331 build/C/man2/get_robust_list.2:137 build/C/man2/getunwind.2:113 build/C/man2/kexec_load.2:162 build/C/man2/lookup_dcookie.2:88 build/C/man2/modify_ldt.2:138 build/C/man2/nfsservctl.2:60 build/C/man2/outb.2:99 build/C/man2/pciconfig_read.2:116 build/C/man2/perf_event_open.2:2272 build/C/man2/perfmonctl.2:209 build/C/man2/personality.2:72 build/C/man2/pivot_root.2:149 build/C/man2/process_vm_readv.2:334 build/C/man2/ptrace.2:2014 build/C/man2/quotactl.2:512 build/C/man2/sendfile.2:203 build/C/man2/set_tid_address.2:102 build/C/man2/splice.2:230 build/C/man2/tee.2:200 build/C/man2/vm86.2:76 build/C/man2/vmsplice.2:157
#, no-wrap
msgid "COLOPHON"
msgstr ""
#. type: Plain text
-#: build/C/man2/arch_prctl.2:152 build/C/man2/futex.2:333 build/C/man2/get_robust_list.2:144 build/C/man2/getunwind.2:120 build/C/man2/kexec_load.2:169 build/C/man2/lookup_dcookie.2:95 build/C/man2/modify_ldt.2:145 build/C/man2/nfsservctl.2:65 build/C/man2/outb.2:106 build/C/man2/pciconfig_read.2:123 build/C/man2/perf_event_open.2:2189 build/C/man2/perfmonctl.2:216 build/C/man2/personality.2:79 build/C/man2/pivot_root.2:156 build/C/man2/process_vm_readv.2:341 build/C/man2/ptrace.2:2021 build/C/man2/quotactl.2:519 build/C/man2/sendfile.2:210 build/C/man2/set_tid_address.2:109 build/C/man2/splice.2:237 build/C/man2/tee.2:207 build/C/man2/vm86.2:83 build/C/man2/vmsplice.2:164
+#: build/C/man2/arch_prctl.2:152 build/C/man2/futex.2:338 build/C/man2/get_robust_list.2:144 build/C/man2/getunwind.2:120 build/C/man2/kexec_load.2:169 build/C/man2/lookup_dcookie.2:95 build/C/man2/modify_ldt.2:145 build/C/man2/nfsservctl.2:67 build/C/man2/outb.2:106 build/C/man2/pciconfig_read.2:123 build/C/man2/perf_event_open.2:2279 build/C/man2/perfmonctl.2:216 build/C/man2/personality.2:79 build/C/man2/pivot_root.2:156 build/C/man2/process_vm_readv.2:341 build/C/man2/ptrace.2:2021 build/C/man2/quotactl.2:519 build/C/man2/sendfile.2:210 build/C/man2/set_tid_address.2:109 build/C/man2/splice.2:237 build/C/man2/tee.2:207 build/C/man2/vm86.2:83 build/C/man2/vmsplice.2:164
msgid ""
-"This page is part of release 3.53 of the Linux I<man-pages> project. A "
+"This page is part of release 3.54 of the Linux I<man-pages> project. A "
"description of the project, and information about reporting bugs, can be "
"found at \\%http://www.kernel.org/doc/man-pages/."
msgstr ""
#. type: TH
#: build/C/man2/futex.2:53
#, no-wrap
-msgid "2013-07-30"
+msgid "2013-09-04"
msgstr ""
#. type: Plain text
msgstr ""
#. type: TP
-#: build/C/man2/futex.2:108 build/C/man2/futex.2:216
+#: build/C/man2/futex.2:108 build/C/man2/futex.2:221
#, no-wrap
msgid "B<FUTEX_WAIT>"
msgstr ""
#. type: Plain text
-#: build/C/man2/futex.2:126
+#: build/C/man2/futex.2:131
msgid ""
"This operation atomically verifies that the futex address I<uaddr> still "
"contains the value I<val>, and sleeps awaiting B<FUTEX_WAKE> on this futex "
-"address. If the I<timeout> argument is non-NULL, its contents describe the "
-"minimum duration of the wait, which is infinite otherwise. The arguments "
-"I<uaddr2> and I<val3> are ignored."
+"address. If the I<timeout> argument is non-NULL, its contents specify the "
+"duration of the wait. (This interval will be rounded up to the system clock "
+"granularity, and kernel scheduling delays mean that the blocking interval "
+"may overrun by a small amount.) If I<timeout> is NULL, the call blocks "
+"indefinitely. The arguments I<uaddr2> and I<val3> are ignored."
msgstr ""
#. type: Plain text
-#: build/C/man2/futex.2:134
+#: build/C/man2/futex.2:139
msgid ""
"For B<futex>(7), this call is executed if decrementing the count gave a "
"negative value (indicating contention), and will sleep until another process "
msgstr ""
#. type: TP
-#: build/C/man2/futex.2:134 build/C/man2/futex.2:222
+#: build/C/man2/futex.2:139 build/C/man2/futex.2:227
#, no-wrap
msgid "B<FUTEX_WAKE>"
msgstr ""
#. type: Plain text
-#: build/C/man2/futex.2:145
+#: build/C/man2/futex.2:150
msgid ""
"This operation wakes at most I<val> processes waiting on this futex address "
"(i.e., inside B<FUTEX_WAIT>). The arguments I<timeout>, I<uaddr2> and "
msgstr ""
#. type: Plain text
-#: build/C/man2/futex.2:151
+#: build/C/man2/futex.2:156
msgid ""
"For B<futex>(7), this is executed if incrementing the count showed that "
"there were waiters, once the futex value has been set to 1 (indicating that "
msgstr ""
#. type: TP
-#: build/C/man2/futex.2:151
+#: build/C/man2/futex.2:156
#, no-wrap
msgid "B<FUTEX_FD> (present up to and including Linux 2.6.25)"
msgstr ""
#. , suitable for .BR poll (2).
#. type: Plain text
-#: build/C/man2/futex.2:167
+#: build/C/man2/futex.2:172
msgid ""
"To support asynchronous wakeups, this operation associates a file descriptor "
"with a futex. If another process executes a B<FUTEX_WAKE>, the process will "
msgstr ""
#. type: Plain text
-#: build/C/man2/futex.2:172
+#: build/C/man2/futex.2:177
msgid ""
"To prevent race conditions, the caller should test if the futex has been "
"upped after B<FUTEX_FD> returns."
msgstr ""
#. type: Plain text
-#: build/C/man2/futex.2:176
+#: build/C/man2/futex.2:181
msgid ""
"Because it was inherently racy, B<FUTEX_FD> has been removed from Linux "
"2.6.26 onward."
msgstr ""
#. type: TP
-#: build/C/man2/futex.2:176
+#: build/C/man2/futex.2:181
#, no-wrap
msgid "B<FUTEX_REQUEUE> (since Linux 2.5.70)"
msgstr ""
#. type: Plain text
-#: build/C/man2/futex.2:191
+#: build/C/man2/futex.2:196
msgid ""
"This operation was introduced in order to avoid a \"thundering herd\" effect "
"when B<FUTEX_WAKE> is used and all processes woken up need to acquire "
msgstr ""
#. type: TP
-#: build/C/man2/futex.2:191
+#: build/C/man2/futex.2:196
#, no-wrap
msgid "B<FUTEX_CMP_REQUEUE> (since Linux 2.6.7)"
msgstr ""
#. type: Plain text
-#: build/C/man2/futex.2:209
+#: build/C/man2/futex.2:214
msgid ""
"There was a race in the intended use of B<FUTEX_REQUEUE>, so "
"B<FUTEX_CMP_REQUEUE> was introduced. This is similar to B<FUTEX_REQUEUE>, "
msgstr ""
#. type: Plain text
-#: build/C/man2/futex.2:216
+#: build/C/man2/futex.2:221
msgid ""
"In the event of an error, all operations return -1, and set I<errno> to "
"indicate the error. The return value on success depends on the operation, "
msgstr ""
#. type: Plain text
-#: build/C/man2/futex.2:222
+#: build/C/man2/futex.2:227
msgid ""
"Returns 0 if the process was woken by a B<FUTEX_WAKE> call. See ERRORS for "
"the various possible error returns."
msgstr ""
#. type: Plain text
-#: build/C/man2/futex.2:225 build/C/man2/futex.2:231 build/C/man2/futex.2:234
+#: build/C/man2/futex.2:230 build/C/man2/futex.2:236 build/C/man2/futex.2:239
msgid "Returns the number of processes woken up."
msgstr ""
#. type: TP
-#: build/C/man2/futex.2:225
+#: build/C/man2/futex.2:230
#, no-wrap
msgid "B<FUTEX_FD>"
msgstr ""
#. type: Plain text
-#: build/C/man2/futex.2:228
+#: build/C/man2/futex.2:233
msgid "Returns the new file descriptor associated with the futex."
msgstr ""
#. type: TP
-#: build/C/man2/futex.2:228
+#: build/C/man2/futex.2:233
#, no-wrap
msgid "B<FUTEX_REQUEUE>"
msgstr ""
#. type: TP
-#: build/C/man2/futex.2:231
+#: build/C/man2/futex.2:236
#, no-wrap
msgid "B<FUTEX_CMP_REQUEUE>"
msgstr ""
#. type: TP
-#: build/C/man2/futex.2:235 build/C/man2/quotactl.2:486
+#: build/C/man2/futex.2:240 build/C/man2/quotactl.2:486
#, no-wrap
msgid "B<EACCES>"
msgstr ""
#. type: Plain text
-#: build/C/man2/futex.2:238
+#: build/C/man2/futex.2:243
msgid "No read access to futex memory."
msgstr ""
#. type: TP
-#: build/C/man2/futex.2:238 build/C/man2/sendfile.2:116
+#: build/C/man2/futex.2:243 build/C/man2/sendfile.2:116
#, no-wrap
msgid "B<EAGAIN>"
msgstr ""
#. type: Plain text
-#: build/C/man2/futex.2:249
+#: build/C/man2/futex.2:254
msgid ""
"B<FUTEX_CMP_REQUEUE> detected that the value pointed to by I<uaddr> is not "
"equal to the expected value I<val3>. (This probably indicates a race; use "
msgstr ""
#. type: Plain text
-#: build/C/man2/futex.2:254
+#: build/C/man2/futex.2:259
msgid "Error retrieving I<timeout> information from user space."
msgstr ""
#. type: TP
-#: build/C/man2/futex.2:254
+#: build/C/man2/futex.2:259
#, no-wrap
msgid "B<EINTR>"
msgstr ""
#. type: Plain text
-#: build/C/man2/futex.2:261
+#: build/C/man2/futex.2:266
msgid ""
"A B<FUTEX_WAIT> operation was interrupted by a signal (see B<signal>(7)) or "
"a spurious wakeup."
msgstr ""
#. type: Plain text
-#: build/C/man2/futex.2:264
+#: build/C/man2/futex.2:269
msgid "Invalid argument."
msgstr ""
#. type: TP
-#: build/C/man2/futex.2:264
+#: build/C/man2/futex.2:269
#, no-wrap
msgid "B<ENFILE>"
msgstr ""
#. type: Plain text
-#: build/C/man2/futex.2:267
+#: build/C/man2/futex.2:272
msgid "The system limit on the total number of open files has been reached."
msgstr ""
#. type: TP
-#: build/C/man2/futex.2:267 build/C/man2/modify_ldt.2:126 build/C/man2/pciconfig_read.2:93 build/C/man2/quotactl.2:447 build/C/man2/vm86.2:64
+#: build/C/man2/futex.2:272 build/C/man2/modify_ldt.2:126 build/C/man2/pciconfig_read.2:93 build/C/man2/quotactl.2:447 build/C/man2/vm86.2:64
#, no-wrap
msgid "B<ENOSYS>"
msgstr ""
#. type: Plain text
-#: build/C/man2/futex.2:271
+#: build/C/man2/futex.2:276
msgid "Invalid operation specified in I<op>."
msgstr ""
#. type: TP
-#: build/C/man2/futex.2:271
+#: build/C/man2/futex.2:276
#, no-wrap
msgid "B<ETIMEDOUT>"
msgstr ""
#. type: Plain text
-#: build/C/man2/futex.2:276
+#: build/C/man2/futex.2:281
msgid "Timeout during the B<FUTEX_WAIT> operation."
msgstr ""
#. type: TP
-#: build/C/man2/futex.2:276
+#: build/C/man2/futex.2:281
#, no-wrap
msgid "B<EWOULDBLOCK>"
msgstr ""
#. type: Plain text
-#: build/C/man2/futex.2:286
+#: build/C/man2/futex.2:291
msgid ""
"I<op> was B<FUTEX_WAIT> and the value pointed to by I<uaddr> was not equal "
"to the expected value I<val> at the time of the call."
msgstr ""
#. type: SH
-#: build/C/man2/futex.2:286 build/C/man2/get_robust_list.2:115 build/C/man2/getunwind.2:94 build/C/man2/kexec_load.2:138 build/C/man2/lookup_dcookie.2:73 build/C/man2/perfmonctl.2:196 build/C/man2/pivot_root.2:125 build/C/man2/process_vm_readv.2:276 build/C/man2/sendfile.2:142 build/C/man2/set_tid_address.2:94 build/C/man2/splice.2:165 build/C/man2/tee.2:114 build/C/man2/vmsplice.2:138
+#: build/C/man2/futex.2:291 build/C/man2/get_robust_list.2:115 build/C/man2/getunwind.2:94 build/C/man2/kexec_load.2:138 build/C/man2/lookup_dcookie.2:73 build/C/man2/perfmonctl.2:196 build/C/man2/pivot_root.2:125 build/C/man2/process_vm_readv.2:276 build/C/man2/sendfile.2:142 build/C/man2/set_tid_address.2:94 build/C/man2/splice.2:165 build/C/man2/tee.2:114 build/C/man2/vmsplice.2:138
#, no-wrap
msgid "VERSIONS"
msgstr ""
#. type: Plain text
-#: build/C/man2/futex.2:296
+#: build/C/man2/futex.2:301
msgid ""
"Initial futex support was merged in Linux 2.5.7 but with different semantics "
"from what was described above. A 4-argument system call with the semantics "
msgstr ""
#. type: Plain text
-#: build/C/man2/futex.2:298 build/C/man2/kexec_load.2:144 build/C/man2/set_tid_address.2:99 build/C/man2/splice.2:172 build/C/man2/tee.2:121 build/C/man2/vmsplice.2:145
+#: build/C/man2/futex.2:303 build/C/man2/kexec_load.2:144 build/C/man2/set_tid_address.2:99 build/C/man2/splice.2:172 build/C/man2/tee.2:121 build/C/man2/vmsplice.2:145
msgid "This system call is Linux-specific."
msgstr ""
#. and Rusty Russell (IBM Linux Technology Center).
#. This page written by bert hubert.
#. type: Plain text
-#: build/C/man2/futex.2:312
+#: build/C/man2/futex.2:317
msgid ""
"To reiterate, bare futexes are not intended as an easy-to-use abstraction "
"for end-users. (There is no wrapper function for this system call in "
msgstr ""
#. type: Plain text
-#: build/C/man2/futex.2:315
+#: build/C/man2/futex.2:320
msgid "B<restart_syscall>(2), B<futex>(7)"
msgstr ""
#. type: Plain text
-#: build/C/man2/futex.2:318
+#: build/C/man2/futex.2:323
msgid ""
"I<Fuss, Futexes and Furwocks: Fast Userlevel Locking in Linux> (proceedings "
"of the Ottawa Linux Symposium 2002), online at"
msgstr ""
#. type: Plain text
-#: build/C/man2/futex.2:321
+#: build/C/man2/futex.2:326
msgid ""
"E<.UR http://kernel.org\\:/doc\\:/ols\\:/2002\\:/ols2002-pages-479-495.pdf> "
"E<.UE>"
msgstr ""
#. type: Plain text
-#: build/C/man2/futex.2:323
+#: build/C/man2/futex.2:328
msgid "Futex example library, futex-*.tar.bz2 at"
msgstr ""
#. type: Plain text
-#: build/C/man2/futex.2:326
+#: build/C/man2/futex.2:331
msgid ""
"E<.UR ftp://ftp.nl.kernel.org\\:/pub\\:/linux\\:/kernel\\:/people\\:/rusty/> "
"E<.UE>"
#. type: TH
#: build/C/man2/nfsservctl.2:8
#, no-wrap
-msgid "2012-03-05"
+msgid "2013-09-17"
msgstr ""
#. type: Plain text
msgstr ""
#. type: Plain text
-#: build/C/man2/nfsservctl.2:33
+#: build/C/man2/nfsservctl.2:35
#, no-wrap
msgid ""
"/*\n"
"#define NFSCTL_SVC 0 /* This is a server process. */\n"
"#define NFSCTL_ADDCLIENT 1 /* Add an NFS client. */\n"
"#define NFSCTL_DELCLIENT 2 /* Remove an NFS client. */\n"
-"#define NFSCTL_EXPORT 3 /* export a file system. */\n"
-"#define NFSCTL_UNEXPORT 4 /* unexport a file system. */\n"
-"#define NFSCTL_UGIDUPDATE 5 /* update a client's UID/GID map. */\n"
-"#define NFSCTL_GETFH 6 /* get an fh (used by mountd) */\n"
+"#define NFSCTL_EXPORT 3 /* Export a filesystem. */\n"
+"#define NFSCTL_UNEXPORT 4 /* Unexport a filesystem. */\n"
+"#define NFSCTL_UGIDUPDATE 5 /* Update a client's UID/GID map\n"
+" (only in Linux 2.4.x and earlier). */\n"
+"#define NFSCTL_GETFH 6 /* Get a file handle (used by mountd)\n"
+" (only in Linux 2.4.x and earlier). */\n"
msgstr ""
#. type: Plain text
-#: build/C/man2/nfsservctl.2:45
+#: build/C/man2/nfsservctl.2:47
#, no-wrap
msgid ""
"struct nfsctl_arg {\n"
msgstr ""
#. type: Plain text
-#: build/C/man2/nfsservctl.2:50
+#: build/C/man2/nfsservctl.2:52
#, no-wrap
msgid ""
"union nfsctl_res {\n"
msgstr ""
#. type: Plain text
-#: build/C/man2/nfsservctl.2:56 build/C/man2/pivot_root.2:105 build/C/man2/vm86.2:59
+#: build/C/man2/nfsservctl.2:58 build/C/man2/pivot_root.2:105 build/C/man2/vm86.2:59
msgid ""
"On success, zero is returned. On error, -1 is returned, and I<errno> is set "
"appropriately."
msgstr ""
#. type: Plain text
-#: build/C/man2/nfsservctl.2:58
+#: build/C/man2/nfsservctl.2:60
msgid "This call is Linux-specific."
msgstr ""
#. type: TH
#: build/C/man2/perf_event_open.2:27
#, no-wrap
-msgid "2013-07-16"
+msgid "2013-09-13"
msgstr ""
#. type: Plain text
msgid ""
"This flag activates per-container system-wide monitoring. A container is an "
"abstraction that isolates a set of resources for finer grain control (CPUs, "
-"memory, etc...). In this mode, the event is measured only if the thread "
+"memory, etc.). In this mode, the event is measured only if the thread "
"running on the monitored CPU belongs to the designated container (cgroup). "
"The cgroup is identified by passing a file descriptor opened on its "
"directory in the cgroupfs filesystem. For instance, if the cgroup to "
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:261 build/C/man2/perf_event_open.2:1311
+#: build/C/man2/perf_event_open.2:261 build/C/man2/perf_event_open.2:1379
#, no-wrap
msgid "I<type>"
msgstr ""
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:316 build/C/man2/perf_event_open.2:1770
+#: build/C/man2/perf_event_open.2:316 build/C/man2/perf_event_open.2:1327
#, no-wrap
msgid "I<size>"
msgstr ""
#. type: Plain text
#: build/C/man2/perf_event_open.2:383
-msgid "Total cycles. Be wary of what happens during CPU frequency scaling"
+msgid "Total cycles. Be wary of what happens during CPU frequency scaling."
msgstr ""
#. type: TP
#: build/C/man2/perf_event_open.2:388
msgid ""
"Retired instructions. Be careful, these can be affected by various issues, "
-"most notably hardware interrupt counts"
+"most notably hardware interrupt counts."
msgstr ""
#. type: TP
#. type: Plain text
#: build/C/man2/perf_event_open.2:840
-msgid "B<SAMPLE_IP> can have arbitrary skid"
+msgid "B<SAMPLE_IP> can have arbitrary skid."
msgstr ""
#. type: TP
#. type: Plain text
#: build/C/man2/perf_event_open.2:844
-msgid "B<SAMPLE_IP> must have constant skid"
+msgid "B<SAMPLE_IP> must have constant skid."
msgstr ""
#. type: TP
#. type: Plain text
#: build/C/man2/perf_event_open.2:848
-msgid "B<SAMPLE_IP> requested to have 0 skid"
+msgid "B<SAMPLE_IP> requested to have 0 skid."
msgstr ""
#. type: TP
#. type: Plain text
#: build/C/man2/perf_event_open.2:872
-msgid "Do not measure time spent in VM host"
+msgid "Do not measure time spent in VM host."
msgstr ""
#. type: TP
#. type: Plain text
#: build/C/man2/perf_event_open.2:875
-msgid "Do not measure time spent in VM guest"
+msgid "Do not measure time spent in VM guest."
msgstr ""
#. type: TP
#. type: Plain text
#: build/C/man2/perf_event_open.2:909
-msgid "no breakpoint"
+msgid "No breakpoint."
msgstr ""
#. type: TP
#. type: Plain text
#: build/C/man2/perf_event_open.2:912
-msgid "count when we read the memory location"
+msgid "Count when we read the memory location."
msgstr ""
#. type: TP
#. type: Plain text
#: build/C/man2/perf_event_open.2:915
-msgid "count when we write the memory location"
+msgid "Count when we write the memory location."
msgstr ""
#. type: TP
#. type: Plain text
#: build/C/man2/perf_event_open.2:918
-msgid "count when we read or write the memory location"
+msgid "Count when we read or write the memory location."
msgstr ""
#. type: TP
#. type: Plain text
#: build/C/man2/perf_event_open.2:921
-msgid "count when we execute code at the memory location"
+msgid "Count when we execute code at the memory location."
msgstr ""
#. type: Plain text
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:979
+#: build/C/man2/perf_event_open.2:972
msgid ""
"If B<PERF_SAMPLE_BRANCH_STACK> is enabled, then this specifies what branches "
-"to include in the branch record. If the user does not set privilege level "
+"to include in the branch record."
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/perf_event_open.2:978
+msgid ""
+"The first part of the value is the privilege level, which is a combination "
+"of one of the following values. If the user does not set privilege level "
"explicitly, the kernel will use the event's privilege level. Event and "
-"branch privilege levels do not have to match. The value is formed by ORing "
-"together zero or more of the following values, although "
-"B<PERF_SAMPLE_BRANCH_ANY> covers all branch types."
+"branch privilege levels do not have to match."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:980
+#: build/C/man2/perf_event_open.2:979
#, no-wrap
msgid "B<PERF_SAMPLE_BRANCH_USER>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:983
-msgid "Branch target is in user space"
+#: build/C/man2/perf_event_open.2:982
+msgid "Branch target is in user space."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:983
+#: build/C/man2/perf_event_open.2:982
#, no-wrap
msgid "B<PERF_SAMPLE_BRANCH_KERNEL>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:986
-msgid "Branch target is in kernel space"
+#: build/C/man2/perf_event_open.2:985
+msgid "Branch target is in kernel space."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:986
+#: build/C/man2/perf_event_open.2:985
#, no-wrap
msgid "B<PERF_SAMPLE_BRANCH_HV>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:989
-msgid "Branch target is in hypervisor"
+#: build/C/man2/perf_event_open.2:988
+msgid "Branch target is in hypervisor."
+msgstr ""
+
+#. type: TP
+#: build/C/man2/perf_event_open.2:988
+#, no-wrap
+msgid "B<PERF_SAMPLE_BRANCH_PLM_ALL>"
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/perf_event_open.2:991
+msgid "A convenience value that is the three preceding values ORed together."
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/perf_event_open.2:995
+msgid ""
+"In addition to the privilege value, at least one or more of the following "
+"bits must be set."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:989
+#: build/C/man2/perf_event_open.2:996
#, no-wrap
msgid "B<PERF_SAMPLE_BRANCH_ANY>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:992
+#: build/C/man2/perf_event_open.2:999
msgid "Any branch type."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:992
+#: build/C/man2/perf_event_open.2:999
#, no-wrap
msgid "B<PERF_SAMPLE_BRANCH_ANY_CALL>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:995
-msgid "Any call branch"
+#: build/C/man2/perf_event_open.2:1002
+msgid "Any call branch."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:995
+#: build/C/man2/perf_event_open.2:1002
#, no-wrap
msgid "B<PERF_SAMPLE_BRANCH_ANY_RETURN>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:998
-msgid "Any return branch"
+#: build/C/man2/perf_event_open.2:1005
+msgid "Any return branch."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:998
+#: build/C/man2/perf_event_open.2:1005
#, no-wrap
msgid "B<PERF_SAMPLE_BRANCH_IND_CALL>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1001
-msgid "Indirect calls"
+#: build/C/man2/perf_event_open.2:1008
+msgid "Indirect calls."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1001
+#: build/C/man2/perf_event_open.2:1008
#, no-wrap
-msgid "B<PERF_SAMPLE_BRANCH_PLM_ALL>"
+msgid "B<PERF_SAMPLE_BRANCH_ABORT_TX> (Since Linux 3.11)"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1004
-msgid "User, kernel, and hv"
+#: build/C/man2/perf_event_open.2:1011
+msgid "Transactional memory aborts."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1005
+#: build/C/man2/perf_event_open.2:1011
+#, no-wrap
+msgid "B<PERF_SAMPLE_BRANCH_IN_TX> (Since Linux 3.11)"
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/perf_event_open.2:1014
+msgid "Branch in transactional memory transaction."
+msgstr ""
+
+#. type: TP
+#: build/C/man2/perf_event_open.2:1014
+#, no-wrap
+msgid "B<PERF_SAMPLE_BRANCH_NO_TX> (Since Linux 3.11)"
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/perf_event_open.2:1017
+msgid "Branch not in transactional memory transaction."
+msgstr ""
+
+#. type: TP
+#: build/C/man2/perf_event_open.2:1019
#, no-wrap
msgid "I<sample_regs_user> (Since Linux 3.7)"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1011
+#: build/C/man2/perf_event_open.2:1025
msgid ""
"This bitmask defines the set of user CPU registers to dump on samples. The "
"layout of the register mask is architecture specific and described in the "
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1011
+#: build/C/man2/perf_event_open.2:1025
#, no-wrap
msgid "I<sample_stack_user> (Since Linux 3.7)"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1016
+#: build/C/man2/perf_event_open.2:1030
msgid ""
"This defines the size of the user stack to dump if B<PERF_SAMPLE_STACK_USER> "
"is specified."
msgstr ""
#. type: SS
-#: build/C/man2/perf_event_open.2:1016
+#: build/C/man2/perf_event_open.2:1030
#, no-wrap
msgid "Reading results"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1026
+#: build/C/man2/perf_event_open.2:1040
msgid ""
"Once a B<perf_event_open>() file descriptor has been opened, the values of "
"the events can be read from the file descriptor. The values that are there "
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1031
+#: build/C/man2/perf_event_open.2:1045
msgid ""
"If you attempt to read into a buffer that is not big enough to hold the data "
"B<ENOSPC> is returned"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1033
+#: build/C/man2/perf_event_open.2:1047
msgid "Here is the layout of the data returned by a read:"
msgstr ""
#. type: IP
-#: build/C/man2/perf_event_open.2:1033 build/C/man2/perf_event_open.2:1051 build/C/man2/ptrace.2:1619 build/C/man2/ptrace.2:1629 build/C/man2/ptrace.2:1637 build/C/man2/ptrace.2:1643 build/C/man2/ptrace.2:1772
+#: build/C/man2/perf_event_open.2:1047 build/C/man2/perf_event_open.2:1065 build/C/man2/ptrace.2:1619 build/C/man2/ptrace.2:1629 build/C/man2/ptrace.2:1637 build/C/man2/ptrace.2:1643 build/C/man2/ptrace.2:1772
#, no-wrap
msgid "*"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1037
+#: build/C/man2/perf_event_open.2:1051
msgid ""
"If B<PERF_FORMAT_GROUP> was specified to allow reading all events in a group "
"at once:"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1049
+#: build/C/man2/perf_event_open.2:1063
#, no-wrap
msgid ""
"struct read_format {\n"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1057
+#: build/C/man2/perf_event_open.2:1071
msgid "If B<PERF_FORMAT_GROUP> was I<not> specified:"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1066
+#: build/C/man2/perf_event_open.2:1080
#, no-wrap
msgid ""
"struct read_format {\n"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1070
+#: build/C/man2/perf_event_open.2:1084
msgid "The values read are as follows:"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1070
+#: build/C/man2/perf_event_open.2:1084
#, no-wrap
msgid "I<nr>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1076
+#: build/C/man2/perf_event_open.2:1090
msgid ""
"The number of events in this file descriptor. Only available if "
"B<PERF_FORMAT_GROUP> was specified."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1076
+#: build/C/man2/perf_event_open.2:1090
#, no-wrap
msgid "I<time_enabled>, I<time_running>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1088
+#: build/C/man2/perf_event_open.2:1102
msgid ""
"Total time the event was enabled and running. Normally these are the same. "
"If more events are started than available counter slots on the PMU, then "
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1088
+#: build/C/man2/perf_event_open.2:1102
#, no-wrap
msgid "I<value>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1091
+#: build/C/man2/perf_event_open.2:1105
msgid "An unsigned 64-bit value containing the counter result."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1091 build/C/man2/perf_event_open.2:1355 build/C/man2/perf_event_open.2:1492
+#: build/C/man2/perf_event_open.2:1105 build/C/man2/perf_event_open.2:1423 build/C/man2/perf_event_open.2:1560
#, no-wrap
msgid "I<id>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1097
+#: build/C/man2/perf_event_open.2:1111
msgid ""
"A globally unique value for this particular event, only there if "
"B<PERF_FORMAT_ID> was specified in I<read_format>."
msgstr ""
#. type: SS
-#: build/C/man2/perf_event_open.2:1097
+#: build/C/man2/perf_event_open.2:1111
#, no-wrap
msgid "MMAP layout"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1107
+#: build/C/man2/perf_event_open.2:1121
msgid ""
"When using B<perf_event_open>() in sampled mode, asynchronous events (like "
"counter overflow or B<PROT_EXEC> mmap tracking) are logged into a "
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1113
+#: build/C/man2/perf_event_open.2:1127
msgid ""
"The mmap size should be 1+2^n pages, where the first page is a metadata page "
"(I<struct perf_event_mmap_page>) that contains various bits of information "
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1116
+#: build/C/man2/perf_event_open.2:1130
msgid ""
"Before kernel 2.6.39, there is a bug that means you must allocate a mmap "
"ring buffer when sampling even if you do not plan to access it."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1118
+#: build/C/man2/perf_event_open.2:1132
msgid "The structure of the first metadata mmap page is as follows:"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1142
+#: build/C/man2/perf_event_open.2:1156
#, no-wrap
msgid ""
"struct perf_event_mmap_page {\n"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1148
+#: build/C/man2/perf_event_open.2:1162
msgid ""
"The following looks at the fields in the I<perf_event_mmap_page> structure "
"in more detail:"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1148
+#: build/C/man2/perf_event_open.2:1162
#, no-wrap
msgid "I<version>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1151
+#: build/C/man2/perf_event_open.2:1165
msgid "Version number of this structure."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1151
+#: build/C/man2/perf_event_open.2:1165
#, no-wrap
msgid "I<compat_version>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1154
+#: build/C/man2/perf_event_open.2:1168
msgid "The lowest version this is compatible with."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1154
+#: build/C/man2/perf_event_open.2:1168
#, no-wrap
msgid "I<lock>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1157
+#: build/C/man2/perf_event_open.2:1171
msgid "A seqlock for synchronization."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1157
+#: build/C/man2/perf_event_open.2:1171
#, no-wrap
msgid "I<index>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1160
+#: build/C/man2/perf_event_open.2:1174
msgid "A unique hardware counter identifier."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1160
+#: build/C/man2/perf_event_open.2:1174
#, no-wrap
msgid "I<offset>"
msgstr ""
#. FIXME clarify
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1164
+#: build/C/man2/perf_event_open.2:1178
msgid "Add this to hardware counter value??"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1164
+#: build/C/man2/perf_event_open.2:1178
#, no-wrap
msgid "I<time_enabled>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1167
+#: build/C/man2/perf_event_open.2:1181
msgid "Time the event was active."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1167
+#: build/C/man2/perf_event_open.2:1181
#, no-wrap
msgid "I<time_running>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1170
+#: build/C/man2/perf_event_open.2:1184
msgid "Time the event was running."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1170
+#: build/C/man2/perf_event_open.2:1184
#, no-wrap
msgid "I<cap_usr_time>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1173
-msgid "User time capability"
+#: build/C/man2/perf_event_open.2:1187
+msgid "User time capability."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1173
+#: build/C/man2/perf_event_open.2:1187
#, no-wrap
msgid "I<cap_usr_rdpmc>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1178
+#: build/C/man2/perf_event_open.2:1192
msgid ""
"If the hardware supports user-space read of performance counters without "
"syscall (this is the \"rdpmc\" instruction on x86), then the following code "
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1185
+#: build/C/man2/perf_event_open.2:1199
#, no-wrap
msgid ""
"u32 seq, time_mult, time_shift, idx, width;\n"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1191
+#: build/C/man2/perf_event_open.2:1205
#, no-wrap
msgid ""
"do {\n"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1198
+#: build/C/man2/perf_event_open.2:1212
#, no-wrap
msgid ""
" if (pc-E<gt>cap_usr_time && enabled != running) {\n"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1201
+#: build/C/man2/perf_event_open.2:1215
#, no-wrap
msgid ""
" idx = pc-E<gt>index;\n"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1206
+#: build/C/man2/perf_event_open.2:1220
#, no-wrap
msgid ""
" if (pc-E<gt>cap_usr_rdpmc && idx) {\n"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1209
+#: build/C/man2/perf_event_open.2:1223
#, no-wrap
msgid ""
" barrier();\n"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1211
+#: build/C/man2/perf_event_open.2:1225
#, no-wrap
msgid "I<pmc_width>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1218
+#: build/C/man2/perf_event_open.2:1232
msgid ""
"If I<cap_usr_rdpmc>, this field provides the bit-width of the value read "
"using the rdpmc or equivalent instruction. This can be used to sign extend "
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1224
+#: build/C/man2/perf_event_open.2:1238
#, no-wrap
msgid ""
"pmc E<lt>E<lt>= 64 - pmc_width;\n"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1226
+#: build/C/man2/perf_event_open.2:1240
#, no-wrap
msgid "I<time_shift>, I<time_mult>, I<time_offset>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1233
+#: build/C/man2/perf_event_open.2:1247
msgid ""
"If I<cap_usr_time>, these fields can be used to compute the time delta since "
"time_enabled (in nanoseconds) using rdtsc or similar."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1241
+#: build/C/man2/perf_event_open.2:1255
#, no-wrap
msgid ""
" u64 quot, rem;\n"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1253
+#: build/C/man2/perf_event_open.2:1267
msgid ""
"Where I<time_offset>, I<time_mult>, I<time_shift>, and I<cyc> are read in "
"the seqcount loop described above. This delta can then be added to enabled "
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1261
+#: build/C/man2/perf_event_open.2:1275
#, no-wrap
msgid ""
" enabled += delta;\n"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1262
+#: build/C/man2/perf_event_open.2:1276
#, no-wrap
msgid "I<data_head>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1268
+#: build/C/man2/perf_event_open.2:1282
msgid ""
"This points to the head of the data section. The value continuously "
"increases, it does not wrap. The value needs to be manually wrapped by the "
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1271
+#: build/C/man2/perf_event_open.2:1285
msgid ""
"On SMP-capable platforms, after reading the data_head value, user space "
"should issue an rmb()."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1271
+#: build/C/man2/perf_event_open.2:1285
#, no-wrap
msgid "I<data_tail;>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1279
+#: build/C/man2/perf_event_open.2:1293
msgid ""
"When the mapping is B<PROT_WRITE>, the I<data_tail> value should be written "
"by user space to reflect the last read data. In this case the kernel will "
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1281
+#: build/C/man2/perf_event_open.2:1295
msgid "The following 2^n ring-buffer pages have the layout described below."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1295
+#: build/C/man2/perf_event_open.2:1309
msgid ""
"If I<perf_event_attr.sample_id_all> is set, then all event types will have "
"the sample_type selected fields related to where/when (identity) an event "
"took place (TID, TIME, ID, CPU, STREAM_ID) described in "
"B<PERF_RECORD_SAMPLE> below, it will be stashed just after the "
"I<perf_event_header> and the fields already present for the existing fields, "
-"i.e., at the end of the payload. That way a newer perf.data file will be "
+"that is, at the end of the payload. That way a newer perf.data file will be "
"supported by older perf tools, with these new optional fields being ignored."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1297
+#: build/C/man2/perf_event_open.2:1311
msgid "The mmap values start with a header:"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1305
+#: build/C/man2/perf_event_open.2:1319
#, no-wrap
msgid ""
"struct perf_event_header {\n"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1311
-msgid "Below, we describe the I<perf_event_header> fields in more detail."
+#: build/C/man2/perf_event_open.2:1327
+msgid ""
+"Below, we describe the I<perf_event_header> fields in more detail. For ease "
+"of reading, the fields with shorter descriptions are presented first."
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/perf_event_open.2:1330
+msgid "This indicates the size of the record."
+msgstr ""
+
+#. type: TP
+#: build/C/man2/perf_event_open.2:1330
+#, no-wrap
+msgid "I<misc>"
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/perf_event_open.2:1335
+msgid "The I<misc> field contains additional information about the sample."
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/perf_event_open.2:1340
+msgid ""
+"The CPU mode can be determined from this value by masking with "
+"B<PERF_RECORD_MISC_CPUMODE_MASK> and looking for one of the following (note "
+"these are not bit masks, only one can be set at a time):"
+msgstr ""
+
+#. type: TP
+#: build/C/man2/perf_event_open.2:1341
+#, no-wrap
+msgid "B<PERF_RECORD_MISC_CPUMODE_UNKNOWN>"
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/perf_event_open.2:1344
+msgid "Unknown CPU mode."
+msgstr ""
+
+#. type: TP
+#: build/C/man2/perf_event_open.2:1344
+#, no-wrap
+msgid "B<PERF_RECORD_MISC_KERNEL>"
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/perf_event_open.2:1347
+msgid "Sample happened in the kernel."
+msgstr ""
+
+#. type: TP
+#: build/C/man2/perf_event_open.2:1347
+#, no-wrap
+msgid "B<PERF_RECORD_MISC_USER>"
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/perf_event_open.2:1350
+msgid "Sample happened in user code."
+msgstr ""
+
+#. type: TP
+#: build/C/man2/perf_event_open.2:1350
+#, no-wrap
+msgid "B<PERF_RECORD_MISC_HYPERVISOR>"
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/perf_event_open.2:1353
+msgid "Sample happened in the hypervisor."
+msgstr ""
+
+#. type: TP
+#: build/C/man2/perf_event_open.2:1353
+#, no-wrap
+msgid "B<PERF_RECORD_MISC_GUEST_KERNEL>"
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/perf_event_open.2:1356
+msgid "Sample happened in the guest kernel."
+msgstr ""
+
+#. type: TP
+#: build/C/man2/perf_event_open.2:1356
+#, no-wrap
+msgid "B<PERF_RECORD_MISC_GUEST_USER>"
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/perf_event_open.2:1359
+msgid "Sample happened in guest user code."
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/perf_event_open.2:1363
+msgid "In addition, one of the following bits can be set:"
+msgstr ""
+
+#. type: TP
+#: build/C/man2/perf_event_open.2:1363
+#, no-wrap
+msgid "B<PERF_RECORD_MISC_MMAP_DATA>"
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/perf_event_open.2:1367
+msgid ""
+"This is set when the mapping is not executable; otherwise the mapping is "
+"executable."
+msgstr ""
+
+#. type: TP
+#: build/C/man2/perf_event_open.2:1367
+#, no-wrap
+msgid "B<PERF_RECORD_MISC_EXACT_IP>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1320
+#: build/C/man2/perf_event_open.2:1375
+msgid ""
+"This indicates that the content of B<PERF_SAMPLE_IP> points to the actual "
+"instruction that triggered the event. See also "
+"I<perf_event_attr.precise_ip>."
+msgstr ""
+
+#. type: TP
+#: build/C/man2/perf_event_open.2:1375
+#, no-wrap
+msgid "B<PERF_RECORD_MISC_EXT_RESERVED>"
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/perf_event_open.2:1378
+msgid "This indicates there is extended data available (currently not used)."
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/perf_event_open.2:1388
msgid ""
"The I<type> value is one of the below. The values in the corresponding "
"record (that follows the header) depend on the I<type> selected as shown."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1321
+#: build/C/man2/perf_event_open.2:1389
#, no-wrap
msgid "B<PERF_RECORD_MMAP>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1328
+#: build/C/man2/perf_event_open.2:1396
msgid ""
"The MMAP events record the B<PROT_EXEC> mappings so that we can correlate "
"user-space IPs to code. They have the following structure:"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1339
+#: build/C/man2/perf_event_open.2:1407
#, no-wrap
msgid ""
"struct {\n"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1341
+#: build/C/man2/perf_event_open.2:1409
#, no-wrap
msgid "B<PERF_RECORD_LOST>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1344
+#: build/C/man2/perf_event_open.2:1412
msgid "This record indicates when events are lost."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1352
+#: build/C/man2/perf_event_open.2:1420
#, no-wrap
msgid ""
"struct {\n"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1358
+#: build/C/man2/perf_event_open.2:1426
msgid "is the unique event ID for the samples that were lost."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1358
+#: build/C/man2/perf_event_open.2:1426
#, no-wrap
msgid "I<lost>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1361
+#: build/C/man2/perf_event_open.2:1429
msgid "is the number of events that were lost."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1362
+#: build/C/man2/perf_event_open.2:1430
#, no-wrap
msgid "B<PERF_RECORD_COMM>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1365
+#: build/C/man2/perf_event_open.2:1433
msgid "This record indicates a change in the process name."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1373
+#: build/C/man2/perf_event_open.2:1441
#, no-wrap
msgid ""
"struct {\n"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1375
+#: build/C/man2/perf_event_open.2:1443
#, no-wrap
msgid "B<PERF_RECORD_EXIT>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1378
+#: build/C/man2/perf_event_open.2:1446
msgid "This record indicates a process exit event."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1387 build/C/man2/perf_event_open.2:1415
+#: build/C/man2/perf_event_open.2:1455 build/C/man2/perf_event_open.2:1483
#, no-wrap
msgid ""
"struct {\n"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1389
+#: build/C/man2/perf_event_open.2:1457
#, no-wrap
msgid "B<PERF_RECORD_THROTTLE>, B<PERF_RECORD_UNTHROTTLE>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1392
+#: build/C/man2/perf_event_open.2:1460
msgid "This record indicates a throttle/unthrottle event."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1401
+#: build/C/man2/perf_event_open.2:1469
#, no-wrap
msgid ""
"struct {\n"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1403
+#: build/C/man2/perf_event_open.2:1471
#, no-wrap
msgid "B<PERF_RECORD_FORK>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1406
+#: build/C/man2/perf_event_open.2:1474
msgid "This record indicates a fork event."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1417
+#: build/C/man2/perf_event_open.2:1485
#, no-wrap
msgid "B<PERF_RECORD_READ>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1420
+#: build/C/man2/perf_event_open.2:1488
msgid "This record indicates a read event."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1428
+#: build/C/man2/perf_event_open.2:1496
#, no-wrap
msgid ""
"struct {\n"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1430
+#: build/C/man2/perf_event_open.2:1498
#, no-wrap
msgid "B<PERF_RECORD_SAMPLE>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1433
+#: build/C/man2/perf_event_open.2:1501
msgid "This record indicates a sample."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1463
+#: build/C/man2/perf_event_open.2:1531
#, no-wrap
msgid ""
"struct {\n"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1465
+#: build/C/man2/perf_event_open.2:1533
#, no-wrap
msgid "I<ip>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1471
+#: build/C/man2/perf_event_open.2:1539
msgid ""
"If B<PERF_SAMPLE_IP> is enabled, then a 64-bit instruction pointer value is "
"included."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1471
+#: build/C/man2/perf_event_open.2:1539
#, no-wrap
msgid "I<pid>, I<tid>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1477
+#: build/C/man2/perf_event_open.2:1545
msgid ""
"If B<PERF_SAMPLE_TID> is enabled, then a 32-bit process ID and 32-bit thread "
"ID are included."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1477
+#: build/C/man2/perf_event_open.2:1545
#, no-wrap
msgid "I<time>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1485
+#: build/C/man2/perf_event_open.2:1553
msgid ""
"If B<PERF_SAMPLE_TIME> is enabled, then a 64-bit timestamp is included. "
"This is obtained via local_clock() which is a hardware timestamp if "
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1485
+#: build/C/man2/perf_event_open.2:1553
#, no-wrap
msgid "I<addr>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1492
+#: build/C/man2/perf_event_open.2:1560
msgid ""
"If B<PERF_SAMPLE_ADDR> is enabled, then a 64-bit address is included. This "
"is usually the address of a tracepoint, breakpoint, or software event; "
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1500
+#: build/C/man2/perf_event_open.2:1568
msgid ""
"If B<PERF_SAMPLE_ID> is enabled, a 64-bit unique ID is included. If the "
"event is a member of an event group, the group leader ID is returned. This "
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1500
+#: build/C/man2/perf_event_open.2:1568
#, no-wrap
msgid "I<stream_id>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1510
+#: build/C/man2/perf_event_open.2:1578
msgid ""
"If B<PERF_SAMPLE_STREAM_ID> is enabled, a 64-bit unique ID is included. "
"Unlike B<PERF_SAMPLE_ID> the actual ID is returned, not the group leader. "
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1510
+#: build/C/man2/perf_event_open.2:1578
#, no-wrap
msgid "I<cpu>, I<res>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1517
+#: build/C/man2/perf_event_open.2:1585
msgid ""
"If B<PERF_SAMPLE_CPU> is enabled, this is a 32-bit value indicating which "
"CPU was being used, in addition to a reserved (unused) 32-bit value."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1517
+#: build/C/man2/perf_event_open.2:1585
#, no-wrap
msgid "I<period>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1523
+#: build/C/man2/perf_event_open.2:1591
msgid ""
"If B<PERF_SAMPLE_PERIOD> is enabled, a 64-bit value indicating the current "
"sampling period is written."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1523
+#: build/C/man2/perf_event_open.2:1591
#, no-wrap
msgid "I<v>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1534
+#: build/C/man2/perf_event_open.2:1602
msgid ""
"If B<PERF_SAMPLE_READ> is enabled, a structure of type read_format is "
"included which has values for all events in the event group. The values "
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1534
+#: build/C/man2/perf_event_open.2:1602
#, no-wrap
msgid "I<nr>, I<ips[nr]>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1542
+#: build/C/man2/perf_event_open.2:1610
msgid ""
"If B<PERF_SAMPLE_CALLCHAIN> is enabled, then a 64-bit number is included "
"which indicates how many following 64-bit instruction pointers will follow. "
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1542
+#: build/C/man2/perf_event_open.2:1610
#, no-wrap
msgid "I<size>, I<data[size]>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1549
+#: build/C/man2/perf_event_open.2:1617
msgid ""
"If B<PERF_SAMPLE_RAW> is enabled, then a 32-bit value indicating size is "
"included followed by an array of 8-bit values of length size. The values "
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1554
+#: build/C/man2/perf_event_open.2:1622
msgid ""
"This RAW record data is opaque with respect to the ABI. The ABI doesn't "
"make any promises with respect to the stability of its content, it may vary "
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1554
+#: build/C/man2/perf_event_open.2:1622
#, no-wrap
msgid "I<bnr>, I<lbr[bnr]>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1563
+#: build/C/man2/perf_event_open.2:1631
msgid ""
"If B<PERF_SAMPLE_BRANCH_STACK> is enabled, then a 64-bit value indicating "
"the number of records is included, followed by I<bnr> I<perf_branch_entry> "
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1564
+#: build/C/man2/perf_event_open.2:1632
#, no-wrap
msgid "I<from>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1567
-msgid "indicating the source instruction (may not be a branch)"
+#: build/C/man2/perf_event_open.2:1635
+msgid "This indicates the source instruction (may not be a branch)."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1567
+#: build/C/man2/perf_event_open.2:1635
#, no-wrap
msgid "I<to>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1570
-msgid "the branch target"
+#: build/C/man2/perf_event_open.2:1638
+msgid "The branch target."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1570
+#: build/C/man2/perf_event_open.2:1638
#, no-wrap
msgid "I<mispred>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1573
-msgid "the branch target was mispredicted"
+#: build/C/man2/perf_event_open.2:1641
+msgid "The branch target was mispredicted."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1573
+#: build/C/man2/perf_event_open.2:1641
#, no-wrap
msgid "I<predicted>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1576
-msgid "the branch target was predicted."
+#: build/C/man2/perf_event_open.2:1644
+msgid "The branch target was predicted."
+msgstr ""
+
+#. type: TP
+#: build/C/man2/perf_event_open.2:1644
+#, no-wrap
+msgid "I<in_tx> (Since Linux 3.11)"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1579
+#: build/C/man2/perf_event_open.2:1647
+msgid "The branch was in a transactional memory transaction."
+msgstr ""
+
+#. type: TP
+#: build/C/man2/perf_event_open.2:1647
+#, no-wrap
+msgid "I<abort> (Since Linux 3.11)"
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/perf_event_open.2:1650
+msgid "The branch was in an aborted transactional memory transaction."
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/perf_event_open.2:1654
msgid ""
"The entries are from most to least recent, so the first entry has the most "
"recent branch."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1586
+#: build/C/man2/perf_event_open.2:1661
msgid ""
"Support for I<mispred> and I<predicted> is optional; if not supported, both "
"values will be 0."
msgstr ""
+#. type: Plain text
+#: build/C/man2/perf_event_open.2:1665
+msgid ""
+"The type of branches recorded is specified by the I<branch_sample_type> "
+"field."
+msgstr ""
+
#. type: TP
-#: build/C/man2/perf_event_open.2:1587
+#: build/C/man2/perf_event_open.2:1667
#, no-wrap
msgid "I<abi>, I<regs[weight(mask)]>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1592
+#: build/C/man2/perf_event_open.2:1672
msgid ""
"If B<PERF_SAMPLE_REGS_USER> is enabled, then the user CPU registers are "
"recorded."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1598
+#: build/C/man2/perf_event_open.2:1678
msgid ""
"The I<abi> field is one of B<PERF_SAMPLE_REGS_ABI_NONE>, "
"B<PERF_SAMPLE_REGS_ABI_32> or B<PERF_SAMPLE_REGS_ABI_64>."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1608
+#: build/C/man2/perf_event_open.2:1688
msgid ""
"The I<regs> field is an array of the CPU registers that were specified by "
"the I<sample_regs_user> attr field. The number of values is the number of "
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1608
+#: build/C/man2/perf_event_open.2:1688
#, no-wrap
msgid "I<size>, I<data[size]>, I<dyn_size>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1622
+#: build/C/man2/perf_event_open.2:1702
msgid ""
"If B<PERF_SAMPLE_STACK_USER> is enabled, then record the user stack to "
"enable backtracing. I<size> is the size requested by the user in "
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1622
+#: build/C/man2/perf_event_open.2:1702
#, no-wrap
msgid "I<weight>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1630
+#: build/C/man2/perf_event_open.2:1710
msgid ""
"If B<PERF_SAMPLE_WEIGHT> is enabled, then a 64 bit value provided by the "
"hardware is recorded that indicates how costly the event was. This allows "
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1630
+#: build/C/man2/perf_event_open.2:1710
#, no-wrap
msgid "I<data_src>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1636
+#: build/C/man2/perf_event_open.2:1716
msgid ""
"If B<PERF_SAMPLE_DATA_SRC> is enabled, then a 64 bit value is recorded that "
"is made up of the following fields:"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1637
+#: build/C/man2/perf_event_open.2:1717
#, no-wrap
msgid "I<mem_op>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1650
-msgid ""
-"type of opcode, a bitwise combination of B<PERF_MEM_OP_NA> (not available), "
-"B<PERF_MEM_OP_LOAD> (load instruction), B<PERF_MEM_OP_STORE> (store "
-"instruction), B<PERF_MEM_OP_PFETCH> (prefetch), and B<PERF_MEM_OP_EXEC> "
-"(executable code)."
+#: build/C/man2/perf_event_open.2:1720
+msgid "Type of opcode, a bitwise combination of:"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1650
+#: build/C/man2/perf_event_open.2:1723
+#, no-wrap
+msgid "B<PERF_MEM_OP_NA>"
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/perf_event_open.2:1726 build/C/man2/perf_event_open.2:1749 build/C/man2/perf_event_open.2:1799 build/C/man2/perf_event_open.2:1822 build/C/man2/perf_event_open.2:1836
+msgid "Not available"
+msgstr ""
+
+#. type: TP
+#: build/C/man2/perf_event_open.2:1726
+#, no-wrap
+msgid "B<PERF_MEM_OP_LOAD>"
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/perf_event_open.2:1729
+msgid "Load instruction"
+msgstr ""
+
+#. type: TP
+#: build/C/man2/perf_event_open.2:1729
+#, no-wrap
+msgid "B<PERF_MEM_OP_STORE>"
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/perf_event_open.2:1732
+msgid "Store instruction"
+msgstr ""
+
+#. type: TP
+#: build/C/man2/perf_event_open.2:1732
+#, no-wrap
+msgid "B<PERF_MEM_OP_PFETCH>"
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/perf_event_open.2:1735
+msgid "Prefetch"
+msgstr ""
+
+#. type: TP
+#: build/C/man2/perf_event_open.2:1735
+#, no-wrap
+msgid "B<PERF_MEM_OP_EXEC>"
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/perf_event_open.2:1738
+msgid "Executable code"
+msgstr ""
+
+#. type: TP
+#: build/C/man2/perf_event_open.2:1740
#, no-wrap
msgid "I<mem_lvl>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1681
-msgid ""
-"memory hierarchy level hit or miss, a bitwise combination of "
-"B<PERF_MEM_LVL_NA> (not available), B<PERF_MEM_LVL_HIT> (hit), "
-"B<PERF_MEM_LVL_MISS> (miss), B<PERF_MEM_LVL_L1> (level 1 cache), "
-"B<PERF_MEM_LVL_LFB> (line fill buffer), B<PERF_MEM_LVL_L2> (level 2 cache), "
-"B<PERF_MEM_LVL_L3> (level 3 cache), B<PERF_MEM_LVL_LOC_RAM> (local DRAM), "
-"B<PERF_MEM_LVL_REM_RAM1> (remote DRAM 1 hop), B<PERF_MEM_LVL_REM_RAM2> "
-"(remote DRAM 2 hops), B<PERF_MEM_LVL_REM_CCE1> (remote cache 1 hop), "
-"B<PERF_MEM_LVL_REM_CCE2> (remote cache 2 hops), B<PERF_MEM_LVL_IO> (I/O "
-"memory), and B<PERF_MEM_LVL_UNC> (uncached memory)."
+#: build/C/man2/perf_event_open.2:1743
+msgid "Memory hierarchy level hit or miss, a bitwise combination of:"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1681
+#: build/C/man2/perf_event_open.2:1746
#, no-wrap
-msgid "I<mem_snoop>"
+msgid "B<PERF_MEM_LVL_NA>"
+msgstr ""
+
+#. type: TP
+#: build/C/man2/perf_event_open.2:1749
+#, no-wrap
+msgid "B<PERF_MEM_LVL_HIT>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1694
-msgid ""
-"snoop mode, a bitwise combination of B<PERF_MEM_SNOOP_NA> (not available), "
-"B<PERF_MEM_SNOOP_NONE> (no snoop), B<PERF_MEM_SNOOP_HIT> (snoop hit), "
-"B<PERF_MEM_SNOOP_MISS> (snoop miss), and B<PERF_MEM_SNOOP_HITM> (snoop hit "
-"modified)."
+#: build/C/man2/perf_event_open.2:1752 build/C/man2/perf_event_open.2:1839
+msgid "Hit"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1694
+#: build/C/man2/perf_event_open.2:1752
#, no-wrap
-msgid "I<mem_lock>"
+msgid "B<PERF_MEM_LVL_MISS>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1701
-msgid ""
-"lock instruction, a bitwise combination of B<PERF_MEM_LOCK_NA> (not "
-"available) and B<PERF_MEM_LOCK_LOCKED> (locked transaction)."
+#: build/C/man2/perf_event_open.2:1755 build/C/man2/perf_event_open.2:1842
+msgid "Miss"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1701
+#: build/C/man2/perf_event_open.2:1755
#, no-wrap
-msgid "I<mem_dtlb>"
+msgid "B<PERF_MEM_LVL_L1>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1718
-msgid ""
-"tlb access hit or miss, a bitwise combination of B<PERF_MEM_TLB_NA> (not "
-"available), B<PERF_MEM_TLB_HIT> (hit), B<PERF_MEM_TLB_MISS> (miss), "
-"B<PERF_MEM_TLB_L1> (level 1 TLB), B<PERF_MEM_TLB_L2> (level 2 TLB), "
-"B<PERF_MEM_TLB_WK> (hardware walker), and B<PERF_MEM_TLB_OS> (OS fault "
-"handler)."
+#: build/C/man2/perf_event_open.2:1758
+msgid "Level 1 cache"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1721
+#: build/C/man2/perf_event_open.2:1758
#, no-wrap
-msgid "I<misc>"
+msgid "B<PERF_MEM_LVL_LFB>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1726
-msgid "The I<misc> field contains additional information about the sample."
+#: build/C/man2/perf_event_open.2:1761
+msgid "Line fill buffer"
+msgstr ""
+
+#. type: TP
+#: build/C/man2/perf_event_open.2:1761
+#, no-wrap
+msgid "B<PERF_MEM_LVL_L2>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1731
-msgid ""
-"The CPU mode can be determined from this value by masking with "
-"B<PERF_RECORD_MISC_CPUMODE_MASK> and looking for one of the following (note "
-"these are not bit masks, only one can be set at a time):"
+#: build/C/man2/perf_event_open.2:1764
+msgid "Level 2 cache"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1732
+#: build/C/man2/perf_event_open.2:1764
#, no-wrap
-msgid "B<PERF_RECORD_MISC_CPUMODE_UNKNOWN>"
+msgid "B<PERF_MEM_LVL_L3>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1735
-msgid "Unknown CPU mode."
+#: build/C/man2/perf_event_open.2:1767
+msgid "Level 3 cache"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1735
+#: build/C/man2/perf_event_open.2:1767
#, no-wrap
-msgid "B<PERF_RECORD_MISC_KERNEL>"
+msgid "B<PERF_MEM_LVL_LOC_RAM>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1738
-msgid "Sample happened in the kernel."
+#: build/C/man2/perf_event_open.2:1770
+msgid "Local DRAM"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1738
+#: build/C/man2/perf_event_open.2:1770
#, no-wrap
-msgid "B<PERF_RECORD_MISC_USER>"
+msgid "B<PERF_MEM_LVL_REM_RAM1>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1741
-msgid "Sample happened in user code."
+#: build/C/man2/perf_event_open.2:1773
+msgid "Remote DRAM 1 hop"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1741
+#: build/C/man2/perf_event_open.2:1773
#, no-wrap
-msgid "B<PERF_RECORD_MISC_HYPERVISOR>"
+msgid "B<PERF_MEM_LVL_REM_RAM2>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1744
-msgid "Sample happened in the hypervisor."
+#: build/C/man2/perf_event_open.2:1776
+msgid "Remote DRAM 2 hops"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1744
+#: build/C/man2/perf_event_open.2:1776
#, no-wrap
-msgid "B<PERF_RECORD_MISC_GUEST_KERNEL>"
+msgid "B<PERF_MEM_LVL_REM_CCE1>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1747
-msgid "Sample happened in the guest kernel."
+#: build/C/man2/perf_event_open.2:1779
+msgid "Remote cache 1 hop"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1747
+#: build/C/man2/perf_event_open.2:1779
#, no-wrap
-msgid "B<PERF_RECORD_MISC_GUEST_USER>"
+msgid "B<PERF_MEM_LVL_REM_CCE2>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1750
-msgid "Sample happened in guest user code."
+#: build/C/man2/perf_event_open.2:1782
+msgid "Remote cache 2 hops"
+msgstr ""
+
+#. type: TP
+#: build/C/man2/perf_event_open.2:1782
+#, no-wrap
+msgid "B<PERF_MEM_LVL_IO>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1754
-msgid "In addition, one of the following bits can be set:"
+#: build/C/man2/perf_event_open.2:1785
+msgid "I/O memory"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1754
+#: build/C/man2/perf_event_open.2:1785
#, no-wrap
-msgid "B<PERF_RECORD_MISC_MMAP_DATA>"
+msgid "B<PERF_MEM_LVL_UNC>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1758
-msgid ""
-"This is set when the mapping is not executable; otherwise the mapping is "
-"executable."
+#: build/C/man2/perf_event_open.2:1788
+msgid "Uncached memory"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1758
+#: build/C/man2/perf_event_open.2:1790
#, no-wrap
-msgid "B<PERF_RECORD_MISC_EXACT_IP>"
+msgid "I<mem_snoop>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1766
-msgid ""
-"This indicates that the content of B<PERF_SAMPLE_IP> points to the actual "
-"instruction that triggered the event. See also "
-"I<perf_event_attr.precise_ip>."
+#: build/C/man2/perf_event_open.2:1793
+msgid "Snoop mode, a bitwise combination of:"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1766
+#: build/C/man2/perf_event_open.2:1796
#, no-wrap
-msgid "B<PERF_RECORD_MISC_EXT_RESERVED>"
+msgid "B<PERF_MEM_SNOOP_NA>"
+msgstr ""
+
+#. type: TP
+#: build/C/man2/perf_event_open.2:1799
+#, no-wrap
+msgid "B<PERF_MEM_SNOOP_NONE>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1769
-msgid "This indicates there is extended data available (currently not used)."
+#: build/C/man2/perf_event_open.2:1802
+msgid "No snoop"
+msgstr ""
+
+#. type: TP
+#: build/C/man2/perf_event_open.2:1802
+#, no-wrap
+msgid "B<PERF_MEM_SNOOP_HIT>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1773
-msgid "This indicates the size of the record."
+#: build/C/man2/perf_event_open.2:1805
+msgid "Snoop hit"
+msgstr ""
+
+#. type: TP
+#: build/C/man2/perf_event_open.2:1805
+#, no-wrap
+msgid "B<PERF_MEM_SNOOP_MISS>"
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/perf_event_open.2:1808
+msgid "Snoop miss"
+msgstr ""
+
+#. type: TP
+#: build/C/man2/perf_event_open.2:1808
+#, no-wrap
+msgid "B<PERF_MEM_SNOOP_HITM>"
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/perf_event_open.2:1811
+msgid "Snoop hit modified"
+msgstr ""
+
+#. type: TP
+#: build/C/man2/perf_event_open.2:1813
+#, no-wrap
+msgid "I<mem_lock>"
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/perf_event_open.2:1816
+msgid "Lock instruction, a bitwise combination of:"
+msgstr ""
+
+#. type: TP
+#: build/C/man2/perf_event_open.2:1819
+#, no-wrap
+msgid "B<PERF_MEM_LOCK_NA>"
+msgstr ""
+
+#. type: TP
+#: build/C/man2/perf_event_open.2:1822
+#, no-wrap
+msgid "B<PERF_MEM_LOCK_LOCKED>"
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/perf_event_open.2:1825
+msgid "Locked transaction"
+msgstr ""
+
+#. type: TP
+#: build/C/man2/perf_event_open.2:1827
+#, no-wrap
+msgid "I<mem_dtlb>"
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/perf_event_open.2:1830
+msgid "TLB access hit or miss, a bitwise combination of:"
+msgstr ""
+
+#. type: TP
+#: build/C/man2/perf_event_open.2:1833
+#, no-wrap
+msgid "B<PERF_MEM_TLB_NA>"
+msgstr ""
+
+#. type: TP
+#: build/C/man2/perf_event_open.2:1836
+#, no-wrap
+msgid "B<PERF_MEM_TLB_HIT>"
+msgstr ""
+
+#. type: TP
+#: build/C/man2/perf_event_open.2:1839
+#, no-wrap
+msgid "B<PERF_MEM_TLB_MISS>"
+msgstr ""
+
+#. type: TP
+#: build/C/man2/perf_event_open.2:1842
+#, no-wrap
+msgid "B<PERF_MEM_TLB_L1>"
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/perf_event_open.2:1845
+msgid "Level 1 TLB"
+msgstr ""
+
+#. type: TP
+#: build/C/man2/perf_event_open.2:1845
+#, no-wrap
+msgid "B<PERF_MEM_TLB_L2>"
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/perf_event_open.2:1848
+msgid "Level 2 TLB"
+msgstr ""
+
+#. type: TP
+#: build/C/man2/perf_event_open.2:1848
+#, no-wrap
+msgid "B<PERF_MEM_TLB_WK>"
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/perf_event_open.2:1851
+msgid "Hardware walker"
+msgstr ""
+
+#. type: TP
+#: build/C/man2/perf_event_open.2:1851
+#, no-wrap
+msgid "B<PERF_MEM_TLB_OS>"
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/perf_event_open.2:1854
+msgid "OS fault handler"
msgstr ""
#. type: SS
-#: build/C/man2/perf_event_open.2:1774
+#: build/C/man2/perf_event_open.2:1860
#, no-wrap
msgid "Signal overflow"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1783
+#: build/C/man2/perf_event_open.2:1869
msgid ""
"Events can be set to deliver a signal when a threshold is crossed. The "
"signal handler is set up using the B<poll>(2), B<select>(2), B<epoll>(2) "
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1787
+#: build/C/man2/perf_event_open.2:1873
msgid ""
"To generate signals, sampling must be enabled (I<sample_period> must have a "
"non-zero value)."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1789
+#: build/C/man2/perf_event_open.2:1875
msgid "There are two ways to generate signals."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1799
+#: build/C/man2/perf_event_open.2:1885
msgid ""
"The first is to set a I<wakeup_events> or I<wakeup_watermark> value that "
"will generate a signal if a certain number of samples or bytes have been "
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1811
+#: build/C/man2/perf_event_open.2:1897
msgid ""
"The other way is by use of the B<PERF_EVENT_IOC_REFRESH> ioctl. This ioctl "
"adds to a counter that decrements each time the event overflows. When "
#. FIXME(Vince) : Find out when this was introduced
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1817
+#: build/C/man2/perf_event_open.2:1903
msgid ""
"Note: on newer kernels (definitely noticed with 3.2) a signal is provided "
"for every overflow, even if I<wakeup_events> is not set."
msgstr ""
#. type: SS
-#: build/C/man2/perf_event_open.2:1817
+#: build/C/man2/perf_event_open.2:1903
#, no-wrap
msgid "rdpmc instruction"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1824
+#: build/C/man2/perf_event_open.2:1910
msgid ""
"Starting with Linux 3.4 on x86, you can use the I<rdpmc> instruction to get "
"low-latency reads without having to enter the kernel. Note that using "
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1829
+#: build/C/man2/perf_event_open.2:1915
msgid ""
"Support for this can be detected with the I<cap_usr_rdpmc> field in the mmap "
"page; documentation on how to calculate event values can be found in that "
msgstr ""
#. type: SS
-#: build/C/man2/perf_event_open.2:1829
+#: build/C/man2/perf_event_open.2:1915
#, no-wrap
msgid "perf_event ioctl calls"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1834
+#: build/C/man2/perf_event_open.2:1920
msgid "Various ioctls act on B<perf_event_open>() file descriptors"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1834
+#: build/C/man2/perf_event_open.2:1920
#, no-wrap
msgid "B<PERF_EVENT_IOC_ENABLE>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1838
+#: build/C/man2/perf_event_open.2:1924
msgid ""
"Enables the individual event or event group specified by the file descriptor "
"argument."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1844
+#: build/C/man2/perf_event_open.2:1930
msgid ""
"If the B<PERF_IOC_FLAG_GROUP> bit is set in the ioctl argument, then all "
"events in a group are enabled, even if the event specified is not the group "
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1844
+#: build/C/man2/perf_event_open.2:1930
#, no-wrap
msgid "B<PERF_EVENT_IOC_DISABLE>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1848
+#: build/C/man2/perf_event_open.2:1934
msgid ""
"Disables the individual counter or event group specified by the file "
"descriptor argument."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1855
+#: build/C/man2/perf_event_open.2:1941
msgid ""
"Enabling or disabling the leader of a group enables or disables the entire "
"group; that is, while the group leader is disabled, none of the counters in "
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1861
+#: build/C/man2/perf_event_open.2:1947
msgid ""
"If the B<PERF_IOC_FLAG_GROUP> bit is set in the ioctl argument, then all "
"events in a group are disabled, even if the event specified is not the group "
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1861
+#: build/C/man2/perf_event_open.2:1947
#, no-wrap
msgid "B<PERF_EVENT_IOC_REFRESH>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1875
+#: build/C/man2/perf_event_open.2:1961
msgid ""
"Non-inherited overflow counters can use this to enable a counter for a "
"number of overflows specified by the argument, after which it is disabled. "
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1875
+#: build/C/man2/perf_event_open.2:1961
#, no-wrap
msgid "B<PERF_EVENT_IOC_RESET>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1885
+#: build/C/man2/perf_event_open.2:1971
msgid ""
"Reset the event count specified by the file descriptor argument to zero. "
"This resets only the counts; there is no way to reset the multiplexing "
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1891
+#: build/C/man2/perf_event_open.2:1977
msgid ""
"If the B<PERF_IOC_FLAG_GROUP> bit is set in the ioctl argument, then all "
"events in a group are reset, even if the event specified is not the group "
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1891
+#: build/C/man2/perf_event_open.2:1977
#, no-wrap
msgid "B<PERF_EVENT_IOC_PERIOD>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1895
+#: build/C/man2/perf_event_open.2:1981
msgid ""
"IOC_PERIOD is the command to update the period; it does not update the "
"current period but instead defers until next."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1898
+#: build/C/man2/perf_event_open.2:1984
msgid ""
"The argument is a pointer to a 64-bit value containing the desired new "
"period."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1898
+#: build/C/man2/perf_event_open.2:1984
#, no-wrap
msgid "B<PERF_EVENT_IOC_SET_OUTPUT>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1903
+#: build/C/man2/perf_event_open.2:1989
msgid ""
"This tells the kernel to report event notifications to the specified file "
"descriptor rather than the default one. The file descriptors must all be on "
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1906
+#: build/C/man2/perf_event_open.2:1992
msgid ""
"The argument specifies the desired file descriptor, or -1 if output should "
"be ignored."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1906
+#: build/C/man2/perf_event_open.2:1992
#, no-wrap
msgid "B<PERF_EVENT_IOC_SET_FILTER> (Since Linux 2.6.33)"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1909
+#: build/C/man2/perf_event_open.2:1995
msgid "This adds an ftrace filter to this event."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1911
+#: build/C/man2/perf_event_open.2:1997
msgid "The argument is a pointer to the desired ftrace filter."
msgstr ""
#. type: SS
-#: build/C/man2/perf_event_open.2:1911
+#: build/C/man2/perf_event_open.2:1997
#, no-wrap
msgid "Using prctl"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1924
+#: build/C/man2/perf_event_open.2:2010
msgid ""
"A process can enable or disable all the event groups that are attached to it "
"using the B<prctl>(2) B<PR_TASK_PERF_EVENTS_ENABLE> and "
msgstr ""
#. type: SS
-#: build/C/man2/perf_event_open.2:1924
+#: build/C/man2/perf_event_open.2:2010
#, no-wrap
msgid "perf_event related configuration files"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1927
+#: build/C/man2/perf_event_open.2:2013
msgid "Files in I</proc/sys/kernel/>"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1928
+#: build/C/man2/perf_event_open.2:2014
#, no-wrap
msgid "I</proc/sys/kernel/perf_event_paranoid>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1934
+#: build/C/man2/perf_event_open.2:2020
msgid ""
"The I<perf_event_paranoid> file can be set to restrict access to the "
"performance counters."
msgstr ""
+#. type: IP
+#: build/C/man2/perf_event_open.2:2021
+#, no-wrap
+msgid "2"
+msgstr ""
+
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1936
-msgid "2 - only allow user-space measurements"
+#: build/C/man2/perf_event_open.2:2023
+msgid "only allow user-space measurements."
+msgstr ""
+
+#. type: IP
+#: build/C/man2/perf_event_open.2:2023
+#, no-wrap
+msgid "1"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1938
-msgid "1 - (default) allow both kernel and user measurements"
+#: build/C/man2/perf_event_open.2:2025
+msgid "allow both kernel and user measurements (default)."
+msgstr ""
+
+#. type: IP
+#: build/C/man2/perf_event_open.2:2025
+#, no-wrap
+msgid "0"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1940
-msgid "0 - allow access to CPU-specific data but not raw tracepoint samples"
+#: build/C/man2/perf_event_open.2:2027
+msgid "allow access to CPU-specific data but not raw tracepoint samples."
+msgstr ""
+
+#. type: IP
+#: build/C/man2/perf_event_open.2:2027
+#, no-wrap
+msgid "-1"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1942
-msgid "-1 - no restrictions"
+#: build/C/man2/perf_event_open.2:2029
+msgid "no restrictions."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1947
+#: build/C/man2/perf_event_open.2:2035
msgid ""
"The existence of the I<perf_event_paranoid> file is the official method for "
"determining if a kernel supports B<perf_event_open>()."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1947
+#: build/C/man2/perf_event_open.2:2035
#, no-wrap
msgid "I</proc/sys/kernel/perf_event_max_sample_rate>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1956
+#: build/C/man2/perf_event_open.2:2044
msgid ""
"This sets the maximum sample rate. Setting this too high can allow users to "
"sample at a rate that impacts overall machine performance and potentially "
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1956
+#: build/C/man2/perf_event_open.2:2044
#, no-wrap
msgid "I</proc/sys/kernel/perf_event_mlock_kb>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1961
+#: build/C/man2/perf_event_open.2:2049
msgid ""
"Maximum number of pages an unprivileged user can mlock (2) . The default is "
"516 (kB)."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1965
+#: build/C/man2/perf_event_open.2:2053
msgid "Files in I</sys/bus/event_source/devices/>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1971
+#: build/C/man2/perf_event_open.2:2059
msgid ""
"Since Linux 2.6.34 the kernel supports having multiple PMUs available for "
"monitoring. Information on how to program these PMUs can be found under "
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1971
+#: build/C/man2/perf_event_open.2:2059
#, no-wrap
msgid "I</sys/bus/event_source/devices/*/type> (Since Linux 2.6.38)"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1976
+#: build/C/man2/perf_event_open.2:2064
msgid ""
"This contains an integer that can be used in the I<type> field of "
"perf_event_attr to indicate you wish to use this PMU."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1976
+#: build/C/man2/perf_event_open.2:2064
#, no-wrap
msgid "I</sys/bus/event_source/devices/*/rdpmc> (Since Linux 3.4)"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1981
+#: build/C/man2/perf_event_open.2:2069
msgid ""
"If this file is 1, then direct user-space access to the performance counter "
"registers is allowed via the rdpmc instruction. This can be disabled by "
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1981
+#: build/C/man2/perf_event_open.2:2069
#, no-wrap
msgid "I</sys/bus/event_source/devices/*/format/> (Since Linux 3.4)"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1987
+#: build/C/man2/perf_event_open.2:2075
msgid ""
"This sub-directory contains information on the architecture-specific "
"sub-fields available for programming the various I<config> fields in the "
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1997
+#: build/C/man2/perf_event_open.2:2085
msgid ""
"The content of each file is the name of the config field, followed by a "
"colon, followed by a series of integer bit ranges separated by commas. For "
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1997
+#: build/C/man2/perf_event_open.2:2085
#, no-wrap
msgid "I</sys/bus/event_source/devices/*/events/> (Since Linux 3.4)"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2006
+#: build/C/man2/perf_event_open.2:2094
msgid ""
"This sub-directory contains files with pre-defined events. The contents are "
"strings describing the event settings expressed in terms of the fields found "
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2014
+#: build/C/man2/perf_event_open.2:2102
msgid ""
"The content of each file is a list of attribute names separated by commas. "
"Each entry has an optional value (either hex or decimal). If no value is "
"specified than it is assumed to be a single-bit field with a value of 1. An "
-"example entry may look like this: I<event=0x2,inv,ldlat=3>"
+"example entry may look like this: I<event=0x2,inv,ldlat=3>."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2014
+#: build/C/man2/perf_event_open.2:2102
#, no-wrap
msgid "I</sys/bus/event_source/devices/*/uevent>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2018
+#: build/C/man2/perf_event_open.2:2106
msgid ""
"This file is the standard kernel device interface for injecting hotplug "
"events."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2018
+#: build/C/man2/perf_event_open.2:2106
#, no-wrap
msgid "I</sys/bus/event_source/devices/*/cpumask> (Since Linux 3.7)"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2025
+#: build/C/man2/perf_event_open.2:2115
msgid ""
-"The cpumask file contains a comma-separated list of integers that indicate a "
-"representative cpu number for each socket (package) on the motherboard. "
-"This is needed when setting up uncore or northbridge events, as those PMUs "
-"present socket-wide events."
+"The I<cpumask> file contains a comma-separated list of integers that "
+"indicate a representative CPU number for each socket (package) on the "
+"motherboard. This is needed when setting up uncore or northbridge events, "
+"as those PMUs present socket-wide events."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2032
+#: build/C/man2/perf_event_open.2:2122
msgid ""
"B<perf_event_open>() returns the new file descriptor, or -1 if an error "
"occurred (in which case, I<errno> is set appropriately)."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2036
+#: build/C/man2/perf_event_open.2:2126
msgid "Returned if the specified event is not available."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2036
+#: build/C/man2/perf_event_open.2:2126
#, no-wrap
msgid "B<ENOSPC>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2046
+#: build/C/man2/perf_event_open.2:2136
msgid ""
"Prior to Linux 3.3, if there was not enough room for the event, B<ENOSPC> "
"was returned. Linus did not like this, and this was changed to B<EINVAL>. "
msgstr ""
#. type: SH
-#: build/C/man2/perf_event_open.2:2046
+#: build/C/man2/perf_event_open.2:2136
#, no-wrap
msgid "VERSION"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2051
+#: build/C/man2/perf_event_open.2:2141
msgid ""
"B<perf_event_open>() was introduced in Linux 2.6.31 but was called "
"B<perf_counter_open>()B<.> It was renamed in Linux 2.6.32."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2056
+#: build/C/man2/perf_event_open.2:2146
msgid ""
"This B<perf_event_open>() system call Linux- specific and should not be "
"used in programs intended to be portable."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2060
+#: build/C/man2/perf_event_open.2:2150
msgid ""
"Glibc does not provide a wrapper for this system call; call it using "
"B<syscall>(2). See the example below."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2066
+#: build/C/man2/perf_event_open.2:2156
msgid ""
"The official way of knowing if B<perf_event_open>() support is enabled is "
"checking for the existence of the file "
msgstr ""
#. type: SH
-#: build/C/man2/perf_event_open.2:2066 build/C/man2/pivot_root.2:134 build/C/man2/ptrace.2:1884
+#: build/C/man2/perf_event_open.2:2156 build/C/man2/pivot_root.2:134 build/C/man2/ptrace.2:1884
#, no-wrap
msgid "BUGS"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2073
+#: build/C/man2/perf_event_open.2:2163
msgid ""
"The B<F_SETOWN_EX> option to B<fcntl>(2) is needed to properly get overflow "
"signals in threads. This was introduced in Linux 2.6.32."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2081
+#: build/C/man2/perf_event_open.2:2171
msgid ""
"Prior to Linux 2.6.33 (at least for x86) the kernel did not check if events "
"could be scheduled together until read time. The same happens on all known "
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2085
+#: build/C/man2/perf_event_open.2:2175
msgid ""
"Prior to Linux 2.6.34 event constraints were not enforced by the kernel. In "
"that case, some events would silently return \"0\" if the kernel scheduled "
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2088
+#: build/C/man2/perf_event_open.2:2178
msgid ""
"Prior to Linux 2.6.34 there was a bug when multiplexing where the wrong "
"results could be returned."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2091
+#: build/C/man2/perf_event_open.2:2181
msgid ""
"Kernels from Linux 2.6.35 to Linux 2.6.39 can quickly crash the kernel if "
"\"inherit\" is enabled and many threads are started."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2095
+#: build/C/man2/perf_event_open.2:2185
msgid ""
"Prior to Linux 2.6.35, B<PERF_FORMAT_GROUP> did not work with attached "
"processes."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2100
+#: build/C/man2/perf_event_open.2:2190
msgid ""
"In older Linux 2.6 versions, refreshing an event group leader refreshed all "
"siblings, and refreshing with a parameter of 0 enabled infinite refresh. "
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2106
+#: build/C/man2/perf_event_open.2:2196
msgid ""
"There is a bug in the kernel code between Linux 2.6.36 and Linux 3.0 that "
"ignores the \"watermark\" field and acts as if a wakeup_event was chosen if "
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2112
+#: build/C/man2/perf_event_open.2:2202
msgid ""
"From Linux 2.6.31 to Linux 3.4, the B<PERF_IOC_FLAG_GROUP> ioctl argument "
"was broken and would repeatedly operate on the event specified rather than "
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2117
+#: build/C/man2/perf_event_open.2:2207
msgid ""
"Always double-check your results! Various generalized events have had wrong "
"values. For example, retired branches measured the wrong thing on AMD "
msgstr ""
#. type: SH
-#: build/C/man2/perf_event_open.2:2117 build/C/man2/process_vm_readv.2:295 build/C/man2/splice.2:223 build/C/man2/tee.2:130
+#: build/C/man2/perf_event_open.2:2207 build/C/man2/process_vm_readv.2:295 build/C/man2/splice.2:223 build/C/man2/tee.2:130
#, no-wrap
msgid "EXAMPLE"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2121
+#: build/C/man2/perf_event_open.2:2211
msgid ""
"The following is a short example that measures the total instruction count "
"of a call to B<printf>(3)."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2130
+#: build/C/man2/perf_event_open.2:2220
#, no-wrap
msgid ""
"#include E<lt>stdlib.hE<gt>\n"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2136
+#: build/C/man2/perf_event_open.2:2226
#, no-wrap
msgid ""
"long\n"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2141
+#: build/C/man2/perf_event_open.2:2231
#, no-wrap
msgid ""
" ret = syscall(__NR_perf_event_open, hw_event, pid, cpu,\n"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2148
+#: build/C/man2/perf_event_open.2:2238
#, no-wrap
msgid ""
"int\n"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2156
+#: build/C/man2/perf_event_open.2:2246
#, no-wrap
msgid ""
" memset(&pe, 0, sizeof(struct perf_event_attr));\n"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2162
+#: build/C/man2/perf_event_open.2:2252
#, no-wrap
msgid ""
" fd = perf_event_open(&pe, 0, -1, -1, 0);\n"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2165
+#: build/C/man2/perf_event_open.2:2255
#, no-wrap
msgid ""
" ioctl(fd, PERF_EVENT_IOC_RESET, 0);\n"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2167
+#: build/C/man2/perf_event_open.2:2257
#, no-wrap
msgid " printf(\"Measuring instruction count for this printf\\en\");\n"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2170
+#: build/C/man2/perf_event_open.2:2260
#, no-wrap
msgid ""
" ioctl(fd, PERF_EVENT_IOC_DISABLE, 0);\n"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2172
+#: build/C/man2/perf_event_open.2:2262
#, no-wrap
msgid " printf(\"Used %lld instructions\\en\", count);\n"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2175
+#: build/C/man2/perf_event_open.2:2265
#, no-wrap
msgid ""
" close(fd);\n"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2182
+#: build/C/man2/perf_event_open.2:2272
msgid "B<fcntl>(2), B<mmap>(2), B<open>(2), B<prctl>(2), B<read>(2)"
msgstr ""
#. type: Plain text
#: build/C/man2/pivot_root.2:13
-msgid "pivot_root - change the root file system"
+msgid "pivot_root - change the root filesystem"
msgstr ""
#. type: Plain text
#. type: Plain text
#: build/C/man2/pivot_root.2:27
msgid ""
-"B<pivot_root>() moves the root file system of the calling process to the "
-"directory I<put_old> and makes I<new_root> the new root file system of the "
+"B<pivot_root>() moves the root filesystem of the calling process to the "
+"directory I<put_old> and makes I<new_root> the new root filesystem of the "
"calling process."
msgstr ""
#: build/C/man2/pivot_root.2:34
msgid ""
"The typical use of B<pivot_root>() is during system startup, when the "
-"system mounts a temporary root file system (e.g., an B<initrd>), then mounts "
-"the real root file system, and eventually turns the latter into the current "
+"system mounts a temporary root filesystem (e.g., an B<initrd>), then mounts "
+"the real root filesystem, and eventually turns the latter into the current "
"root of all relevant processes or threads."
msgstr ""
"or thread to I<new_root> if they point to the old root directory. This is "
"necessary in order to prevent kernel threads from keeping the old root "
"directory busy with their root and current working directory, even if they "
-"never access the file system in any way. In the future, there may be a "
-"mechanism for kernel threads to explicitly relinquish any access to the file "
-"system, such that this fairly intrusive mechanism can be removed from "
+"never access the filesystem in any way. In the future, there may be a "
+"mechanism for kernel threads to explicitly relinquish any access to the "
+"filesystem, such that this fairly intrusive mechanism can be removed from "
"B<pivot_root>()."
msgstr ""
#. type: Plain text
#: build/C/man2/pivot_root.2:79
msgid ""
-"I<new_root> and I<put_old> must not be on the same file system as the "
-"current root."
+"I<new_root> and I<put_old> must not be on the same filesystem as the current "
+"root."
msgstr ""
#. type: Plain text
#. type: Plain text
#: build/C/man2/pivot_root.2:85
-msgid "No other file system may be mounted on I<put_old>."
+msgid "No other filesystem may be mounted on I<put_old>."
msgstr ""
#. type: Plain text
msgid ""
"If the current root is not a mount point (e.g., after B<chroot>(2) or "
"B<pivot_root>(), see also below), not the old root directory, but the mount "
-"point of that file system is mounted on I<put_old>."
+"point of that filesystem is mounted on I<put_old>."
msgstr ""
#. type: Plain text
#: build/C/man2/pivot_root.2:101
msgid ""
"I<new_root> does not have to be a mount point. In this case, "
-"I</proc/mounts> will show the mount point of the file system containing "
+"I</proc/mounts> will show the mount point of the filesystem containing "
"I<new_root> as root (I</>)."
msgstr ""
#. type: Plain text
#: build/C/man2/pivot_root.2:114
msgid ""
-"I<new_root> or I<put_old> are on the current root file system, or a file "
-"system is already mounted on I<put_old>."
+"I<new_root> or I<put_old> are on the current root filesystem, or a "
+"filesystem is already mounted on I<put_old>."
msgstr ""
#. type: Plain text
#. type: Plain text
#: build/C/man2/ptrace.2:1106
msgid ""
-"If tracee was attached using I<PTRACE_SEIZE>, group-stop is indicated by "
+"If tracee was attached using B<PTRACE_SEIZE>, group-stop is indicated by "
"B<PTRACE_EVENT_STOP>: I<statusE<gt>E<gt>16 == PTRACE_EVENT_STOP>. This "
"allows detection of group-stops without requiring an extra "
"B<PTRACE_GETSIGINFO> call."
msgid ""
"Stop induced by B<PTRACE_INTERRUPT> command, or group-stop, or initial "
"ptrace-stop when a new child is attached (only if attached using "
-"B<PTRACE_SEIZE>). or B<PTRACE_EVENT_STOP> if B<PTRACE_SEIZE> was used."
+"B<PTRACE_SEIZE>), or B<PTRACE_EVENT_STOP> if B<PTRACE_SEIZE> was used."
msgstr ""
#. type: Plain text
#: build/C/man2/quotactl.2:49
msgid ""
"The quota system can be used to set per-user and per-group limits on the "
-"amount of disk space used on a file system. For each user and/or group, a "
-"soft limit and a hard limit can be set for each file system. The hard limit "
+"amount of disk space used on a filesystem. For each user and/or group, a "
+"soft limit and a hard limit can be set for each filesystem. The hard limit "
"can't be exceeded. The soft limit can be exceeded, but warnings will "
"ensue. Moreover, the user can't exceed the soft limit for more than one "
"week (by default) at a time; after this time, the soft limit counts as a "
#: build/C/man2/quotactl.2:79
msgid ""
"The I<special> argument is a pointer to a null-terminated string containing "
-"the pathname of the (mounted) block special device for the file system being "
+"the pathname of the (mounted) block special device for the filesystem being "
"manipulated."
msgstr ""
#. type: Plain text
#: build/C/man2/quotactl.2:98
msgid ""
-"Turn on quotas for a file system. The I<id> argument is the identification "
+"Turn on quotas for a filesystem. The I<id> argument is the identification "
"number of the quota format to be used. Currently, there are three supported "
"quota formats:"
msgstr ""
#: build/C/man2/quotactl.2:121
msgid ""
"The I<addr> argument points to the pathname of a file containing the quotas "
-"for the file system. The quota file must exist; it is normally created with "
+"for the filesystem. The quota file must exist; it is normally created with "
"the B<quotacheck>(8) program. This operation requires privilege "
"(B<CAP_SYS_ADMIN>)."
msgstr ""
#. type: Plain text
#: build/C/man2/quotactl.2:131
msgid ""
-"Turn off quotas for a file system. The I<addr> and I<id> arguments are "
+"Turn off quotas for a filesystem. The I<addr> and I<id> arguments are "
"ignored. This operation requires privilege (B<CAP_SYS_ADMIN>)."
msgstr ""
#. type: Plain text
#: build/C/man2/quotactl.2:308
msgid ""
-"Get quota format used on the specified file system. The I<addr> argument "
+"Get quota format used on the specified filesystem. The I<addr> argument "
"should be a pointer to a 4-byte buffer where the format number will be "
"stored."
msgstr ""
#. type: Plain text
#: build/C/man2/quotactl.2:319
msgid ""
-"Update the on-disk copy of quota usages for a file system. If I<special> is "
-"NULL, then all file systems with active quotas are sync'ed. The I<addr> and "
+"Update the on-disk copy of quota usages for a filesystem. If I<special> is "
+"NULL, then all filesystems with active quotas are sync'ed. The I<addr> and "
"I<id> arguments are ignored."
msgstr ""
#. type: Plain text
#: build/C/man2/quotactl.2:342
msgid ""
-"For XFS file systems making use of the XFS Quota Manager (XQM), the above "
+"For XFS filesystems making use of the XFS Quota Manager (XQM), the above "
"commands are bypassed and the following commands are used:"
msgstr ""
#. type: Plain text
#: build/C/man2/quotactl.2:363
msgid ""
-"Turn on quotas for an XFS file system. XFS provides the ability to turn "
+"Turn on quotas for an XFS filesystem. XFS provides the ability to turn "
"on/off quota limit enforcement with quota accounting. Therefore, XFS "
"expects I<addr> to be a pointer to an I<unsigned int> that contains either "
"the flags B<XFS_QUOTA_UDQ_ACCT> and/or B<XFS_QUOTA_UDQ_ENFD> (for user "
#. type: Plain text
#: build/C/man2/quotactl.2:374
msgid ""
-"Turn off quotas for an XFS file system. As with B<Q_QUOTAON>, XFS file "
-"systems expect a pointer to an I<unsigned int> that specifies whether quota "
-"accounting and/or limit enforcement need to be turned off. This operation "
-"requires privilege (B<CAP_SYS_ADMIN>)."
+"Turn off quotas for an XFS filesystem. As with B<Q_QUOTAON>, XFS "
+"filesystems expect a pointer to an I<unsigned int> that specifies whether "
+"quota accounting and/or limit enforcement need to be turned off. This "
+"operation requires privilege (B<CAP_SYS_ADMIN>)."
msgstr ""
#. type: TP
#. type: Plain text
#: build/C/man2/quotactl.2:408
msgid ""
-"Returns an I<fs_quota_stat> structure containing XFS file system specific "
+"Returns an I<fs_quota_stat> structure containing XFS filesystem specific "
"quota information. This is useful for finding out how much space is used to "
"store quota information, and also to get quotaon/off status of a given local "
-"XFS file system."
+"XFS filesystem."
msgstr ""
#. type: TP
#: build/C/man2/quotactl.2:419
msgid ""
"There is no command equivalent to B<Q_SYNC> for XFS since B<sync>(1) writes "
-"quota information to disk (in addition to the other file system metadata "
-"that it writes out)."
+"quota information to disk (in addition to the other filesystem metadata that "
+"it writes out)."
msgstr ""
#. type: Plain text
#: build/C/man2/quotactl.2:465
msgid ""
"No disk quota is found for the indicated user. Quotas have not been turned "
-"on for this file system."
+"on for this filesystem."
msgstr ""
#. type: Plain text
#: build/C/man2/quotactl.2:495
msgid ""
"The quota file pointed to by I<addr> exists, but is not a regular file; or, "
-"the quota file pointed to by I<addr> exists, but is not on the file system "
+"the quota file pointed to by I<addr> exists, but is not on the filesystem "
"pointed to by I<special>."
msgstr ""
#. type: Plain text
#: build/C/man2/splice.2:155
msgid ""
-"Target file system doesn't support splicing; target file is opened in append "
+"Target filesystem doesn't support splicing; target file is opened in append "
"mode; neither of the descriptors refers to a pipe; or offset given for "
"nonseekable device."
msgstr ""