Home | History | Annotate | Download | only in coregrind
      1 
      2 /*--------------------------------------------------------------------*/
      3 /*--- Command line options.                            m_options.c ---*/
      4 /*--------------------------------------------------------------------*/
      5 
      6 /*
      7    This file is part of Valgrind, a dynamic binary instrumentation
      8    framework.
      9 
     10    Copyright (C) 2000-2010 Nicholas Nethercote
     11       njn (at) valgrind.org
     12 
     13    This program is free software; you can redistribute it and/or
     14    modify it under the terms of the GNU General Public License as
     15    published by the Free Software Foundation; either version 2 of the
     16    License, or (at your option) any later version.
     17 
     18    This program is distributed in the hope that it will be useful, but
     19    WITHOUT ANY WARRANTY; without even the implied warranty of
     20    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
     21    General Public License for more details.
     22 
     23    You should have received a copy of the GNU General Public License
     24    along with this program; if not, write to the Free Software
     25    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
     26    02111-1307, USA.
     27 
     28    The GNU General Public License is contained in the file COPYING.
     29 */
     30 
     31 #include "pub_core_basics.h"
     32 #include "pub_core_vki.h"
     33 #include "pub_core_options.h"
     34 #include "pub_core_libcassert.h"
     35 #include "pub_core_libcbase.h"
     36 #include "pub_core_libcfile.h"
     37 #include "pub_core_libcprint.h"
     38 #include "pub_core_libcproc.h"
     39 #include "pub_core_mallocfree.h"
     40 #include "pub_core_seqmatch.h"     // VG_(string_match)
     41 
     42 // See pub_{core,tool}_options.h for explanations of all these.
     43 
     44 
     45 /* Define, and set defaults. */
     46 VexControl VG_(clo_vex_control);
     47 Bool   VG_(clo_error_limit)    = True;
     48 Int    VG_(clo_error_exitcode) = 0;
     49 Bool   VG_(clo_db_attach)      = False;
     50 Char*  VG_(clo_db_command)     = GDB_PATH " -nw %f %p";
     51 Int    VG_(clo_gen_suppressions) = 0;
     52 Int    VG_(clo_sanity_level)   = 1;
     53 Int    VG_(clo_verbosity)      = 1;
     54 Bool   VG_(clo_stats)          = False;
     55 Bool   VG_(clo_xml)            = False;
     56 HChar* VG_(clo_xml_user_comment) = NULL;
     57 Bool   VG_(clo_demangle)       = True;
     58 Bool   VG_(clo_trace_children) = False;
     59 HChar* VG_(clo_trace_children_skip) = NULL;
     60 Bool   VG_(clo_child_silent_after_fork) = False;
     61 Char*  VG_(clo_log_fname_expanded) = NULL;
     62 Char*  VG_(clo_xml_fname_expanded) = NULL;
     63 Bool   VG_(clo_time_stamp)     = False;
     64 Int    VG_(clo_input_fd)       = 0; /* stdin */
     65 Int    VG_(clo_n_suppressions) = 0;
     66 Char*  VG_(clo_suppressions)[VG_CLO_MAX_SFILES];
     67 Int    VG_(clo_n_fullpath_after) = 0;
     68 Char*  VG_(clo_fullpath_after)[VG_CLO_MAX_FULLPATH_AFTER];
     69 UChar  VG_(clo_trace_flags)    = 0; // 00000000b
     70 UChar  VG_(clo_profile_flags)  = 0; // 00000000b
     71 Int    VG_(clo_trace_notbelow) = 999999999;
     72 Bool   VG_(clo_trace_syscalls) = False;
     73 Bool   VG_(clo_trace_signals)  = False;
     74 Bool   VG_(clo_trace_symtab)   = False;
     75 HChar* VG_(clo_trace_symtab_patt) = "*";
     76 Bool   VG_(clo_trace_cfi)      = False;
     77 Bool   VG_(clo_debug_dump_syms) = False;
     78 Bool   VG_(clo_debug_dump_line) = False;
     79 Bool   VG_(clo_debug_dump_frames) = False;
     80 Bool   VG_(clo_trace_redir)    = False;
     81 Bool   VG_(clo_trace_sched)    = False;
     82 Bool   VG_(clo_profile_heap)   = False;
     83 Int    VG_(clo_dump_error)     = 0;
     84 Int    VG_(clo_backtrace_size) = 12;
     85 Char*  VG_(clo_sim_hints)      = NULL;
     86 Bool   VG_(clo_sym_offsets)    = False;
     87 Bool   VG_(clo_read_var_info)  = False;
     88 Int    VG_(clo_n_req_tsyms)    = 0;
     89 HChar* VG_(clo_req_tsyms)[VG_CLO_MAX_REQ_TSYMS];
     90 HChar* VG_(clo_require_text_symbol) = NULL;
     91 Bool   VG_(clo_run_libc_freeres) = True;
     92 Bool   VG_(clo_track_fds)      = False;
     93 Bool   VG_(clo_show_below_main)= False;
     94 Bool   VG_(clo_show_emwarns)   = False;
     95 Word   VG_(clo_max_stackframe) = 2000000;
     96 Word   VG_(clo_main_stacksize) = 0; /* use client's rlimit.stack */
     97 Bool   VG_(clo_wait_for_gdb)   = False;
     98 VgSmc  VG_(clo_smc_check)      = Vg_SmcStack;
     99 HChar* VG_(clo_kernel_variant) = NULL;
    100 Bool   VG_(clo_dsymutil)       = False;
    101 Char*  VG_(clo_memfs_malloc_path) = NULL;
    102 Int    VG_(clo_memfs_page_size)  = 2048;  /* 2M */
    103 
    104 
    105 /*====================================================================*/
    106 /*=== File expansion                                               ===*/
    107 /*====================================================================*/
    108 
    109 // Copies the string, prepending it with the startup working directory, and
    110 // expanding %p and %q entries.  Returns a new, malloc'd string.
    111 Char* VG_(expand_file_name)(Char* option_name, Char* format)
    112 {
    113    static Char base_dir[VKI_PATH_MAX];
    114    Int len, i = 0, j = 0;
    115    Char* out;
    116 
    117    Bool ok = VG_(get_startup_wd)(base_dir, VKI_PATH_MAX);
    118    tl_assert(ok);
    119 
    120    if (VG_STREQ(format, "")) {
    121       // Empty name, bad.
    122       VG_(fmsg)("%s: filename is empty", option_name);
    123       goto bad;
    124    }
    125 
    126    // If 'format' starts with a '~', abort -- the user probably expected the
    127    // shell to expand but it didn't (see bug 195268 for details).  This means
    128    // that we don't allow a legitimate filename beginning with '~' but that
    129    // seems very unlikely.
    130    if (format[0] == '~') {
    131       VG_(fmsg)(
    132          "%s: filename begins with '~'\n"
    133          "You probably expected the shell to expand the '~', but it\n"
    134          "didn't.  The rules for '~'-expansion vary from shell to shell.\n"
    135          "You might have more luck using $HOME instead.\n",
    136          option_name
    137       );
    138       goto bad;
    139    }
    140 
    141    // If 'format' starts with a '/', do not prefix with startup dir.
    142    if (format[0] != '/') {
    143       j += VG_(strlen)(base_dir);
    144    }
    145 
    146    // The 10 is slop, it should be enough in most cases.
    147    len = j + VG_(strlen)(format) + 10;
    148    out = VG_(malloc)( "options.efn.1", len );
    149    if (format[0] != '/') {
    150       VG_(strcpy)(out, base_dir);
    151       out[j++] = '/';
    152    }
    153 
    154 #define ENSURE_THIS_MUCH_SPACE(x) \
    155    if (j + x >= len) { \
    156       len += (10 + x); \
    157       out = VG_(realloc)("options.efn.2(multiple)", out, len); \
    158    }
    159 
    160    while (format[i]) {
    161       if (format[i] != '%') {
    162          ENSURE_THIS_MUCH_SPACE(1);
    163          out[j++] = format[i++];
    164 
    165       } else {
    166          // We saw a '%'.  What's next...
    167          i++;
    168          if      ('%' == format[i]) {
    169             // Replace '%%' with '%'.
    170             ENSURE_THIS_MUCH_SPACE(1);
    171             out[j++] = format[i++];
    172          }
    173          else if ('p' == format[i]) {
    174             // Print the PID.  Assume that it's not longer than 10 chars --
    175             // reasonable since 'pid' is an Int (ie. 32 bits).
    176             Int pid = VG_(getpid)();
    177             ENSURE_THIS_MUCH_SPACE(10);
    178             j += VG_(sprintf)(&out[j], "%d", pid);
    179             i++;
    180          }
    181          else if ('q' == format[i]) {
    182             i++;
    183             if ('{' == format[i]) {
    184                // Get the env var name, print its contents.
    185                Char* qualname;
    186                Char* qual;
    187                i++;
    188                qualname = &format[i];
    189                while (True) {
    190                   if (0 == format[i]) {
    191                      VG_(fmsg)("%s: malformed %%q specifier\n", option_name);
    192                      goto bad;
    193                   } else if ('}' == format[i]) {
    194                      // Temporarily replace the '}' with NUL to extract var
    195                      // name.
    196                      format[i] = 0;
    197                      qual = VG_(getenv)(qualname);
    198                      if (NULL == qual) {
    199                         VG_(fmsg)("%s: environment variable %s is not set\n",
    200                                   option_name, qualname);
    201                         format[i] = '}';  // Put the '}' back.
    202                         goto bad;
    203                      }
    204                      format[i] = '}';     // Put the '}' back.
    205                      i++;
    206                      break;
    207                   }
    208                   i++;
    209                }
    210                ENSURE_THIS_MUCH_SPACE(VG_(strlen)(qual));
    211                j += VG_(sprintf)(&out[j], "%s", qual);
    212             } else {
    213                VG_(fmsg)("%s: expected '{' after '%%q'\n", option_name);
    214                goto bad;
    215             }
    216          }
    217          else {
    218             // Something else, abort.
    219             VG_(fmsg)("%s: expected 'p' or 'q' or '%%' after '%%'\n",
    220                       option_name);
    221             goto bad;
    222          }
    223       }
    224    }
    225    ENSURE_THIS_MUCH_SPACE(1);
    226    out[j++] = 0;
    227 
    228    return out;
    229 
    230   bad: {
    231    Char* opt =    // 2:  1 for the '=', 1 for the NUL.
    232       VG_(malloc)( "options.efn.3",
    233                    VG_(strlen)(option_name) + VG_(strlen)(format) + 2 );
    234    VG_(strcpy)(opt, option_name);
    235    VG_(strcat)(opt, "=");
    236    VG_(strcat)(opt, format);
    237    VG_(fmsg_bad_option)(opt, "");
    238   }
    239 }
    240 
    241 /*====================================================================*/
    242 /*=== --trace-children= support                                    ===*/
    243 /*====================================================================*/
    244 
    245 static HChar const* consume_commas ( HChar const* c ) {
    246    while (*c && *c == ',') {
    247       ++c;
    248    }
    249    return c;
    250 }
    251 
    252 static HChar const* consume_field ( HChar const* c ) {
    253    while (*c && *c != ',') {
    254       ++c;
    255    }
    256    return c;
    257 }
    258 
    259 /* Should we trace into this child executable (across execve etc) ?
    260    This involves considering --trace-children=, --trace-children-skip=
    261    and the name of the executable. */
    262 Bool VG_(should_we_trace_this_child) ( HChar* child_exe_name )
    263 {
    264    // child_exe_name is pulled out of the guest's space.  We
    265    // should be at least marginally cautious with it, lest it
    266    // explode or burst into flames unexpectedly.
    267    if (child_exe_name == NULL || VG_(strlen)(child_exe_name) == 0)
    268       return VG_(clo_trace_children);  // we know narfink
    269 
    270    // the main logic
    271    // If --trace-children=no, the answer is simply NO.
    272    if (! VG_(clo_trace_children))
    273       return False;
    274 
    275    // otherwise, return True, unless the exe name matches any of the
    276    // patterns specified by --trace-children-skip=.
    277    if (VG_(clo_trace_children_skip)) {
    278       HChar const* last = VG_(clo_trace_children_skip);
    279       HChar const* name = (HChar const*)child_exe_name;
    280       while (*last) {
    281          Bool   matches;
    282          HChar* patt;
    283          HChar const* first = consume_commas(last);
    284          last = consume_field(first);
    285          if (first == last)
    286             break;
    287          vg_assert(last > first);
    288          /* copy the candidate string into a temporary malloc'd block
    289             so we can use VG_(string_match) on it. */
    290          patt = VG_(calloc)("m_options.swttc.1", last - first + 1, 1);
    291          VG_(memcpy)(patt, first, last - first);
    292          vg_assert(patt[last-first] == 0);
    293          matches = VG_(string_match)(patt, name);
    294          VG_(free)(patt);
    295          if (matches)
    296             return False;
    297       }
    298    }
    299 
    300    // --trace-children=yes, and this particular executable isn't
    301    // excluded
    302    return True;
    303 }
    304 
    305 
    306 /*--------------------------------------------------------------------*/
    307 /*--- end                                                          ---*/
    308 /*--------------------------------------------------------------------*/
    309