1.\" Copyright (c) 2003 Matthew N. Dodd <winter@jurai.net> 2.\" All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. 9.\" 2. Redistributions in binary form must reproduce the above copyright 10.\" notice, this list of conditions and the following disclaimer in the 11.\" documentation and/or other materials provided with the distribution. 12.\" 13.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 14.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 15.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 16.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 17.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 18.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 19.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 20.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 21.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 22.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 23.\" SUCH DAMAGE. 24.\" 25.\" $FreeBSD$ 26.\" 27.Dd January 31, 2004 28.Dt LIBMAP.CONF 5 29.Os 30.Sh NAME 31.Nm libmap.conf 32.Nd "configuration file for dynamic object dependency mapping" 33.Sh DESCRIPTION 34The 35.Nm libmap 36functionality of 37.Xr ld-elf.so.1 1 38allows dynamic object dependencies to be mapped to arbitrary 39names. 40.Pp 41The configuration file consists of two whitespace separated columns; the 42left hand side containing the mapping candidate and the right hand 43side containing the mapping. 44Dependencies are matched against candidates and replaced with the mappings. 45.Pp 46Constrained mappings may be specified by enclosing the name of the 47executable or library in brackets. 48All mappings following a constraint will only be evaluated for that constraint. 49Constraints can be one of three types: 50.Bl -tag -width indent 51.It Exact 52The constraint is matched literally so that only an executable with an 53identical fully qualified pathname will match the constraint. 54This means that the executable 55.Pa /usr/bin/foo 56will not match a constraint for 57.Pa /usr/bin/./foo 58and vice-versa. 59This is the default constraint type. 60.It Basename 61A constraint with no path is matched against the basename of the 62executable. 63.Pa foo 64will match 65.Pa /bin/foo , 66.Pa /usr/local/sbin/foo , 67or any other executable named 68.Pa foo , 69no matter what its path is. 70.It Directory 71A constraint with a trailing slash is prefix-matched against the full 72pathname of the executable. 73.Pa /usr/bin/ 74will match any executable with a path starting with /usr/bin. 75.El 76.Pp 77Note that the executable path matched against is the 78.Fa path 79parameter in an 80.Fn exec* 81function call. 82The Directory or Exact constraints can only match when the executable 83is called with a full pathname. 84Most programs executed from a shell are run without a full path, via 85.Fn exec*p , 86so the Basename constraint type is the most useful. 87.Pp 88WARNING! 89Constrained mappings must never appear first in the configuration file. 90While there is a way to specify the 91.Dq default 92constraint, its use is not recommended. 93.Pp 94The most common use at the date of writing is for allowing multiple 95.Tn POSIX 96threading libraries to be used on a system without relinking or 97changing symlinks. 98.Sh FILES 99.Bl -tag -width ".Pa /etc/libmap.conf" -compact 100.It Pa /etc/libmap.conf 101The libmap configuration file. 102.El 103.Sh EXAMPLES 104.Bd -literal 105# /etc/libmap.conf 106# 107# candidate mapping 108# 109libpthread.so.1 libpthread.so.1 # Everything uses 'libpthread' 110libpthread.so libpthread.so 111 112libc_r.so.5 libpthread.so.1 # Everything that uses 'libc_r' 113libc_r.so libpthread.so # now uses 'libpthread' 114 115[/tmp/mplayer] # Test version of mplayer uses libc_r 116libpthread.so.1 libc_r.so.5 117libpthread.so libc_r.so 118 119[mplayer] # All other mplayers use libpthread 120libpthread.so.1 libpthread.so.1 121libpthread.so libpthread.so 122 123[/usr/local/jdk1.4.1/] # All Java 1.4.1 programs use libthr 124 # This works because "javavms" executes 125 # programs with the full pathname 126libpthread.so.1 libthr.so.1 127libpthread.so libthr.so 128.Ed 129.Sh SEE ALSO 130.Xr ldd 1 , 131.Xr rtld 1 132.Sh HISTORY 133The 134.Nm 135manual page and 136.Nm libmap 137functionality first appeared in 138.Fx 5.1 . 139.Sh AUTHORS 140This manual page was written by 141.An Matthew N. Dodd Aq winter@jurai.net . 142