doc/help/man-mime.convs.html

   1 <!DOCTYPE HTML>
   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>
  11 mime.convs - mime type conversion file for cups (deprecated)
  12 <h2 class="title"><a name="DESCRIPTION">Description</a></h2>
  13 The <b>mime.convs</b> file defines the filters that are available for converting files from one format to another.
  14 The 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
  17 line.
  18 Comment lines start with the # character.
  19 Filter 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>
  25 The <i>source/type</i> field specifies the source MIME media type that is consumed by the filter.
  26 <p>The <i>destination/type</i> field specifies the destination MIME media type that is produced by the filter.
  27 <p>The <i>cost</i> field specifies the relative cost for running the filter.
  28 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.
  29 <p>The <i>filter</i> field specifies the filter program filename.
  30 Filenames 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.
  33 <br>
  34 <i>/usr/lib/cups/filter</i> - Typical CUPS filter directory.
  35 <br>
  36 <i>/usr/libexec/cups/filter</i> - CUPS filter directory on macOS.
  37 <h2 class="title"><a name="EXAMPLES">Examples</a></h2>
  38 Define a filter that converts PostScript documents to CUPS Raster format:
  39 <pre class="man">
  40
  41     application/vnd.cups-postscript application/vnd.cups-raster 50 pstoraster
  42
  43 </pre>
  44 <h2 class="title"><a name="NOTES">Notes</a></h2>
  45 CUPS filters are deprecated and will no longer be supported in a future feature release of CUPS.
  46 Printers that do not support IPP can be supported using applications such as
  47 <b>ippeveprinter</b>(1).
  48 <h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
  49 <b>cups-files.conf</b>(5),
  50 <b>cupsd.conf</b>(5),
  51 <b>cupsd</b>(8),
  52 <b>cupsfilter</b>(8),
  53 <b>mime.types</b>(5),
  54 CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
  55 <h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
  56 Copyright &copy; 2007-2019 by Apple Inc.
  57
  58 </body>
  59 </html>