]> git.ipfire.org Git - thirdparty/cups.git/blame - doc/help/man-mime.convs.html
Update all references to OS X to macOS.
[thirdparty/cups.git] / doc / help / man-mime.convs.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>mime.convs(5)</title>
7</head>
8<body>
9<h1 class="title">mime.convs(5)</h1>
10<h2 class="title"><a name="NAME">Name</a></h2>
11mime.convs - mime type conversion file for cups
12<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
27e0d6f8
MS
13The <b>mime.convs</b> file defines the filters that are available for converting files from one format to another.
14The standard filters support text, PDF, PostScript, and many types of image files.
15<p>Additional filters are specified in files with the extension <i>.convs</i> in the CUPS configuration directory.
16<p>Each line in the <b>mime.convs</b> file is a comment, blank, or filter
17line.
18Comment lines start with the # character.
19Filter lines specify the source and destination MIME types along with a relative cost associated with the filter and the filter to run:
20<pre class="man">
21
22 source/type destination/type cost filter
23
24</pre>
25The <i>source/type</i> field specifies the source MIME media type that is consumed by the filter.
dd3fdd2c 26<p>The <i>destination/type</i> field specifies the destination MIME media type that is produced by the filter.
27e0d6f8
MS
27<p>The <i>cost</i> field specifies the relative cost for running the filter.
28A 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.
29<p>The <i>filter</i> field specifies the filter program filename.
30Filenames are relative to the CUPS filter directory.
31<h2 class="title"><a name="FILES">Files</a></h2>
32<i>/etc/cups</i> - Typical CUPS configuration directory.
94436c5a 33<br>
27e0d6f8
MS
34<i>/usr/lib/cups/filter</i> - Typical CUPS filter directory.
35<br>
8072030b 36<i>/usr/libexec/cups/filter</i> - CUPS filter directory on macOS.
27e0d6f8
MS
37<h2 class="title"><a name="EXAMPLES">Examples</a></h2>
38Define a filter that converts PostScript documents to CUPS Raster format:
2909c66c 39<pre class="man">
94436c5a 40
27e0d6f8
MS
41 application/vnd.cups-postscript application/vnd.cups-raster 50 pstoraster
42
94436c5a
MS
43</pre>
44<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
27e0d6f8
MS
45<a href="man-cups-files.conf.html?TOPIC=Man+Pages"><b>cups-files.conf</b>(5),</a>
46<a href="man-cupsd.conf.html?TOPIC=Man+Pages"><b>cupsd.conf</b>(5),</a>
47<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8),</a>
48<a href="man-cupsfilter.html?TOPIC=Man+Pages"><b>cupsfilter</b>(8),</a>
49<a href="man-mime.types.html?TOPIC=Man+Pages"><b>mime.types</b>(5),</a>
50CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
94436c5a 51<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
d58c2629 52Copyright &copy; 2007-2016 by Apple Inc.
94436c5a
MS
53
54</body>
55</html>