summaryrefslogtreecommitdiff
path: root/doc/help/man-cupsfilter.html
blob: 5ff9c340495d80b7356ecc0e66c73f9e0927b13d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- SECTION: Man Pages -->
<head>
	<link rel="stylesheet" type="text/css" href="../cups-printable.css">
	<title>cupsfilter(8)</title>
</head>
<body>
<h1 class="title">cupsfilter(8)</h1>
<h2 class="title"><a name="NAME">Name</a></h2>
cupsfilter - convert a file to another format using cups filters
<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
<b>cupsfilter
</b>[ -D ] [ -U
<i>user
</i>] [ -c
<i>config-file
</i>] [ -d
<i>printer
</i>] [ -e ] [ -i
<i>mime/type
</i>] [ -j
<i>job-id[,N]
</i>] [ -m
<i>mime/type
</i>] [ -n
<i>copies
</i>] [ -o
<i>name=value
</i>] [ -p
<i>filename.ppd
</i>] [ -t
<i>title
</i>] [ -u ]
<i>filename
</i><h2 class="title"><a name="DESCRIPTION">Description</a></h2>
<i>cupsfilter</i> 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, <i>cupsfilter</i> generates a PDF file. The converted
file is sent to the standard output.
<h2 class="title"><a name="OPTIONS">Options</a></h2>
<dl>
<dt>-D
</dt>
<dd></dd>
<dd>Delete the input file after conversion.
</dd>
<dt>-U user
</dt>
<dd></dd>
<dd>Specifies the username passed to the filters. The default is the name of the current user.
</dd>
<dt>-c config-file
</dt>
<dd></dd>
<dd>Uses the named cups-files.conf configuration file.
</dd>
<dt>-d printer
</dt>
<dd>Uses information from the named printer.
</dd>
<dt>-e
</dt>
<dd></dd>
<dd>Use every filter from the PPD file.
</dd>
<dt>-i mime/type
</dt>
<dd></dd>
<dd>Specifies the source file type. The default file type is guessed using the
filename and contents of the file.
</dd>
<dt>-j job-id[,N]
</dt>
<dd></dd>
<dd>Converts document N from the specified job. If N is omitted, document 1 is
converted.
</dd>
<dt>-m mime/type
</dt>
<dd></dd>
<dd>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.
</dd>
<dt>-n copies
</dt>
<dd></dd>
<dd>Specifies the number of copies to generate.
</dd>
<dt>-o name=value
</dt>
<dd></dd>
<dd>Specifies options to pass to the CUPS filters.
</dd>
<dt>-p filename.ppd
</dt>
<dd></dd>
<dd>Specifies the PPD file to use.
</dd>
<dt>-t title
</dt>
<dd></dd>
<dd>Specifies the document title.
</dd>
<dt>-u
</dt>
<dd></dd>
<dd>Delete the PPD file after conversion.
</dd>
</dl>
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
<a href='man-cups-files.conf.html?TOPIC=Man+Pages'>cups-files.conf(5)</a>
<br>
<a href='http://localhost:631/help'>http://localhost:631/help</a>
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
Copyright 2007-2014 by Apple Inc.

</body>
</html>