perf_event.h 20 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738
  1. /*
  2. * Performance events:
  3. *
  4. * Copyright (C) 2008-2009, Thomas Gleixner <tglx@linutronix.de>
  5. * Copyright (C) 2008-2011, Red Hat, Inc., Ingo Molnar
  6. * Copyright (C) 2008-2011, Red Hat, Inc., Peter Zijlstra
  7. *
  8. * Data type definitions, declarations, prototypes.
  9. *
  10. * Started by: Thomas Gleixner and Ingo Molnar
  11. *
  12. * For licencing details see kernel-base/COPYING
  13. */
  14. #ifndef _UAPI_LINUX_PERF_EVENT_H
  15. #define _UAPI_LINUX_PERF_EVENT_H
  16. #include <linux/types.h>
  17. #include <linux/ioctl.h>
  18. #include <asm/byteorder.h>
  19. /*
  20. * User-space ABI bits:
  21. */
  22. /*
  23. * attr.type
  24. */
  25. enum perf_type_id {
  26. PERF_TYPE_HARDWARE = 0,
  27. PERF_TYPE_SOFTWARE = 1,
  28. PERF_TYPE_TRACEPOINT = 2,
  29. PERF_TYPE_HW_CACHE = 3,
  30. PERF_TYPE_RAW = 4,
  31. PERF_TYPE_BREAKPOINT = 5,
  32. PERF_TYPE_MAX, /* non-ABI */
  33. };
  34. /*
  35. * Generalized performance event event_id types, used by the
  36. * attr.event_id parameter of the sys_perf_event_open()
  37. * syscall:
  38. */
  39. enum perf_hw_id {
  40. /*
  41. * Common hardware events, generalized by the kernel:
  42. */
  43. PERF_COUNT_HW_CPU_CYCLES = 0,
  44. PERF_COUNT_HW_INSTRUCTIONS = 1,
  45. PERF_COUNT_HW_CACHE_REFERENCES = 2,
  46. PERF_COUNT_HW_CACHE_MISSES = 3,
  47. PERF_COUNT_HW_BRANCH_INSTRUCTIONS = 4,
  48. PERF_COUNT_HW_BRANCH_MISSES = 5,
  49. PERF_COUNT_HW_BUS_CYCLES = 6,
  50. PERF_COUNT_HW_STALLED_CYCLES_FRONTEND = 7,
  51. PERF_COUNT_HW_STALLED_CYCLES_BACKEND = 8,
  52. PERF_COUNT_HW_REF_CPU_CYCLES = 9,
  53. PERF_COUNT_HW_MAX, /* non-ABI */
  54. };
  55. /*
  56. * Generalized hardware cache events:
  57. *
  58. * { L1-D, L1-I, LLC, ITLB, DTLB, BPU, NODE } x
  59. * { read, write, prefetch } x
  60. * { accesses, misses }
  61. */
  62. enum perf_hw_cache_id {
  63. PERF_COUNT_HW_CACHE_L1D = 0,
  64. PERF_COUNT_HW_CACHE_L1I = 1,
  65. PERF_COUNT_HW_CACHE_LL = 2,
  66. PERF_COUNT_HW_CACHE_DTLB = 3,
  67. PERF_COUNT_HW_CACHE_ITLB = 4,
  68. PERF_COUNT_HW_CACHE_BPU = 5,
  69. PERF_COUNT_HW_CACHE_NODE = 6,
  70. PERF_COUNT_HW_CACHE_MAX, /* non-ABI */
  71. };
  72. enum perf_hw_cache_op_id {
  73. PERF_COUNT_HW_CACHE_OP_READ = 0,
  74. PERF_COUNT_HW_CACHE_OP_WRITE = 1,
  75. PERF_COUNT_HW_CACHE_OP_PREFETCH = 2,
  76. PERF_COUNT_HW_CACHE_OP_MAX, /* non-ABI */
  77. };
  78. enum perf_hw_cache_op_result_id {
  79. PERF_COUNT_HW_CACHE_RESULT_ACCESS = 0,
  80. PERF_COUNT_HW_CACHE_RESULT_MISS = 1,
  81. PERF_COUNT_HW_CACHE_RESULT_MAX, /* non-ABI */
  82. };
  83. /*
  84. * Special "software" events provided by the kernel, even if the hardware
  85. * does not support performance events. These events measure various
  86. * physical and sw events of the kernel (and allow the profiling of them as
  87. * well):
  88. */
  89. enum perf_sw_ids {
  90. PERF_COUNT_SW_CPU_CLOCK = 0,
  91. PERF_COUNT_SW_TASK_CLOCK = 1,
  92. PERF_COUNT_SW_PAGE_FAULTS = 2,
  93. PERF_COUNT_SW_CONTEXT_SWITCHES = 3,
  94. PERF_COUNT_SW_CPU_MIGRATIONS = 4,
  95. PERF_COUNT_SW_PAGE_FAULTS_MIN = 5,
  96. PERF_COUNT_SW_PAGE_FAULTS_MAJ = 6,
  97. PERF_COUNT_SW_ALIGNMENT_FAULTS = 7,
  98. PERF_COUNT_SW_EMULATION_FAULTS = 8,
  99. PERF_COUNT_SW_MAX, /* non-ABI */
  100. };
  101. /*
  102. * Bits that can be set in attr.sample_type to request information
  103. * in the overflow packets.
  104. */
  105. enum perf_event_sample_format {
  106. PERF_SAMPLE_IP = 1U << 0,
  107. PERF_SAMPLE_TID = 1U << 1,
  108. PERF_SAMPLE_TIME = 1U << 2,
  109. PERF_SAMPLE_ADDR = 1U << 3,
  110. PERF_SAMPLE_READ = 1U << 4,
  111. PERF_SAMPLE_CALLCHAIN = 1U << 5,
  112. PERF_SAMPLE_ID = 1U << 6,
  113. PERF_SAMPLE_CPU = 1U << 7,
  114. PERF_SAMPLE_PERIOD = 1U << 8,
  115. PERF_SAMPLE_STREAM_ID = 1U << 9,
  116. PERF_SAMPLE_RAW = 1U << 10,
  117. PERF_SAMPLE_BRANCH_STACK = 1U << 11,
  118. PERF_SAMPLE_REGS_USER = 1U << 12,
  119. PERF_SAMPLE_STACK_USER = 1U << 13,
  120. PERF_SAMPLE_WEIGHT = 1U << 14,
  121. PERF_SAMPLE_DATA_SRC = 1U << 15,
  122. PERF_SAMPLE_IDENTIFIER = 1U << 16,
  123. PERF_SAMPLE_MAX = 1U << 17, /* non-ABI */
  124. };
  125. /*
  126. * values to program into branch_sample_type when PERF_SAMPLE_BRANCH is set
  127. *
  128. * If the user does not pass priv level information via branch_sample_type,
  129. * the kernel uses the event's priv level. Branch and event priv levels do
  130. * not have to match. Branch priv level is checked for permissions.
  131. *
  132. * The branch types can be combined, however BRANCH_ANY covers all types
  133. * of branches and therefore it supersedes all the other types.
  134. */
  135. enum perf_branch_sample_type {
  136. PERF_SAMPLE_BRANCH_USER = 1U << 0, /* user branches */
  137. PERF_SAMPLE_BRANCH_KERNEL = 1U << 1, /* kernel branches */
  138. PERF_SAMPLE_BRANCH_HV = 1U << 2, /* hypervisor branches */
  139. PERF_SAMPLE_BRANCH_ANY = 1U << 3, /* any branch types */
  140. PERF_SAMPLE_BRANCH_ANY_CALL = 1U << 4, /* any call branch */
  141. PERF_SAMPLE_BRANCH_ANY_RETURN = 1U << 5, /* any return branch */
  142. PERF_SAMPLE_BRANCH_IND_CALL = 1U << 6, /* indirect calls */
  143. PERF_SAMPLE_BRANCH_ABORT_TX = 1U << 7, /* transaction aborts */
  144. PERF_SAMPLE_BRANCH_IN_TX = 1U << 8, /* in transaction */
  145. PERF_SAMPLE_BRANCH_NO_TX = 1U << 9, /* not in transaction */
  146. PERF_SAMPLE_BRANCH_MAX = 1U << 10, /* non-ABI */
  147. };
  148. #define PERF_SAMPLE_BRANCH_PLM_ALL \
  149. (PERF_SAMPLE_BRANCH_USER|\
  150. PERF_SAMPLE_BRANCH_KERNEL|\
  151. PERF_SAMPLE_BRANCH_HV)
  152. /*
  153. * Values to determine ABI of the registers dump.
  154. */
  155. enum perf_sample_regs_abi {
  156. PERF_SAMPLE_REGS_ABI_NONE = 0,
  157. PERF_SAMPLE_REGS_ABI_32 = 1,
  158. PERF_SAMPLE_REGS_ABI_64 = 2,
  159. };
  160. /*
  161. * The format of the data returned by read() on a perf event fd,
  162. * as specified by attr.read_format:
  163. *
  164. * struct read_format {
  165. * { u64 value;
  166. * { u64 time_enabled; } && PERF_FORMAT_TOTAL_TIME_ENABLED
  167. * { u64 time_running; } && PERF_FORMAT_TOTAL_TIME_RUNNING
  168. * { u64 id; } && PERF_FORMAT_ID
  169. * } && !PERF_FORMAT_GROUP
  170. *
  171. * { u64 nr;
  172. * { u64 time_enabled; } && PERF_FORMAT_TOTAL_TIME_ENABLED
  173. * { u64 time_running; } && PERF_FORMAT_TOTAL_TIME_RUNNING
  174. * { u64 value;
  175. * { u64 id; } && PERF_FORMAT_ID
  176. * } cntr[nr];
  177. * } && PERF_FORMAT_GROUP
  178. * };
  179. */
  180. enum perf_event_read_format {
  181. PERF_FORMAT_TOTAL_TIME_ENABLED = 1U << 0,
  182. PERF_FORMAT_TOTAL_TIME_RUNNING = 1U << 1,
  183. PERF_FORMAT_ID = 1U << 2,
  184. PERF_FORMAT_GROUP = 1U << 3,
  185. PERF_FORMAT_MAX = 1U << 4, /* non-ABI */
  186. };
  187. #define PERF_ATTR_SIZE_VER0 64 /* sizeof first published struct */
  188. #define PERF_ATTR_SIZE_VER1 72 /* add: config2 */
  189. #define PERF_ATTR_SIZE_VER2 80 /* add: branch_sample_type */
  190. #define PERF_ATTR_SIZE_VER3 96 /* add: sample_regs_user */
  191. /* add: sample_stack_user */
  192. /*
  193. * Hardware event_id to monitor via a performance monitoring event:
  194. */
  195. struct perf_event_attr {
  196. /*
  197. * Major type: hardware/software/tracepoint/etc.
  198. */
  199. __u32 type;
  200. /*
  201. * Size of the attr structure, for fwd/bwd compat.
  202. */
  203. __u32 size;
  204. /*
  205. * Type specific configuration information.
  206. */
  207. __u64 config;
  208. union {
  209. __u64 sample_period;
  210. __u64 sample_freq;
  211. };
  212. __u64 sample_type;
  213. __u64 read_format;
  214. __u64 disabled : 1, /* off by default */
  215. inherit : 1, /* children inherit it */
  216. pinned : 1, /* must always be on PMU */
  217. exclusive : 1, /* only group on PMU */
  218. exclude_user : 1, /* don't count user */
  219. exclude_kernel : 1, /* ditto kernel */
  220. exclude_hv : 1, /* ditto hypervisor */
  221. exclude_idle : 1, /* don't count when idle */
  222. mmap : 1, /* include mmap data */
  223. comm : 1, /* include comm data */
  224. freq : 1, /* use freq, not period */
  225. inherit_stat : 1, /* per task counts */
  226. enable_on_exec : 1, /* next exec enables */
  227. task : 1, /* trace fork/exit */
  228. watermark : 1, /* wakeup_watermark */
  229. /*
  230. * precise_ip:
  231. *
  232. * 0 - SAMPLE_IP can have arbitrary skid
  233. * 1 - SAMPLE_IP must have constant skid
  234. * 2 - SAMPLE_IP requested to have 0 skid
  235. * 3 - SAMPLE_IP must have 0 skid
  236. *
  237. * See also PERF_RECORD_MISC_EXACT_IP
  238. */
  239. precise_ip : 2, /* skid constraint */
  240. mmap_data : 1, /* non-exec mmap data */
  241. sample_id_all : 1, /* sample_type all events */
  242. exclude_host : 1, /* don't count in host */
  243. exclude_guest : 1, /* don't count in guest */
  244. exclude_callchain_kernel : 1, /* exclude kernel callchains */
  245. exclude_callchain_user : 1, /* exclude user callchains */
  246. __reserved_1 : 41;
  247. union {
  248. __u32 wakeup_events; /* wakeup every n events */
  249. __u32 wakeup_watermark; /* bytes before wakeup */
  250. };
  251. __u32 bp_type;
  252. union {
  253. __u64 bp_addr;
  254. __u64 config1; /* extension of config */
  255. };
  256. union {
  257. __u64 bp_len;
  258. __u64 config2; /* extension of config1 */
  259. };
  260. __u64 branch_sample_type; /* enum perf_branch_sample_type */
  261. /*
  262. * Defines set of user regs to dump on samples.
  263. * See asm/perf_regs.h for details.
  264. */
  265. __u64 sample_regs_user;
  266. /*
  267. * Defines size of the user stack to dump on samples.
  268. */
  269. __u32 sample_stack_user;
  270. /* Align to u64. */
  271. __u32 __reserved_2;
  272. };
  273. #define perf_flags(attr) (*(&(attr)->read_format + 1))
  274. /*
  275. * Ioctls that can be done on a perf event fd:
  276. */
  277. #define PERF_EVENT_IOC_ENABLE _IO ('$', 0)
  278. #define PERF_EVENT_IOC_DISABLE _IO ('$', 1)
  279. #define PERF_EVENT_IOC_REFRESH _IO ('$', 2)
  280. #define PERF_EVENT_IOC_RESET _IO ('$', 3)
  281. #define PERF_EVENT_IOC_PERIOD _IOW('$', 4, __u64)
  282. #define PERF_EVENT_IOC_SET_OUTPUT _IO ('$', 5)
  283. #define PERF_EVENT_IOC_SET_FILTER _IOW('$', 6, char *)
  284. #define PERF_EVENT_IOC_ID _IOR('$', 7, u64 *)
  285. enum perf_event_ioc_flags {
  286. PERF_IOC_FLAG_GROUP = 1U << 0,
  287. };
  288. /*
  289. * Structure of the page that can be mapped via mmap
  290. */
  291. struct perf_event_mmap_page {
  292. __u32 version; /* version number of this structure */
  293. __u32 compat_version; /* lowest version this is compat with */
  294. /*
  295. * Bits needed to read the hw events in user-space.
  296. *
  297. * u32 seq, time_mult, time_shift, idx, width;
  298. * u64 count, enabled, running;
  299. * u64 cyc, time_offset;
  300. * s64 pmc = 0;
  301. *
  302. * do {
  303. * seq = pc->lock;
  304. * barrier()
  305. *
  306. * enabled = pc->time_enabled;
  307. * running = pc->time_running;
  308. *
  309. * if (pc->cap_usr_time && enabled != running) {
  310. * cyc = rdtsc();
  311. * time_offset = pc->time_offset;
  312. * time_mult = pc->time_mult;
  313. * time_shift = pc->time_shift;
  314. * }
  315. *
  316. * idx = pc->index;
  317. * count = pc->offset;
  318. * if (pc->cap_usr_rdpmc && idx) {
  319. * width = pc->pmc_width;
  320. * pmc = rdpmc(idx - 1);
  321. * }
  322. *
  323. * barrier();
  324. * } while (pc->lock != seq);
  325. *
  326. * NOTE: for obvious reason this only works on self-monitoring
  327. * processes.
  328. */
  329. __u32 lock; /* seqlock for synchronization */
  330. __u32 index; /* hardware event identifier */
  331. __s64 offset; /* add to hardware event value */
  332. __u64 time_enabled; /* time event active */
  333. __u64 time_running; /* time event on cpu */
  334. union {
  335. __u64 capabilities;
  336. struct {
  337. __u64 cap_usr_time : 1,
  338. cap_usr_rdpmc : 1,
  339. cap_usr_time_zero : 1,
  340. cap_____res : 61;
  341. };
  342. };
  343. /*
  344. * If cap_usr_rdpmc this field provides the bit-width of the value
  345. * read using the rdpmc() or equivalent instruction. This can be used
  346. * to sign extend the result like:
  347. *
  348. * pmc <<= 64 - width;
  349. * pmc >>= 64 - width; // signed shift right
  350. * count += pmc;
  351. */
  352. __u16 pmc_width;
  353. /*
  354. * If cap_usr_time the below fields can be used to compute the time
  355. * delta since time_enabled (in ns) using rdtsc or similar.
  356. *
  357. * u64 quot, rem;
  358. * u64 delta;
  359. *
  360. * quot = (cyc >> time_shift);
  361. * rem = cyc & ((1 << time_shift) - 1);
  362. * delta = time_offset + quot * time_mult +
  363. * ((rem * time_mult) >> time_shift);
  364. *
  365. * Where time_offset,time_mult,time_shift and cyc are read in the
  366. * seqcount loop described above. This delta can then be added to
  367. * enabled and possible running (if idx), improving the scaling:
  368. *
  369. * enabled += delta;
  370. * if (idx)
  371. * running += delta;
  372. *
  373. * quot = count / running;
  374. * rem = count % running;
  375. * count = quot * enabled + (rem * enabled) / running;
  376. */
  377. __u16 time_shift;
  378. __u32 time_mult;
  379. __u64 time_offset;
  380. /*
  381. * If cap_usr_time_zero, the hardware clock (e.g. TSC) can be calculated
  382. * from sample timestamps.
  383. *
  384. * time = timestamp - time_zero;
  385. * quot = time / time_mult;
  386. * rem = time % time_mult;
  387. * cyc = (quot << time_shift) + (rem << time_shift) / time_mult;
  388. *
  389. * And vice versa:
  390. *
  391. * quot = cyc >> time_shift;
  392. * rem = cyc & ((1 << time_shift) - 1);
  393. * timestamp = time_zero + quot * time_mult +
  394. * ((rem * time_mult) >> time_shift);
  395. */
  396. __u64 time_zero;
  397. /*
  398. * Hole for extension of the self monitor capabilities
  399. */
  400. __u64 __reserved[119]; /* align to 1k */
  401. /*
  402. * Control data for the mmap() data buffer.
  403. *
  404. * User-space reading the @data_head value should issue an rmb(), on
  405. * SMP capable platforms, after reading this value -- see
  406. * perf_event_wakeup().
  407. *
  408. * When the mapping is PROT_WRITE the @data_tail value should be
  409. * written by userspace to reflect the last read data. In this case
  410. * the kernel will not over-write unread data.
  411. */
  412. __u64 data_head; /* head in the data section */
  413. __u64 data_tail; /* user-space written tail */
  414. };
  415. #define PERF_RECORD_MISC_CPUMODE_MASK (7 << 0)
  416. #define PERF_RECORD_MISC_CPUMODE_UNKNOWN (0 << 0)
  417. #define PERF_RECORD_MISC_KERNEL (1 << 0)
  418. #define PERF_RECORD_MISC_USER (2 << 0)
  419. #define PERF_RECORD_MISC_HYPERVISOR (3 << 0)
  420. #define PERF_RECORD_MISC_GUEST_KERNEL (4 << 0)
  421. #define PERF_RECORD_MISC_GUEST_USER (5 << 0)
  422. #define PERF_RECORD_MISC_MMAP_DATA (1 << 13)
  423. /*
  424. * Indicates that the content of PERF_SAMPLE_IP points to
  425. * the actual instruction that triggered the event. See also
  426. * perf_event_attr::precise_ip.
  427. */
  428. #define PERF_RECORD_MISC_EXACT_IP (1 << 14)
  429. /*
  430. * Reserve the last bit to indicate some extended misc field
  431. */
  432. #define PERF_RECORD_MISC_EXT_RESERVED (1 << 15)
  433. struct perf_event_header {
  434. __u32 type;
  435. __u16 misc;
  436. __u16 size;
  437. };
  438. enum perf_event_type {
  439. /*
  440. * If perf_event_attr.sample_id_all is set then all event types will
  441. * have the sample_type selected fields related to where/when
  442. * (identity) an event took place (TID, TIME, ID, STREAM_ID, CPU,
  443. * IDENTIFIER) described in PERF_RECORD_SAMPLE below, it will be stashed
  444. * just after the perf_event_header and the fields already present for
  445. * the existing fields, i.e. at the end of the payload. That way a newer
  446. * perf.data file will be supported by older perf tools, with these new
  447. * optional fields being ignored.
  448. *
  449. * struct sample_id {
  450. * { u32 pid, tid; } && PERF_SAMPLE_TID
  451. * { u64 time; } && PERF_SAMPLE_TIME
  452. * { u64 id; } && PERF_SAMPLE_ID
  453. * { u64 stream_id;} && PERF_SAMPLE_STREAM_ID
  454. * { u32 cpu, res; } && PERF_SAMPLE_CPU
  455. * { u64 id; } && PERF_SAMPLE_IDENTIFIER
  456. * } && perf_event_attr::sample_id_all
  457. *
  458. * Note that PERF_SAMPLE_IDENTIFIER duplicates PERF_SAMPLE_ID. The
  459. * advantage of PERF_SAMPLE_IDENTIFIER is that its position is fixed
  460. * relative to header.size.
  461. */
  462. /*
  463. * The MMAP events record the PROT_EXEC mappings so that we can
  464. * correlate userspace IPs to code. They have the following structure:
  465. *
  466. * struct {
  467. * struct perf_event_header header;
  468. *
  469. * u32 pid, tid;
  470. * u64 addr;
  471. * u64 len;
  472. * u64 pgoff;
  473. * char filename[];
  474. * };
  475. */
  476. PERF_RECORD_MMAP = 1,
  477. /*
  478. * struct {
  479. * struct perf_event_header header;
  480. * u64 id;
  481. * u64 lost;
  482. * struct sample_id sample_id;
  483. * };
  484. */
  485. PERF_RECORD_LOST = 2,
  486. /*
  487. * struct {
  488. * struct perf_event_header header;
  489. *
  490. * u32 pid, tid;
  491. * char comm[];
  492. * struct sample_id sample_id;
  493. * };
  494. */
  495. PERF_RECORD_COMM = 3,
  496. /*
  497. * struct {
  498. * struct perf_event_header header;
  499. * u32 pid, ppid;
  500. * u32 tid, ptid;
  501. * u64 time;
  502. * struct sample_id sample_id;
  503. * };
  504. */
  505. PERF_RECORD_EXIT = 4,
  506. /*
  507. * struct {
  508. * struct perf_event_header header;
  509. * u64 time;
  510. * u64 id;
  511. * u64 stream_id;
  512. * struct sample_id sample_id;
  513. * };
  514. */
  515. PERF_RECORD_THROTTLE = 5,
  516. PERF_RECORD_UNTHROTTLE = 6,
  517. /*
  518. * struct {
  519. * struct perf_event_header header;
  520. * u32 pid, ppid;
  521. * u32 tid, ptid;
  522. * u64 time;
  523. * struct sample_id sample_id;
  524. * };
  525. */
  526. PERF_RECORD_FORK = 7,
  527. /*
  528. * struct {
  529. * struct perf_event_header header;
  530. * u32 pid, tid;
  531. *
  532. * struct read_format values;
  533. * struct sample_id sample_id;
  534. * };
  535. */
  536. PERF_RECORD_READ = 8,
  537. /*
  538. * struct {
  539. * struct perf_event_header header;
  540. *
  541. * #
  542. * # Note that PERF_SAMPLE_IDENTIFIER duplicates PERF_SAMPLE_ID.
  543. * # The advantage of PERF_SAMPLE_IDENTIFIER is that its position
  544. * # is fixed relative to header.
  545. * #
  546. *
  547. * { u64 id; } && PERF_SAMPLE_IDENTIFIER
  548. * { u64 ip; } && PERF_SAMPLE_IP
  549. * { u32 pid, tid; } && PERF_SAMPLE_TID
  550. * { u64 time; } && PERF_SAMPLE_TIME
  551. * { u64 addr; } && PERF_SAMPLE_ADDR
  552. * { u64 id; } && PERF_SAMPLE_ID
  553. * { u64 stream_id;} && PERF_SAMPLE_STREAM_ID
  554. * { u32 cpu, res; } && PERF_SAMPLE_CPU
  555. * { u64 period; } && PERF_SAMPLE_PERIOD
  556. *
  557. * { struct read_format values; } && PERF_SAMPLE_READ
  558. *
  559. * { u64 nr,
  560. * u64 ips[nr]; } && PERF_SAMPLE_CALLCHAIN
  561. *
  562. * #
  563. * # The RAW record below is opaque data wrt the ABI
  564. * #
  565. * # That is, the ABI doesn't make any promises wrt to
  566. * # the stability of its content, it may vary depending
  567. * # on event, hardware, kernel version and phase of
  568. * # the moon.
  569. * #
  570. * # In other words, PERF_SAMPLE_RAW contents are not an ABI.
  571. * #
  572. *
  573. * { u32 size;
  574. * char data[size];}&& PERF_SAMPLE_RAW
  575. *
  576. * { u64 nr;
  577. * { u64 from, to, flags } lbr[nr];} && PERF_SAMPLE_BRANCH_STACK
  578. *
  579. * { u64 abi; # enum perf_sample_regs_abi
  580. * u64 regs[weight(mask)]; } && PERF_SAMPLE_REGS_USER
  581. *
  582. * { u64 size;
  583. * char data[size];
  584. * u64 dyn_size; } && PERF_SAMPLE_STACK_USER
  585. *
  586. * { u64 weight; } && PERF_SAMPLE_WEIGHT
  587. * { u64 data_src; } && PERF_SAMPLE_DATA_SRC
  588. * };
  589. */
  590. PERF_RECORD_SAMPLE = 9,
  591. PERF_RECORD_MAX, /* non-ABI */
  592. };
  593. #define PERF_MAX_STACK_DEPTH 127
  594. enum perf_callchain_context {
  595. PERF_CONTEXT_HV = (__u64)-32,
  596. PERF_CONTEXT_KERNEL = (__u64)-128,
  597. PERF_CONTEXT_USER = (__u64)-512,
  598. PERF_CONTEXT_GUEST = (__u64)-2048,
  599. PERF_CONTEXT_GUEST_KERNEL = (__u64)-2176,
  600. PERF_CONTEXT_GUEST_USER = (__u64)-2560,
  601. PERF_CONTEXT_MAX = (__u64)-4095,
  602. };
  603. #define PERF_FLAG_FD_NO_GROUP (1U << 0)
  604. #define PERF_FLAG_FD_OUTPUT (1U << 1)
  605. #define PERF_FLAG_PID_CGROUP (1U << 2) /* pid=cgroup id, per-cpu mode only */
  606. union perf_mem_data_src {
  607. __u64 val;
  608. struct {
  609. __u64 mem_op:5, /* type of opcode */
  610. mem_lvl:14, /* memory hierarchy level */
  611. mem_snoop:5, /* snoop mode */
  612. mem_lock:2, /* lock instr */
  613. mem_dtlb:7, /* tlb access */
  614. mem_rsvd:31;
  615. };
  616. };
  617. /* type of opcode (load/store/prefetch,code) */
  618. #define PERF_MEM_OP_NA 0x01 /* not available */
  619. #define PERF_MEM_OP_LOAD 0x02 /* load instruction */
  620. #define PERF_MEM_OP_STORE 0x04 /* store instruction */
  621. #define PERF_MEM_OP_PFETCH 0x08 /* prefetch */
  622. #define PERF_MEM_OP_EXEC 0x10 /* code (execution) */
  623. #define PERF_MEM_OP_SHIFT 0
  624. /* memory hierarchy (memory level, hit or miss) */
  625. #define PERF_MEM_LVL_NA 0x01 /* not available */
  626. #define PERF_MEM_LVL_HIT 0x02 /* hit level */
  627. #define PERF_MEM_LVL_MISS 0x04 /* miss level */
  628. #define PERF_MEM_LVL_L1 0x08 /* L1 */
  629. #define PERF_MEM_LVL_LFB 0x10 /* Line Fill Buffer */
  630. #define PERF_MEM_LVL_L2 0x20 /* L2 */
  631. #define PERF_MEM_LVL_L3 0x40 /* L3 */
  632. #define PERF_MEM_LVL_LOC_RAM 0x80 /* Local DRAM */
  633. #define PERF_MEM_LVL_REM_RAM1 0x100 /* Remote DRAM (1 hop) */
  634. #define PERF_MEM_LVL_REM_RAM2 0x200 /* Remote DRAM (2 hops) */
  635. #define PERF_MEM_LVL_REM_CCE1 0x400 /* Remote Cache (1 hop) */
  636. #define PERF_MEM_LVL_REM_CCE2 0x800 /* Remote Cache (2 hops) */
  637. #define PERF_MEM_LVL_IO 0x1000 /* I/O memory */
  638. #define PERF_MEM_LVL_UNC 0x2000 /* Uncached memory */
  639. #define PERF_MEM_LVL_SHIFT 5
  640. /* snoop mode */
  641. #define PERF_MEM_SNOOP_NA 0x01 /* not available */
  642. #define PERF_MEM_SNOOP_NONE 0x02 /* no snoop */
  643. #define PERF_MEM_SNOOP_HIT 0x04 /* snoop hit */
  644. #define PERF_MEM_SNOOP_MISS 0x08 /* snoop miss */
  645. #define PERF_MEM_SNOOP_HITM 0x10 /* snoop hit modified */
  646. #define PERF_MEM_SNOOP_SHIFT 19
  647. /* locked instruction */
  648. #define PERF_MEM_LOCK_NA 0x01 /* not available */
  649. #define PERF_MEM_LOCK_LOCKED 0x02 /* locked transaction */
  650. #define PERF_MEM_LOCK_SHIFT 24
  651. /* TLB access */
  652. #define PERF_MEM_TLB_NA 0x01 /* not available */
  653. #define PERF_MEM_TLB_HIT 0x02 /* hit level */
  654. #define PERF_MEM_TLB_MISS 0x04 /* miss level */
  655. #define PERF_MEM_TLB_L1 0x08 /* L1 */
  656. #define PERF_MEM_TLB_L2 0x10 /* L2 */
  657. #define PERF_MEM_TLB_WK 0x20 /* Hardware Walker*/
  658. #define PERF_MEM_TLB_OS 0x40 /* OS fault handler */
  659. #define PERF_MEM_TLB_SHIFT 26
  660. #define PERF_MEM_S(a, s) \
  661. (((u64)PERF_MEM_##a##_##s) << PERF_MEM_##a##_SHIFT)
  662. #endif /* _UAPI_LINUX_PERF_EVENT_H */