Go to main content

man pages section 5: File Formats

Exit Print View

Updated: Wednesday, February 9, 2022
 
 

mime.types (5)

Name

mime.types - mime type description file for cups

Synopsis

Please see following description for synopsis

Description

mime.types(5)                     Apple Inc.                     mime.types(5)



NAME
       mime.types - mime type description file for cups

DESCRIPTION
       The mime.types file defines the recognized file types.

       Additional  file types are specified in files with the extension .types
       in the CUPS configuration directory.

       Each line in the mime.types file is a comment,  blank,  or  rule  line.
       Comment  lines  start  with the # character.  Rule lines start with the
       MIME media type and are optionally followed by a series of file  recog-
       nition rules:

           mime/type [ rule ... rule ]

       Rules can be extended over multiple lines using the backslash character
       (\):

           mime/type [ really-really-really-long-rule ... \
             rule ]

       MIME media types specified by the mime/type field are  case-insensitive
       and  are  sorted  in  ascending  alphanumeric order for the purposes of
       matching.  See the "TYPE MATCHING AND PRIORITY" section for more infor-
       mation.

       The rules may be grouped using parenthesis, joined using "+" for a log-
       ical AND, joined using "," or whitespace for a logical OR, and  negated
       using "!".

   RULES
       Rules  take  two  forms  - a filename extension by itself and functions
       with test values  inside  parenthesis.   The  following  functions  are
       available:

       match("pattern")
            True if the filename matches the given shell wildcard pattern.

       ascii(offset,length)
            True  if  the  length bytes starting at offset are valid printable
            ASCII (CR, NL, TAB, BS, 32-126).

       printable(offset,length)
            True if the length bytes starting at offset  are  printable  8-bit
            chars (CR, NL, TAB, BS, 32-126, 128-254).

       priority(number)
            Specifies  the  relative  priority  of  this MIME media type.  The
            default priority is 100.  Larger values have higher priority while
            smaller values have lower priority.

       string(offset,"string")
            True if the bytes starting at offset are identical to string.

       istring(offset,"string")
            True  if the bytes starting at offset match string without respect
            to case.

       char(offset,value)
            True if the byte at offset is identical to value.

       short(offset,value)
            True if the 16-bit big-endian integer at offset  is  identical  to
            value.

       int(offset,value)
            True  if  the  32-bit big-endian integer at offset is identical to
            value.

       locale("string")
            True if current locale matches string.

       contains(offset,range,"string")
            True if the bytes starting at  offset  for  range  bytes  contains
            string.

   STRING CONSTANTS
       String  constants  can be specified inside quotes ("") for strings con-
       taining whitespace and angle brackets (<>) for hexadecimal strings.

   TYPE MATCHING AND PRIORITY
       When CUPS needs to determine the MIME media type of a  given  file,  it
       checks  every MIME media type defined in the .types files.  When two or
       more types match a given file, the type chosen will depend on the  type
       name  and  priority,  with higher-priority types being used over lower-
       priority ones.  If the types have the same priority, the type names are
       sorted  alphanumerically  in ascending order and the first type is cho-
       sen.

       For example, if two types "text/bar"  and  "text/foo"  are  defined  as
       matching the extension "doc", normally the type "text/bar" will be cho-
       sen since its name is alphanumerically smaller than  "text/foo".   How-
       ever,  if  "text/foo"  also  defines a higher priority than "text/bar",
       "text/foo" will be chosen instead.

FILES
       /etc/cups - Typical CUPS configuration directory.

EXAMPLES
       Define two MIME media types for raster data, with one  being  a  subset
       with higher priority:

           application/vnd.cups-raster  string(0,"RaSt") string(0,"tSaR") \
                                         string(0,"RaS2") string(0,"2SaR") \
                                         string(0,"RaS3") string(0,"3SaR")

           image/pwg-raster              string(0,"RaS2") + \
                                         string(4,PwgRaster<00>) priority(150)


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | print/cups       |
       +---------------+------------------+
       |Stability      | Volatile         |
       +---------------+------------------+

SEE ALSO
       cups-files.conf(5),     cupsd.conf(5),     cupsd(8),     cupsfilter(8),
       mime.convs(5), CUPS Online Help (http://localhost:631/help)

COPYRIGHT
       Copyright (C) 2007-2019 by Apple Inc.



NOTES
       Source code for open source software components in Oracle  Solaris  can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This    software    was    built    from    source     available     at
       https://github.com/oracle/solaris-userland.    The  original  community
       source   was   downloaded    from     https://github.com/apple/cups/ar-
       chive/v2.3.3.zip.

       Further information about this software can be found on the open source
       community website at http://www.cups.org/.



26 April 2019                        CUPS                        mime.types(5)