Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
LIBMAP.CONF(5)            FreeBSD 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 depen-
     dencies 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 configura-
     tion 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
     #
     libpthread.so.1         libpthread.so.1 # Everything uses 'libpthread'
     libpthread.so           libpthread.so

     libc_r.so.5             libpthread.so.1 # Everything that uses 'libc_r'
     libc_r.so               libpthread.so   # now uses 'libpthread'

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

     [mplayer]
     libpthread.so.1         libc_r.so.5
     libpthread.so           libc_r.so

     [/usr/local/sbin/httpd]                 # Apache uses libthr
     libpthread.so.1         libthr.so.1
     libpthread.so           libthr.so

     [httpd]
     libpthread.so.1         libthr.so.1
     libpthread.so           libthr.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 4.10                   January 31, 2004                   FreeBSD 4.10

NAME | DESCRIPTION | EXAMPLE | FILES | SEE ALSO | HISTORY | AUTHORS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=libmap.conf&sektion=5&manpath=FreeBSD+4.10-RELEASE>

home | help