libtool: Install mode
1
1 4.4 Install mode
1 ================
1
1 In "install" mode, libtool interprets most of the elements of MODE-ARGS
1 as an installation command beginning with 'cp', or a BSD-compatible
1 'install' program.
1
1 The following components of MODE-ARGS are treated specially:
1
1 '-inst-prefix-dir INST-PREFIX-DIR'
1 When installing into a temporary staging area, rather than the
1 final 'prefix', this argument is used to reflect the temporary
1 path, in much the same way 'automake' uses 'DESTDIR'. For
1 instance, if 'prefix' is '/usr/local', but INST-PREFIX-DIR is
1 '/tmp', then the object will be installed under '/tmp/usr/local/'.
1 If the installed object is a libtool library, then the internal
1 fields of that library will reflect only 'prefix', not
1 INST-PREFIX-DIR:
1
1 # Directory that this library needs to be installed in:
1 libdir='/usr/local/lib'
1
1 not
1
1 # Directory that this library needs to be installed in:
1 libdir='/tmp/usr/local/lib'
1
1 'inst-prefix' is also used to ensure that if the installed object
1 must be relinked upon installation, that it is relinked against the
1 libraries in INST-PREFIX-DIR/'prefix', not 'prefix'.
1
1 In truth, this option is not really intended for use when calling
1 libtool directly; it is automatically used when 'libtool
1 --mode=install' calls 'libtool --mode=relink'. Libtool does this
1 by analyzing the destination path given in the original 'libtool
1 --mode=install' command and comparing it to the expected
1 installation path established during 'libtool --mode=link'.
1
1 Thus, end-users need change nothing, and 'automake'-style 'make
1 install DESTDIR=/tmp' will Just Work(tm) most of the time. For
1 systems where fast installation cannot be turned on, relinking may
1 be needed. In this case, a 'DESTDIR' install will fail.
1
1 Currently it is not generally possible to install into a temporary
1 staging area that contains needed third-party libraries that are
1 not yet visible at their final location.
1
1 The rest of the MODE-ARGS are interpreted as arguments to the 'cp' or
1 'install' command.
1
1 The command is run, and any necessary unprivileged post-installation
1 commands are also completed.
1