diff options
Diffstat (limited to 'ld/ld.texinfo')
| -rw-r--r-- | ld/ld.texinfo | 16 |
1 files changed, 16 insertions, 0 deletions
diff --git a/ld/ld.texinfo b/ld/ld.texinfo index 8a7a08f981e..bddf926b3c7 100644 --- a/ld/ld.texinfo +++ b/ld/ld.texinfo @@ -973,6 +973,22 @@ modules from standard libraries. @samp{-u} may be repeated with different option arguments to enter additional undefined symbols. This option is equivalent to the @code{EXTERN} linker script command. +If this option is being used to force additional modules to be pulled +into the link, and if it is an error for the symbol to remain +undefined, then the option @option{--require-defined} should be used +instead. + +@kindex --require-defined=@var{symbol} +@cindex symbols, require defined +@cindex defined symbol +@item --require-defined=@var{symbol} +Require that @var{symbol} is defined in the output file. This option +is the same as option @option{--undefined} except that if @var{symbol} +is not defined in the output file then the linker will issue an error +and exit. The same effect can be achieved in a linker script by using +@code{EXTERN}, @code{ASSERT} and @code{DEFINED} together. This option +can be used multiple times to require additional symbols. + @kindex -Ur @cindex constructors @item -Ur |