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(5) 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 other 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 libraries to add to the hints.

On elf(5) lines that do not begin with a ‘/' are parsed as hardware dependent per library directives:

<library> <sysctl> <variable>[,...]:<library>[,...] ...

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

FILES

/etc/ld.so.conf

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.

SEE ALSO

ld.aout_so(1), ld.elf_so(1), a.out(5), elf(5), ldconfig(8)

HISTORY

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

BUGS

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