llvm.org GIT mirror llvm / 9cca1f1
[dsymutil] Add a manpage for dsymutil git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@317221 91177308-0d34-0410-b5e6-96231b3b80d8 Jonas Devlieghere 1 year, 9 months ago
4 changed file(s) with 94 addition(s) and 6 deletion(s). Raw diff Collapse all Expand all
22 if (LLVM_ENABLE_DOXYGEN)
33 set(abs_top_srcdir ${CMAKE_CURRENT_SOURCE_DIR})
44 set(abs_top_builddir ${CMAKE_CURRENT_BINARY_DIR})
5
5
66 if (HAVE_DOT)
77 set(DOT ${LLVM_PATH_DOT})
88 endif()
2020 set(enable_external_search "NO")
2121 set(extra_search_mappings "")
2222 endif()
23
23
2424 # If asked, configure doxygen for the creation of a Qt Compressed Help file.
2525 option(LLVM_ENABLE_DOXYGEN_QT_HELP
2626 "Generate a Qt Compressed Help file." OFF)
2727 if (LLVM_ENABLE_DOXYGEN_QT_HELP)
2828 set(LLVM_DOXYGEN_QCH_FILENAME "org.llvm.qch" CACHE STRING
2929 "Filename of the Qt Compressed help file")
30 set(LLVM_DOXYGEN_QHP_NAMESPACE "org.llvm" CACHE STRING
30 set(LLVM_DOXYGEN_QHP_NAMESPACE "org.llvm" CACHE STRING
3131 "Namespace under which the intermediate Qt Help Project file lives")
3232 set(LLVM_DOXYGEN_QHP_CUST_FILTER_NAME "${PACKAGE_STRING}" CACHE STRING
3333 "See http://qt-project.org/doc/qt-4.8/qthelpproject.html#custom-filters")
3434 set(LLVM_DOXYGEN_QHP_CUST_FILTER_ATTRS "${PACKAGE_NAME},${PACKAGE_VERSION}" CACHE STRING
3535 "See http://qt-project.org/doc/qt-4.8/qthelpproject.html#filter-attributes")
36 find_program(LLVM_DOXYGEN_QHELPGENERATOR_PATH qhelpgenerator
36 find_program(LLVM_DOXYGEN_QHELPGENERATOR_PATH qhelpgenerator
3737 DOC "Path to the qhelpgenerator binary")
3838 if (NOT LLVM_DOXYGEN_QHELPGENERATOR_PATH)
3939 message(FATAL_ERROR "Failed to find qhelpgenerator binary")
5454 set(llvm_doxygen_qhp_cust_filter_name "")
5555 set(llvm_doxygen_qhp_cust_filter_attrs "")
5656 endif()
57
57
5858 option(LLVM_DOXYGEN_SVG
5959 "Use svg instead of png files for doxygen graphs." OFF)
6060 if (LLVM_DOXYGEN_SVG)
112112 if (${SPHINX_OUTPUT_MAN})
113113 add_sphinx_target(man llvm)
114114 add_sphinx_target(man llvm-dwarfdump)
115 add_sphinx_target(man llvm-dsymutil)
115116 endif()
116117
117118 endif()
2929 llvm-stress
3030 llvm-symbolizer
3131 llvm-dwarfdump
32 llvm-dsymutil
3233
3334 Debugging Tools
3435 ~~~~~~~~~~~~~~~
0 llvm-dsymutil - manipulate archived DWARF debug symbol files
1 ============================================================
2
3 SYNOPSIS
4 --------
5
6 :program:`llvm-dsymutil` [*options*] [*filename*]
7
8 DESCRIPTION
9 -----------
10
11 :program:`llvm-dsymutil` links the DWARF debug information found in the object
12 files for the executable input file by using debug symbols information
13 contained in its symbol table.
14
15 OPTIONS
16 -------
17 .. option:: -arch=
18
19 Link DWARF debug information only for specified CPU architecture
20 types. This option can be specified multiple times, once for each
21 desired architecture. All cpu architectures will be linked by
22 default.
23
24 .. option:: -dump-debug-map
25
26 Parse and dump the debug map to standard output. Not DWARF link
27 will take place.
28
29 .. option:: -f, -flat
30
31 Produce a flat dSYM file (not a bundle).
32
33 .. option:: -no-odr
34
35 Do not use ODR (One Definition Rule) for type uniquing.
36
37 .. option:: -no-output
38
39 Do the link in memory, but do not emit the result file.
40
41 .. option:: -no-swiftmodule-timestamp
42
43 Don't check timestamp for swiftmodule files.
44
45 .. option:: -j , -num-threads=
46
47 Specifies the maximum number (n) of simultaneous threads to use
48 when linking multiple architectures.
49
50 .. option:: -o=
51
52 Specify the output file. default: .dwarf
53
54 .. option:: -oso-prepend-path=
55
56 Specify a directory to prepend to the paths of object files.
57
58 .. option:: -s, -symtab
59
60 Dumps the symbol table found in executable or object file(s) and
61 exits.
62
63 .. option:: -v, -verbose
64
65 Verbosity level
66
67 .. option:: --version
68
69 Display the version of the tool.
70
71 .. option:: -y
72
73 Treat the input file is a YAML debug map rather than a binary.
74
75
76 EXIT STATUS
77 -----------
78
79 :program:`llvm-dsymutil` returns 0 if the DWARF debug information was linked
80 successfully. Otherwise, it returns 1.
81
82 SEE ALSO
83 --------
84
85 :manpage:`llvm-dwarfdump(1)`
138138 SEE ALSO
139139 --------
140140
141 :manpage:`dsymutil(1)`
141 :manpage:`llvm-dsymutil(1)`