mirror/nasm
2
0
Fork 0
mirror of https://github.com/netwide-assembler/nasm.git synced 2025-01-18 16:25:05 +08:00
Code Issues Packages Projects Releases Wiki Activity

doc: document subsections_via_symbols

Browse Source 
Document the subsections_via_symbols directive.

Signed-off-by: H. Peter Anvin <hpa@linux.intel.com>
This commit is contained in:
H. Peter Anvin 2017-03-07 23:03:11 -08:00
parent fc7c5c3967
commit 7fcd9898f4
2 changed files with 20 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

3
doc/changes.src
View File

@ -23,6 +23,9 @@ since 2007.
\b NASM can now generate sparse output files for relevant output \b NASM can now generate sparse output files for relevant output
formats, if the underlying operating system supports them. formats, if the underlying operating system supports them.
\b \c{macho} object format now supports the \c{subsections_via_symbols}
directive, see \k{macho-ssvs}.
\S{cl-2.12.03} Version 2.12.03 \S{cl-2.12.03} Version 2.12.03
\b Add new warnings for certain dangerous constructs which never ought \b Add new warnings for certain dangerous constructs which never ought

19
doc/nasmdoc.src
View File

@ -1,6 +1,6 @@
\# -------------------------------------------------------------------------- \# --------------------------------------------------------------------------
\# \#
\# Copyright 1996-2016 The NASM Authors - All Rights Reserved \# Copyright 1996-2017 The NASM Authors - All Rights Reserved
\# See the file AUTHORS included with the NASM distribution for \# See the file AUTHORS included with the NASM distribution for
\# the specific copyright holders. \# the specific copyright holders.
\# \#
@ -36,7 +36,7 @@
\M{category}{Programming} \M{category}{Programming}
\M{title}{NASM - The Netwide Assembler} \M{title}{NASM - The Netwide Assembler}
\M{year}{1996-2016} \M{year}{1996-2017}
\M{author}{The NASM Development Team} \M{author}{The NASM Development Team}
\M{copyright_tail}{-- All Rights Reserved} \M{copyright_tail}{-- All Rights Reserved}
\M{license}{This document is redistributable under the license given in the file "LICENSE" distributed in the NASM archive.} \M{license}{This document is redistributable under the license given in the file "LICENSE" distributed in the NASM archive.}
@ -5758,6 +5758,21 @@ right-hand side of the \c{WRT} operator:
\b \c{..gotpcrel} is used to specify references to the Global Offset \b \c{..gotpcrel} is used to specify references to the Global Offset
Table. The GOT is supported in the \c{macho64} format only. Table. The GOT is supported in the \c{macho64} format only.
\S{macho-ssvs} \c{macho} specfic directive \i\c{subsections_via_symbols}
The directive \c{subsections_via_symbols} sets the
\c{MH_SUBSECTIONS_VIA_SYMBOLS} flag in the Mach-O header, which tells
the linker that the symbols in the file matches the conventions
required to allow for link-time dead code elimination.
This directive takes no arguments. Like most directives, it is
wrapped in a macro; it is therefore possible to support older versions
of NASM (without the dead code elimination support) simply by:
\c %ifnmacro subsections_via_symbols
\c %imacro subsections_via_symbols 0
\c %endmacro
\c %endif
\H{elffmt} \i\c{elf32}, \i\c{elf64}, \i\c{elfx32}: \I{ELF}\I{linux, elf}\i{Executable and Linkable \H{elffmt} \i\c{elf32}, \i\c{elf64}, \i\c{elfx32}: \I{ELF}\I{linux, elf}\i{Executable and Linkable
Format} Object Files Format} Object Files