diff options
Diffstat (limited to 'usr/src/man/man1/ld.1')
| -rw-r--r-- | usr/src/man/man1/ld.1 | 28 |
1 files changed, 17 insertions, 11 deletions
diff --git a/usr/src/man/man1/ld.1 b/usr/src/man/man1/ld.1 index 2d0893fdc4..9ff3680e82 100644 --- a/usr/src/man/man1/ld.1 +++ b/usr/src/man/man1/ld.1 @@ -9,7 +9,6 @@ .SH NAME ld \- link-editor for object files .SH SYNOPSIS -.LP .nf \fBld\fR [\fB-32\fR | \fB-64\fR] [\fB-a\fR | \fB-r\fR] [\fB-b\fR] [\fB-B\fRdirect | nodirect] [\fB-B\fR dynamic | static] [\fB-B\fR eliminate] [\fB-B\fR group] [\fB-B\fR local] @@ -40,7 +39,6 @@ ld \- link-editor for object files .fi .SH DESCRIPTION -.LP The link-editor, \fBld\fR, combines relocatable object files by resolving symbol references to symbol definitions, together with performing relocations. \fBld\fR operates in two modes, static or dynamic, as governed by the \fB-d\fR @@ -104,7 +102,6 @@ Similarly, only objects of a single machine type are allowed. See the \fB-32\fR, \fB-64\fR and \fB-z target\fR options, and the \fBLD_NOEXEC_64\fR environment variable. .SS "Static Executables" -.LP The creation of static executables has been discouraged for many releases. In fact, 64-bit system archive libraries have never been provided. Because a static executable is built against system archive libraries, the executable @@ -139,7 +136,6 @@ executables is no longer achievable without specialized system knowledge. However, the capability of \fBld\fR to process static linking options, and the processing of archive libraries, remains unchanged. .SH OPTIONS -.LP The following options are supported. .sp .ne 2 @@ -1036,8 +1032,8 @@ had been built using the \fB-B\fR \fBgroup\fR option. Give messages suggesting link-editor features that could improve the resulting dynamic object. .LP -Specific classes of suggestion can be silenced by specifying an optional comma separated -list of guidance identifiers. +Specific classes of suggestion can be silenced by specifying an optional comma +separated list of guidance identifiers. .LP The current classes of suggestion provided are: @@ -1120,6 +1116,19 @@ removed from the link-editor command line. Can be disabled with \fB-z guidance=nounused\fR. .RE + +.sp +.ne 2 +.na +Global data in shared libraries built with mapfiles have size assertions +.ad +.sp .6 +.RS 4n +Suggests that any global data in a library built with a mapfile asserts the +size of that global data for ABI stability purposes. + +Can be disabled with \fB-z guidance=noasserts\fR. +.RE .RE .sp @@ -1841,8 +1850,8 @@ that is in effect. See the \fB-S\fR option. .sp .LP Notice that environment variable-names that begin with the -characters '\fBLD_\fR' are reserved for possible future enhancements to \fBld\fR and -\fBld.so.1\fR(1). +characters '\fBLD_\fR' are reserved for possible future enhancements to +\fBld\fR and \fBld.so.1\fR(1). .SH FILES .ne 2 .na @@ -1893,7 +1902,6 @@ defining memory layouts, aligning bss, and defining non-executable stacks. .RE .SH ATTRIBUTES -.LP See \fBattributes\fR(5) for descriptions of the following attributes: .sp @@ -1908,7 +1916,6 @@ Interface Stability Committed .TE .SH SEE ALSO -.LP \fBas\fR(1), \fBcrle\fR(1), \fBgprof\fR(1), \fBld.so.1\fR(1), \fBldd\fR(1), \fBmcs\fR(1), \fBpvs\fR(1), \fBexec\fR(2), \fBstat\fR(2), \fBdlopen\fR(3C), \fBdldump\fR(3C), \fBelf\fR(3ELF), \fBar.h\fR(3HEAD), \fBa.out\fR(4), @@ -1917,7 +1924,6 @@ Interface Stability Committed .LP \fILinker and Libraries Guide\fR .SH NOTES -.LP Default options applied by \fBld\fR are maintained for historic reasons. In today's programming environment, where dynamic objects dominate, alternative defaults would often make more sense. However, historic defaults must be |