tools/perf/util/config.c

   1 // SPDX-License-Identifier: GPL-2.0
   2 /*
   3  * config.c
   4  *
   5  * Helper functions for parsing config items.
   6  * Originally copied from GIT source.
   7  *
   8  * Copyright (C) Linus Torvalds, 2005
   9  * Copyright (C) Johannes Schindelin, 2005
  10  *
  11  */
  12 #include <errno.h>
  13 #include <sys/param.h>
  14 #include "cache.h"
  15 #include "callchain.h"
  16 #include <subcmd/exec-cmd.h>
  17 #include "util/event.h"  /* proc_map_timeout */
  18 #include "util/hist.h"  /* perf_hist_config */
  19 #include "util/llvm-utils.h"   /* perf_llvm_config */
  20 #include "util/stat.h"  /* perf_stat__set_big_num */
  21 #include "build-id.h"
  22 #include "debug.h"
  23 #include "config.h"
  24 #include <sys/types.h>
  25 #include <sys/stat.h>
  26 #include <stdlib.h>
  27 #include <unistd.h>
  28 #include <linux/string.h>
  29 #include <linux/zalloc.h>
  30 #include <linux/ctype.h>
  31
  32 #define MAXNAME (256)
  33
  34 #define DEBUG_CACHE_DIR ".debug"
  35
  36
  37 char buildid_dir[MAXPATHLEN]; /* root dir for buildid, binary cache */
  38
  39 static FILE *config_file;
  40 static const char *config_file_name;
  41 static int config_linenr;
  42 static int config_file_eof;
  43 static struct perf_config_set *config_set;
  44
  45 const char *config_exclusive_filename;
  46
  47 static int get_next_char(void)
  48 {
  49         int c;
  50         FILE *f;
  51
  52         c = '\n';
  53         if ((f = config_file) != NULL) {
  54                 c = fgetc(f);
  55                 if (c == '\r') {
  56                         /* DOS like systems */
  57                         c = fgetc(f);
  58                         if (c != '\n') {
  59                                 ungetc(c, f);
  60                                 c = '\r';
  61                         }
  62                 }
  63                 if (c == '\n')
  64                         config_linenr++;
  65                 if (c == EOF) {
  66                         config_file_eof = 1;
  67                         c = '\n';
  68                 }
  69         }
  70         return c;
  71 }
  72
  73 static char *parse_value(void)
  74 {
  75         static char value[1024];
  76         int quote = 0, comment = 0, space = 0;
  77         size_t len = 0;
  78
  79         for (;;) {
  80                 int c = get_next_char();
  81
  82                 if (len >= sizeof(value) - 1)
  83                         return NULL;
  84                 if (c == '\n') {
  85                         if (quote)
  86                                 return NULL;
  87                         value[len] = 0;
  88                         return value;
  89                 }
  90                 if (comment)
  91                         continue;
  92                 if (isspace(c) && !quote) {
  93                         space = 1;
  94                         continue;
  95                 }
  96                 if (!quote) {
  97                         if (c == ';' || c == '#') {
  98                                 comment = 1;
  99                                 continue;
 100                         }
 101                 }
 102                 if (space) {
 103                         if (len)
 104                                 value[len++] = ' ';
 105                         space = 0;
 106                 }
 107                 if (c == '\\') {
 108                         c = get_next_char();
 109                         switch (c) {
 110                         case '\n':
 111                                 continue;
 112                         case 't':
 113                                 c = '\t';
 114                                 break;
 115                         case 'b':
 116                                 c = '\b';
 117                                 break;
 118                         case 'n':
 119                                 c = '\n';
 120                                 break;
 121                         /* Some characters escape as themselves */
 122                         case '\\': case '"':
 123                                 break;
 124                         /* Reject unknown escape sequences */
 125                         default:
 126                                 return NULL;
 127                         }
 128                         value[len++] = c;
 129                         continue;
 130                 }
 131                 if (c == '"') {
 132                         quote = 1-quote;
 133                         continue;
 134                 }
 135                 value[len++] = c;
 136         }
 137 }
 138
 139 static inline int iskeychar(int c)
 140 {
 141         return isalnum(c) || c == '-' || c == '_';
 142 }
 143
 144 static int get_value(config_fn_t fn, void *data, char *name, unsigned int len)
 145 {
 146         int c;
 147         char *value;
 148
 149         /* Get the full name */
 150         for (;;) {
 151                 c = get_next_char();
 152                 if (config_file_eof)
 153                         break;
 154                 if (!iskeychar(c))
 155                         break;
 156                 name[len++] = c;
 157                 if (len >= MAXNAME)
 158                         return -1;
 159         }
 160         name[len] = 0;
 161         while (c == ' ' || c == '\t')
 162                 c = get_next_char();
 163
 164         value = NULL;
 165         if (c != '\n') {
 166                 if (c != '=')
 167                         return -1;
 168                 value = parse_value();
 169                 if (!value)
 170                         return -1;
 171         }
 172         return fn(name, value, data);
 173 }
 174
 175 static int get_extended_base_var(char *name, int baselen, int c)
 176 {
 177         do {
 178                 if (c == '\n')
 179                         return -1;
 180                 c = get_next_char();
 181         } while (isspace(c));
 182
 183         /* We require the format to be '[base "extension"]' */
 184         if (c != '"')
 185                 return -1;
 186         name[baselen++] = '.';
 187
 188         for (;;) {
 189                 int ch = get_next_char();
 190
 191                 if (ch == '\n')
 192                         return -1;
 193                 if (ch == '"')
 194                         break;
 195                 if (ch == '\\') {
 196                         ch = get_next_char();
 197                         if (ch == '\n')
 198                                 return -1;
 199                 }
 200                 name[baselen++] = ch;
 201                 if (baselen > MAXNAME / 2)
 202                         return -1;
 203         }
 204
 205         /* Final ']' */
 206         if (get_next_char() != ']')
 207                 return -1;
 208         return baselen;
 209 }
 210
 211 static int get_base_var(char *name)
 212 {
 213         int baselen = 0;
 214
 215         for (;;) {
 216                 int c = get_next_char();
 217                 if (config_file_eof)
 218                         return -1;
 219                 if (c == ']')
 220                         return baselen;
 221                 if (isspace(c))
 222                         return get_extended_base_var(name, baselen, c);
 223                 if (!iskeychar(c) && c != '.')
 224                         return -1;
 225                 if (baselen > MAXNAME / 2)
 226                         return -1;
 227                 name[baselen++] = tolower(c);
 228         }
 229 }
 230
 231 static int perf_parse_file(config_fn_t fn, void *data)
 232 {
 233         int comment = 0;
 234         int baselen = 0;
 235         static char var[MAXNAME];
 236
 237         /* U+FEFF Byte Order Mark in UTF8 */
 238         static const unsigned char *utf8_bom = (unsigned char *) "\xef\xbb\xbf";
 239         const unsigned char *bomptr = utf8_bom;
 240
 241         for (;;) {
 242                 int line, c = get_next_char();
 243
 244                 if (bomptr && *bomptr) {
 245                         /* We are at the file beginning; skip UTF8-encoded BOM
 246                          * if present. Sane editors won't put this in on their
 247                          * own, but e.g. Windows Notepad will do it happily. */
 248                         if ((unsigned char) c == *bomptr) {
 249                                 bomptr++;
 250                                 continue;
 251                         } else {
 252                                 /* Do not tolerate partial BOM. */
 253                                 if (bomptr != utf8_bom)
 254                                         break;
 255                                 /* No BOM at file beginning. Cool. */
 256                                 bomptr = NULL;
 257                         }
 258                 }
 259                 if (c == '\n') {
 260                         if (config_file_eof)
 261                                 return 0;
 262                         comment = 0;
 263                         continue;
 264                 }
 265                 if (comment || isspace(c))
 266                         continue;
 267                 if (c == '#' || c == ';') {
 268                         comment = 1;
 269                         continue;
 270                 }
 271                 if (c == '[') {
 272                         baselen = get_base_var(var);
 273                         if (baselen <= 0)
 274                                 break;
 275                         var[baselen++] = '.';
 276                         var[baselen] = 0;
 277                         continue;
 278                 }
 279                 if (!isalpha(c))
 280                         break;
 281                 var[baselen] = tolower(c);
 282
 283                 /*
 284                  * The get_value function might or might not reach the '\n',
 285                  * so saving the current line number for error reporting.
 286                  */
 287                 line = config_linenr;
 288                 if (get_value(fn, data, var, baselen+1) < 0) {
 289                         config_linenr = line;
 290                         break;
 291                 }
 292         }
 293         pr_err("bad config file line %d in %s\n", config_linenr, config_file_name);
 294         return -1;
 295 }
 296
 297 static int parse_unit_factor(const char *end, unsigned long *val)
 298 {
 299         if (!*end)
 300                 return 1;
 301         else if (!strcasecmp(end, "k")) {
 302                 *val *= 1024;
 303                 return 1;
 304         }
 305         else if (!strcasecmp(end, "m")) {
 306                 *val *= 1024 * 1024;
 307                 return 1;
 308         }
 309         else if (!strcasecmp(end, "g")) {
 310                 *val *= 1024 * 1024 * 1024;
 311                 return 1;
 312         }
 313         return 0;
 314 }
 315
 316 static int perf_parse_llong(const char *value, long long *ret)
 317 {
 318         if (value && *value) {
 319                 char *end;
 320                 long long val = strtoll(value, &end, 0);
 321                 unsigned long factor = 1;
 322
 323                 if (!parse_unit_factor(end, &factor))
 324                         return 0;
 325                 *ret = val * factor;
 326                 return 1;
 327         }
 328         return 0;
 329 }
 330
 331 static int perf_parse_long(const char *value, long *ret)
 332 {
 333         if (value && *value) {
 334                 char *end;
 335                 long val = strtol(value, &end, 0);
 336                 unsigned long factor = 1;
 337                 if (!parse_unit_factor(end, &factor))
 338                         return 0;
 339                 *ret = val * factor;
 340                 return 1;
 341         }
 342         return 0;
 343 }
 344
 345 static void bad_config(const char *name)
 346 {
 347         if (config_file_name)
 348                 pr_warning("bad config value for '%s' in %s, ignoring...\n", name, config_file_name);
 349         else
 350                 pr_warning("bad config value for '%s', ignoring...\n", name);
 351 }
 352
 353 int perf_config_u64(u64 *dest, const char *name, const char *value)
 354 {
 355         long long ret = 0;
 356
 357         if (!perf_parse_llong(value, &ret)) {
 358                 bad_config(name);
 359                 return -1;
 360         }
 361
 362         *dest = ret;
 363         return 0;
 364 }
 365
 366 int perf_config_int(int *dest, const char *name, const char *value)
 367 {
 368         long ret = 0;
 369         if (!perf_parse_long(value, &ret)) {
 370                 bad_config(name);
 371                 return -1;
 372         }
 373         *dest = ret;
 374         return 0;
 375 }
 376
 377 int perf_config_u8(u8 *dest, const char *name, const char *value)
 378 {
 379         long ret = 0;
 380
 381         if (!perf_parse_long(value, &ret)) {
 382                 bad_config(name);
 383                 return -1;
 384         }
 385         *dest = ret;
 386         return 0;
 387 }
 388
 389 static int perf_config_bool_or_int(const char *name, const char *value, int *is_bool)
 390 {
 391         int ret;
 392
 393         *is_bool = 1;
 394         if (!value)
 395                 return 1;
 396         if (!*value)
 397                 return 0;
 398         if (!strcasecmp(value, "true") || !strcasecmp(value, "yes") || !strcasecmp(value, "on"))
 399                 return 1;
 400         if (!strcasecmp(value, "false") || !strcasecmp(value, "no") || !strcasecmp(value, "off"))
 401                 return 0;
 402         *is_bool = 0;
 403         return perf_config_int(&ret, name, value) < 0 ? -1 : ret;
 404 }
 405
 406 int perf_config_bool(const char *name, const char *value)
 407 {
 408         int discard;
 409         return !!perf_config_bool_or_int(name, value, &discard);
 410 }
 411
 412 static const char *perf_config_dirname(const char *name, const char *value)
 413 {
 414         if (!name)
 415                 return NULL;
 416         return value;
 417 }
 418
 419 static int perf_buildid_config(const char *var, const char *value)
 420 {
 421         /* same dir for all commands */
 422         if (!strcmp(var, "buildid.dir")) {
 423                 const char *dir = perf_config_dirname(var, value);
 424
 425                 if (!dir) {
 426                         pr_err("Invalid buildid directory!\n");
 427                         return -1;
 428                 }
 429                 strncpy(buildid_dir, dir, MAXPATHLEN-1);
 430                 buildid_dir[MAXPATHLEN-1] = '\0';
 431         }
 432
 433         return 0;
 434 }
 435
 436 static int perf_default_core_config(const char *var __maybe_unused,
 437                                     const char *value __maybe_unused)
 438 {
 439         if (!strcmp(var, "core.proc-map-timeout"))
 440                 proc_map_timeout = strtoul(value, NULL, 10);
 441
 442         /* Add other config variables here. */
 443         return 0;
 444 }
 445
 446 static int perf_ui_config(const char *var, const char *value)
 447 {
 448         /* Add other config variables here. */
 449         if (!strcmp(var, "ui.show-headers"))
 450                 symbol_conf.show_hist_headers = perf_config_bool(var, value);
 451
 452         return 0;
 453 }
 454
 455 static int perf_stat_config(const char *var, const char *value)
 456 {
 457         if (!strcmp(var, "stat.big-num"))
 458                 perf_stat__set_big_num(perf_config_bool(var, value));
 459
 460         if (!strcmp(var, "stat.no-csv-summary"))
 461                 perf_stat__set_no_csv_summary(perf_config_bool(var, value));
 462
 463         /* Add other config variables here. */
 464         return 0;
 465 }
 466
 467 int perf_default_config(const char *var, const char *value,
 468                         void *dummy __maybe_unused)
 469 {
 470         if (strstarts(var, "core."))
 471                 return perf_default_core_config(var, value);
 472
 473         if (strstarts(var, "hist."))
 474                 return perf_hist_config(var, value);
 475
 476         if (strstarts(var, "ui."))
 477                 return perf_ui_config(var, value);
 478
 479         if (strstarts(var, "call-graph."))
 480                 return perf_callchain_config(var, value);
 481
 482         if (strstarts(var, "llvm."))
 483                 return perf_llvm_config(var, value);
 484
 485         if (strstarts(var, "buildid."))
 486                 return perf_buildid_config(var, value);
 487
 488         if (strstarts(var, "stat."))
 489                 return perf_stat_config(var, value);
 490
 491         /* Add other config variables here. */
 492         return 0;
 493 }
 494
 495 static int perf_config_from_file(config_fn_t fn, const char *filename, void *data)
 496 {
 497         int ret;
 498         FILE *f = fopen(filename, "r");
 499
 500         ret = -1;
 501         if (f) {
 502                 config_file = f;
 503                 config_file_name = filename;
 504                 config_linenr = 1;
 505                 config_file_eof = 0;
 506                 ret = perf_parse_file(fn, data);
 507                 fclose(f);
 508                 config_file_name = NULL;
 509         }
 510         return ret;
 511 }
 512
 513 const char *perf_etc_perfconfig(void)
 514 {
 515         static const char *system_wide;
 516         if (!system_wide)
 517                 system_wide = system_path(ETC_PERFCONFIG);
 518         return system_wide;
 519 }
 520
 521 static int perf_env_bool(const char *k, int def)
 522 {
 523         const char *v = getenv(k);
 524         return v ? perf_config_bool(k, v) : def;
 525 }
 526
 527 int perf_config_system(void)
 528 {
 529         return !perf_env_bool("PERF_CONFIG_NOSYSTEM", 0);
 530 }
 531
 532 int perf_config_global(void)
 533 {
 534         return !perf_env_bool("PERF_CONFIG_NOGLOBAL", 0);
 535 }
 536
 537 static char *home_perfconfig(void)
 538 {
 539         const char *home = NULL;
 540         char *config;
 541         struct stat st;
 542
 543         home = getenv("HOME");
 544
 545         /*
 546          * Skip reading user config if:
 547          *   - there is no place to read it from (HOME)
 548          *   - we are asked not to (PERF_CONFIG_NOGLOBAL=1)
 549          */
 550         if (!home || !*home || !perf_config_global())
 551                 return NULL;
 552
 553         config = strdup(mkpath("%s/.perfconfig", home));
 554         if (config == NULL) {
 555                 pr_warning("Not enough memory to process %s/.perfconfig, ignoring it.", home);
 556                 return NULL;
 557         }
 558
 559         if (stat(config, &st) < 0)
 560                 goto out_free;
 561
 562         if (st.st_uid && (st.st_uid != geteuid())) {
 563                 pr_warning("File %s not owned by current user or root, ignoring it.", config);
 564                 goto out_free;
 565         }
 566
 567         if (st.st_size)
 568                 return config;
 569
 570 out_free:
 571         free(config);
 572         return NULL;
 573 }
 574
 575 const char *perf_home_perfconfig(void)
 576 {
 577         static const char *config;
 578         static bool failed;
 579
 580         config = failed ? NULL : home_perfconfig();
 581         if (!config)
 582                 failed = true;
 583
 584         return config;
 585 }
 586
 587 static struct perf_config_section *find_section(struct list_head *sections,
 588                                                 const char *section_name)
 589 {
 590         struct perf_config_section *section;
 591
 592         list_for_each_entry(section, sections, node)
 593                 if (!strcmp(section->name, section_name))
 594                         return section;
 595
 596         return NULL;
 597 }
 598
 599 static struct perf_config_item *find_config_item(const char *name,
 600                                                  struct perf_config_section *section)
 601 {
 602         struct perf_config_item *item;
 603
 604         list_for_each_entry(item, &section->items, node)
 605                 if (!strcmp(item->name, name))
 606                         return item;
 607
 608         return NULL;
 609 }
 610
 611 static struct perf_config_section *add_section(struct list_head *sections,
 612                                                const char *section_name)
 613 {
 614         struct perf_config_section *section = zalloc(sizeof(*section));
 615
 616         if (!section)
 617                 return NULL;
 618
 619         INIT_LIST_HEAD(&section->items);
 620         section->name = strdup(section_name);
 621         if (!section->name) {
 622                 pr_debug("%s: strdup failed\n", __func__);
 623                 free(section);
 624                 return NULL;
 625         }
 626
 627         list_add_tail(&section->node, sections);
 628         return section;
 629 }
 630
 631 static struct perf_config_item *add_config_item(struct perf_config_section *section,
 632                                                 const char *name)
 633 {
 634         struct perf_config_item *item = zalloc(sizeof(*item));
 635
 636         if (!item)
 637                 return NULL;
 638
 639         item->name = strdup(name);
 640         if (!item->name) {
 641                 pr_debug("%s: strdup failed\n", __func__);
 642                 free(item);
 643                 return NULL;
 644         }
 645
 646         list_add_tail(&item->node, &section->items);
 647         return item;
 648 }
 649
 650 static int set_value(struct perf_config_item *item, const char *value)
 651 {
 652         char *val = strdup(value);
 653
 654         if (!val)
 655                 return -1;
 656
 657         zfree(&item->value);
 658         item->value = val;
 659         return 0;
 660 }
 661
 662 static int collect_config(const char *var, const char *value,
 663                           void *perf_config_set)
 664 {
 665         int ret = -1;
 666         char *ptr, *key;
 667         char *section_name, *name;
 668         struct perf_config_section *section = NULL;
 669         struct perf_config_item *item = NULL;
 670         struct perf_config_set *set = perf_config_set;
 671         struct list_head *sections;
 672
 673         if (set == NULL)
 674                 return -1;
 675
 676         sections = &set->sections;
 677         key = ptr = strdup(var);
 678         if (!key) {
 679                 pr_debug("%s: strdup failed\n", __func__);
 680                 return -1;
 681         }
 682
 683         section_name = strsep(&ptr, ".");
 684         name = ptr;
 685         if (name == NULL || value == NULL)
 686                 goto out_free;
 687
 688         section = find_section(sections, section_name);
 689         if (!section) {
 690                 section = add_section(sections, section_name);
 691                 if (!section)
 692                         goto out_free;
 693         }
 694
 695         item = find_config_item(name, section);
 696         if (!item) {
 697                 item = add_config_item(section, name);
 698                 if (!item)
 699                         goto out_free;
 700         }
 701
 702         /* perf_config_set can contain both user and system config items.
 703          * So we should know where each value is from.
 704          * The classification would be needed when a particular config file
 705          * is overwritten by setting feature i.e. set_config().
 706          */
 707         if (strcmp(config_file_name, perf_etc_perfconfig()) == 0) {
 708                 section->from_system_config = true;
 709                 item->from_system_config = true;
 710         } else {
 711                 section->from_system_config = false;
 712                 item->from_system_config = false;
 713         }
 714
 715         ret = set_value(item, value);
 716
 717 out_free:
 718         free(key);
 719         return ret;
 720 }
 721
 722 int perf_config_set__collect(struct perf_config_set *set, const char *file_name,
 723                              const char *var, const char *value)
 724 {
 725         config_file_name = file_name;
 726         return collect_config(var, value, set);
 727 }
 728
 729 static int perf_config_set__init(struct perf_config_set *set)
 730 {
 731         int ret = -1;
 732
 733         /* Setting $PERF_CONFIG makes perf read _only_ the given config file. */
 734         if (config_exclusive_filename)
 735                 return perf_config_from_file(collect_config, config_exclusive_filename, set);
 736         if (perf_config_system() && !access(perf_etc_perfconfig(), R_OK)) {
 737                 if (perf_config_from_file(collect_config, perf_etc_perfconfig(), set) < 0)
 738                         goto out;
 739         }
 740         if (perf_config_global() && perf_home_perfconfig()) {
 741                 if (perf_config_from_file(collect_config, perf_home_perfconfig(), set) < 0)
 742                         goto out;
 743         }
 744
 745 out:
 746         return ret;
 747 }
 748
 749 struct perf_config_set *perf_config_set__new(void)
 750 {
 751         struct perf_config_set *set = zalloc(sizeof(*set));
 752
 753         if (set) {
 754                 INIT_LIST_HEAD(&set->sections);
 755                 perf_config_set__init(set);
 756         }
 757
 758         return set;
 759 }
 760
 761 struct perf_config_set *perf_config_set__load_file(const char *file)
 762 {
 763         struct perf_config_set *set = zalloc(sizeof(*set));
 764
 765         if (set) {
 766                 INIT_LIST_HEAD(&set->sections);
 767                 perf_config_from_file(collect_config, file, set);
 768         }
 769
 770         return set;
 771 }
 772
 773 static int perf_config__init(void)
 774 {
 775         if (config_set == NULL)
 776                 config_set = perf_config_set__new();
 777
 778         return config_set == NULL;
 779 }
 780
 781 int perf_config_set(struct perf_config_set *set,
 782                     config_fn_t fn, void *data)
 783 {
 784         int ret = 0;
 785         char key[BUFSIZ];
 786         struct perf_config_section *section;
 787         struct perf_config_item *item;
 788
 789         perf_config_set__for_each_entry(set, section, item) {
 790                 char *value = item->value;
 791
 792                 if (value) {
 793                         scnprintf(key, sizeof(key), "%s.%s",
 794                                   section->name, item->name);
 795                         ret = fn(key, value, data);
 796                         if (ret < 0) {
 797                                 pr_err("Error: wrong config key-value pair %s=%s\n",
 798                                        key, value);
 799                                 /*
 800                                  * Can't be just a 'break', as perf_config_set__for_each_entry()
 801                                  * expands to two nested for() loops.
 802                                  */
 803                                 goto out;
 804                         }
 805                 }
 806         }
 807 out:
 808         return ret;
 809 }
 810
 811 int perf_config(config_fn_t fn, void *data)
 812 {
 813         if (config_set == NULL && perf_config__init())
 814                 return -1;
 815
 816         return perf_config_set(config_set, fn, data);
 817 }
 818
 819 void perf_config__exit(void)
 820 {
 821         perf_config_set__delete(config_set);
 822         config_set = NULL;
 823 }
 824
 825 void perf_config__refresh(void)
 826 {
 827         perf_config__exit();
 828         perf_config__init();
 829 }
 830
 831 static void perf_config_item__delete(struct perf_config_item *item)
 832 {
 833         zfree(&item->name);
 834         zfree(&item->value);
 835         free(item);
 836 }
 837
 838 static void perf_config_section__purge(struct perf_config_section *section)
 839 {
 840         struct perf_config_item *item, *tmp;
 841
 842         list_for_each_entry_safe(item, tmp, &section->items, node) {
 843                 list_del_init(&item->node);
 844                 perf_config_item__delete(item);
 845         }
 846 }
 847
 848 static void perf_config_section__delete(struct perf_config_section *section)
 849 {
 850         perf_config_section__purge(section);
 851         zfree(&section->name);
 852         free(section);
 853 }
 854
 855 static void perf_config_set__purge(struct perf_config_set *set)
 856 {
 857         struct perf_config_section *section, *tmp;
 858
 859         list_for_each_entry_safe(section, tmp, &set->sections, node) {
 860                 list_del_init(&section->node);
 861                 perf_config_section__delete(section);
 862         }
 863 }
 864
 865 void perf_config_set__delete(struct perf_config_set *set)
 866 {
 867         if (set == NULL)
 868                 return;
 869
 870         perf_config_set__purge(set);
 871         free(set);
 872 }
 873
 874 /*
 875  * Call this to report error for your variable that should not
 876  * get a boolean value (i.e. "[my] var" means "true").
 877  */
 878 int config_error_nonbool(const char *var)
 879 {
 880         pr_err("Missing value for '%s'", var);
 881         return -1;
 882 }
 883
 884 void set_buildid_dir(const char *dir)
 885 {
 886         if (dir)
 887                 scnprintf(buildid_dir, MAXPATHLEN, "%s", dir);
 888
 889         /* default to $HOME/.debug */
 890         if (buildid_dir[0] == '\0') {
 891                 char *home = getenv("HOME");
 892
 893                 if (home) {
 894                         snprintf(buildid_dir, MAXPATHLEN, "%s/%s",
 895                                  home, DEBUG_CACHE_DIR);
 896                 } else {
 897                         strncpy(buildid_dir, DEBUG_CACHE_DIR, MAXPATHLEN-1);
 898                 }
 899                 buildid_dir[MAXPATHLEN-1] = '\0';
 900         }
 901         /* for communicating with external commands */
 902         setenv("PERF_BUILDID_DIR", buildid_dir, 1);
 903 }