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

FreeBSD Man Pages

Man Page or Keyword Search:
Man Architecture
Apropos Keyword Search (all sections) Output format
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
     #
     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	9.3			 April 7, 2003			   FreeBSD 9.3

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

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

home | help