[dsymutil] Add a manpage for dsymutil

llvm-svn: 317221

3 files changed, 88 insertions, 1 deletions

diff --git a/llvm/docs/CommandGuide/index.rst b/llvm/docs/CommandGuide/index.rst
index 5a0a98ceb1f..a706ba1d675 100644
--- a/llvm/docs/CommandGuide/index.rst
+++ b/llvm/docs/CommandGuide/index.rst
@@ -30,6 +30,7 @@ Basic Commands
    llvm-stress
    llvm-symbolizer
    llvm-dwarfdump
+   llvm-dsymutil
 
 Debugging Tools
 ~~~~~~~~~~~~~~~
diff --git a/llvm/docs/CommandGuide/llvm-dsymutil.rst b/llvm/docs/CommandGuide/llvm-dsymutil.rst
new file mode 100644
index 00000000000..19340e194b8
--- /dev/null
+++ b/llvm/docs/CommandGuide/llvm-dsymutil.rst
@@ -0,0 +1,86 @@
+llvm-dsymutil - manipulate archived DWARF debug symbol files
+============================================================
+
+SYNOPSIS
+--------
+
+:program:`llvm-dsymutil` [*options*] [*filename*]
+
+DESCRIPTION
+-----------
+
+:program:`llvm-dsymutil` links the DWARF debug information found in the object
+files for the executable input file by using debug symbols information
+contained in its symbol table.
+
+OPTIONS
+-------
+.. option:: -arch=<string>
+
+            Link DWARF debug information only for specified CPU architecture
+            types. This option can be specified multiple times, once for each
+            desired architecture.  All cpu architectures will be linked by
+            default.
+
+.. option:: -dump-debug-map
+
+            Parse and dump the debug map to standard output. Not DWARF link
+            will take place.
+
+.. option:: -f, -flat
+
+            Produce a flat dSYM file (not a bundle).
+
+.. option:: -no-odr
+
+            Do not use ODR (One Definition Rule) for type uniquing.
+
+.. option:: -no-output
+
+            Do the link in memory, but do not emit the result file.
+
+.. option:: -no-swiftmodule-timestamp
+
+            Don't check timestamp for swiftmodule files.
+
+.. option:: -j <n>, -num-threads=<n>
+
+            Specifies the maximum number (n) of simultaneous threads to use
+            when linking multiple architectures.
+
+.. option:: -o=<filename>
+
+            Specify the output file. default: <input file>.dwarf
+
+.. option:: -oso-prepend-path=<path>
+
+            Specify a directory to prepend to the paths of object files.
+
+.. option:: -s, -symtab
+
+            Dumps the symbol table found in executable or object file(s) and
+            exits.
+
+.. option:: -v, -verbose
+
+            Verbosity level
+
+.. option:: --version
+
+            Display the version of the tool.
+
+.. option:: -y
+
+            Treat the input file is a YAML debug map rather than a binary.
+
+
+EXIT STATUS
+-----------
+
+:program:`llvm-dsymutil` returns 0 if the DWARF debug information was linked
+successfully. Otherwise, it returns 1.
+
+SEE ALSO
+--------
+
+:manpage:`llvm-dwarfdump(1)`
diff --git a/llvm/docs/CommandGuide/llvm-dwarfdump.rst b/llvm/docs/CommandGuide/llvm-dwarfdump.rst
index a3b62664cbe..4e7791573e6 100644
--- a/llvm/docs/CommandGuide/llvm-dwarfdump.rst
+++ b/llvm/docs/CommandGuide/llvm-dwarfdump.rst
@@ -139,4 +139,4 @@ successfully. Otherwise, it returns 1.
 SEE ALSO
 --------
 
-:manpage:`dsymutil(1)`
+:manpage:`llvm-dsymutil(1)`