]> git.ipfire.org Git - thirdparty/cups.git/blame - doc/help/man-cupsfilter.html
Initial work on man page modernization (STR #4372)
[thirdparty/cups.git] / doc / help / man-cupsfilter.html
CommitLineData
c277f98c 1<!DOCTYPE HTML>
94436c5a
MS
2<html>
3<!-- SECTION: Man Pages -->
4<head>
5 <link rel="stylesheet" type="text/css" href="../cups-printable.css">
6 <title>cupsfilter(8)</title>
7</head>
8<body>
9<h1 class="title">cupsfilter(8)</h1>
10<h2 class="title"><a name="NAME">Name</a></h2>
11cupsfilter - convert a file to another format using cups filters
12<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
c277f98c
MS
13<b>cupsfilter</b>
14[ -D ] [ -U
15<i>user</i>
16] [ -c
17<i>config-file</i>
18] [ -d
19<i>printer</i>
20] [ -e ] [ -i
21<i>mime/type</i>
22] [ -j
23<i>job-id[,N]</i>
24] [ -m
25<i>mime/type</i>
26] [ -n
27<i>copies</i>
28] [ -o
29<i>name=value</i>
30] [ -p
31<i>filename.ppd</i>
32] [ -t
33<i>title</i>
34] [ -u ]
35<i>filename</i>
36<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
94436c5a
MS
37<i>cupsfilter</i> is a front-end to the CUPS filter subsystem which allows you
38to convert a file to a specific format, just as if you had printed the file
39through CUPS. By default, <i>cupsfilter</i> generates a PDF file.
40<h2 class="title"><a name="OPTIONS">Options</a></h2>
c277f98c
MS
41<p style="margin-left: 5.0em; text-indent: -5.0em">-D
42<br>
43<br>
44Delete the input file after conversion.
45<p style="margin-left: 5.0em; text-indent: -5.0em">-U user
46<br>
47<br>
48Specifies the username passed to the filters. The default is the name of the current user.
49<p style="margin-left: 5.0em; text-indent: -5.0em">-c config-file
50<br>
51<br>
52Uses the named cupsd.conf configuration file.
53<p style="margin-left: 5.0em; text-indent: -5.0em">-d printer
54<br>
55Uses information from the named printer.
56<p style="margin-left: 5.0em; text-indent: -5.0em">-e
57<br>
58<br>
59Use every filter from the PPD file.
60<p style="margin-left: 5.0em; text-indent: -5.0em">-i mime/type
61<br>
62<br>
63Specifies the source file type. The default file type is guessed using the
94436c5a 64filename and contents of the file.
c277f98c
MS
65<p style="margin-left: 5.0em; text-indent: -5.0em">-j job-id[,N]
66<br>
67<br>
68Converts document N from the specified job. If N is omitted, document 1 is
94436c5a 69converted.
c277f98c
MS
70<p style="margin-left: 5.0em; text-indent: -5.0em">-m mime/type
71<br>
72<br>
73Specifies the destination file type. The default file type is application/pdf.
94436c5a
MS
74Use printer/foo to convert to the printer format defined by the filters in the
75PPD file.
c277f98c
MS
76<p style="margin-left: 5.0em; text-indent: -5.0em">-n copies
77<br>
78<br>
79Specifies the number of copies to generate.
80<p style="margin-left: 5.0em; text-indent: -5.0em">-o name=value
81<br>
82<br>
83Specifies options to pass to the CUPS filters.
84<p style="margin-left: 5.0em; text-indent: -5.0em">-p filename.ppd
85<br>
86<br>
87Specifies the PPD file to use.
88<p style="margin-left: 5.0em; text-indent: -5.0em">-t title
89<br>
90<br>
91Specifies the document title.
92<p style="margin-left: 5.0em; text-indent: -5.0em">-u
93<br>
94<br>
95Delete the PPD file after conversion.
94436c5a 96<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
c277f98c 97<i>cupsd.conf(5)</i>
94436c5a 98<br>
c277f98c 99<a href="http://localhost:631/help">http://localhost:631/help</a>
94436c5a
MS
100<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
101Copyright 2007-2013 by Apple Inc.
102
103</body>
104</html>