]>
Commit | Line | Data |
---|---|---|
ef416fc2 | 1 | .\" |
27e0d6f8 | 2 | .\" mime.convs man page for CUPS. |
ef416fc2 | 3 | .\" |
87030afb MS |
4 | .\" Copyright © 2007-2019 by Apple Inc. |
5 | .\" Copyright © 1997-2006 by Easy Software Products. | |
ef416fc2 | 6 | .\" |
87030afb MS |
7 | .\" Licensed under Apache License v2.0. See the file "LICENSE" for more |
8 | .\" information. | |
ef416fc2 | 9 | .\" |
87030afb | 10 | .TH mime.convs 5 "CUPS" "26 April 2019" "Apple Inc." |
ef416fc2 | 11 | .SH NAME |
87030afb | 12 | mime.convs \- mime type conversion file for cups (deprecated) |
ef416fc2 | 13 | .SH DESCRIPTION |
27e0d6f8 MS |
14 | The \fBmime.convs\fR file defines the filters that are available for converting files from one format to another. |
15 | The standard filters support text, PDF, PostScript, and many types of image files. | |
ef416fc2 | 16 | .LP |
27e0d6f8 | 17 | Additional filters are specified in files with the extension \fI.convs\fR in the CUPS configuration directory. |
ef416fc2 | 18 | .LP |
27e0d6f8 MS |
19 | Each line in the \fBmime.convs\fR file is a comment, blank, or filter |
20 | line. | |
21 | Comment lines start with the # character. | |
22 | Filter lines specify the source and destination MIME types along with a relative cost associated with the filter and the filter to run: | |
23 | .nf | |
24 | ||
25 | source/type destination/type cost filter | |
26 | ||
27 | .fi | |
28 | The \fIsource/type\fR field specifies the source MIME media type that is consumed by the filter. | |
29 | .LP | |
dd3fdd2c | 30 | The \fIdestination/type\fR field specifies the destination MIME media type that is produced by the filter. |
27e0d6f8 MS |
31 | .LP |
32 | The \fIcost\fR field specifies the relative cost for running the filter. | |
33 | A value of 100 means that the filter uses a large amount of resources while a value of 0 means that the filter uses very few resources. | |
34 | .LP | |
35 | The \fIfilter\fR field specifies the filter program filename. | |
36 | Filenames are relative to the CUPS filter directory. | |
37 | .SH FILES | |
38 | \fI/etc/cups\fR - Typical CUPS configuration directory. | |
39 | .br | |
40 | \fI/usr/lib/cups/filter\fR - Typical CUPS filter directory. | |
ef416fc2 | 41 | .br |
8072030b | 42 | \fI/usr/libexec/cups/filter\fR - CUPS filter directory on macOS. |
27e0d6f8 MS |
43 | .SH EXAMPLES |
44 | Define a filter that converts PostScript documents to CUPS Raster format: | |
ef416fc2 | 45 | .nf |
46 | ||
27e0d6f8 MS |
47 | application/vnd.cups\-postscript application/vnd.cups\-raster 50 pstoraster |
48 | ||
ef416fc2 | 49 | .fi |
87030afb MS |
50 | .SH NOTES |
51 | CUPS filters are deprecated and will no longer be supported in a future feature release of CUPS. | |
52 | Printers that do not support IPP can be supported using applications such as | |
53 | .BR ippeveprinter (1). | |
ef416fc2 | 54 | .SH SEE ALSO |
27e0d6f8 MS |
55 | .BR cups-files.conf (5), |
56 | .BR cupsd.conf (5), | |
57 | .BR cupsd (8), | |
58 | .BR cupsfilter (8), | |
59 | .BR mime.types (5), | |
60 | CUPS Online Help (http://localhost:631/help) | |
ef416fc2 | 61 | .SH COPYRIGHT |
87030afb | 62 | Copyright \[co] 2007-2019 by Apple Inc. |