cups/man/mime.convs.5

64 lines
2.3 KiB
Groff
Raw Permalink Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

.\"
.\" mime.convs man page for CUPS.
.\"
.\" Copyright © 2021-2023 by OpenPrinting.
.\" Copyright © 2007-2019 by Apple Inc.
.\" Copyright © 1997-2006 by Easy Software Products.
.\"
.\" Licensed under Apache License v2.0. See the file "LICENSE" for more
.\" information.
.\"
.TH mime.convs 5 "CUPS" "2021-02-28" "OpenPrinting"
.SH NAME
mime.convs \- mime type conversion file for cups (deprecated)
.SH DESCRIPTION
The \fBmime.convs\fR 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.
.LP
Additional filters are specified in files with the extension \fI.convs\fR in the CUPS configuration directory.
.LP
Each line in the \fBmime.convs\fR 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:
.nf
source/type destination/type cost filter
.fi
The \fIsource/type\fR field specifies the source MIME media type that is consumed by the filter.
.LP
The \fIdestination/type\fR field specifies the destination MIME media type that is produced by the filter.
.LP
The \fIcost\fR 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.
.LP
The \fIfilter\fR field specifies the filter program filename.
Filenames are relative to the CUPS filter directory.
.SH FILES
\fI/etc/cups\fR - Typical CUPS configuration directory.
.br
\fI/usr/lib/cups/filter\fR - Typical CUPS filter directory.
.br
\fI/usr/libexec/cups/filter\fR - CUPS filter directory on macOS.
.SH EXAMPLES
Define a filter that converts PostScript documents to CUPS Raster format:
.nf
application/vnd.cups\-postscript application/vnd.cups\-raster 50 pstoraster
.fi
.SH NOTES
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
.BR ippeveprinter (1).
.SH SEE ALSO
.BR cups-files.conf (5),
.BR cupsd.conf (5),
.BR cupsd (8),
.BR cupsfilter (8),
.BR mime.types (5),
CUPS Online Help (http://localhost:631/help)
.SH COPYRIGHT
Copyright \[co] 2021-2023 by OpenPrinting.