NAME | SYNOPSIS | DESCRIPTION | EXAMPLES | ATTRIBUTES | SEE ALSO
site_path/conf/content.conf
The content definitions may be created by htcontent(1m).
The following syntax rules apply to the content.conf file:
The pound sign (#) is a comment character. All characters from a # to the end of a line are ignored.
White space is ignored in directive definitions.
Some directives accept a list of values. Separate multiple values by white space. If more than one line is required to list all values, escape all but the last newline with a backslash (\) at the end of the line.
Directives of the type name = value require whitespace around the = symbol.
All directives are grouped in blocks surrounded by curly braces ({ and }). Any amount of white space, newlines, or directive definitions may appear between an opening curly brace and its matching close, including directive blocks. Directive blocks also use matched curly braces to contain a definition. The url blocks can be embedded inside other url blocks. Then the embedded url block inherits information from its parent block unless it explicitly redefines a directive, in which case the directives in the child block will override the directives in the parent.
Content settings take the following form:
url <URI> { variant <variant_info> preferences { directory_listing {fancy | simple | off} default_files media_type language encoding charset } [url <file_uri> { filename <variant_info> preferences { media_type language encoding charset } }]... }
The syntax and definition of each directive is explained in the following Directives section.
The following keyword directives are valid in the content.conf file:
Sets the server's content negotiation preferences for the specified URI. Listed in order of preference. Separate multiple preferences with a space. Valid preferences are:
Specifies the character set of the data. A character set refers to a method used with one or more tables to convert a sequence of octets into a sequence of characters. The default charset for variants is ISO-8859-1.
Specifies in order of preference the default files Sun WebServer looks for in a directory. If no match is found in this list of file names, the directory contents are displayed. Multiple files must be separated by whitespace. A different set of default files can be named in any directory.
Use the null string, "", as the file name to indicate that there is no default file for the directory. If no file is named, the directory contents will always be listed.
Sets the method for displaying the contents of a directory when there is no file matching one of the default file names. Listing type can be "fancy" to display each directory entry as a hyperlink with the file size, the last modified time, and an icon next to each entry to indicate the file type; "simple" to display directory entries as plain text hyperlinks; or "off" to display no directory contents.
Specifies the preferred encodings or the encoding type. Encoding refers only to methods of compression. For example, gzip or compress reveals which methods have been used to encode the file.
Specifies in order of preference the preferred languages. Languages are specified in the standard two-letter format.
Specifies the preferred types of media. Media type is in standard MIME type format.
Sets the server's variants for resources. Separate multiple variants with a space. Valid variants are:
Specifies the character set of the data. A character set refers to a method used with one or more tables to convert a sequence of octets into a sequence of characters.
Specifies the preferred encodings or the encoding type. Encoding refers only to methods of compression. For example, gzip or compress reveals which methods have been used to encode the file.
Specifies the preferred languages. Languages are specified in the standard two--letter format.
Specifies the preferred types of media. Media type is in standard MIME type format.
url /index.html { index.fr.html lang = fr enc = gzip char = iso-8809-1 type = text/html index.de.html lang = de type = text/html; level=3.0 }
Note that the level=3.0
is part of the type definition; it indicates the HTML version level of the resource. If a browser uses the level in a request for an HTML document, and all other things are equal, the server will send the matching resource with the greatest HTML level acceptable to the client.
To set the default files in a directory to index.html or index.shtml:
url /pages/ { preferences { directory_listing off default_files index.html index.shtml } url index.html { index.ja.html lang = ja char = EUC_JP index.en.html lang = en char = iso-8809-1 index.fr.html lang = fr char = iso-8809-1 } }
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE | ATTRIBUTE VALUE |
Availability | SUNWhttpc |
Interface Stability | Evolving |
NAME | SYNOPSIS | DESCRIPTION | EXAMPLES | ATTRIBUTES | SEE ALSO