Skip to content

Add debug prefix map #8

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
JPEWdev wants to merge 1 commit into
base: master
Choose a base branch
from
Open

Add debug prefix map #8

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
25 changes: 25 additions & 0 deletions doc/running.src
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -289,6 +289,29 @@ If no debug information is currently implemented in the selected output
format, \c{-g} is \e{silently ignored}.


\S{opt-debug-prefix-map} The \i\c{--debug-prefix-map} Option: Remapping \i{Source File Paths} in Debug Info

This option remaps source file path prefixes when encoding filenames in
the output object file's debug information. It takes a single argument
of the form \c{BASE=DEST}: any source path that begins with \c{BASE} has
that prefix replaced with \c{DEST} before the path is written into the
output. This is useful when building in a different directory from the
one referenced in the source, or when producing \i{reproducible builds}
by stripping machine-specific path components.

For example:

\c nasm -f elf64 -g -F dwarf --debug-prefix-map /home/user/src=/usr/src myfile.asm

causes paths beginning with \c{/home/user/src} to appear as \c{/usr/src}
in the generated DWARF debug information. Multiple \c{--debug-prefix-map}
options may be given; they are applied in the order specified and the
first matching prefix wins.

The option requires an argument of the form \c{BASE=DEST}; omitting the
\c{=} separator is a fatal usage error.


\S{opt-X} The \i\c{-X} Option: Selecting an \i{Error Reporting Format}

This option can be used to select an error reporting format for any
Expand Down Expand Up @@ -575,6 +598,8 @@ For command-line compatibility with Yasm, the form \i\c{--v} is also
accepted for this option starting in NASM version 2.11.05.


\IR{--debug-prefix-map} \c{--debug-prefix-map} option

\IR{--prefix} \c{--prefix} option
\IC{--prefix}{--gprefix} \c{--gprefix} option
\IC{--prefix}{--lprefix} \c{--lprefix} option
Expand Down