1
0
mirror of https://github.com/Kitware/CMake.git synced 2025-10-21 23:00:50 +08:00

Help: Document CMAKE_OBJDUMP variable

This commit is contained in:
Peter Kokot
2025-01-23 17:34:19 +01:00
committed by Brad King
parent 4bd3519e89
commit dc7aabf4d0
6 changed files with 23 additions and 4 deletions

View File

@@ -1337,7 +1337,7 @@ Handling Runtime Binaries
the actual path to ``objdump``, ``dumpbin``, or ``otool``.
If this variable is not specified, it is determined by the value of
``CMAKE_OBJDUMP`` if set, else by system introspection.
:variable:`CMAKE_OBJDUMP` variable if set, else by system introspection.
.. versionadded:: 3.18
Use ``CMAKE_OBJDUMP`` if set.
Uses :variable:`CMAKE_OBJDUMP` if set.

View File

@@ -93,6 +93,7 @@ Variables that Provide Information
/variable/CMAKE_MINOR_VERSION
/variable/CMAKE_NETRC
/variable/CMAKE_NETRC_FILE
/variable/CMAKE_OBJDUMP
/variable/CMAKE_PARENT_LIST_FILE
/variable/CMAKE_PATCH_VERSION
/variable/CMAKE_PROJECT_DESCRIPTION

View File

@@ -0,0 +1,16 @@
CMAKE_OBJDUMP
-------------
Path to the ``objdump`` executable on the host system. This tool, typically
part of the Binutils collection on Unix-like systems, provides information
about compiled object files.
This cache variable may be populated by CMake when project languages are
enabled using the :command:`project` or :command:`enable_language` commands.
See Also
^^^^^^^^
* The :command:`file(GET_RUNTIME_DEPENDENCIES)` command provides a more general
way to get information from runtime binaries.
* The :variable:`CPACK_OBJDUMP_EXECUTABLE` variable.

View File

@@ -15,6 +15,7 @@
# CMAKE_RANLIB
# CMAKE_LINKER
# CMAKE_MT
# CMAKE_OBJDUMP
# CMAKE_STRIP
# CMAKE_INSTALL_NAME_TOOL

View File

@@ -498,7 +498,7 @@ The following variables are for advanced uses of CPack:
.. versionadded:: 3.25
Specify the ``objdump`` executable path used by CPack.
The default value will be taken from the ``CMAKE_OBJDUMP`` variable, if set,
The default value will be taken from the :variable:`CMAKE_OBJDUMP` variable,
which may be populated by CMake when enabling languages. If ``CMAKE_OBJDUMP``
is not set, CPack will use :command:`find_program` to determine the
``objdump`` path when needed.

View File

@@ -26,7 +26,8 @@ files:
otool (Mac OSX)
.. versionchanged:: 3.16
The tool specified by ``CMAKE_OBJDUMP`` will be used, if set.
The tool specified by the :variable:`CMAKE_OBJDUMP` variable
will be used, if set.
The following functions are provided by this module: