projects / thirdparty / cups.git / blame
| Commit | Line | Data |
|---|---|---|
| ef416fc2 | 1 | .\" |
| e4e5666b | 2 | .\" "$Id$" |
| ef416fc2 | 3 | .\" |
| 27e0d6f8 | 4 | .\" mime.convs man page for CUPS. |
| ef416fc2 | 5 | .\" |
| 27e0d6f8 MS |
6 | .\" Copyright 2007-2014 by Apple Inc. |
| 7 | .\" Copyright 1997-2006 by Easy Software Products. | |
| ef416fc2 | 8 | .\" |
| 27e0d6f8 MS |
9 | .\" These coded instructions, statements, and computer programs are the |
| 10 | .\" property of Apple Inc. and are protected by Federal copyright | |
| 11 | .\" law. Distribution and use rights are outlined in the file "LICENSE.txt" | |
| 12 | .\" which should have been included with this file. If this file is | |
| 13 | .\" file is missing or damaged, see the license at "http://www.cups.org/". | |
| ef416fc2 | 14 | .\" |
| 27e0d6f8 | 15 | .TH mime.convs 5 "CUPS" "12 June 2014" "Apple Inc." |
| ef416fc2 | 16 | .SH NAME |
| 17 | mime.convs \- mime type conversion file for cups | |
| 18 | .SH DESCRIPTION | |
| 27e0d6f8 MS |
19 | The \fBmime.convs\fR file defines the filters that are available for converting files from one format to another. |
| 20 | The standard filters support text, PDF, PostScript, and many types of image files. | |
| ef416fc2 | 21 | .LP |
| 27e0d6f8 | 22 | Additional filters are specified in files with the extension \fI.convs\fR in the CUPS configuration directory. |
| ef416fc2 | 23 | .LP |
| 27e0d6f8 MS |
24 | Each line in the \fBmime.convs\fR file is a comment, blank, or filter |
| 25 | line. | |
| 26 | Comment lines start with the # character. | |
| 27 | Filter lines specify the source and destination MIME types along with a relative cost associated with the filter and the filter to run: | |
| 28 | .nf | |
| 29 | ||
| 30 | source/type destination/type cost filter | |
| 31 | ||
| 32 | .fi | |
| 33 | The \fIsource/type\fR field specifies the source MIME media type that is consumed by the filter. | |
| 34 | .LP | |
| 35 | The \fIdestination/type\fR field specifies the destiantion MIME media type that is produced by the filter. | |
| 36 | .LP | |
| 37 | The \fIcost\fR field specifies the relative cost for running the filter. | |
| 38 | 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. | |
| 39 | .LP | |
| 40 | The \fIfilter\fR field specifies the filter program filename. | |
| 41 | Filenames are relative to the CUPS filter directory. | |
| 42 | .SH FILES | |
| 43 | \fI/etc/cups\fR - Typical CUPS configuration directory. | |
| 44 | .br | |
| 45 | \fI/usr/lib/cups/filter\fR - Typical CUPS filter directory. | |
| ef416fc2 | 46 | .br |
| 27e0d6f8 MS |
47 | \fI/usr/libexec/cups/filter\fR - CUPS filter directory on OS X. |
| 48 | .SH EXAMPLES | |
| 49 | Define a filter that converts PostScript documents to CUPS Raster format: | |
| ef416fc2 | 50 | .nf |
| 51 | ||
| 27e0d6f8 MS |
52 | application/vnd.cups\-postscript application/vnd.cups\-raster 50 pstoraster |
| 53 | ||
| ef416fc2 | 54 | .fi |
| 55 | .SH SEE ALSO | |
| 27e0d6f8 MS |
56 | .BR cups-files.conf (5), |
| 57 | .BR cupsd.conf (5), | |
| 58 | .BR cupsd (8), | |
| 59 | .BR cupsfilter (8), | |
| 60 | .BR mime.types (5), | |
| 61 | CUPS Online Help (http://localhost:631/help) | |
| ef416fc2 | 62 | .SH COPYRIGHT |
| 27e0d6f8 | 63 | Copyright \[co] 2007-2014 by Apple Inc. |
| ef416fc2 | 64 | .\" |
| e4e5666b | 65 | .\" End of "$Id$". |
| ef416fc2 | 66 | .\" |