openpkg/rpm-config.pod@a6cd892638c1
openpkg/rpm-config.pod
Sat, 03 Oct 2009 16:18:52 +0200
- author
- Michael Schloh von Bennewitz <michael@schloh.com>
- date
- Sat, 03 Oct 2009 16:18:52 +0200
- changeset 220
- a6cd892638c1
- child 428
- f880f219c566
- permissions
- -rw-r--r--
Update version, adjust corresponding buildconf, and correct logic.
1: Make minor corrections and improvements to scripts patch logic.
2: Upgrade to most recent stable release version 3.0.2.
3: Force selection of a single db backend, as multiple ones never
were supported (changing 'with_db<end>' identifiers accordingly.)
4: Unfortunately add gawk requirement although only partly needed.
5: Add openssl::with_threads requirement to solve strange and hard
to debug problems on Solaris leading to connection failures:
'host-dir JobId 0: Error: openssl.c:86 Connect failure: ERR=error:1408F10B:SSL routines:SSL3_GET_RECORD:wrong version number'
and
'host-dir JobId 40: Fatal error: TLS negotiation failed with FD at "back1.host.com:9102"'
1 ##
2 ## rpm-config -- OpenPKG RPM Library Build Utility
3 ## Copyright (c) 2000-2007 OpenPKG Foundation e.V. <http://openpkg.net/>
4 ## Copyright (c) 2000-2007 Ralf S. Engelschall <http://engelschall.com/>
5 ##
6 ## Permission to use, copy, modify, and distribute this software for
7 ## any purpose with or without fee is hereby granted, provided that
8 ## the above copyright notice and this permission notice appear in all
9 ## copies.
10 ##
11 ## THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
12 ## WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
13 ## MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
14 ## IN NO EVENT SHALL THE AUTHORS AND COPYRIGHT HOLDERS AND THEIR
15 ## CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
16 ## SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
17 ## LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
18 ## USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
19 ## ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
20 ## OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
21 ## OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
22 ## SUCH DAMAGE.
23 ##
24 ## rpm-config.pod: manual page
25 ##
27 =pod
29 =head1 NAME
31 B<rpm-config> - OpenPKG RPM library build utility
33 =head1 VERSION
35 OpenPKG RPM RPM_VERSION
37 =head1 SYNOPSIS
39 B<rpm-config>
40 [B<--help>]
41 [B<--version>]
42 [B<--cc>]
43 [B<--cppflags>]
44 [B<--cflags>]
45 [B<--ldflags>]
46 [B<--libs>]
48 =head1 DESCRIPTION
50 The B<rpm-config> program is a little helper utility for easy
51 configuring and building applications based on the OpenPKG RPM library.
52 It can be used to query the C compiler and linker flags which are
53 required to correctly compile and link the application against the
54 RPM library.
56 =head1 OPTIONS
58 B<rpm-config> accepts the following options:
60 =over 4
62 =item B<--help>
64 Prints the short usage information.
66 =item B<--version>
68 Prints the version number and date of the installed RPM library.
70 =item B<--cc>
72 =item B<--cppflags>
74 Prints the C pre-processor flags (C<-I>) which are needed to compile the
75 RPM-based application. The output is usually added to the C<CPPFLAGS>
76 variable of the applications C<Makefile>.
78 =item B<--cflags>
80 Prints the C compiler flags which are needed to compile the RPM-based
81 application. The output is usually added to the C<CFLAGS> variable of the
82 applications C<Makefile>.
84 =item B<--ldflags>
86 Prints the linker flags (C<-L>) which are needed to link the application with
87 the RPM library. The output is usually added to the C<LDFLAGS> variable of
88 the applications C<Makefile>.
90 =item B<--libs>
92 Prints the library flags (C<-l>) which are needed to link the application with
93 the RPM library. The output is usually added to the C<LIBS> variable of the
94 applications C<Makefile>.
96 =back
98 =head1 EXAMPLE
100 CC = `rpm-config --cc`
101 CPPFLAGS = `rpm-config --cppflags`
102 CFLAGS = `rpm-config --cflags`
103 LDFLAGS = `rpm-config --ldflags`
104 LIBS = `rpm-config --libs`
106 all: foo
108 foo: foo.o
109 $(CC) $(LDFLAGS) -o foo foo.o $(LIBS)
111 foo.o: foo.c
112 $(CC) $(CPPFLAGS) $(CFLAGS) -o foo.o -c foo.c
114 =head1 SEE ALSO
116 rpm(1), cc(1).
118 =head1 AUTHOR
120 Ralf S. Engelschall
121 rse@engelschall.com
122 www.engelschall.com
124 =cut
