[thirdparty/cups.git] / doc / help / man-cupstestppd.html

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- SECTION: Man Pages -->
<head>
	<link rel="stylesheet" type="text/css" href="../cups-printable.css">
	<title>cupstestppd(1)</title>
</head>
<body>
<h1 class="title">cupstestppd(1)</h1>
<h2 class="title"><a name="NAME">Name</a></h2>
cupstestppd - test conformance of ppd files
<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
<b>cupstestppd
</b>[ -I
<i>category
</i>] [ -R
<i>rootdir
</i>] [ -W
<i>category
</i>] [ -q ] [-r] [ -v[v] ] filename.ppd[.gz] [ ... filenameN.ppd[.gz] ]
<br>
<b>cupstestppd
</b>[ -R
<i>rootdir
</i>] [ -W
<i>category
</i>] [ -q ] [-r] [ -v[v] ] -
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
<i>cupstestppd</i> tests the conformance of PPD files to the
Adobe PostScript Printer Description file format specification
version 4.3. It can also be used to list the supported options
and available fonts in a PPD file. The results of testing and
any other output are sent to the standard output.
<p>The first form of <i>cupstestppd</i> tests one or more PPD files
on the command-line. The second form tests the PPD file provided
on the standard input.
<h2 class="title"><a name="OPTIONS">Options</a></h2>
<i>cupstestppd</i> supports the following options:
<dl>
<dt>-I filename
</dt>
<dd></dd>
<dd>Ignores all PCFileName warnings.
</dd>
<dt>-I filters
</dt>
<dd></dd>
<dd>Ignores all filter errors.
</dd>
<dt>-I profiles
</dt>
<dd></dd>
<dd>Ignores all profile errors.
</dd>
<dt>-R rootdir
</dt>
<dd></dd>
<dd>Specifies an alternate root directory for the filter, pre-filter,
and other support file checks.
</dd>
<dt>-W constraints
</dt>
<dd></dd>
<dd>Report all UIConstraint errors as warnings.
</dd>
<dt>-W defaults
</dt>
<dd></dd>
<dd>Except for size-related options, report all default option errors as warnings.
</dd>
<dt>-W filters
</dt>
<dd></dd>
<dd>Report all filter errors as warnings.
</dd>
<dt>-W profiles
</dt>
<dd></dd>
<dd>Report all profile errors as warnings.
</dd>
<dt>-W sizes
</dt>
<dd></dd>
<dd>Report all media size errors as warnings.
</dd>
<dt>-W translations
</dt>
<dd></dd>
<dd>Report all translation errors as warnings.
</dd>
<dt>-W all
</dt>
<dd></dd>
<dd>Report all of the previous errors as warnings.
</dd>
<dt>-W none
</dt>
<dd></dd>
<dd>Report all of the previous errors as errors.
</dd>
<dt>-q
</dt>
<dd></dd>
<dd>Specifies that no information should be displayed.
</dd>
<dt>-r
</dt>
<dd></dd>
<dd>Relaxes the PPD conformance requirements so that common
whitespace, control character, and formatting problems are not
treated as hard errors.
</dd>
<dt>-v
</dt>
<dd></dd>
<dd>Specifies that detailed conformance testing results should be
displayed rather than the concise PASS/FAIL/ERROR status.
</dd>
<dt>-vv
</dt>
<dd></dd>
<dd>Specifies that all information in the PPD file should be
displayed in addition to the detailed conformance testing
results.
</dd>
</dl>
<p>The <i>-q</i>, <i>-v</i>, and <i>-vv</i> options are mutually exclusive.
<h2 class="title"><a name="EXIT_STATUS">Exit Status</a></h2>
<i>cupstestppd</i> returns zero on success and non-zero on error. The
error codes are as follows:
<dl>
<dt>1
</dt>
<dd></dd>
<dd>Bad command-line arguments or missing PPD filename.
</dd>
<dt>2
</dt>
<dd></dd>
<dd>Unable to open or read PPD file.
</dd>
<dt>3
</dt>
<dd></dd>
<dd>The PPD file contains format errors that cannot be skipped.
</dd>
<dt>4
</dt>
<dd></dd>
<dd>The PPD file does not conform to the Adobe PPD specification.
</dd>
</dl>
<h2 class="title"><a name="EXAMPLES">Examples</a></h2>
The following command will test all PPD files under the current
directory and print the names of each file that does not
conform:
<pre>

    find . -name \*.ppd \! -exec cupstestppd -q '{}' \; -print

</pre>
The next command tests all PPD files under the current directory
and print detailed conformance testing results for the files
that do not conform:
<pre>

    find . -name \*.ppd \! -exec cupstestppd -q '{}' \; \
        -exec cupstestppd -v '{}' \;

</pre>
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
<a href='man-lpadmin.html?TOPIC=Man+Pages'>lpadmin(8)</a>,
<br>
<a href='http://localhost:631/help'>http://localhost:631/help</a>
<br>
Adobe PostScript Printer Description File Format Specification, Version 4.3.
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
Copyright 2007-2013 by Apple Inc.

</body>
</html>
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>