]>
Commit | Line | Data |
---|---|---|
bc44d920 | 1 | .\" |
e4e5666b | 2 | .\" "$Id$" |
bc44d920 | 3 | .\" |
84987361 | 4 | .\" cupsfilter man page for CUPS. |
bc44d920 | 5 | .\" |
84987361 | 6 | .\" Copyright 2007-2014 by Apple Inc. |
bc44d920 | 7 | .\" |
84987361 MS |
8 | .\" These coded instructions, statements, and computer programs are the |
9 | .\" property of Apple Inc. and are protected by Federal copyright | |
10 | .\" law. Distribution and use rights are outlined in the file "LICENSE.txt" | |
11 | .\" which should have been included with this file. If this file is | |
12 | .\" file is missing or damaged, see the license at "http://www.cups.org/". | |
bc44d920 | 13 | .\" |
bf1bc4c6 | 14 | .TH cupsfilter 8 "CUPS" "11 June 2014" "Apple Inc." |
bc44d920 | 15 | .SH NAME |
16 | cupsfilter \- convert a file to another format using cups filters | |
17 | .SH SYNOPSIS | |
18 | .B cupsfilter | |
bf1bc4c6 MS |
19 | [ |
20 | .B \-\-list\-filters | |
21 | ] [ | |
22 | .B \-D | |
23 | ] [ | |
24 | .B \-U | |
37e7e6e0 | 25 | .I user |
bf1bc4c6 MS |
26 | ] [ |
27 | .B \-c | |
bc44d920 | 28 | .I config-file |
bf1bc4c6 MS |
29 | ] [ |
30 | .B \-d | |
ba55dc12 | 31 | .I printer |
bf1bc4c6 MS |
32 | ] [ |
33 | .B \-e | |
34 | ] [ | |
35 | .B \-i | |
37e7e6e0 | 36 | .I mime/type |
bf1bc4c6 MS |
37 | ] [ |
38 | .B \-j | |
2e4ff8af | 39 | .I job-id[,N] |
bf1bc4c6 MS |
40 | ] [ |
41 | .B \-m | |
bc44d920 | 42 | .I mime/type |
bf1bc4c6 MS |
43 | ] [ |
44 | .B \-n | |
bc44d920 | 45 | .I copies |
bf1bc4c6 MS |
46 | ] [ |
47 | .B \-o | |
bc44d920 | 48 | .I name=value |
bf1bc4c6 MS |
49 | ] [ |
50 | .B \-p | |
bc44d920 | 51 | .I filename.ppd |
bf1bc4c6 MS |
52 | ] [ |
53 | .B \-t | |
bc44d920 | 54 | .I title |
bf1bc4c6 MS |
55 | ] [ |
56 | .B \-u | |
57 | ] | |
bc44d920 | 58 | .I filename |
59 | .SH DESCRIPTION | |
84987361 MS |
60 | .B cupsfilter |
61 | 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, | |
62 | .B cupsfilter | |
63 | generates a PDF file. The converted file is sent to the standard output. | |
bc44d920 | 64 | .SH OPTIONS |
65 | .TP 5 | |
bf1bc4c6 | 66 | .B \-\-list\-filters |
84987361 MS |
67 | Do not actually run the filters, just print the filters used to stdout. |
68 | .TP 5 | |
bf1bc4c6 | 69 | .B \-D |
37e7e6e0 MS |
70 | Delete the input file after conversion. |
71 | .TP 5 | |
bf1bc4c6 | 72 | \fB\-U \fIuser\fR |
37e7e6e0 MS |
73 | Specifies the username passed to the filters. The default is the name of the current user. |
74 | .TP 5 | |
bf1bc4c6 | 75 | \fB\-c \fIconfig-file\fR |
84987361 | 76 | Uses the named cups-files.conf configuration file. |
bc44d920 | 77 | .TP 5 |
bf1bc4c6 | 78 | \fB\-d \fIprinter\fR |
ba55dc12 MS |
79 | Uses information from the named printer. |
80 | .TP 5 | |
bf1bc4c6 | 81 | .B \-e |
1340db2d MS |
82 | Use every filter from the PPD file. |
83 | .TP 5 | |
bf1bc4c6 | 84 | \fB\-i \fImime/type\fR |
84987361 | 85 | Specifies the source file type. The default file type is guessed using the filename and contents of the file. |
37e7e6e0 | 86 | .TP 5 |
bf1bc4c6 | 87 | \fB\-j \fIjob-id[,N]\fR |
84987361 | 88 | Converts document N from the specified job. If N is omitted, document 1 is converted. |
2e4ff8af | 89 | .TP 5 |
bf1bc4c6 | 90 | \fB\-m \fImime/type\fR |
84987361 | 91 | 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. |
bc44d920 | 92 | .TP 5 |
bf1bc4c6 | 93 | \fB\-n \fIcopies\fR |
bc44d920 | 94 | Specifies the number of copies to generate. |
95 | .TP 5 | |
bf1bc4c6 | 96 | \fB\-o \fIname=value\fR |
bc44d920 | 97 | Specifies options to pass to the CUPS filters. |
98 | .TP 5 | |
bf1bc4c6 | 99 | \fB\-p \fIfilename.ppd\fR |
bc44d920 | 100 | Specifies the PPD file to use. |
101 | .TP 5 | |
bf1bc4c6 | 102 | \fB\-t \fItitle\fR |
bc44d920 | 103 | Specifies the document title. |
37e7e6e0 | 104 | .TP 5 |
bf1bc4c6 | 105 | .B \-u |
37e7e6e0 | 106 | Delete the PPD file after conversion. |
84987361 MS |
107 | .SH EXIT STATUS |
108 | .B cupsfilter | |
109 | returns a non-zero exit status on any error. | |
110 | .SH ENVIRONMENT | |
111 | All of the standard | |
112 | .BR cups (1) | |
113 | environment variables affect the operation of | |
114 | .BR cupsfilter . | |
115 | .SH FILES | |
bf1bc4c6 MS |
116 | .nf |
117 | /etc/cups/cups-files.conf | |
118 | /etc/cups/*.convs | |
119 | /etc/cups/*.types | |
120 | /usr/share/cups/mime/*.convs | |
121 | /usr/share/cups/mime/*.types | |
84987361 MS |
122 | .SH NOTES |
123 | Unlike when printing, filters run using the | |
124 | .B cupsfilter | |
125 | command use the current user and security session. This may result in different output or unexpected behavior. | |
126 | .SH EXAMPLE | |
127 | 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": | |
128 | .nf | |
bf1bc4c6 | 129 | |
84987361 MS |
130 | cupsfilter -m application/pdf -d myprinter -j 42 >preview.pdf |
131 | .fi | |
bc44d920 | 132 | .SH SEE ALSO |
bf1bc4c6 MS |
133 | .BR cups (1), |
134 | .BR cupsd.conf (5), | |
135 | .BR filter(7), | |
136 | .BR mime.convs (7), | |
137 | .BR mime.types (7), | |
138 | CUPS Online Help (http://localhost:631/help) | |
bc44d920 | 139 | .SH COPYRIGHT |
84987361 | 140 | Copyright \[co] 2007-2014 by Apple Inc. |
bc44d920 | 141 | .\" |
e4e5666b | 142 | .\" End of "$Id$". |
bc44d920 | 143 | .\" |