| libmap.conf.5 (130103) | libmap.conf.5 (130582) |
|---|---|
| 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. --- 8 unchanged lines hidden (view full) --- 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.\" | 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. --- 8 unchanged lines hidden (view full) --- 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: head/share/man/man5/libmap.conf.5 130103 2004-06-05 02:47:08Z ceri $ | 25.\" $FreeBSD: head/share/man/man5/libmap.conf.5 130582 2004-06-16 08:33:57Z ru $ |
| 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 --- 9 unchanged lines hidden (view full) --- 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 | 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 --- 9 unchanged lines hidden (view full) --- 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 | 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 | 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 | 64will match |
| 65.Pa /bin/foo , 66.Pa /usr/local/sbin/foo , | 65.Pa /bin/foo , 66.Pa /usr/local/sbin/foo , |
| 67or any other executable named | 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 | 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.Pa path 79parameter in an | 77Note that the executable path matched against is the 78.Fa path 79parameter in an |
| 80.Fn exec* | 80.Fn exec* |
| 81function call. | 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 , | 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. | 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. | 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 EXAMPLE | 98.Sh EXAMPLES |
| 99.Bd -literal 100# /etc/libmap.conf 101# 102# candidate mapping 103# 104libpthread.so.1 libpthread.so.1 # Everything uses 'libpthread' 105libpthread.so libpthread.so 106 --- 35 unchanged lines hidden --- | 99.Bd -literal 100# /etc/libmap.conf 101# 102# candidate mapping 103# 104libpthread.so.1 libpthread.so.1 # Everything uses 'libpthread' 105libpthread.so libpthread.so 106 --- 35 unchanged lines hidden --- |