summaryrefslogtreecommitdiff
path: root/doc/help/man-mime.convs.html
blob: e4d8813c8e160a30f012d1284023cb7f25a7a37b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
<!DOCTYPE HTML>
<html>
<!-- SECTION: Man Pages -->
<head>
	<link rel="stylesheet" type="text/css" href="../cups-printable.css">
	<title>mime.convs(5)</title>
</head>
<body>
<h1 class="title">mime.convs(5)</h1>
<h2 class="title"><a name="NAME">Name</a></h2>
mime.convs - mime type conversion file for cups (deprecated)
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
The <b>mime.convs</b> file defines the filters that are available for converting files from one format to another.
The standard filters support text, PDF, PostScript, and many types of image files.
<p>Additional filters are specified in files with the extension <i>.convs</i> in the CUPS configuration directory.
<p>Each line in the <b>mime.convs</b> file is a comment, blank, or filter
line.
Comment lines start with the # character.
Filter lines specify the source and destination MIME types along with a relative cost associated with the filter and the filter to run:
<pre class="man">

    source/type destination/type cost filter

</pre>
The <i>source/type</i> field specifies the source MIME media type that is consumed by the filter.
<p>The <i>destination/type</i> field specifies the destination MIME media type that is produced by the filter.
<p>The <i>cost</i> field specifies the relative cost for running the filter.
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.
<p>The <i>filter</i> field specifies the filter program filename.
Filenames are relative to the CUPS filter directory.
<h2 class="title"><a name="FILES">Files</a></h2>
<i>/etc/cups</i> - Typical CUPS configuration directory.
<br>
<i>/usr/lib/cups/filter</i> - Typical CUPS filter directory.
<br>
<i>/usr/libexec/cups/filter</i> - CUPS filter directory on macOS.
<h2 class="title"><a name="EXAMPLES">Examples</a></h2>
Define a filter that converts PostScript documents to CUPS Raster format:
<pre class="man">

    application/vnd.cups-postscript application/vnd.cups-raster 50 pstoraster

</pre>
<h2 class="title"><a name="NOTES">Notes</a></h2>
CUPS filters are deprecated and will no longer be supported in a future feature release of CUPS.
Printers that do not support IPP can be supported using applications such as
<b>ippeveprinter</b>(1).
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
<b>cups-files.conf</b>(5),
<b>cupsd.conf</b>(5),
<b>cupsd</b>(8),
<b>cupsfilter</b>(8),
<b>mime.types</b>(5),
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
Copyright &copy; 2007-2019 by Apple Inc.

</body>
</html>