Fix mono exception handler crashing on windows.

[mono.git] / mono / dis / monodis.1

diff --git a/mono/dis/monodis.1 b/mono/dis/monodis.1
index 28b2b37bcecd6a09c920ec3851f1ed041d494e9e..182d117308c9b9254b93762a78e15f127c9e33a3 100644 (file)
--- a/mono/dis/monodis.1
+++ b/mono/dis/monodis.1
@@ -4,102 +4,206 @@
 .\" Author:
 .\"   Miguel de Icaza (miguel@gnu.org)
 .\"
 .\" Author:
 .\"   Miguel de Icaza (miguel@gnu.org)
 .\"

-.TH Mono "Mono 1.0"
+.TH Mono "Mono 1.1.x"

 .SH NAME
 monodis \- CIL image content dumper and disassembler.
 .SH SYNOPSIS
 .PP
 .B monodis
 .SH NAME
 monodis \- CIL image content dumper and disassembler.
 .SH SYNOPSIS
 .PP
 .B monodis

-[\-hd] [\-\-help] 
+[\-h] [\-\-help] 
+[\-\-output=FILENAME]

 [\-\-mscorlib]
 [\-\-assembly]
 [\-\-assemblyref]
 [\-\-classlayout]
 [\-\-constant]
 [\-\-mscorlib]
 [\-\-assembly]
 [\-\-assemblyref]
 [\-\-classlayout]
 [\-\-constant]

+[\-\-customattr]
+[\-\-declsec]

 [\-\-event]
 [\-\-event]

+[\-\-exported]

 [\-\-fields]
 [\-\-file]
 [\-\-fields]
 [\-\-file]

+[\-\-forward-decls]
+[\-\-genericpar]
+[\-\-implmap]

 [\-\-interface]
 [\-\-interface]

+[\-\-manifest]
+[\-\-marshal]

 [\-\-memberref]
 [\-\-method]
 [\-\-memberref]
 [\-\-method]

+[\-\-methodimpl]

 [\-\-methodsem]
 [\-\-methodsem]

+[\-\-methodspec]

 [\-\-module]
 [\-\-moduleref]
 [\-\-module]
 [\-\-moduleref]

+[\-\-mresources]
+[\-\-presources]
+[\-\-nested]

 [\-\-param]
 [\-\-param]

+[\-\-parconst]

 [\-\-property]
 [\-\-propertymap]
 [\-\-property]
 [\-\-propertymap]

+[\-\-standalonesig]

 [\-\-typedef]
 [\-\-typeref]
 [\-\-typedef]
 [\-\-typeref]

+[\-\-typespec]
+[\-\-blob]
+[\-\-strings]
+[\-\-userstrings]

 [FILES...]
 .SH DESCRIPTION
 [FILES...]
 .SH DESCRIPTION

-The \fImonodis\fP program is used to dump the contents a CIL image
-(contained in .EXE files that contain extended PE/COFF CIL code).  
+The \fImonodis\fP program is used to dump the contents an ECMA/ISO CIL
+image (contained in .EXE files that contain extended PE/COFF CIL
+code).
+.PP
+To roundtrip assemblies using ilasm, it is best to use the --output
+argument, as that will make monodis save the embedded resources in
+files that can later be properly embedded back by ilasm. 
+.PP
+Additionally, the tool can be used to dump the contents of the various
+ECMA CIL metadata tables.

 .SH OPTIONS
 The following Generic options are supported:
 .TP
 .I "--help", "-h"
 Displays usage instructions.
 .TP
 .SH OPTIONS
 The following Generic options are supported:
 .TP
 .I "--help", "-h"
 Displays usage instructions.
 .TP

+.I "--output=FILENAME"
+Write output into \fIFILENAME\fP and dump any embedded managed resources.
+.TP

 .I "--mscorlib"
 For non-corlib assemblies, use "mscorlib" as the assembly name. This
 is useful for round-tripping the IL with ilasm.
 .TP
 .I "--mscorlib"
 For non-corlib assemblies, use "mscorlib" as the assembly name. This
 is useful for round-tripping the IL with ilasm.
 .TP

+.I "--show-method-tokens"
+Display tokens for disassembled methods.
+.SH OPTIONS TO DISPLAY METADATA TABLES
+The following options are used to display metadata tables instead of
+disassembling the CIL image.
+.TP

 .I "--assembly"
 .I "--assembly"

-Dumps the contents of the assembly table
+Dumps the contents of the Assembly table.

 .TP
 .I "--assemblyref"
 .TP
 .I "--assemblyref"

-Dumps the contents of the assemblyref table
+Dumps the contents of the AssemblyRef table.

 .TP
 .I "--classlayout"
 .TP
 .I "--classlayout"

-Dumps the contents of the classlayout table
+Dumps the contents of the ClassLayout table.

 .TP
 .I "--constant"
 .TP
 .I "--constant"

-Dumps the contents of the constant table
+Dumps the contents of the Constant table.
+.TP
+.I "--customattr"
+Dumps the contents of the CustomAttribute table.
+.TP
+.I "--declsec"
+Dumps the contents of the DeclSec table.

 .TP
 .I "--event"
 .TP
 .I "--event"

-Dumps the contents of the event table
+Dumps the contents of the Event table.
+.TP
+.I "--exported"
+Dumps the contents of the ExportedType table.

 .TP
 .I "--fields"
 .TP
 .I "--fields"

-Dumps the contents of the fields table
+Dumps the contents of the Field table.

 .TP
 .I "--file"
 .TP
 .I "--file"

-Dumps the contents of the file table
+Dumps the contents of the File table.
+.TP
+.I "--forward-decls"
+Dumps forward declarations for classes.
+.TP
+.I "--genericpar"
+Dumps the contents of the GenericParam table.
+.TP
+.I "--implmap"
+Dumps the contents of the ImplMap table.

 .TP
 .I "--interface"
 .TP
 .I "--interface"

-Dumps the contents of the interface table
+Dumps the contents of the InterfaceImpl table.
+.TP
+.I "--manifest"
+Dumps the contents of the ManifestResource table.
+.TP
+.I "--marshal"
+Dumps the contents of the FieldMarshal table.

 .TP
 .I "--memberref"
 .TP
 .I "--memberref"

-Dumps the contents of the memberref table
+Dumps the contents of the MemberRef table.

 .TP
 .I "--method"
 .TP
 .I "--method"

-Dumps the contents of the method table
+Dumps the contents of the MethodDef table.
+.TP
+.I "--methodimpl"
+Dumps the contents of the MethodImpl table.
+.TP
+.I "--methodspec"
+Dumps the contents of the MethodSpec table.

 .TP
 .I "--methodsem"
 .TP
 .I "--methodsem"

-Dumps the contents of the methodsem table
+Dumps the contents of the MethodSemantics table.

 .TP
 .I "--module"
 .TP
 .I "--module"

-Dumps the contents of the module table
+Dumps the contents of the Module table.

 .TP
 .I "--moduleref"
 .TP
 .I "--moduleref"

-Dumps the contents of the moduleref table
+Dumps the contents of the ModuleRef table.
+.TP
+.I "--mresources"
+Saves all the managed resources embedded in the assembly into the
+current directory.   To get a list of the embedded resources use the
+--manifest option.
+.TP
+.I "--presources"
+Prints offsets and names of manifest resources embedded in the assembly.
+.TP
+.I "--nested"
+Dumps the contents of the NestedClass table.

 .TP
 .I "--param"
 .TP
 .I "--param"

-Dumps the contents of the param table
+Dumps the contents of the Param table.
+.TP
+.I "--parconst"
+Dumps the contents of the GenericParameterConstraint table.

 .TP
 .I "--property"
 .TP
 .I "--property"

-Dumps the contents of the property table
+Dumps the contents of the Property table.

 .TP
 .I "--propertymap"
 .TP
 .I "--propertymap"

-Dumps the contents of the propertymap table
+Dumps the contents of the PropertyMap table.
+.TP
+.I "--standalonesig"
+Dumps the contents of the StandAloneSig table.

 .TP
 .I "--typedef"
 .TP
 .I "--typedef"

-Dumps the contents of the typedef table
+Dumps the contents of the TypeDef table.
+.TP
+.I "--typespec"
+Dumps the contents of the TypeSpec table.

 .TP
 .I "--typeref"
 .TP
 .I "--typeref"

-Dumps the contents of the typeref table
+Dumps the contents of the TypeRef table.
+.TP
+.I "--blob"
+Dumps the entire contents of the blob stream as hex.
+.TP
+.I "--strings"
+Dumps the contents of the Strings heap.
+.TP
+.I "--userstrings"
+Dumps the contents of the User-Strings heap

 .PP
 If no flags are specified the program dumps the content of the image
 .PP
 If no flags are specified the program dumps the content of the image

-in a format that can be used to rountrip the code. 
+in a format that can be used to rountrip the code.
+.PP
+.SH ENVIRONMENT VARIABLES
+.TP
+.I "MONO_PATH"
+Provides a search path to mono and mint where to look for library files.
+Directories are separated by the platform path separator (colons on unix). Example:
+.B /home/username/lib:/usr/local/mono/lib
+.PP

 .SH AUTHOR
 monodis was written by Miguel de Icaza, Paolo Molaro and Dietmar Maurer.
 .SH SEE ALSO
 .SH AUTHOR
 monodis was written by Miguel de Icaza, Paolo Molaro and Dietmar Maurer.
 .SH SEE ALSO