]> git.ipfire.org Git - thirdparty/cups.git/blob - man/cups-config.man
License change: Apache License, Version 2.0.
[thirdparty/cups.git] / man / cups-config.man
1 .\"
2 .\" cups-config man page for CUPS.
3 .\"
4 .\" Copyright 2007-2014 by Apple Inc.
5 .\" Copyright 1997-2006 by Easy Software Products.
6 .\"
7 .\" Licensed under Apache License v2.0. See the file "LICENSE" for more information.
8 .\"
9 .TH cups-config 1 "CUPS" "15 April 2014" "Apple Inc."
10 .SH NAME
11 cups\-config \- get cups api, compiler, directory, and link information.
12 .SH SYNOPSIS
13 .B cups\-config
14 .I \-\-api\-version
15 .br
16 .B cups\-config
17 .I \-\-build
18 .br
19 .B cups\-config
20 .I \-\-cflags
21 .br
22 .B cups\-config
23 .I \-\-datadir
24 .br
25 .B cups\-config
26 .I \-\-help
27 .br
28 .B cups\-config
29 .I \-\-ldflags
30 .br
31 .B cups\-config
32 [
33 .I \-\-image
34 ] [
35 .I \-\-static
36 ]
37 .I \-\-libs
38 .br
39 .B cups\-config
40 .I \-\-serverbin
41 .br
42 .B cups\-config
43 .I \-\-serverroot
44 .br
45 .B cups-config
46 .I \-\-version
47 .br
48 .SH DESCRIPTION
49 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.
50 All values are reported to the standard output.
51 .SH OPTIONS
52 The \fBcups-config\fR command accepts the following command-line options:
53 .TP 5
54 .B \-\-api-version
55 Reports the current API version (major.minor).
56 .TP 5
57 .B \-\-build
58 Reports a system-specific build number.
59 .TP 5
60 .B \-\-cflags
61 Reports the necessary compiler options.
62 .TP 5
63 .B \-\-datadir
64 Reports the default CUPS data directory.
65 .TP 5
66 .B \-\-help
67 Reports the program usage message.
68 .TP 5
69 .B \-\-image
70 When used with \fI\-\-libs\fR, adds the CUPS imaging library to the
71 list of libraries.
72 .TP 5
73 .B \-\-ldflags
74 Reports the necessary linker options.
75 .TP 5
76 .B \-\-libs
77 Reports the necessary libraries to link to.
78 .TP 5
79 .B \-\-serverbin
80 Reports the default CUPS binary directory, where filters and backends are stored.
81 .TP 5
82 .B \-\-serverroot
83 Reports the default CUPS configuration file directory.
84 .TP 5
85 .B \-\-static
86 When used with \fI\-\-libs\fR, reports the static libraries instead of the default (shared) libraries.
87 .TP 5
88 .B \-\-version
89 Reports the full version number of the CUPS installation (major.minor.patch).
90 .SH EXAMPLES
91 Show the currently installed version of CUPS:
92 .nf
93
94 cups-config \-\-version
95
96 .fi
97 Compile a simple one-file CUPS filter:
98 .nf
99
100 cc `cups\-config \-\-cflags \-\-ldflags` \-o filter filter.c \\
101 `cups\-config \-\-libs`
102 .fi
103 .SH SEE ALSO
104 .BR cups (1),
105 CUPS Online Help (http://localhost:631/help)
106 .SH COPYRIGHT
107 Copyright \[co] 2007-2017 by Apple Inc.