|
Packit |
2fc92b |
.\"
|
|
Packit |
2fc92b |
.\" cupsfilter man page for CUPS.
|
|
Packit |
2fc92b |
.\"
|
|
Packit |
2fc92b |
.\" Copyright 2007-2014 by Apple Inc.
|
|
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 cupsfilter 8 "CUPS" "11 June 2014" "Apple Inc."
|
|
Packit |
2fc92b |
.SH NAME
|
|
Packit |
2fc92b |
cupsfilter \- convert a file to another format using cups filters
|
|
Packit |
2fc92b |
.SH SYNOPSIS
|
|
Packit |
2fc92b |
.B cupsfilter
|
|
Packit |
2fc92b |
[
|
|
Packit |
2fc92b |
.B \-\-list\-filters
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-D
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-U
|
|
Packit |
2fc92b |
.I user
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-c
|
|
Packit |
2fc92b |
.I config-file
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-d
|
|
Packit |
2fc92b |
.I printer
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-e
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-i
|
|
Packit |
2fc92b |
.I mime/type
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-j
|
|
Packit |
2fc92b |
.I job-id[,N]
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-m
|
|
Packit |
2fc92b |
.I mime/type
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-n
|
|
Packit |
2fc92b |
.I copies
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-o
|
|
Packit |
2fc92b |
.I name=value
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-p
|
|
Packit |
2fc92b |
.I filename.ppd
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-t
|
|
Packit |
2fc92b |
.I title
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-u
|
|
Packit |
2fc92b |
]
|
|
Packit |
2fc92b |
.I filename
|
|
Packit |
2fc92b |
.SH DESCRIPTION
|
|
Packit |
2fc92b |
.B cupsfilter
|
|
Packit |
2fc92b |
is a front-end to the CUPS filter subsystem which allows you to convert a file to a specific format, just as if you had printed the file through CUPS. By default,
|
|
Packit |
2fc92b |
.B cupsfilter
|
|
Packit |
2fc92b |
generates a PDF file. The converted file is sent to the standard output.
|
|
Packit |
2fc92b |
.SH OPTIONS
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
.B \-\-list\-filters
|
|
Packit |
2fc92b |
Do not actually run the filters, just print the filters used to stdout.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
.B \-D
|
|
Packit |
2fc92b |
Delete the input file after conversion.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-U \fIuser\fR
|
|
Packit |
2fc92b |
Specifies the username passed to the filters. The default is the name of the current user.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-c \fIconfig-file\fR
|
|
Packit |
2fc92b |
Uses the named cups-files.conf configuration file.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-d \fIprinter\fR
|
|
Packit |
2fc92b |
Uses information from the named printer.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
.B \-e
|
|
Packit |
2fc92b |
Use every filter from the PPD file.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-i \fImime/type\fR
|
|
Packit |
2fc92b |
Specifies the source file type. The default file type is guessed using the filename and contents of the file.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-j \fIjob-id[,N]\fR
|
|
Packit |
2fc92b |
Converts document N from the specified job. If N is omitted, document 1 is converted.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-m \fImime/type\fR
|
|
Packit |
2fc92b |
Specifies the destination file type. The default file type is application/pdf. Use printer/foo to convert to the printer format defined by the filters in the PPD file.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-n \fIcopies\fR
|
|
Packit |
2fc92b |
Specifies the number of copies to generate.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-o \fIname=value\fR
|
|
Packit |
2fc92b |
Specifies options to pass to the CUPS filters.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-p \fIfilename.ppd\fR
|
|
Packit |
2fc92b |
Specifies the PPD file to use.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-t \fItitle\fR
|
|
Packit |
2fc92b |
Specifies the document title.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
.B \-u
|
|
Packit |
2fc92b |
Delete the PPD file after conversion.
|
|
Packit |
2fc92b |
.SH EXIT STATUS
|
|
Packit |
2fc92b |
.B cupsfilter
|
|
Packit |
2fc92b |
returns a non-zero exit status on any error.
|
|
Packit |
2fc92b |
.SH ENVIRONMENT
|
|
Packit |
2fc92b |
All of the standard
|
|
Packit |
2fc92b |
.BR cups (1)
|
|
Packit |
2fc92b |
environment variables affect the operation of
|
|
Packit |
2fc92b |
.BR cupsfilter .
|
|
Packit |
2fc92b |
.SH FILES
|
|
Packit |
2fc92b |
.nf
|
|
Packit |
2fc92b |
/etc/cups/cups-files.conf
|
|
Packit |
2fc92b |
/etc/cups/*.convs
|
|
Packit |
2fc92b |
/etc/cups/*.types
|
|
Packit |
2fc92b |
/usr/share/cups/mime/*.convs
|
|
Packit |
2fc92b |
/usr/share/cups/mime/*.types
|
|
Packit |
2fc92b |
.SH NOTES
|
|
Packit |
2fc92b |
Unlike when printing, filters run using the
|
|
Packit |
2fc92b |
.B cupsfilter
|
|
Packit |
2fc92b |
command use the current user and security session. This may result in different output or unexpected behavior.
|
|
Packit |
2fc92b |
.SH EXAMPLE
|
|
Packit |
2fc92b |
The following command will generate a PDF preview of job 42 for a printer named "myprinter" and save it to a file named "preview.pdf":
|
|
Packit |
2fc92b |
.nf
|
|
Packit |
2fc92b |
|
|
Packit |
2fc92b |
cupsfilter -m application/pdf -d myprinter -j 42 >preview.pdf
|
|
Packit |
2fc92b |
.fi
|
|
Packit |
2fc92b |
.SH SEE ALSO
|
|
Packit |
2fc92b |
.BR cups (1),
|
|
Packit |
2fc92b |
.BR cupsd.conf (5),
|
|
Packit |
2fc92b |
.BR filter(7),
|
|
Packit |
2fc92b |
.BR mime.convs (7),
|
|
Packit |
2fc92b |
.BR mime.types (7),
|
|
Packit |
2fc92b |
CUPS Online Help (http://localhost:631/help)
|
|
Packit |
2fc92b |
.SH COPYRIGHT
|
|
Packit |
2fc92b |
Copyright \[co] 2007-2017 by Apple Inc.
|