CRUX-ARM : Home

Home :: Documentation :: Download :: Development :: Community :: Ports :: Packages :: Bugs :: Links :: About :: Donors
Imported core-cross ports from 2.5
[crossrootfs.git] / libtool / libtool.1
CommitLineData
6dca1d21
JB
1.TH LIBTOOL 1 "August 2003" "Library Support" "User Manuals"
2.SH NAME
3libtool \- Provide generalized library-building support services.
4.SH SYNOPSIS
5.B libtool
6.BI [ OPTION ] ...
7.BI [ MODE\-ARG ] ...
8.SH "DESCRIPTION"
9The `libtool' program provides a standard way to generate both static
10and shared libraries. It hides the complexities of platform\-specific
11library generation behind an interface that is the same across all
12platforms supported by libtool.
13.SH "OPTIONS"
14libtool accepts the following options:
15.TP
16.B \-\-config
17Display libtool configuration variables and exit.
18.TP
19.B \-\-debug
20Dump a trace of shell script execution to standard output. This
21produces a lot of output, so you may wish to pipe it to `less' (or
22`more') or redirect to a file.
23.TP
24.BI \-n | \-\-dry-run
25Don't create, modify, or delete any files, just show what commands
26would be executed by `libtool'.
27.TP
28.B \-\-features
29Display basic configuration options. This provides a way for packages
30to determine whether shared or static libraries will be built.
31.TP
32.B \-\-finish
33Same as
34.BR \-\-mode=finish .
35.TP
36.B \-\-help
37Display a help message and exit. If
38.BI \-\-mode= MODE
39is specified, then detailed help for
40.I MODE
41is displayed.
42.TP
43.BI \-\-mode= MODE
44Use
45.I MODE
46as the operation mode. By default, the operation mode is inferred
47from the
48.IR MODE\-ARGS .
49
50If
51.I MODE
52is specified, it must be one of the following:
53.IP
54.B clean
55Remove files from the build directory
56.IP
57.B compile
58Compile a source file into a `libtool' object.
59.IP
60.B execute
61Automatically set the library path, then run a program.
62.IP
63.B finish
64Complete the installation of libtool libraries.
65.IP
66.B install
67Install libraries or executables.
68.IP
69.B link
70Create a library or an executable.
71.IP
72.B uninstall
73Remove libraries from an installed directory.
74.TP
75.B \-\-quiet
76Same as `\-\-silent'.
77.TP
78.B \-\-silent
79Don't print informational messages.
80.TP
81.B \-\-tag=TAG
82Use configuration variables from tag
83.I TAG
84.TP
85.B \-\-version
86Print version information.
87.P
88The
89.I MODE\-ARGS
90are a variable number of arguments, depending on the selected
91operation mode. In general, each
92.I MODE\-ARG
93is interpreted by programs libtool invokes, rather than libtool itself.
94.SH "SEE ALSO"
95.BR libtoolize (1),
96.BR automake (1)
97.br
98`libtool', `libtoolize' and `automake' are fully documented via the
99Info system.
100.SH AUTHOR
101This manual page was created by Ossama Othman <ossama@debian.org>. It
102is based on the "Invoking Libtool" menu entry in the `libtool' TEXINFO
103documentation, and the output from the
104.B \-\-help
105option. It was updated for Libtool 1.5 by
106Scott James Remnant <scott@netsplit.com>.