mod_cern_meta.xml revision 7a98571671f92e53441bf24a0222768072172f90
1a38107941725211e7c3f051f7a8f5e12199f03acmaeder<?xml version="1.0"?>
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu<!DOCTYPE modulesynopsis SYSTEM "/style/modulesynopsis.dtd">
e9458b1a7a19a63aa4c179f9ab20f4d50681c168Jens Elkner<?xml-stylesheet type="text/xsl" href="/style/manual.en.xsl"?>
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu<!-- $LastChangedRevision$ -->
431571057e88a650a974adec93ea4bb5173b6213Felix Gabriel Mance
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu<!--
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu Licensed to the Apache Software Foundation (ASF) under one or more
431571057e88a650a974adec93ea4bb5173b6213Felix Gabriel Mance contributor license agreements. See the NOTICE file distributed with
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu this work for additional information regarding copyright ownership.
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu The ASF licenses this file to You under the Apache License, Version 2.0
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu (the "License"); you may not use this file except in compliance with
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu the License. You may obtain a copy of the License at
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu http://www.apache.org/licenses/LICENSE-2.0
19e01e1a7e319063434bd86c8ecbc5f241ef9993Felix Gabriel Mance
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu Unless required by applicable law or agreed to in writing, software
80875f917d741946a39d0ec0b5721e46ba609823Till Mossakowski distributed under the License is distributed on an "AS IS" BASIS,
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
a604cbad8e2202147b5c6bb9f2e06ae61162d654Felix Gabriel Mance See the License for the specific language governing permissions and
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu limitations under the License.
be2439588008221e691321fdf4f75432cfb72878Felix Gabriel Mance-->
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu
fc05327b875b5723b6c17849b83477f29ec12c90Felix Gabriel Mance<modulesynopsis metafile="mod_cern_meta.xml.meta">
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu<name>mod_cern_meta</name>
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu<description>CERN httpd metafile semantics</description>
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu<status>Extension</status>
0dd6e7830de0887c9a12356447975a826b3b3db2Christian Maeder<sourcefile>mod_cern_meta.c</sourcefile>
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu<identifier>cern_meta_module</identifier>
e0f1794e365dd347e97b37d7d22b2fce27296fa1Christian Maeder
424860079d47bf490fa98d5d7498096a0447c569mcodescu<summary>
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu <p>Emulate the CERN HTTPD Meta file semantics. Meta files are HTTP
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu headers that can be output in addition to the normal range of
1a38107941725211e7c3f051f7a8f5e12199f03acmaeder headers for each file accessed. They appear rather like the
1a38107941725211e7c3f051f7a8f5e12199f03acmaeder Apache .asis files, and are able to provide a crude way of
32bbac77828be0233953f8fe476edb0a9585408dChristian Maeder influencing the Expires: header, as well as providing other
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu curiosities. There are many ways to manage meta information,
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu this one was chosen because there is already a large number of
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu CERN users who can exploit this module.</p>
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu <p>More information on the <a
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu href="http://www.w3.org/pub/WWW/Daemon/User/Config/General.html#MetaDir"
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu >CERN metafile semantics</a> is available.</p>
27fdf879983dd28e211b41f3be6c0e930b7c816bFelix Gabriel Mance</summary>
431571057e88a650a974adec93ea4bb5173b6213Felix Gabriel Mance
1a38107941725211e7c3f051f7a8f5e12199f03acmaeder<seealso><module>mod_headers</module></seealso>
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu<seealso><module>mod_asis</module></seealso>
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu<directivesynopsis>
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu<name>MetaFiles</name>
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu<description>Activates CERN meta-file processing</description>
b84c87f199dc287d235d7dad6ea344f6912ef531Christian Maeder<syntax>MetaFiles on|off</syntax>
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu<default>MetaFiles off</default>
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu<contextlist><context>server config</context>
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu<context>virtual host</context>
be00381168b3f10192afabbba136fb06d3a9f358Christian Maeder<context>directory</context>
be00381168b3f10192afabbba136fb06d3a9f358Christian Maeder<context>.htaccess</context></contextlist>
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu<override>Indexes</override>
27fdf879983dd28e211b41f3be6c0e930b7c816bFelix Gabriel Mance
7852de3551fc797566ee71165bafe05b6d81728cnotanartist<usage>
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu <p>Turns on/off Meta file processing on a per-directory basis.</p>
27fdf879983dd28e211b41f3be6c0e930b7c816bFelix Gabriel Mance</usage>
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu</directivesynopsis>
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu
27fdf879983dd28e211b41f3be6c0e930b7c816bFelix Gabriel Mance<directivesynopsis>
d0f58d27c2536eba454d8f77de8617bc6a2c99cdFelix Gabriel Mance<name>MetaDir</name>
d0f58d27c2536eba454d8f77de8617bc6a2c99cdFelix Gabriel Mance<description>Name of the directory to find CERN-style meta information
d0f58d27c2536eba454d8f77de8617bc6a2c99cdFelix Gabriel Mancefiles</description>
d0f58d27c2536eba454d8f77de8617bc6a2c99cdFelix Gabriel Mance<syntax>MetaDir <var>directory</var></syntax>
431571057e88a650a974adec93ea4bb5173b6213Felix Gabriel Mance<default>MetaDir .web</default>
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu<contextlist><context>server config</context>
27fdf879983dd28e211b41f3be6c0e930b7c816bFelix Gabriel Mance<context>virtual host</context>
424860079d47bf490fa98d5d7498096a0447c569mcodescu<context>directory</context>
60f30f0eeeacdfc1e0dfe39664373ddf5a0675adFelix Gabriel Mance<context>.htaccess</context></contextlist>
60f30f0eeeacdfc1e0dfe39664373ddf5a0675adFelix Gabriel Mance<override>Indexes</override>
0dd6e7830de0887c9a12356447975a826b3b3db2Christian Maeder
424860079d47bf490fa98d5d7498096a0447c569mcodescu<usage>
424860079d47bf490fa98d5d7498096a0447c569mcodescu <p>Specifies the name of the directory in which Apache can find
424860079d47bf490fa98d5d7498096a0447c569mcodescu meta information files. The directory is usually a 'hidden'
60f30f0eeeacdfc1e0dfe39664373ddf5a0675adFelix Gabriel Mance subdirectory of the directory that contains the file being
d6d81ead61a5f9fb7d047e623f7898e730c258camcodescu accessed. Set to "<code>.</code>" to look in the same directory
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu as the file:</p>
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu <highlight language="config">
60f30f0eeeacdfc1e0dfe39664373ddf5a0675adFelix Gabriel ManceMetaDir .
7852de3551fc797566ee71165bafe05b6d81728cnotanartist </highlight>
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu
60f30f0eeeacdfc1e0dfe39664373ddf5a0675adFelix Gabriel Mance <p>Or, to set it to a subdirectory of the directory containing the
9475501a6acf48434052d9e6f4a05ed6681eaaabFrancisc Nicolae Bungiu files:</p>
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu
7852de3551fc797566ee71165bafe05b6d81728cnotanartist <highlight language="config">
80875f917d741946a39d0ec0b5721e46ba609823Till MossakowskiMetaDir .meta
80875f917d741946a39d0ec0b5721e46ba609823Till Mossakowski </highlight>
424860079d47bf490fa98d5d7498096a0447c569mcodescu</usage>
0dd6e7830de0887c9a12356447975a826b3b3db2Christian Maeder</directivesynopsis>
0dd6e7830de0887c9a12356447975a826b3b3db2Christian Maeder
424860079d47bf490fa98d5d7498096a0447c569mcodescu<directivesynopsis>
0dd6e7830de0887c9a12356447975a826b3b3db2Christian Maeder<name>MetaSuffix</name>
0dd6e7830de0887c9a12356447975a826b3b3db2Christian Maeder<description>File name suffix for the file containing CERN-style
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiumeta information</description>
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu<syntax>MetaSuffix <var>suffix</var></syntax>
d0f58d27c2536eba454d8f77de8617bc6a2c99cdFelix Gabriel Mance<default>MetaSuffix .meta</default>
60f30f0eeeacdfc1e0dfe39664373ddf5a0675adFelix Gabriel Mance<contextlist><context>server config</context>
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu<context>virtual host</context>
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu<context>directory</context>
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu<context>.htaccess</context></contextlist>
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu<override>Indexes</override>
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu<usage>
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu <p>Specifies the file name suffix for the file containing the
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu meta information. For example, the default values for the two
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu directives will cause a request to
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu <code>DOCUMENT_ROOT/somedir/index.html</code> to look in
3d3889e0cefcdce9b3f43c53aaa201943ac2e895Jonathan von Schroeder <code>DOCUMENT_ROOT/somedir/.web/index.html.meta</code> and
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu will use its contents to generate additional MIME header
3d3889e0cefcdce9b3f43c53aaa201943ac2e895Jonathan von Schroeder information.</p>
3d3889e0cefcdce9b3f43c53aaa201943ac2e895Jonathan von Schroeder
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu <example><title>Example:</title>
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu <highlight language="config">
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu MetaSuffix .meta
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu </highlight>
3d3889e0cefcdce9b3f43c53aaa201943ac2e895Jonathan von Schroeder </example>
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu</usage>
31e9d2a02e15b7dbc157e0d3fb3b84f6c8666482Christian Maeder</directivesynopsis>
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu
ee93ea764a2b8189253e912c8447f9419033f6d4Francisc Nicolae Bungiu</modulesynopsis>
656f17ae9b7610ff2de1b6eedeeadea0c3bcdc8dChristian Maeder