aniani/nasm
0
0
Fork 1
mirror of https://github.com/netwide-assembler/nasm.git synced 2025-10-10 00:25:06 -04:00
Code Activity

doc: Add a description for a useful case of mangling symbols

Browse Source 
Signed-off-by: Chang S. Bae <changseok.bae@gmail.com>
This commit is contained in:
Chang S. Bae
2018-10-29 16:16:16 -07:00
committed by Cyrill Gorcunov
parent 4b5b737d49
commit 4310eb9d42
1 changed files with 15 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

18
doc/nasmdoc.src
View File

@@ -4707,6 +4707,18 @@ This is a macro implemented as a \c{%pragma}:
Commandline option is also possible. See also \k{opt-pfix}. Commandline option is also possible. See also \k{opt-pfix}.
Some tool chain is aware of a particular prefix for its own optimization
options, such as code elimination. For instance, Mach-O backend has a
linker that uses a simplistic naming scheme to chunk up sections into a
meta section. When the \c{subsections_via_symbols} directive
(\k{macho-ssvs}) is declared, each symbol is the start of a
separate block. The meta section is, then, defined to include sections
before the one that starts with a 'L'. \c{LPREFIX} is useful here to mark
all local symbols with the 'L' prefix to be excluded to the meta section.
It converts local symbols compatible with the particular tool chain.
Note that local symbols declared with \c{STATIC} (\k{static})
are excluded from the symbol mangling and also not marked as global.
\H{gen-namespace} \i\c{OUTPUT}, \i\c{DEBUG}: Generic Namespaces \H{gen-namespace} \i\c{OUTPUT}, \i\c{DEBUG}: Generic Namespaces
@@ -5823,9 +5835,9 @@ right-hand side of the \c{WRT} operator:
\S{macho-ssvs} \c{macho} specfic directive \i\c{subsections_via_symbols} \S{macho-ssvs} \c{macho} specfic directive \i\c{subsections_via_symbols}
The directive \c{subsections_via_symbols} sets the The directive \c{subsections_via_symbols} sets the
\c{MH_SUBSECTIONS_VIA_SYMBOLS} flag in the Mach-O header, which tells \c{MH_SUBSECTIONS_VIA_SYMBOLS} flag in the Mach-O header, that effectively
the linker that the symbols in the file matches the conventions separates a block (or a subsection) based on a symbol. It is often used
required to allow for link-time dead code elimination. for eliminating dead codes by a linker.
This directive takes no arguments. This directive takes no arguments.