Fix mono build with disabled sgen (#4915)
[mono.git] / mono / dis / monodis.1
index c1b33f9aee071514ac2542ed6451697b954a0f69..182d117308c9b9254b93762a78e15f127c9e33a3 100644 (file)
@@ -37,6 +37,7 @@ monodis \- CIL image content dumper and disassembler.
 [\-\-module]
 [\-\-moduleref]
 [\-\-mresources]
+[\-\-presources]
 [\-\-nested]
 [\-\-param]
 [\-\-parconst]
@@ -47,10 +48,20 @@ monodis \- CIL image content dumper and disassembler.
 [\-\-typeref]
 [\-\-typespec]
 [\-\-blob]
+[\-\-strings]
+[\-\-userstrings]
 [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
@@ -66,6 +77,9 @@ 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"
 Dumps the contents of the Assembly table.
@@ -137,7 +151,12 @@ Dumps the contents of the Module table.
 Dumps the contents of the ModuleRef table.
 .TP
 .I "--mresources"
-Dumps the managed resources embedded in the assembly.
+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.
@@ -168,6 +187,12 @@ 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
 in a format that can be used to rountrip the code.