]>
Commit | Line | Data |
---|---|---|
94436c5a MS |
1 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> |
2 | <html> | |
3 | <!-- SECTION: Man Pages --> | |
4 | <head> | |
5 | <link rel="stylesheet" type="text/css" href="../cups-printable.css"> | |
6 | <title>cupstestppd(1)</title> | |
7 | </head> | |
8 | <body> | |
9 | <h1 class="title">cupstestppd(1)</h1> | |
10 | <h2 class="title"><a name="NAME">Name</a></h2> | |
11 | cupstestppd - test conformance of ppd files | |
12 | <h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2> | |
13 | <b>cupstestppd | |
14 | </b>[ -I | |
15 | <i>category | |
16 | </i>] [ -R | |
17 | <i>rootdir | |
18 | </i>] [ -W | |
19 | <i>category | |
20 | </i>] [ -q ] [-r] [ -v[v] ] filename.ppd[.gz] [ ... filenameN.ppd[.gz] ] | |
21 | <br> | |
22 | <b>cupstestppd | |
23 | </b>[ -R | |
24 | <i>rootdir | |
25 | </i>] [ -W | |
26 | <i>category | |
27 | </i>] [ -q ] [-r] [ -v[v] ] - | |
28 | <h2 class="title"><a name="DESCRIPTION">Description</a></h2> | |
29 | <i>cupstestppd</i> tests the conformance of PPD files to the | |
30 | Adobe PostScript Printer Description file format specification | |
31 | version 4.3. It can also be used to list the supported options | |
32 | and available fonts in a PPD file. The results of testing and | |
33 | any other output are sent to the standard output. | |
34 | <p>The first form of <i>cupstestppd</i> tests one or more PPD files | |
35 | on the command-line. The second form tests the PPD file provided | |
36 | on the standard input. | |
37 | <h2 class="title"><a name="OPTIONS">Options</a></h2> | |
38 | <i>cupstestppd</i> supports the following options: | |
39 | <dl> | |
40 | <dt>-I filename | |
41 | </dt> | |
42 | <dd></dd> | |
43 | <dd>Ignores all PCFileName warnings. | |
44 | </dd> | |
45 | <dt>-I filters | |
46 | </dt> | |
47 | <dd></dd> | |
48 | <dd>Ignores all filter errors. | |
49 | </dd> | |
50 | <dt>-I profiles | |
51 | </dt> | |
52 | <dd></dd> | |
53 | <dd>Ignores all profile errors. | |
54 | </dd> | |
55 | <dt>-R rootdir | |
56 | </dt> | |
57 | <dd></dd> | |
58 | <dd>Specifies an alternate root directory for the filter, pre-filter, | |
59 | and other support file checks. | |
60 | </dd> | |
61 | <dt>-W constraints | |
62 | </dt> | |
63 | <dd></dd> | |
64 | <dd>Report all UIConstraint errors as warnings. | |
65 | </dd> | |
66 | <dt>-W defaults | |
67 | </dt> | |
68 | <dd></dd> | |
69 | <dd>Except for size-related options, report all default option errors as warnings. | |
70 | </dd> | |
71 | <dt>-W filters | |
72 | </dt> | |
73 | <dd></dd> | |
74 | <dd>Report all filter errors as warnings. | |
75 | </dd> | |
76 | <dt>-W profiles | |
77 | </dt> | |
78 | <dd></dd> | |
79 | <dd>Report all profile errors as warnings. | |
80 | </dd> | |
81 | <dt>-W sizes | |
82 | </dt> | |
83 | <dd></dd> | |
84 | <dd>Report all media size errors as warnings. | |
85 | </dd> | |
86 | <dt>-W translations | |
87 | </dt> | |
88 | <dd></dd> | |
89 | <dd>Report all translation errors as warnings. | |
90 | </dd> | |
91 | <dt>-W all | |
92 | </dt> | |
93 | <dd></dd> | |
94 | <dd>Report all of the previous errors as warnings. | |
95 | </dd> | |
96 | <dt>-W none | |
97 | </dt> | |
98 | <dd></dd> | |
99 | <dd>Report all of the previous errors as errors. | |
100 | </dd> | |
101 | <dt>-q | |
102 | </dt> | |
103 | <dd></dd> | |
104 | <dd>Specifies that no information should be displayed. | |
105 | </dd> | |
106 | <dt>-r | |
107 | </dt> | |
108 | <dd></dd> | |
109 | <dd>Relaxes the PPD conformance requirements so that common | |
110 | whitespace, control character, and formatting problems are not | |
111 | treated as hard errors. | |
112 | </dd> | |
113 | <dt>-v | |
114 | </dt> | |
115 | <dd></dd> | |
116 | <dd>Specifies that detailed conformance testing results should be | |
117 | displayed rather than the concise PASS/FAIL/ERROR status. | |
118 | </dd> | |
119 | <dt>-vv | |
120 | </dt> | |
121 | <dd></dd> | |
122 | <dd>Specifies that all information in the PPD file should be | |
123 | displayed in addition to the detailed conformance testing | |
124 | results. | |
125 | </dd> | |
126 | </dl> | |
127 | <p>The <i>-q</i>, <i>-v</i>, and <i>-vv</i> options are mutually exclusive. | |
128 | <h2 class="title"><a name="EXIT_STATUS">Exit Status</a></h2> | |
129 | <i>cupstestppd</i> returns zero on success and non-zero on error. The | |
130 | error codes are as follows: | |
131 | <dl> | |
132 | <dt>1 | |
133 | </dt> | |
134 | <dd></dd> | |
135 | <dd>Bad command-line arguments or missing PPD filename. | |
136 | </dd> | |
137 | <dt>2 | |
138 | </dt> | |
139 | <dd></dd> | |
140 | <dd>Unable to open or read PPD file. | |
141 | </dd> | |
142 | <dt>3 | |
143 | </dt> | |
144 | <dd></dd> | |
145 | <dd>The PPD file contains format errors that cannot be skipped. | |
146 | </dd> | |
147 | <dt>4 | |
148 | </dt> | |
149 | <dd></dd> | |
150 | <dd>The PPD file does not conform to the Adobe PPD specification. | |
151 | </dd> | |
152 | </dl> | |
153 | <h2 class="title"><a name="EXAMPLES">Examples</a></h2> | |
154 | The following command will test all PPD files under the current | |
155 | directory and print the names of each file that does not | |
156 | conform: | |
157 | <pre> | |
158 | ||
159 | find . -name \*.ppd \! -exec cupstestppd -q '{}' \; -print | |
160 | ||
161 | </pre> | |
162 | The next command tests all PPD files under the current directory | |
163 | and print detailed conformance testing results for the files | |
164 | that do not conform: | |
165 | <pre> | |
166 | ||
167 | find . -name \*.ppd \! -exec cupstestppd -q '{}' \; \ | |
168 | -exec cupstestppd -v '{}' \; | |
169 | ||
170 | </pre> | |
171 | <h2 class="title"><a name="SEE_ALSO">See Also</a></h2> | |
172 | <a href='man-lpadmin.html?TOPIC=Man+Pages'>lpadmin(8)</a>, | |
173 | <br> | |
174 | <a href='http://localhost:631/help'>http://localhost:631/help</a> | |
175 | <br> | |
176 | Adobe PostScript Printer Description File Format Specification, Version 4.3. | |
177 | <h2 class="title"><a name="COPYRIGHT">Copyright</a></h2> | |
178 | Copyright 2007-2013 by Apple Inc. | |
179 | ||
180 | </body> | |
181 | </html> |