mono/dis/monodis.1

   1 .\"
   2 .\" monodis manual page.
   3 .\" (C) Ximian, Inc.
   4 .\" Author:
   5 .\"   Miguel de Icaza (miguel@gnu.org)
   6 .\"
   7 .TH Mono "Mono 1.1.x"
   8 .SH NAME
   9 monodis \- CIL image content dumper and disassembler.
  10 .SH SYNOPSIS
  11 .PP
  12 .B monodis
  13 [\-h] [\-\-help]
  14 [\-\-output=FILENAME]
  15 [\-\-mscorlib]
  16 [\-\-assembly]
  17 [\-\-assemblyref]
  18 [\-\-classlayout]
  19 [\-\-constant]
  20 [\-\-customattr]
  21 [\-\-declsec]
  22 [\-\-event]
  23 [\-\-exported]
  24 [\-\-fields]
  25 [\-\-file]
  26 [\-\-forward-decls]
  27 [\-\-genericpar]
  28 [\-\-implmap]
  29 [\-\-interface]
  30 [\-\-manifest]
  31 [\-\-marshal]
  32 [\-\-memberref]
  33 [\-\-method]
  34 [\-\-methodimpl]
  35 [\-\-methodsem]
  36 [\-\-methodspec]
  37 [\-\-module]
  38 [\-\-moduleref]
  39 [\-\-mresources]
  40 [\-\-presources]
  41 [\-\-nested]
  42 [\-\-param]
  43 [\-\-parconst]
  44 [\-\-property]
  45 [\-\-propertymap]
  46 [\-\-standalonesig]
  47 [\-\-typedef]
  48 [\-\-typeref]
  49 [\-\-typespec]
  50 [\-\-blob]
  51 [\-\-strings]
  52 [\-\-userstrings]
  53 [FILES...]
  54 .SH DESCRIPTION
  55 The \fImonodis\fP program is used to dump the contents an ECMA/ISO CIL
  56 image (contained in .EXE files that contain extended PE/COFF CIL
  57 code).
  58 .PP
  59 To roundtrip assemblies using ilasm, it is best to use the --output
  60 argument, as that will make monodis save the embedded resources in
  61 files that can later be properly embedded back by ilasm.
  62 .PP
  63 Additionally, the tool can be used to dump the contents of the various
  64 ECMA CIL metadata tables.
  65 .SH OPTIONS
  66 The following Generic options are supported:
  67 .TP
  68 .I "--help", "-h"
  69 Displays usage instructions.
  70 .TP
  71 .I "--output=FILENAME"
  72 Write output into \fIFILENAME\fP and dump any embedded managed resources.
  73 .TP
  74 .I "--mscorlib"
  75 For non-corlib assemblies, use "mscorlib" as the assembly name. This
  76 is useful for round-tripping the IL with ilasm.
  77 .TP
  78 .I "--show-method-tokens"
  79 Display tokens for disassembled methods.
  80 .SH OPTIONS TO DISPLAY METADATA TABLES
  81 The following options are used to display metadata tables instead of
  82 disassembling the CIL image.
  83 .TP
  84 .I "--assembly"
  85 Dumps the contents of the Assembly table.
  86 .TP
  87 .I "--assemblyref"
  88 Dumps the contents of the AssemblyRef table.
  89 .TP
  90 .I "--classlayout"
  91 Dumps the contents of the ClassLayout table.
  92 .TP
  93 .I "--constant"
  94 Dumps the contents of the Constant table.
  95 .TP
  96 .I "--customattr"
  97 Dumps the contents of the CustomAttribute table.
  98 .TP
  99 .I "--declsec"
 100 Dumps the contents of the DeclSec table.
 101 .TP
 102 .I "--event"
 103 Dumps the contents of the Event table.
 104 .TP
 105 .I "--exported"
 106 Dumps the contents of the ExportedType table.
 107 .TP
 108 .I "--fields"
 109 Dumps the contents of the Field table.
 110 .TP
 111 .I "--file"
 112 Dumps the contents of the File table.
 113 .TP
 114 .I "--forward-decls"
 115 Dumps forward declarations for classes.
 116 .TP
 117 .I "--genericpar"
 118 Dumps the contents of the GenericParam table.
 119 .TP
 120 .I "--implmap"
 121 Dumps the contents of the ImplMap table.
 122 .TP
 123 .I "--interface"
 124 Dumps the contents of the InterfaceImpl table.
 125 .TP
 126 .I "--manifest"
 127 Dumps the contents of the ManifestResource table.
 128 .TP
 129 .I "--marshal"
 130 Dumps the contents of the FieldMarshal table.
 131 .TP
 132 .I "--memberref"
 133 Dumps the contents of the MemberRef table.
 134 .TP
 135 .I "--method"
 136 Dumps the contents of the MethodDef table.
 137 .TP
 138 .I "--methodimpl"
 139 Dumps the contents of the MethodImpl table.
 140 .TP
 141 .I "--methodspec"
 142 Dumps the contents of the MethodSpec table.
 143 .TP
 144 .I "--methodsem"
 145 Dumps the contents of the MethodSemantics table.
 146 .TP
 147 .I "--module"
 148 Dumps the contents of the Module table.
 149 .TP
 150 .I "--moduleref"
 151 Dumps the contents of the ModuleRef table.
 152 .TP
 153 .I "--mresources"
 154 Saves all the managed resources embedded in the assembly into the
 155 current directory.   To get a list of the embedded resources use the
 156 --manifest option.
 157 .TP
 158 .I "--presources"
 159 Prints offsets and names of manifest resources embedded in the assembly.
 160 .TP
 161 .I "--nested"
 162 Dumps the contents of the NestedClass table.
 163 .TP
 164 .I "--param"
 165 Dumps the contents of the Param table.
 166 .TP
 167 .I "--parconst"
 168 Dumps the contents of the GenericParameterConstraint table.
 169 .TP
 170 .I "--property"
 171 Dumps the contents of the Property table.
 172 .TP
 173 .I "--propertymap"
 174 Dumps the contents of the PropertyMap table.
 175 .TP
 176 .I "--standalonesig"
 177 Dumps the contents of the StandAloneSig table.
 178 .TP
 179 .I "--typedef"
 180 Dumps the contents of the TypeDef table.
 181 .TP
 182 .I "--typespec"
 183 Dumps the contents of the TypeSpec table.
 184 .TP
 185 .I "--typeref"
 186 Dumps the contents of the TypeRef table.
 187 .TP
 188 .I "--blob"
 189 Dumps the entire contents of the blob stream as hex.
 190 .TP
 191 .I "--strings"
 192 Dumps the contents of the Strings heap.
 193 .TP
 194 .I "--userstrings"
 195 Dumps the contents of the User-Strings heap
 196 .PP
 197 If no flags are specified the program dumps the content of the image
 198 in a format that can be used to rountrip the code.
 199 .PP
 200 .SH ENVIRONMENT VARIABLES
 201 .TP
 202 .I "MONO_PATH"
 203 Provides a search path to mono and mint where to look for library files.
 204 Directories are separated by the platform path separator (colons on unix). Example:
 205 .B /home/username/lib:/usr/local/mono/lib
 206 .PP
 207 .SH AUTHOR
 208 monodis was written by Miguel de Icaza, Paolo Molaro and Dietmar Maurer.
 209 .SH SEE ALSO
 210 .BR pedump(1)