4 Invoking libtool
The libtool program has the following synopsis:
libtool [option]... [mode-arg]...
and accepts the following options:
- --config
- Display libtool configuration variables and exit.
- --debug
- Dump a trace of shell script execution to standard output. This
produces a lot of output, so you may wish to pipe it to less (or
more) or redirect to a file.
- -n
- --dry-run
- Don't create, modify, or delete any files, just show what commands would
be executed by libtool.
- --features
- Display basic configuration options. This provides a way for packages
to determine whether shared or static libraries will be built.
- --finish
- Same as --mode=finish.
- --help
- Display a help message and exit. If --mode=mode is
specified, then detailed help for mode is
displayed.
- --mode=mode
- Use mode as the operation mode. When using libtool from the
command line, you can give just mode (or a unique abbreviation
of it) as the first argument as a shorthand for the full
--mode=mode.
mode must be set to one of the following:
- compile
- Compile a source file into a libtool object.
- execute
- Automatically set the library path so that another program can use
uninstalled libtool-generated programs or libraries.
- finish
- Complete the installation of libtool libraries on the system.
- install
- Install libraries or executables.
- link
- Create a library or an executable.
- uninstall
- Delete installed libraries or executables.
- clean
- Delete uninstalled libraries or executables.
- --tag=tag
- Use configuration variables from tag tag (see Tags).
- --preserve-dup-deps
- Do not remove duplicate dependencies in libraries. When building packages
with static libraries, the libraries may depend circularly on each other
(shared libs can too, but for those it doesn't matter), so there are
situations, where -la -lb -la is required, and the second -la may not be
stripped or the link will fail. In cases where these duplications are
required, this option will preserve them, only stripping the libraries
that libtool knows it can safely.
- --quiet
- --silent
- Do not print out any progress or informational messages.
- -v
- --verbose
- Print out progress and informational messages (enabled by default).
- --version
- Print libtool version information and exit.
The mode-args are a variable number of arguments, depending on the
selected operation mode. In general, each mode-arg is interpreted
by programs libtool invokes, rather than libtool itself.