ld.so.conf(5) - NetBSD Manual Pages

LD.SO.CONF(5)             NetBSD Programmer's Manual             LD.SO.CONF(5)


NAME

     ld.so.conf - run-time link-editor configuration file


DESCRIPTION

     The ld.so.conf file specifies additional default directories (beyond the
     standard set, normally ``/usr/lib'' ).

     On a.out(5) systems, this file is scanned by ldconfig(8) to create the
     hints files used by the run-time linker /usr/libexec/ld.so to locate
     shared libraries.

     On elf systems, this file is scanned directly by the run-time linker
     /usr/libexec/ld.elf_so.

     Lines beginning with ``#'' are treated as comments and ignored.  Any oth-
     er non-blank lines beginning with '/' are stripped of leading whitespace
     and trailing comments (introduced with ``#'') together with any preceding
     whitespace, then treated as directories to be scanned for shared li-
     braries to add to the hints.

     On elf lines that do not begin with a '/' are parsed as hardware depen-
     dent per library directives:

     <library_name> <sysctl_variable> <variable_value>[,...]:<library_name>[,...] ...

     If there is no match, the standard action is taken.


EXAMPLES

     libm.so.0 machdep.fpu_present 1:libm387.so.0,libm.so.0

     The above line loads both libm387 and libm when the sysctl(3) variable
     fpu_present has the value 1.


FILES

     /etc/ld.so.conf


SEE ALSO

     a.out(5) ldconfig(8)


BUGS

     Directory names containing the comment character (``#'') and/or leading
     or trailing whitespace cannot be included.  (Embedded blanks are allowed,
     however.)


HISTORY

     The ld.so.conf file appeared in NetBSD 1.3.  The ELF support for it was
     added in NetBSD 1.5.

NetBSD 1.5.3                    August 24, 1997                              1