mirror of https://gitee.com/openkylin/cups.git
149 lines
3.8 KiB
Groff
149 lines
3.8 KiB
Groff
.\"
|
||
.\" cupstestppd man page for CUPS.
|
||
.\"
|
||
.\" Copyright © 2021-2023 by OpenPrinting.
|
||
.\" Copyright © 2007-2019 by Apple Inc.
|
||
.\" Copyright © 1997-2006 by Easy Software Products.
|
||
.\"
|
||
.\" Licensed under Apache License v2.0. See the file "LICENSE" for more
|
||
.\" information.
|
||
.\"
|
||
.TH cupstestppd 1 "CUPS" "2021-02-28" "OpenPrinting"
|
||
.SH NAME
|
||
cupstestppd \- test conformance of ppd files (deprecated)
|
||
.SH SYNOPSIS
|
||
.B cupstestppd
|
||
[
|
||
.B \-I
|
||
.I category
|
||
] [
|
||
.B \-R
|
||
.I rootdir
|
||
] [
|
||
.B \-W
|
||
.I category
|
||
] [
|
||
.B \-q
|
||
] [
|
||
.B \-r
|
||
] [
|
||
\fB\-v\fR[\fBv\fR]
|
||
]
|
||
.I filename.ppd[.gz]
|
||
[ ...
|
||
.I filename.ppd[.gz]
|
||
]
|
||
.br
|
||
.B cupstestppd
|
||
[
|
||
.B \-R
|
||
.I rootdir
|
||
] [
|
||
.B \-W
|
||
.I category
|
||
] [
|
||
.B \-q
|
||
] [
|
||
.B \-r
|
||
] [
|
||
\fB\-v\fR[\fBv\fR]
|
||
]
|
||
.B \-
|
||
.SH DESCRIPTION
|
||
\fBcupstestppd\fR 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.
|
||
.LP
|
||
The first form of \fBcupstestppd\fR tests one or more PPD files on the command-line.
|
||
The second form tests the PPD file provided on the standard input.
|
||
.SH OPTIONS
|
||
\fBcupstestppd\fR supports the following options:
|
||
.TP 5
|
||
\fB\-I filename\fR
|
||
Ignores all PCFileName warnings.
|
||
.TP 5
|
||
\fB\-I filters\fR
|
||
Ignores all filter errors.
|
||
.TP 5
|
||
\fB\-I profiles\fR
|
||
Ignores all profile errors.
|
||
.TP 5
|
||
\fB\-R \fIrootdir\fR
|
||
Specifies an alternate root directory for the filter, pre-filter, and other support file checks.
|
||
.TP 5
|
||
\fB\-W constraints\fR
|
||
Report all UIConstraint errors as warnings.
|
||
.TP 5
|
||
\fB\-W defaults\fR
|
||
Except for size-related options, report all default option errors as warnings.
|
||
.TP 5
|
||
\fB\-W filters\fR
|
||
Report all filter errors as warnings.
|
||
.TP 5
|
||
\fB\-W profiles\fR
|
||
Report all profile errors as warnings.
|
||
.TP 5
|
||
\fB\-W sizes\fR
|
||
Report all media size errors as warnings.
|
||
.TP 5
|
||
\fB\-W translations\fR
|
||
Report all translation errors as warnings.
|
||
.TP 5
|
||
\fB\-W all\fR
|
||
Report all of the previous errors as warnings.
|
||
.TP 5
|
||
\fB\-W none\fR
|
||
Report all of the previous errors as errors.
|
||
.TP 5
|
||
.B \-q
|
||
Specifies that no information should be displayed.
|
||
.TP 5
|
||
.B \-r
|
||
Relaxes the PPD conformance requirements so that common whitespace, control character, and formatting problems are not treated as hard errors.
|
||
.TP 5
|
||
.B \-v
|
||
Specifies that detailed conformance testing results should be displayed rather than the concise PASS/FAIL/ERROR status.
|
||
.TP 5
|
||
.B \-vv
|
||
Specifies that all information in the PPD file should be displayed in addition to the detailed conformance testing results.
|
||
.LP
|
||
The \fI-q\fR, \fI-v\fR, and \fI-vv\fR options are mutually exclusive.
|
||
.SH EXIT STATUS
|
||
\fBcupstestppd\fR returns zero on success and non-zero on error.
|
||
The error codes are as follows:
|
||
.TP 5
|
||
1
|
||
Bad command-line arguments or missing PPD filename.
|
||
.TP 5
|
||
2
|
||
Unable to open or read PPD file.
|
||
.TP 5
|
||
3
|
||
The PPD file contains format errors that cannot be skipped.
|
||
.TP 5
|
||
4
|
||
The PPD file does not conform to the Adobe PPD specification.
|
||
.SH EXAMPLES
|
||
The following command will test all PPD files under the current directory and print the names of each file that does not conform:
|
||
.nf
|
||
|
||
find . \-name \\*.ppd \\! \-exec cupstestppd \-q '{}' \\; \-print
|
||
|
||
.fi
|
||
The next command tests all PPD files under the current directory and print detailed conformance testing results for the files that do not conform:
|
||
.nf
|
||
|
||
find . \-name \\*.ppd \\! \-exec cupstestppd \-q '{}' \\; \\
|
||
\-exec cupstestppd \-v '{}' \\;
|
||
.fi
|
||
.SH NOTES
|
||
PPD files are deprecated and will no longer be supported in a future feature release of CUPS.
|
||
Printers that do not support IPP can be supported using applications such as
|
||
.BR ippeveprinter (1).
|
||
.SH SEE ALSO
|
||
.BR lpadmin (8),
|
||
CUPS Online Help (http://localhost:631/help),
|
||
Adobe PostScript Printer Description File Format Specification, Version 4.3.
|
||
.SH COPYRIGHT
|
||
Copyright \[co] 2021-2023 by OpenPrinting.
|