auxtrace.c 32 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393
  1. /*
  2. * auxtrace.c: AUX area trace support
  3. * Copyright (c) 2013-2015, Intel Corporation.
  4. *
  5. * This program is free software; you can redistribute it and/or modify it
  6. * under the terms and conditions of the GNU General Public License,
  7. * version 2, as published by the Free Software Foundation.
  8. *
  9. * This program is distributed in the hope it will be useful, but WITHOUT
  10. * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  11. * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
  12. * more details.
  13. *
  14. */
  15. #include <sys/types.h>
  16. #include <sys/mman.h>
  17. #include <stdbool.h>
  18. #include <linux/kernel.h>
  19. #include <linux/perf_event.h>
  20. #include <linux/types.h>
  21. #include <linux/bitops.h>
  22. #include <linux/log2.h>
  23. #include <linux/string.h>
  24. #include <sys/param.h>
  25. #include <stdlib.h>
  26. #include <stdio.h>
  27. #include <string.h>
  28. #include <limits.h>
  29. #include <errno.h>
  30. #include <linux/list.h>
  31. #include "../perf.h"
  32. #include "util.h"
  33. #include "evlist.h"
  34. #include "cpumap.h"
  35. #include "thread_map.h"
  36. #include "asm/bug.h"
  37. #include "auxtrace.h"
  38. #include <linux/hash.h>
  39. #include "event.h"
  40. #include "session.h"
  41. #include "debug.h"
  42. #include <subcmd/parse-options.h>
  43. #include "intel-pt.h"
  44. #include "intel-bts.h"
  45. int auxtrace_mmap__mmap(struct auxtrace_mmap *mm,
  46. struct auxtrace_mmap_params *mp,
  47. void *userpg, int fd)
  48. {
  49. struct perf_event_mmap_page *pc = userpg;
  50. WARN_ONCE(mm->base, "Uninitialized auxtrace_mmap\n");
  51. mm->userpg = userpg;
  52. mm->mask = mp->mask;
  53. mm->len = mp->len;
  54. mm->prev = 0;
  55. mm->idx = mp->idx;
  56. mm->tid = mp->tid;
  57. mm->cpu = mp->cpu;
  58. if (!mp->len) {
  59. mm->base = NULL;
  60. return 0;
  61. }
  62. #if BITS_PER_LONG != 64 && !defined(HAVE_SYNC_COMPARE_AND_SWAP_SUPPORT)
  63. pr_err("Cannot use AUX area tracing mmaps\n");
  64. return -1;
  65. #endif
  66. pc->aux_offset = mp->offset;
  67. pc->aux_size = mp->len;
  68. mm->base = mmap(NULL, mp->len, mp->prot, MAP_SHARED, fd, mp->offset);
  69. if (mm->base == MAP_FAILED) {
  70. pr_debug2("failed to mmap AUX area\n");
  71. mm->base = NULL;
  72. return -1;
  73. }
  74. return 0;
  75. }
  76. void auxtrace_mmap__munmap(struct auxtrace_mmap *mm)
  77. {
  78. if (mm->base) {
  79. munmap(mm->base, mm->len);
  80. mm->base = NULL;
  81. }
  82. }
  83. void auxtrace_mmap_params__init(struct auxtrace_mmap_params *mp,
  84. off_t auxtrace_offset,
  85. unsigned int auxtrace_pages,
  86. bool auxtrace_overwrite)
  87. {
  88. if (auxtrace_pages) {
  89. mp->offset = auxtrace_offset;
  90. mp->len = auxtrace_pages * (size_t)page_size;
  91. mp->mask = is_power_of_2(mp->len) ? mp->len - 1 : 0;
  92. mp->prot = PROT_READ | (auxtrace_overwrite ? 0 : PROT_WRITE);
  93. pr_debug2("AUX area mmap length %zu\n", mp->len);
  94. } else {
  95. mp->len = 0;
  96. }
  97. }
  98. void auxtrace_mmap_params__set_idx(struct auxtrace_mmap_params *mp,
  99. struct perf_evlist *evlist, int idx,
  100. bool per_cpu)
  101. {
  102. mp->idx = idx;
  103. if (per_cpu) {
  104. mp->cpu = evlist->cpus->map[idx];
  105. if (evlist->threads)
  106. mp->tid = thread_map__pid(evlist->threads, 0);
  107. else
  108. mp->tid = -1;
  109. } else {
  110. mp->cpu = -1;
  111. mp->tid = thread_map__pid(evlist->threads, idx);
  112. }
  113. }
  114. #define AUXTRACE_INIT_NR_QUEUES 32
  115. static struct auxtrace_queue *auxtrace_alloc_queue_array(unsigned int nr_queues)
  116. {
  117. struct auxtrace_queue *queue_array;
  118. unsigned int max_nr_queues, i;
  119. max_nr_queues = UINT_MAX / sizeof(struct auxtrace_queue);
  120. if (nr_queues > max_nr_queues)
  121. return NULL;
  122. queue_array = calloc(nr_queues, sizeof(struct auxtrace_queue));
  123. if (!queue_array)
  124. return NULL;
  125. for (i = 0; i < nr_queues; i++) {
  126. INIT_LIST_HEAD(&queue_array[i].head);
  127. queue_array[i].priv = NULL;
  128. }
  129. return queue_array;
  130. }
  131. int auxtrace_queues__init(struct auxtrace_queues *queues)
  132. {
  133. queues->nr_queues = AUXTRACE_INIT_NR_QUEUES;
  134. queues->queue_array = auxtrace_alloc_queue_array(queues->nr_queues);
  135. if (!queues->queue_array)
  136. return -ENOMEM;
  137. return 0;
  138. }
  139. static int auxtrace_queues__grow(struct auxtrace_queues *queues,
  140. unsigned int new_nr_queues)
  141. {
  142. unsigned int nr_queues = queues->nr_queues;
  143. struct auxtrace_queue *queue_array;
  144. unsigned int i;
  145. if (!nr_queues)
  146. nr_queues = AUXTRACE_INIT_NR_QUEUES;
  147. while (nr_queues && nr_queues < new_nr_queues)
  148. nr_queues <<= 1;
  149. if (nr_queues < queues->nr_queues || nr_queues < new_nr_queues)
  150. return -EINVAL;
  151. queue_array = auxtrace_alloc_queue_array(nr_queues);
  152. if (!queue_array)
  153. return -ENOMEM;
  154. for (i = 0; i < queues->nr_queues; i++) {
  155. list_splice_tail(&queues->queue_array[i].head,
  156. &queue_array[i].head);
  157. queue_array[i].priv = queues->queue_array[i].priv;
  158. }
  159. queues->nr_queues = nr_queues;
  160. queues->queue_array = queue_array;
  161. return 0;
  162. }
  163. static void *auxtrace_copy_data(u64 size, struct perf_session *session)
  164. {
  165. int fd = perf_data_file__fd(session->file);
  166. void *p;
  167. ssize_t ret;
  168. if (size > SSIZE_MAX)
  169. return NULL;
  170. p = malloc(size);
  171. if (!p)
  172. return NULL;
  173. ret = readn(fd, p, size);
  174. if (ret != (ssize_t)size) {
  175. free(p);
  176. return NULL;
  177. }
  178. return p;
  179. }
  180. static int auxtrace_queues__add_buffer(struct auxtrace_queues *queues,
  181. unsigned int idx,
  182. struct auxtrace_buffer *buffer)
  183. {
  184. struct auxtrace_queue *queue;
  185. int err;
  186. if (idx >= queues->nr_queues) {
  187. err = auxtrace_queues__grow(queues, idx + 1);
  188. if (err)
  189. return err;
  190. }
  191. queue = &queues->queue_array[idx];
  192. if (!queue->set) {
  193. queue->set = true;
  194. queue->tid = buffer->tid;
  195. queue->cpu = buffer->cpu;
  196. } else if (buffer->cpu != queue->cpu || buffer->tid != queue->tid) {
  197. pr_err("auxtrace queue conflict: cpu %d, tid %d vs cpu %d, tid %d\n",
  198. queue->cpu, queue->tid, buffer->cpu, buffer->tid);
  199. return -EINVAL;
  200. }
  201. buffer->buffer_nr = queues->next_buffer_nr++;
  202. list_add_tail(&buffer->list, &queue->head);
  203. queues->new_data = true;
  204. queues->populated = true;
  205. return 0;
  206. }
  207. /* Limit buffers to 32MiB on 32-bit */
  208. #define BUFFER_LIMIT_FOR_32_BIT (32 * 1024 * 1024)
  209. static int auxtrace_queues__split_buffer(struct auxtrace_queues *queues,
  210. unsigned int idx,
  211. struct auxtrace_buffer *buffer)
  212. {
  213. u64 sz = buffer->size;
  214. bool consecutive = false;
  215. struct auxtrace_buffer *b;
  216. int err;
  217. while (sz > BUFFER_LIMIT_FOR_32_BIT) {
  218. b = memdup(buffer, sizeof(struct auxtrace_buffer));
  219. if (!b)
  220. return -ENOMEM;
  221. b->size = BUFFER_LIMIT_FOR_32_BIT;
  222. b->consecutive = consecutive;
  223. err = auxtrace_queues__add_buffer(queues, idx, b);
  224. if (err) {
  225. auxtrace_buffer__free(b);
  226. return err;
  227. }
  228. buffer->data_offset += BUFFER_LIMIT_FOR_32_BIT;
  229. sz -= BUFFER_LIMIT_FOR_32_BIT;
  230. consecutive = true;
  231. }
  232. buffer->size = sz;
  233. buffer->consecutive = consecutive;
  234. return 0;
  235. }
  236. static int auxtrace_queues__add_event_buffer(struct auxtrace_queues *queues,
  237. struct perf_session *session,
  238. unsigned int idx,
  239. struct auxtrace_buffer *buffer)
  240. {
  241. if (session->one_mmap) {
  242. buffer->data = buffer->data_offset - session->one_mmap_offset +
  243. session->one_mmap_addr;
  244. } else if (perf_data_file__is_pipe(session->file)) {
  245. buffer->data = auxtrace_copy_data(buffer->size, session);
  246. if (!buffer->data)
  247. return -ENOMEM;
  248. buffer->data_needs_freeing = true;
  249. } else if (BITS_PER_LONG == 32 &&
  250. buffer->size > BUFFER_LIMIT_FOR_32_BIT) {
  251. int err;
  252. err = auxtrace_queues__split_buffer(queues, idx, buffer);
  253. if (err)
  254. return err;
  255. }
  256. return auxtrace_queues__add_buffer(queues, idx, buffer);
  257. }
  258. int auxtrace_queues__add_event(struct auxtrace_queues *queues,
  259. struct perf_session *session,
  260. union perf_event *event, off_t data_offset,
  261. struct auxtrace_buffer **buffer_ptr)
  262. {
  263. struct auxtrace_buffer *buffer;
  264. unsigned int idx;
  265. int err;
  266. buffer = zalloc(sizeof(struct auxtrace_buffer));
  267. if (!buffer)
  268. return -ENOMEM;
  269. buffer->pid = -1;
  270. buffer->tid = event->auxtrace.tid;
  271. buffer->cpu = event->auxtrace.cpu;
  272. buffer->data_offset = data_offset;
  273. buffer->offset = event->auxtrace.offset;
  274. buffer->reference = event->auxtrace.reference;
  275. buffer->size = event->auxtrace.size;
  276. idx = event->auxtrace.idx;
  277. err = auxtrace_queues__add_event_buffer(queues, session, idx, buffer);
  278. if (err)
  279. goto out_err;
  280. if (buffer_ptr)
  281. *buffer_ptr = buffer;
  282. return 0;
  283. out_err:
  284. auxtrace_buffer__free(buffer);
  285. return err;
  286. }
  287. static int auxtrace_queues__add_indexed_event(struct auxtrace_queues *queues,
  288. struct perf_session *session,
  289. off_t file_offset, size_t sz)
  290. {
  291. union perf_event *event;
  292. int err;
  293. char buf[PERF_SAMPLE_MAX_SIZE];
  294. err = perf_session__peek_event(session, file_offset, buf,
  295. PERF_SAMPLE_MAX_SIZE, &event, NULL);
  296. if (err)
  297. return err;
  298. if (event->header.type == PERF_RECORD_AUXTRACE) {
  299. if (event->header.size < sizeof(struct auxtrace_event) ||
  300. event->header.size != sz) {
  301. err = -EINVAL;
  302. goto out;
  303. }
  304. file_offset += event->header.size;
  305. err = auxtrace_queues__add_event(queues, session, event,
  306. file_offset, NULL);
  307. }
  308. out:
  309. return err;
  310. }
  311. void auxtrace_queues__free(struct auxtrace_queues *queues)
  312. {
  313. unsigned int i;
  314. for (i = 0; i < queues->nr_queues; i++) {
  315. while (!list_empty(&queues->queue_array[i].head)) {
  316. struct auxtrace_buffer *buffer;
  317. buffer = list_entry(queues->queue_array[i].head.next,
  318. struct auxtrace_buffer, list);
  319. list_del(&buffer->list);
  320. auxtrace_buffer__free(buffer);
  321. }
  322. }
  323. zfree(&queues->queue_array);
  324. queues->nr_queues = 0;
  325. }
  326. static void auxtrace_heapify(struct auxtrace_heap_item *heap_array,
  327. unsigned int pos, unsigned int queue_nr,
  328. u64 ordinal)
  329. {
  330. unsigned int parent;
  331. while (pos) {
  332. parent = (pos - 1) >> 1;
  333. if (heap_array[parent].ordinal <= ordinal)
  334. break;
  335. heap_array[pos] = heap_array[parent];
  336. pos = parent;
  337. }
  338. heap_array[pos].queue_nr = queue_nr;
  339. heap_array[pos].ordinal = ordinal;
  340. }
  341. int auxtrace_heap__add(struct auxtrace_heap *heap, unsigned int queue_nr,
  342. u64 ordinal)
  343. {
  344. struct auxtrace_heap_item *heap_array;
  345. if (queue_nr >= heap->heap_sz) {
  346. unsigned int heap_sz = AUXTRACE_INIT_NR_QUEUES;
  347. while (heap_sz <= queue_nr)
  348. heap_sz <<= 1;
  349. heap_array = realloc(heap->heap_array,
  350. heap_sz * sizeof(struct auxtrace_heap_item));
  351. if (!heap_array)
  352. return -ENOMEM;
  353. heap->heap_array = heap_array;
  354. heap->heap_sz = heap_sz;
  355. }
  356. auxtrace_heapify(heap->heap_array, heap->heap_cnt++, queue_nr, ordinal);
  357. return 0;
  358. }
  359. void auxtrace_heap__free(struct auxtrace_heap *heap)
  360. {
  361. zfree(&heap->heap_array);
  362. heap->heap_cnt = 0;
  363. heap->heap_sz = 0;
  364. }
  365. void auxtrace_heap__pop(struct auxtrace_heap *heap)
  366. {
  367. unsigned int pos, last, heap_cnt = heap->heap_cnt;
  368. struct auxtrace_heap_item *heap_array;
  369. if (!heap_cnt)
  370. return;
  371. heap->heap_cnt -= 1;
  372. heap_array = heap->heap_array;
  373. pos = 0;
  374. while (1) {
  375. unsigned int left, right;
  376. left = (pos << 1) + 1;
  377. if (left >= heap_cnt)
  378. break;
  379. right = left + 1;
  380. if (right >= heap_cnt) {
  381. heap_array[pos] = heap_array[left];
  382. return;
  383. }
  384. if (heap_array[left].ordinal < heap_array[right].ordinal) {
  385. heap_array[pos] = heap_array[left];
  386. pos = left;
  387. } else {
  388. heap_array[pos] = heap_array[right];
  389. pos = right;
  390. }
  391. }
  392. last = heap_cnt - 1;
  393. auxtrace_heapify(heap_array, pos, heap_array[last].queue_nr,
  394. heap_array[last].ordinal);
  395. }
  396. size_t auxtrace_record__info_priv_size(struct auxtrace_record *itr,
  397. struct perf_evlist *evlist)
  398. {
  399. if (itr)
  400. return itr->info_priv_size(itr, evlist);
  401. return 0;
  402. }
  403. static int auxtrace_not_supported(void)
  404. {
  405. pr_err("AUX area tracing is not supported on this architecture\n");
  406. return -EINVAL;
  407. }
  408. int auxtrace_record__info_fill(struct auxtrace_record *itr,
  409. struct perf_session *session,
  410. struct auxtrace_info_event *auxtrace_info,
  411. size_t priv_size)
  412. {
  413. if (itr)
  414. return itr->info_fill(itr, session, auxtrace_info, priv_size);
  415. return auxtrace_not_supported();
  416. }
  417. void auxtrace_record__free(struct auxtrace_record *itr)
  418. {
  419. if (itr)
  420. itr->free(itr);
  421. }
  422. int auxtrace_record__snapshot_start(struct auxtrace_record *itr)
  423. {
  424. if (itr && itr->snapshot_start)
  425. return itr->snapshot_start(itr);
  426. return 0;
  427. }
  428. int auxtrace_record__snapshot_finish(struct auxtrace_record *itr)
  429. {
  430. if (itr && itr->snapshot_finish)
  431. return itr->snapshot_finish(itr);
  432. return 0;
  433. }
  434. int auxtrace_record__find_snapshot(struct auxtrace_record *itr, int idx,
  435. struct auxtrace_mmap *mm,
  436. unsigned char *data, u64 *head, u64 *old)
  437. {
  438. if (itr && itr->find_snapshot)
  439. return itr->find_snapshot(itr, idx, mm, data, head, old);
  440. return 0;
  441. }
  442. int auxtrace_record__options(struct auxtrace_record *itr,
  443. struct perf_evlist *evlist,
  444. struct record_opts *opts)
  445. {
  446. if (itr)
  447. return itr->recording_options(itr, evlist, opts);
  448. return 0;
  449. }
  450. u64 auxtrace_record__reference(struct auxtrace_record *itr)
  451. {
  452. if (itr)
  453. return itr->reference(itr);
  454. return 0;
  455. }
  456. int auxtrace_parse_snapshot_options(struct auxtrace_record *itr,
  457. struct record_opts *opts, const char *str)
  458. {
  459. if (!str)
  460. return 0;
  461. if (itr)
  462. return itr->parse_snapshot_options(itr, opts, str);
  463. pr_err("No AUX area tracing to snapshot\n");
  464. return -EINVAL;
  465. }
  466. struct auxtrace_record *__weak
  467. auxtrace_record__init(struct perf_evlist *evlist __maybe_unused, int *err)
  468. {
  469. *err = 0;
  470. return NULL;
  471. }
  472. static int auxtrace_index__alloc(struct list_head *head)
  473. {
  474. struct auxtrace_index *auxtrace_index;
  475. auxtrace_index = malloc(sizeof(struct auxtrace_index));
  476. if (!auxtrace_index)
  477. return -ENOMEM;
  478. auxtrace_index->nr = 0;
  479. INIT_LIST_HEAD(&auxtrace_index->list);
  480. list_add_tail(&auxtrace_index->list, head);
  481. return 0;
  482. }
  483. void auxtrace_index__free(struct list_head *head)
  484. {
  485. struct auxtrace_index *auxtrace_index, *n;
  486. list_for_each_entry_safe(auxtrace_index, n, head, list) {
  487. list_del(&auxtrace_index->list);
  488. free(auxtrace_index);
  489. }
  490. }
  491. static struct auxtrace_index *auxtrace_index__last(struct list_head *head)
  492. {
  493. struct auxtrace_index *auxtrace_index;
  494. int err;
  495. if (list_empty(head)) {
  496. err = auxtrace_index__alloc(head);
  497. if (err)
  498. return NULL;
  499. }
  500. auxtrace_index = list_entry(head->prev, struct auxtrace_index, list);
  501. if (auxtrace_index->nr >= PERF_AUXTRACE_INDEX_ENTRY_COUNT) {
  502. err = auxtrace_index__alloc(head);
  503. if (err)
  504. return NULL;
  505. auxtrace_index = list_entry(head->prev, struct auxtrace_index,
  506. list);
  507. }
  508. return auxtrace_index;
  509. }
  510. int auxtrace_index__auxtrace_event(struct list_head *head,
  511. union perf_event *event, off_t file_offset)
  512. {
  513. struct auxtrace_index *auxtrace_index;
  514. size_t nr;
  515. auxtrace_index = auxtrace_index__last(head);
  516. if (!auxtrace_index)
  517. return -ENOMEM;
  518. nr = auxtrace_index->nr;
  519. auxtrace_index->entries[nr].file_offset = file_offset;
  520. auxtrace_index->entries[nr].sz = event->header.size;
  521. auxtrace_index->nr += 1;
  522. return 0;
  523. }
  524. static int auxtrace_index__do_write(int fd,
  525. struct auxtrace_index *auxtrace_index)
  526. {
  527. struct auxtrace_index_entry ent;
  528. size_t i;
  529. for (i = 0; i < auxtrace_index->nr; i++) {
  530. ent.file_offset = auxtrace_index->entries[i].file_offset;
  531. ent.sz = auxtrace_index->entries[i].sz;
  532. if (writen(fd, &ent, sizeof(ent)) != sizeof(ent))
  533. return -errno;
  534. }
  535. return 0;
  536. }
  537. int auxtrace_index__write(int fd, struct list_head *head)
  538. {
  539. struct auxtrace_index *auxtrace_index;
  540. u64 total = 0;
  541. int err;
  542. list_for_each_entry(auxtrace_index, head, list)
  543. total += auxtrace_index->nr;
  544. if (writen(fd, &total, sizeof(total)) != sizeof(total))
  545. return -errno;
  546. list_for_each_entry(auxtrace_index, head, list) {
  547. err = auxtrace_index__do_write(fd, auxtrace_index);
  548. if (err)
  549. return err;
  550. }
  551. return 0;
  552. }
  553. static int auxtrace_index__process_entry(int fd, struct list_head *head,
  554. bool needs_swap)
  555. {
  556. struct auxtrace_index *auxtrace_index;
  557. struct auxtrace_index_entry ent;
  558. size_t nr;
  559. if (readn(fd, &ent, sizeof(ent)) != sizeof(ent))
  560. return -1;
  561. auxtrace_index = auxtrace_index__last(head);
  562. if (!auxtrace_index)
  563. return -1;
  564. nr = auxtrace_index->nr;
  565. if (needs_swap) {
  566. auxtrace_index->entries[nr].file_offset =
  567. bswap_64(ent.file_offset);
  568. auxtrace_index->entries[nr].sz = bswap_64(ent.sz);
  569. } else {
  570. auxtrace_index->entries[nr].file_offset = ent.file_offset;
  571. auxtrace_index->entries[nr].sz = ent.sz;
  572. }
  573. auxtrace_index->nr = nr + 1;
  574. return 0;
  575. }
  576. int auxtrace_index__process(int fd, u64 size, struct perf_session *session,
  577. bool needs_swap)
  578. {
  579. struct list_head *head = &session->auxtrace_index;
  580. u64 nr;
  581. if (readn(fd, &nr, sizeof(u64)) != sizeof(u64))
  582. return -1;
  583. if (needs_swap)
  584. nr = bswap_64(nr);
  585. if (sizeof(u64) + nr * sizeof(struct auxtrace_index_entry) > size)
  586. return -1;
  587. while (nr--) {
  588. int err;
  589. err = auxtrace_index__process_entry(fd, head, needs_swap);
  590. if (err)
  591. return -1;
  592. }
  593. return 0;
  594. }
  595. static int auxtrace_queues__process_index_entry(struct auxtrace_queues *queues,
  596. struct perf_session *session,
  597. struct auxtrace_index_entry *ent)
  598. {
  599. return auxtrace_queues__add_indexed_event(queues, session,
  600. ent->file_offset, ent->sz);
  601. }
  602. int auxtrace_queues__process_index(struct auxtrace_queues *queues,
  603. struct perf_session *session)
  604. {
  605. struct auxtrace_index *auxtrace_index;
  606. struct auxtrace_index_entry *ent;
  607. size_t i;
  608. int err;
  609. list_for_each_entry(auxtrace_index, &session->auxtrace_index, list) {
  610. for (i = 0; i < auxtrace_index->nr; i++) {
  611. ent = &auxtrace_index->entries[i];
  612. err = auxtrace_queues__process_index_entry(queues,
  613. session,
  614. ent);
  615. if (err)
  616. return err;
  617. }
  618. }
  619. return 0;
  620. }
  621. struct auxtrace_buffer *auxtrace_buffer__next(struct auxtrace_queue *queue,
  622. struct auxtrace_buffer *buffer)
  623. {
  624. if (buffer) {
  625. if (list_is_last(&buffer->list, &queue->head))
  626. return NULL;
  627. return list_entry(buffer->list.next, struct auxtrace_buffer,
  628. list);
  629. } else {
  630. if (list_empty(&queue->head))
  631. return NULL;
  632. return list_entry(queue->head.next, struct auxtrace_buffer,
  633. list);
  634. }
  635. }
  636. void *auxtrace_buffer__get_data(struct auxtrace_buffer *buffer, int fd)
  637. {
  638. size_t adj = buffer->data_offset & (page_size - 1);
  639. size_t size = buffer->size + adj;
  640. off_t file_offset = buffer->data_offset - adj;
  641. void *addr;
  642. if (buffer->data)
  643. return buffer->data;
  644. addr = mmap(NULL, size, PROT_READ, MAP_SHARED, fd, file_offset);
  645. if (addr == MAP_FAILED)
  646. return NULL;
  647. buffer->mmap_addr = addr;
  648. buffer->mmap_size = size;
  649. buffer->data = addr + adj;
  650. return buffer->data;
  651. }
  652. void auxtrace_buffer__put_data(struct auxtrace_buffer *buffer)
  653. {
  654. if (!buffer->data || !buffer->mmap_addr)
  655. return;
  656. munmap(buffer->mmap_addr, buffer->mmap_size);
  657. buffer->mmap_addr = NULL;
  658. buffer->mmap_size = 0;
  659. buffer->data = NULL;
  660. buffer->use_data = NULL;
  661. }
  662. void auxtrace_buffer__drop_data(struct auxtrace_buffer *buffer)
  663. {
  664. auxtrace_buffer__put_data(buffer);
  665. if (buffer->data_needs_freeing) {
  666. buffer->data_needs_freeing = false;
  667. zfree(&buffer->data);
  668. buffer->use_data = NULL;
  669. buffer->size = 0;
  670. }
  671. }
  672. void auxtrace_buffer__free(struct auxtrace_buffer *buffer)
  673. {
  674. auxtrace_buffer__drop_data(buffer);
  675. free(buffer);
  676. }
  677. void auxtrace_synth_error(struct auxtrace_error_event *auxtrace_error, int type,
  678. int code, int cpu, pid_t pid, pid_t tid, u64 ip,
  679. const char *msg)
  680. {
  681. size_t size;
  682. memset(auxtrace_error, 0, sizeof(struct auxtrace_error_event));
  683. auxtrace_error->header.type = PERF_RECORD_AUXTRACE_ERROR;
  684. auxtrace_error->type = type;
  685. auxtrace_error->code = code;
  686. auxtrace_error->cpu = cpu;
  687. auxtrace_error->pid = pid;
  688. auxtrace_error->tid = tid;
  689. auxtrace_error->ip = ip;
  690. strlcpy(auxtrace_error->msg, msg, MAX_AUXTRACE_ERROR_MSG);
  691. size = (void *)auxtrace_error->msg - (void *)auxtrace_error +
  692. strlen(auxtrace_error->msg) + 1;
  693. auxtrace_error->header.size = PERF_ALIGN(size, sizeof(u64));
  694. }
  695. int perf_event__synthesize_auxtrace_info(struct auxtrace_record *itr,
  696. struct perf_tool *tool,
  697. struct perf_session *session,
  698. perf_event__handler_t process)
  699. {
  700. union perf_event *ev;
  701. size_t priv_size;
  702. int err;
  703. pr_debug2("Synthesizing auxtrace information\n");
  704. priv_size = auxtrace_record__info_priv_size(itr, session->evlist);
  705. ev = zalloc(sizeof(struct auxtrace_info_event) + priv_size);
  706. if (!ev)
  707. return -ENOMEM;
  708. ev->auxtrace_info.header.type = PERF_RECORD_AUXTRACE_INFO;
  709. ev->auxtrace_info.header.size = sizeof(struct auxtrace_info_event) +
  710. priv_size;
  711. err = auxtrace_record__info_fill(itr, session, &ev->auxtrace_info,
  712. priv_size);
  713. if (err)
  714. goto out_free;
  715. err = process(tool, ev, NULL, NULL);
  716. out_free:
  717. free(ev);
  718. return err;
  719. }
  720. static bool auxtrace__dont_decode(struct perf_session *session)
  721. {
  722. return !session->itrace_synth_opts ||
  723. session->itrace_synth_opts->dont_decode;
  724. }
  725. int perf_event__process_auxtrace_info(struct perf_tool *tool __maybe_unused,
  726. union perf_event *event,
  727. struct perf_session *session)
  728. {
  729. enum auxtrace_type type = event->auxtrace_info.type;
  730. if (dump_trace)
  731. fprintf(stdout, " type: %u\n", type);
  732. switch (type) {
  733. case PERF_AUXTRACE_INTEL_PT:
  734. return intel_pt_process_auxtrace_info(event, session);
  735. case PERF_AUXTRACE_INTEL_BTS:
  736. return intel_bts_process_auxtrace_info(event, session);
  737. case PERF_AUXTRACE_UNKNOWN:
  738. default:
  739. return -EINVAL;
  740. }
  741. }
  742. s64 perf_event__process_auxtrace(struct perf_tool *tool,
  743. union perf_event *event,
  744. struct perf_session *session)
  745. {
  746. s64 err;
  747. if (dump_trace)
  748. fprintf(stdout, " size: %#"PRIx64" offset: %#"PRIx64" ref: %#"PRIx64" idx: %u tid: %d cpu: %d\n",
  749. event->auxtrace.size, event->auxtrace.offset,
  750. event->auxtrace.reference, event->auxtrace.idx,
  751. event->auxtrace.tid, event->auxtrace.cpu);
  752. if (auxtrace__dont_decode(session))
  753. return event->auxtrace.size;
  754. if (!session->auxtrace || event->header.type != PERF_RECORD_AUXTRACE)
  755. return -EINVAL;
  756. err = session->auxtrace->process_auxtrace_event(session, event, tool);
  757. if (err < 0)
  758. return err;
  759. return event->auxtrace.size;
  760. }
  761. #define PERF_ITRACE_DEFAULT_PERIOD_TYPE PERF_ITRACE_PERIOD_NANOSECS
  762. #define PERF_ITRACE_DEFAULT_PERIOD 100000
  763. #define PERF_ITRACE_DEFAULT_CALLCHAIN_SZ 16
  764. #define PERF_ITRACE_MAX_CALLCHAIN_SZ 1024
  765. #define PERF_ITRACE_DEFAULT_LAST_BRANCH_SZ 64
  766. #define PERF_ITRACE_MAX_LAST_BRANCH_SZ 1024
  767. void itrace_synth_opts__set_default(struct itrace_synth_opts *synth_opts)
  768. {
  769. synth_opts->instructions = true;
  770. synth_opts->branches = true;
  771. synth_opts->transactions = true;
  772. synth_opts->errors = true;
  773. synth_opts->period_type = PERF_ITRACE_DEFAULT_PERIOD_TYPE;
  774. synth_opts->period = PERF_ITRACE_DEFAULT_PERIOD;
  775. synth_opts->callchain_sz = PERF_ITRACE_DEFAULT_CALLCHAIN_SZ;
  776. synth_opts->last_branch_sz = PERF_ITRACE_DEFAULT_LAST_BRANCH_SZ;
  777. }
  778. /*
  779. * Please check tools/perf/Documentation/perf-script.txt for information
  780. * about the options parsed here, which is introduced after this cset,
  781. * when support in 'perf script' for these options is introduced.
  782. */
  783. int itrace_parse_synth_opts(const struct option *opt, const char *str,
  784. int unset)
  785. {
  786. struct itrace_synth_opts *synth_opts = opt->value;
  787. const char *p;
  788. char *endptr;
  789. bool period_type_set = false;
  790. bool period_set = false;
  791. synth_opts->set = true;
  792. if (unset) {
  793. synth_opts->dont_decode = true;
  794. return 0;
  795. }
  796. if (!str) {
  797. itrace_synth_opts__set_default(synth_opts);
  798. return 0;
  799. }
  800. for (p = str; *p;) {
  801. switch (*p++) {
  802. case 'i':
  803. synth_opts->instructions = true;
  804. while (*p == ' ' || *p == ',')
  805. p += 1;
  806. if (isdigit(*p)) {
  807. synth_opts->period = strtoull(p, &endptr, 10);
  808. period_set = true;
  809. p = endptr;
  810. while (*p == ' ' || *p == ',')
  811. p += 1;
  812. switch (*p++) {
  813. case 'i':
  814. synth_opts->period_type =
  815. PERF_ITRACE_PERIOD_INSTRUCTIONS;
  816. period_type_set = true;
  817. break;
  818. case 't':
  819. synth_opts->period_type =
  820. PERF_ITRACE_PERIOD_TICKS;
  821. period_type_set = true;
  822. break;
  823. case 'm':
  824. synth_opts->period *= 1000;
  825. /* Fall through */
  826. case 'u':
  827. synth_opts->period *= 1000;
  828. /* Fall through */
  829. case 'n':
  830. if (*p++ != 's')
  831. goto out_err;
  832. synth_opts->period_type =
  833. PERF_ITRACE_PERIOD_NANOSECS;
  834. period_type_set = true;
  835. break;
  836. case '\0':
  837. goto out;
  838. default:
  839. goto out_err;
  840. }
  841. }
  842. break;
  843. case 'b':
  844. synth_opts->branches = true;
  845. break;
  846. case 'x':
  847. synth_opts->transactions = true;
  848. break;
  849. case 'e':
  850. synth_opts->errors = true;
  851. break;
  852. case 'd':
  853. synth_opts->log = true;
  854. break;
  855. case 'c':
  856. synth_opts->branches = true;
  857. synth_opts->calls = true;
  858. break;
  859. case 'r':
  860. synth_opts->branches = true;
  861. synth_opts->returns = true;
  862. break;
  863. case 'g':
  864. synth_opts->callchain = true;
  865. synth_opts->callchain_sz =
  866. PERF_ITRACE_DEFAULT_CALLCHAIN_SZ;
  867. while (*p == ' ' || *p == ',')
  868. p += 1;
  869. if (isdigit(*p)) {
  870. unsigned int val;
  871. val = strtoul(p, &endptr, 10);
  872. p = endptr;
  873. if (!val || val > PERF_ITRACE_MAX_CALLCHAIN_SZ)
  874. goto out_err;
  875. synth_opts->callchain_sz = val;
  876. }
  877. break;
  878. case 'l':
  879. synth_opts->last_branch = true;
  880. synth_opts->last_branch_sz =
  881. PERF_ITRACE_DEFAULT_LAST_BRANCH_SZ;
  882. while (*p == ' ' || *p == ',')
  883. p += 1;
  884. if (isdigit(*p)) {
  885. unsigned int val;
  886. val = strtoul(p, &endptr, 10);
  887. p = endptr;
  888. if (!val ||
  889. val > PERF_ITRACE_MAX_LAST_BRANCH_SZ)
  890. goto out_err;
  891. synth_opts->last_branch_sz = val;
  892. }
  893. break;
  894. case ' ':
  895. case ',':
  896. break;
  897. default:
  898. goto out_err;
  899. }
  900. }
  901. out:
  902. if (synth_opts->instructions) {
  903. if (!period_type_set)
  904. synth_opts->period_type =
  905. PERF_ITRACE_DEFAULT_PERIOD_TYPE;
  906. if (!period_set)
  907. synth_opts->period = PERF_ITRACE_DEFAULT_PERIOD;
  908. }
  909. return 0;
  910. out_err:
  911. pr_err("Bad Instruction Tracing options '%s'\n", str);
  912. return -EINVAL;
  913. }
  914. static const char * const auxtrace_error_type_name[] = {
  915. [PERF_AUXTRACE_ERROR_ITRACE] = "instruction trace",
  916. };
  917. static const char *auxtrace_error_name(int type)
  918. {
  919. const char *error_type_name = NULL;
  920. if (type < PERF_AUXTRACE_ERROR_MAX)
  921. error_type_name = auxtrace_error_type_name[type];
  922. if (!error_type_name)
  923. error_type_name = "unknown AUX";
  924. return error_type_name;
  925. }
  926. size_t perf_event__fprintf_auxtrace_error(union perf_event *event, FILE *fp)
  927. {
  928. struct auxtrace_error_event *e = &event->auxtrace_error;
  929. int ret;
  930. ret = fprintf(fp, " %s error type %u",
  931. auxtrace_error_name(e->type), e->type);
  932. ret += fprintf(fp, " cpu %d pid %d tid %d ip %#"PRIx64" code %u: %s\n",
  933. e->cpu, e->pid, e->tid, e->ip, e->code, e->msg);
  934. return ret;
  935. }
  936. void perf_session__auxtrace_error_inc(struct perf_session *session,
  937. union perf_event *event)
  938. {
  939. struct auxtrace_error_event *e = &event->auxtrace_error;
  940. if (e->type < PERF_AUXTRACE_ERROR_MAX)
  941. session->evlist->stats.nr_auxtrace_errors[e->type] += 1;
  942. }
  943. void events_stats__auxtrace_error_warn(const struct events_stats *stats)
  944. {
  945. int i;
  946. for (i = 0; i < PERF_AUXTRACE_ERROR_MAX; i++) {
  947. if (!stats->nr_auxtrace_errors[i])
  948. continue;
  949. ui__warning("%u %s errors\n",
  950. stats->nr_auxtrace_errors[i],
  951. auxtrace_error_name(i));
  952. }
  953. }
  954. int perf_event__process_auxtrace_error(struct perf_tool *tool __maybe_unused,
  955. union perf_event *event,
  956. struct perf_session *session)
  957. {
  958. if (auxtrace__dont_decode(session))
  959. return 0;
  960. perf_event__fprintf_auxtrace_error(event, stdout);
  961. return 0;
  962. }
  963. static int __auxtrace_mmap__read(struct auxtrace_mmap *mm,
  964. struct auxtrace_record *itr,
  965. struct perf_tool *tool, process_auxtrace_t fn,
  966. bool snapshot, size_t snapshot_size)
  967. {
  968. u64 head, old = mm->prev, offset, ref;
  969. unsigned char *data = mm->base;
  970. size_t size, head_off, old_off, len1, len2, padding;
  971. union perf_event ev;
  972. void *data1, *data2;
  973. if (snapshot) {
  974. head = auxtrace_mmap__read_snapshot_head(mm);
  975. if (auxtrace_record__find_snapshot(itr, mm->idx, mm, data,
  976. &head, &old))
  977. return -1;
  978. } else {
  979. head = auxtrace_mmap__read_head(mm);
  980. }
  981. if (old == head)
  982. return 0;
  983. pr_debug3("auxtrace idx %d old %#"PRIx64" head %#"PRIx64" diff %#"PRIx64"\n",
  984. mm->idx, old, head, head - old);
  985. if (mm->mask) {
  986. head_off = head & mm->mask;
  987. old_off = old & mm->mask;
  988. } else {
  989. head_off = head % mm->len;
  990. old_off = old % mm->len;
  991. }
  992. if (head_off > old_off)
  993. size = head_off - old_off;
  994. else
  995. size = mm->len - (old_off - head_off);
  996. if (snapshot && size > snapshot_size)
  997. size = snapshot_size;
  998. ref = auxtrace_record__reference(itr);
  999. if (head > old || size <= head || mm->mask) {
  1000. offset = head - size;
  1001. } else {
  1002. /*
  1003. * When the buffer size is not a power of 2, 'head' wraps at the
  1004. * highest multiple of the buffer size, so we have to subtract
  1005. * the remainder here.
  1006. */
  1007. u64 rem = (0ULL - mm->len) % mm->len;
  1008. offset = head - size - rem;
  1009. }
  1010. if (size > head_off) {
  1011. len1 = size - head_off;
  1012. data1 = &data[mm->len - len1];
  1013. len2 = head_off;
  1014. data2 = &data[0];
  1015. } else {
  1016. len1 = size;
  1017. data1 = &data[head_off - len1];
  1018. len2 = 0;
  1019. data2 = NULL;
  1020. }
  1021. if (itr->alignment) {
  1022. unsigned int unwanted = len1 % itr->alignment;
  1023. len1 -= unwanted;
  1024. size -= unwanted;
  1025. }
  1026. /* padding must be written by fn() e.g. record__process_auxtrace() */
  1027. padding = size & 7;
  1028. if (padding)
  1029. padding = 8 - padding;
  1030. memset(&ev, 0, sizeof(ev));
  1031. ev.auxtrace.header.type = PERF_RECORD_AUXTRACE;
  1032. ev.auxtrace.header.size = sizeof(ev.auxtrace);
  1033. ev.auxtrace.size = size + padding;
  1034. ev.auxtrace.offset = offset;
  1035. ev.auxtrace.reference = ref;
  1036. ev.auxtrace.idx = mm->idx;
  1037. ev.auxtrace.tid = mm->tid;
  1038. ev.auxtrace.cpu = mm->cpu;
  1039. if (fn(tool, &ev, data1, len1, data2, len2))
  1040. return -1;
  1041. mm->prev = head;
  1042. if (!snapshot) {
  1043. auxtrace_mmap__write_tail(mm, head);
  1044. if (itr->read_finish) {
  1045. int err;
  1046. err = itr->read_finish(itr, mm->idx);
  1047. if (err < 0)
  1048. return err;
  1049. }
  1050. }
  1051. return 1;
  1052. }
  1053. int auxtrace_mmap__read(struct auxtrace_mmap *mm, struct auxtrace_record *itr,
  1054. struct perf_tool *tool, process_auxtrace_t fn)
  1055. {
  1056. return __auxtrace_mmap__read(mm, itr, tool, fn, false, 0);
  1057. }
  1058. int auxtrace_mmap__read_snapshot(struct auxtrace_mmap *mm,
  1059. struct auxtrace_record *itr,
  1060. struct perf_tool *tool, process_auxtrace_t fn,
  1061. size_t snapshot_size)
  1062. {
  1063. return __auxtrace_mmap__read(mm, itr, tool, fn, true, snapshot_size);
  1064. }
  1065. /**
  1066. * struct auxtrace_cache - hash table to implement a cache
  1067. * @hashtable: the hashtable
  1068. * @sz: hashtable size (number of hlists)
  1069. * @entry_size: size of an entry
  1070. * @limit: limit the number of entries to this maximum, when reached the cache
  1071. * is dropped and caching begins again with an empty cache
  1072. * @cnt: current number of entries
  1073. * @bits: hashtable size (@sz = 2^@bits)
  1074. */
  1075. struct auxtrace_cache {
  1076. struct hlist_head *hashtable;
  1077. size_t sz;
  1078. size_t entry_size;
  1079. size_t limit;
  1080. size_t cnt;
  1081. unsigned int bits;
  1082. };
  1083. struct auxtrace_cache *auxtrace_cache__new(unsigned int bits, size_t entry_size,
  1084. unsigned int limit_percent)
  1085. {
  1086. struct auxtrace_cache *c;
  1087. struct hlist_head *ht;
  1088. size_t sz, i;
  1089. c = zalloc(sizeof(struct auxtrace_cache));
  1090. if (!c)
  1091. return NULL;
  1092. sz = 1UL << bits;
  1093. ht = calloc(sz, sizeof(struct hlist_head));
  1094. if (!ht)
  1095. goto out_free;
  1096. for (i = 0; i < sz; i++)
  1097. INIT_HLIST_HEAD(&ht[i]);
  1098. c->hashtable = ht;
  1099. c->sz = sz;
  1100. c->entry_size = entry_size;
  1101. c->limit = (c->sz * limit_percent) / 100;
  1102. c->bits = bits;
  1103. return c;
  1104. out_free:
  1105. free(c);
  1106. return NULL;
  1107. }
  1108. static void auxtrace_cache__drop(struct auxtrace_cache *c)
  1109. {
  1110. struct auxtrace_cache_entry *entry;
  1111. struct hlist_node *tmp;
  1112. size_t i;
  1113. if (!c)
  1114. return;
  1115. for (i = 0; i < c->sz; i++) {
  1116. hlist_for_each_entry_safe(entry, tmp, &c->hashtable[i], hash) {
  1117. hlist_del(&entry->hash);
  1118. auxtrace_cache__free_entry(c, entry);
  1119. }
  1120. }
  1121. c->cnt = 0;
  1122. }
  1123. void auxtrace_cache__free(struct auxtrace_cache *c)
  1124. {
  1125. if (!c)
  1126. return;
  1127. auxtrace_cache__drop(c);
  1128. free(c->hashtable);
  1129. free(c);
  1130. }
  1131. void *auxtrace_cache__alloc_entry(struct auxtrace_cache *c)
  1132. {
  1133. return malloc(c->entry_size);
  1134. }
  1135. void auxtrace_cache__free_entry(struct auxtrace_cache *c __maybe_unused,
  1136. void *entry)
  1137. {
  1138. free(entry);
  1139. }
  1140. int auxtrace_cache__add(struct auxtrace_cache *c, u32 key,
  1141. struct auxtrace_cache_entry *entry)
  1142. {
  1143. if (c->limit && ++c->cnt > c->limit)
  1144. auxtrace_cache__drop(c);
  1145. entry->key = key;
  1146. hlist_add_head(&entry->hash, &c->hashtable[hash_32(key, c->bits)]);
  1147. return 0;
  1148. }
  1149. void *auxtrace_cache__lookup(struct auxtrace_cache *c, u32 key)
  1150. {
  1151. struct auxtrace_cache_entry *entry;
  1152. struct hlist_head *hlist;
  1153. if (!c)
  1154. return NULL;
  1155. hlist = &c->hashtable[hash_32(key, c->bits)];
  1156. hlist_for_each_entry(entry, hlist, hash) {
  1157. if (entry->key == key)
  1158. return entry;
  1159. }
  1160. return NULL;
  1161. }