]> git.ipfire.org Git - thirdparty/cups.git/blob - man/mime.types.man
Merge changes from CUPS 1.4svn-r7696.
[thirdparty/cups.git] / man / mime.types.man
1 .\"
2 .\" "$Id: mime.types.man 7670 2008-06-17 22:42:08Z mike $"
3 .\"
4 .\" mime.types man page for the Common UNIX Printing System (CUPS).
5 .\"
6 .\" Copyright 2007-2008 by Apple Inc.
7 .\" Copyright 1997-2006 by Easy Software Products.
8 .\"
9 .\" These coded instructions, statements, and computer programs are the
10 .\" property of Apple Inc. and are protected by Federal copyright
11 .\" law. Distribution and use rights are outlined in the file "LICENSE.txt"
12 .\" which should have been included with this file. If this file is
13 .\" file is missing or damaged, see the license at "http://www.cups.org/".
14 .\"
15 .TH mime.types 5 "Common UNIX Printing System" "17 June 2008" "Apple Inc."
16 .SH NAME
17 mime.types \- mime type description file for cups
18 .SH DESCRIPTION
19 The \fImime.types\fR file defines the recognized file types.
20 .LP
21 Additional file types can be added to \fImime.types\fR or
22 (preferably) in additional files in the CUPS configuration
23 directory with the extension ".types".
24 .LP
25 Each line in the \fImime.types\fR file is a comment, blank, or
26 rule line. Comment lines start with the # character. Rule lines
27 start with the MIME type name and are optionally followed by a
28 series of file recognition rules that are used to automatically
29 identify print and web files:
30 .br
31 .nf
32
33 super/type rule [ ... ruleN]
34 .fi
35 The rules may be grouped using parenthesis, joined using "+" for a
36 logical AND and "," or whitespace for a logical OR, and negated using
37 "!".
38 .SH RULES
39 Rules take two forms - a filename extension by itself and functions with test
40 values inside parenthesis. The following functions are available:
41 .TP 5
42 match("pattern")
43 .br
44 Pattern match on filename
45 .TP 5
46 ascii(offset,length)
47 .br
48 True if bytes are valid printable ASCII (CR, NL, TAB, BS, 32-126)
49 .TP 5
50 printable(offset,length)
51 .br
52 True if bytes are printable 8-bit chars (CR, NL, TAB, BS, 32-126, 128-254)
53 .TP 5
54 priority(number)
55 .br
56 Specifies the relative priority of this MIME type. The default priority is 100.
57 Larger values have higher priority while smaller values have lower priority.
58 .TP 5
59 string(offset,"string")
60 .br
61 True if bytes are identical to string
62 .TP 5
63 istring(offset,"string")
64 .br
65 True if a case-insensitive comparison of the bytes is identical
66 .TP 5
67 char(offset,value)
68 .br
69 True if byte is identical
70 .TP 5
71 short(offset,value)
72 .br
73 True if 16-bit integer is identical
74 .TP 5
75 int(offset,value)
76 .br
77 True if 32-bit integer is identical
78 .TP 5
79 locale("string")
80 .br
81 True if current locale matches string
82 .TP 5
83 contains(offset,range,"string")
84 .br
85 True if the range contains the string
86 .SH STRING CONSTANTS
87 String constants can be specified inside quotes ("") for strings
88 containing whitespace and angle brackets (<>) for hexadecimal
89 strings.
90 .SH SEE ALSO
91 \fIclasses.conf(5)\fR, \fIcupsd(8)\fR, \fIcupsd.conf(5)\fR,
92 \fImime.convs(5)\fR, \fIprinters.conf(5)\fR,
93 .br
94 http://localhost:631/help
95 .SH COPYRIGHT
96 Copyright 2007-2008 by Apple Inc.
97 .\"
98 .\" End of "$Id: mime.types.man 7670 2008-06-17 22:42:08Z mike $".
99 .\"