History

perf: Update perf_event_type documentation

Due to a discussion with Adrian I had a good look at the perf_event_type record layout and found the documentation to be somewhat unclear.

Peter Zijlstra committed 13 years ago

Commit a5cdd401 parent 17f41572 files · +33 −16Browse files

Showing the changes to include/uapi/linux (1 of 2 files). Show all

Unified · Split

include/uapi/linux/perf_event.h+17−1
@@ -478,6 +478,16 @@ enum perf_event_type { · 477 unmodified lines
478 * file will be supported by older perf tools, with these new optional478 * file will be supported by older perf tools, with these new optional
479 * fields being ignored.479 * fields being ignored.
480 *480 *
481 * struct sample_id {
482 * { u32 pid, tid; } && PERF_SAMPLE_TID
483 * { u64 time; } && PERF_SAMPLE_TIME
484 * { u64 id; } && PERF_SAMPLE_ID
485 * { u64 stream_id;} && PERF_SAMPLE_STREAM_ID
486 * { u32 cpu, res; } && PERF_SAMPLE_CPU
487 * } && perf_event_attr::sample_id_all
488 */
489
490 /*
481 * The MMAP events record the PROT_EXEC mappings so that we can491 * The MMAP events record the PROT_EXEC mappings so that we can
482 * correlate userspace IPs to code. They have the following structure:492 * correlate userspace IPs to code. They have the following structure:
483 *493 *
@@ -498,6 +508,7 @@ enum perf_event_type { · 14 unmodified lines
498 * struct perf_event_header header;508 * struct perf_event_header header;
499 * u64 id;509 * u64 id;
500 * u64 lost;510 * u64 lost;
511 * struct sample_id sample_id;
501 * };512 * };
502 */513 */
503 PERF_RECORD_LOST = 2,514 PERF_RECORD_LOST = 2,
@@ -508,6 +519,7 @@ enum perf_event_type { · 4 unmodified lines
508 *519 *
509 * u32 pid, tid;520 * u32 pid, tid;
510 * char comm[];521 * char comm[];
522 * struct sample_id sample_id;
511 * };523 * };
512 */524 */
513 PERF_RECORD_COMM = 3,525 PERF_RECORD_COMM = 3,
@@ -518,6 +530,7 @@ enum perf_event_type { · 4 unmodified lines
518 * u32 pid, ppid;530 * u32 pid, ppid;
519 * u32 tid, ptid;531 * u32 tid, ptid;
520 * u64 time;532 * u64 time;
533 * struct sample_id sample_id;
521 * };534 * };
522 */535 */
523 PERF_RECORD_EXIT = 4,536 PERF_RECORD_EXIT = 4,
@@ -528,6 +541,7 @@ enum perf_event_type { · 4 unmodified lines
528 * u64 time;541 * u64 time;
529 * u64 id;542 * u64 id;
530 * u64 stream_id;543 * u64 stream_id;
544 * struct sample_id sample_id;
531 * };545 * };
532 */546 */
533 PERF_RECORD_THROTTLE = 5,547 PERF_RECORD_THROTTLE = 5,
@@ -539,6 +553,7 @@ enum perf_event_type { · 5 unmodified lines
539 * u32 pid, ppid;553 * u32 pid, ppid;
540 * u32 tid, ptid;554 * u32 tid, ptid;
541 * u64 time;555 * u64 time;
556 * struct sample_id sample_id;
542 * };557 * };
543 */558 */
544 PERF_RECORD_FORK = 7,559 PERF_RECORD_FORK = 7,
@@ -549,6 +564,7 @@ enum perf_event_type { · 4 unmodified lines
549 * u32 pid, tid;564 * u32 pid, tid;
550 *565 *
551 * struct read_format values;566 * struct read_format values;
567 * struct sample_id sample_id;
552 * };568 * };
553 */569 */
554 PERF_RECORD_READ = 8,570 PERF_RECORD_READ = 8,
@@ -596,7 +612,7 @@ enum perf_event_type { · 41 unmodified lines
596 * u64 dyn_size; } && PERF_SAMPLE_STACK_USER612 * u64 dyn_size; } && PERF_SAMPLE_STACK_USER
597 *613 *
598 * { u64 weight; } && PERF_SAMPLE_WEIGHT614 * { u64 weight; } && PERF_SAMPLE_WEIGHT
599 * { u64 data_src; } && PERF_SAMPLE_DATA_SRC615 * { u64 data_src; } && PERF_SAMPLE_DATA_SRC
600 * };616 * };
601 */617 */
602 PERF_RECORD_SAMPLE = 9,618 PERF_RECORD_SAMPLE = 9,

Keyboard shortcuts

General

Show keyboard shortcuts
?
Focus the current search
/

Issues and pull requests

Open filters
f

Issues, pull requests and Inbox

Select next item
j↓
Select previous item
k↑
Open selected item
Enter
Dismiss filters or clear selection
Esc

Repository code

Go to file
t