www.delorie.com/gnu/docs/libtool/libtool_15.html

search

	Buy GNU books!

Libtool

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.

`--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.

`--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. By default, the operation mode is inferred from the mode-args.

If mode is specified, it must be 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.

`--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.

4.1 Compile mode		Creating library object files.
4.2 Link mode		Generating executables and libraries.
4.3 Execute mode		Debugging libtool-generated programs.
4.4 Install mode		Making libraries and executables public.
4.5 Finish mode		Completing a library installation.
4.6 Uninstall mode		Removing installed executables and libraries.
4.7 Clean mode		Removing uninstalled executables and libraries.