956 .na
 957 \fB\fB--fatal-warnings\fR | \fB--no-fatal-warnings\fR
 958 .ad
 959 .sp .6
 960 .RS 4n
 961 Controls the behavior of warnings emitted from the link-editor. Setting \fB-z
 962 fatal-warnings\fR promotes warnings emitted by the link-editor to fatal errors
 963 that will cause the link-editor to fail before linking. \fB-z
 964 nofatal-warnings\fR instead demotes these warnings such that they will not cause
 965 the link-editor to exit prematurely.
 966 .RE
 967 
 968 
 969 .sp
 970 .ne 2
 971 .na
 972 \fB\fB-z\fR \fBfiniarray=\fR\fIfunction\fR\fR
 973 .ad
 974 .sp .6
 975 .RS 4n
 976 Appends an entry to the \fB\&.finiarray\fR section of the object being built.
 977 If no \fB\&.finiarray\fR section is present, a section is created. The new
 978 entry is initialized to point to \fIfunction\fR. See \fIInitialization and
 979 Termination Sections\fR in \fILinker and Libraries Guide\fR.
 980 .RE
 981 
 982 .sp
 983 .ne 2
 984 .na
 985 \fB\fB-z\fR \fBglobalaudit\fR\fR
 986 .ad
 987 .sp .6
 988 .RS 4n
 989 This option supplements an audit library definition that has been recorded with
 990 the \fB-P\fR option. This option is only meaningful when building a dynamic
 991 executable. Audit libraries that are defined within an object with the \fB-P\fR
 992 option typically allow for the auditing of the immediate dependencies of the
 993 object. The \fB-z\fR \fBglobalaudit\fR promotes the auditor to a global
 994 auditor, thus allowing the auditing of all dependencies. See \fIInvoking the
 995 Auditing Interface\fR in \fILinker and Libraries Guide\fR.
 996 .sp
 997 An auditor established with the \fB-P\fR option and the \fB-z\fR

1130 .RS 4n
1131 Ignores, or records, dynamic dependencies that are not referenced as part of
1132 the link-edit. Ignores, or records, unreferenced \fBELF\fR sections from the
1133 relocatable objects that are read as part of the link-edit. By default,
1134 \fB-z\fR \fBrecord\fR is in effect.
1135 .sp
1136 If an \fBELF\fR section is ignored, the section is eliminated from the output
1137 file being generated. A section is ignored when three conditions are true. The
1138 eliminated section must contribute to an allocatable segment. The eliminated
1139 section must provide no global symbols. No other section from any object that
1140 contributes to the link-edit, must reference an eliminated section.
1141 .RE
1142 
1143 .sp
1144 .ne 2
1145 .na
1146 \fB\fB-z\fR \fBinitarray=\fR\fIfunction\fR\fR
1147 .ad
1148 .sp .6
1149 .RS 4n
1150 Appends an entry to the \fB\&.initarray\fR section of the object being built.
1151 If no \fB\&.initarray\fR section is present, a section is created. The new
1152 entry is initialized to point to \fIfunction\fR. See \fIInitialization and
1153 Termination Sections\fR in \fILinker and Libraries Guide\fR.
1154 .RE
1155 
1156 .sp
1157 .ne 2
1158 .na
1159 \fB\fB-z\fR \fBinitfirst\fR\fR
1160 .ad
1161 .sp .6
1162 .RS 4n
1163 Marks the object so that its runtime initialization occurs before the runtime
1164 initialization of any other objects brought into the process at the same time.
1165 In addition, the object runtime finalization occurs after the runtime
1166 finalization of any other objects removed from the process at the same time.
1167 This option is only meaningful when building a shared object.
1168 .RE
1169 
1170 .sp
1171 .ne 2

 956 .na
 957 \fB\fB--fatal-warnings\fR | \fB--no-fatal-warnings\fR
 958 .ad
 959 .sp .6
 960 .RS 4n
 961 Controls the behavior of warnings emitted from the link-editor. Setting \fB-z
 962 fatal-warnings\fR promotes warnings emitted by the link-editor to fatal errors
 963 that will cause the link-editor to fail before linking. \fB-z
 964 nofatal-warnings\fR instead demotes these warnings such that they will not cause
 965 the link-editor to exit prematurely.
 966 .RE
 967 
 968 
 969 .sp
 970 .ne 2
 971 .na
 972 \fB\fB-z\fR \fBfiniarray=\fR\fIfunction\fR\fR
 973 .ad
 974 .sp .6
 975 .RS 4n
 976 Appends an entry to the \fB\&.fini_array\fR section of the object being built.
 977 If no \fB\&.fini_array\fR section is present, a section is created. The new
 978 entry is initialized to point to \fIfunction\fR. See \fIInitialization and
 979 Termination Sections\fR in \fILinker and Libraries Guide\fR.
 980 .RE
 981 
 982 .sp
 983 .ne 2
 984 .na
 985 \fB\fB-z\fR \fBglobalaudit\fR\fR
 986 .ad
 987 .sp .6
 988 .RS 4n
 989 This option supplements an audit library definition that has been recorded with
 990 the \fB-P\fR option. This option is only meaningful when building a dynamic
 991 executable. Audit libraries that are defined within an object with the \fB-P\fR
 992 option typically allow for the auditing of the immediate dependencies of the
 993 object. The \fB-z\fR \fBglobalaudit\fR promotes the auditor to a global
 994 auditor, thus allowing the auditing of all dependencies. See \fIInvoking the
 995 Auditing Interface\fR in \fILinker and Libraries Guide\fR.
 996 .sp
 997 An auditor established with the \fB-P\fR option and the \fB-z\fR

1130 .RS 4n
1131 Ignores, or records, dynamic dependencies that are not referenced as part of
1132 the link-edit. Ignores, or records, unreferenced \fBELF\fR sections from the
1133 relocatable objects that are read as part of the link-edit. By default,
1134 \fB-z\fR \fBrecord\fR is in effect.
1135 .sp
1136 If an \fBELF\fR section is ignored, the section is eliminated from the output
1137 file being generated. A section is ignored when three conditions are true. The
1138 eliminated section must contribute to an allocatable segment. The eliminated
1139 section must provide no global symbols. No other section from any object that
1140 contributes to the link-edit, must reference an eliminated section.
1141 .RE
1142 
1143 .sp
1144 .ne 2
1145 .na
1146 \fB\fB-z\fR \fBinitarray=\fR\fIfunction\fR\fR
1147 .ad
1148 .sp .6
1149 .RS 4n
1150 Appends an entry to the \fB\&.init_array\fR section of the object being built.
1151 If no \fB\&.init_array\fR section is present, a section is created. The new
1152 entry is initialized to point to \fIfunction\fR. See \fIInitialization and
1153 Termination Sections\fR in \fILinker and Libraries Guide\fR.
1154 .RE
1155 
1156 .sp
1157 .ne 2
1158 .na
1159 \fB\fB-z\fR \fBinitfirst\fR\fR
1160 .ad
1161 .sp .6
1162 .RS 4n
1163 Marks the object so that its runtime initialization occurs before the runtime
1164 initialization of any other objects brought into the process at the same time.
1165 In addition, the object runtime finalization occurs after the runtime
1166 finalization of any other objects removed from the process at the same time.
1167 This option is only meaningful when building a shared object.
1168 .RE
1169 
1170 .sp
1171 .ne 2