NAME    [Toc]    [Back]

     libmap.conf -- configuration file for dynamic object dependency mapping

DESCRIPTION    [Toc]    [Back]

     The libmap functionality of ld-elf.so.1(1) allows dynamic object dependencies
 to be mapped to arbitrary names.

     The configuration file consists of two whitespace separated columns; the
     left hand side containing the mapping candidate and the right hand side
     containing the mapping.  Dependencies are matched against candidates and
     replaced with the mappings.

     Constrained mappings may be specified by enclosing the name of the executable
 or library in brackets.  All mappings following a constraint will
     only be evaluated for that constraint.  Currently, constraints are
     matched literally so that an executable with a fully qualified pathname
     will only match the same constraint.  This means that /usr/bin/foo will
     not match a constraint for foo and vise-versa.

     WARNING!  Constrained mappings must never appear first in the configuration
 file.  While there is a way to specify the ``default'' constraint,
     its use is not recommended.

     The most common use at the date of writing is for allowing multiple POSIX
     threading libraries to be used on a system without relinking or changing
     symlinks.

EXAMPLE    [Toc]    [Back]

     # /etc/libmap.conf
     #
     # candidate	     mapping
     #
     libc_r.so.5	     libthr.so.1     # Everything uses 'libthr'
     libc_r.so		     libthr.so

     [/usr/local/bin/mplayer]		     # 'mplayer' uses libc_r.
     libc_r.so.5	     libc_r.so.5
     libc_r.so		     libc_r.so

     [mplayer]
     libc_r.so.5	     libc_r.so.5
     libc_r.so		     libc_r.so

     [/usr/local/sbin/httpd]		     # Apache uses libkse
     libc_r.so.5	     libkse.so.1
     libc_r.so		     libkse.so

     [httpd]
     libc_r.so.5	     libkse.so.1
     libc_r.so		     libkse.so

FILES    [Toc]    [Back]

     /etc/libmap.conf  The libmap configuration file.

SEE ALSO    [Toc]    [Back]

     ldd(1), rtld(1)

HISTORY    [Toc]    [Back]

     The libmap.conf manual page and libmap functionality first appeared in
     FreeBSD 5.1.

AUTHORS    [Toc]    [Back]

     This manual page was written by Matthew N. Dodd <winter@jurai.net>.


FreeBSD 5.2.1			 April 7, 2003			 FreeBSD 5.2.1