man/mime.convs.man

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