ldconfig.8 revision 1.2
1 1.1 pk .Dd October 3, 1993 2 1.1 pk .Dt LDCONFIG 8 3 1.1 pk .Os NetBSD 0.9 4 1.1 pk .Sh NAME 5 1.1 pk .Nm ldconfig 6 1.1 pk .Nd configure the shared library cache 7 1.1 pk .Sh SYNOPSIS 8 1.1 pk .Nm ldconfig 9 1.1 pk .Op Fl rsv 10 1.1 pk .Op Ar directory Ar ... 11 1.1 pk .Sh DESCRIPTION 12 1.1 pk .Nm 13 1.1 pk is used to prepare a set of 14 1.1 pk .Dq hints 15 1.1 pk for use by the run-time linker 16 1.1 pk .Xr ld.so 17 1.1 pk to facilitate quick lookup of shared libraries available in multiple 18 1.1 pk directories. It scans a set of built-in system directories and any 19 1.1 pk .Ar directories 20 1.1 pk specified on the command line (in the given order) looking for shared 21 1.1 pk libraries and stores the results in the file 22 1.1 pk .Xr /var/run/ld.so.hints 23 1.2 pk to forestall the overhead that would otherwise result from the 24 1.1 pk directory search operations 25 1.1 pk .Xr ld.so 26 1.1 pk would have to perform to load the required shared libraries. 27 1.1 pk .Pp 28 1.1 pk The shared libraries so found will be automatically available for loading 29 1.1 pk if needed by the program being prepared for execution. This obviates the need 30 1.1 pk for storing search paths within the executable. 31 1.1 pk .Pp 32 1.1 pk The 33 1.1 pk .Ev LD_LIBRARY_PATH 34 1.1 pk environment variable can be used to override the use of 35 1.1 pk directories (or the order thereof) from the cache or to specify additional 36 1.1 pk directories where shared libraries might be found. 37 1.1 pk .Ev LD_LIBRARY_PATH 38 1.1 pk is a 39 1.1 pk .Sq \: 40 1.1 pk separated list of directory paths which are searched by 41 1.1 pk .Xr ld.so 42 1.1 pk when it needs to load a shared library. It can be viewed as the run-time 43 1.1 pk equivalent of the 44 1.1 pk .Fl L 45 1.1 pk switch of 46 1.1 pk .Xr ld. 47 1.1 pk .Pp 48 1.1 pk .Nm Ldconfig 49 1.1 pk is typically run as part of the boot sequence. 50 1.1 pk .Pp 51 1.1 pk The following options recognized by 52 1.1 pk .Nm ldconfig: 53 1.1 pk .Bl -tag -width indent 54 1.1 pk .It Fl r 55 1.1 pk Lists the current contents of 56 1.1 pk .Xr ld.so.hints 57 1.1 pk on the standard output. The hints file will not be modified. 58 1.1 pk .It Fl s 59 1.2 pk Do not scan the built-in system directory 60 1.2 pk .Pq Dq /usr/lib 61 1.1 pk for shared libraries. 62 1.1 pk .It Fl v 63 1.1 pk Switch on verbose mode. 64 1.1 pk .Sh Security 65 1.1 pk Special care must be taken when loading shared libraries into the address 66 1.1 pk space of 67 1.1 pk .Ev set-user-Id 68 1.1 pk programs. Whenever such a program is run, 69 1.1 pk .Xr ld.so 70 1.1 pk will only load shared libraries from the 71 1.1 pk .Ev ld.so.hints 72 1.1 pk file. In particular, the 73 1.1 pk .Ev LD_LIBRARY_PATH 74 1.1 pk is not used to search for libraries. Thus, the role of ldconfig is dual. In 75 1.1 pk addition to building a set of hints for quick lookup, it also serves to 76 1.1 pk specify the trusted collection of directories from which shared objects can 77 1.1 pk be safely loaded. It is presumed that the set of directories specified to 78 1.1 pk .Nm ldconfig 79 1.1 pk are under control of the system's administrator. 80 1.1 pk .Xr ld.so 81 1.1 pk further assists set-user-Id programs by erasing the 82 1.1 pk .Ev LD_LIBRARY_PATH 83 1.1 pk from the environment. 84 1.1 pk 85 1.1 pk .Sh FILES 86 1.1 pk .Xr /var/run/ld.so.hints 87 1.1 pk .Sh SEE ALSO 88 1.1 pk .Xr ld 1 , 89 1.1 pk .Xr link 5 90 1.1 pk .Sh HISTORY 91 1.1 pk A 92 1.1 pk .Nm 93 1.1 pk utility first appeared in SunOS 4.0, it appeared in its current form 94 1.1 pk in NetBSD 0.9a. 95
Indexes created Fri Oct 31 11:10:07 GMT 2025