perf_event_open(2) - Russkiy

union {
__u64 sample_period; /* период выборки */
__u64 sample_freq; /* частота выборки */
};

__u64 sample_type; /* значения, включённые в измерение */
__u64 read_format; /* значения, возвращаемые при чтении */

__u64 disabled : 1, /* по умолчанию выключено */
inherit : 1, /* потомок наследует это */
pinned : 1, /* должно быть всегда на PMU */
exclusive : 1, /* только группа на PMU */
exclude_user : 1, /* не учитывать режим пользователя */
exclude_kernel : 1, /* не учитывать режим ядра */
exclude_hv : 1, /* не учитывать режим гипервизора */
exclude_idle : 1, /* не учитывать простой */
mmap : 1, /* включать данные mmap */
comm : 1, /* включать данные comm */
freq : 1, /* использовать частоту вместо
периода */
inherit_stat : 1, /* позадачный учёт */
enable_on_exec : 1, /* включать при следующем exec */
task : 1, /* трассировка fork/exit */
watermark : 1, /* wakeup_watermark */
precise_ip : 2, /* ограничение skid */
mmap_data : 1, /* неисполняемые данные mmap */
sample_id_all : 1, /* sample_type всех событий */
exclude_host : 1, /* не учитывать на узле */
exclude_guest : 1, /* не учитывать на госте */
exclude_callchain_kernel : 1,
/* исключать цепочки ядерных
вызовов */
exclude_callchain_user : 1,
/* исключать цепочки пользовательских
вызовов */
mmap2 : 1, /* включать mmap с данными inode */
comm_exec : 1, /* помечать события comm,
произошедшие из-за exec */
use_clockid : 1, /* использовать clockid в полях
времени */
context_switch : 1, /* данные переключения контекста */

__reserved_1 : 37;

union {
__u32 wakeup_events; /* пробуждаться каждые n событий */
__u32 wakeup_watermark; /* байт до пробуждения */
};

__u32 bp_type; /* тип точки останова */

union {
__u64 bp_addr; /* адрес точки останова */
__u64 kprobe_func; /* для perf_kprobe */
__u64 uprobe_path; /* для perf_uprobe */
__u64 config1; /* расширение of config */
};

union {
__u64 bp_len; /* длина точки останова */
__u64 kprobe_addr; /* с kprobe_func == NULL */
__u64 probe_offset; /* для perf_[k,u]probe */
__u64 config2; /* расширение config1 */
};
__u64 branch_sample_type; /* enum perf_branch_sample_type */
__u64 sample_regs_user; /* пользовательские регистры,
записываемые в замер */
__u32 sample_stack_user; /* размер стека, записываемые в
замер */
__s32 clockid; /* часы, используемые в полях
времени */
__u64 sample_regs_intr; /* регистры, записываемые в замер */
__u32 aux_watermark; /* вспомогательные байт перед
пробуждением */
__u16 sample_max_stack; /* максимальное количество фреймов
в цепочке вызовов */
__u16 __reserved_2; /* выравнивание до u64 */

};

Если type равно PERF_TYPE_TRACEPOINT, то измеряется точки трассировки ядра. Значение, используемое в config, можно получить из debugfs tracing/events/*/*/id, если ftrace включён в ядре.

Если type равно PERF_TYPE_HW_CACHE, то измеряется событие кэша аппаратного ЦП. Для вычисления соответствующего значения config используйте следующую формулу:

    (perf_hw_cache_id) | (perf_hw_cache_op_id << 8) |
    (perf_hw_cache_op_result_id << 16)

Если type равно PERF_TYPE_RAW, то требуется пользовательское «неструктурированное» значение config. Большинство ЦП поддерживают события, которые не подпадают под «общие» события. Они определяются реализацией; смотрите руководство на ЦП (например, документацию Intel Volume 3B или AMD BIOS и руководство разработчика ядра). Для трансляции ожидаемых значений в этом поле шестнадцатеричных значений в perf_event_open() из имён справочников по архитектуре можно использовать библиотеку libpfm4.

Если type равно PERF_TYPE_BREAKPOINT, то присвойте config значение 0. Его параметры задаются в других местах.

Если type равно kprobe или uprobe, установите retprobe (бит 0 в config, смотрите /sys/bus/event_source/devices/[k,u]probe/format/retprobe) равным kretprobe/uretprobe. Дополнительную информацию смотрите в описании полей kprobe_func, uprobe_path, kprobe_addr и probe_offset.

do {
seq = pc->lock;
barrier();
enabled = pc->time_enabled;
running = pc->time_running;

if (pc->cap_usr_time && enabled != running) {
cyc = rdtsc();
time_offset = pc->time_offset;
time_mult = pc->time_mult;
time_shift = pc->time_shift;
}

idx = pc->index;
count = pc->offset;

if (pc->cap_usr_rdpmc && idx) {
width = pc->pmc_width;
count += rdpmc(idx - 1);
}

barrier(); } while (pc->lock != seq);

Так как следующие три состояния сгенерированы различными типами записей, то они указывают на один и тот же бит:

Также могут устанавливаться следующие биты: