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