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 [\-\-nested]
  41 [\-\-param]
  42 [\-\-parconst]
  43 [\-\-property]
  44 [\-\-propertymap]
  45 [\-\-standalonesig]
  46 [\-\-typedef]
  47 [\-\-typeref]
  48 [\-\-typespec]
  49 [\-\-blob]
  50 [FILES...]
  51 .SH DESCRIPTION
  52 The \fImonodis\fP program is used to dump the contents a CIL image
  53 (contained in .EXE files that contain extended PE/COFF CIL code).
  54 .PP
  55 To roundtrip assemblies using ilasm, it is best to use the --output
  56 argument, as that will make monodis save the embedded resources in
  57 files that can later be properly embedded back by ilasm.
  58 .SH OPTIONS
  59 The following Generic options are supported:
  60 .TP
  61 .I "--help", "-h"
  62 Displays usage instructions.
  63 .TP
  64 .I "--output=FILENAME"
  65 Write output into \fIFILENAME\fP and dump any embedded managed resources.
  66 .TP
  67 .I "--mscorlib"
  68 For non-corlib assemblies, use "mscorlib" as the assembly name. This
  69 is useful for round-tripping the IL with ilasm.
  70 .TP
  71 .I "--show-method-tokens"
  72 Display tokens for disassembled methods.
  73 .TP
  74 .I "--assembly"
  75 Dumps the contents of the Assembly table.
  76 .TP
  77 .I "--assemblyref"
  78 Dumps the contents of the AssemblyRef table.
  79 .TP
  80 .I "--classlayout"
  81 Dumps the contents of the ClassLayout table.
  82 .TP
  83 .I "--constant"
  84 Dumps the contents of the Constant table.
  85 .TP
  86 .I "--customattr"
  87 Dumps the contents of the CustomAttribute table.
  88 .TP
  89 .I "--declsec"
  90 Dumps the contents of the DeclSec table.
  91 .TP
  92 .I "--event"
  93 Dumps the contents of the Event table.
  94 .TP
  95 .I "--exported"
  96 Dumps the contents of the ExportedType table.
  97 .TP
  98 .I "--fields"
  99 Dumps the contents of the Field table.
 100 .TP
 101 .I "--file"
 102 Dumps the contents of the File table.
 103 .TP
 104 .I "--forward-decls"
 105 Dumps forward declarations for classes.
 106 .TP
 107 .I "--genericpar"
 108 Dumps the contents of the GenericParam table.
 109 .TP
 110 .I "--implmap"
 111 Dumps the contents of the ImplMap table.
 112 .TP
 113 .I "--interface"
 114 Dumps the contents of the InterfaceImpl table.
 115 .TP
 116 .I "--manifest"
 117 Dumps the contents of the ManifestResource table.
 118 .TP
 119 .I "--marshal"
 120 Dumps the contents of the FieldMarshal table.
 121 .TP
 122 .I "--memberref"
 123 Dumps the contents of the MemberRef table.
 124 .TP
 125 .I "--method"
 126 Dumps the contents of the MethodDef table.
 127 .TP
 128 .I "--methodimpl"
 129 Dumps the contents of the MethodImpl table.
 130 .TP
 131 .I "--methodspec"
 132 Dumps the contents of the MethodSpec table.
 133 .TP
 134 .I "--methodsem"
 135 Dumps the contents of the MethodSemantics table.
 136 .TP
 137 .I "--module"
 138 Dumps the contents of the Module table.
 139 .TP
 140 .I "--moduleref"
 141 Dumps the contents of the ModuleRef table.
 142 .TP
 143 .I "--mresources"
 144 Dumps the managed resources embedded in the assembly.
 145 .TP
 146 .I "--nested"
 147 Dumps the contents of the NestedClass table.
 148 .TP
 149 .I "--param"
 150 Dumps the contents of the Param table.
 151 .TP
 152 .I "--parconst"
 153 Dumps the contents of the GenericParameterConstraint table.
 154 .TP
 155 .I "--property"
 156 Dumps the contents of the Property table.
 157 .TP
 158 .I "--propertymap"
 159 Dumps the contents of the PropertyMap table.
 160 .TP
 161 .I "--standalonesig"
 162 Dumps the contents of the StandAloneSig table.
 163 .TP
 164 .I "--typedef"
 165 Dumps the contents of the TypeDef table.
 166 .TP
 167 .I "--typespec"
 168 Dumps the contents of the TypeSpec table.
 169 .TP
 170 .I "--typeref"
 171 Dumps the contents of the TypeRef table.
 172 .TP
 173 .I "--blob"
 174 Dumps the entire contents of the blob stream as hex.
 175 .PP
 176 If no flags are specified the program dumps the content of the image
 177 in a format that can be used to rountrip the code.
 178 .PP
 179 .SH ENVIRONMENT VARIABLES
 180 .TP
 181 .I "MONO_PATH"
 182 Provides a search path to mono and mint where to look for library files.
 183 Directories are separated by the platform path separator (colons on unix). Example:
 184 .B /home/username/lib:/usr/local/mono/lib
 185 .PP
 186 .SH AUTHOR
 187 monodis was written by Miguel de Icaza, Paolo Molaro and Dietmar Maurer.
 188 .SH SEE ALSO
 189 .BR pedump(1)