xref: /aosp_15_r20/external/libcups/doc/help/man-mime.convs.html (revision 5e7646d21f1134fb0638875d812ef646c12ab91e)
1*5e7646d2SAndroid Build Coastguard Worker<!DOCTYPE HTML>
2*5e7646d2SAndroid Build Coastguard Worker<html>
3*5e7646d2SAndroid Build Coastguard Worker<!-- SECTION: Man Pages -->
4*5e7646d2SAndroid Build Coastguard Worker<head>
5*5e7646d2SAndroid Build Coastguard Worker	<link rel="stylesheet" type="text/css" href="../cups-printable.css">
6*5e7646d2SAndroid Build Coastguard Worker	<title>mime.convs(5)</title>
7*5e7646d2SAndroid Build Coastguard Worker</head>
8*5e7646d2SAndroid Build Coastguard Worker<body>
9*5e7646d2SAndroid Build Coastguard Worker<h1 class="title">mime.convs(5)</h1>
10*5e7646d2SAndroid Build Coastguard Worker<h2 class="title"><a name="NAME">Name</a></h2>
11*5e7646d2SAndroid Build Coastguard Workermime.convs - mime type conversion file for cups (deprecated)
12*5e7646d2SAndroid Build Coastguard Worker<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
13*5e7646d2SAndroid Build Coastguard WorkerThe <b>mime.convs</b> file defines the filters that are available for converting files from one format to another.
14*5e7646d2SAndroid Build Coastguard WorkerThe standard filters support text, PDF, PostScript, and many types of image files.
15*5e7646d2SAndroid Build Coastguard Worker<p>Additional filters are specified in files with the extension <i>.convs</i> in the CUPS configuration directory.
16*5e7646d2SAndroid Build Coastguard Worker<p>Each line in the <b>mime.convs</b> file is a comment, blank, or filter
17*5e7646d2SAndroid Build Coastguard Workerline.
18*5e7646d2SAndroid Build Coastguard WorkerComment lines start with the # character.
19*5e7646d2SAndroid Build Coastguard WorkerFilter lines specify the source and destination MIME types along with a relative cost associated with the filter and the filter to run:
20*5e7646d2SAndroid Build Coastguard Worker<pre class="man">
21*5e7646d2SAndroid Build Coastguard Worker
22*5e7646d2SAndroid Build Coastguard Worker    source/type destination/type cost filter
23*5e7646d2SAndroid Build Coastguard Worker
24*5e7646d2SAndroid Build Coastguard Worker</pre>
25*5e7646d2SAndroid Build Coastguard WorkerThe <i>source/type</i> field specifies the source MIME media type that is consumed by the filter.
26*5e7646d2SAndroid Build Coastguard Worker<p>The <i>destination/type</i> field specifies the destination MIME media type that is produced by the filter.
27*5e7646d2SAndroid Build Coastguard Worker<p>The <i>cost</i> field specifies the relative cost for running the filter.
28*5e7646d2SAndroid Build Coastguard WorkerA 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*5e7646d2SAndroid Build Coastguard Worker<p>The <i>filter</i> field specifies the filter program filename.
30*5e7646d2SAndroid Build Coastguard WorkerFilenames are relative to the CUPS filter directory.
31*5e7646d2SAndroid Build Coastguard Worker<h2 class="title"><a name="FILES">Files</a></h2>
32*5e7646d2SAndroid Build Coastguard Worker<i>/etc/cups</i> - Typical CUPS configuration directory.
33*5e7646d2SAndroid Build Coastguard Worker<br>
34*5e7646d2SAndroid Build Coastguard Worker<i>/usr/lib/cups/filter</i> - Typical CUPS filter directory.
35*5e7646d2SAndroid Build Coastguard Worker<br>
36*5e7646d2SAndroid Build Coastguard Worker<i>/usr/libexec/cups/filter</i> - CUPS filter directory on macOS.
37*5e7646d2SAndroid Build Coastguard Worker<h2 class="title"><a name="EXAMPLES">Examples</a></h2>
38*5e7646d2SAndroid Build Coastguard WorkerDefine a filter that converts PostScript documents to CUPS Raster format:
39*5e7646d2SAndroid Build Coastguard Worker<pre class="man">
40*5e7646d2SAndroid Build Coastguard Worker
41*5e7646d2SAndroid Build Coastguard Worker    application/vnd.cups-postscript application/vnd.cups-raster 50 pstoraster
42*5e7646d2SAndroid Build Coastguard Worker
43*5e7646d2SAndroid Build Coastguard Worker</pre>
44*5e7646d2SAndroid Build Coastguard Worker<h2 class="title"><a name="NOTES">Notes</a></h2>
45*5e7646d2SAndroid Build Coastguard WorkerCUPS filters are deprecated and will no longer be supported in a future feature release of CUPS.
46*5e7646d2SAndroid Build Coastguard WorkerPrinters that do not support IPP can be supported using applications such as
47*5e7646d2SAndroid Build Coastguard Worker<b>ippeveprinter</b>(1).
48*5e7646d2SAndroid Build Coastguard Worker<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
49*5e7646d2SAndroid Build Coastguard Worker<b>cups-files.conf</b>(5),
50*5e7646d2SAndroid Build Coastguard Worker<b>cupsd.conf</b>(5),
51*5e7646d2SAndroid Build Coastguard Worker<b>cupsd</b>(8),
52*5e7646d2SAndroid Build Coastguard Worker<b>cupsfilter</b>(8),
53*5e7646d2SAndroid Build Coastguard Worker<b>mime.types</b>(5),
54*5e7646d2SAndroid Build Coastguard WorkerCUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
55*5e7646d2SAndroid Build Coastguard Worker<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
56*5e7646d2SAndroid Build Coastguard WorkerCopyright &copy; 2007-2019 by Apple Inc.
57*5e7646d2SAndroid Build Coastguard Worker
58*5e7646d2SAndroid Build Coastguard Worker</body>
59*5e7646d2SAndroid Build Coastguard Worker</html>
60