|
Packit |
2fc92b |
.\"
|
|
Packit |
2fc92b |
.\" cupstestppd man page for CUPS.
|
|
Packit |
2fc92b |
.\"
|
|
Packit |
2fc92b |
.\" Copyright 2007-2014 by Apple Inc.
|
|
Packit |
2fc92b |
.\" Copyright 1997-2006 by Easy Software Products.
|
|
Packit |
2fc92b |
.\"
|
|
Packit |
2fc92b |
.\" These coded instructions, statements, and computer programs are the
|
|
Packit |
2fc92b |
.\" property of Apple Inc. and are protected by Federal copyright
|
|
Packit |
2fc92b |
.\" law. Distribution and use rights are outlined in the file "LICENSE.txt"
|
|
Packit |
2fc92b |
.\" which should have been included with this file. If this file is
|
|
Packit |
2fc92b |
.\" file is missing or damaged, see the license at "http://www.cups.org/".
|
|
Packit |
2fc92b |
.\"
|
|
Packit |
2fc92b |
.TH cupstestppd 1 "CUPS" "11 June 2014" "Apple Inc."
|
|
Packit |
2fc92b |
.SH NAME
|
|
Packit |
2fc92b |
cupstestppd \- test conformance of ppd files
|
|
Packit |
2fc92b |
.SH SYNOPSIS
|
|
Packit |
2fc92b |
.B cupstestppd
|
|
Packit |
2fc92b |
[
|
|
Packit |
2fc92b |
.B \-I
|
|
Packit |
2fc92b |
.I category
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-R
|
|
Packit |
2fc92b |
.I rootdir
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-W
|
|
Packit |
2fc92b |
.I category
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-q
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-r
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
\fB\-v\fR[\fBv\fR]
|
|
Packit |
2fc92b |
]
|
|
Packit |
2fc92b |
.I filename.ppd[.gz]
|
|
Packit |
2fc92b |
[ ...
|
|
Packit |
2fc92b |
.I filename.ppd[.gz]
|
|
Packit |
2fc92b |
]
|
|
Packit |
2fc92b |
.br
|
|
Packit |
2fc92b |
.B cupstestppd
|
|
Packit |
2fc92b |
[
|
|
Packit |
2fc92b |
.B \-R
|
|
Packit |
2fc92b |
.I rootdir
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-W
|
|
Packit |
2fc92b |
.I category
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-q
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-r
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
\fB\-v\fR[\fBv\fR]
|
|
Packit |
2fc92b |
]
|
|
Packit |
2fc92b |
.B \-
|
|
Packit |
2fc92b |
.SH DESCRIPTION
|
|
Packit |
2fc92b |
\fBcupstestppd\fR tests the conformance of PPD files to the Adobe PostScript Printer Description file format specification version 4.3.
|
|
Packit |
2fc92b |
It can also be used to list the supported options and available fonts in a PPD file.
|
|
Packit |
2fc92b |
The results of testing and any other output are sent to the standard output.
|
|
Packit |
2fc92b |
.LP
|
|
Packit |
2fc92b |
The first form of \fBcupstestppd\fR tests one or more PPD files on the command-line.
|
|
Packit |
2fc92b |
The second form tests the PPD file provided on the standard input.
|
|
Packit |
2fc92b |
.SH OPTIONS
|
|
Packit |
2fc92b |
\fBcupstestppd\fR supports the following options:
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-I filename\fR
|
|
Packit |
2fc92b |
Ignores all PCFileName warnings.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-I filters\fR
|
|
Packit |
2fc92b |
Ignores all filter errors.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-I profiles\fR
|
|
Packit |
2fc92b |
Ignores all profile errors.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-R \fIrootdir\fR
|
|
Packit |
2fc92b |
Specifies an alternate root directory for the filter, pre-filter, and other support file checks.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-W constraints\fR
|
|
Packit |
2fc92b |
Report all UIConstraint errors as warnings.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-W defaults\fR
|
|
Packit |
2fc92b |
Except for size-related options, report all default option errors as warnings.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-W filters\fR
|
|
Packit |
2fc92b |
Report all filter errors as warnings.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-W profiles\fR
|
|
Packit |
2fc92b |
Report all profile errors as warnings.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-W sizes\fR
|
|
Packit |
2fc92b |
Report all media size errors as warnings.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-W translations\fR
|
|
Packit |
2fc92b |
Report all translation errors as warnings.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-W all\fR
|
|
Packit |
2fc92b |
Report all of the previous errors as warnings.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-W none\fR
|
|
Packit |
2fc92b |
Report all of the previous errors as errors.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
.B \-q
|
|
Packit |
2fc92b |
Specifies that no information should be displayed.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
.B \-r
|
|
Packit |
2fc92b |
Relaxes the PPD conformance requirements so that common whitespace, control character, and formatting problems are not treated as hard errors.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
.B \-v
|
|
Packit |
2fc92b |
Specifies that detailed conformance testing results should be displayed rather than the concise PASS/FAIL/ERROR status.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
.B \-vv
|
|
Packit |
2fc92b |
Specifies that all information in the PPD file should be displayed in addition to the detailed conformance testing results.
|
|
Packit |
2fc92b |
.LP
|
|
Packit |
2fc92b |
The \fI-q\fR, \fI-v\fR, and \fI-vv\fR options are mutually exclusive.
|
|
Packit |
2fc92b |
.SH EXIT STATUS
|
|
Packit |
2fc92b |
\fBcupstestppd\fR returns zero on success and non-zero on error.
|
|
Packit |
2fc92b |
The error codes are as follows:
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
1
|
|
Packit |
2fc92b |
Bad command-line arguments or missing PPD filename.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
2
|
|
Packit |
2fc92b |
Unable to open or read PPD file.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
3
|
|
Packit |
2fc92b |
The PPD file contains format errors that cannot be skipped.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
4
|
|
Packit |
2fc92b |
The PPD file does not conform to the Adobe PPD specification.
|
|
Packit |
2fc92b |
.SH EXAMPLES
|
|
Packit |
2fc92b |
The following command will test all PPD files under the current directory and print the names of each file that does not conform:
|
|
Packit |
2fc92b |
.nf
|
|
Packit |
2fc92b |
|
|
Packit |
2fc92b |
find . \-name \\*.ppd \\! \-exec cupstestppd \-q '{}' \\; \-print
|
|
Packit |
2fc92b |
|
|
Packit |
2fc92b |
.fi
|
|
Packit |
2fc92b |
The next command tests all PPD files under the current directory and print detailed conformance testing results for the files that do not conform:
|
|
Packit |
2fc92b |
.nf
|
|
Packit |
2fc92b |
|
|
Packit |
2fc92b |
find . \-name \\*.ppd \\! \-exec cupstestppd \-q '{}' \\; \\
|
|
Packit |
2fc92b |
\-exec cupstestppd \-v '{}' \\;
|
|
Packit |
2fc92b |
.fi
|
|
Packit |
2fc92b |
.SH SEE ALSO
|
|
Packit |
2fc92b |
.BR lpadmin (8),
|
|
Packit |
2fc92b |
CUPS Online Help (http://localhost:631/help),
|
|
Packit |
2fc92b |
Adobe PostScript Printer Description File Format Specification, Version 4.3.
|
|
Packit |
2fc92b |
.SH COPYRIGHT
|
|
Packit |
2fc92b |
Copyright \[co] 2007-2017 by Apple Inc.
|