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 .\" Licensed under Apache License v2.0.  See the file "LICENSE" for more information.
   8 .\"
   9 .TH mime.convs 5 "CUPS" "26 August 2015" "Apple Inc."
  10 .SH NAME
  11 mime.convs \- mime type conversion file for cups
  12 .SH DESCRIPTION
  13 The \fBmime.convs\fR 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 .LP
  16 Additional filters are specified in files with the extension \fI.convs\fR in the CUPS configuration directory.
  17 .LP
  18 Each line in the \fBmime.convs\fR file is a comment, blank, or filter
  19 line.
  20 Comment lines start with the # character.
  21 Filter lines specify the source and destination MIME types along with a relative cost associated with the filter and the filter to run:
  22 .nf
  23
  24     source/type destination/type cost filter
  25
  26 .fi
  27 The \fIsource/type\fR field specifies the source MIME media type that is consumed by the filter.
  28 .LP
  29 The \fIdestination/type\fR field specifies the destination MIME media type that is produced by the filter.
  30 .LP
  31 The \fIcost\fR field specifies the relative cost for running the filter.
  32 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.
  33 .LP
  34 The \fIfilter\fR field specifies the filter program filename.
  35 Filenames are relative to the CUPS filter directory.
  36 .SH FILES
  37 \fI/etc/cups\fR - Typical CUPS configuration directory.
  38 .br
  39 \fI/usr/lib/cups/filter\fR - Typical CUPS filter directory.
  40 .br
  41 \fI/usr/libexec/cups/filter\fR - CUPS filter directory on macOS.
  42 .SH EXAMPLES
  43 Define a filter that converts PostScript documents to CUPS Raster format:
  44 .nf
  45
  46     application/vnd.cups\-postscript application/vnd.cups\-raster 50 pstoraster
  47
  48 .fi
  49 .SH SEE ALSO
  50 .BR cups-files.conf (5),
  51 .BR cupsd.conf (5),
  52 .BR cupsd (8),
  53 .BR cupsfilter (8),
  54 .BR mime.types (5),
  55 CUPS Online Help (http://localhost:631/help)
  56 .SH COPYRIGHT
  57 Copyright \[co] 2007-2018 by Apple Inc.