home | help
LIBMAP.CONF(5)		       File Formats Manual		  LIBMAP.CONF(5)

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

DESCRIPTION
     The  libmap functionality of ld-elf.so.1(1) allows dynamic object dependen-
     cies 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 exe-
     cutable 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
     # /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
     /etc/libmap.conf  The libmap configuration file.

SEE ALSO
     ldd(1), rtld(1)

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

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

FreeBSD 5.2.1			  April 7, 2003 		  LIBMAP.CONF(5)

home | help