libtool - Man Page
Provide generalized library-building support services
Examples (TL;DR)
- Compile a source file into a
libtool
object:libtool --mode=compile gcc -c path/to/source.c -o path/to/source.lo
- Create a library or an executable:
libtool --mode=link gcc -o path/to/library.lo path/to/source.lo
- Automatically set the library path so that another program can use uninstalled
libtool
generated programs or libraries:libtool --mode=execute gdb path/to/program
- Install a shared library:
libtool --mode=install cp path/to/library.la path/to/installation_directory
- Complete the installation of
libtool
libraries on the system:libtool --mode=finish path/to/installation_dir
- Delete installed libraries or executables:
libtool --mode=uninstall path/to/installed_library.la
- Delete uninstalled libraries or executables:
libtool --mode=clean rm path/to/source.lo path/to/library.la
Synopsis
libtool [OPTION]... [MODE-ARG]...
Description
Provide generalized library-building support services.
Options
- --config
show all configuration variables
- --debug
enable verbose shell tracing
- -n, --dry-run
display commands without modifying any files
- --features
display basic configuration information
- --finish
use operation '--mode=finish'
- --mode=MODE
use operation mode MODE
- --no-finish
don't update shared library cache
- --no-quiet, --no-silent
print default informational messages
- --no-warnings
equivalent to '-Wnone'
- --preserve-dup-deps
don't remove duplicate dependency libraries
- --quiet, --silent
don't print informational messages
- --reorder-cache=DIRS
reorder shared library cache for preferred DIRS
- --tag=TAG
use configuration variables from tag TAG
- -v, --verbose
print more informational messages than default
- --version
print version information
- -W, --warnings=CATEGORY
report the warnings falling in CATEGORY [all]
- -h, --help, --help-all
print short, long, or detailed help message
Warning categories include
- 'all'
show all warnings
- 'none'
turn off all the warnings
- 'error'
warnings are treated as fatal errors
MODE must be one of the following:
- clean
remove files from the build directory
- compile
compile a source file into a libtool object
- execute
automatically set library path, then run a program
- finish
complete the installation of libtool libraries
- install
install libraries or executables
- link
create a library or an executable
- uninstall
remove libraries from an installed directory
MODE-ARGS vary depending on the MODE. When passed as first option, '--mode=MODE' may be abbreviated as 'MODE' or a unique abbreviation of that.
GNU libtool home page: <https://www.gnu.org/software/libtool/>.
When reporting a bug, please describe a test case to reproduce it and include the following information:
- host-triplet:
x86_64-pc-linux-gnu
- shell:
/bin/bash
- compiler:
gcc
compiler flags: -g -O2 linker: /usr/bin/ld -m elf_x86_64 (gnu? yes) version: libtool (GNU libtool) 2.5.4 automake: automake (GNU automake) 1.17 autoconf: autoconf (GNU Autoconf) 2.72e
Reporting Bugs
Report bugs to <bug-libtool@gnu.org>.
Copyright
Copyright © 2024 Free Software Foundation, Inc. License GPLv2+: GNU GPL version 2 or later <https://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.
Originally written by Gordon Matzigkeit, 1996 (See AUTHORS for complete contributor listing)
See Also
The full documentation for libtool is maintained as a Texinfo manual. If the info and libtool programs are properly installed at your site, the command
info libtool
should give you access to the complete manual.
Referenced By
autoconf(1), autoheader(1), autom4te(1), autoreconf(1), autoscan(1), autoupdate(1), ifnames(1), krb5_pwcheck(3), root-config(1).