diff options
Diffstat (limited to 'upstream/archlinux/man1/cupstestppd.1')
| -rw-r--r-- | upstream/archlinux/man1/cupstestppd.1 | 148 |
1 files changed, 148 insertions, 0 deletions
diff --git a/upstream/archlinux/man1/cupstestppd.1 b/upstream/archlinux/man1/cupstestppd.1 new file mode 100644 index 00000000..af8abead --- /dev/null +++ b/upstream/archlinux/man1/cupstestppd.1 @@ -0,0 +1,148 @@ +.\" +.\" 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. |