perf_event.h 20 KB

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