3 <!-- SECTION: Man Pages -->
5 <link rel=
"stylesheet" type=
"text/css" href=
"../cups-printable.css">
6 <title>cupsfilter(
8)
</title>
9 <h1 class=
"title">cupsfilter(
8)
</h1>
10 <h2 class=
"title"><a name=
"NAME">Name
</a></h2>
11 cupsfilter - convert a file to another format using cups filters
12 <h2 class=
"title"><a name=
"SYNOPSIS">Synopsis
</a></h2>
54 <h2 class=
"title"><a name=
"DESCRIPTION">Description
</a></h2>
56 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,
58 generates a PDF file. The converted file is sent to the standard output.
59 <h2 class=
"title"><a name=
"OPTIONS">Options
</a></h2>
61 <dt><b>--list-filters
</b>
62 <dd style=
"margin-left: 5.0em">Do not actually run the filters, just print the filters used to stdout.
64 <dd style=
"margin-left: 5.0em">Delete the input file after conversion.
65 <dt><b>-U
</b><i>user
</i>
66 <dd style=
"margin-left: 5.0em">Specifies the username passed to the filters. The default is the name of the current user.
67 <dt><b>-c
</b><i>config-file
</i>
68 <dd style=
"margin-left: 5.0em">Uses the named cups-files.conf configuration file.
69 <dt><b>-d
</b><i>printer
</i>
70 <dd style=
"margin-left: 5.0em">Uses information from the named printer.
72 <dd style=
"margin-left: 5.0em">Use every filter from the PPD file.
73 <dt><b>-i
</b><i>mime/type
</i>
74 <dd style=
"margin-left: 5.0em">Specifies the source file type. The default file type is guessed using the filename and contents of the file.
75 <dt><b>-j
</b><i>job-id[,N]
</i>
76 <dd style=
"margin-left: 5.0em">Converts document N from the specified job. If N is omitted, document
1 is converted.
77 <dt><b>-m
</b><i>mime/type
</i>
78 <dd style=
"margin-left: 5.0em">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.
79 <dt><b>-n
</b><i>copies
</i>
80 <dd style=
"margin-left: 5.0em">Specifies the number of copies to generate.
81 <dt><b>-o
</b><i>name=value
</i>
82 <dd style=
"margin-left: 5.0em">Specifies options to pass to the CUPS filters.
83 <dt><b>-p
</b><i>filename.ppd
</i>
84 <dd style=
"margin-left: 5.0em">Specifies the PPD file to use.
85 <dt><b>-t
</b><i>title
</i>
86 <dd style=
"margin-left: 5.0em">Specifies the document title.
88 <dd style=
"margin-left: 5.0em">Delete the PPD file after conversion.
90 <h2 class=
"title"><a name=
"EXIT_STATUS">Exit Status
</a></h2>
92 returns a non-zero exit status on any error.
93 <h2 class=
"title"><a name=
"ENVIRONMENT">Environment
</a></h2>
95 <a href=
"man-cups.html?TOPIC=Man+Pages"><b>cups
</b>(
1)
</a>
96 environment variables affect the operation of
98 <h2 class=
"title"><a name=
"FILES">Files
</a></h2>
100 /etc/cups/cups-files.conf
103 /usr/share/cups/mime/*.convs
104 /usr/share/cups/mime/*.types
105 <h2 class=
"title"><a name=
"NOTES">Notes
</a></h2>
106 Unlike when printing, filters run using the
108 command use the current user and security session. This may result in different output or unexpected behavior.
109 <h2 class=
"title"><a name=
"EXAMPLE">Example
</a></h2>
110 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":
113 cupsfilter -m application/pdf -d myprinter -j
42 >preview.pdf
115 <h2 class=
"title"><a name=
"SEE_ALSO">See Also
</a></h2>
116 <a href=
"man-cups.html?TOPIC=Man+Pages"><b>cups
</b>(
1),
</a>
117 <a href=
"man-cupsd.conf.html?TOPIC=Man+Pages"><b>cupsd.conf
</b>(
5),
</a>
119 <a href=
"man-mime.convs.html?TOPIC=Man+Pages"><b>mime.convs
</b>(
7),
</a>
120 <a href=
"man-mime.types.html?TOPIC=Man+Pages"><b>mime.types
</b>(
7),
</a>
121 CUPS Online Help (
<a href=
"http://localhost:631/help">http://localhost:
631/help
</a>)
122 <h2 class=
"title"><a name=
"COPYRIGHT">Copyright
</a></h2>
123 Copyright
© 2007-
2014 by Apple Inc.