360 lines
9.5 KiB
Groff
360 lines
9.5 KiB
Groff
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.38.2.
|
|
.TH LIBTOOL "1" "June 2010" "libtool 2.2.10" "User Commands"
|
|
.SH NAME
|
|
libtool \- manual page for libtool 2.2.10
|
|
.SH SYNOPSIS
|
|
.B libtool
|
|
[\fIOPTION\fR]... [\fIMODE-ARG\fR]...
|
|
.br
|
|
.B libtool
|
|
[\fIOPTION\fR]... \fI--mode=compile COMPILE-COMMAND\fR... \fISOURCEFILE\fR
|
|
.br
|
|
.B libtool
|
|
[\fIOPTION\fR]... \fI--mode=link LINK-COMMAND\fR...
|
|
.br
|
|
.B libtool
|
|
[\fIOPTION\fR]... \fI--mode=execute COMMAND \fR[\fIARGS\fR]...
|
|
.br
|
|
.B libtool
|
|
[\fIOPTION\fR]... \fI--mode=install INSTALL-COMMAND\fR...
|
|
.br
|
|
.B libtool
|
|
[\fIOPTION\fR]... \fI--mode=finish \fR[\fILIBDIR\fR]...
|
|
.br
|
|
.B libtool
|
|
[\fIOPTION\fR]... \fI--mode=uninstall RM \fR[\fIRM-OPTION\fR]... \fIFILE\fR...
|
|
.br
|
|
.B libtool
|
|
[\fIOPTION\fR]... \fI--mode=clean RM \fR[\fIRM-OPTION\fR]... \fIFILE\fR...
|
|
.SH DESCRIPTION
|
|
Provide generalized library\-building support services.
|
|
.TP
|
|
\fB\-\-config\fR
|
|
show all configuration variables
|
|
.TP
|
|
\fB\-\-debug\fR
|
|
enable verbose shell tracing
|
|
.TP
|
|
\fB\-n\fR, \fB\-\-dry\-run\fR
|
|
display commands without modifying any files
|
|
.TP
|
|
\fB\-\-features\fR
|
|
display basic configuration information and exit
|
|
.TP
|
|
\fB\-\-mode\fR=\fIMODE\fR
|
|
use operation mode MODE
|
|
.TP
|
|
\fB\-\-preserve\-dup\-deps\fR
|
|
don't remove duplicate dependency libraries
|
|
.TP
|
|
\fB\-\-quiet\fR, \fB\-\-silent\fR
|
|
don't print informational messages
|
|
.TP
|
|
\fB\-\-no\-quiet\fR, \fB\-\-no\-silent\fR
|
|
print informational messages (default)
|
|
.TP
|
|
\fB\-\-tag\fR=\fITAG\fR
|
|
use configuration variables from tag TAG
|
|
.TP
|
|
\fB\-v\fR, \fB\-\-verbose\fR
|
|
print more informational messages than default
|
|
.TP
|
|
\fB\-\-no\-verbose\fR
|
|
don't print the extra informational messages
|
|
.TP
|
|
\fB\-\-version\fR
|
|
print version information
|
|
.TP
|
|
\fB\-h\fR, \fB\-\-help\fR, \fB\-\-help\-all\fR
|
|
print short, long, or detailed help message
|
|
.PP
|
|
MODE must be one of the following:
|
|
.TP
|
|
clean
|
|
remove files from the build directory
|
|
.TP
|
|
compile
|
|
compile a source file into a libtool object
|
|
.TP
|
|
execute
|
|
automatically set library path, then run a program
|
|
.TP
|
|
finish
|
|
complete the installation of libtool libraries
|
|
.TP
|
|
install
|
|
install libraries or executables
|
|
.TP
|
|
link
|
|
create a library or an executable
|
|
.TP
|
|
uninstall
|
|
remove libraries from an installed directory
|
|
.PP
|
|
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.
|
|
.PP
|
|
Description of compile mode:
|
|
.PP
|
|
Compile a source file into a libtool library object.
|
|
.PP
|
|
This mode accepts the following additional options:
|
|
.TP
|
|
\fB\-o\fR OUTPUT\-FILE
|
|
set the output file name to OUTPUT\-FILE
|
|
.TP
|
|
\fB\-no\-suppress\fR
|
|
do not suppress compiler output for multiple passes
|
|
.TP
|
|
\fB\-prefer\-pic\fR
|
|
try to build PIC objects only
|
|
.TP
|
|
\fB\-prefer\-non\-pic\fR
|
|
try to build non\-PIC objects only
|
|
.TP
|
|
\fB\-shared\fR
|
|
do not build a `.o' file suitable for static linking
|
|
.TP
|
|
\fB\-static\fR
|
|
only build a `.o' file suitable for static linking
|
|
.TP
|
|
\fB\-Wc\fR,FLAG
|
|
pass FLAG directly to the compiler
|
|
.PP
|
|
COMPILE\-COMMAND is a command to be used in creating a `standard' object file
|
|
from the given SOURCEFILE.
|
|
.PP
|
|
The output file name is determined by removing the directory component from
|
|
SOURCEFILE, then substituting the C source code suffix `.c' with the
|
|
library object suffix, `.lo'.
|
|
.PP
|
|
Description of link mode:
|
|
.PP
|
|
Link object files or libraries together to form another library, or to
|
|
create an executable program.
|
|
.PP
|
|
LINK\-COMMAND is a command using the C compiler that you would use to create
|
|
a program from several object files.
|
|
.PP
|
|
The following components of LINK\-COMMAND are treated specially:
|
|
.TP
|
|
\fB\-all\-static\fR
|
|
do not do any dynamic linking at all
|
|
.TP
|
|
\fB\-avoid\-version\fR
|
|
do not add a version suffix if possible
|
|
.TP
|
|
\fB\-bindir\fR BINDIR
|
|
specify path to binaries directory (for systems where
|
|
libraries must be found in the PATH setting at runtime)
|
|
.TP
|
|
\fB\-dlopen\fR FILE
|
|
`\-dlpreopen' FILE if it cannot be dlopened at runtime
|
|
.TP
|
|
\fB\-dlpreopen\fR FILE
|
|
link in FILE and add its symbols to lt_preloaded_symbols
|
|
.TP
|
|
\fB\-export\-dynamic\fR
|
|
allow symbols from OUTPUT\-FILE to be resolved with dlsym(3)
|
|
.TP
|
|
\fB\-export\-symbols\fR SYMFILE
|
|
try to export only the symbols listed in SYMFILE
|
|
.TP
|
|
\fB\-export\-symbols\-regex\fR REGEX
|
|
try to export only the symbols matching REGEX
|
|
.TP
|
|
\fB\-LLIBDIR\fR
|
|
search LIBDIR for required installed libraries
|
|
.TP
|
|
\fB\-lNAME\fR
|
|
OUTPUT\-FILE requires the installed library libNAME
|
|
.TP
|
|
\fB\-module\fR
|
|
build a library that can dlopened
|
|
.TP
|
|
\fB\-no\-fast\-install\fR
|
|
disable the fast\-install mode
|
|
.TP
|
|
\fB\-no\-install\fR
|
|
link a not\-installable executable
|
|
.TP
|
|
\fB\-no\-undefined\fR
|
|
declare that a library does not refer to external symbols
|
|
.TP
|
|
\fB\-o\fR OUTPUT\-FILE
|
|
create OUTPUT\-FILE from the specified objects
|
|
.TP
|
|
\fB\-objectlist\fR FILE
|
|
Use a list of object files found in FILE to specify objects
|
|
.TP
|
|
\fB\-precious\-files\-regex\fR REGEX
|
|
don't remove output files matching REGEX
|
|
.TP
|
|
\fB\-release\fR RELEASE
|
|
specify package release information
|
|
.TP
|
|
\fB\-rpath\fR LIBDIR
|
|
the created library will eventually be installed in LIBDIR
|
|
.TP
|
|
\fB\-R[\fR ]LIBDIR
|
|
add LIBDIR to the runtime path of programs and libraries
|
|
.TP
|
|
\fB\-shared\fR
|
|
only do dynamic linking of libtool libraries
|
|
.TP
|
|
\fB\-shrext\fR SUFFIX
|
|
override the standard shared library file extension
|
|
.TP
|
|
\fB\-static\fR
|
|
do not do any dynamic linking of uninstalled libtool libraries
|
|
.TP
|
|
\fB\-static\-libtool\-libs\fR
|
|
do not do any dynamic linking of libtool libraries
|
|
.TP
|
|
\fB\-version\-info\fR CURRENT[:REVISION[:AGE]]
|
|
specify library version info [each variable defaults to 0]
|
|
.TP
|
|
\fB\-weak\fR LIBNAME
|
|
declare that the target provides the LIBNAME interface
|
|
.HP
|
|
\fB\-Wc\fR,FLAG
|
|
.TP
|
|
\fB\-Xcompiler\fR FLAG
|
|
pass linker\-specific FLAG directly to the compiler
|
|
.HP
|
|
\fB\-Wl\fR,FLAG
|
|
.TP
|
|
\fB\-Xlinker\fR FLAG
|
|
pass linker\-specific FLAG directly to the linker
|
|
.TP
|
|
\fB\-XCClinker\fR FLAG
|
|
pass link\-specific FLAG to the compiler driver (CC)
|
|
.PP
|
|
All other options (arguments beginning with `\-') are ignored.
|
|
.PP
|
|
Every other argument is treated as a filename. Files ending in `.la' are
|
|
treated as uninstalled libtool libraries, other files are standard or library
|
|
object files.
|
|
.PP
|
|
If the OUTPUT\-FILE ends in `.la', then a libtool library is created,
|
|
only library objects (`.lo' files) may be specified, and `\-rpath' is
|
|
required, except when creating a convenience library.
|
|
.PP
|
|
If OUTPUT\-FILE ends in `.a' or `.lib', then a standard library is created
|
|
using `ar' and `ranlib', or on Windows using `lib'.
|
|
.PP
|
|
If OUTPUT\-FILE ends in `.lo' or `.o', then a reloadable object file
|
|
is created, otherwise an executable program is created.
|
|
.PP
|
|
Description of execute mode:
|
|
.PP
|
|
Automatically set library path, then run a program.
|
|
.PP
|
|
This mode accepts the following additional options:
|
|
.TP
|
|
\fB\-dlopen\fR FILE
|
|
add the directory containing FILE to the library path
|
|
.PP
|
|
This mode sets the library path environment variable according to `\-dlopen'
|
|
flags.
|
|
.PP
|
|
If any of the ARGS are libtool executable wrappers, then they are translated
|
|
into their corresponding uninstalled binary, and any of their required library
|
|
directories are added to the library path.
|
|
.PP
|
|
Then, COMMAND is executed, with ARGS as arguments.
|
|
.PP
|
|
Description of install mode:
|
|
.PP
|
|
Install executables or libraries.
|
|
.PP
|
|
INSTALL\-COMMAND is the installation command. The first component should be
|
|
either the `install' or `cp' program.
|
|
.PP
|
|
The following components of INSTALL\-COMMAND are treated specially:
|
|
.TP
|
|
\fB\-inst\-prefix\-dir\fR PREFIX\-DIR
|
|
Use PREFIX\-DIR as a staging area for installation
|
|
.PP
|
|
The rest of the components are interpreted as arguments to that command (only
|
|
BSD\-compatible install options are recognized).
|
|
.PP
|
|
Description of finish mode:
|
|
.PP
|
|
Complete the installation of libtool libraries.
|
|
.PP
|
|
Each LIBDIR is a directory that contains libtool libraries.
|
|
.PP
|
|
The commands that this mode executes may require superuser privileges. Use
|
|
the `\-\-dry\-run' option if you just want to see what would be executed.
|
|
.PP
|
|
Description of uninstall mode:
|
|
.PP
|
|
Remove libraries from an installation directory.
|
|
.PP
|
|
RM is the name of the program to use to delete files associated with each FILE
|
|
(typically `/bin/rm'). RM\-OPTIONS are options (such as `\-f') to be passed
|
|
to RM.
|
|
.PP
|
|
If FILE is a libtool library, all the files associated with it are deleted.
|
|
Otherwise, only FILE itself is deleted using RM.
|
|
.PP
|
|
Description of clean mode:
|
|
.PP
|
|
Remove files from the build directory.
|
|
.PP
|
|
RM is the name of the program to use to delete files associated with each FILE
|
|
(typically `/bin/rm'). RM\-OPTIONS are options (such as `\-f') to be passed
|
|
to RM.
|
|
.PP
|
|
If FILE is a libtool library, object or program, all the files associated
|
|
with it are deleted. Otherwise, only FILE itself is deleted using RM.
|
|
.PP
|
|
When reporting a bug, please describe a test case to reproduce it and
|
|
include the following information:
|
|
.TP
|
|
host\-triplet:
|
|
x86_64\-apple\-darwin10.3.0
|
|
.TP
|
|
shell:
|
|
/bin/sh
|
|
.TP
|
|
compiler:
|
|
gcc
|
|
.TP
|
|
compiler flags:
|
|
\fB\-g\fR \fB\-O2\fR
|
|
.TP
|
|
linker:
|
|
/usr/libexec/gcc/i686\-apple\-darwin10/4.2.1/ld (gnu? no)
|
|
.TP
|
|
libtool:
|
|
(GNU libtool) 2.2.10
|
|
.TP
|
|
automake:
|
|
automake (GNU automake) 1.11.1
|
|
.TP
|
|
autoconf:
|
|
autoconf (GNU Autoconf) 2.65
|
|
.SH AUTHOR
|
|
Written by Gordon Matzigkeit <gord@gnu.ai.mit.edu>, 1996
|
|
.SH "REPORTING BUGS"
|
|
Report bugs to <bug\-libtool@gnu.org>.
|
|
.SH COPYRIGHT
|
|
Copyright \(co 2010 Free Software Foundation, Inc.
|
|
.br
|
|
This is free software; see the source for copying conditions. There is NO
|
|
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
|
|
.SH "SEE ALSO"
|
|
The full documentation for
|
|
.B libtool
|
|
is maintained as a Texinfo manual. If the
|
|
.B info
|
|
and
|
|
.B libtool
|
|
programs are properly installed at your site, the command
|
|
.IP
|
|
.B info libtool
|
|
.PP
|
|
should give you access to the complete manual.
|