]> git.ipfire.org Git - thirdparty/cups.git/blob - man/cups-config.man
Allow more paths in sandbox.
[thirdparty/cups.git] / man / cups-config.man
1 .\"
2 .\" "$Id$"
3 .\"
4 .\" cups-config man page for CUPS.
5 .\"
6 .\" Copyright 2007-2014 by Apple Inc.
7 .\" Copyright 1997-2006 by Easy Software Products.
8 .\"
9 .\" These coded instructions, statements, and computer programs are the
10 .\" property of Apple Inc. and are protected by Federal copyright
11 .\" law. Distribution and use rights are outlined in the file "LICENSE.txt"
12 .\" which should have been included with this file. If this file is
13 .\" file is missing or damaged, see the license at "http://www.cups.org/".
14 .\"
15 .TH cups-config 1 "CUPS" "15 April 2014" "Apple Inc."
16 .SH NAME
17 cups\-config \- get cups api, compiler, directory, and link information.
18 .SH SYNOPSIS
19 .B cups\-config
20 .I \-\-api\-version
21 .br
22 .B cups\-config
23 .I \-\-build
24 .br
25 .B cups\-config
26 .I \-\-cflags
27 .br
28 .B cups\-config
29 .I \-\-datadir
30 .br
31 .B cups\-config
32 .I \-\-help
33 .br
34 .B cups\-config
35 .I \-\-ldflags
36 .br
37 .B cups\-config
38 [
39 .I \-\-image
40 ] [
41 .I \-\-static
42 ]
43 .I \-\-libs
44 .br
45 .B cups\-config
46 .I \-\-serverbin
47 .br
48 .B cups\-config
49 .I \-\-serverroot
50 .br
51 .B cups-config
52 .I \-\-version
53 .br
54 .SH DESCRIPTION
55 The \fBcups-config\fR command allows application developers to determine the necessary command-line options for the compiler and linker, as well as the installation directories for filters, configuration files, and drivers.
56 All values are reported to the standard output.
57 .SH OPTIONS
58 The \fBcups-config\fR command accepts the following command-line options:
59 .TP 5
60 .B \-\-api-version
61 Reports the current API version (major.minor).
62 .TP 5
63 .B \-\-build
64 Reports a system-specific build number.
65 .TP 5
66 .B \-\-cflags
67 Reports the necessary compiler options.
68 .TP 5
69 .B \-\-datadir
70 Reports the default CUPS data directory.
71 .TP 5
72 .B \-\-help
73 Reports the program usage message.
74 .TP 5
75 .B \-\-image
76 When used with \fI\-\-libs\fR, adds the CUPS imaging library to the
77 list of libraries.
78 .TP 5
79 .B \-\-ldflags
80 Reports the necessary linker options.
81 .TP 5
82 .B \-\-libs
83 Reports the necessary libraries to link to.
84 .TP 5
85 .B \-\-serverbin
86 Reports the default CUPS binary directory, where filters and backends are stored.
87 .TP 5
88 .B \-\-serverroot
89 Reports the default CUPS configuration file directory.
90 .TP 5
91 .B \-\-static
92 When used with \fI\-\-libs\fR, reports the static libraries instead of the default (shared) libraries.
93 .TP 5
94 .B \-\-version
95 Reports the full version number of the CUPS installation (major.minor.patch).
96 .SH EXAMPLES
97 Show the currently installed version of CUPS:
98 .nf
99
100 cups-config \-\-version
101
102 .fi
103 Compile a simple one-file CUPS filter:
104 .nf
105
106 cc `cups\-config \-\-cflags \-\-ldflags` \-o filter filter.c \\
107 `cups\-config \-\-libs`
108 .fi
109 .SH SEE ALSO
110 .BR cups (1),
111 CUPS Online Help (http://localhost:631/help)
112 .SH COPYRIGHT
113 Copyright \[co] 2007-2014 by Apple Inc.
114 .\"
115 .\" End of "$Id$".
116 .\"