msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
-"POT-Creation-Date: 2015-01-23 22:24+0900\n"
+"POT-Creation-Date: 2015-02-04 23:30+0900\n"
"PO-Revision-Date: 2015-01-27 02:55+0900\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
#. type: TH
#: build/C/man2/arch_prctl.2:25 build/C/man2/futex.2:53
#: build/C/man2/get_robust_list.2:29 build/C/man2/getunwind.2:27
-#: build/C/man2/kexec_load.2:26 build/C/man2/lookup_dcookie.2:27
+#: build/C/man2/kexec_load.2:27 build/C/man2/lookup_dcookie.2:27
#: build/C/man2/modify_ldt.2:24 build/C/man2/nfsservctl.2:8
#: build/C/man2/outb.2:26 build/C/man2/pciconfig_read.2:8
#: build/C/man2/perf_event_open.2:27 build/C/man2/perfmonctl.2:27
#. type: TH
#: build/C/man2/arch_prctl.2:25 build/C/man2/futex.2:53
-#: build/C/man2/getunwind.2:27 build/C/man2/kexec_load.2:26
+#: build/C/man2/getunwind.2:27 build/C/man2/kexec_load.2:27
#: build/C/man2/lookup_dcookie.2:27 build/C/man2/modify_ldt.2:24
#: build/C/man2/nfsservctl.2:8 build/C/man2/outb.2:26
#: build/C/man2/pciconfig_read.2:8 build/C/man2/perf_event_open.2:27
#. type: SH
#: build/C/man2/arch_prctl.2:26 build/C/man2/futex.2:54
#: build/C/man2/get_robust_list.2:30 build/C/man2/getunwind.2:28
-#: build/C/man2/kexec_load.2:27 build/C/man2/lookup_dcookie.2:28
+#: build/C/man2/kexec_load.2:28 build/C/man2/lookup_dcookie.2:28
#: build/C/man2/modify_ldt.2:25 build/C/man2/nfsservctl.2:9
#: build/C/man2/outb.2:27 build/C/man2/pciconfig_read.2:9
#: build/C/man2/perf_event_open.2:28 build/C/man2/perfmonctl.2:28
#. type: SH
#: build/C/man2/arch_prctl.2:28 build/C/man2/futex.2:56
#: build/C/man2/get_robust_list.2:32 build/C/man2/getunwind.2:30
-#: build/C/man2/kexec_load.2:29 build/C/man2/lookup_dcookie.2:30
+#: build/C/man2/kexec_load.2:30 build/C/man2/lookup_dcookie.2:30
#: build/C/man2/modify_ldt.2:27 build/C/man2/nfsservctl.2:11
#: build/C/man2/outb.2:31 build/C/man2/pciconfig_read.2:11
#: build/C/man2/perf_event_open.2:30 build/C/man2/perfmonctl.2:30
#. type: SH
#: build/C/man2/arch_prctl.2:37 build/C/man2/futex.2:70
#: build/C/man2/get_robust_list.2:45 build/C/man2/getunwind.2:40
-#: build/C/man2/kexec_load.2:39 build/C/man2/lookup_dcookie.2:32
+#: build/C/man2/kexec_load.2:47 build/C/man2/lookup_dcookie.2:32
#: build/C/man2/modify_ldt.2:36 build/C/man2/nfsservctl.2:18
#: build/C/man2/outb.2:62 build/C/man2/pciconfig_read.2:22
#: build/C/man2/perf_event_open.2:42 build/C/man2/perfmonctl.2:39
#. type: SH
#: build/C/man2/arch_prctl.2:82 build/C/man2/futex.2:216
#: build/C/man2/get_robust_list.2:78 build/C/man2/getunwind.2:81
-#: build/C/man2/kexec_load.2:117 build/C/man2/lookup_dcookie.2:43
+#: build/C/man2/kexec_load.2:242 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:2551
+#: build/C/man2/pciconfig_read.2:50 build/C/man2/perf_event_open.2:2607
#: build/C/man2/perfmonctl.2:190 build/C/man2/personality.2:62
#: build/C/man2/pivot_root.2:101 build/C/man2/process_vm_readv.2:225
#: build/C/man2/ptrace.2:1896 build/C/man2/quotactl.2:419
#. type: SH
#: build/C/man2/arch_prctl.2:88 build/C/man2/futex.2:241
#: build/C/man2/get_robust_list.2:85 build/C/man2/getunwind.2:88
-#: build/C/man2/kexec_load.2:124 build/C/man2/lookup_dcookie.2:50
+#: build/C/man2/kexec_load.2:247 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:2557 build/C/man2/personality.2:69
+#: build/C/man2/perf_event_open.2:2613 build/C/man2/personality.2:69
#: build/C/man2/pivot_root.2:105 build/C/man2/process_vm_readv.2:245
#: build/C/man2/ptrace.2:1911 build/C/man2/quotactl.2:427
#: build/C/man2/sendfile.2:115 build/C/man2/set_tid_address.2:91
#. type: TP
#: build/C/man2/arch_prctl.2:89 build/C/man2/futex.2:256
#: build/C/man2/get_robust_list.2:112 build/C/man2/lookup_dcookie.2:51
-#: build/C/man2/modify_ldt.2:109 build/C/man2/perf_event_open.2:2603
+#: build/C/man2/modify_ldt.2:109 build/C/man2/perf_event_open.2:2659
#: build/C/man2/process_vm_readv.2:267 build/C/man2/process_vm_readv.2:272
#: build/C/man2/ptrace.2:1915 build/C/man2/quotactl.2:428
#: build/C/man2/sendfile.2:125 build/C/man2/vm86.2:60
#. type: TP
#: build/C/man2/arch_prctl.2:93 build/C/man2/futex.2:268
-#: build/C/man2/get_robust_list.2:89 build/C/man2/kexec_load.2:129
-#: 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:2608
-#: build/C/man2/personality.2:70 build/C/man2/pivot_root.2:114
-#: build/C/man2/process_vm_readv.2:246 build/C/man2/process_vm_readv.2:257
-#: build/C/man2/process_vm_readv.2:261 build/C/man2/ptrace.2:1926
-#: build/C/man2/quotactl.2:434 build/C/man2/quotactl.2:501
-#: build/C/man2/sendfile.2:128 build/C/man2/splice.2:161
-#: build/C/man2/tee.2:107 build/C/man2/vmsplice.2:137
+#: build/C/man2/get_robust_list.2:89 build/C/man2/kexec_load.2:279
+#: build/C/man2/kexec_load.2:283 build/C/man2/kexec_load.2:292
+#: build/C/man2/kexec_load.2:298 build/C/man2/kexec_load.2:301
+#: build/C/man2/kexec_load.2:306 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:2664 build/C/man2/personality.2:70
+#: build/C/man2/pivot_root.2:114 build/C/man2/process_vm_readv.2:246
+#: build/C/man2/process_vm_readv.2:257 build/C/man2/process_vm_readv.2:261
+#: build/C/man2/ptrace.2:1926 build/C/man2/quotactl.2:434
+#: build/C/man2/quotactl.2:501 build/C/man2/sendfile.2:128
+#: build/C/man2/splice.2:161 build/C/man2/tee.2:107
+#: build/C/man2/vmsplice.2:137
#, no-wrap
msgid "B<EINVAL>"
msgstr "B<EINVAL>"
#. type: TP
#: build/C/man2/arch_prctl.2:97 build/C/man2/get_robust_list.2:99
-#: build/C/man2/kexec_load.2:136 build/C/man2/lookup_dcookie.2:65
-#: build/C/man2/pciconfig_read.2:105 build/C/man2/perf_event_open.2:2675
+#: build/C/man2/kexec_load.2:323 build/C/man2/lookup_dcookie.2:65
+#: build/C/man2/pciconfig_read.2:105 build/C/man2/perf_event_open.2:2732
#: build/C/man2/pivot_root.2:120 build/C/man2/process_vm_readv.2:283
#: build/C/man2/ptrace.2:1936 build/C/man2/quotactl.2:456
#: build/C/man2/vm86.2:68
#. type: SH
#: build/C/man2/arch_prctl.2:103 build/C/man2/futex.2:303
-#: build/C/man2/getunwind.2:96 build/C/man2/kexec_load.2:145
+#: build/C/man2/getunwind.2:96 build/C/man2/kexec_load.2:335
#: 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:2696
+#: build/C/man2/pciconfig_read.2:112 build/C/man2/perf_event_open.2:2756
#: build/C/man2/perfmonctl.2:199 build/C/man2/personality.2:73
#: build/C/man2/pivot_root.2:128 build/C/man2/process_vm_readv.2:295
#: build/C/man2/ptrace.2:1954 build/C/man2/sendfile.2:148
#. type: SH
#: build/C/man2/arch_prctl.2:107 build/C/man2/futex.2:305
#: build/C/man2/get_robust_list.2:118 build/C/man2/getunwind.2:99
-#: build/C/man2/kexec_load.2:147 build/C/man2/lookup_dcookie.2:81
-#: build/C/man2/modify_ldt.2:133 build/C/man2/perf_event_open.2:2701
+#: build/C/man2/kexec_load.2:337 build/C/man2/lookup_dcookie.2:81
+#: build/C/man2/modify_ldt.2:133 build/C/man2/perf_event_open.2:2761
#: build/C/man2/perfmonctl.2:202 build/C/man2/pivot_root.2:131
#: build/C/man2/process_vm_readv.2:297 build/C/man2/ptrace.2:1956
#: build/C/man2/sendfile.2:155 build/C/man2/splice.2:186
#. type: SH
#: build/C/man2/arch_prctl.2:138 build/C/man2/futex.2:319
#: build/C/man2/get_robust_list.2:127 build/C/man2/getunwind.2:111
-#: build/C/man2/kexec_load.2:162 build/C/man2/modify_ldt.2:136
+#: build/C/man2/kexec_load.2:341 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:2832 build/C/man2/perfmonctl.2:205
-#: build/C/man2/pivot_root.2:143 build/C/man2/process_vm_readv.2:347
-#: build/C/man2/ptrace.2:2122 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:240 build/C/man2/tee.2:214
-#: build/C/man2/vmsplice.2:164
+#: build/C/man2/perf_event_open.2:2903 build/C/man2/perfmonctl.2:205
+#: build/C/man2/personality.2:77 build/C/man2/pivot_root.2:143
+#: build/C/man2/process_vm_readv.2:347 build/C/man2/ptrace.2:2122
+#: 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:240
+#: build/C/man2/tee.2:214 build/C/man2/vmsplice.2:164
#, no-wrap
msgid "SEE ALSO"
msgstr "関連項目"
#. type: SH
#: build/C/man2/arch_prctl.2:145 build/C/man2/futex.2:333
#: build/C/man2/get_robust_list.2:136 build/C/man2/getunwind.2:113
-#: build/C/man2/kexec_load.2:165 build/C/man2/lookup_dcookie.2:88
+#: build/C/man2/kexec_load.2:350 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:2838 build/C/man2/perfmonctl.2:209
-#: build/C/man2/personality.2:77 build/C/man2/pivot_root.2:149
+#: build/C/man2/perf_event_open.2:2909 build/C/man2/perfmonctl.2:209
+#: build/C/man2/personality.2:79 build/C/man2/pivot_root.2:149
#: build/C/man2/process_vm_readv.2:350 build/C/man2/ptrace.2:2137
#: build/C/man2/quotactl.2:512 build/C/man2/sendfile.2:203
#: build/C/man2/set_tid_address.2:103 build/C/man2/splice.2:244
#. type: Plain text
#: build/C/man2/arch_prctl.2:153 build/C/man2/futex.2:341
#: build/C/man2/get_robust_list.2:144 build/C/man2/getunwind.2:121
-#: build/C/man2/kexec_load.2:173 build/C/man2/lookup_dcookie.2:96
+#: build/C/man2/kexec_load.2:358 build/C/man2/lookup_dcookie.2:96
#: build/C/man2/modify_ldt.2:146 build/C/man2/nfsservctl.2:68
#: build/C/man2/outb.2:107 build/C/man2/pciconfig_read.2:124
-#: build/C/man2/perf_event_open.2:2846 build/C/man2/perfmonctl.2:217
-#: build/C/man2/personality.2:85 build/C/man2/pivot_root.2:157
+#: build/C/man2/perf_event_open.2:2917 build/C/man2/perfmonctl.2:217
+#: build/C/man2/personality.2:87 build/C/man2/pivot_root.2:157
#: build/C/man2/process_vm_readv.2:358 build/C/man2/ptrace.2:2145
#: build/C/man2/quotactl.2:520 build/C/man2/sendfile.2:211
#: build/C/man2/set_tid_address.2:111 build/C/man2/splice.2:252
#: build/C/man2/tee.2:225 build/C/man2/vm86.2:84 build/C/man2/vmsplice.2:175
-msgid ""
-"This page is part of release 3.78 of the Linux I<man-pages> project. A "
+#, fuzzy
+#| msgid ""
+#| "This page is part of release 3.78 of the Linux I<man-pages> project. A "
+#| "description of the project, information about reporting bugs, and the "
+#| "latest version of this page, can be found at \\%http://www.kernel.org/doc/"
+#| "man-pages/."
+msgid ""
+"This page is part of release 3.79 of the Linux I<man-pages> project. A "
"description of the project, information about reporting bugs, and the latest "
"version of this page, can be found at \\%http://www.kernel.org/doc/man-"
"pages/."
#. type: Plain text
#: build/C/man2/futex.2:70 build/C/man2/getunwind.2:40
-#: build/C/man2/kexec_load.2:39 build/C/man2/modify_ldt.2:36
-#: build/C/man2/perf_event_open.2:42 build/C/man2/perfmonctl.2:39
-#: build/C/man2/pivot_root.2:18
+#: build/C/man2/modify_ldt.2:36 build/C/man2/perf_event_open.2:42
+#: build/C/man2/perfmonctl.2:39 build/C/man2/pivot_root.2:18
msgid "I<Note>: There is no glibc wrapper for this system call; see NOTES."
msgstr ""
"I<注>: このシステムコールには glibc のラッパー関数は存在しない。「注意」の節"
msgstr "B<FUTEX_CMP_REQUEUE>"
#. type: TP
-#: build/C/man2/futex.2:242 build/C/man2/perf_event_open.2:2579
+#: build/C/man2/futex.2:242 build/C/man2/perf_event_open.2:2635
#: build/C/man2/quotactl.2:486
#, no-wrap
msgid "B<EACCES>"
#. type: TP
#: build/C/man2/futex.2:274 build/C/man2/modify_ldt.2:126
-#: build/C/man2/pciconfig_read.2:93 build/C/man2/perf_event_open.2:2661
+#: build/C/man2/pciconfig_read.2:93 build/C/man2/perf_event_open.2:2718
#: build/C/man2/quotactl.2:447 build/C/man2/vm86.2:64
#, no-wrap
msgid "B<ENOSYS>"
#. type: SH
#: build/C/man2/futex.2:293 build/C/man2/get_robust_list.2:116
-#: build/C/man2/getunwind.2:94 build/C/man2/kexec_load.2:141
+#: build/C/man2/getunwind.2:94 build/C/man2/kexec_load.2:328
#: 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:292
#: build/C/man2/sendfile.2:142 build/C/man2/set_tid_address.2:94
"チャー上の特別のものである。"
#. type: Plain text
-#: build/C/man2/futex.2:305 build/C/man2/kexec_load.2:147
-#: build/C/man2/set_tid_address.2:99 build/C/man2/splice.2:186
-#: build/C/man2/tee.2:127 build/C/man2/vmsplice.2:155
+#: build/C/man2/futex.2:305 build/C/man2/set_tid_address.2:99
+#: build/C/man2/splice.2:186 build/C/man2/tee.2:127
+#: build/C/man2/vmsplice.2:155
msgid "This system call is Linux-specific."
msgstr "このシステムコールは Linux 固有である。"
msgstr ""
#. type: Plain text
-#: build/C/man2/get_robust_list.2:45
+#: build/C/man2/get_robust_list.2:45 build/C/man2/kexec_load.2:47
msgid "I<Note>: There are no glibc wrappers for these system calls; see NOTES."
msgstr ""
"I<注意>: これらのシステムコールには glibc ラッパー関数は存在しない。 「注意」"
msgstr ""
#. type: TP
-#: build/C/man2/get_robust_list.2:107 build/C/man2/perf_event_open.2:2688
+#: build/C/man2/get_robust_list.2:107 build/C/man2/perf_event_open.2:2746
#: build/C/man2/process_vm_readv.2:287 build/C/man2/ptrace.2:1949
#: build/C/man2/quotactl.2:461 build/C/man2/quotactl.2:504
#, no-wrap
msgstr "B<getauxval>(3)"
#. type: TH
-#: build/C/man2/kexec_load.2:26
+#: build/C/man2/kexec_load.2:27
#, no-wrap
msgid "KEXEC_LOAD"
msgstr "KEXEC_LOAD"
#. type: TH
-#: build/C/man2/kexec_load.2:26 build/C/man2/process_vm_readv.2:29
-#, no-wrap
-msgid "2014-08-19"
-msgstr "2014-08-19"
+#: build/C/man2/kexec_load.2:27 build/C/man2/personality.2:32
+#, fuzzy, no-wrap
+#| msgid "2015-01-10"
+msgid "2015-02-01"
+msgstr "2015-01-10"
#. type: Plain text
-#: build/C/man2/kexec_load.2:29
-msgid "kexec_load - load a new kernel for later execution"
+#: build/C/man2/kexec_load.2:30
+#, fuzzy
+#| msgid "kexec_load - load a new kernel for later execution"
+msgid "kexec_load, kexec_file_load - load a new kernel for later execution"
msgstr "kexec_load - 新しいカーネルを後で実行するためにロードする"
#. type: Plain text
-#: build/C/man2/kexec_load.2:31
-msgid "B<#include E<lt>linux/kexec.hE<gt>>"
+#: build/C/man2/kexec_load.2:33
+#, fuzzy, no-wrap
+#| msgid "B<#include E<lt>linux/kexec.hE<gt>>"
+msgid "B<#include E<lt>linux/kexec.hE<gt>>\n"
msgstr "B<#include E<lt>linux/kexec.hE<gt>>"
#. type: Plain text
-#: build/C/man2/kexec_load.2:33
+#: build/C/man2/kexec_load.2:37
+#, fuzzy, no-wrap
+#| msgid "B<long kexec_load(unsigned long >I<entry>B<, unsigned long >I<nr_segments>B<,>"
msgid ""
-"B<long kexec_load(unsigned long >I<entry>B<, unsigned long >I<nr_segments>B<,"
-">"
-msgstr ""
-"B<long kexec_load(unsigned long >I<entry>B<, unsigned long >I<nr_segments>B<,"
-">"
+"B<long kexec_load(unsigned long >I<entry>B<, unsigned long >I<nr_segments>B<,>\n"
+"B< struct kexec_segment *>I<segments>B<, unsigned long >I<flags>B<);>\n"
+msgstr "B<long kexec_load(unsigned long >I<entry>B<, unsigned long >I<nr_segments>B<,>"
#. type: Plain text
-#: build/C/man2/kexec_load.2:36
-msgid "B< struct kexec_segment *>I<segments>B<, unsigned long >I<flags>B<);>"
-msgstr "B< struct kexec_segment *>I<segments>B<, unsigned long >I<flags>B<);>"
+#: build/C/man2/kexec_load.2:39
+#, fuzzy, no-wrap
+#| msgid "B<long kexec_load(unsigned long >I<entry>B<, unsigned long >I<nr_segments>B<,>"
+msgid "B<long kexec_file_load(int >I<kernel_fd>B<, int >I<initrd_fd>B<,>\n"
+msgstr "B<long kexec_load(unsigned long >I<entry>B<, unsigned long >I<nr_segments>B<,>"
#. type: Plain text
-#: build/C/man2/kexec_load.2:44
+#: build/C/man2/kexec_load.2:43
+#, fuzzy, no-wrap
+#| msgid ""
+#| "B<int perf_event_open(struct perf_event_attr *>I<attr>B<,>\n"
+#| "B< pid_t >I<pid>B<, int >I<cpu>B<, int >I<group_fd>B<,>\n"
+#| "B< unsigned long >I<flags>B<);>\n"
+msgid ""
+"B< unsigned long >I<cmdline_len>B<, const char *>I<cmdline>B<,>\n"
+"B< unsigned long >I<flags>B<);>\n"
+msgstr ""
+"B<int perf_event_open(struct perf_event_attr *>I<attr>B<,>\n"
+"B< pid_t >I<pid>B<, int >I<cpu>B<, int >I<group_fd>B<,>\n"
+"B< unsigned long >I<flags>B<);>\n"
+
+#. type: Plain text
+#: build/C/man2/kexec_load.2:52
msgid ""
"The B<kexec_load>() system call loads a new kernel that can be executed "
"later by B<reboot>(2)."
"その後の B<reboot>(2) で実行できるようにする。"
#. type: Plain text
-#: build/C/man2/kexec_load.2:50
+#: build/C/man2/kexec_load.2:58
msgid ""
"The I<flags> argument is a bit mask that controls the operation of the "
"call. The following values can be specified in I<flags>:"
"る。 I<flags> には以下の値を指定できる。"
#. type: TP
-#: build/C/man2/kexec_load.2:50
+#: build/C/man2/kexec_load.2:58
#, no-wrap
msgid "B<KEXEC_ON_CRASH> (since Linux 2.6.13)"
msgstr "B<KEXEC_ON_CRASH> (Linux 2.6.13 以降)"
-#. FIXME Explain in more detail how KEXEC_ON_CRASH is actually used
#. type: Plain text
-#: build/C/man2/kexec_load.2:54
-msgid "Execute the new kernel automatically on a system crash."
-msgstr "システムのクラッシュ時に、新しいカーネルを自動的に実行する。"
+#: build/C/man2/kexec_load.2:74
+msgid ""
+"Execute the new kernel automatically on a system crash. This \"crash kernel"
+"\" is loaded into an area of reserved memory that is determined at boot time "
+"using the I<craskkernel> kernel command-line parameter. The location of "
+"this reserved memory is exported to user space via the I</proc/iomem> file, "
+"in an entry labeled \"Crash kernel\". A user-space application can parse "
+"this file and prepare a list of segments (see below) that specify this "
+"reserved memory as destination. If this flag is specified, the kernel "
+"checks that the target segments specified in I<segments> fall within the "
+"reserved region."
+msgstr ""
#. type: TP
-#: build/C/man2/kexec_load.2:54
+#: build/C/man2/kexec_load.2:74
#, no-wrap
msgid "B<KEXEC_PRESERVE_CONTEXT> (since Linux 2.6.27)"
msgstr "B<KEXEC_PRESERVE_CONTEXT> (Linux 2.6.27 以降)"
#. type: Plain text
-#: build/C/man2/kexec_load.2:64
+#: build/C/man2/kexec_load.2:84
msgid ""
"Preserve the system hardware and software states before executing the new "
"kernel. This could be used for system suspend. This flag is available only "
"利用可能であり、 I<nr_segments> が 0 より大きい場合のみ効果がある。"
#. type: Plain text
-#: build/C/man2/kexec_load.2:85
+#: build/C/man2/kexec_load.2:105
msgid ""
"The high-order bits (corresponding to the mask 0xffff0000) of I<flags> "
"contain the architecture of the to-be-executed kernel. Specify (OR) the "
"システムの CPU で実行可能なものでなければならない。"
#. type: Plain text
-#: build/C/man2/kexec_load.2:100
+#: build/C/man2/kexec_load.2:120
msgid ""
"The I<entry> argument is the physical entry address in the kernel image. "
"The I<nr_segments> argument is the number of segments pointed to by the "
"ルの配置が定義される。"
#. type: Plain text
-#: build/C/man2/kexec_load.2:109
+#: build/C/man2/kexec_load.2:129
#, no-wrap
msgid ""
"struct kexec_segment {\n"
" size_t memsz; /* Physical address length */\n"
"};\n"
-#. FIXME Explain the details of how the kernel image defined by segments
-#. is copied from the calling process into previously reserved memory.
#. type: Plain text
-#: build/C/man2/kexec_load.2:117
+#: build/C/man2/kexec_load.2:146
msgid ""
"The kernel image defined by I<segments> is copied from the calling process "
-"into previously reserved memory."
+"into the kernel either in regular memory or in reserved memory (if "
+"B<KEXEC_ON_CRASH> is set). The kernel first performs various sanity checks "
+"on the information passed in I<segments>. If these checks pass, the kernel "
+"copies the segment data to kernel memory. Each segment specified in "
+"I<segments> is copied as follows:"
+msgstr ""
+
+#. type: IP
+#: build/C/man2/kexec_load.2:146 build/C/man2/kexec_load.2:157
+#: build/C/man2/kexec_load.2:164 build/C/man2/perf_event_open.2:1238
+#: build/C/man2/perf_event_open.2:1256 build/C/man2/ptrace.2:1735
+#: build/C/man2/ptrace.2:1745 build/C/man2/ptrace.2:1753
+#: build/C/man2/ptrace.2:1759 build/C/man2/ptrace.2:1888
+#: build/C/man2/splice.2:55 build/C/man2/splice.2:61 build/C/man2/splice.2:70
+#, no-wrap
+msgid "*"
+msgstr "*"
+
+#. type: Plain text
+#: build/C/man2/kexec_load.2:157
+msgid ""
+"I<buf> and I<bufsz> identify a memory region in the caller's virtual address "
+"space that is the source of the copy. The value in I<bufsz> may not exceed "
+"the value in the I<memsz> field."
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/kexec_load.2:164
+msgid ""
+"I<mem> and I<memsz> specify a physical address range that is the target of "
+"the copy. The values specified in both fields must be multiples of the "
+"system page size."
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/kexec_load.2:172
+msgid ""
+"I<bufsz> bytes are copied from the source buffer to the target kernel "
+"buffer. If I<bufsz> is less than I<memsz>, then the excess bytes in the "
+"kernel buffer are zeroed out."
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/kexec_load.2:181
+msgid ""
+"In case of a normal kexec (i.e., the B<KEXEC_ON_CRASH> flag is not set), the "
+"segment data is loaded in any available memory and is moved to the final "
+"destination at kexec reboot time (e.g., when the B<kexec>(8) command is "
+"executed with the I<-e> option)."
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/kexec_load.2:187
+msgid ""
+"In case of kexec on panic (i.e., the B<KEXEC_ON_CRASH> flag is set), the "
+"segment data is loaded to reserved memory at the time of the call, and, "
+"after a crash, the kexec mechanism simply passes control to that kernel."
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/kexec_load.2:192
+#, fuzzy
+#| msgid ""
+#| "This system call is available only if the kernel was configured with "
+#| "B<CONFIG_KEXEC>."
+msgid ""
+"The B<kexec_load>() system call is available only if the kernel was "
+"configured with B<CONFIG_KEXEC>."
+msgstr ""
+"このシステムコールは、カーネルの設定で B<CONFIG_KEXEC> が有効になって\n"
+"いる場合にのみ利用できる。"
+
+#. type: SS
+#: build/C/man2/kexec_load.2:192
+#, no-wrap
+msgid "kexec_file_load()"
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/kexec_load.2:211
+msgid ""
+"The B<kexec_file_load>() system call is similar to B<kexec_load>(), but it "
+"takes a different set of arguments. It reads the kernel to be loaded from "
+"the file referred to by the descriptor I<kernel_fd>, and the initrd (initial "
+"RAM disk) to be loaded from file referred to by the descriptor "
+"I<initrd_fd>. The I<cmdline> argument is a pointer to a buffer containing "
+"the command line for the new kernel. The I<cmdline_len> argument specifies "
+"size of the buffer. The last byte in the buffer must be a null byte (\\(aq"
+"\\e0\\(aq)."
msgstr ""
-"I<segments> で定義されたカーネルイメージは、\n"
-"呼び出したプロセスから予約済みメモリーにコピーされる。"
#. type: Plain text
-#: build/C/man2/kexec_load.2:124
+#: build/C/man2/kexec_load.2:217
+#, fuzzy
+#| msgid ""
+#| "The I<flags> argument is a bit mask that controls the operation of the "
+#| "call. The following values can be specified in I<flags>:"
msgid ""
-"On success, B<kexec_load>() returns 0. On error, -1 is returned and "
+"The I<flags> argument is a bit mask which modifies the behavior of the "
+"call. The following values can be specified in I<flags>:"
+msgstr ""
+"I<flags> 引き数は、システムコールの呼び出しの動作を制御するマスクビットであ"
+"る。 I<flags> には以下の値を指定できる。"
+
+#. type: TP
+#: build/C/man2/kexec_load.2:217
+#, fuzzy, no-wrap
+#| msgid "KEXEC_LOAD"
+msgid "B<KEXEC_FILE_UNLOAD>"
+msgstr "KEXEC_LOAD"
+
+#. type: Plain text
+#: build/C/man2/kexec_load.2:220
+msgid "Unload the currently loaded kernel."
+msgstr ""
+
+#. type: TP
+#: build/C/man2/kexec_load.2:220
+#, no-wrap
+msgid "B<KEXEC_FILE_ON_CRASH>"
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/kexec_load.2:226
+msgid ""
+"Load the new kernel in the memory region reserved for the crash kernel (as "
+"for B<KEXEC_ON_CRASH).> This kernel is booted if the currently running "
+"kernel crashes."
+msgstr ""
+
+#. type: TP
+#: build/C/man2/kexec_load.2:226
+#, no-wrap
+msgid "B<KEXEC_FILE_NO_INITRAMFS>"
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/kexec_load.2:233
+msgid ""
+"Loading initrd/initramfs is optional. Specify this flag if no initramfs is "
+"being loaded. If this flag is set, the value passed in I<initrd_fd> is "
+"ignored."
+msgstr ""
+
+#. See also http://lwn.net/Articles/603116/
+#. type: Plain text
+#: build/C/man2/kexec_load.2:242
+msgid ""
+"The B<kexec_file_load>() system call was added to provide support for "
+"systems where \"kexec\" loading should be restricted to only kernels that "
+"are signed. This system call is available only if the kernel was configured "
+"with B<CONFIG_KEXEC_FILE>."
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/kexec_load.2:247
+#, fuzzy
+#| msgid ""
+#| "On success, B<kexec_load>() returns 0. On error, -1 is returned and "
+#| "I<errno> is set to indicate the error."
+msgid ""
+"On success, these system calls returns 0. On error, -1 is returned and "
"I<errno> is set to indicate the error."
msgstr ""
"成功すると、 B<kexec_load> は 0 を返す。\n"
"エラーの場合、 -1 が返り、 I<errno> にエラーを示す値が設定される。"
#. type: TP
-#: build/C/man2/kexec_load.2:125 build/C/man2/pivot_root.2:110
+#: build/C/man2/kexec_load.2:248 build/C/man2/kexec_load.2:260
+#, no-wrap
+msgid "B<EADDRNOTAVAIL>"
+msgstr ""
+
+#. See kernel/kexec.::sanity_check_segment_list in the 3.19 kernel source
+#. type: Plain text
+#: build/C/man2/kexec_load.2:260
+msgid ""
+"The B<KEXEC_ON_CRASH> flags was specified, but the region specified by the "
+"I<mem> and I<memsz> fields of one of the I<segments> entries lies outside "
+"the range of memory reserved for the crash kernel."
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/kexec_load.2:269
+msgid ""
+"The value in a I<mem> or I<memsz> field in one of the I<segments> entries is "
+"not a multiple of the system page size."
+msgstr ""
+
+#. type: TP
+#: build/C/man2/kexec_load.2:269 build/C/man2/perf_event_open.2:2649
+#: build/C/man2/sendfile.2:121 build/C/man2/splice.2:157
+#: build/C/man2/vmsplice.2:133
+#, no-wrap
+msgid "B<EBADF>"
+msgstr "B<EBADF>"
+
+#. type: Plain text
+#: build/C/man2/kexec_load.2:275
+#, fuzzy
+#| msgid "I<new_root> or I<put_old> is not a directory."
+msgid "I<kernel_fd> or I<initrd_fd> is not a valid file descriptor."
+msgstr "I<new_root> または I<put_old> がディレクトリでない。"
+
+#. type: TP
+#: build/C/man2/kexec_load.2:275 build/C/man2/pivot_root.2:110
#: build/C/man2/ptrace.2:1912 build/C/man2/quotactl.2:495
#, no-wrap
msgid "B<EBUSY>"
msgstr "B<EBUSY>"
#. type: Plain text
-#: build/C/man2/kexec_load.2:129
+#: build/C/man2/kexec_load.2:279
msgid ""
"Another crash kernel is already being loaded or a crash kernel is already in "
"use."
"別のクラッシュカーネルがすでにロードされているか、\n"
"クラッシュカーネルがすでに使用されている。"
-#. KEXEC_SEGMENT_MAX == 16
#. type: Plain text
-#: build/C/man2/kexec_load.2:136
-msgid "I<flags> is invalid; or I<nr_segments> is too large"
-msgstr "I<flags> が無効である。 I<nr_segments> が大きすぎる。"
+#: build/C/man2/kexec_load.2:283
+#, fuzzy
+#| msgid "I<flags> is not 0."
+msgid "I<flags> is invalid."
+msgstr "I<flags> が 0 でない。"
#. type: Plain text
-#: build/C/man2/kexec_load.2:141
-msgid "The caller does not have the B<CAP_SYS_BOOT> capability."
-msgstr "呼び出し側が B<CAP_SYS_BOOT> ケーパビリティを持っていない。"
+#: build/C/man2/kexec_load.2:292
+msgid ""
+"The value of a I<bufsz> field in one of the I<segments> entries exceeds the "
+"value in the corresponding I<memsz> field."
+msgstr ""
#. type: Plain text
-#: build/C/man2/kexec_load.2:145
-msgid "The B<kexec_load>() system call first appeared in Linux 2.6.13."
-msgstr "B<kexec_load>() システムコールは Linux 2.6.13 で初めて登場した。"
+#: build/C/man2/kexec_load.2:298
+msgid "I<nr_segments> exceeds B<KEXEC_SEGMENT_MAX> (16)."
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/kexec_load.2:301
+msgid "Two or more of the kernel target buffers overlap."
+msgstr ""
#. type: Plain text
-#: build/C/man2/kexec_load.2:152
+#: build/C/man2/kexec_load.2:306
+msgid "The value in I<cmdline[cmdline_len-1]> is not \\(aq\\e0\\(aq."
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/kexec_load.2:313
msgid ""
-"Currently, there is no glibc support for B<kexec_load>(). Call it using "
-"B<syscall>(2)."
+"The file referred to by I<kernel_fd> or I<initrd_fd> is empty (length zero)."
msgstr ""
-"現在のところ、 B<kexec_load>() は glibc ではサポートされていない。\n"
-"B<syscall>(2) を使って呼び出すこと。"
-#. FIXME . Andi submitted a patch for this.
-#. Check if it got accepted later.
+#. type: TP
+#: build/C/man2/kexec_load.2:313 build/C/man2/lookup_dcookie.2:61
+#: build/C/man2/process_vm_readv.2:278 build/C/man2/sendfile.2:138
+#: build/C/man2/splice.2:169 build/C/man2/tee.2:117
+#: build/C/man2/vmsplice.2:145
+#, no-wrap
+msgid "B<ENOMEM>"
+msgstr "B<ENOMEM>"
+
#. type: Plain text
-#: build/C/man2/kexec_load.2:159
+#: build/C/man2/kexec_load.2:316
+#, fuzzy
+#| msgid "Out of memory."
+msgid "Could not allocate memory."
+msgstr "メモリー不足。"
+
+#. type: TP
+#: build/C/man2/kexec_load.2:316
+#, fuzzy, no-wrap
+#| msgid "B<ENOENT>"
+msgid "B<ENOEXEC>"
+msgstr "B<ENOENT>"
+
+#. type: Plain text
+#: build/C/man2/kexec_load.2:323
msgid ""
-"The required constants are in the Linux kernel source file I<linux/kexec.h>, "
-"which is not currently exported to glibc. Therefore, these constants must "
-"be defined manually."
+"I<kernel_fd> does not refer to an open file, or the kernel can't load this "
+"file. Currently, the file must be a bzImage and contain an x86 kernel that "
+"is loadable above 4GiB in memory (see the kernel source file I<Documentation/"
+"x86/boot.txt>)."
msgstr ""
-"必要な定数は Linux カーネルのソースファイル I<linux/kexec.h> で定義されてい"
-"る\n"
-"が、現在のところ glibc には公開されていない。\n"
-"そのため、これらの定数は手動で定義しなければならない。"
#. type: Plain text
-#: build/C/man2/kexec_load.2:162
+#: build/C/man2/kexec_load.2:328
+msgid "The caller does not have the B<CAP_SYS_BOOT> capability."
+msgstr "呼び出し側が B<CAP_SYS_BOOT> ケーパビリティを持っていない。"
+
+#. type: Plain text
+#: build/C/man2/kexec_load.2:335
+#, fuzzy
+#| msgid "The B<kexec_load>() system call first appeared in Linux 2.6.13."
msgid ""
-"This system call is available only if the kernel was configured with "
-"B<CONFIG_KEXEC>."
+"The B<kexec_load>() system call first appeared in Linux 2.6.13. The "
+"B<kexec_file_load>() system call first appeared in Linux 3.17."
+msgstr "B<kexec_load>() システムコールは Linux 2.6.13 で初めて登場した。"
+
+#. type: Plain text
+#: build/C/man2/kexec_load.2:337
+#, fuzzy
+#| msgid "This system call is Linux-specific."
+msgid "These system calls are Linux-specific."
+msgstr "このシステムコールは Linux 固有である。"
+
+#. type: Plain text
+#: build/C/man2/kexec_load.2:341
+#, fuzzy
+#| msgid ""
+#| "Currently, there is no glibc support for B<kexec_load>(). Call it using "
+#| "B<syscall>(2)."
+msgid ""
+"Currently, there is no glibc support for these system calls. Call them "
+"using B<syscall>(2)."
msgstr ""
-"このシステムコールは、カーネルの設定で B<CONFIG_KEXEC> が有効になって\n"
-"いる場合にのみ利用できる。"
+"現在のところ、 B<kexec_load>() は glibc ではサポートされていない。\n"
+"B<syscall>(2) を使って呼び出すこと。"
#. type: Plain text
-#: build/C/man2/kexec_load.2:165
-msgid "B<reboot>(2), B<syscall>(2)"
+#: build/C/man2/kexec_load.2:345
+#, fuzzy
+#| msgid "B<reboot>(2), B<syscall>(2)"
+msgid "B<reboot>(2), B<syscall>(2), B<kexec>(8)"
msgstr "B<reboot>(2), B<syscall>(2)"
+#. type: Plain text
+#: build/C/man2/kexec_load.2:350
+msgid ""
+"The kernel source files I<Documentation/kdump/kdump.txt> and I<Documentation/"
+"kernel-parameters.txt>."
+msgstr ""
+
#. type: TH
#: build/C/man2/lookup_dcookie.2:27
#, no-wrap
msgid "The name could not fit in the buffer."
msgstr "名前がバッファーに入り切らなかった。"
-#. type: TP
-#: build/C/man2/lookup_dcookie.2:61 build/C/man2/process_vm_readv.2:278
-#: build/C/man2/sendfile.2:138 build/C/man2/splice.2:169
-#: build/C/man2/tee.2:117 build/C/man2/vmsplice.2:145
-#, no-wrap
-msgid "B<ENOMEM>"
-msgstr "B<ENOMEM>"
-
#. type: Plain text
#: build/C/man2/lookup_dcookie.2:65
msgid ""
msgstr "I/O エラー。"
#. type: TP
-#: build/C/man2/pciconfig_read.2:87 build/C/man2/perf_event_open.2:2640
+#: build/C/man2/pciconfig_read.2:87 build/C/man2/perf_event_open.2:2696
#, no-wrap
msgid "B<ENODEV>"
msgstr "B<ENODEV>"
"いない)。"
#. type: TP
-#: build/C/man2/pciconfig_read.2:98 build/C/man2/perf_event_open.2:2668
+#: build/C/man2/pciconfig_read.2:98 build/C/man2/perf_event_open.2:2725
#, no-wrap
msgid "B<EOPNOTSUPP>"
msgstr "B<EOPNOTSUPP>"
msgid "B<PERF_FLAG_FD_OUTPUT> (broken since Linux 2.6.35)"
msgstr "B<PERF_FLAG_FD_OUTPUT> (Linux 2.6.35 以降では正しく動作しない)"
+#. commit ac9721f3f54b27a16c7e1afb2481e7ee95a70318
#. type: Plain text
-#: build/C/man2/perf_event_open.2:164
+#: build/C/man2/perf_event_open.2:165
msgid ""
"This flag re-routes the event's sampled output to instead be included in the "
"mmap buffer of the event specified by I<group_fd>."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:164
+#: build/C/man2/perf_event_open.2:165
#, no-wrap
msgid "B<PERF_FLAG_PID_CGROUP> (since Linux 2.6.39)"
msgstr "B<PERF_FLAG_PID_CGROUP> (Linux 2.6.39 以降)"
#. commit e5d1367f17ba6a6fed5fd8b74e4d5720923e0c25
#. type: Plain text
-#: build/C/man2/perf_event_open.2:188
+#: build/C/man2/perf_event_open.2:189
msgid ""
"This flag activates per-container system-wide monitoring. A container is an "
"abstraction that isolates a set of resources for finer-grained control "
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:193
+#: build/C/man2/perf_event_open.2:194
msgid ""
"The I<perf_event_attr> structure provides detailed configuration information "
"for the event being created."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:200
+#: build/C/man2/perf_event_open.2:201
#, no-wrap
msgid ""
"struct perf_event_attr {\n"
" __u64 config; /* Type-specific configuration */\n"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:205
+#: build/C/man2/perf_event_open.2:206
#, no-wrap
msgid ""
" union {\n"
" };\n"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:208
+#: build/C/man2/perf_event_open.2:209
#, no-wrap
msgid ""
" __u64 sample_type; /* Specifies values included in sample */\n"
" __u64 read_format; /* Specifies values returned in read */\n"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:236
+#: build/C/man2/perf_event_open.2:237
#, no-wrap
msgid ""
" __u64 disabled : 1, /* off by default */\n"
" __reserved_1 : 39;\n"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:241
+#: build/C/man2/perf_event_open.2:242
#, no-wrap
msgid ""
" union {\n"
" };\n"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:243
+#: build/C/man2/perf_event_open.2:244
#, no-wrap
msgid " __u32 bp_type; /* breakpoint type */\n"
msgstr " __u32 bp_type; /* breakpoint type */\n"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:248
+#: build/C/man2/perf_event_open.2:249
#, no-wrap
msgid ""
" union {\n"
" };\n"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:258
+#: build/C/man2/perf_event_open.2:259
#, no-wrap
msgid ""
" union {\n"
" __u32 __reserved_2; /* Align to u64 */\n"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:260
+#: build/C/man2/perf_event_open.2:261
#, no-wrap
msgid "};\n"
msgstr "};\n"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:266
+#: build/C/man2/perf_event_open.2:267
msgid ""
"The fields of the I<perf_event_attr> structure are described in more detail "
"below:"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:266 build/C/man2/perf_event_open.2:1627
+#: build/C/man2/perf_event_open.2:267 build/C/man2/perf_event_open.2:1669
#, no-wrap
msgid "I<type>"
msgstr "I<type>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:270
+#: build/C/man2/perf_event_open.2:271
msgid ""
"This field specifies the overall event type. It has one of the following "
"values:"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:271
+#: build/C/man2/perf_event_open.2:272
#, no-wrap
msgid "B<PERF_TYPE_HARDWARE>"
msgstr "B<PERF_TYPE_HARDWARE>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:278
+#: build/C/man2/perf_event_open.2:279
msgid ""
"This indicates one of the \"generalized\" hardware events provided by the "
"kernel. See the I<config> field definition for more details."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:278
+#: build/C/man2/perf_event_open.2:279
#, no-wrap
msgid "B<PERF_TYPE_SOFTWARE>"
msgstr "B<PERF_TYPE_SOFTWARE>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:282
+#: build/C/man2/perf_event_open.2:283
msgid ""
"This indicates one of the software-defined events provided by the kernel "
"(even if no hardware support is available)."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:282
+#: build/C/man2/perf_event_open.2:283
#, no-wrap
msgid "B<PERF_TYPE_TRACEPOINT>"
msgstr "B<PERF_TYPE_TRACEPOINT>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:286
+#: build/C/man2/perf_event_open.2:287
msgid ""
"This indicates a tracepoint provided by the kernel tracepoint infrastructure."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:286
+#: build/C/man2/perf_event_open.2:287
#, no-wrap
msgid "B<PERF_TYPE_HW_CACHE>"
msgstr "B<PERF_TYPE_HW_CACHE>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:292
+#: build/C/man2/perf_event_open.2:293
msgid ""
"This indicates a hardware cache event. This has a special encoding, "
"described in the I<config> field definition."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:292
+#: build/C/man2/perf_event_open.2:293
#, no-wrap
msgid "B<PERF_TYPE_RAW>"
msgstr "B<PERF_TYPE_RAW>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:296
+#: build/C/man2/perf_event_open.2:297
msgid ""
"This indicates a \"raw\" implementation-specific event in the I<config> "
"field."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:296
+#: build/C/man2/perf_event_open.2:297
#, no-wrap
msgid "B<PERF_TYPE_BREAKPOINT> (since Linux 2.6.33)"
msgstr "B<PERF_TYPE_BREAKPOINT> (Linux 2.6.33 以降)"
#. commit 24f1e32c60c45c89a997c73395b69c8af6f0a84e
#. type: Plain text
-#: build/C/man2/perf_event_open.2:302
+#: build/C/man2/perf_event_open.2:303
msgid ""
"This indicates a hardware breakpoint as provided by the CPU. Breakpoints "
"can be read/write accesses to an address as well as execution of an "
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:302
+#: build/C/man2/perf_event_open.2:303
#, no-wrap
msgid "dynamic PMU"
msgstr ""
+#. commit 2e80a82a49c4c7eca4e35734380f28298ba5db19
#. type: Plain text
-#: build/C/man2/perf_event_open.2:321
+#: build/C/man2/perf_event_open.2:323
msgid ""
-"Since Linux 2.6.3
9, B<perf_event_open>() can support multiple PMUs. To "
+"Since Linux 2.6.3
8, B<perf_event_open>() can support multiple PMUs. To "
"enable this, a value exported by the kernel can be used in the I<type> field "
"to indicate which PMU to use. The value to use can be found in the sysfs "
"filesystem: there is a subdirectory per PMU instance under I</sys/bus/"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:322 build/C/man2/perf_event_open.2:1559
+#: build/C/man2/perf_event_open.2:324 build/C/man2/perf_event_open.2:1601
#, no-wrap
msgid "I<size>"
msgstr "I<size>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:331
+#: build/C/man2/perf_event_open.2:333
msgid ""
"The size of the I<perf_event_attr> structure for forward/backward "
"compatibility. Set this using I<sizeof(struct perf_event_attr)> to allow "
"the kernel to see the struct size at the time of compilation."
msgstr ""
+#. commit cb5d76999029ae7a517cb07dfa732c1b5a934fc2
+#. this was added much later when PERF_ATTR_SIZE_VER2 happened
+#. but the actual attr_size had increased in 2.6.33
+#. commit cb5d76999029ae7a517cb07dfa732c1b5a934fc2
+#. commit 1659d129ed014b715b0b2120e6fd929bdd33ed03
#. type: Plain text
-#: build/C/man2/perf_event_open.2:346
+#: build/C/man2/perf_event_open.2:353
msgid ""
"The related define B<PERF_ATTR_SIZE_VER0> is set to 64; this was the size of "
"the first published struct. B<PERF_ATTR_SIZE_VER1> is 72, corresponding to "
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:346
+#: build/C/man2/perf_event_open.2:353
#, no-wrap
msgid "I<config>"
msgstr "I<config>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:357
+#: build/C/man2/perf_event_open.2:364
msgid ""
"This specifies which event you want, in conjunction with the I<type> field. "
"The I<config1> and I<config2> fields are also taken into account in cases "
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:368
+#: build/C/man2/perf_event_open.2:375
msgid ""
"There are various ways to set the I<config> field that are dependent on the "
"value of the previously described I<type> field. What follows are various "
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:378
+#: build/C/man2/perf_event_open.2:385
msgid ""
"If I<type> is B<PERF_TYPE_HARDWARE>, we are measuring one of the generalized "
"hardware CPU events. Not all of these are available on all platforms. Set "
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:379
+#: build/C/man2/perf_event_open.2:386
#, no-wrap
msgid "B<PERF_COUNT_HW_CPU_CYCLES>"
msgstr "B<PERF_COUNT_HW_CPU_CYCLES>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:383
+#: build/C/man2/perf_event_open.2:390
msgid "Total cycles. Be wary of what happens during CPU frequency scaling."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:383
+#: build/C/man2/perf_event_open.2:390
#, no-wrap
msgid "B<PERF_COUNT_HW_INSTRUCTIONS>"
msgstr "B<PERF_COUNT_HW_INSTRUCTIONS>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:388
+#: build/C/man2/perf_event_open.2:395
msgid ""
"Retired instructions. Be careful, these can be affected by various issues, "
"most notably hardware interrupt counts."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:388
+#: build/C/man2/perf_event_open.2:395
#, no-wrap
msgid "B<PERF_COUNT_HW_CACHE_REFERENCES>"
msgstr "B<PERF_COUNT_HW_CACHE_REFERENCES>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:395
+#: build/C/man2/perf_event_open.2:402
msgid ""
"Cache accesses. Usually this indicates Last Level Cache accesses but this "
"may vary depending on your CPU. This may include prefetches and coherency "
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:395
+#: build/C/man2/perf_event_open.2:402
#, no-wrap
msgid "B<PERF_COUNT_HW_CACHE_MISSES>"
msgstr "B<PERF_COUNT_HW_CACHE_MISSES>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:402
+#: build/C/man2/perf_event_open.2:409
msgid ""
"Cache misses. Usually this indicates Last Level Cache misses; this is "
"intended to be used in conjunction with the "
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:402
+#: build/C/man2/perf_event_open.2:409
#, no-wrap
msgid "B<PERF_COUNT_HW_BRANCH_INSTRUCTIONS>"
msgstr "B<PERF_COUNT_HW_BRANCH_INSTRUCTIONS>"
+#. commit f287d332ce835f77a4f5077d2c0ef1e3f9ea42d2
#. type: Plain text
-#: build/C/man2/perf_event_open.2:407
+#: build/C/man2/perf_event_open.2:415
msgid ""
-"Retired branch instructions. Prior to Linux 2.6.34, this used the wrong "
+"Retired branch instructions. Prior to Linux 2.6.35, this used the wrong "
"event on AMD processors."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:407
+#: build/C/man2/perf_event_open.2:415
#, no-wrap
msgid "B<PERF_COUNT_HW_BRANCH_MISSES>"
msgstr "B<PERF_COUNT_HW_BRANCH_MISSES>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:410
+#: build/C/man2/perf_event_open.2:418
msgid "Mispredicted branch instructions."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:410
+#: build/C/man2/perf_event_open.2:418
#, no-wrap
msgid "B<PERF_COUNT_HW_BUS_CYCLES>"
msgstr "B<PERF_COUNT_HW_BUS_CYCLES>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:413
+#: build/C/man2/perf_event_open.2:421
msgid "Bus cycles, which can be different from total cycles."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:413
+#: build/C/man2/perf_event_open.2:421
#, no-wrap
msgid "B<PERF_COUNT_HW_STALLED_CYCLES_FRONTEND> (since Linux 3.0)"
msgstr "B<PERF_COUNT_HW_STALLED_CYCLES_FRONTEND> (Linux 3.0 以降)"
+#. commit 8f62242246351b5a4bc0c1f00c0c7003edea128a
#. type: Plain text
-#: build/C/man2/perf_event_open.2:416
+#: build/C/man2/perf_event_open.2:425
msgid "Stalled cycles during issue."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:416
+#: build/C/man2/perf_event_open.2:425
#, no-wrap
msgid "B<PERF_COUNT_HW_STALLED_CYCLES_BACKEND> (since Linux 3.0)"
msgstr "B<PERF_COUNT_HW_STALLED_CYCLES_BACKEND> (Linux 3.0 以降)"
+#. commit 8f62242246351b5a4bc0c1f00c0c7003edea128a
#. type: Plain text
-#: build/C/man2/perf_event_open.2:419
+#: build/C/man2/perf_event_open.2:429
msgid "Stalled cycles during retirement."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:419
+#: build/C/man2/perf_event_open.2:429
#, no-wrap
msgid "B<PERF_COUNT_HW_REF_CPU_CYCLES> (since Linux 3.3)"
msgstr "B<PERF_COUNT_HW_REF_CPU_CYCLES> (Linux 3.3 以降)"
#. commit c37e17497e01fc0f5d2d6feb5723b210b3ab8890
#. type: Plain text
-#: build/C/man2/perf_event_open.2:423
+#: build/C/man2/perf_event_open.2:433
msgid "Total cycles; not affected by CPU frequency scaling."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:433
+#: build/C/man2/perf_event_open.2:443
msgid ""
"If I<type> is B<PERF_TYPE_SOFTWARE>, we are measuring software events "
"provided by the kernel. Set I<config> to one of the following:"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:434
+#: build/C/man2/perf_event_open.2:444
#, no-wrap
msgid "B<PERF_COUNT_SW_CPU_CLOCK>"
msgstr "B<PERF_COUNT_SW_CPU_CLOCK>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:437
+#: build/C/man2/perf_event_open.2:447
msgid "This reports the CPU clock, a high-resolution per-CPU timer."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:437
+#: build/C/man2/perf_event_open.2:447
#, no-wrap
msgid "B<PERF_COUNT_SW_TASK_CLOCK>"
msgstr "B<PERF_COUNT_SW_TASK_CLOCK>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:440
+#: build/C/man2/perf_event_open.2:450
msgid "This reports a clock count specific to the task that is running."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:440
+#: build/C/man2/perf_event_open.2:450
#, no-wrap
msgid "B<PERF_COUNT_SW_PAGE_FAULTS>"
msgstr "B<PERF_COUNT_SW_PAGE_FAULTS>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:443
+#: build/C/man2/perf_event_open.2:453
msgid "This reports the number of page faults."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:443
+#: build/C/man2/perf_event_open.2:453
#, no-wrap
msgid "B<PERF_COUNT_SW_CONTEXT_SWITCHES>"
msgstr "B<PERF_COUNT_SW_CONTEXT_SWITCHES>"
+#. commit e49a5bd38159dfb1928fd25b173bc9de4bbadb21
#. type: Plain text
-#: build/C/man2/perf_event_open.2:448
+#: build/C/man2/perf_event_open.2:459
msgid ""
"This counts context switches. Until Linux 2.6.34, these were all reported "
"as user-space events, after that they are reported as happening in the "
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:448
+#: build/C/man2/perf_event_open.2:459
#, no-wrap
msgid "B<PERF_COUNT_SW_CPU_MIGRATIONS>"
msgstr "B<PERF_COUNT_SW_CPU_MIGRATIONS>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:452
+#: build/C/man2/perf_event_open.2:463
msgid "This reports the number of times the process has migrated to a new CPU."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:452
+#: build/C/man2/perf_event_open.2:463
#, no-wrap
msgid "B<PERF_COUNT_SW_PAGE_FAULTS_MIN>"
msgstr "B<PERF_COUNT_SW_PAGE_FAULTS_MIN>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:456
+#: build/C/man2/perf_event_open.2:467
msgid ""
"This counts the number of minor page faults. These did not require disk I/O "
"to handle."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:456
+#: build/C/man2/perf_event_open.2:467
#, no-wrap
msgid "B<PERF_COUNT_SW_PAGE_FAULTS_MAJ>"
msgstr "B<PERF_COUNT_SW_PAGE_FAULTS_MAJ>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:460
+#: build/C/man2/perf_event_open.2:471
msgid ""
"This counts the number of major page faults. These required disk I/O to "
"handle."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:460
+#: build/C/man2/perf_event_open.2:471
#, no-wrap
msgid "B<PERF_COUNT_SW_ALIGNMENT_FAULTS> (since Linux 2.6.33)"
msgstr "B<PERF_COUNT_SW_ALIGNMENT_FAULTS> (Linux 2.6.33 以降)"
#. commit f7d7986060b2890fc26db6ab5203efbd33aa2497
#. type: Plain text
-#: build/C/man2/perf_event_open.2:467
+#: build/C/man2/perf_event_open.2:478
msgid ""
"This counts the number of alignment faults. These happen when unaligned "
"memory accesses happen; the kernel can handle these but it reduces "
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:467
+#: build/C/man2/perf_event_open.2:478
#, no-wrap
msgid "B<PERF_COUNT_SW_EMULATION_FAULTS> (since Linux 2.6.33)"
msgstr "B<PERF_COUNT_SW_EMULATION_FAULTS> (Linux 2.6.33 以降)"
#. commit f7d7986060b2890fc26db6ab5203efbd33aa2497
#. type: Plain text
-#: build/C/man2/perf_event_open.2:474
+#: build/C/man2/perf_event_open.2:485
msgid ""
"This counts the number of emulation faults. The kernel sometimes traps on "
"unimplemented instructions and emulates them for user space. This can "
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:474
+#: build/C/man2/perf_event_open.2:485
#, no-wrap
msgid "B<PERF_COUNT_SW_DUMMY> (since Linux 3.12)"
msgstr "B<PERF_COUNT_SW_DUMMY> (Linux 3.12 以降)"
#. commit fa0097ee690693006ab1aea6c01ad3c851b65c77
#. type: Plain text
-#: build/C/man2/perf_event_open.2:482
+#: build/C/man2/perf_event_open.2:493
msgid ""
"This is a placeholder event that counts nothing. Informational sample "
"record types such as mmap or comm must be associated with an active event. "
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:495
+#: build/C/man2/perf_event_open.2:506
msgid ""
"If I<type> is B<PERF_TYPE_TRACEPOINT>, then we are measuring kernel "
"tracepoints. The value to use in I<config> can be obtained from under "
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:506
+#: build/C/man2/perf_event_open.2:517
msgid ""
"If I<type> is B<PERF_TYPE_HW_CACHE>, then we are measuring a hardware CPU "
"cache event. To calculate the appropriate I<config> value use the following "
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:511
+#: build/C/man2/perf_event_open.2:522
#, no-wrap
msgid ""
" (perf_hw_cache_id) | (perf_hw_cache_op_id E<lt>E<lt> 8) |\n"
" (perf_hw_cache_op_result_id E<lt>E<lt> 16)\n"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:516
+#: build/C/man2/perf_event_open.2:527
msgid "where I<perf_hw_cache_id> is one of:"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:517
+#: build/C/man2/perf_event_open.2:528
#, no-wrap
msgid "B<PERF_COUNT_HW_CACHE_L1D>"
msgstr "B<PERF_COUNT_HW_CACHE_L1D>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:520
+#: build/C/man2/perf_event_open.2:531
msgid "for measuring Level 1 Data Cache"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:520
+#: build/C/man2/perf_event_open.2:531
#, no-wrap
msgid "B<PERF_COUNT_HW_CACHE_L1I>"
msgstr "B<PERF_COUNT_HW_CACHE_L1I>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:523
+#: build/C/man2/perf_event_open.2:534
msgid "for measuring Level 1 Instruction Cache"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:523
+#: build/C/man2/perf_event_open.2:534
#, no-wrap
msgid "B<PERF_COUNT_HW_CACHE_LL>"
msgstr "B<PERF_COUNT_HW_CACHE_LL>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:526
+#: build/C/man2/perf_event_open.2:537
msgid "for measuring Last-Level Cache"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:526
+#: build/C/man2/perf_event_open.2:537
#, no-wrap
msgid "B<PERF_COUNT_HW_CACHE_DTLB>"
msgstr "B<PERF_COUNT_HW_CACHE_DTLB>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:529
+#: build/C/man2/perf_event_open.2:540
msgid "for measuring the Data TLB"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:529
+#: build/C/man2/perf_event_open.2:540
#, no-wrap
msgid "B<PERF_COUNT_HW_CACHE_ITLB>"
msgstr "B<PERF_COUNT_HW_CACHE_ITLB>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:532
+#: build/C/man2/perf_event_open.2:543
msgid "for measuring the Instruction TLB"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:532
+#: build/C/man2/perf_event_open.2:543
#, no-wrap
msgid "B<PERF_COUNT_HW_CACHE_BPU>"
msgstr "B<PERF_COUNT_HW_CACHE_BPU>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:535
+#: build/C/man2/perf_event_open.2:546
msgid "for measuring the branch prediction unit"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:535
+#: build/C/man2/perf_event_open.2:546
#, no-wrap
msgid "B<PERF_COUNT_HW_CACHE_NODE> (since Linux 3.1)"
msgstr "B<PERF_COUNT_HW_CACHE_NODE> (Linux 3.1 以降)"
#. commit 89d6c0b5bdbb1927775584dcf532d98b3efe1477
#. type: Plain text
-#: build/C/man2/perf_event_open.2:539
+#: build/C/man2/perf_event_open.2:550
msgid "for measuring local memory accesses"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:544
+#: build/C/man2/perf_event_open.2:555
msgid "and I<perf_hw_cache_op_id> is one of"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:545
+#: build/C/man2/perf_event_open.2:556
#, no-wrap
msgid "B<PERF_COUNT_HW_CACHE_OP_READ>"
msgstr "B<PERF_COUNT_HW_CACHE_OP_READ>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:548
+#: build/C/man2/perf_event_open.2:559
msgid "for read accesses"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:548
+#: build/C/man2/perf_event_open.2:559
#, no-wrap
msgid "B<PERF_COUNT_HW_CACHE_OP_WRITE>"
msgstr "B<PERF_COUNT_HW_CACHE_OP_WRITE>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:551
+#: build/C/man2/perf_event_open.2:562
msgid "for write accesses"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:551
+#: build/C/man2/perf_event_open.2:562
#, no-wrap
msgid "B<PERF_COUNT_HW_CACHE_OP_PREFETCH>"
msgstr "B<PERF_COUNT_HW_CACHE_OP_PREFETCH>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:554
+#: build/C/man2/perf_event_open.2:565
msgid "for prefetch accesses"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:559
+#: build/C/man2/perf_event_open.2:570
msgid "and I<perf_hw_cache_op_result_id> is one of"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:560
+#: build/C/man2/perf_event_open.2:571
#, no-wrap
msgid "B<PERF_COUNT_HW_CACHE_RESULT_ACCESS>"
msgstr "B<PERF_COUNT_HW_CACHE_RESULT_ACCESS>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:563
+#: build/C/man2/perf_event_open.2:574
msgid "to measure accesses"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:563
+#: build/C/man2/perf_event_open.2:574
#, no-wrap
msgid "B<PERF_COUNT_HW_CACHE_RESULT_MISS>"
msgstr "B<PERF_COUNT_HW_CACHE_RESULT_MISS>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:566
+#: build/C/man2/perf_event_open.2:577
msgid "to measure misses"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:584
+#: build/C/man2/perf_event_open.2:595
msgid ""
"If I<type> is B<PERF_TYPE_RAW>, then a custom \"raw\" I<config> value is "
"needed. Most CPUs support events that are not covered by the \"generalized"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:593
+#: build/C/man2/perf_event_open.2:604
msgid ""
"If I<type> is B<PERF_TYPE_BREAKPOINT>, then leave I<config> set to zero. "
"Its parameters are set in other places."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:594
+#: build/C/man2/perf_event_open.2:605
#, no-wrap
msgid "I<sample_period>, I<sample_freq>"
msgstr "I<sample_period>, I<sample_freq>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:606
+#: build/C/man2/perf_event_open.2:617
msgid ""
"A \"sampling\" event is one that generates an overflow notification every N "
"events, where N is given by I<sample_period>. A sampling event has "
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:616
+#: build/C/man2/perf_event_open.2:627
msgid ""
"I<sample_freq> can be used if you wish to use frequency rather than period. "
"In this case, you set the I<freq> flag. The kernel will adjust the sampling "
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:616
+#: build/C/man2/perf_event_open.2:627
#, no-wrap
msgid "I<sample_type>"
msgstr "I<sample_type>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:628
+#: build/C/man2/perf_event_open.2:639
msgid ""
"The various bits in this field specify which values to include in the "
"sample. They will be recorded in a ring-buffer, which is available to user "
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:629
+#: build/C/man2/perf_event_open.2:640
#, no-wrap
msgid "B<PERF_SAMPLE_IP>"
msgstr "B<PERF_SAMPLE_IP>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:632
+#: build/C/man2/perf_event_open.2:643
msgid "Records instruction pointer."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:632
+#: build/C/man2/perf_event_open.2:643
#, no-wrap
msgid "B<PERF_SAMPLE_TID>"
msgstr "B<PERF_SAMPLE_TID>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:635
+#: build/C/man2/perf_event_open.2:646
msgid "Records the process and thread IDs."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:635
+#: build/C/man2/perf_event_open.2:646
#, no-wrap
msgid "B<PERF_SAMPLE_TIME>"
msgstr "B<PERF_SAMPLE_TIME>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:638
+#: build/C/man2/perf_event_open.2:649
msgid "Records a timestamp."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:638
+#: build/C/man2/perf_event_open.2:649
#, no-wrap
msgid "B<PERF_SAMPLE_ADDR>"
msgstr "B<PERF_SAMPLE_ADDR>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:641
+#: build/C/man2/perf_event_open.2:652
msgid "Records an address, if applicable."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:641
+#: build/C/man2/perf_event_open.2:652
#, no-wrap
msgid "B<PERF_SAMPLE_READ>"
msgstr "B<PERF_SAMPLE_READ>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:644
+#: build/C/man2/perf_event_open.2:655
msgid ""
"Record counter values for all events in a group, not just the group leader."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:644
+#: build/C/man2/perf_event_open.2:655
#, no-wrap
msgid "B<PERF_SAMPLE_CALLCHAIN>"
msgstr "B<PERF_SAMPLE_CALLCHAIN>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:647
+#: build/C/man2/perf_event_open.2:658
msgid "Records the callchain (stack backtrace)."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:647
+#: build/C/man2/perf_event_open.2:658
#, no-wrap
msgid "B<PERF_SAMPLE_ID>"
msgstr "B<PERF_SAMPLE_ID>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:650
+#: build/C/man2/perf_event_open.2:661
msgid "Records a unique ID for the opened event's group leader."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:650
+#: build/C/man2/perf_event_open.2:661
#, no-wrap
msgid "B<PERF_SAMPLE_CPU>"
msgstr "B<PERF_SAMPLE_CPU>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:653
+#: build/C/man2/perf_event_open.2:664
msgid "Records CPU number."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:653
+#: build/C/man2/perf_event_open.2:664
#, no-wrap
msgid "B<PERF_SAMPLE_PERIOD>"
msgstr "B<PERF_SAMPLE_PERIOD>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:656
+#: build/C/man2/perf_event_open.2:667
msgid "Records the current sampling period."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:656
+#: build/C/man2/perf_event_open.2:667
#, no-wrap
msgid "B<PERF_SAMPLE_STREAM_ID>"
msgstr "B<PERF_SAMPLE_STREAM_ID>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:664
+#: build/C/man2/perf_event_open.2:675
msgid ""
"Records a unique ID for the opened event. Unlike B<PERF_SAMPLE_ID> the "
"actual ID is returned, not the group leader. This ID is the same as the one "
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:664
+#: build/C/man2/perf_event_open.2:675
#, no-wrap
msgid "B<PERF_SAMPLE_RAW>"
msgstr "B<PERF_SAMPLE_RAW>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:668
+#: build/C/man2/perf_event_open.2:679
msgid ""
"Records additional data, if applicable. Usually returned by tracepoint "
"events."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:668
+#: build/C/man2/perf_event_open.2:679
#, no-wrap
msgid "B<PERF_SAMPLE_BRANCH_STACK> (since Linux 3.4)"
msgstr "B<PERF_SAMPLE_BRANCH_STACK> (Linux 3.4 以降)"
#. commit bce38cd53e5ddba9cb6d708c4ef3d04a4016ec7e
#. type: Plain text
-#: build/C/man2/perf_event_open.2:674
+#: build/C/man2/perf_event_open.2:685
msgid ""
"This provides a record of recent branches, as provided by CPU branch "
"sampling hardware (such as Intel Last Branch Record). Not all hardware "
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:678
+#: build/C/man2/perf_event_open.2:689
msgid ""
"See the I<branch_sample_type> field for how to filter which branches are "
"reported."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:678
+#: build/C/man2/perf_event_open.2:689
#, no-wrap
msgid "B<PERF_SAMPLE_REGS_USER> (since Linux 3.7)"
msgstr "B<PERF_SAMPLE_REGS_USER> (Linux 3.7 以降)"
#. commit 4018994f3d8785275ef0e7391b75c3462c029e56
#. type: Plain text
-#: build/C/man2/perf_event_open.2:683
+#: build/C/man2/perf_event_open.2:694
msgid ""
"Records the current user-level CPU register state (the values in the process "
"before the kernel was called)."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:683
+#: build/C/man2/perf_event_open.2:694
#, no-wrap
msgid "B<PERF_SAMPLE_STACK_USER> (since Linux 3.7)"
msgstr "B<PERF_SAMPLE_STACK_USER> (Linux 3.7 以降)"
#. commit c5ebcedb566ef17bda7b02686e0d658a7bb42ee7
#. type: Plain text
-#: build/C/man2/perf_event_open.2:687
+#: build/C/man2/perf_event_open.2:698
msgid "Records the user level stack, allowing stack unwinding."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:687
+#: build/C/man2/perf_event_open.2:698
#, no-wrap
msgid "B<PERF_SAMPLE_WEIGHT> (since Linux 3.10)"
msgstr "B<PERF_SAMPLE_WEIGHT> (Linux 3.10 以降)"
#. commit c3feedf2aaf9ac8bad6f19f5d21e4ee0b4b87e9c
#. type: Plain text
-#: build/C/man2/perf_event_open.2:694
+#: build/C/man2/perf_event_open.2:705
msgid ""
"Records a hardware provided weight value that expresses how costly the "
"sampled event was. This allows the hardware to highlight expensive events "
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:694
+#: build/C/man2/perf_event_open.2:705
#, no-wrap
msgid "B<PERF_SAMPLE_DATA_SRC> (since Linux 3.10)"
msgstr "B<PERF_SAMPLE_DATA_SRC> (Linux 3.10 以降)"
#. commit d6be9ad6c960f43800a6f118932bc8a5a4eadcd1
#. type: Plain text
-#: build/C/man2/perf_event_open.2:701
+#: build/C/man2/perf_event_open.2:712
msgid ""
"Records the data source: where in the memory hierarchy the data associated "
-"with the sampled instruction came from. This is only available if the "
+"with the sampled instruction came from. This is available only if the "
"underlying hardware supports this feature."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:701
+#: build/C/man2/perf_event_open.2:712
#, no-wrap
msgid "B<PERF_SAMPLE_IDENTIFIER> (since Linux 3.12)"
msgstr "B<PERF_SAMPLE_IDENTIFIER> (Linux 3.12 以降)"
#. commit ff3d527cebc1fa3707c617bfe9e74f53fcfb0955
#. type: Plain text
-#: build/C/man2/perf_event_open.2:709
+#: build/C/man2/perf_event_open.2:720
msgid ""
"Places the B<SAMPLE_ID> value in a fixed position in the record, either at "
"the beginning (for sample events) or at the end (if a non-sample event)."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:721
+#: build/C/man2/perf_event_open.2:732
msgid ""
"This was necessary because a sample stream may have records from various "
"different event sources with different I<sample_type> settings. Parsing the "
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:731
+#: build/C/man2/perf_event_open.2:742
msgid ""
"The B<PERF_SAMPLE_IDENTIFIER> setting makes the event stream always parsable "
"by putting B<SAMPLE_ID> in a fixed location, even though it means having "
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:731
+#: build/C/man2/perf_event_open.2:742
#, no-wrap
msgid "B<PERF_SAMPLE_TRANSACTION> (since Linux 3.13)"
msgstr "B<PERF_SAMPLE_TRANSACTION> (Linux 3.13 以降)"
#. commit fdfbbd07e91f8fe387140776f3fd94605f0c89e5
#. type: Plain text
-#: build/C/man2/perf_event_open.2:736
+#: build/C/man2/perf_event_open.2:747
msgid ""
"Records reasons for transactional memory abort events (for example, from "
"Intel TSX transactional memory support)."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:744
+#: build/C/man2/perf_event_open.2:755
msgid ""
"The I<precise_ip> setting must be greater than 0 and a transactional memory "
"abort event must be measured or no values will be recorded. Also note that "
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:745
+#: build/C/man2/perf_event_open.2:756
#, no-wrap
msgid "I<read_format>"
msgstr "I<read_format>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:752
+#: build/C/man2/perf_event_open.2:763
msgid ""
"This field specifies the format of the data returned by B<read>(2) on a "
"B<perf_event_open>() file descriptor."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:753
+#: build/C/man2/perf_event_open.2:764
#, no-wrap
msgid "B<PERF_FORMAT_TOTAL_TIME_ENABLED>"
msgstr "B<PERF_FORMAT_TOTAL_TIME_ENABLED>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:760
+#: build/C/man2/perf_event_open.2:771
msgid ""
"Adds the 64-bit I<time_enabled> field. This can be used to calculate "
"estimated totals if the PMU is overcommitted and multiplexing is happening."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:760
+#: build/C/man2/perf_event_open.2:771
#, no-wrap
msgid "B<PERF_FORMAT_TOTAL_TIME_RUNNING>"
msgstr "B<PERF_FORMAT_TOTAL_TIME_RUNNING>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:767
+#: build/C/man2/perf_event_open.2:778
msgid ""
"Adds the 64-bit I<time_running> field. This can be used to calculate "
"estimated totals if the PMU is overcommitted and multiplexing is happening."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:767
+#: build/C/man2/perf_event_open.2:778
#, no-wrap
msgid "B<PERF_FORMAT_ID>"
msgstr "B<PERF_FORMAT_ID>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:770
+#: build/C/man2/perf_event_open.2:781
msgid "Adds a 64-bit unique value that corresponds to the event group."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:770
+#: build/C/man2/perf_event_open.2:781
#, no-wrap
msgid "B<PERF_FORMAT_GROUP>"
msgstr "B<PERF_FORMAT_GROUP>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:773
+#: build/C/man2/perf_event_open.2:784
msgid "Allows all counter values in an event group to be read with one read."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:774
+#: build/C/man2/perf_event_open.2:785
#, no-wrap
msgid "I<disabled>"
msgstr "I<disabled>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:784
+#: build/C/man2/perf_event_open.2:795
msgid ""
"The I<disabled> bit specifies whether the counter starts out disabled or "
"enabled. If disabled, the event can later be enabled by B<ioctl>(2), "
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:795
+#: build/C/man2/perf_event_open.2:806
msgid ""
"When creating an event group, typically the group leader is initialized with "
"I<disabled> set to 1 and any child events are initialized with I<disabled> "
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:795
+#: build/C/man2/perf_event_open.2:806
#, no-wrap
msgid "I<inherit>"
msgstr "I<inherit>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:804
+#: build/C/man2/perf_event_open.2:815
msgid ""
"The I<inherit> bit specifies that this counter should count events of child "
"tasks as well as the task specified. This applies only to new children, not "
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:809
+#: build/C/man2/perf_event_open.2:820
msgid ""
"Inherit does not work for some combinations of I<read_format>s, such as "
"B<PERF_FORMAT_GROUP>."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:809
+#: build/C/man2/perf_event_open.2:820
#, no-wrap
msgid "I<pinned>"
msgstr "I<pinned>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:822
+#: build/C/man2/perf_event_open.2:833
msgid ""
"The I<pinned> bit specifies that the counter should always be on the CPU if "
"at all possible. It applies only to hardware counters and only to group "
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:822
+#: build/C/man2/perf_event_open.2:833
#, no-wrap
msgid "I<exclusive>"
msgstr "I<exclusive>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:831
+#: build/C/man2/perf_event_open.2:842
msgid ""
"The I<exclusive> bit specifies that when this counter's group is on the CPU, "
"it should be the only group using the CPU's counters. In the future this "
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:838
+#: build/C/man2/perf_event_open.2:849
msgid ""
"Note that many unexpected situations may prevent events with the "
"I<exclusive> bit set from ever running. This includes any users running a "
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:838
+#: build/C/man2/perf_event_open.2:849
#, no-wrap
msgid "I<exclude_user>"
msgstr "I<exclude_user>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:841
+#: build/C/man2/perf_event_open.2:852
msgid ""
"If this bit is set, the count excludes events that happen in user space."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:841
+#: build/C/man2/perf_event_open.2:852
#, no-wrap
msgid "I<exclude_kernel>"
msgstr "I<exclude_kernel>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:844
+#: build/C/man2/perf_event_open.2:855
msgid ""
"If this bit is set, the count excludes events that happen in kernel-space."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:844
+#: build/C/man2/perf_event_open.2:855
#, no-wrap
msgid "I<exclude_hv>"
msgstr "I<exclude_hv>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:852
+#: build/C/man2/perf_event_open.2:863
msgid ""
"If this bit is set, the count excludes events that happen in the "
"hypervisor. This is mainly for PMUs that have built-in support for handling "
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:852
+#: build/C/man2/perf_event_open.2:863
#, no-wrap
msgid "I<exclude_idle>"
msgstr "I<exclude_idle>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:855
+#: build/C/man2/perf_event_open.2:866
msgid "If set, don't count when the CPU is idle."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:855
+#: build/C/man2/perf_event_open.2:866
#, no-wrap
msgid "I<mmap>"
msgstr "I<mmap>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:869
+#: build/C/man2/perf_event_open.2:880
msgid ""
"The I<mmap> bit enables generation of B<PERF_RECORD_MMAP> samples for every "
"B<mmap>(2) call that has B<PROT_EXEC> set. This allows tools to notice new "
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:869 build/C/man2/perf_event_open.2:1719
+#: build/C/man2/perf_event_open.2:880 build/C/man2/perf_event_open.2:1761
#, no-wrap
msgid "I<comm>"
msgstr "I<comm>"
+#. commit 82b897782d10fcc4930c9d4a15b175348fdd2871
#. type: Plain text
-#: build/C/man2/perf_event_open.2:887
+#: build/C/man2/perf_event_open.2:899
msgid ""
"The I<comm> bit enables tracking of process command name as modified by the "
"B<exec>(2) and B<prctl>(PR_SET_NAME) system calls as well as writing to I</"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:887
+#: build/C/man2/perf_event_open.2:899
#, no-wrap
msgid "I<freq>"
msgstr "I<freq>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:894
+#: build/C/man2/perf_event_open.2:906
msgid ""
"If this bit is set, then I<sample_frequency> not I<sample_period> is used "
"when setting up the sampling interval."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:894
+#: build/C/man2/perf_event_open.2:906
#, no-wrap
msgid "I<inherit_stat>"
msgstr "I<inherit_stat>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:901
+#: build/C/man2/perf_event_open.2:913
msgid ""
"This bit enables saving of event counts on context switch for inherited "
"tasks. This is meaningful only if the I<inherit> field is set."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:901
+#: build/C/man2/perf_event_open.2:913
#, no-wrap
msgid "I<enable_on_exec>"
msgstr "I<enable_on_exec>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:906
+#: build/C/man2/perf_event_open.2:918
msgid ""
"If this bit is set, a counter is automatically enabled after a call to "
"B<exec>(2)."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:906
+#: build/C/man2/perf_event_open.2:918
#, no-wrap
msgid "I<task>"
msgstr "I<task>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:910
+#: build/C/man2/perf_event_open.2:922
msgid ""
"If this bit is set, then fork/exit notifications are included in the ring "
"buffer."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:910
+#: build/C/man2/perf_event_open.2:922
#, no-wrap
msgid "I<watermark>"
msgstr "I<watermark>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:918
+#: build/C/man2/perf_event_open.2:930
msgid ""
"If set, have an overflow notification happen when we cross the "
"I<wakeup_watermark> boundary. Otherwise, overflow notifications happen "
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:918
+#: build/C/man2/perf_event_open.2:930
#, no-wrap
msgid "I<precise_ip> (since Linux 2.6.35)"
msgstr "I<precise_ip> (Linux 2.6.35 以降)"
+#. commit ab608344bcbde4f55ec4cd911b686b0ce3eae076
#. type: Plain text
-#: build/C/man2/perf_event_open.2:928
+#: build/C/man2/perf_event_open.2:941
msgid ""
"This controls the amount of skid. Skid is how many instructions execute "
"between an event of interest happening and the kernel being able to stop and "
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:930
+#: build/C/man2/perf_event_open.2:943
msgid "The values of this are the following:"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:931
+#: build/C/man2/perf_event_open.2:944
#, no-wrap
msgid "0 -"
msgstr "0 -"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:935
+#: build/C/man2/perf_event_open.2:948
msgid "B<SAMPLE_IP> can have arbitrary skid."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:935
+#: build/C/man2/perf_event_open.2:948
#, no-wrap
msgid "1 -"
msgstr "1 -"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:939
+#: build/C/man2/perf_event_open.2:952
msgid "B<SAMPLE_IP> must have constant skid."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:939
+#: build/C/man2/perf_event_open.2:952
#, no-wrap
msgid "2 -"
msgstr "2 -"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:943
+#: build/C/man2/perf_event_open.2:956
msgid "B<SAMPLE_IP> requested to have 0 skid."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:943
+#: build/C/man2/perf_event_open.2:956
#, no-wrap
msgid "3 -"
msgstr "3 -"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:949
+#: build/C/man2/perf_event_open.2:962
msgid "B<SAMPLE_IP> must have 0 skid. See also B<PERF_RECORD_MISC_EXACT_IP>."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:950
+#: build/C/man2/perf_event_open.2:963
#, no-wrap
msgid "I<mmap_data> (since Linux 2.6.36)"
msgstr "I<mmap_data> (Linux 2.6.36 以降)"
+#. commit 3af9e859281bda7eb7c20b51879cf43aa788ac2e
#. type: Plain text
-#: build/C/man2/perf_event_open.2:962
+#: build/C/man2/perf_event_open.2:976
msgid ""
"The counterpart of the I<mmap> field. This enables generation of "
"B<PERF_RECORD_MMAP> samples for B<mmap>(2) calls that do not have "
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:962
+#: build/C/man2/perf_event_open.2:976
#, no-wrap
msgid "I<sample_id_all> (since Linux 2.6.38)"
msgstr "I<sample_id_all> (Linux 2.6.38 以降)"
+#. commit c980d1091810df13f21aabbce545fd98f545bbf7
#. type: Plain text
-#: build/C/man2/perf_event_open.2:970
+#: build/C/man2/perf_event_open.2:985
msgid ""
"If set, then TID, TIME, ID, STREAM_ID, and CPU can additionally be included "
"in non-B<PERF_RECORD_SAMPLE>s if the corresponding I<sample_type> is "
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:978
+#: build/C/man2/perf_event_open.2:993
msgid ""
"If B<PERF_SAMPLE_IDENTIFIER> is specified, then an additional ID value is "
"included as the last value to ease parsing the record stream. This may lead "
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:980
+#: build/C/man2/perf_event_open.2:995
msgid "The layout is described by this pseudo-structure:"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:990
+#: build/C/man2/perf_event_open.2:1005
#, no-wrap
msgid ""
"struct sample_id {\n"
"};\n"
#. type: TP
-#: build/C/man2/perf_event_open.2:991
+#: build/C/man2/perf_event_open.2:1006
#, no-wrap
msgid "I<exclude_host> (since Linux 3.2)"
msgstr "I<exclude_host> (Linux 3.2 以降)"
+#. commit a240f76165e6255384d4bdb8139895fac7988799
#. type: Plain text
-#: build/C/man2/perf_event_open.2:994
+#: build/C/man2/perf_event_open.2:1010
msgid "Do not measure time spent in VM host."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:994
+#: build/C/man2/perf_event_open.2:1010
#, no-wrap
msgid "I<exclude_guest> (since Linux 3.2)"
msgstr "I<exclude_guest> (Linux 3.2 以降)"
+#. commit a240f76165e6255384d4bdb8139895fac7988799
#. type: Plain text
-#: build/C/man2/perf_event_open.2:997
+#: build/C/man2/perf_event_open.2:1014
msgid "Do not measure time spent in VM guest."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:997
+#: build/C/man2/perf_event_open.2:1014
#, no-wrap
msgid "I<exclude_callchain_kernel> (since Linux 3.7)"
msgstr "I<exclude_callchain_kernel> (Linux 3.7 以降)"
+#. commit d077526485d5c9b12fe85d0b2b3b7041e6bc5f91
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1000
+#: build/C/man2/perf_event_open.2:1018
msgid "Do not include kernel callchains."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1000
+#: build/C/man2/perf_event_open.2:1018
#, no-wrap
msgid "I<exclude_callchain_user> (since Linux 3.7)"
msgstr "I<exclude_callchain_user> (Linux 3.7 以降)"
+#. commit d077526485d5c9b12fe85d0b2b3b7041e6bc5f91
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1003
+#: build/C/man2/perf_event_open.2:1022
msgid "Do not include user callchains."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1003
+#: build/C/man2/perf_event_open.2:1022
#, no-wrap
msgid "I<mmap2> (since Linux 3.16)"
msgstr "I<mmap2> (Linux 3.16 以降)"
+#. commit 13d7a2410fa637f450a29ecb515ac318ee40c741
+#. This is tricky; was committed during 3.12 development
+#. but right before release was disabled.
+#. So while you could select mmap2 starting with 3.12
+#. it did not work until 3.16
+#. commit a5a5ba72843dd05f991184d6cb9a4471acce1005
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1010
+#: build/C/man2/perf_event_open.2:1035
msgid ""
"Generate an extended executable mmap record that contains enough additional "
"information to uniquely identify shared mappings. The I<mmap> flag must "
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1010
+#: build/C/man2/perf_event_open.2:1035
#, no-wrap
msgid "I<comm_exec> (since Linux 3.16)"
msgstr "I<comm_exec> (Linux 3.16 以降)"
+#. commit 82b897782d10fcc4930c9d4a15b175348fdd2871
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1025
+#: build/C/man2/perf_event_open.2:1051
msgid ""
"This is purely a feature-detection flag, it does not change kernel "
"behavior. If this flag can successfully be set, then, when I<comm> is "
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1025
+#: build/C/man2/perf_event_open.2:1051
#, no-wrap
msgid "I<wakeup_events>, I<wakeup_watermark>"
msgstr "I<wakeup_events>, I<wakeup_watermark>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1035
+#: build/C/man2/perf_event_open.2:1061
msgid ""
"This union sets how many samples (I<wakeup_events>) or bytes "
"(I<wakeup_watermark>) happen before an overflow notification happens. "
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1045
+#: build/C/man2/perf_event_open.2:1071
msgid ""
-"I<wakeup_events>
only counts B<PERF_RECORD_SAMPLE> record types. To receive "
+"I<wakeup_events>
counts only B<PERF_RECORD_SAMPLE> record types. To receive "
"overflow notification for all B<PERF_RECORD> types choose watermark and set "
"I<wakeup_watermark> to 1."
msgstr ""
+#. commit f506b3dc0ec454a16d40cab9ee5d75435b39dc50
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1050
+#: build/C/man2/perf_event_open.2:1077
msgid ""
"Prior to Linux 3.0 setting I<wakeup_events> to 0 resulted in no overflow "
"notifications; more recent kernels treat 0 the same as 1."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1050
+#: build/C/man2/perf_event_open.2:1077
#, no-wrap
msgid "I<bp_type> (since Linux 2.6.33)"
msgstr "I<bp_type> (Linux 2.6.33 以降)"
+#. commit 24f1e32c60c45c89a997c73395b69c8af6f0a84e
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1054
+#: build/C/man2/perf_event_open.2:1082
msgid "This chooses the breakpoint type. It is one of:"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1055
+#: build/C/man2/perf_event_open.2:1083
#, no-wrap
msgid "B<HW_BREAKPOINT_EMPTY>"
msgstr "B<HW_BREAKPOINT_EMPTY>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1058
+#: build/C/man2/perf_event_open.2:1086
msgid "No breakpoint."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1058
+#: build/C/man2/perf_event_open.2:1086
#, no-wrap
msgid "B<HW_BREAKPOINT_R>"
msgstr "B<HW_BREAKPOINT_R>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1061
+#: build/C/man2/perf_event_open.2:1089
msgid "Count when we read the memory location."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1061
+#: build/C/man2/perf_event_open.2:1089
#, no-wrap
msgid "B<HW_BREAKPOINT_W>"
msgstr "B<HW_BREAKPOINT_W>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1064
+#: build/C/man2/perf_event_open.2:1092
msgid "Count when we write the memory location."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1064
+#: build/C/man2/perf_event_open.2:1092
#, no-wrap
msgid "B<HW_BREAKPOINT_RW>"
msgstr "B<HW_BREAKPOINT_RW>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1067
+#: build/C/man2/perf_event_open.2:1095
msgid "Count when we read or write the memory location."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1067
+#: build/C/man2/perf_event_open.2:1095
#, no-wrap
msgid "B<HW_BREAKPOINT_X>"
msgstr "B<HW_BREAKPOINT_X>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1070
+#: build/C/man2/perf_event_open.2:1098
msgid "Count when we execute code at the memory location."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1079
+#: build/C/man2/perf_event_open.2:1107
msgid ""
"The values can be combined via a bitwise or, but the combination of "
"B<HW_BREAKPOINT_R> or B<HW_BREAKPOINT_W> with B<HW_BREAKPOINT_X> is not "
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1080
+#: build/C/man2/perf_event_open.2:1108
#, no-wrap
msgid "I<bp_addr> (since Linux 2.6.33)"
msgstr "I<bp_addr> (Linux 2.6.33 以降)"
+#. commit 24f1e32c60c45c89a997c73395b69c8af6f0a84e
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1087
+#: build/C/man2/perf_event_open.2:1116
msgid ""
"I<bp_addr> address of the breakpoint. For execution breakpoints this is the "
"memory address of the instruction of interest; for read and write "
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1087
+#: build/C/man2/perf_event_open.2:1116
#, no-wrap
msgid "I<config1> (since Linux 2.6.39)"
msgstr "I<config1> (Linux 2.6.39 以降)"
+#. commit a7e3ed1e470116c9d12c2f778431a481a6be8ab6
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1094
+#: build/C/man2/perf_event_open.2:1124
msgid ""
"I<config1> is used for setting events that need an extra register or "
"otherwise do not fit in the regular config field. Raw OFFCORE_EVENTS on "
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1094
+#: build/C/man2/perf_event_open.2:1124
#, no-wrap
msgid "I<bp_len> (since Linux 2.6.33)"
msgstr "I<bp_len> (Linux 2.6.33 以降)"
+#. commit 24f1e32c60c45c89a997c73395b69c8af6f0a84e
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1108
+#: build/C/man2/perf_event_open.2:1139
msgid ""
"I<bp_len> is the length of the breakpoint being measured if I<type> is "
"B<PERF_TYPE_BREAKPOINT>. Options are B<HW_BREAKPOINT_LEN_1>, "
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1108
+#: build/C/man2/perf_event_open.2:1139
#, no-wrap
msgid "I<config2> (since Linux 2.6.39)"
msgstr "I<config2> (Linux 2.6.39 以降)"
+#. commit a7e3ed1e470116c9d12c2f778431a481a6be8ab6
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1115
+#: build/C/man2/perf_event_open.2:1147
msgid "I<config2> is a further extension of the I<config1> field."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1115
+#: build/C/man2/perf_event_open.2:1147
#, no-wrap
msgid "I<branch_sample_type> (since Linux 3.4)"
msgstr "I<branch_sample_type> (Linux 3.4 以降)"
+#. commit bce38cd53e5ddba9cb6d708c4ef3d04a4016ec7e
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1121
+#: build/C/man2/perf_event_open.2:1154
msgid ""
"If B<PERF_SAMPLE_BRANCH_STACK> is enabled, then this specifies what branches "
"to include in the branch record."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1127
+#: build/C/man2/perf_event_open.2:1160
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 "
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1128
+#: build/C/man2/perf_event_open.2:1161
#, no-wrap
msgid "B<PERF_SAMPLE_BRANCH_USER>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1131
+#: build/C/man2/perf_event_open.2:1164
msgid "Branch target is in user space."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1131
+#: build/C/man2/perf_event_open.2:1164
#, no-wrap
msgid "B<PERF_SAMPLE_BRANCH_KERNEL>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1134
+#: build/C/man2/perf_event_open.2:1167
msgid "Branch target is in kernel space."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1134
+#: build/C/man2/perf_event_open.2:1167
#, no-wrap
msgid "B<PERF_SAMPLE_BRANCH_HV>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1137
+#: build/C/man2/perf_event_open.2:1170
msgid "Branch target is in hypervisor."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1137
+#: build/C/man2/perf_event_open.2:1170
#, no-wrap
msgid "B<PERF_SAMPLE_BRANCH_PLM_ALL>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1140
+#: build/C/man2/perf_event_open.2:1173
msgid "A convenience value that is the three preceding values ORed together."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1144
+#: build/C/man2/perf_event_open.2:1177
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:1145
+#: build/C/man2/perf_event_open.2:1178
#, no-wrap
msgid "B<PERF_SAMPLE_BRANCH_ANY>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1148
+#: build/C/man2/perf_event_open.2:1181
msgid "Any branch type."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1148
+#: build/C/man2/perf_event_open.2:1181
#, no-wrap
msgid "B<PERF_SAMPLE_BRANCH_ANY_CALL>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1151
+#: build/C/man2/perf_event_open.2:1184
msgid "Any call branch."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1151
+#: build/C/man2/perf_event_open.2:1184
#, no-wrap
msgid "B<PERF_SAMPLE_BRANCH_ANY_RETURN>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1154
+#: build/C/man2/perf_event_open.2:1187
msgid "Any return branch."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1154
+#: build/C/man2/perf_event_open.2:1187
#, no-wrap
msgid "B<PERF_SAMPLE_BRANCH_IND_CALL>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1157
+#: build/C/man2/perf_event_open.2:1190
msgid "Indirect calls."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1157
+#: build/C/man2/perf_event_open.2:1190
#, no-wrap
msgid "B<PERF_SAMPLE_BRANCH_COND> (since Linux 3.16)"
msgstr "B<PERF_SAMPLE_BRANCH_COND> (Linux 3.16 以降)"
#. commit bac52139f0b7ab31330e98fd87fc5a2664951050
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1161
+#: build/C/man2/perf_event_open.2:1194
msgid "Conditional branches."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1161
+#: build/C/man2/perf_event_open.2:1194
#, no-wrap
msgid "B<PERF_SAMPLE_BRANCH_ABORT_TX> (since Linux 3.11)"
msgstr "B<PERF_SAMPLE_BRANCH_ABORT_TX> (Linux 3.11 以降)"
#. commit 135c5612c460f89657c4698fe2ea753f6f667963
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1165
+#: build/C/man2/perf_event_open.2:1198
msgid "Transactional memory aborts."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1165
+#: build/C/man2/perf_event_open.2:1198
#, no-wrap
msgid "B<PERF_SAMPLE_BRANCH_IN_TX> (since Linux 3.11)"
msgstr "B<PERF_SAMPLE_BRANCH_IN_TX> (Linux 3.11 以降)"
#. commit 135c5612c460f89657c4698fe2ea753f6f667963
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1169
+#: build/C/man2/perf_event_open.2:1202
msgid "Branch in transactional memory transaction."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1169
+#: build/C/man2/perf_event_open.2:1202
#, no-wrap
msgid "B<PERF_SAMPLE_BRANCH_NO_TX> (since Linux 3.11)"
msgstr "B<PERF_SAMPLE_BRANCH_NO_TX> (Linux 3.11 以降)"
#. commit 135c5612c460f89657c4698fe2ea753f6f667963
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1173
+#: build/C/man2/perf_event_open.2:1206
msgid "Branch not in transactional memory transaction."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1175
+#: build/C/man2/perf_event_open.2:1208
#, no-wrap
msgid "I<sample_regs_user> (since Linux 3.7)"
msgstr "I<sample_regs_user> (Linux 3.7 以降)"
+#. commit 4018994f3d8785275ef0e7391b75c3462c029e56
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1181
+#: build/C/man2/perf_event_open.2:1215
msgid ""
"This bit mask 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:1181
+#: build/C/man2/perf_event_open.2:1215
#, no-wrap
msgid "I<sample_stack_user> (since Linux 3.7)"
msgstr "I<sample_stack_user> (Linux 3.7 以降)"
+#. commit c5ebcedb566ef17bda7b02686e0d658a7bb42ee7
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1186
+#: build/C/man2/perf_event_open.2:1221
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:1186
+#: build/C/man2/perf_event_open.2:1221
#, no-wrap
msgid "Reading results"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1196
+#: build/C/man2/perf_event_open.2:1231
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:1201
+#: build/C/man2/perf_event_open.2:1236
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:1203
+#: build/C/man2/perf_event_open.2:1238
msgid "Here is the layout of the data returned by a read:"
msgstr ""
-#. type: IP
-#: build/C/man2/perf_event_open.2:1203 build/C/man2/perf_event_open.2:1221
-#: build/C/man2/ptrace.2:1735 build/C/man2/ptrace.2:1745
-#: build/C/man2/ptrace.2:1753 build/C/man2/ptrace.2:1759
-#: build/C/man2/ptrace.2:1888 build/C/man2/splice.2:55
-#: build/C/man2/splice.2:61 build/C/man2/splice.2:70
-#, no-wrap
-msgid "*"
-msgstr "*"
-
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1207
+#: build/C/man2/perf_event_open.2:1242
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:1219
+#: build/C/man2/perf_event_open.2:1254
#, no-wrap
msgid ""
"struct read_format {\n"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1227
+#: build/C/man2/perf_event_open.2:1262
msgid "If B<PERF_FORMAT_GROUP> was I<not> specified:"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1236
+#: build/C/man2/perf_event_open.2:1271
#, no-wrap
msgid ""
"struct read_format {\n"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1240
+#: build/C/man2/perf_event_open.2:1275
msgid "The values read are as follows:"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1240
+#: build/C/man2/perf_event_open.2:1275
#, no-wrap
msgid "I<nr>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1246
+#: build/C/man2/perf_event_open.2:1281
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:1246
+#: build/C/man2/perf_event_open.2:1281
#, no-wrap
msgid "I<time_enabled>, I<time_running>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1258
+#: build/C/man2/perf_event_open.2:1293
msgid ""
"Total time the event was enabled and running. Normally these are the same. "
"If more events are started, then available counter slots on the PMU, then "
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1258
+#: build/C/man2/perf_event_open.2:1293
#, no-wrap
msgid "I<value>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1261
+#: build/C/man2/perf_event_open.2:1296
msgid "An unsigned 64-bit value containing the counter result."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1261 build/C/man2/perf_event_open.2:1690
-#: build/C/man2/perf_event_open.2:1856
+#: build/C/man2/perf_event_open.2:1296 build/C/man2/perf_event_open.2:1732
+#: build/C/man2/perf_event_open.2:1898
#, no-wrap
msgid "I<id>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1267
+#: build/C/man2/perf_event_open.2:1302
msgid ""
-"A globally unique value for this particular event, only there if "
+"A globally unique value for this particular event, only present if "
"B<PERF_FORMAT_ID> was specified in I<read_format>."
msgstr ""
#. type: SS
-#: build/C/man2/perf_event_open.2:1267
+#: build/C/man2/perf_event_open.2:1302
#, no-wrap
msgid "MMAP layout"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1277
+#: build/C/man2/perf_event_open.2:1312
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 ring-"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1283
+#: build/C/man2/perf_event_open.2:1318
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:1286
+#: build/C/man2/perf_event_open.2:1321
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:1288
+#: build/C/man2/perf_event_open.2:1323
msgid "The structure of the first metadata mmap page is as follows:"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1317
+#: build/C/man2/perf_event_open.2:1352
#, no-wrap
msgid ""
"struct perf_event_mmap_page {\n"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1323
+#: build/C/man2/perf_event_open.2:1358
msgid ""
"The following list describes the fields in the I<perf_event_mmap_page> "
"structure in more detail:"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1323
+#: build/C/man2/perf_event_open.2:1358
#, no-wrap
msgid "I<version>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1326
+#: build/C/man2/perf_event_open.2:1361
msgid "Version number of this structure."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1326
+#: build/C/man2/perf_event_open.2:1361
#, no-wrap
msgid "I<compat_version>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1329
+#: build/C/man2/perf_event_open.2:1364
msgid "The lowest version this is compatible with."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1329
+#: build/C/man2/perf_event_open.2:1364
#, no-wrap
msgid "I<lock>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1332
+#: build/C/man2/perf_event_open.2:1367
msgid "A seqlock for synchronization."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1332
+#: build/C/man2/perf_event_open.2:1367
#, no-wrap
msgid "I<index>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1335
+#: build/C/man2/perf_event_open.2:1370
msgid "A unique hardware counter identifier."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1335
+#: build/C/man2/perf_event_open.2:1370
#, no-wrap
msgid "I<offset>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1340
+#: build/C/man2/perf_event_open.2:1375
msgid ""
"When using rdpmc for reads this offset value must be added to the one "
"returned by rdpmc to get the current total event count."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1340
+#: build/C/man2/perf_event_open.2:1375
#, no-wrap
msgid "I<time_enabled>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1343
+#: build/C/man2/perf_event_open.2:1378
msgid "Time the event was active."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1343
+#: build/C/man2/perf_event_open.2:1378
#, no-wrap
msgid "I<time_running>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1346
+#: build/C/man2/perf_event_open.2:1381
msgid "Time the event was running."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1346
+#: build/C/man2/perf_event_open.2:1381
#, no-wrap
msgid "I<cap_usr_time> / I<cap_usr_rdpmc> / I<cap_bit0> (since Linux 3.4)"
msgstr ""
+#. commit c7206205d00ab375839bd6c7ddb247d600693c09
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1359
+#: build/C/man2/perf_event_open.2:1395
msgid ""
"There was a bug in the definition of I<cap_usr_time> and I<cap_usr_rdpmc> "
"from Linux 3.4 until Linux 3.11. Both bits were defined to point to the "
"I<cap_usr_rdpmc> were actually set."
msgstr ""
+#. commit fa7315871046b9a4c48627905691dbde57e51033
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1367
+#: build/C/man2/perf_event_open.2:1404
msgid ""
"Starting with Linux 3.12, these are renamed to I<cap_bit0> and you should "
"use the I<cap_user_time> and I<cap_user_rdpmc> fields instead."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1368
+#: build/C/man2/perf_event_open.2:1405
#, no-wrap
msgid "I<cap_bit0_is_deprecated> (since Linux 3.12)"
msgstr "I<cap_bit0_is_deprecated> (Linux 3.12 以降)"
+#. commit fa7315871046b9a4c48627905691dbde57e51033
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1376
+#: build/C/man2/perf_event_open.2:1414
msgid ""
"If set, this bit indicates that the kernel supports the properly separated "
"I<cap_user_time> and I<cap_user_rdpmc> bits."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1383
+#: build/C/man2/perf_event_open.2:1421
msgid ""
"If not-set, it indicates an older kernel where I<cap_usr_time> and "
"I<cap_usr_rdpmc> map to the same bit and thus both features should be used "
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1384
+#: build/C/man2/perf_event_open.2:1422
#, no-wrap
msgid "I<cap_user_rdpmc> (since Linux 3.12)"
msgstr "I<cap_user_rdpmc> (Linux 3.12 以降)"
+#. commit fa7315871046b9a4c48627905691dbde57e51033
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1389
+#: build/C/man2/perf_event_open.2:1428
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:1395
+#: build/C/man2/perf_event_open.2:1434
#, no-wrap
msgid ""
"u32 seq, time_mult, time_shift, idx, width;\n"
"u64 cyc, time_offset;\n"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1401
+#: build/C/man2/perf_event_open.2:1440
#, no-wrap
msgid ""
"do {\n"
" running = pc-E<gt>time_running;\n"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1408
+#: build/C/man2/perf_event_open.2:1447
#, no-wrap
msgid ""
" if (pc-E<gt>cap_usr_time && enabled != running) {\n"
" }\n"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1411
+#: build/C/man2/perf_event_open.2:1450
#, no-wrap
msgid ""
" idx = pc-E<gt>index;\n"
" count = pc-E<gt>offset;\n"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1416
+#: build/C/man2/perf_event_open.2:1455
#, no-wrap
msgid ""
" if (pc-E<gt>cap_usr_rdpmc && idx) {\n"
" }\n"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1419
+#: build/C/man2/perf_event_open.2:1458
#, no-wrap
msgid ""
" barrier();\n"
"} while (pc-E<gt>lock != seq);\n"
#. type: TP
-#: build/C/man2/perf_event_open.2:1421
+#: build/C/man2/perf_event_open.2:1460
#, no-wrap
msgid "I<cap_user_time> (since Linux 3.12)"
msgstr "I<cap_user_time> (Linux 3.12 以降)"
+#. commit fa7315871046b9a4c48627905691dbde57e51033
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1425
+#: build/C/man2/perf_event_open.2:1465
msgid ""
"This bit indicates the hardware has a constant, nonstop timestamp counter "
"(TSC on x86)."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1425
+#: build/C/man2/perf_event_open.2:1465
#, no-wrap
msgid "I<cap_user_time_zero> (since Linux 3.12)"
msgstr "I<cap_user_time_zero> (Linux 3.12 以降)"
+#. commit fa7315871046b9a4c48627905691dbde57e51033
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1431
+#: build/C/man2/perf_event_open.2:1472
msgid ""
"Indicates the presence of I<time_zero> which allows mapping timestamp values "
"to the hardware clock."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1431
+#: build/C/man2/perf_event_open.2:1472
#, no-wrap
msgid "I<pmc_width>"
msgstr "I<pmc_width>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1438
+#: build/C/man2/perf_event_open.2:1479
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:1444
+#: build/C/man2/perf_event_open.2:1485
#, no-wrap
msgid ""
"pmc E<lt>E<lt>= 64 - pmc_width;\n"
"count += pmc;\n"
#. type: TP
-#: build/C/man2/perf_event_open.2:1446
+#: build/C/man2/perf_event_open.2:1487
#, no-wrap
msgid "I<time_shift>, I<time_mult>, I<time_offset>"
msgstr "I<time_shift>, I<time_mult>, I<time_offset>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1453
+#: build/C/man2/perf_event_open.2:1494
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:1461
+#: build/C/man2/perf_event_open.2:1502
#, no-wrap
msgid ""
" u64 quot, rem;\n"
" ((rem * time_mult) E<gt>E<gt> time_shift);\n"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1473
+#: build/C/man2/perf_event_open.2:1514
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:1481
+#: build/C/man2/perf_event_open.2:1522
#, no-wrap
msgid ""
" enabled += delta;\n"
" count = quot * enabled + (rem * enabled) / running;\n"
#. type: TP
-#: build/C/man2/perf_event_open.2:1482
+#: build/C/man2/perf_event_open.2:1523
#, no-wrap
msgid "I<time_zero> (since Linux 3.12)"
msgstr "I<time_zero> (Linux 3.12 以降)"
+#. commit fa7315871046b9a4c48627905691dbde57e51033
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1490
+#: build/C/man2/perf_event_open.2:1532
msgid ""
"If I<cap_usr_time_zero> is set, then the hardware clock (the TSC timestamp "
"counter on x86) can be calculated from the I<time_zero>, I<time_mult>, and "
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1496
+#: build/C/man2/perf_event_open.2:1538
#, no-wrap
msgid ""
" time = timestamp - time_zero;\n"
" cyc = (quot E<lt>E<lt> time_shift) + (rem E<lt>E<lt> time_shift) / time_mult;\n"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1499
+#: build/C/man2/perf_event_open.2:1541
msgid "And vice versa:"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1505
+#: build/C/man2/perf_event_open.2:1547
#, no-wrap
msgid ""
" quot = cyc E<gt>E<gt> time_shift;\n"
" ((rem * time_mult) E<gt>E<gt> time_shift);\n"
#. type: TP
-#: build/C/man2/perf_event_open.2:1506
+#: build/C/man2/perf_event_open.2:1548
#, no-wrap
msgid "I<data_head>"
msgstr "I<data_head>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1512
+#: build/C/man2/perf_event_open.2:1554
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:1517
+#: build/C/man2/perf_event_open.2:1559
msgid ""
"On SMP-capable platforms, after reading the I<data_head> value, user space "
"should issue an rmb()."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1517
+#: build/C/man2/perf_event_open.2:1559
#, no-wrap
msgid "I<data_tail>"
msgstr "I<data_tail>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1525
+#: build/C/man2/perf_event_open.2:1567
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:1527
+#: build/C/man2/perf_event_open.2:1569
msgid "The following 2^n ring-buffer pages have the layout described below."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1541
+#: build/C/man2/perf_event_open.2:1583
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 "
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1543
+#: build/C/man2/perf_event_open.2:1585
msgid "The mmap values start with a header:"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1551
+#: build/C/man2/perf_event_open.2:1593
#, no-wrap
msgid ""
"struct perf_event_header {\n"
"};\n"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1559
+#: build/C/man2/perf_event_open.2:1601
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:1562
+#: build/C/man2/perf_event_open.2:1604
msgid "This indicates the size of the record."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1562
+#: build/C/man2/perf_event_open.2:1604
#, no-wrap
msgid "I<misc>"
msgstr "I<misc>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1567
+#: build/C/man2/perf_event_open.2:1609
msgid "The I<misc> field contains additional information about the sample."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1572
+#: build/C/man2/perf_event_open.2:1614
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 "
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1573
+#: build/C/man2/perf_event_open.2:1615
#, no-wrap
msgid "B<PERF_RECORD_MISC_CPUMODE_UNKNOWN>"
msgstr "B<PERF_RECORD_MISC_CPUMODE_UNKNOWN>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1576
+#: build/C/man2/perf_event_open.2:1618
msgid "Unknown CPU mode."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1576
+#: build/C/man2/perf_event_open.2:1618
#, no-wrap
msgid "B<PERF_RECORD_MISC_KERNEL>"
msgstr "B<PERF_RECORD_MISC_KERNEL>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1579
+#: build/C/man2/perf_event_open.2:1621
msgid "Sample happened in the kernel."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1579
+#: build/C/man2/perf_event_open.2:1621
#, no-wrap
msgid "B<PERF_RECORD_MISC_USER>"
msgstr "B<PERF_RECORD_MISC_USER>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1582
+#: build/C/man2/perf_event_open.2:1624
msgid "Sample happened in user code."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1582
+#: build/C/man2/perf_event_open.2:1624
#, no-wrap
msgid "B<PERF_RECORD_MISC_HYPERVISOR>"
msgstr "B<PERF_RECORD_MISC_HYPERVISOR>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1585
+#: build/C/man2/perf_event_open.2:1627
msgid "Sample happened in the hypervisor."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1585
-#, no-wrap
-msgid "B<PERF_RECORD_MISC_GUEST_KERNEL> (since Linux2.6.35)"
+#: build/C/man2/perf_event_open.2:1627
+#, fuzzy, no-wrap
+#| msgid "B<PERF_RECORD_MISC_GUEST_KERNEL> (since Linux2.6.35)"
+msgid "B<PERF_RECORD_MISC_GUEST_KERNEL> (since Linux 2.6.35)"
msgstr "B<PERF_RECORD_MISC_GUEST_KERNEL> (Linux 2.6.35 以降)"
#. commit 39447b386c846bbf1c56f6403c5282837486200f
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1589
+#: build/C/man2/perf_event_open.2:1631
msgid "Sample happened in the guest kernel."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1589
-#, no-wrap
-msgid "B<PERF_RECORD_MISC_GUEST_USER (since Linux2.6.35)>"
+#: build/C/man2/perf_event_open.2:1631
+#, fuzzy, no-wrap
+#| msgid "B<PERF_RECORD_MISC_GUEST_USER (since Linux2.6.35)>"
+msgid "B<PERF_RECORD_MISC_GUEST_USER (since Linux 2.6.35)>"
msgstr "B<PERF_RECORD_MISC_GUEST_USER (Linux 2.6.35 以降)>"
#. commit 39447b386c846bbf1c56f6403c5282837486200f
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1593
+#: build/C/man2/perf_event_open.2:1635
msgid "Sample happened in guest user code."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1597
+#: build/C/man2/perf_event_open.2:1639
msgid "In addition, one of the following bits can be set:"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1597
+#: build/C/man2/perf_event_open.2:1639
#, no-wrap
msgid "B<PERF_RECORD_MISC_MMAP_DATA> (since Linux 3.10)"
msgstr "B<PERF_RECORD_MISC_MMAP_DATA> (Linux 3.10 以降)"
#. commit 2fe85427e3bf65d791700d065132772fc26e4d75
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1602
+#: build/C/man2/perf_event_open.2:1644
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:1602
+#: build/C/man2/perf_event_open.2:1644
#, no-wrap
msgid "B<PERF_RECORD_MISC_COMM_EXEC> (since Linux 3.16)"
msgstr "B<PERF_RECORD_MISC_COMM_EXEC> (Linux 3.16 以降)"
#. commit 82b897782d10fcc4930c9d4a15b175348fdd2871
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1614
+#: build/C/man2/perf_event_open.2:1656
msgid ""
"This is set for a B<PERF_RECORD_COMM> record on kernels more recent than "
"Linux 3.16 if a process name change was caused by an B<exec>(2) system "
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1614
+#: build/C/man2/perf_event_open.2:1656
#, no-wrap
msgid "B<PERF_RECORD_MISC_EXACT_IP>"
msgstr "B<PERF_RECORD_MISC_EXACT_IP>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1622
+#: build/C/man2/perf_event_open.2:1664
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."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1622
+#: build/C/man2/perf_event_open.2:1664
#, no-wrap
msgid "B<PERF_RECORD_MISC_EXT_RESERVED> (since Linux 2.6.35)"
msgstr "B<PERF_RECORD_MISC_EXT_RESERVED> (Linux 2.6.35 以降)"
#. commit 1676b8a077c352085d52578fb4f29350b58b6e74
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1626
+#: build/C/man2/perf_event_open.2:1668
msgid "This indicates there is extended data available (currently not used)."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1636
+#: build/C/man2/perf_event_open.2:1678
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:1638
+#: build/C/man2/perf_event_open.2:1680
#, no-wrap
msgid "B<PERF_RECORD_MMAP>"
msgstr "B<PERF_RECORD_MMAP>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1645
+#: build/C/man2/perf_event_open.2:1687
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:1656
+#: build/C/man2/perf_event_open.2:1698
#, no-wrap
msgid ""
"struct {\n"
"};\n"
#. type: TP
-#: build/C/man2/perf_event_open.2:1659 build/C/man2/perf_event_open.2:1713
-#: build/C/man2/perf_event_open.2:2232
+#: build/C/man2/perf_event_open.2:1701 build/C/man2/perf_event_open.2:1755
+#: build/C/man2/perf_event_open.2:2276
#, no-wrap
msgid "I<pid>"
msgstr "I<pid>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1662 build/C/man2/perf_event_open.2:1716
-#: build/C/man2/perf_event_open.2:2235
+#: build/C/man2/perf_event_open.2:1704 build/C/man2/perf_event_open.2:1758
+#: build/C/man2/perf_event_open.2:2279
msgid "is the process ID."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1662 build/C/man2/perf_event_open.2:1716
-#: build/C/man2/perf_event_open.2:2235
+#: build/C/man2/perf_event_open.2:1704 build/C/man2/perf_event_open.2:1758
+#: build/C/man2/perf_event_open.2:2279
#, no-wrap
msgid "I<tid>"
msgstr "I<tid>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1665 build/C/man2/perf_event_open.2:1719
-#: build/C/man2/perf_event_open.2:2238
+#: build/C/man2/perf_event_open.2:1707 build/C/man2/perf_event_open.2:1761
+#: build/C/man2/perf_event_open.2:2282
msgid "is the thread ID."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1665 build/C/man2/perf_event_open.2:1849
-#: build/C/man2/perf_event_open.2:2238
+#: build/C/man2/perf_event_open.2:1707 build/C/man2/perf_event_open.2:1891
+#: build/C/man2/perf_event_open.2:2282
#, no-wrap
msgid "I<addr>"
msgstr "I<addr>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1674
+#: build/C/man2/perf_event_open.2:1716
msgid ""
"is the address of the allocated memory. I<len> is the length of the "
"allocated memory. I<pgoff> is the page offset of the allocated memory. "
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1675
+#: build/C/man2/perf_event_open.2:1717
#, no-wrap
msgid "B<PERF_RECORD_LOST>"
msgstr "B<PERF_RECORD_LOST>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1678
+#: build/C/man2/perf_event_open.2:1720
msgid "This record indicates when events are lost."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1687
+#: build/C/man2/perf_event_open.2:1729
#, no-wrap
msgid ""
"struct {\n"
"};\n"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1693
+#: build/C/man2/perf_event_open.2:1735
msgid "is the unique event ID for the samples that were lost."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1693
+#: build/C/man2/perf_event_open.2:1735
#, no-wrap
msgid "I<lost>"
msgstr "I<lost>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1696
+#: build/C/man2/perf_event_open.2:1738
msgid "is the number of events that were lost."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1697
+#: build/C/man2/perf_event_open.2:1739
#, no-wrap
msgid "B<PERF_RECORD_COMM>"
msgstr "B<PERF_RECORD_COMM>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1700
+#: build/C/man2/perf_event_open.2:1742
msgid "This record indicates a change in the process name."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1710
+#: build/C/man2/perf_event_open.2:1752
#, no-wrap
msgid ""
"struct {\n"
"};\n"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1722
+#: build/C/man2/perf_event_open.2:1764
msgid "is a string containing the new name of the process."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1723
+#: build/C/man2/perf_event_open.2:1765
#, no-wrap
msgid "B<PERF_RECORD_EXIT>"
msgstr "B<PERF_RECORD_EXIT>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1726
+#: build/C/man2/perf_event_open.2:1768
msgid "This record indicates a process exit event."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1736 build/C/man2/perf_event_open.2:1766
+#: build/C/man2/perf_event_open.2:1778 build/C/man2/perf_event_open.2:1808
#, no-wrap
msgid ""
"struct {\n"
"};\n"
#. type: TP
-#: build/C/man2/perf_event_open.2:1738
+#: build/C/man2/perf_event_open.2:1780
#, no-wrap
msgid "B<PERF_RECORD_THROTTLE>, B<PERF_RECORD_UNTHROTTLE>"
msgstr "B<PERF_RECORD_THROTTLE>, B<PERF_RECORD_UNTHROTTLE>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1741
+#: build/C/man2/perf_event_open.2:1783
msgid "This record indicates a throttle/unthrottle event."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1751
+#: build/C/man2/perf_event_open.2:1793
#, no-wrap
msgid ""
"struct {\n"
"};\n"
#. type: TP
-#: build/C/man2/perf_event_open.2:1753
+#: build/C/man2/perf_event_open.2:1795
#, no-wrap
msgid "B<PERF_RECORD_FORK>"
msgstr "B<PERF_RECORD_FORK>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1756
+#: build/C/man2/perf_event_open.2:1798
msgid "This record indicates a fork event."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1768
+#: build/C/man2/perf_event_open.2:1810
#, no-wrap
msgid "B<PERF_RECORD_READ>"
msgstr "B<PERF_RECORD_READ>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1771
+#: build/C/man2/perf_event_open.2:1813
msgid "This record indicates a read event."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1780
+#: build/C/man2/perf_event_open.2:1822
#, no-wrap
msgid ""
"struct {\n"
"};\n"
#. type: TP
-#: build/C/man2/perf_event_open.2:1782
+#: build/C/man2/perf_event_open.2:1824
#, no-wrap
msgid "B<PERF_RECORD_SAMPLE>"
msgstr "B<PERF_RECORD_SAMPLE>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1785
+#: build/C/man2/perf_event_open.2:1827
msgid "This record indicates a sample."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1817
+#: build/C/man2/perf_event_open.2:1859
#, no-wrap
msgid ""
"struct {\n"
"};\n"
#. type: TP
-#: build/C/man2/perf_event_open.2:1819
+#: build/C/man2/perf_event_open.2:1861
#, no-wrap
msgid "I<sample_id>"
msgstr "I<sample_id>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1829
+#: build/C/man2/perf_event_open.2:1871
msgid ""
"If B<PERF_SAMPLE_IDENTIFIER> is enabled, a 64-bit unique ID is included. "
"This is a duplication of the B<PERF_SAMPLE_ID> I<id> value, but included at "
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1829
+#: build/C/man2/perf_event_open.2:1871
#, no-wrap
msgid "I<ip>"
msgstr "I<ip>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1835
+#: build/C/man2/perf_event_open.2:1877
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:1835
+#: build/C/man2/perf_event_open.2:1877
#, no-wrap
msgid "I<pid>, I<tid>"
msgstr "I<pid>, I<tid>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1841
+#: build/C/man2/perf_event_open.2:1883
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:1841
+#: build/C/man2/perf_event_open.2:1883
#, no-wrap
msgid "I<time>"
msgstr "I<time>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1849
+#: build/C/man2/perf_event_open.2:1891
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: Plain text
-#: build/C/man2/perf_event_open.2:1856
+#: build/C/man2/perf_event_open.2:1898
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:1864
+#: build/C/man2/perf_event_open.2:1906
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:1864
+#: build/C/man2/perf_event_open.2:1906
#, no-wrap
msgid "I<stream_id>"
msgstr "I<stream_id>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1874
+#: build/C/man2/perf_event_open.2:1916
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:1874
+#: build/C/man2/perf_event_open.2:1916
#, no-wrap
msgid "I<cpu>, I<res>"
msgstr "I<cpu>, I<res>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1881
+#: build/C/man2/perf_event_open.2:1923
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:1881
+#: build/C/man2/perf_event_open.2:1923
#, no-wrap
msgid "I<period>"
msgstr "I<period>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1887
+#: build/C/man2/perf_event_open.2:1929
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:1887
+#: build/C/man2/perf_event_open.2:1929
#, no-wrap
msgid "I<v>"
msgstr "I<v>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1898
+#: build/C/man2/perf_event_open.2:1940
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:1898
+#: build/C/man2/perf_event_open.2:1940
#, no-wrap
msgid "I<nr>, I<ips[nr]>"
msgstr "I<nr>, I<ips[nr]>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1906
+#: build/C/man2/perf_event_open.2:1948
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:1906
+#: build/C/man2/perf_event_open.2:1948
#, no-wrap
msgid "I<size>, I<data[size]>"
msgstr "I<size>, I<data[size]>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1913
+#: build/C/man2/perf_event_open.2:1955
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:1918
+#: build/C/man2/perf_event_open.2:1960
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:1918
+#: build/C/man2/perf_event_open.2:1960
#, no-wrap
msgid "I<bnr>, I<lbr[bnr]>"
msgstr "I<bnr>, I<lbr[bnr]>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1927
+#: build/C/man2/perf_event_open.2:1969
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:1928
+#: build/C/man2/perf_event_open.2:1970
#, no-wrap
msgid "I<from>"
msgstr "I<from>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1931
+#: build/C/man2/perf_event_open.2:1973
msgid "This indicates the source instruction (may not be a branch)."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1931
+#: build/C/man2/perf_event_open.2:1973
#, no-wrap
msgid "I<to>"
msgstr "I<to>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1934
+#: build/C/man2/perf_event_open.2:1976
msgid "The branch target."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1934
+#: build/C/man2/perf_event_open.2:1976
#, no-wrap
msgid "I<mispred>"
msgstr "I<mispred>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1937
+#: build/C/man2/perf_event_open.2:1979
msgid "The branch target was mispredicted."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1937
+#: build/C/man2/perf_event_open.2:1979
#, no-wrap
msgid "I<predicted>"
msgstr "I<predicted>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1940
+#: build/C/man2/perf_event_open.2:1982
msgid "The branch target was predicted."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1940
+#: build/C/man2/perf_event_open.2:1982
#, no-wrap
msgid "I<in_tx> (since Linux 3.11)"
msgstr "I<in_tx> (Linux 3.11 以降)"
+#. commit 135c5612c460f89657c4698fe2ea753f6f667963
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1943
+#: build/C/man2/perf_event_open.2:1986
msgid "The branch was in a transactional memory transaction."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:1943
+#: build/C/man2/perf_event_open.2:1986
#, no-wrap
msgid "I<abort> (since Linux 3.11)"
msgstr "I<abort> (Linux 3.11 以降)"
+#. commit 135c5612c460f89657c4698fe2ea753f6f667963
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1946
+#: build/C/man2/perf_event_open.2:1990
msgid "The branch was in an aborted transactional memory transaction."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1950
+#: build/C/man2/perf_event_open.2:1994
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:1957
+#: build/C/man2/perf_event_open.2:2001
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:1961
+#: build/C/man2/perf_event_open.2:2005
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:1963
+#: build/C/man2/perf_event_open.2:2007
#, no-wrap
msgid "I<abi>, I<regs[weight(mask)]>"
msgstr "I<abi>, I<regs[weight(mask)]>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:1968
+#: build/C/man2/perf_event_open.2:2012
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:1974
+#: build/C/man2/perf_event_open.2:2018
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:1984
+#: build/C/man2/perf_event_open.2:2028
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:1984
+#: build/C/man2/perf_event_open.2:2028
#, no-wrap
msgid "I<size>, I<data[size]>, I<dyn_size>"
msgstr "I<size>, I<data[size]>, I<dyn_size>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2000
+#: build/C/man2/perf_event_open.2:2044
msgid ""
"If B<PERF_SAMPLE_STACK_USER> is enabled, then the user stack is recorded. "
"This can be used to generate stack backtraces. I<size> is the size "
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2000
+#: build/C/man2/perf_event_open.2:2044
#, no-wrap
msgid "I<weight>"
msgstr "I<weight>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2008
+#: build/C/man2/perf_event_open.2:2052
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:2008
+#: build/C/man2/perf_event_open.2:2052
#, no-wrap
msgid "I<data_src>"
msgstr "I<data_src>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2014
+#: build/C/man2/perf_event_open.2:2058
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:2015
+#: build/C/man2/perf_event_open.2:2059
#, no-wrap
msgid "I<mem_op>"
msgstr "I<mem_op>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2018
+#: build/C/man2/perf_event_open.2:2062
msgid "Type of opcode, a bitwise combination of:"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2021
+#: build/C/man2/perf_event_open.2:2065
#, no-wrap
msgid "B<PERF_MEM_OP_NA>"
msgstr "B<PERF_MEM_OP_NA>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2024 build/C/man2/perf_event_open.2:2049
-#: build/C/man2/perf_event_open.2:2100 build/C/man2/perf_event_open.2:2124
-#: build/C/man2/perf_event_open.2:2140
+#: build/C/man2/perf_event_open.2:2068 build/C/man2/perf_event_open.2:2093
+#: build/C/man2/perf_event_open.2:2144 build/C/man2/perf_event_open.2:2168
+#: build/C/man2/perf_event_open.2:2184
msgid "Not available"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2024
+#: build/C/man2/perf_event_open.2:2068
#, no-wrap
msgid "B<PERF_MEM_OP_LOAD>"
msgstr "B<PERF_MEM_OP_LOAD>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2027
+#: build/C/man2/perf_event_open.2:2071
msgid "Load instruction"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2027
+#: build/C/man2/perf_event_open.2:2071
#, no-wrap
msgid "B<PERF_MEM_OP_STORE>"
msgstr "B<PERF_MEM_OP_STORE>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2030
+#: build/C/man2/perf_event_open.2:2074
msgid "Store instruction"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2030
+#: build/C/man2/perf_event_open.2:2074
#, no-wrap
msgid "B<PERF_MEM_OP_PFETCH>"
msgstr "B<PERF_MEM_OP_PFETCH>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2033
+#: build/C/man2/perf_event_open.2:2077
msgid "Prefetch"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2033
+#: build/C/man2/perf_event_open.2:2077
#, no-wrap
msgid "B<PERF_MEM_OP_EXEC>"
msgstr "B<PERF_MEM_OP_EXEC>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2036
+#: build/C/man2/perf_event_open.2:2080
msgid "Executable code"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2038
+#: build/C/man2/perf_event_open.2:2082
#, no-wrap
msgid "I<mem_lvl>"
msgstr "I<mem_lvl>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2043
+#: build/C/man2/perf_event_open.2:2087
msgid ""
"Memory hierarchy level hit or miss, a bitwise combination of the following, "
"shifted left by B<PERF_MEM_LVL_SHIFT>:"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2046
+#: build/C/man2/perf_event_open.2:2090
#, no-wrap
msgid "B<PERF_MEM_LVL_NA>"
msgstr "B<PERF_MEM_LVL_NA>"
#. type: TP
-#: build/C/man2/perf_event_open.2:2049
+#: build/C/man2/perf_event_open.2:2093
#, no-wrap
msgid "B<PERF_MEM_LVL_HIT>"
msgstr "B<PERF_MEM_LVL_HIT>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2052 build/C/man2/perf_event_open.2:2143
+#: build/C/man2/perf_event_open.2:2096 build/C/man2/perf_event_open.2:2187
msgid "Hit"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2052
+#: build/C/man2/perf_event_open.2:2096
#, no-wrap
msgid "B<PERF_MEM_LVL_MISS>"
msgstr "B<PERF_MEM_LVL_MISS>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2055 build/C/man2/perf_event_open.2:2146
+#: build/C/man2/perf_event_open.2:2099 build/C/man2/perf_event_open.2:2190
msgid "Miss"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2055
+#: build/C/man2/perf_event_open.2:2099
#, no-wrap
msgid "B<PERF_MEM_LVL_L1>"
msgstr "B<PERF_MEM_LVL_L1>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2058
+#: build/C/man2/perf_event_open.2:2102
msgid "Level 1 cache"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2058
+#: build/C/man2/perf_event_open.2:2102
#, no-wrap
msgid "B<PERF_MEM_LVL_LFB>"
msgstr "B<PERF_MEM_LVL_LFB>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2061
+#: build/C/man2/perf_event_open.2:2105
msgid "Line fill buffer"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2061
+#: build/C/man2/perf_event_open.2:2105
#, no-wrap
msgid "B<PERF_MEM_LVL_L2>"
msgstr "B<PERF_MEM_LVL_L2>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2064
+#: build/C/man2/perf_event_open.2:2108
msgid "Level 2 cache"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2064
+#: build/C/man2/perf_event_open.2:2108
#, no-wrap
msgid "B<PERF_MEM_LVL_L3>"
msgstr "B<PERF_MEM_LVL_L3>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2067
+#: build/C/man2/perf_event_open.2:2111
msgid "Level 3 cache"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2067
+#: build/C/man2/perf_event_open.2:2111
#, no-wrap
msgid "B<PERF_MEM_LVL_LOC_RAM>"
msgstr "B<PERF_MEM_LVL_LOC_RAM>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2070
+#: build/C/man2/perf_event_open.2:2114
msgid "Local DRAM"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2070
+#: build/C/man2/perf_event_open.2:2114
#, no-wrap
msgid "B<PERF_MEM_LVL_REM_RAM1>"
msgstr "B<PERF_MEM_LVL_REM_RAM1>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2073
+#: build/C/man2/perf_event_open.2:2117
msgid "Remote DRAM 1 hop"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2073
+#: build/C/man2/perf_event_open.2:2117
#, no-wrap
msgid "B<PERF_MEM_LVL_REM_RAM2>"
msgstr "B<PERF_MEM_LVL_REM_RAM2>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2076
+#: build/C/man2/perf_event_open.2:2120
msgid "Remote DRAM 2 hops"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2076
+#: build/C/man2/perf_event_open.2:2120
#, no-wrap
msgid "B<PERF_MEM_LVL_REM_CCE1>"
msgstr "B<PERF_MEM_LVL_REM_CCE1>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2079
+#: build/C/man2/perf_event_open.2:2123
msgid "Remote cache 1 hop"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2079
+#: build/C/man2/perf_event_open.2:2123
#, no-wrap
msgid "B<PERF_MEM_LVL_REM_CCE2>"
msgstr "B<PERF_MEM_LVL_REM_CCE2>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2082
+#: build/C/man2/perf_event_open.2:2126
msgid "Remote cache 2 hops"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2082
+#: build/C/man2/perf_event_open.2:2126
#, no-wrap
msgid "B<PERF_MEM_LVL_IO>"
msgstr "B<PERF_MEM_LVL_IO>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2085
+#: build/C/man2/perf_event_open.2:2129
msgid "I/O memory"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2085
+#: build/C/man2/perf_event_open.2:2129
#, no-wrap
msgid "B<PERF_MEM_LVL_UNC>"
msgstr "B<PERF_MEM_LVL_UNC>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2088
+#: build/C/man2/perf_event_open.2:2132
msgid "Uncached memory"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2090
+#: build/C/man2/perf_event_open.2:2134
#, no-wrap
msgid "I<mem_snoop>"
msgstr "I<mem_snoop>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2094
+#: build/C/man2/perf_event_open.2:2138
msgid ""
"Snoop mode, a bitwise combination of the following, shifted left by "
"B<PERF_MEM_SNOOP_SHIFT>:"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2097
+#: build/C/man2/perf_event_open.2:2141
#, no-wrap
msgid "B<PERF_MEM_SNOOP_NA>"
msgstr "B<PERF_MEM_SNOOP_NA>"
#. type: TP
-#: build/C/man2/perf_event_open.2:2100
+#: build/C/man2/perf_event_open.2:2144
#, no-wrap
msgid "B<PERF_MEM_SNOOP_NONE>"
msgstr "B<PERF_MEM_SNOOP_NONE>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2103
+#: build/C/man2/perf_event_open.2:2147
msgid "No snoop"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2103
+#: build/C/man2/perf_event_open.2:2147
#, no-wrap
msgid "B<PERF_MEM_SNOOP_HIT>"
msgstr "B<PERF_MEM_SNOOP_HIT>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2106
+#: build/C/man2/perf_event_open.2:2150
msgid "Snoop hit"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2106
+#: build/C/man2/perf_event_open.2:2150
#, no-wrap
msgid "B<PERF_MEM_SNOOP_MISS>"
msgstr "B<PERF_MEM_SNOOP_MISS>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2109
+#: build/C/man2/perf_event_open.2:2153
msgid "Snoop miss"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2109
+#: build/C/man2/perf_event_open.2:2153
#, no-wrap
msgid "B<PERF_MEM_SNOOP_HITM>"
msgstr "B<PERF_MEM_SNOOP_HITM>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2112
+#: build/C/man2/perf_event_open.2:2156
msgid "Snoop hit modified"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2114
+#: build/C/man2/perf_event_open.2:2158
#, no-wrap
msgid "I<mem_lock>"
msgstr "I<mem_lock>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2118
+#: build/C/man2/perf_event_open.2:2162
msgid ""
"Lock instruction, a bitwise combination of the following, shifted left by "
"B<PERF_MEM_LOCK_SHIFT>:"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2121
+#: build/C/man2/perf_event_open.2:2165
#, no-wrap
msgid "B<PERF_MEM_LOCK_NA>"
msgstr "B<PERF_MEM_LOCK_NA>"
#. type: TP
-#: build/C/man2/perf_event_open.2:2124
+#: build/C/man2/perf_event_open.2:2168
#, no-wrap
msgid "B<PERF_MEM_LOCK_LOCKED>"
msgstr "B<PERF_MEM_LOCK_LOCKED>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2127
+#: build/C/man2/perf_event_open.2:2171
msgid "Locked transaction"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2129
+#: build/C/man2/perf_event_open.2:2173
#, no-wrap
msgid "I<mem_dtlb>"
msgstr "I<mem_dtlb>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2134
+#: build/C/man2/perf_event_open.2:2178
msgid ""
"TLB access hit or miss, a bitwise combination of the following, shifted left "
"by B<PERF_MEM_TLB_SHIFT>:"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2137
+#: build/C/man2/perf_event_open.2:2181
#, no-wrap
msgid "B<PERF_MEM_TLB_NA>"
msgstr "B<PERF_MEM_TLB_NA>"
#. type: TP
-#: build/C/man2/perf_event_open.2:2140
+#: build/C/man2/perf_event_open.2:2184
#, no-wrap
msgid "B<PERF_MEM_TLB_HIT>"
msgstr "B<PERF_MEM_TLB_HIT>"
#. type: TP
-#: build/C/man2/perf_event_open.2:2143
+#: build/C/man2/perf_event_open.2:2187
#, no-wrap
msgid "B<PERF_MEM_TLB_MISS>"
msgstr "B<PERF_MEM_TLB_MISS>"
#. type: TP
-#: build/C/man2/perf_event_open.2:2146
+#: build/C/man2/perf_event_open.2:2190
#, no-wrap
msgid "B<PERF_MEM_TLB_L1>"
msgstr "B<PERF_MEM_TLB_L1>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2149
+#: build/C/man2/perf_event_open.2:2193
msgid "Level 1 TLB"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2149
+#: build/C/man2/perf_event_open.2:2193
#, no-wrap
msgid "B<PERF_MEM_TLB_L2>"
msgstr "B<PERF_MEM_TLB_L2>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2152
+#: build/C/man2/perf_event_open.2:2196
msgid "Level 2 TLB"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2152
+#: build/C/man2/perf_event_open.2:2196
#, no-wrap
msgid "B<PERF_MEM_TLB_WK>"
msgstr "B<PERF_MEM_TLB_WK>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2155
+#: build/C/man2/perf_event_open.2:2199
msgid "Hardware walker"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2155
+#: build/C/man2/perf_event_open.2:2199
#, no-wrap
msgid "B<PERF_MEM_TLB_OS>"
msgstr "B<PERF_MEM_TLB_OS>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2158
+#: build/C/man2/perf_event_open.2:2202
msgid "OS fault handler"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2161
+#: build/C/man2/perf_event_open.2:2205
#, no-wrap
msgid "I<transaction>"
msgstr "I<transaction>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2167
+#: build/C/man2/perf_event_open.2:2211
msgid ""
"If the B<PERF_SAMPLE_TRANSACTION> flag is set, then a 64-bit field is "
"recorded describing the sources of any transactional memory aborts."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2169
+#: build/C/man2/perf_event_open.2:2213
msgid "The field is a bitwise combination of the following values:"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2170
+#: build/C/man2/perf_event_open.2:2214
#, no-wrap
msgid "B<PERF_TXN_ELISION>"
msgstr "B<PERF_TXN_ELISION>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2173
+#: build/C/man2/perf_event_open.2:2217
msgid "Abort from an elision type transaction (Intel-CPU-specific)."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2173
+#: build/C/man2/perf_event_open.2:2217
#, no-wrap
msgid "B<PERF_TXN_TRANSACTION>"
msgstr "B<PERF_TXN_TRANSACTION>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2176
+#: build/C/man2/perf_event_open.2:2220
msgid "Abort from a generic transaction."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2176
+#: build/C/man2/perf_event_open.2:2220
#, no-wrap
msgid "B<PERF_TXN_SYNC>"
msgstr "B<PERF_TXN_SYNC>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2179
+#: build/C/man2/perf_event_open.2:2223
msgid "Synchronous abort (related to the reported instruction)."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2179
+#: build/C/man2/perf_event_open.2:2223
#, no-wrap
msgid "B<PERF_TXN_ASYNC>"
msgstr "B<PERF_TXN_ASYNC>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2182
+#: build/C/man2/perf_event_open.2:2226
msgid "Asynchronous abort (not related to the reported instruction)."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2182
+#: build/C/man2/perf_event_open.2:2226
#, no-wrap
msgid "B<PERF_TXN_RETRY>"
msgstr "B<PERF_TXN_RETRY>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2185
+#: build/C/man2/perf_event_open.2:2229
msgid "Retryable abort (retrying the transaction may have succeeded)."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2185
+#: build/C/man2/perf_event_open.2:2229
#, no-wrap
msgid "B<PERF_TXN_CONFLICT>"
msgstr "B<PERF_TXN_CONFLICT>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2188
+#: build/C/man2/perf_event_open.2:2232
msgid "Abort due to memory conflicts with other threads."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2188
+#: build/C/man2/perf_event_open.2:2232
#, no-wrap
msgid "B<PERF_TXN_CAPACITY_WRITE>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2191
+#: build/C/man2/perf_event_open.2:2235
msgid "Abort due to write capacity overflow."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2191
+#: build/C/man2/perf_event_open.2:2235
#, no-wrap
msgid "B<PERF_TXN_CAPACITY_READ>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2194
+#: build/C/man2/perf_event_open.2:2238
msgid "Abort due to read capacity overflow."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2201
+#: build/C/man2/perf_event_open.2:2245
msgid ""
"In addition, a user-specified abort code can be obtained from the high 32 "
"bits of the field by shifting right by B<PERF_TXN_ABORT_SHIFT> and masking "
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2202
+#: build/C/man2/perf_event_open.2:2246
#, no-wrap
msgid "B<PERF_RECORD_MMAP2>"
msgstr "B<PERF_RECORD_MMAP2>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2211
+#: build/C/man2/perf_event_open.2:2255
msgid ""
"This record includes extended information on B<mmap>(2) calls returning "
"executable mappings. The format is similar to that of the "
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2230
+#: build/C/man2/perf_event_open.2:2274
#, no-wrap
msgid ""
"struct {\n"
"};\n"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2241
+#: build/C/man2/perf_event_open.2:2285
msgid "is the address of the allocated memory."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2241
+#: build/C/man2/perf_event_open.2:2285
#, no-wrap
msgid "I<len>"
msgstr "I<len>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2244
+#: build/C/man2/perf_event_open.2:2288
msgid "is the length of the allocated memory."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2244
+#: build/C/man2/perf_event_open.2:2288
#, no-wrap
msgid "I<pgoff>"
msgstr "I<pgoff>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2247
+#: build/C/man2/perf_event_open.2:2291
msgid "is the page offset of the allocated memory."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2247
+#: build/C/man2/perf_event_open.2:2291
#, no-wrap
msgid "I<maj>"
msgstr "I<maj>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2250
+#: build/C/man2/perf_event_open.2:2294
msgid "is the major ID of the underlying device."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2250
+#: build/C/man2/perf_event_open.2:2294
#, no-wrap
msgid "I<min>"
msgstr "I<min>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2253
+#: build/C/man2/perf_event_open.2:2297
msgid "is the minor ID of the underlying device."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2253
+#: build/C/man2/perf_event_open.2:2297
#, no-wrap
msgid "I<ino>"
msgstr "I<ino>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2256
+#: build/C/man2/perf_event_open.2:2300
msgid "is the inode number."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2256
+#: build/C/man2/perf_event_open.2:2300
#, no-wrap
msgid "I<ino_generation>"
msgstr "I<ino_generation>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2259
+#: build/C/man2/perf_event_open.2:2303
msgid "is the inode generation."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2259
+#: build/C/man2/perf_event_open.2:2303
#, no-wrap
msgid "I<prot>"
msgstr "I<prot>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2262
+#: build/C/man2/perf_event_open.2:2306
msgid "is the protection information."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2262
+#: build/C/man2/perf_event_open.2:2306
#, no-wrap
msgid "I<flags>"
msgstr "I<flags>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2265
+#: build/C/man2/perf_event_open.2:2309
msgid "is the flags information."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2265
+#: build/C/man2/perf_event_open.2:2309
#, no-wrap
msgid "I<filename>"
msgstr "I<filename>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2268
+#: build/C/man2/perf_event_open.2:2312
msgid "is a string describing the backing of the allocated memory."
msgstr ""
#. type: SS
-#: build/C/man2/perf_event_open.2:2270
+#: build/C/man2/perf_event_open.2:2314
#, no-wrap
msgid "Overflow handling"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2283
+#: build/C/man2/perf_event_open.2:2327
msgid ""
"Events can be set to notify when a threshold is crossed, indicating an "
"overflow. Overflow conditions can be captured by monitoring the event file "
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2287
+#: build/C/man2/perf_event_open.2:2331
msgid ""
-"Overflows are only generated by sampling events (I<sample_period> must have "
+"Overflows are generated only by sampling events (I<sample_period> must have "
"a nonzero value)."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2289
+#: build/C/man2/perf_event_open.2:2333
msgid "There are two ways to generate overflow notifications."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2299
+#: build/C/man2/perf_event_open.2:2343
msgid ""
"The first is to set a I<wakeup_events> or I<wakeup_watermark> value that "
"will trigger if a certain number of samples or bytes have been written to "
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2311
+#: build/C/man2/perf_event_open.2:2355
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 "
"is indicated and the underlying event is disabled."
msgstr ""
+#. commit 179033b3e064d2cd3f5f9945e76b0a0f0fbf4883
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2316
+#: build/C/man2/perf_event_open.2:2361
msgid ""
"Starting with Linux 3.18, B<POLL_HUP> is indicated if the event being "
"monitored is attached to a different process and that process exits."
msgstr ""
#. type: SS
-#: build/C/man2/perf_event_open.2:2316
+#: build/C/man2/perf_event_open.2:2361
#, no-wrap
msgid "rdpmc instruction"
msgstr ""
+#. commit c7206205d00ab375839bd6c7ddb247d600693c09
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2323
+#: build/C/man2/perf_event_open.2:2369
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:2328
+#: build/C/man2/perf_event_open.2:2374
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:2328
+#: build/C/man2/perf_event_open.2:2374
#, no-wrap
msgid "perf_event ioctl calls"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2333
+#: build/C/man2/perf_event_open.2:2379
msgid "Various ioctls act on B<perf_event_open>() file descriptors:"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2333
+#: build/C/man2/perf_event_open.2:2379
#, no-wrap
msgid "B<PERF_EVENT_IOC_ENABLE>"
msgstr "B<PERF_EVENT_IOC_ENABLE>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2337
+#: build/C/man2/perf_event_open.2:2383
msgid ""
"This enables the individual event or event group specified by the file "
"descriptor argument."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2343
+#: build/C/man2/perf_event_open.2:2389
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:2343
+#: build/C/man2/perf_event_open.2:2389
#, no-wrap
msgid "B<PERF_EVENT_IOC_DISABLE>"
msgstr "B<PERF_EVENT_IOC_DISABLE>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2347
+#: build/C/man2/perf_event_open.2:2393
msgid ""
"This disables the individual counter or event group specified by the file "
"descriptor argument."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2354
+#: build/C/man2/perf_event_open.2:2400
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:2360
+#: build/C/man2/perf_event_open.2:2406
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:2360
+#: build/C/man2/perf_event_open.2:2406
#, no-wrap
msgid "B<PERF_EVENT_IOC_REFRESH>"
msgstr "B<PERF_EVENT_IOC_REFRESH>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2374
+#: build/C/man2/perf_event_open.2:2420
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:2374
+#: build/C/man2/perf_event_open.2:2420
#, no-wrap
msgid "B<PERF_EVENT_IOC_RESET>"
msgstr "B<PERF_EVENT_IOC_RESET>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2384
+#: build/C/man2/perf_event_open.2:2430
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:2390
+#: build/C/man2/perf_event_open.2:2436
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:2390
+#: build/C/man2/perf_event_open.2:2436
#, no-wrap
msgid "B<PERF_EVENT_IOC_PERIOD>"
msgstr "B<PERF_EVENT_IOC_PERIOD>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2393
+#: build/C/man2/perf_event_open.2:2439
msgid "This updates the overflow period for the event."
msgstr ""
+#. commit 3581fe0ef37ce12ac7a4f74831168352ae848edc
+#. commit bad7192b842c83e580747ca57104dd51fe08c223
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2398
+#: build/C/man2/perf_event_open.2:2447
msgid ""
-"Since Linux 3.7 (on ARM) and Linux 3.14 (all other architectures), the new "
+"Since Linux 3.7 (on ARM) and Linux 3.14 (all other architectures), the new "
"period takes effect immediately. On older kernels, the new period did not "
"take effect until after the next overflow."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2401
+#: build/C/man2/perf_event_open.2:2450
msgid ""
"The argument is a pointer to a 64-bit value containing the desired new "
"period."
msgstr ""
+#. commit ad0cf3478de8677f720ee06393b3147819568d6a
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2404
+#: build/C/man2/perf_event_open.2:2455
msgid ""
"Prior to Linux 2.6.36 this ioctl always failed due to a bug in the kernel."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2405
+#: build/C/man2/perf_event_open.2:2456
#, no-wrap
msgid "B<PERF_EVENT_IOC_SET_OUTPUT>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2410
+#: build/C/man2/perf_event_open.2:2461
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:2413
+#: build/C/man2/perf_event_open.2:2464
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:2413
+#: build/C/man2/perf_event_open.2:2464
#, no-wrap
msgid "B<PERF_EVENT_IOC_SET_FILTER> (since Linux 2.6.33)"
msgstr "B<PERF_EVENT_IOC_SET_FILTER> (Linux 2.6.33 以降)"
#. commit 6fb2915df7f0747d9044da9dbff5b46dc2e20830
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2417
+#: build/C/man2/perf_event_open.2:2468
msgid "This adds an ftrace filter to this event."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2419
+#: build/C/man2/perf_event_open.2:2470
msgid "The argument is a pointer to the desired ftrace filter."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2419
+#: build/C/man2/perf_event_open.2:2470
#, no-wrap
msgid "B<PERF_EVENT_IOC_ID> (since Linux 3.12)"
msgstr "B<PERF_EVENT_IOC_ID> (Linux 3.12 以降)"
#. commit cf4957f17f2a89984915ea808876d9c82225b862
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2423
+#: build/C/man2/perf_event_open.2:2474
msgid "This returns the event ID value for the given event file descriptor."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2426
+#: build/C/man2/perf_event_open.2:2477
msgid ""
"The argument is a pointer to a 64-bit unsigned integer to hold the result."
msgstr ""
#. type: SS
-#: build/C/man2/perf_event_open.2:2426
+#: build/C/man2/perf_event_open.2:2477
#, no-wrap
msgid "Using prctl"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2439
+#: build/C/man2/perf_event_open.2:2490
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:2439
+#: build/C/man2/perf_event_open.2:2490
#, no-wrap
msgid "perf_event related configuration files"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2442
+#: build/C/man2/perf_event_open.2:2493
msgid "Files in I</proc/sys/kernel/>"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2443
+#: build/C/man2/perf_event_open.2:2494
#, no-wrap
msgid "I</proc/sys/kernel/perf_event_paranoid>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2449
+#: build/C/man2/perf_event_open.2:2500
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:2450
+#: build/C/man2/perf_event_open.2:2501
#, no-wrap
msgid "2"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2452
-msgid "only allow user-space measurements."
+#: build/C/man2/perf_event_open.2:2503
+msgid "allow only user-space measurements."
msgstr ""
#. type: IP
-#: build/C/man2/perf_event_open.2:2452
+#: build/C/man2/perf_event_open.2:2503
#, no-wrap
msgid "1"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2454
+#: build/C/man2/perf_event_open.2:2505
msgid "allow both kernel and user measurements (default)."
msgstr ""
#. type: IP
-#: build/C/man2/perf_event_open.2:2454
+#: build/C/man2/perf_event_open.2:2505
#, no-wrap
msgid "0"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2456
+#: build/C/man2/perf_event_open.2:2507
msgid "allow access to CPU-specific data but not raw tracepoint samples."
msgstr ""
#. type: IP
-#: build/C/man2/perf_event_open.2:2456
+#: build/C/man2/perf_event_open.2:2507
#, no-wrap
msgid "-1"
msgstr "-1"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2458
+#: build/C/man2/perf_event_open.2:2509
msgid "no restrictions."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2464
+#: build/C/man2/perf_event_open.2:2515
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:2464
+#: build/C/man2/perf_event_open.2:2515
#, no-wrap
msgid "I</proc/sys/kernel/perf_event_max_sample_rate>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2473
+#: build/C/man2/perf_event_open.2:2524
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:2473
+#: build/C/man2/perf_event_open.2:2524
#, no-wrap
msgid "I</proc/sys/kernel/perf_event_mlock_kb>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2479
+#: build/C/man2/perf_event_open.2:2530
msgid ""
"Maximum number of pages an unprivileged user can B<mlock>(2). The default "
"is 516 (kB)."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2483
+#: build/C/man2/perf_event_open.2:2534
msgid "Files in I</sys/bus/event_source/devices/>"
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2489
+#: build/C/man2/perf_event_open.2:2540
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 I</"
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2489
+#: build/C/man2/perf_event_open.2:2540
#, no-wrap
msgid "I</sys/bus/event_source/devices/*/type> (since Linux 2.6.38)"
msgstr "I</sys/bus/event_source/devices/*/type> (Linux 2.6.38 以降)"
+#. commit abe43400579d5de0078c2d3a760e6598e183f871
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2496
+#: build/C/man2/perf_event_open.2:2548
msgid ""
"This contains an integer that can be used in the I<type> field of "
"I<perf_event_attr> to indicate that you wish to use this PMU."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2496
+#: build/C/man2/perf_event_open.2:2548
#, no-wrap
msgid "I</sys/bus/event_source/devices/*/rdpmc> (since Linux 3.4)"
msgstr "I</sys/bus/event_source/devices/*/rdpmc> (Linux 3.4 以降)"
+#. commit 0c9d42ed4cee2aa1dfc3a260b741baae8615744f
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2501
+#: build/C/man2/perf_event_open.2:2554
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:2501
+#: build/C/man2/perf_event_open.2:2554
#, no-wrap
msgid "I</sys/bus/event_source/devices/*/format/> (since Linux 3.4)"
msgstr "I</sys/bus/event_source/devices/*/format/> (Linux 3.4 以降)"
+#. commit 641cc938815dfd09f8fa1ec72deb814f0938ac33
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2509
+#: build/C/man2/perf_event_open.2:2563
msgid ""
"This subdirectory contains information on the architecture-specific "
"subfields available for programming the various I<config> fields in the "
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2520
+#: build/C/man2/perf_event_open.2:2574
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:2520
+#: build/C/man2/perf_event_open.2:2574
#, no-wrap
msgid "I</sys/bus/event_source/devices/*/events/> (since Linux 3.4)"
msgstr "I</sys/bus/event_source/devices/*/events/> (Linux 3.4 以降)"
+#. commit 641cc938815dfd09f8fa1ec72deb814f0938ac33
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2529
+#: build/C/man2/perf_event_open.2:2584
msgid ""
"This subdirectory contains files with predefined 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:2537
+#: build/C/man2/perf_event_open.2:2592
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 "
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2537
+#: build/C/man2/perf_event_open.2:2592
#, no-wrap
msgid "I</sys/bus/event_source/devices/*/uevent>"
msgstr "I</sys/bus/event_source/devices/*/uevent>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2541
+#: build/C/man2/perf_event_open.2:2596
msgid ""
"This file is the standard kernel device interface for injecting hotplug "
"events."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2541
+#: build/C/man2/perf_event_open.2:2596
#, no-wrap
msgid "I</sys/bus/event_source/devices/*/cpumask> (since Linux 3.7)"
msgstr "I</sys/bus/event_source/devices/*/cpumask> (Linux 3.7 以降)"
+#. commit 314d9f63f385096580e9e2a06eaa0745d92fe4ac
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2550
+#: build/C/man2/perf_event_open.2:2606
msgid ""
"The I<cpumask> file contains a comma-separated list of integers that "
"indicate a representative CPU number for each socket (package) on the "
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2557
+#: build/C/man2/perf_event_open.2:2613
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:2562
+#: build/C/man2/perf_event_open.2:2618
msgid ""
"The errors returned by B<perf_event_open>() can be inconsistent, and may "
"vary across processor architectures and performance monitoring units."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2562
+#: build/C/man2/perf_event_open.2:2618
#, no-wrap
msgid "B<E2BIG>"
msgstr "B<E2BIG>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2579
+#: build/C/man2/perf_event_open.2:2635
msgid ""
"Returned if the I<perf_event_attr> I<size> value is too small (smaller than "
"B<PERF_ATTR_SIZE_VER0>), too big (larger than the page size), or larger than "
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2593
+#: build/C/man2/perf_event_open.2:2649
msgid ""
"Returned when the requested event requires B<CAP_SYS_ADMIN> permissions (or "
"a more permissive perf_event paranoid setting). Some common cases where an "
"when the paranoid setting requires it."
msgstr ""
-#. type: TP
-#: build/C/man2/perf_event_open.2:2593 build/C/man2/sendfile.2:121
-#: build/C/man2/splice.2:157 build/C/man2/vmsplice.2:133
-#, no-wrap
-msgid "B<EBADF>"
-msgstr "B<EBADF>"
-
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2603
+#: build/C/man2/perf_event_open.2:2659
msgid ""
"Returned if the I<group_fd> file descriptor is not valid, or, if "
"B<PERF_FLAG_PID_CGROUP> is set, the cgroup file descriptor in I<pid> is not "
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2608
+#: build/C/man2/perf_event_open.2:2664
msgid "Returned if the I<attr> pointer points at an invalid memory address."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2634
+#: build/C/man2/perf_event_open.2:2690
msgid ""
"Returned if the specified event is invalid. There are many possible reasons "
"for this. A not-exhaustive list: I<sample_freq> is higher than the maximum "
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2634
+#: build/C/man2/perf_event_open.2:2690
#, no-wrap
msgid "B<EMFILE>"
msgstr "B<EMFILE>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2640
+#: build/C/man2/perf_event_open.2:2696
msgid ""
"Each opened event uses one file descriptor. If a large number of events are "
"opened the per-user file descriptor limit (often 1024) will be hit and no "
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2644
+#: build/C/man2/perf_event_open.2:2700
msgid ""
"Returned when the event involves a feature not supported by the current CPU."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2644 build/C/man2/quotactl.2:440
+#: build/C/man2/perf_event_open.2:2700 build/C/man2/quotactl.2:440
#, no-wrap
msgid "B<ENOENT>"
msgstr "B<ENOENT>"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2651
+#: build/C/man2/perf_event_open.2:2707
msgid ""
"Returned if the I<type> setting is not valid. This error is also returned "
"for some unsupported generic events."
msgstr ""
#. type: TP
-#: build/C/man2/perf_event_open.2:2651
+#: build/C/man2/perf_event_open.2:2707
#, no-wrap
msgid "B<ENOSPC>"
msgstr "B<ENOSPC>"
+#. commit aa2bc1ade59003a379ffc485d6da2d92ea3370a6
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2661
+#: build/C/man2/perf_event_open.2:2718
msgid ""
"Prior to Linux 3.3, if there was not enough room for the event, B<ENOSPC> "
"was returned. In Linux 3.3, this was changed to B<EINVAL>. B<ENOSPC> is "
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2668
+#: build/C/man2/perf_event_open.2:2725
msgid ""
"Returned if B<PERF_SAMPLE_STACK_USER> is set in I<sample_type> and it is not "
"supported by hardware."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2675
+#: build/C/man2/perf_event_open.2:2732
msgid ""
"Returned if an event requiring a specific hardware feature is requested but "
"there is no hardware support. This includes requesting low-skid events if "
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2680
+#: build/C/man2/perf_event_open.2:2737
msgid ""
"Returned on many (but not all) architectures when an unsupported "
"I<exclude_hv>, I<exclude_idle>, I<exclude_user>, or I<exclude_kernel> "
"setting is specified."
msgstr ""
+#. commit a4e95fc2cbb31d70a65beffeaf8773f881328c34
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2688
+#: build/C/man2/perf_event_open.2:2746
msgid ""
"It can also happen, as with B<EACCES>, when the requested event requires "
"B<CAP_SYS_ADMIN> permissions (or a more permissive perf_event paranoid "
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2691
+#: build/C/man2/perf_event_open.2:2749
msgid "Returned if attempting to attach to a process that does not exist."
msgstr ""
#. type: SH
-#: build/C/man2/perf_event_open.2:2691
+#: build/C/man2/perf_event_open.2:2749
#, no-wrap
msgid "VERSION"
msgstr "バージョン"
+#. commit 0793a61d4df8daeac6492dbf8d2f3e5713caae5e
+#. commit cdd6c482c9ff9c55475ee7392ec8f672eddb7be6
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2696
+#: build/C/man2/perf_event_open.2:2756
msgid ""
"B<perf_event_open>() was introduced in Linux 2.6.31 but was called "
"B<perf_counter_open>(). It was renamed in Linux 2.6.32."
msgstr ""
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2701
+#: build/C/man2/perf_event_open.2:2761
msgid ""
"This B<perf_event_open>() system call Linux- specific and should not be "
"used in programs intended to be portable."
"ラムで使用すべきではない。"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2705
+#: build/C/man2/perf_event_open.2:2765
msgid ""
"Glibc does not provide a wrapper for this system call; call it using "
"B<syscall>(2). See the example below."
"B<syscall>(2) を使って呼び出すこと。 以下の例を参照。"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2711
+#: build/C/man2/perf_event_open.2:2771
msgid ""
"The official way of knowing if B<perf_event_open>() support is enabled is "
"checking for the existence of the file I</proc/sys/kernel/"
msgstr ""
#. type: SH
-#: build/C/man2/perf_event_open.2:2711 build/C/man2/pivot_root.2:134
+#: build/C/man2/perf_event_open.2:2771 build/C/man2/pivot_root.2:134
#: build/C/man2/ptrace.2:2006
#, no-wrap
msgid "BUGS"
msgstr "バグ"
+#. commit ba0a6c9f6fceed11c6a99e8326f0477fe383e6b5
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2718
+#: build/C/man2/perf_event_open.2:2779
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 ""
+#. commit b690081d4d3f6a23541493f1682835c3cd5c54a1
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2726
+#: build/C/man2/perf_event_open.2:2789
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 "
"know for sure you can get valid measurements."
msgstr ""
+#. FIXME: cannot find a kernel commit for this one
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2730
+#: build/C/man2/perf_event_open.2:2794
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 them in an improper counter slot."
msgstr ""
+#. commit 45e16a6834b6af098702e5ea6c9a40de42ff77d8
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2733
+#: build/C/man2/perf_event_open.2:2798
msgid ""
"Prior to Linux 2.6.34, there was a bug when multiplexing where the wrong "
"results could be returned."
msgstr ""
+#. commit 38b435b16c36b0d863efcf3f07b34a6fac9873fd
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2736
+#: build/C/man2/perf_event_open.2:2802
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 ""
+#. commit 050735b08ca8a016bbace4445fa025b88fee770b
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2740
+#: build/C/man2/perf_event_open.2:2807
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:2745
+#: build/C/man2/perf_event_open.2:2812
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. "
"This behavior is unsupported and should not be relied on."
msgstr ""
+#. commit 4ec8363dfc1451f8c8f86825731fe712798ada02
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2751
+#: build/C/man2/perf_event_open.2:2819
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 "
"the union has a nonzero value in it."
msgstr ""
+#. commit 724b6daa13e100067c30cfc4d1ad06629609dc4e
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2757
+#: build/C/man2/perf_event_open.2:2826
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 "
"iterating across all sibling events in a group."
msgstr ""
+#. commit fa7315871046b9a4c48627905691dbde57e51033
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2768
+#: build/C/man2/perf_event_open.2:2838
msgid ""
"From Linux 3.4 to Linux 3.11, the mmap I<cap_usr_rdpmc> and I<cap_usr_time> "
"bits mapped to the same location. Code should migrate to the new "
"I<cap_user_rdpmc> and I<cap_user_time> fields instead."
msgstr ""
+#. commit f287d332ce835f77a4f5077d2c0ef1e3f9ea42d2
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2773
+#: build/C/man2/perf_event_open.2:2844
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:2773 build/C/man2/process_vm_readv.2:311
+#: build/C/man2/perf_event_open.2:2844 build/C/man2/process_vm_readv.2:311
#: build/C/man2/splice.2:237 build/C/man2/tee.2:136
#, no-wrap
msgid "EXAMPLE"
msgstr "例"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2777
+#: build/C/man2/perf_event_open.2:2848
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:2786
+#: build/C/man2/perf_event_open.2:2857
#, no-wrap
msgid ""
"#include E<lt>stdlib.hE<gt>\n"
"#include E<lt>asm/unistd.hE<gt>\n"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2792
+#: build/C/man2/perf_event_open.2:2863
#, no-wrap
msgid ""
"static long\n"
" int ret;\n"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2797
+#: build/C/man2/perf_event_open.2:2868
#, no-wrap
msgid ""
" ret = syscall(__NR_perf_event_open, hw_event, pid, cpu,\n"
"}\n"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2804
+#: build/C/man2/perf_event_open.2:2875
#, no-wrap
msgid ""
"int\n"
" int fd;\n"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2812
+#: build/C/man2/perf_event_open.2:2883
#, no-wrap
msgid ""
" memset(&pe, 0, sizeof(struct perf_event_attr));\n"
" pe.exclude_hv = 1;\n"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2818
+#: build/C/man2/perf_event_open.2:2889
#, no-wrap
msgid ""
" fd = perf_event_open(&pe, 0, -1, -1, 0);\n"
" }\n"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2821
+#: build/C/man2/perf_event_open.2:2892
#, no-wrap
msgid ""
" ioctl(fd, PERF_EVENT_IOC_RESET, 0);\n"
" ioctl(fd, PERF_EVENT_IOC_ENABLE, 0);\n"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2823
+#: build/C/man2/perf_event_open.2:2894
#, no-wrap
msgid " printf(\"Measuring instruction count for this printf\\en\");\n"
msgstr " printf(\"Measuring instruction count for this printf\\en\");\n"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2826
+#: build/C/man2/perf_event_open.2:2897
#, no-wrap
msgid ""
" ioctl(fd, PERF_EVENT_IOC_DISABLE, 0);\n"
" read(fd, &count, sizeof(long long));\n"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2828
+#: build/C/man2/perf_event_open.2:2899
#, no-wrap
msgid " printf(\"Used %lld instructions\\en\", count);\n"
msgstr " printf(\"Used %lld instructions\\en\", count);\n"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2831
+#: build/C/man2/perf_event_open.2:2902
#, no-wrap
msgid ""
" close(fd);\n"
"}\n"
#. type: Plain text
-#: build/C/man2/perf_event_open.2:2838
+#: build/C/man2/perf_event_open.2:2909
msgid "B<fcntl>(2), B<mmap>(2), B<open>(2), B<prctl>(2), B<read>(2)"
msgstr "B<fcntl>(2), B<mmap>(2), B<open>(2), B<prctl>(2), B<read>(2)"
"PMU (performance monitoring unit). The PMU consists of PMD (performance "
"monitoring data) registers and PMC (performance monitoring control) "
"registers, which gather hardware statistics."
-msgstr "IA-64 固有の B<perfmonctl>() システムコールは PMU (性能監視ユニット; performance monitoring unit) へのインターフェースを提供する。 PMU は PMD (performance monitoring data) レジスターと PMC (performance monitoring control) レジスターで構成され、 ハードウェアの統計を収集する。"
+msgstr ""
+"IA-64 固有の B<perfmonctl>() システムコールは PMU (性能監視ユニット; "
+"performance monitoring unit) へのインターフェースを提供する。 PMU は PMD "
+"(performance monitoring data) レジスターと PMC (performance monitoring "
+"control) レジスターで構成され、 ハードウェアの統計を収集する。"
#. type: Plain text
#: build/C/man2/perfmonctl.2:57
"B<perfmonctl>() applies the operation I<cmd> to the input arguments "
"specified by I<arg>. The number of arguments is defined by I<narg>. The "
"I<fd> argument specifies the perfmon context to operate on."
-msgstr "B<perfmonctl>() は、 操作 I<cmd> を I<arg> で指定された入力引き数で行う。 引き数の数は I<narg> で規定される。 I<fd> 引き数は操作対象の perfmon コンテキストを指定する。"
+msgstr ""
+"B<perfmonctl>() は、 操作 I<cmd> を I<arg> で指定された入力引き数で行う。 引"
+"き数の数は I<narg> で規定される。 I<fd> 引き数は操作対象の perfmon コンテキス"
+"トを指定する。"
#. type: Plain text
#: build/C/man2/perfmonctl.2:61
"The I<fd> parameter is ignored. A new perfmon context is created as "
"specified in I<ctxt> and its file descriptor is returned in I<ctxt-"
"E<gt>ctx_fd>."
-msgstr "I<fd> 引き数は無視される。 新しい perfmon コンテキストを I<ctxt> で指定した内容で作成し、 そのファイルディスクリプターを I<ctxt-E<gt>ctx_fd> で返す。"
+msgstr ""
+"I<fd> 引き数は無視される。 新しい perfmon コンテキストを I<ctxt> で指定した内"
+"容で作成し、 そのファイルディスクリプターを I<ctxt-E<gt>ctx_fd> で返す。"
#. type: Plain text
#: build/C/man2/perfmonctl.2:86
"can be used to read event notifications (type I<pfm_msg_t>) using "
"B<read>(2). The file descriptor is pollable using B<select>(2), B<poll>(2), "
"and B<epoll>(7)."
-msgstr "ファイルディスクリプターはそれ以降の B<perfmonctl>() の呼び出しで使用したり、 B<read>(2) を使ってイベント通知 (I<pfm_msg_t> 型) を読み出したりするのに使用できる。 このファイルディスクリプターは B<select>(2), B<poll>(2), B<epoll>(7) で状態監視 (ポーリング) することができる。"
+msgstr ""
+"ファイルディスクリプターはそれ以降の B<perfmonctl>() の呼び出しで使用した"
+"り、 B<read>(2) を使ってイベント通知 (I<pfm_msg_t> 型) を読み出したりするのに"
+"使用できる。 このファイルディスクリプターは B<select>(2), B<poll>(2), "
+"B<epoll>(7) で状態監視 (ポーリング) することができる。"
#. type: Plain text
#: build/C/man2/perfmonctl.2:90
msgid ""
"The context can be destroyed by calling B<close>(2) on the file descriptor."
-msgstr "コンテキストを破棄するには、 そのファイルディスクリプターに対して B<close>(2) を呼び出す。"
+msgstr ""
+"コンテキストを破棄するには、 そのファイルディスクリプターに対して "
+"B<close>(2) を呼び出す。"
#. type: TP
#: build/C/man2/perfmonctl.2:90
#. type: Plain text
#: build/C/man2/perfmonctl.2:162
msgid "If I<val> is nonzero, enable debugging mode, otherwise disable."
-msgstr "I<val> が 0 以外の場合、デバッグモードを有効にする。 そうでない場合、 無効にする。"
+msgstr ""
+"I<val> が 0 以外の場合、デバッグモードを有効にする。 そうでない場合、 無効に"
+"する。"
#. type: TP
#: build/C/man2/perfmonctl.2:162
msgid ""
"B<perfmonctl>() returns zero when the operation is successful. On error, "
"-1 is returned and I<errno> is set to indicate the cause of the error."
-msgstr "B<perfmonctl>() は操作が成功すると 0 を返す。 エラーの場合、 -1 が返り、 I<errno> にエラーの原因を示す値が設定される。"
+msgstr ""
+"B<perfmonctl>() は操作が成功すると 0 を返す。 エラーの場合、 -1 が返り、 "
+"I<errno> にエラーの原因を示す値が設定される。"
#. type: Plain text
#: build/C/man2/perfmonctl.2:199
msgid ""
"B<perfmonctl>() is Linux-specific and is available only on the IA-64 "
"architecture."
-msgstr "B<perfmonctl>() は Linux 固有で、 IA-64 アーキテクチャーでのみ利用できる。"
+msgstr ""
+"B<perfmonctl>() は Linux 固有で、 IA-64 アーキテクチャーでのみ利用できる。"
#. type: Plain text
#: build/C/man2/perfmonctl.2:207
msgid "PERSONALITY"
msgstr "PERSONALITY"
-#. type: TH
-#: build/C/man2/personality.2:32
-#, no-wrap
-msgid "2014-04-15"
-msgstr "2014-04-15"
-
#. type: Plain text
#: build/C/man2/personality.2:35
msgid "personality - set the process execution domain"
"B<personality>() は Linux 固有であり、移植を意図したプログラムで使用すべきで"
"はない。"
+#. type: Plain text
+#: build/C/man2/personality.2:79
+msgid "B<setarch>(8)"
+msgstr ""
+
#. type: TH
#: build/C/man2/pivot_root.2:10
#, no-wrap
msgid "PROCESS_VM_READV"
msgstr "PROCESS_VM_READV"
+#. type: TH
+#: build/C/man2/process_vm_readv.2:29
+#, no-wrap
+msgid "2014-08-19"
+msgstr "2014-08-19"
+
#. type: Plain text
#: build/C/man2/process_vm_readv.2:32
msgid ""
"process (\"the local process\") and the process identified by I<pid> (\"the "
"remote process\"). The data moves directly between the address spaces of "
"the two processes, without passing through kernel space."
-msgstr "これらのシステムコールは、 呼び出し元プロセス (「ローカルプロセス」) と I<pid> で指定されるプロセス (「リモートプロセス」) のアドレス空間間でデータを転送する。 データの移動は、 カーネル空間を経由することなく、 2 つのプロセスのアドレス空間間で直接行われる。"
+msgstr ""
+"これらのシステムコールは、 呼び出し元プロセス (「ローカルプロセス」) と "
+"I<pid> で指定されるプロセス (「リモートプロセス」) のアドレス空間間でデータを"
+"転送する。 データの移動は、 カーネル空間を経由することなく、 2 つのプロセスの"
+"アドレス空間間で直接行われる。"
#. type: Plain text
#: build/C/man2/process_vm_readv.2:98
"locations specified by I<local_iov> and I<liovcnt>: I<local_iov> is a "
"pointer to an array describing address ranges in the calling process, and "
"I<liovcnt> specifies the number of elements in I<local_iov>."
-msgstr "B<process_vm_readv>() システムコールは、 リモートプロセスからローカルプロセスへデータを転送する。 転送対象のデータは I<remote_iov> と I<riovcnt> で指定される。 I<remote_iov> はプロセス I<pid> におけるアドレス範囲を指定する配列へのポインターで、 I<riovcnt> は I<remote_iov> の要素数を指定する。 データは I<local_iov> と I<liovcnt> で指定された場所に転送される。 I<local_iov> は呼び出し元プロセスにおけるアドレス範囲を指定する配列で、 I<liovcnt> は I<local_iov> の要素数を指定する。"
+msgstr ""
+"B<process_vm_readv>() システムコールは、 リモートプロセスからローカルプロセス"
+"へデータを転送する。 転送対象のデータは I<remote_iov> と I<riovcnt> で指定さ"
+"れる。 I<remote_iov> はプロセス I<pid> におけるアドレス範囲を指定する配列への"
+"ポインターで、 I<riovcnt> は I<remote_iov> の要素数を指定する。 データは "
+"I<local_iov> と I<liovcnt> で指定された場所に転送される。 I<local_iov> は呼び"
+"出し元プロセスにおけるアドレス範囲を指定する配列で、 I<liovcnt> は "
+"I<local_iov> の要素数を指定する。"
#. type: Plain text
#: build/C/man2/process_vm_readv.2:112
"remote process. Other than the direction of the transfer, the arguments "
"I<liovcnt>, I<local_iov>, I<riovcnt>, and I<remote_iov> have the same "
"meaning as for B<process_vm_readv>()."
-msgstr "B<process_vm_writev>() システムコールは B<process_vm_readv>() の逆で、 ローカルプロセスからリモートプロセスにデータを転送する。 転送の方向が違う以外は、 引き数 I<liovcnt>, I<local_iov>, I<riovcnt>, I<remote_iov> は B<process_vm_readv>() と同じ意味を持つ。"
+msgstr ""
+"B<process_vm_writev>() システムコールは B<process_vm_readv>() の逆で、 ローカ"
+"ルプロセスからリモートプロセスにデータを転送する。 転送の方向が違う以外は、 "
+"引き数 I<liovcnt>, I<local_iov>, I<riovcnt>, I<remote_iov> は "
+"B<process_vm_readv>() と同じ意味を持つ。"
#. type: Plain text
#: build/C/man2/process_vm_readv.2:122
"B<process_vm_readv>() completely fills I<local_iov[0]> before proceeding to "
"I<local_iov[1]>, and so on. Likewise, I<remote_iov[0]> is completely read "
"before proceeding to I<remote_iov[1]>, and so on."
-msgstr "バッファーは配列の順序で処理される。 つまり、 B<process_vm_readv>() は I<local_iov>[0] が一杯になるまでデータを詰めてから、 I<local_iov>[1] に進むことを意味する。 同様に、 I<remote_iov>[0] を全部読み出してから I<remote_iov>[1] に進み、 以降も同様である。"
+msgstr ""
+"バッファーは配列の順序で処理される。 つまり、 B<process_vm_readv>() は "
+"I<local_iov>[0] が一杯になるまでデータを詰めてから、 I<local_iov>[1] に進むこ"
+"とを意味する。 同様に、 I<remote_iov>[0] を全部読み出してから "
+"I<remote_iov>[1] に進み、 以降も同様である。"
#. type: Plain text
#: build/C/man2/process_vm_readv.2:156
"Similarly, B<process_vm_writev>() writes out the entire contents of "
"I<local_iov[0]> before proceeding to I<local_iov[1]>, and it completely "
"fills I<remote_iov[0]> before proceeding to I<remote_iov[1]>."
-msgstr "同様に、 B<process_vm_writev>() は I<local_iov[0]> の内容を全部読み出してから I<local_iov[1]> に進み、 書き込み先でも I<remote_iov[0]> が一杯になってから I<remote_iov[1]> に進む。"
+msgstr ""
+"同様に、 B<process_vm_writev>() は I<local_iov[0]> の内容を全部読み出してか"
+"ら I<local_iov[1]> に進み、 書き込み先でも I<remote_iov[0]> が一杯になってか"
+"ら I<remote_iov[1]> に進む。"
#. type: Plain text
#: build/C/man2/process_vm_readv.2:164
"The lengths of I<remote_iov[i].iov_len> and I<local_iov[i].iov_len> do not "
"have to be the same. Thus, it is possible to split a single local buffer "
"into multiple remote buffers, or vice versa."
-msgstr "長さ I<remote_iov[i].iov_len> と I<local_iov[i].iov_len> は同じである必要はない。 したがって、 ローカル側で 1 つのバッファーのデータがリモート側で複数のバッファーに分割されることがあるし、 その逆も起こりえる。"
+msgstr ""
+"長さ I<remote_iov[i].iov_len> と I<local_iov[i].iov_len> は同じである必要はな"
+"い。 したがって、 ローカル側で 1 つのバッファーのデータがリモート側で複数の"
+"バッファーに分割されることがあるし、 その逆も起こりえる。"
#. type: Plain text
#: build/C/man2/process_vm_readv.2:168
"The values specified in the I<liovcnt> and I<riovcnt> arguments must be less "
"than or equal to B<IOV_MAX> (defined in I<E<lt>limits.hE<gt>> or accessible "
"via the call I<sysconf(_SC_IOV_MAX)>)."
-msgstr "I<liovcnt> と I<riovcnt> で指定される値は B<IOV_MAX> 以下でなければならない (B<IOV_MAX> は I<E<lt>limits.hE<gt>> で定義されており、 I<sysconf(_SC_IOV_MAX)> の呼び出しでも入手できる)。"
+msgstr ""
+"I<liovcnt> と I<riovcnt> で指定される値は B<IOV_MAX> 以下でなければならない "
+"(B<IOV_MAX> は I<E<lt>limits.hE<gt>> で定義されており、 "
+"I<sysconf(_SC_IOV_MAX)> の呼び出しでも入手できる)。"
#. type: Plain text
#: build/C/man2/process_vm_readv.2:191
"transfers. If the counts are too big, or I<local_iov> is invalid, or the "
"addresses refer to regions that are inaccessible to the local process, none "
"of the vectors will be processed and an error will be returned immediately."
-msgstr "要素数引き数と I<local_iov> のチェックは、 すべてのデータ転送に先立って行われる。 要素数が大きすぎる場合や I<local_iov> が無効な場合、 アドレスがローカルプロセスがアクセスできない領域を参照している場合は、 配列のどの要素も処理されず、 すぐにエラーが返される。"
+msgstr ""
+"要素数引き数と I<local_iov> のチェックは、 すべてのデータ転送に先立って行われ"
+"る。 要素数が大きすぎる場合や I<local_iov> が無効な場合、 アドレスがローカル"
+"プロセスがアクセスできない領域を参照している場合は、 配列のどの要素も処理され"
+"ず、 すぐにエラーが返される。"
#. type: Plain text
#: build/C/man2/process_vm_readv.2:211
"entry goes up to the page boundary, while the second starts on the next page "
"boundary.)"
msgstr ""
-"ただし、 これらのシステムコールは、 実際に読み出し/書き込みを行う直前までリモートプロセスのメモリー領域のチェックを行わない点に注意すること。 結果として、 I<remote_iov> の要素の一つがリモートプロセスで無効なメモリー領域を参照している場合、 部分的な読み出し/書き込み (「返り値」の節を参照) が行われることになる。 これ以降は読み出し/書き込みは行われない。 リモートプロセスから長さ不明のデータ (例えば NULL 終端された C 文字列) を読み出す際で、 リモート側の一つの I<iovec> 要素が複数のメモリーページ (通常は 4KiB) にまたがらないようにしている場合は、 この点に注意が必要である。\n"
-"(リモートからの読み出しを 2 つの I<remote_iov> 要素に分割し、 1 つの I<local_iov> 要素への書き込みにマージすればよい。 最初の読み出しでページ境界まで読み出し、 次の読み出しを次のページ境界から行う。)"
+"ただし、 これらのシステムコールは、 実際に読み出し/書き込みを行う直前までリ"
+"モートプロセスのメモリー領域のチェックを行わない点に注意すること。 結果とし"
+"て、 I<remote_iov> の要素の一つがリモートプロセスで無効なメモリー領域を参照し"
+"ている場合、 部分的な読み出し/書き込み (「返り値」の節を参照) が行われること"
+"になる。 これ以降は読み出し/書き込みは行われない。 リモートプロセスから長さ不"
+"明のデータ (例えば NULL 終端された C 文字列) を読み出す際で、 リモート側の一"
+"つの I<iovec> 要素が複数のメモリーページ (通常は 4KiB) にまたがらないようにし"
+"ている場合は、 この点に注意が必要である。\n"
+"(リモートからの読み出しを 2 つの I<remote_iov> 要素に分割し、 1 つの "
+"I<local_iov> 要素への書き込みにマージすればよい。 最初の読み出しでページ境界"
+"まで読み出し、 次の読み出しを次のページ境界から行う。)"
#. type: Plain text
#: build/C/man2/process_vm_readv.2:225
"group-ID of the remote process must match the real group ID of the caller. "
"(The permission required is exactly the same as that required to perform a "
"B<ptrace>(2) B<PTRACE_ATTACH> on the remote process.)"
-msgstr "他のプロセスからの読み出しや他のプロセスへの書き込みを行うには、 呼び出し元がケーパビリティ B<CAP_SYS_PTRACE> を持っていなければならない、もしくは、 リモートプロセスの実ユーザー ID、 実効ユーザー ID、 保存 set-user-ID が呼び出し元の実ユーザー ID と一致し、 かつリモートプロセスの実グループ ID、 実効グループ ID、 保存 set-group-ID が呼び出し元の実グループ ID と一致していなければならない。 (ここで必要なアクセス許可は、 リモートプロセスに対して B<ptrace>(2) の B<PTRACE_ATTACH> を実行するのに必要な許可と全く同じである。)"
+msgstr ""
+"他のプロセスからの読み出しや他のプロセスへの書き込みを行うには、 呼び出し元が"
+"ケーパビリティ B<CAP_SYS_PTRACE> を持っていなければならない、もしくは、 リ"
+"モートプロセスの実ユーザー ID、 実効ユーザー ID、 保存 set-user-ID が呼び出し"
+"元の実ユーザー ID と一致し、 かつリモートプロセスの実グループ ID、 実効グルー"
+"プ ID、 保存 set-group-ID が呼び出し元の実グループ ID と一致していなければな"
+"らない。 (ここで必要なアクセス許可は、 リモートプロセスに対して B<ptrace>(2) "
+"の B<PTRACE_ATTACH> を実行するのに必要な許可と全く同じである。)"
#. type: Plain text
#: build/C/man2/process_vm_readv.2:241
"I<iovec> elements. These system calls won't perform a partial transfer that "
"splits a single I<iovec> element.) The caller should check the return value "
"to determine whether a partial read/write occurred."
-msgstr "成功すると、 B<process_vm_readv>() は読み出したバイト数を返し、 B<process_vm_writev>() は書き込んだバイト数を返す。 この返り値は、 読み出し/書き込みが部分的に行われた場合には、 要求された総バイト数よりも小さくなることがある (部分的な転送は I<iovec> 要素単位に行われ、 これらのシステムコールが一つの I<iovec> 要素の一部だけが転送されることはない)。 呼び出し元は返り値を検査して、 部分的な読み出し/書き込みが起こったかどうかを判定できる。"
+msgstr ""
+"成功すると、 B<process_vm_readv>() は読み出したバイト数を返し、 "
+"B<process_vm_writev>() は書き込んだバイト数を返す。 この返り値は、 読み出し/"
+"書き込みが部分的に行われた場合には、 要求された総バイト数よりも小さくなること"
+"がある (部分的な転送は I<iovec> 要素単位に行われ、 これらのシステムコールが一"
+"つの I<iovec> 要素の一部だけが転送されることはない)。 呼び出し元は返り値を検"
+"査して、 部分的な読み出し/書き込みが起こったかどうかを判定できる。"
#. type: Plain text
#: build/C/man2/process_vm_readv.2:245
msgid ""
"The sum of the I<iov_len> values of either I<local_iov> or I<remote_iov> "
"overflows a I<ssize_t> value."
-msgstr "I<local_iov> か I<remote_iov> のいずれかの I<iov_len> の合計値が I<ssize_t> で表現できる値を超えている。"
+msgstr ""
+"I<local_iov> か I<remote_iov> のいずれかの I<iov_len> の合計値が I<ssize_t> "
+"で表現できる値を超えている。"
#. type: Plain text
#: build/C/man2/process_vm_readv.2:261
msgid ""
"The memory described by I<local_iov> is outside the caller's accessible "
"address space."
-msgstr "I<local_iov> で指定されたメモリーが呼び出し元がアクセス可能なアドレス空間の外にある。"
+msgstr ""
+"I<local_iov> で指定されたメモリーが呼び出し元がアクセス可能なアドレス空間の外"
+"にある。"
#. type: Plain text
#: build/C/man2/process_vm_readv.2:278
msgid ""
"The memory described by I<remote_iov> is outside the accessible address "
"space of the process I<pid>."
-msgstr "I<remote_iov> で指定されたメモリーがプロセス I<pid> がアクセス可能なアドレス空間の外にある。"
+msgstr ""
+"I<remote_iov> で指定されたメモリーがプロセス I<pid> がアクセス可能なアドレス"
+"空間の外にある。"
#. type: Plain text
#: build/C/man2/process_vm_readv.2:283
msgid ""
"The data transfers performed by B<process_vm_readv>() and "
"B<process_vm_writev>() are not guaranteed to be atomic in any way."
-msgstr "B<process_vm_readv>() と B<process_vm_writev>() により実行されるデータ転送をどのように行ったとしても、 これらがアトミックに行われる保証はない。"
+msgstr ""
+"B<process_vm_readv>() と B<process_vm_writev>() により実行されるデータ転送を"
+"どのように行ったとしても、 これらがアトミックに行われる保証はない。"
#. Original user is MPI, http://www.mcs.anl.gov/research/projects/mpi/
#. See also some benchmarks at http://lwn.net/Articles/405284/
"double copy that would be required when using, for example, shared memory or "
"pipes)."
msgstr ""
-"これらのシステムコールは、 (共有メモリーやパイプなどを使った場合に必要となる 2 回のコピーではなく)\n"
-"1 回のコピー処理でメッセージの交換を許すことで、 高速なメッセージ送信をできるようにするために設計された。"
+"これらのシステムコールは、 (共有メモリーやパイプなどを使った場合に必要となる "
+"2 回のコピーではなく)\n"
+"1 回のコピー処理でメッセージの交換を許すことで、 高速なメッセージ送信をできる"
+"ようにするために設計された。"
#. type: Plain text
#: build/C/man2/process_vm_readv.2:319
"The following code sample demonstrates the use of B<process_vm_readv>(). It "
"reads 20 bytes at the address 0x10000 from the process with PID 10 and "
"writes the first 10 bytes into I<buf1> and the second 10 bytes into I<buf2>."
-msgstr "以下のサンプルコードは B<process_vm_readv>() の使用例を示すものである。 このコードは PID 10 のプロセスのアドレス 0x10000 から 20 バイトを読み取り、 最初の 10 バイトを I<buf1> に、 残りの 10 バイトを I<buf2> に書き込む。"
+msgstr ""
+"以下のサンプルコードは B<process_vm_readv>() の使用例を示すものである。 この"
+"コードは PID 10 のプロセスのアドレス 0x10000 から 20 バイトを読み取り、 最初"
+"の 10 バイトを I<buf1> に、 残りの 10 バイトを I<buf2> に書き込む。"
#. type: Plain text
#: build/C/man2/process_vm_readv.2:322
"\"tracer\") may observe and control the execution of another process (the "
"\"tracee\"), and examine and change the tracee's memory and registers. It "
"is primarily used to implement breakpoint debugging and system call tracing."
-msgstr "B<ptrace>() システムコールは、 あるプロセス (\"tracer\") が、 別のプロセス (\"tracee\") の実行の監視/制御を行ったり、 tracee のメモリーやレジスターの調査/変更を行ったりする手段を提供する。 B<ptrace>() は、 主にブレークポイントによるデバッグやシステムコールのトレースを実装するのに用いられる。"
+msgstr ""
+"B<ptrace>() システムコールは、 あるプロセス (\"tracer\") が、 別のプロセス "
+"(\"tracee\") の実行の監視/制御を行ったり、 tracee のメモリーやレジスターの調"
+"査/変更を行ったりする手段を提供する。 B<ptrace>() は、 主にブレークポイント"
+"によるデバッグやシステムコールのトレースを実装するのに用いられる。"
#. type: Plain text
#: build/C/man2/ptrace.2:75
"resulting child do a B<PTRACE_TRACEME>, followed (typically) by an "
"B<execve>(2). Alternatively, one process may commence tracing another "
"process using B<PTRACE_ATTACH> or B<PTRACE_SEIZE>."
-msgstr "プロセスがトレースを開始するには、 まず親プロセスで B<fork>(2) を呼び出す。 生成された子プロセスで B<PTRACE_TRACEME> を行い、 続いて (典型的には) B<execve>(2) を行なう。 別の方法としては、 プロセスが別のプロセスに対して B<PTRACE_ATTACH> か B<PTRACE_SEIZE> を使用し、 トレースを開始する。"
+msgstr ""
+"プロセスがトレースを開始するには、 まず親プロセスで B<fork>(2) を呼び出す。 "
+"生成された子プロセスで B<PTRACE_TRACEME> を行い、 続いて (典型的には) "
+"B<execve>(2) を行なう。 別の方法としては、 プロセスが別のプロセスに対して "
+"B<PTRACE_ATTACH> か B<PTRACE_SEIZE> を使用し、 トレースを開始する。"
#. type: Plain text
#: build/C/man2/ptrace.2:115
"various ptrace requests to inspect and modify the tracee. The tracer then "
"causes the tracee to continue, optionally ignoring the delivered signal (or "
"even delivering a different signal instead)."
-msgstr "トレースの実行中、tracee はシグナルが配送されるたびに、 たとえそのシグナルが無視されている場合であっても停止する (B<SIGKILL> は例外で、通常どおりの効果を持つ)。 tracer には次の B<waitpid>(2) (や関連の \"wait\" システムコール) の呼び出しで通知され、 その呼び出しでは tracee で停止の原因を示す情報が入った I<status> 値が返される。 tracee が停止している間に、 tracer は様々な ptrace の要求を使って tracee を調査したり修正したりすることができる。 それから tracer は tracee の実行を再開させるが、 配送されたシグナルを無視することもできる (あるいは別のシグナルを配送することもできる) 。"
+msgstr ""
+"トレースの実行中、tracee はシグナルが配送されるたびに、 たとえそのシグナルが"
+"無視されている場合であっても停止する (B<SIGKILL> は例外で、通常どおりの効果を"
+"持つ)。 tracer には次の B<waitpid>(2) (や関連の \"wait\" システムコール) の呼"
+"び出しで通知され、 その呼び出しでは tracee で停止の原因を示す情報が入った "
+"I<status> 値が返される。 tracee が停止している間に、 tracer は様々な ptrace "
+"の要求を使って tracee を調査したり修正したりすることができる。 それから "
+"tracer は tracee の実行を再開させるが、 配送されたシグナルを無視することもで"
+"きる (あるいは別のシグナルを配送することもできる) 。"
#. type: Plain text
#: build/C/man2/ptrace.2:125
msgid ""
"When the tracer is finished tracing, it can cause the tracee to continue "
"executing in a normal, untraced mode via B<PTRACE_DETACH>."
-msgstr "tracer がトレースを終了する際には、 B<PTRACE_DETACH> を用いて tracee を通常のトレースなしのモードにして、 実行を継続させることができる。"
+msgstr ""
+"tracer がトレースを終了する際には、 B<PTRACE_DETACH> を用いて tracee を通常の"
+"トレースなしのモードにして、 実行を継続させることができる。"
#. type: Plain text
#: build/C/man2/ptrace.2:133
"specifies the thread ID of the tracee to be acted on. For requests other "
"than B<PTRACE_ATTACH>, B<PTRACE_SEIZE>, B<PTRACE_INTERRUPT>, and "
"B<PTRACE_KILL>, the tracee must be stopped."
-msgstr "B<PTRACE_TRACEME> 要求は tracee だけが使用するものである。 残りの要求は tracer だけが使用する。 以下の要求では、I<pid> は操作の対象となる tracee のスレッド ID を指定する。 B<PTRACE_ATTACH>, B<PTRACE_SEIZE>, B<PTRACE_INTERRUPT>, B<PTRACE_KILL> 以外の要求では、 tracee は停止していなければならない。"
+msgstr ""
+"B<PTRACE_TRACEME> 要求は tracee だけが使用するものである。 残りの要求は "
+"tracer だけが使用する。 以下の要求では、I<pid> は操作の対象となる tracee のス"
+"レッド ID を指定する。 B<PTRACE_ATTACH>, B<PTRACE_SEIZE>, "
+"B<PTRACE_INTERRUPT>, B<PTRACE_KILL> 以外の要求では、 tracee は停止していなけ"
+"ればならない。"
#. type: TP
#: build/C/man2/ptrace.2:158
"word as the result of the B<ptrace>() call. Linux does not have separate "
"text and data address spaces, so these two requests are currently "
"equivalent. (I<data> is ignored; but see NOTES.)"
-msgstr "tracee のメモリーの I<addr> のアドレスから 1 ワードを読み出す。 読み出したワードは B<ptrace>() の返り値として返される。 Linux ではテキスト (text) とデータ (data) で 同じアドレス空間を使用するため、これらの 2 つの要求は現在のところ 同じものである。 (I<data> は無視される。 ただし「注意」を参照。)"
+msgstr ""
+"tracee のメモリーの I<addr> のアドレスから 1 ワードを読み出す。 読み出した"
+"ワードは B<ptrace>() の返り値として返される。 Linux ではテキスト (text) と"
+"データ (data) で 同じアドレス空間を使用するため、これらの 2 つの要求は現在の"
+"ところ 同じものである。 (I<data> は無視される。 ただし「注意」を参照。)"
#. type: TP
#: build/C/man2/ptrace.2:169
"hE<gt>>). The word is returned as the result of the B<ptrace>() call. "
"Typically, the offset must be word-aligned, though this might vary by "
"architecture. See NOTES. (I<data> is ignored; but see NOTES.)"
-msgstr "tracee の USER 領域のオフセット I<addr> の位置から 1 ワードを読み込む。USER 領域にはそのプロセスの レジスター (registers) などの情報が保持されている (I<E<lt>sys/user.hE<gt>> を参照)。読み込んだワードは B<ptrace>() コールの結果として返される。 たいていはオフセットはワード境界になければならないが、 アーキテクチャーによってはその必要はない。 「注意」の節を参照。 (I<data> は無視される。 ただし「注意」を参照。)"
+msgstr ""
+"tracee の USER 領域のオフセット I<addr> の位置から 1 ワードを読み込む。USER "
+"領域にはそのプロセスの レジスター (registers) などの情報が保持されている "
+"(I<E<lt>sys/user.hE<gt>> を参照)。読み込んだワードは B<ptrace>() コールの結"
+"果として返される。 たいていはオフセットはワード境界になければならないが、 "
+"アーキテクチャーによってはその必要はない。 「注意」の節を参照。 (I<data> は無"
+"視される。 ただし「注意」を参照。)"
#. type: TP
#: build/C/man2/ptrace.2:187
"Copy the word I<data> to the address I<addr> in the tracee's memory. As for "
"B<PTRACE_PEEKTEXT> and B<PTRACE_PEEKDATA>, these two requests are currently "
"equivalent."
-msgstr "ワード I<data> を tracee のメモリーの I<addr> のアドレスへコピーする。 B<PTRACE_PEEKTEXT> や B<PTRACE_PEEKDATA> と同様に、 現在のところ二つの要求は同じものである。"
+msgstr ""
+"ワード I<data> を tracee のメモリーの I<addr> のアドレスへコピーする。 "
+"B<PTRACE_PEEKTEXT> や B<PTRACE_PEEKDATA> と同様に、 現在のところ二つの要求は"
+"同じものである。"
#. type: TP
#: build/C/man2/ptrace.2:199
"B<PTRACE_PEEKUSER>, the offset must typically be word-aligned. In order to "
"maintain the integrity of the kernel, some modifications to the USER area "
"are disallowed."
-msgstr "ワード I<data> を tracee の USER 領域のオフセット I<addr> のアドレスにコピーする。 B<PTRACE_PEEKUSER> と同様に、通常、オフセットはワード境界になければならない。 カーネルの完全性 (integrity) を維持するため、 変更内容によっては USER 領域の変更は禁止されている。"
+msgstr ""
+"ワード I<data> を tracee の USER 領域のオフセット I<addr> のアドレスにコピー"
+"する。 B<PTRACE_PEEKUSER> と同様に、通常、オフセットはワード境界になければな"
+"らない。 カーネルの完全性 (integrity) を維持するため、 変更内容によっては "
+"USER 領域の変更は禁止されている。"
#. type: TP
#: build/C/man2/ptrace.2:215
"I<data> is ignored and the registers are copied to the address I<addr>. "
"B<PTRACE_GETREGS> and B<PTRACE_GETFPREGS> are not present on all "
"architectures."
-msgstr "それぞれ、 tracee の汎用レジスター、 浮動小数点レジスターを tracer の I<data> のアドレスにコピーする。この data の書式に関しては I<E<lt>sys/user.hE<gt>> を参照すること。(I<addr> は無視される。) SPARC システムでは I<data> と I<addr> の意味が逆になっている点に注意。 つまり、 I<data> は無視され、 レジスターはアドレス I<addr> にコピーされる。 B<PTRACE_GETREGS> と B<PTRACE_GETFPREGS> はすべてのアーキテクチャーで存在するわけではない。"
+msgstr ""
+"それぞれ、 tracee の汎用レジスター、 浮動小数点レジスターを tracer の "
+"I<data> のアドレスにコピーする。この data の書式に関しては I<E<lt>sys/user."
+"hE<gt>> を参照すること。(I<addr> は無視される。) SPARC システムでは I<data> "
+"と I<addr> の意味が逆になっている点に注意。 つまり、 I<data> は無視され、 レ"
+"ジスターはアドレス I<addr> にコピーされる。 B<PTRACE_GETREGS> と "
+"B<PTRACE_GETFPREGS> はすべてのアーキテクチャーで存在するわけではない。"
#. type: TP
#: build/C/man2/ptrace.2:238
"registers are copied from the address I<addr>. B<PTRACE_SETREGS> and "
"B<PTRACE_SETFPREGS> are not present on all architectures."
msgstr ""
-"それぞれ、 tracee の汎用レジスター、浮動小数点レジスターに tracer の I<date> のアドレスからコピーする。 B<PTRACE_POKEUSER> と同様に、汎用レジスターによっては 変更が禁止されている場合がある。 (I<addr> は無視される。)\n"
+"それぞれ、 tracee の汎用レジスター、浮動小数点レジスターに tracer の I<date> "
+"のアドレスからコピーする。 B<PTRACE_POKEUSER> と同様に、汎用レジスターによっ"
+"ては 変更が禁止されている場合がある。 (I<addr> は無視される。)\n"
"\n"
"Note that SPARC systems have the meaning of I<data> and I<addr>\n"
"reversed; that is, I<data> is ignored and the registers are copied\n"
"Retrieve information about the signal that caused the stop. Copy a "
"I<siginfo_t> structure (see B<sigaction>(2)) from the tracee to the address "
"I<data> in the tracer. (I<addr> is ignored.)"
-msgstr "停止の原因となったシグナルに関する情報を取得する。 I<siginfo_t> 構造体 (B<sigaction>(2) 参照) を tracee から tracer の I<data> のアドレスにコピーする。 (I<addr> は無視される。)"
+msgstr ""
+"停止の原因となったシグナルに関する情報を取得する。 I<siginfo_t> 構造体 "
+"(B<sigaction>(2) 参照) を tracee から tracer の I<data> のアドレスにコピーす"
+"る。 (I<addr> は無視される。)"
#. type: TP
#: build/C/man2/ptrace.2:305
"would normally be delivered to the tracee and were caught by the tracer. It "
"may be difficult to tell these normal signals from synthetic signals "
"generated by B<ptrace>() itself. (I<addr> is ignored.)"
-msgstr "シグナル情報を設定する。 I<siginfo_t> 構造体を tracer のデータ I<data> のアドレスから tracee にコピーする。 この処理を行うことができるのは、 tracee に通常は配送されるはずで トレーサに捕捉されたシグナルについてだけである。 これらの通常のシグナルと B<ptrace>() 自身が発生するシグナルを見分けるのは難しいかもしれない。 (I<addr> は無視される。)"
+msgstr ""
+"シグナル情報を設定する。 I<siginfo_t> 構造体を tracer のデータ I<data> のアド"
+"レスから tracee にコピーする。 この処理を行うことができるのは、 tracee に通常"
+"は配送されるはずで トレーサに捕捉されたシグナルについてだけである。 これらの"
+"通常のシグナルと B<ptrace>() 自身が発生するシグナルを見分けるのは難しいかも"
+"しれない。 (I<addr> は無視される。)"
#. type: TP
#: build/C/man2/ptrace.2:321
"newly cloned process, which will start with a B<SIGSTOP>, or "
"B<PTRACE_EVENT_STOP> if B<PTRACE_SEIZE> was used. A B<waitpid>(2) by the "
"tracer will return a I<status> value such that"
-msgstr "次の B<clone>(2) 呼び出し時に tracee を停止し、 新しくクローンされたプロセスのトレースを自動的に開始し、 B<SIGSTOP> でプロセスの実行を開始する。 B<PTRACE_SEIZE> が使用された場合は B<PTRACE_EVENT_STOP> で開始する。 tracer による B<waitpid>(2) の呼び出しでは以下のような I<status> 値が返る。"
+msgstr ""
+"次の B<clone>(2) 呼び出し時に tracee を停止し、 新しくクローンされたプロセス"
+"のトレースを自動的に開始し、 B<SIGSTOP> でプロセスの実行を開始する。 "
+"B<PTRACE_SEIZE> が使用された場合は B<PTRACE_EVENT_STOP> で開始する。 tracer "
+"による B<waitpid>(2) の呼び出しでは以下のような I<status> 値が返る。"
#. type: Plain text
#: build/C/man2/ptrace.2:432
"be delivered instead if B<PTRACE_O_TRACEVFORK> is set; otherwise if the "
"tracee calls B<clone>(2) with the exit signal set to B<SIGCHLD>, "
"B<PTRACE_EVENT_FORK> will be delivered if B<PTRACE_O_TRACEFORK> is set."
-msgstr "このオプションで全ての B<clone>(2) コールを捕まえられるわけではない。 tracee が B<CLONE_VFORK> フラグ付きで B<clone>(2) を呼び出した場合、 B<PTRACE_O_TRACEVFORK> が設定されていれば代わりに B<PTRACE_EVENT_VFORK> が配送される。 また、 tracee が終了シグナルを B<SIGCHLD> に設定して B<clone>(2) を呼び出した場合は、 B<PTRACE_O_TRACEFORK> が設定されていれば B<PTRACE_EVENT_FORK> が配送される。"
+msgstr ""
+"このオプションで全ての B<clone>(2) コールを捕まえられるわけではない。 "
+"tracee が B<CLONE_VFORK> フラグ付きで B<clone>(2) を呼び出した場合、 "
+"B<PTRACE_O_TRACEVFORK> が設定されていれば代わりに B<PTRACE_EVENT_VFORK> が配"
+"送される。 また、 tracee が終了シグナルを B<SIGCHLD> に設定して B<clone>(2) "
+"を呼び出した場合は、 B<PTRACE_O_TRACEFORK> が設定されていれば "
+"B<PTRACE_EVENT_FORK> が配送される。"
#. type: TP
#: build/C/man2/ptrace.2:457
msgid ""
"Stop the tracee at exit. A B<waitpid>(2) by the tracer will return a "
"I<status> value such that"
-msgstr "exit 時に tracee を停止する。 tracer による B<waiting>(2) では以下のような I<status> 値が返る。"
+msgstr ""
+"exit 時に tracee を停止する。 tracer による B<waiting>(2) では以下のような "
+"I<status> 値が返る。"
#. type: Plain text
#: build/C/man2/ptrace.2:486
"normal exit notification is done after the process is finished exiting. "
"Even though context is available, the tracer cannot prevent the exit from "
"happening at this point."
-msgstr "tracee の停止はレジスターがまだ参照可能であるプロセス終了処理の初期に行われ、 トレーサはどこで終了が発生したかを知ることができる。 通常の終了通知 (exit notification) はプロセスの終了処理が完了した後に 行われる。コンテキストを参照することはできるにも関わらず、 トレーサはこの時点から終了を止めることはできない。"
+msgstr ""
+"tracee の停止はレジスターがまだ参照可能であるプロセス終了処理の初期に行わ"
+"れ、 トレーサはどこで終了が発生したかを知ることができる。 通常の終了通知 "
+"(exit notification) はプロセスの終了処理が完了した後に 行われる。コンテキスト"
+"を参照することはできるにも関わらず、 トレーサはこの時点から終了を止めることは"
+"できない。"
#. type: TP
#: build/C/man2/ptrace.2:498
"newly forked process, which will start with a B<SIGSTOP>, or "
"B<PTRACE_EVENT_STOP> if B<PTRACE_SEIZE> was used. A B<waitpid>(2) by the "
"tracer will return a I<status> value such that"
-msgstr "次の B<fork>(2) 呼び出し時に tracee を停止し、 新しく fork されたプロセスのトレースを自動的に開始し、 B<SIGSTOP> でそのプロセスの実行を開始する。 B<PTRACE_SEIZE> が使用された場合は B<PTRACE_EVENT_STOP> で実行を開始する。 tracer による B<waitpid>(2) の呼び出しでは以下のような I<status> 値が返る。"
+msgstr ""
+"次の B<fork>(2) 呼び出し時に tracee を停止し、 新しく fork されたプロセスの"
+"トレースを自動的に開始し、 B<SIGSTOP> でそのプロセスの実行を開始する。 "
+"B<PTRACE_SEIZE> が使用された場合は B<PTRACE_EVENT_STOP> で実行を開始する。 "
+"tracer による B<waitpid>(2) の呼び出しでは以下のような I<status> 値が返る。"
#. type: Plain text
#: build/C/man2/ptrace.2:518
"deliver I<SIGTRAP|0x80>). This makes it easy for the tracer to distinguish "
"normal traps from those caused by a system call. (B<PTRACE_O_TRACESYSGOOD> "
"may not work on all architectures.)"
-msgstr "システムコールのトラップが配送されたときに、シグナル番号のビット 7 を設定する (すなわち、I<SIGTRAP | 0x80> を配送する)。 これにより、トレーサが通常のトラップとシステムコールによるトラップを区別しやすくなる。 (B<PTRACE_O_TRACESYSGOOD> はどのアーキテクチャーでも動作しない可能性がある。)"
+msgstr ""
+"システムコールのトラップが配送されたときに、シグナル番号のビット 7 を設定す"
+"る (すなわち、I<SIGTRAP | 0x80> を配送する)。 これにより、トレーサが通常のト"
+"ラップとシステムコールによるトラップを区別しやすくなる。 "
+"(B<PTRACE_O_TRACESYSGOOD> はどのアーキテクチャーでも動作しない可能性がある。)"
#. type: TP
#: build/C/man2/ptrace.2:531
"newly vforked process, which will start with a B<SIGSTOP>, or "
"B<PTRACE_EVENT_STOP> if B<PTRACE_SEIZE> was used. A B<waitpid>(2) by the "
"tracer will return a I<status> value such that"
-msgstr "次の B<vfork>(2) 呼び出し時に tracee を停止し、 新しく vfork されたプロセスのトレースを自動的に開始し、 B<SIGSTOP> でそのプロセスの実行を開始する。 B<PTRACE_SEIZE> が使用された場合は B<PTRACE_EVENT_STOP> で実行を開始する。 tracer による B<waitpid>(2) の呼び出しでは以下のような I<status> 値が返る。"
+msgstr ""
+"次の B<vfork>(2) 呼び出し時に tracee を停止し、 新しく vfork されたプロセス"
+"のトレースを自動的に開始し、 B<SIGSTOP> でそのプロセスの実行を開始する。 "
+"B<PTRACE_SEIZE> が使用された場合は B<PTRACE_EVENT_STOP> で実行を開始する。 "
+"tracer による B<waitpid>(2) の呼び出しでは以下のような I<status> 値が返る。"
#. type: Plain text
#: build/C/man2/ptrace.2:551
"Stop the tracee when a B<seccomp>(2) B<SECCOMP_RET_TRACE> rule is "
"triggered. A B<waitpid>(2) by the tracer will return a I<status> value "
"such that"
-msgstr "B<seccomp>(2) B<SECCOMP_RET_TRACE> ルールが起動された場合に tracee を停止する。 tracer による B<waitpid>(2) の呼び出しでは以下のような I<status> 値が返る。"
+msgstr ""
+"B<seccomp>(2) B<SECCOMP_RET_TRACE> ルールが起動された場合に tracee を停止す"
+"る。 tracer による B<waitpid>(2) の呼び出しでは以下のような I<status> 値が返"
+"る。"
#. type: Plain text
#: build/C/man2/ptrace.2:585
"B<PTRACE_EVENT_SECCOMP>, this is the B<seccomp>(2) filter's "
"B<SECCOMP_RET_DATA> associated with the triggered rule. (I<addr> is "
"ignored.)"
-msgstr "発生したばかりの ptrace イベントに関するメッセージを (I<unsigned long> 型で) 取得する。 取得したメッセージは tracer の I<data> のアドレスに格納される。 格納される内容は、 B<PTRACE_EVENT_EXIT> の場合は tracee の終了ステータスである。 B<PTRACE_EVENT_FORK>, B<PTRACE_EVENT_VFORK>, B<PTRACE_EVENT_VFORK_DONE>, B<PTRACE_EVENT_CLONE> の場合は新しいプロセスの PID が格納される。 B<PTRACE_EVENT_SECCOMP> の場合は、起動されたルールに関連付けられた B<seccomp>(2) フィルターの B<SECCOMP_RET_DATA> が格納される。 (I<addr> は無視される。)"
+msgstr ""
+"発生したばかりの ptrace イベントに関するメッセージを (I<unsigned long> 型で) "
+"取得する。 取得したメッセージは tracer の I<data> のアドレスに格納される。 格"
+"納される内容は、 B<PTRACE_EVENT_EXIT> の場合は tracee の終了ステータスであ"
+"る。 B<PTRACE_EVENT_FORK>, B<PTRACE_EVENT_VFORK>, "
+"B<PTRACE_EVENT_VFORK_DONE>, B<PTRACE_EVENT_CLONE> の場合は新しいプロセスの "
+"PID が格納される。 B<PTRACE_EVENT_SECCOMP> の場合は、起動されたルールに関連付"
+"けられた B<seccomp>(2) フィルターの B<SECCOMP_RET_DATA> が格納される。 "
+"(I<addr> は無視される。)"
#. type: TP
#: build/C/man2/ptrace.2:623
"otherwise, no signal is delivered. Thus, for example, the tracer can "
"control whether a signal sent to the tracee is delivered or not. (I<addr> "
"is ignored.)"
-msgstr "停止した tracee の実行を再開させる。 I<data> がゼロでない場合、 tracee に配送されるシグナル数と解釈される。 ゼロの場合はシグナルは配送されない。 これを使うと、例えば、 tracer は tracee に送られたシグナルを実際に配送するかどうかを 制御することができる。(I<addr> は無視される。)"
+msgstr ""
+"停止した tracee の実行を再開させる。 I<data> がゼロでない場合、 tracee に配送"
+"されるシグナル数と解釈される。 ゼロの場合はシグナルは配送されない。 これを使"
+"うと、例えば、 tracer は tracee に送られたシグナルを実際に配送するかどうかを "
+"制御することができる。(I<addr> は無視される。)"
#. type: TP
#: build/C/man2/ptrace.2:635
"the system call at the first stop, then do another B<PTRACE_SYSCALL> and "
"inspect the return value of the system call at the second stop. The I<data> "
"argument is treated as for B<PTRACE_CONT>. (I<addr> is ignored.)"
-msgstr "B<PTRACE_CONT> と同様に停止した tracee を再開する。ただし、 B<PTRACE_SYSCALL> の場合は tracee が 次にシステムコールに入るかシステムコールから抜けるかする時に、 B<PTRACE_SINGLESTEP> の場合は 1 命令 (instruction) 実行した後に停止させる (通常どおり、 tracee はシグナルを受け取った場合にも停止する)。 tracer から見ると、 tracee は B<SIGTRAP> を受信して停止したように見える。そのため、例えば B<PTRACE_SYSCALL> を使うと、1回目の停止で引き数を調べて B<PTRACE_SYSCALL> を実行し、 2回目の停止でシステムコールの返り値を調べる、 というようなことができる。 引き数 I<data> は B<PTRACE_CONT> の場合と同じ様に解釈される。 (I<addr> は無視される。)"
+msgstr ""
+"B<PTRACE_CONT> と同様に停止した tracee を再開する。ただし、 "
+"B<PTRACE_SYSCALL> の場合は tracee が 次にシステムコールに入るかシステムコール"
+"から抜けるかする時に、 B<PTRACE_SINGLESTEP> の場合は 1 命令 (instruction) 実"
+"行した後に停止させる (通常どおり、 tracee はシグナルを受け取った場合にも停止"
+"する)。 tracer から見ると、 tracee は B<SIGTRAP> を受信して停止したように見え"
+"る。そのため、例えば B<PTRACE_SYSCALL> を使うと、1回目の停止で引き数を調べて "
+"B<PTRACE_SYSCALL> を実行し、 2回目の停止でシステムコールの返り値を調べる、 と"
+"いうようなことができる。 引き数 I<data> は B<PTRACE_CONT> の場合と同じ様に解"
+"釈される。 (I<addr> は無視される。)"
#. type: TP
#: build/C/man2/ptrace.2:659
"like User Mode Linux that want to emulate all the tracee's system calls. "
"The I<data> argument is treated as for B<PTRACE_CONT>. The I<addr> argument "
"is ignored. These requests are currently supported only on x86."
-msgstr "B<PTRACE_SYSEMU> は、実行を再開し、次のシステムコールに入る時に停止させる。 システムコールは実行されない。 B<PTRACE_SYSEMU_SINGLESTEP> も同様だが、システムコールでない場合には 1 命令 (singlestep) だけ実行した時点でも停止させる。 このコールは User Mode Linux のように tracee のシステムコールを全て エミュレートしようとするプログラムで使用される。 引き数 I<data> は B<PTRACE_CONT> の場合と同じ様に解釈される。 I<addr> 引き数は無視される。 現在のところこれらの要求は x86 でのみサポートされている。"
+msgstr ""
+"B<PTRACE_SYSEMU> は、実行を再開し、次のシステムコールに入る時に停止させる。 "
+"システムコールは実行されない。 B<PTRACE_SYSEMU_SINGLESTEP> も同様だが、システ"
+"ムコールでない場合には 1 命令 (singlestep) だけ実行した時点でも停止させる。 "
+"このコールは User Mode Linux のように tracee のシステムコールを全て エミュ"
+"レートしようとするプログラムで使用される。 引き数 I<data> は B<PTRACE_CONT> "
+"の場合と同じ様に解釈される。 I<addr> 引き数は無視される。 現在のところこれら"
+"の要求は x86 でのみサポートされている。"
#. type: TP
#: build/C/man2/ptrace.2:680
msgid ""
"Send the tracee a B<SIGKILL> to terminate it. (I<addr> and I<data> are "
"ignored.)"
-msgstr "tracee に B<SIGKILL> を送り終了させる。(I<addr> と I<data> は無視される。)"
+msgstr ""
+"tracee に B<SIGKILL> を送り終了させる。(I<addr> と I<data> は無視される。)"
#. [Note from Denys Vlasenko:
#. deprecation suggested by Oleg Nesterov. He prefers to deprecate it
"Restart the stopped tracee as for B<PTRACE_CONT>, but first detach from it. "
"Under Linux, a tracee can be detached in this way regardless of which method "
"was used to initiate tracing. (I<addr> is ignored.)"
-msgstr "B<PTRACE_CONT> と同様に停止した tracee を再開するが、 まずそのプロセスからの分離 (detach) を行う。 Linux では、トレースされている tracee はどのような方法でトレースを開始されたとしても、この方法で分離 (detach) することができる。 (I<addr> は無視される。)"
+msgstr ""
+"B<PTRACE_CONT> と同様に停止した tracee を再開するが、 まずそのプロセスからの"
+"分離 (detach) を行う。 Linux では、トレースされている tracee はどのような方法"
+"でトレースを開始されたとしても、この方法で分離 (detach) することができる。 "
+"(I<addr> は無視される。)"
#. type: SS
#: build/C/man2/ptrace.2:804
msgid ""
"On success, the B<PTRACE_PEEK*> requests return the requested data (but see "
"NOTES), while other requests return zero."
-msgstr "成功すると B<PTRACE_PEEK*> の場合は要求したデータを返し (「注意」を参照)、 それ以外の場合は 0 を返す。"
+msgstr ""
+"成功すると B<PTRACE_PEEK*> の場合は要求したデータを返し (「注意」を参照)、 そ"
+"れ以外の場合は 0 を返す。"
#. type: Plain text
#: build/C/man2/ptrace.2:1911
"the value returned by a successful B<PTRACE_PEEK*> request may be -1, the "
"caller must clear I<errno> before the call, and then check it afterward to "
"determine whether or not an error occurred."
-msgstr "エラーの場合は -1 を返し、 I<errno> が適切に設定される。 B<PTRACE_PEEK*> が成功して返す値も-1 になることがあるため、 呼び出し元は呼び出しを行う前に I<errno> をクリアして、 あとで I<errno> を調べ、エラーか発生したのかどうかを判断しなければならない。"
+msgstr ""
+"エラーの場合は -1 を返し、 I<errno> が適切に設定される。 B<PTRACE_PEEK*> が成"
+"功して返す値も-1 になることがあるため、 呼び出し元は呼び出しを行う前に "
+"I<errno> をクリアして、 あとで I<errno> を調べ、エラーか発生したのかどうかを"
+"判断しなければならない。"
#. type: Plain text
#: build/C/man2/ptrace.2:1915
"tracer's or the tracee's memory, probably because the area wasn't mapped or "
"accessible. Unfortunately, under Linux, different variations of this fault "
"will return B<EIO> or B<EFAULT> more or less arbitrarily."
-msgstr "tracer または tracee のメモリーの不正な領域に読み書きしようとした。 おそらくその領域がマッピングされていないか、 その領域へのアクセスが許されていないかである。 不運なことに、Linux ではこのようなエラーの場合、多かれ少なかれ 恣意的に B<EIO> を返したり B<EFAULT> を返したりすることがある。"
+msgstr ""
+"tracer または tracee のメモリーの不正な領域に読み書きしようとした。 おそらく"
+"その領域がマッピングされていないか、 その領域へのアクセスが許されていないかで"
+"ある。 不運なことに、Linux ではこのようなエラーの場合、多かれ少なかれ 恣意的"
+"に B<EIO> を返したり B<EFAULT> を返したりすることがある。"
#. type: Plain text
#: build/C/man2/ptrace.2:1929
"invalid area in the tracer's or the tracee's memory, or there was a word-"
"alignment violation, or an invalid signal was specified during a restart "
"request."
-msgstr "I<request> が不正である。 または、tracer または tracee のメモリーの 不正な領域に読み書きしようとした。 または、ワード境界違反があった。 または、実行再開の要求で不正なシグナルを指定した。"
+msgstr ""
+"I<request> が不正である。 または、tracer または tracee のメモリーの 不正な領"
+"域に読み書きしようとした。 または、ワード境界違反があった。 または、実行再開"
+"の要求で不正なシグナルを指定した。"
#. type: Plain text
#: build/C/man2/ptrace.2:1949
"to or those running set-user-ID/set-group-ID programs, for obvious reasons. "
"Alternatively, the process may already be being traced, or (on kernels "
"before 2.6.26) be B<init>(1) (PID 1)."
-msgstr "指定したプロセスをトレースすることができない。これは tracer が 必要な権限 (必要なケーパビリティは B<CAP_SYS_PTRACE>) を持っていないことが原因の場合がある。 分かりやすい理由を挙げるなら、 非特権プロセスはシグナルを送ることができないプロセスをトレースできないし、 set-user-ID/set-group-ID プログラムを実行しているプロセスはトレースできない。 または、プロセスはすでにトレース中である、 または (カーネル 2.6.26 より前では) B<init>(1) プロセス (PID が 1) である。"
+msgstr ""
+"指定したプロセスをトレースすることができない。これは tracer が 必要な権限 (必"
+"要なケーパビリティは B<CAP_SYS_PTRACE>) を持っていないことが原因の場合があ"
+"る。 分かりやすい理由を挙げるなら、 非特権プロセスはシグナルを送ることができ"
+"ないプロセスをトレースできないし、 set-user-ID/set-group-ID プログラムを実行"
+"しているプロセスはトレースできない。 または、プロセスはすでにトレース中であ"
+"る、 または (カーネル 2.6.26 より前では) B<init>(1) プロセス (PID が 1) であ"
+"る。"
#. type: Plain text
#: build/C/man2/ptrace.2:1954
msgid ""
"The specified process does not exist, or is not currently being traced by "
"the caller, or is not stopped (for requests that require a stopped tracee)."
-msgstr "指定したプロセスが存在しない。 または、指定したプロセスは呼び出したプロセスがトレース中のプロセスではない。 または、指定したプロセスが停止していない (tracee が停止していることが必要な要求の場合)。"
+msgstr ""
+"指定したプロセスが存在しない。 または、指定したプロセスは呼び出したプロセスが"
+"トレース中のプロセスではない。 または、指定したプロセスが停止していない "
+"(tracee が停止していることが必要な要求の場合)。"
#. type: Plain text
#: build/C/man2/ptrace.2:1956
"function with only the I<request> argument fixed. It is recommended to "
"always supply four arguments, even if the requested operation does not use "
"them, setting unused/ignored arguments to I<0L> or I<(void\\ *)\\ 0>."
-msgstr "B<ptrace>() の引き数は上のようなプロトタイプに基づいて解釈されるが、 glibc では、現在のところ B<ptrace>() は I<request> 引き数だけが固定の可変長引き数関数として宣言されている。 要求する操作が引き数を使用しない場合であっても、 未使用や無視される引き数には I<0L> や I<(void\\ *)\\ 0> を設定して、 4 つの引き数を常に省略せずに指定することを推奨する。"
+msgstr ""
+"B<ptrace>() の引き数は上のようなプロトタイプに基づいて解釈されるが、 glibc "
+"では、現在のところ B<ptrace>() は I<request> 引き数だけが固定の可変長引き数"
+"関数として宣言されている。 要求する操作が引き数を使用しない場合であっても、 "
+"未使用や無視される引き数には I<0L> や I<(void\\ *)\\ 0> を設定して、 4 つの引"
+"き数を常に省略せずに指定することを推奨する。"
#. See commit 00cd5c37afd5f431ac186dd131705048c0a11fdb
#. type: Plain text
#: build/C/man2/vmsplice.2:167
msgid "B<splice>(2), B<tee>(2)"
msgstr "B<splice>(2), B<tee>(2)"
+
+#~ msgid ""
+#~ "B< struct kexec_segment *>I<segments>B<, unsigned long >I<flags>B<);>"
+#~ msgstr ""
+#~ "B< struct kexec_segment *>I<segments>B<, unsigned long >I<flags>B<);>"
+
+#~ msgid "Execute the new kernel automatically on a system crash."
+#~ msgstr "システムのクラッシュ時に、新しいカーネルを自動的に実行する。"
+
+#~ msgid ""
+#~ "The kernel image defined by I<segments> is copied from the calling "
+#~ "process into previously reserved memory."
+#~ msgstr ""
+#~ "I<segments> で定義されたカーネルイメージは、\n"
+#~ "呼び出したプロセスから予約済みメモリーにコピーされる。"
+
+#~ msgid "I<flags> is invalid; or I<nr_segments> is too large"
+#~ msgstr "I<flags> が無効である。 I<nr_segments> が大きすぎる。"
+
+#~ msgid ""
+#~ "The required constants are in the Linux kernel source file I<linux/kexec."
+#~ "h>, which is not currently exported to glibc. Therefore, these constants "
+#~ "must be defined manually."
+#~ msgstr ""
+#~ "必要な定数は Linux カーネルのソースファイル I<linux/kexec.h> で定義されて"
+#~ "いる\n"
+#~ "が、現在のところ glibc には公開されていない。\n"
+#~ "そのため、これらの定数は手動で定義しなければならない。"
+
+#~ msgid "2014-04-15"
+#~ msgstr "2014-04-15"
OSDN Git Service
