evlist.c 16 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676
  1. /*
  2. * Copyright (C) 2011, Red Hat Inc, Arnaldo Carvalho de Melo <acme@redhat.com>
  3. *
  4. * Parts came from builtin-{top,stat,record}.c, see those files for further
  5. * copyright notes.
  6. *
  7. * Released under the GPL v2. (and only v2, not any later version)
  8. */
  9. #include "util.h"
  10. #include "debugfs.h"
  11. #include <poll.h>
  12. #include "cpumap.h"
  13. #include "thread_map.h"
  14. #include "evlist.h"
  15. #include "evsel.h"
  16. #include "parse-events.h"
  17. #include <sys/mman.h>
  18. #include <linux/bitops.h>
  19. #include <linux/hash.h>
  20. #define FD(e, x, y) (*(int *)xyarray__entry(e->fd, x, y))
  21. #define SID(e, x, y) xyarray__entry(e->sample_id, x, y)
  22. void perf_evlist__init(struct perf_evlist *evlist, struct cpu_map *cpus,
  23. struct thread_map *threads)
  24. {
  25. int i;
  26. for (i = 0; i < PERF_EVLIST__HLIST_SIZE; ++i)
  27. INIT_HLIST_HEAD(&evlist->heads[i]);
  28. INIT_LIST_HEAD(&evlist->entries);
  29. perf_evlist__set_maps(evlist, cpus, threads);
  30. }
  31. struct perf_evlist *perf_evlist__new(struct cpu_map *cpus,
  32. struct thread_map *threads)
  33. {
  34. struct perf_evlist *evlist = zalloc(sizeof(*evlist));
  35. if (evlist != NULL)
  36. perf_evlist__init(evlist, cpus, threads);
  37. return evlist;
  38. }
  39. void perf_evlist__config_attrs(struct perf_evlist *evlist,
  40. struct perf_record_opts *opts)
  41. {
  42. struct perf_evsel *evsel;
  43. if (evlist->cpus->map[0] < 0)
  44. opts->no_inherit = true;
  45. list_for_each_entry(evsel, &evlist->entries, node) {
  46. perf_evsel__config(evsel, opts);
  47. if (evlist->nr_entries > 1)
  48. evsel->attr.sample_type |= PERF_SAMPLE_ID;
  49. }
  50. }
  51. static void perf_evlist__purge(struct perf_evlist *evlist)
  52. {
  53. struct perf_evsel *pos, *n;
  54. list_for_each_entry_safe(pos, n, &evlist->entries, node) {
  55. list_del_init(&pos->node);
  56. perf_evsel__delete(pos);
  57. }
  58. evlist->nr_entries = 0;
  59. }
  60. void perf_evlist__exit(struct perf_evlist *evlist)
  61. {
  62. free(evlist->mmap);
  63. free(evlist->pollfd);
  64. evlist->mmap = NULL;
  65. evlist->pollfd = NULL;
  66. }
  67. void perf_evlist__delete(struct perf_evlist *evlist)
  68. {
  69. perf_evlist__purge(evlist);
  70. perf_evlist__exit(evlist);
  71. free(evlist);
  72. }
  73. void perf_evlist__add(struct perf_evlist *evlist, struct perf_evsel *entry)
  74. {
  75. list_add_tail(&entry->node, &evlist->entries);
  76. ++evlist->nr_entries;
  77. }
  78. static void perf_evlist__splice_list_tail(struct perf_evlist *evlist,
  79. struct list_head *list,
  80. int nr_entries)
  81. {
  82. list_splice_tail(list, &evlist->entries);
  83. evlist->nr_entries += nr_entries;
  84. }
  85. int perf_evlist__add_default(struct perf_evlist *evlist)
  86. {
  87. struct perf_event_attr attr = {
  88. .type = PERF_TYPE_HARDWARE,
  89. .config = PERF_COUNT_HW_CPU_CYCLES,
  90. };
  91. struct perf_evsel *evsel = perf_evsel__new(&attr, 0);
  92. if (evsel == NULL)
  93. goto error;
  94. /* use strdup() because free(evsel) assumes name is allocated */
  95. evsel->name = strdup("cycles");
  96. if (!evsel->name)
  97. goto error_free;
  98. perf_evlist__add(evlist, evsel);
  99. return 0;
  100. error_free:
  101. perf_evsel__delete(evsel);
  102. error:
  103. return -ENOMEM;
  104. }
  105. int perf_evlist__add_attrs(struct perf_evlist *evlist,
  106. struct perf_event_attr *attrs, size_t nr_attrs)
  107. {
  108. struct perf_evsel *evsel, *n;
  109. LIST_HEAD(head);
  110. size_t i;
  111. for (i = 0; i < nr_attrs; i++) {
  112. evsel = perf_evsel__new(attrs + i, evlist->nr_entries + i);
  113. if (evsel == NULL)
  114. goto out_delete_partial_list;
  115. list_add_tail(&evsel->node, &head);
  116. }
  117. perf_evlist__splice_list_tail(evlist, &head, nr_attrs);
  118. return 0;
  119. out_delete_partial_list:
  120. list_for_each_entry_safe(evsel, n, &head, node)
  121. perf_evsel__delete(evsel);
  122. return -1;
  123. }
  124. static int trace_event__id(const char *evname)
  125. {
  126. char *filename, *colon;
  127. int err = -1, fd;
  128. if (asprintf(&filename, "%s/%s/id", tracing_events_path, evname) < 0)
  129. return -1;
  130. colon = strrchr(filename, ':');
  131. if (colon != NULL)
  132. *colon = '/';
  133. fd = open(filename, O_RDONLY);
  134. if (fd >= 0) {
  135. char id[16];
  136. if (read(fd, id, sizeof(id)) > 0)
  137. err = atoi(id);
  138. close(fd);
  139. }
  140. free(filename);
  141. return err;
  142. }
  143. int perf_evlist__add_tracepoints(struct perf_evlist *evlist,
  144. const char *tracepoints[],
  145. size_t nr_tracepoints)
  146. {
  147. int err;
  148. size_t i;
  149. struct perf_event_attr *attrs = zalloc(nr_tracepoints * sizeof(*attrs));
  150. if (attrs == NULL)
  151. return -1;
  152. for (i = 0; i < nr_tracepoints; i++) {
  153. err = trace_event__id(tracepoints[i]);
  154. if (err < 0)
  155. goto out_free_attrs;
  156. attrs[i].type = PERF_TYPE_TRACEPOINT;
  157. attrs[i].config = err;
  158. attrs[i].sample_type = (PERF_SAMPLE_RAW | PERF_SAMPLE_TIME |
  159. PERF_SAMPLE_CPU);
  160. attrs[i].sample_period = 1;
  161. }
  162. err = perf_evlist__add_attrs(evlist, attrs, nr_tracepoints);
  163. out_free_attrs:
  164. free(attrs);
  165. return err;
  166. }
  167. void perf_evlist__disable(struct perf_evlist *evlist)
  168. {
  169. int cpu, thread;
  170. struct perf_evsel *pos;
  171. for (cpu = 0; cpu < evlist->cpus->nr; cpu++) {
  172. list_for_each_entry(pos, &evlist->entries, node) {
  173. for (thread = 0; thread < evlist->threads->nr; thread++)
  174. ioctl(FD(pos, cpu, thread), PERF_EVENT_IOC_DISABLE);
  175. }
  176. }
  177. }
  178. void perf_evlist__enable(struct perf_evlist *evlist)
  179. {
  180. int cpu, thread;
  181. struct perf_evsel *pos;
  182. for (cpu = 0; cpu < evlist->cpus->nr; cpu++) {
  183. list_for_each_entry(pos, &evlist->entries, node) {
  184. for (thread = 0; thread < evlist->threads->nr; thread++)
  185. ioctl(FD(pos, cpu, thread), PERF_EVENT_IOC_ENABLE);
  186. }
  187. }
  188. }
  189. int perf_evlist__alloc_pollfd(struct perf_evlist *evlist)
  190. {
  191. int nfds = evlist->cpus->nr * evlist->threads->nr * evlist->nr_entries;
  192. evlist->pollfd = malloc(sizeof(struct pollfd) * nfds);
  193. return evlist->pollfd != NULL ? 0 : -ENOMEM;
  194. }
  195. void perf_evlist__add_pollfd(struct perf_evlist *evlist, int fd)
  196. {
  197. fcntl(fd, F_SETFL, O_NONBLOCK);
  198. evlist->pollfd[evlist->nr_fds].fd = fd;
  199. evlist->pollfd[evlist->nr_fds].events = POLLIN;
  200. evlist->nr_fds++;
  201. }
  202. static void perf_evlist__id_hash(struct perf_evlist *evlist,
  203. struct perf_evsel *evsel,
  204. int cpu, int thread, u64 id)
  205. {
  206. int hash;
  207. struct perf_sample_id *sid = SID(evsel, cpu, thread);
  208. sid->id = id;
  209. sid->evsel = evsel;
  210. hash = hash_64(sid->id, PERF_EVLIST__HLIST_BITS);
  211. hlist_add_head(&sid->node, &evlist->heads[hash]);
  212. }
  213. void perf_evlist__id_add(struct perf_evlist *evlist, struct perf_evsel *evsel,
  214. int cpu, int thread, u64 id)
  215. {
  216. perf_evlist__id_hash(evlist, evsel, cpu, thread, id);
  217. evsel->id[evsel->ids++] = id;
  218. }
  219. static int perf_evlist__id_add_fd(struct perf_evlist *evlist,
  220. struct perf_evsel *evsel,
  221. int cpu, int thread, int fd)
  222. {
  223. u64 read_data[4] = { 0, };
  224. int id_idx = 1; /* The first entry is the counter value */
  225. if (!(evsel->attr.read_format & PERF_FORMAT_ID) ||
  226. read(fd, &read_data, sizeof(read_data)) == -1)
  227. return -1;
  228. if (evsel->attr.read_format & PERF_FORMAT_TOTAL_TIME_ENABLED)
  229. ++id_idx;
  230. if (evsel->attr.read_format & PERF_FORMAT_TOTAL_TIME_RUNNING)
  231. ++id_idx;
  232. perf_evlist__id_add(evlist, evsel, cpu, thread, read_data[id_idx]);
  233. return 0;
  234. }
  235. struct perf_evsel *perf_evlist__id2evsel(struct perf_evlist *evlist, u64 id)
  236. {
  237. struct hlist_head *head;
  238. struct hlist_node *pos;
  239. struct perf_sample_id *sid;
  240. int hash;
  241. if (evlist->nr_entries == 1)
  242. return list_entry(evlist->entries.next, struct perf_evsel, node);
  243. hash = hash_64(id, PERF_EVLIST__HLIST_BITS);
  244. head = &evlist->heads[hash];
  245. hlist_for_each_entry(sid, pos, head, node)
  246. if (sid->id == id)
  247. return sid->evsel;
  248. return NULL;
  249. }
  250. union perf_event *perf_evlist__mmap_read(struct perf_evlist *evlist, int idx)
  251. {
  252. /* XXX Move this to perf.c, making it generally available */
  253. unsigned int page_size = sysconf(_SC_PAGE_SIZE);
  254. struct perf_mmap *md = &evlist->mmap[idx];
  255. unsigned int head = perf_mmap__read_head(md);
  256. unsigned int old = md->prev;
  257. unsigned char *data = md->base + page_size;
  258. union perf_event *event = NULL;
  259. if (evlist->overwrite) {
  260. /*
  261. * If we're further behind than half the buffer, there's a chance
  262. * the writer will bite our tail and mess up the samples under us.
  263. *
  264. * If we somehow ended up ahead of the head, we got messed up.
  265. *
  266. * In either case, truncate and restart at head.
  267. */
  268. int diff = head - old;
  269. if (diff > md->mask / 2 || diff < 0) {
  270. fprintf(stderr, "WARNING: failed to keep up with mmap data.\n");
  271. /*
  272. * head points to a known good entry, start there.
  273. */
  274. old = head;
  275. }
  276. }
  277. if (old != head) {
  278. size_t size;
  279. event = (union perf_event *)&data[old & md->mask];
  280. size = event->header.size;
  281. /*
  282. * Event straddles the mmap boundary -- header should always
  283. * be inside due to u64 alignment of output.
  284. */
  285. if ((old & md->mask) + size != ((old + size) & md->mask)) {
  286. unsigned int offset = old;
  287. unsigned int len = min(sizeof(*event), size), cpy;
  288. void *dst = &evlist->event_copy;
  289. do {
  290. cpy = min(md->mask + 1 - (offset & md->mask), len);
  291. memcpy(dst, &data[offset & md->mask], cpy);
  292. offset += cpy;
  293. dst += cpy;
  294. len -= cpy;
  295. } while (len);
  296. event = &evlist->event_copy;
  297. }
  298. old += size;
  299. }
  300. md->prev = old;
  301. if (!evlist->overwrite)
  302. perf_mmap__write_tail(md, old);
  303. return event;
  304. }
  305. void perf_evlist__munmap(struct perf_evlist *evlist)
  306. {
  307. int i;
  308. for (i = 0; i < evlist->nr_mmaps; i++) {
  309. if (evlist->mmap[i].base != NULL) {
  310. munmap(evlist->mmap[i].base, evlist->mmap_len);
  311. evlist->mmap[i].base = NULL;
  312. }
  313. }
  314. free(evlist->mmap);
  315. evlist->mmap = NULL;
  316. }
  317. int perf_evlist__alloc_mmap(struct perf_evlist *evlist)
  318. {
  319. evlist->nr_mmaps = evlist->cpus->nr;
  320. if (evlist->cpus->map[0] == -1)
  321. evlist->nr_mmaps = evlist->threads->nr;
  322. evlist->mmap = zalloc(evlist->nr_mmaps * sizeof(struct perf_mmap));
  323. return evlist->mmap != NULL ? 0 : -ENOMEM;
  324. }
  325. static int __perf_evlist__mmap(struct perf_evlist *evlist,
  326. int idx, int prot, int mask, int fd)
  327. {
  328. evlist->mmap[idx].prev = 0;
  329. evlist->mmap[idx].mask = mask;
  330. evlist->mmap[idx].base = mmap(NULL, evlist->mmap_len, prot,
  331. MAP_SHARED, fd, 0);
  332. if (evlist->mmap[idx].base == MAP_FAILED)
  333. return -1;
  334. perf_evlist__add_pollfd(evlist, fd);
  335. return 0;
  336. }
  337. static int perf_evlist__mmap_per_cpu(struct perf_evlist *evlist, int prot, int mask)
  338. {
  339. struct perf_evsel *evsel;
  340. int cpu, thread;
  341. for (cpu = 0; cpu < evlist->cpus->nr; cpu++) {
  342. int output = -1;
  343. for (thread = 0; thread < evlist->threads->nr; thread++) {
  344. list_for_each_entry(evsel, &evlist->entries, node) {
  345. int fd = FD(evsel, cpu, thread);
  346. if (output == -1) {
  347. output = fd;
  348. if (__perf_evlist__mmap(evlist, cpu,
  349. prot, mask, output) < 0)
  350. goto out_unmap;
  351. } else {
  352. if (ioctl(fd, PERF_EVENT_IOC_SET_OUTPUT, output) != 0)
  353. goto out_unmap;
  354. }
  355. if ((evsel->attr.read_format & PERF_FORMAT_ID) &&
  356. perf_evlist__id_add_fd(evlist, evsel, cpu, thread, fd) < 0)
  357. goto out_unmap;
  358. }
  359. }
  360. }
  361. return 0;
  362. out_unmap:
  363. for (cpu = 0; cpu < evlist->cpus->nr; cpu++) {
  364. if (evlist->mmap[cpu].base != NULL) {
  365. munmap(evlist->mmap[cpu].base, evlist->mmap_len);
  366. evlist->mmap[cpu].base = NULL;
  367. }
  368. }
  369. return -1;
  370. }
  371. static int perf_evlist__mmap_per_thread(struct perf_evlist *evlist, int prot, int mask)
  372. {
  373. struct perf_evsel *evsel;
  374. int thread;
  375. for (thread = 0; thread < evlist->threads->nr; thread++) {
  376. int output = -1;
  377. list_for_each_entry(evsel, &evlist->entries, node) {
  378. int fd = FD(evsel, 0, thread);
  379. if (output == -1) {
  380. output = fd;
  381. if (__perf_evlist__mmap(evlist, thread,
  382. prot, mask, output) < 0)
  383. goto out_unmap;
  384. } else {
  385. if (ioctl(fd, PERF_EVENT_IOC_SET_OUTPUT, output) != 0)
  386. goto out_unmap;
  387. }
  388. if ((evsel->attr.read_format & PERF_FORMAT_ID) &&
  389. perf_evlist__id_add_fd(evlist, evsel, 0, thread, fd) < 0)
  390. goto out_unmap;
  391. }
  392. }
  393. return 0;
  394. out_unmap:
  395. for (thread = 0; thread < evlist->threads->nr; thread++) {
  396. if (evlist->mmap[thread].base != NULL) {
  397. munmap(evlist->mmap[thread].base, evlist->mmap_len);
  398. evlist->mmap[thread].base = NULL;
  399. }
  400. }
  401. return -1;
  402. }
  403. /** perf_evlist__mmap - Create per cpu maps to receive events
  404. *
  405. * @evlist - list of events
  406. * @pages - map length in pages
  407. * @overwrite - overwrite older events?
  408. *
  409. * If overwrite is false the user needs to signal event consuption using:
  410. *
  411. * struct perf_mmap *m = &evlist->mmap[cpu];
  412. * unsigned int head = perf_mmap__read_head(m);
  413. *
  414. * perf_mmap__write_tail(m, head)
  415. *
  416. * Using perf_evlist__read_on_cpu does this automatically.
  417. */
  418. int perf_evlist__mmap(struct perf_evlist *evlist, int pages, bool overwrite)
  419. {
  420. unsigned int page_size = sysconf(_SC_PAGE_SIZE);
  421. int mask = pages * page_size - 1;
  422. struct perf_evsel *evsel;
  423. const struct cpu_map *cpus = evlist->cpus;
  424. const struct thread_map *threads = evlist->threads;
  425. int prot = PROT_READ | (overwrite ? 0 : PROT_WRITE);
  426. if (evlist->mmap == NULL && perf_evlist__alloc_mmap(evlist) < 0)
  427. return -ENOMEM;
  428. if (evlist->pollfd == NULL && perf_evlist__alloc_pollfd(evlist) < 0)
  429. return -ENOMEM;
  430. evlist->overwrite = overwrite;
  431. evlist->mmap_len = (pages + 1) * page_size;
  432. list_for_each_entry(evsel, &evlist->entries, node) {
  433. if ((evsel->attr.read_format & PERF_FORMAT_ID) &&
  434. evsel->sample_id == NULL &&
  435. perf_evsel__alloc_id(evsel, cpus->nr, threads->nr) < 0)
  436. return -ENOMEM;
  437. }
  438. if (evlist->cpus->map[0] == -1)
  439. return perf_evlist__mmap_per_thread(evlist, prot, mask);
  440. return perf_evlist__mmap_per_cpu(evlist, prot, mask);
  441. }
  442. int perf_evlist__create_maps(struct perf_evlist *evlist, pid_t target_pid,
  443. pid_t target_tid, const char *cpu_list)
  444. {
  445. evlist->threads = thread_map__new(target_pid, target_tid);
  446. if (evlist->threads == NULL)
  447. return -1;
  448. if (cpu_list == NULL && target_tid != -1)
  449. evlist->cpus = cpu_map__dummy_new();
  450. else
  451. evlist->cpus = cpu_map__new(cpu_list);
  452. if (evlist->cpus == NULL)
  453. goto out_delete_threads;
  454. return 0;
  455. out_delete_threads:
  456. thread_map__delete(evlist->threads);
  457. return -1;
  458. }
  459. void perf_evlist__delete_maps(struct perf_evlist *evlist)
  460. {
  461. cpu_map__delete(evlist->cpus);
  462. thread_map__delete(evlist->threads);
  463. evlist->cpus = NULL;
  464. evlist->threads = NULL;
  465. }
  466. int perf_evlist__set_filters(struct perf_evlist *evlist)
  467. {
  468. const struct thread_map *threads = evlist->threads;
  469. const struct cpu_map *cpus = evlist->cpus;
  470. struct perf_evsel *evsel;
  471. char *filter;
  472. int thread;
  473. int cpu;
  474. int err;
  475. int fd;
  476. list_for_each_entry(evsel, &evlist->entries, node) {
  477. filter = evsel->filter;
  478. if (!filter)
  479. continue;
  480. for (cpu = 0; cpu < cpus->nr; cpu++) {
  481. for (thread = 0; thread < threads->nr; thread++) {
  482. fd = FD(evsel, cpu, thread);
  483. err = ioctl(fd, PERF_EVENT_IOC_SET_FILTER, filter);
  484. if (err)
  485. return err;
  486. }
  487. }
  488. }
  489. return 0;
  490. }
  491. bool perf_evlist__valid_sample_type(const struct perf_evlist *evlist)
  492. {
  493. struct perf_evsel *pos, *first;
  494. pos = first = list_entry(evlist->entries.next, struct perf_evsel, node);
  495. list_for_each_entry_continue(pos, &evlist->entries, node) {
  496. if (first->attr.sample_type != pos->attr.sample_type)
  497. return false;
  498. }
  499. return true;
  500. }
  501. u64 perf_evlist__sample_type(const struct perf_evlist *evlist)
  502. {
  503. struct perf_evsel *first;
  504. first = list_entry(evlist->entries.next, struct perf_evsel, node);
  505. return first->attr.sample_type;
  506. }
  507. bool perf_evlist__valid_sample_id_all(const struct perf_evlist *evlist)
  508. {
  509. struct perf_evsel *pos, *first;
  510. pos = first = list_entry(evlist->entries.next, struct perf_evsel, node);
  511. list_for_each_entry_continue(pos, &evlist->entries, node) {
  512. if (first->attr.sample_id_all != pos->attr.sample_id_all)
  513. return false;
  514. }
  515. return true;
  516. }
  517. bool perf_evlist__sample_id_all(const struct perf_evlist *evlist)
  518. {
  519. struct perf_evsel *first;
  520. first = list_entry(evlist->entries.next, struct perf_evsel, node);
  521. return first->attr.sample_id_all;
  522. }
  523. void perf_evlist__set_selected(struct perf_evlist *evlist,
  524. struct perf_evsel *evsel)
  525. {
  526. evlist->selected = evsel;
  527. }
  528. int perf_evlist__open(struct perf_evlist *evlist, bool group)
  529. {
  530. struct perf_evsel *evsel, *first;
  531. int err, ncpus, nthreads;
  532. first = list_entry(evlist->entries.next, struct perf_evsel, node);
  533. list_for_each_entry(evsel, &evlist->entries, node) {
  534. struct xyarray *group_fd = NULL;
  535. if (group && evsel != first)
  536. group_fd = first->fd;
  537. err = perf_evsel__open(evsel, evlist->cpus, evlist->threads,
  538. group, group_fd);
  539. if (err < 0)
  540. goto out_err;
  541. }
  542. return 0;
  543. out_err:
  544. ncpus = evlist->cpus ? evlist->cpus->nr : 1;
  545. nthreads = evlist->threads ? evlist->threads->nr : 1;
  546. list_for_each_entry_reverse(evsel, &evlist->entries, node)
  547. perf_evsel__close(evsel, ncpus, nthreads);
  548. return err;
  549. }