| Part 4 |
|
Part 4
|
LINK Command Reference
|
|
Command 1
|
LINK
|
|
|
Qualifier Descriptions
|
|
|
/ALPHA (Alpha and VAX)
|
|
|
/BASE_ADDRESS (I64 Only)
|
|
|
/BPAGE
|
|
|
/BRIEF
|
|
|
/CONTIGUOUS
|
|
|
/CROSS_REFERENCE
|
|
|
/DEBUG
|
|
|
/DEMAND_ZERO (I64 and Alpha)
|
|
|
/DNI (Display Name Information, I64 Only)
|
|
|
/DSF (Debug Symbol File, I64 and Alpha Only)
|
|
|
/EXECUTABLE
|
|
|
/FP_MODE (I64 Only)
|
|
|
/FULL
|
|
|
/GST (I64 and Alpha)
|
|
|
/HEADER (Alpha and VAX)
|
|
|
/INCLUDE
|
|
|
/INFORMATIONALS
|
|
|
/LIBRARY
|
|
|
/MAP
|
|
|
/NATIVE_ONLY (I64 and Alpha)
|
|
|
/OPTIONS
|
|
|
/P0IMAGE
|
|
|
/PROTECT
|
|
|
/REPLACE (Alpha Only)
|
|
|
/SECTION_BINDING (Alpha Only)
|
|
|
/SEGMENT_ATTRIBUTE (I64 Only)
|
|
|
/SELECTIVE_SEARCH
|
|
|
/SHAREABLE
|
|
|
/SYMBOL_TABLE
|
|
|
/SYSEXE (I64 and Alpha)
|
|
|
/SYSLIB
|
|
|
/SYSSHR
|
|
|
/SYSTEM (Alpha and VAX)
|
|
|
/THREADS_ENABLE
|
|
|
/TRACE
|
|
|
/USERLIBRARY
|
|
|
/VAX (Alpha and VAX)
|
|
|
Option Descriptions
|
|
|
BASE= (VAX Only)
|
|
|
CASE_SENSITIVE=
|
|
|
CLUSTER=
|
|
|
COLLECT=
|
|
|
DZRO_MIN= (Alpha and VAX)
|
|
|
GSMATCH=
|
|
|
IDENTIFICATION=
|
|
|
IOSEGMENT=
|
|
|
ISD_MAX= (Alpha and VAX)
|
|
|
NAME=
|
|
|
PROTECT=
|
|
|
PSECT_ATTRIBUTE=
|
|
|
RMS_RELATED_CONTEXT=
|
|
|
STACK=
|
|
|
SYMBOL=
|
|
|
SYMBOL_TABLE= (I64 and Alpha)
|
|
|
SYMBOL_VECTOR= (I64 and Alpha)
|
|
|
UNIVERSAL= (VAX Only)
|
| Glossary |
|
Glossary
|
Glossary
|
| Index |
Index |
| Examples |
| 1-1 |
Hello World! Program (HELLO.C) |
| 1-2 |
Sample Linker Options File |
| 2-1 |
Source File Containing a Symbolic Reference: MY_MAIN.C |
| 2-2 |
Source File Containing a Symbol Definition: MY_MATH.C |
| 2-3 |
UNIX-Style Weak and Group Symbols |
| 2-4 |
Compile and Link Commands |
| 3-1 |
Sample Program MYTEST.C |
| 3-2 |
Sample Program MYADD.C |
| 3-3 |
Sample Program MYSUB.C |
| 3-4 |
Sections Generated by an Analysis of Example 3-1 |
| 3-5 |
Linking Examples 3-1, 3-2, and 3-3 |
| 3-6 |
Segment Information in a Map File |
| 3-7 |
Section Information in a Map File |
| 3-8 |
Image Segment Descriptions in an ANALYZE/IMAGE Display |
| 3-9 |
Image and Program Section Synopsis of Second Link |
| 3-10 |
Compatible Initializations |
| 3-11 |
Linker Map Showing Program Section Synopsis |
| 3-12 |
Incompatible Initialization |
| 4-1 |
Shareable Image Test Module: my_main.c |
| 4-2 |
Shareable Image: my_math.c |
| 5-1 |
Object and Image Synopsis |
| 5-2 |
Cluster Synopsis |
| 5-3 |
Image Segment Synopsis |
| 5-4 |
Symbol Cross-Reference |
| 5-5 |
Symbols by Value |
| 5-6 |
Image Synopsis |
| 5-7 |
Link Run Statistics |
| 5-8 |
Shortened Symbol and Module Names |
| 5-9 |
Cross Reference Footnotes |
| 5-10 |
Mangled/Demangled Symbols |
| 6-1 |
Module Containing a Symbolic Reference: my_main.c |
| 6-2 |
Module Containing a Symbol Definition: my_math.c |
| 7-1 |
Sample Program MYTEST.C |
| 7-2 |
Sample Program MYADD.C |
| 7-3 |
Sample Program MYSUB.C |
| 7-4 |
Program Sections Generated by Example 3-1 |
| 7-5 |
Linking Examples 3-1, 3-2, and 3-3 |
| 7-6 |
Image Section Information in a Map File |
| 7-7 |
Program Section Information in a Map File (VAX Example) |
| 7-8 |
Image Section Descriptions in an ANALYZE/IMAGE Display |
| 7-9 |
Image Section Synopsis of Second Link |
| 8-1 |
Shareable Image Test Module: my_main.c |
| 8-2 |
Shareable Image: my_math.c |
| 8-3 |
Transfer Vector for the Shareable Image MY_MATH.EXE |
| Figures |
| 1-1 |
Position of the Linker in Program Development |
| 2-1 |
Symbol Vector Contents |
| 2-2 |
Symbol Resolution |
| 2-3 |
Clusters Created for Sample Link |
| 2-4 |
Linker Processing of Default Libraries and SYS$BASE_IMAGE.EXE |
| 3-1 |
Communication of Image Memory Requirements on I64 Systems |
| 3-2 |
Sections Created for Examples 3-1, 3-2, and 3-3 |
| 3-3 |
Official Function Descriptor |
| 3-4 |
Local Function Descriptor - Two Quadwords |
| 3-5 |
Combining Sections into Image Segments |
| 3-6 |
Combining Sections into Image Segments (continued) |
| 4-1 |
Accessing Universal Symbols Specified Using the SYMBOL_VECTOR = Option |
| 5-1 |
Program Section Synopsis |
| 6-1 |
Symbol Vector Contents |
| 6-2 |
Symbol Resolution |
| 6-3 |
Clusters Created for Sample Link |
| 6-4 |
Linker Processing of Default Libraries and SYS$BASE_IMAGE.EXE |
| 7-1 |
Communication of Image Memory Requirements on Alpha/VAX |
| 7-2 |
Program Sections Created for Examples 3-1, 3-2, and 3-3 |
| 7-3 |
Combining Program Sections into Image Sections |
| 8-1 |
Comparison of UNIVERSAL = Option and Transfer Vectors |
| 8-2 |
Accessing Universal Symbols Specified Using the SYMBOL_VECTOR = Option |
| Tables |
| 1-1 |
Input Files Accepted by the Linker |
| 1-2 |
Output Files Generated by the Linker |
| 1-3 |
Linker Qualifiers |
| 1-4 |
Linker Options |
| 1-5 |
Logical Names for Cross-Architecture Linking |
| 2-1 |
Linker Input File Processing |
| 2-2 |
Linker Input File Cluster Processing |
| 2-3 |
Symbol Definition Handling |
| 3-1 |
Mapping ELF Section Terms to OpenVMS Attributes |
| 3-2 |
Section Attributes on I64 |
| 3-3 |
Mapping OpenVMS Image Attribute Terms to ELF Terms |
| 3-4 |
Mapping Section Attributes to Segment Attributes for Executable Images |
| 3-5 |
Mapping Section Attributes to Segment Attributes for Shareable Images |
| 3-6 |
Significant Attributes of User Sections from Module MYSUB |
| 3-7 |
Segment Attributes |
| 3-8 |
Linker Flags |
| 3-9 |
Flag Settings Determined by /TRACEBACK, /DEBUG, and /DSF |
| 3-10 |
Location of Global Symbols Determined by /TRACEBACK, /DEBUG, and /DSF |
| 4-1 |
Linker Qualifiers and Options Used to Create Shareable Images on I64 |
| 5-1 |
LINK Command Map File Qualifiers |
| 5-2 |
I64 Image Map Sections |
| 6-1 |
Linker Input File Processing |
| 6-2 |
Linker Input File Cluster Processing |
| 7-1 |
Program Section Attributes (Alpha/VAX) |
| 7-2 |
Mapping Program Section Attributes to Image Section Attributes for Executable Images |
| 7-3 |
Mapping Program Section Attributes to Image Section Attributes for Shareable Images |
| 7-4 |
Significant Attributes of Program Sections in MYSUB_CLUS Cluster |
| 7-5 |
Image Section Attributes |
| 8-1 |
Linker Qualifiers and Options Used to Create Shareable Images |
| 9-1 |
LINK Command Map File Qualifiers |
| 9-2 |
Image Map Sections |
| 9-3 |
Symbol Characterization Codes (Alpha/VAX) |
| LINKER-1 |
Effects of /DEBUG, /DSF and /TRACE when Running an Image on I64 and Alpha |