tools/dsymutil/Options.td

   1 include "llvm/Option/OptParser.td"
   2
   3 class F<string name>: Flag<["--", "-"], name>;
   4
   5 def grp_general : OptionGroup<"Dsymutil">, HelpText<"Dsymutil Options">;
   6
   7 def help: F<"help">,
   8   HelpText<"Prints this help output.">,
   9   Group<grp_general>;
  10 def: Flag<["-"], "h">,
  11   Alias<help>,
  12   HelpText<"Alias for --help">,
  13   Group<grp_general>;
  14
  15 def version: F<"version">,
  16   HelpText<"Prints the dsymutil version.">,
  17   Group<grp_general>;
  18 def: Flag<["-"], "v">,
  19   Alias<version>,
  20   HelpText<"Alias for --version">,
  21   Group<grp_general>;
  22
  23 def verbose: F<"verbose">,
  24   HelpText<"Enable verbose mode.">,
  25   Group<grp_general>;
  26
  27 def verify: F<"verify">,
  28   HelpText<"Run the DWARF verifier on the linked DWARF debug info.">,
  29   Group<grp_general>;
  30
  31 def no_output: F<"no-output">,
  32   HelpText<"Do the link in memory, but do not emit the result file.">,
  33   Group<grp_general>;
  34
  35 def no_swiftmodule_timestamp: F<"no-swiftmodule-timestamp">,
  36   HelpText<"Don't check timestamp for swiftmodule files.">,
  37   Group<grp_general>;
  38
  39 def no_odr: F<"no-odr">,
  40   HelpText<"Do not use ODR (One Definition Rule) for type uniquing.">,
  41   Group<grp_general>;
  42
  43 def dump_debug_map: F<"dump-debug-map">,
  44   HelpText<"Parse and dump the debug map to standard output. Not DWARF link will take place.">,
  45   Group<grp_general>;
  46
  47 def yaml_input: F<"y">,
  48   HelpText<"Treat the input file is a YAML debug map rather than a binary.">,
  49   Group<grp_general>;
  50
  51 def papertrail: F<"papertrail">,
  52   HelpText<"Embed warnings in the linked DWARF debug info.">,
  53   Group<grp_general>;
  54
  55 def assembly: F<"S">,
  56   HelpText<"Output textual assembly instead of a binary dSYM companion file.">,
  57   Group<grp_general>;
  58
  59 def symtab: F<"symtab">,
  60   HelpText<"Dumps the symbol table found in executable or object file(s) and exits.">,
  61   Group<grp_general>;
  62 def: Flag<["-"], "s">,
  63   Alias<symtab>,
  64   HelpText<"Alias for --symtab">,
  65   Group<grp_general>;
  66
  67 def flat: F<"flat">,
  68   HelpText<"Produce a flat dSYM file (not a bundle).">,
  69   Group<grp_general>;
  70 def: Flag<["-"], "f">,
  71   Alias<flat>,
  72   HelpText<"Alias for --flat">,
  73   Group<grp_general>;
  74
  75 def minimize: F<"minimize">,
  76   HelpText<"When used when creating a dSYM file with Apple accelerator tables, "
  77            "this option will suppress the emission of the .debug_inlines, "
  78            ".debug_pubnames, and .debug_pubtypes sections since dsymutil "
  79            "has better equivalents: .apple_names and .apple_types. When used in "
  80            "conjunction with --update option, this option will cause redundant "
  81            "accelerator tables to be removed.">,
  82   Group<grp_general>;
  83 def: Flag<["-"], "z">,
  84   Alias<minimize>,
  85   HelpText<"Alias for --minimize">,
  86   Group<grp_general>;
  87
  88 def update: F<"update">,
  89   HelpText<"Updates existing dSYM files to contain the latest accelerator tables and other DWARF optimizations.">,
  90   Group<grp_general>;
  91 def: Flag<["-"], "u">,
  92   Alias<update>,
  93   HelpText<"Alias for --update">,
  94   Group<grp_general>;
  95
  96 def output: Separate<["--", "-"], "o">,
  97   MetaVarName<"<filename>">,
  98   HelpText<"Specify the output file. Defaults to <input file>.dwarf">,
  99   Group<grp_general>;
 100 def: Separate<["-"], "out">,
 101   Alias<output>,
 102   HelpText<"Alias for --o">,
 103   Group<grp_general>;
 104 def: Joined<["--", "-"], "out=">, Alias<output>;
 105 def: Joined<["--", "-"], "o=">, Alias<output>;
 106
 107 def oso_prepend_path: Separate<["--", "-"], "oso-prepend-path">,
 108   MetaVarName<"<path>">,
 109   HelpText<"Specify a directory to prepend to the paths of object files.">,
 110   Group<grp_general>;
 111 def: Joined<["--", "-"], "oso-prepend-path=">, Alias<oso_prepend_path>;
 112
 113 def symbolmap: Separate<["--", "-"], "symbol-map">,
 114   MetaVarName<"<bcsymbolmap>">,
 115   HelpText<"Updates the existing dSYMs inplace using symbol map specified.">,
 116   Group<grp_general>;
 117 def: Joined<["--", "-"], "symbol-map=">, Alias<symbolmap>;
 118
 119 def arch: Separate<["--", "-"], "arch">,
 120   MetaVarName<"<arch>">,
 121   HelpText<"Link DWARF debug information only for specified CPU architecture"
 122            "types. This option can be specified multiple times, once for each"
 123            "desired architecture. All CPU architectures will be linked by"
 124            "default.">,
 125   Group<grp_general>;
 126 def: Joined<["--", "-"], "arch=">, Alias<arch>;
 127
 128 def accelerator: Separate<["--", "-"], "accelerator">,
 129   MetaVarName<"<accelerator type>">,
 130   HelpText<"Specify the desired type of accelerator table. Valid options are 'Apple', 'Dwarf' and 'Default'">,
 131   Group<grp_general>;
 132 def: Joined<["--", "-"], "accelerator=">, Alias<accelerator>;
 133
 134 def toolchain: Separate<["--", "-"], "toolchain">,
 135   MetaVarName<"<toolchain>">,
 136   HelpText<"Embed toolchain information in dSYM bundle.">,
 137   Group<grp_general>;
 138
 139 def threads: Separate<["--", "-"], "num-threads">,
 140   MetaVarName<"<threads>">,
 141   HelpText<"Specifies the maximum number of simultaneous threads to use when linking multiple architectures.">,
 142   Group<grp_general>;
 143 def: Separate<["-"], "j">,
 144   Alias<threads>,
 145   HelpText<"Alias for --num-threads">,
 146   Group<grp_general>;