mod_cern_meta.xml revision 6fbd2e53c97ea6976d93e0ac521adabc55e0fb73
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive<?xml version="1.0"?>
5220994f9c49c04a0d44d935b4fe0c81aaf63f95patrikj<!DOCTYPE modulesynopsis SYSTEM "/style/modulesynopsis.dtd">
e942c741056732f50da2074b36fe59805d370650slive<?xml-stylesheet type="text/xsl" href="/style/manual.en.xsl"?>
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd<!--
6fbd2e53c97ea6976d93e0ac521adabc55e0fb73nd Copyright 2002-2004 The Apache Software Foundation
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd Licensed under the Apache License, Version 2.0 (the "License");
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd you may not use this file except in compliance with the License.
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd You may obtain a copy of the License at
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd http://www.apache.org/licenses/LICENSE-2.0
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd Unless required by applicable law or agreed to in writing, software
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd distributed under the License is distributed on an "AS IS" BASIS,
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd See the License for the specific language governing permissions and
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd limitations under the License.
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd-->
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd
7db9f691a00ead175b03335457ca296a33ddf31bnd<modulesynopsis metafile="mod_cern_meta.xml.meta">
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive<name>mod_cern_meta</name>
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive<description>CERN httpd metafile semantics</description>
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive<status>Extension</status>
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive<sourcefile>mod_cern_meta.c</sourcefile>
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive<identifier>cern_meta_module</identifier>
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive<summary>
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive <p>Emulate the CERN HTTPD Meta file semantics. Meta files are HTTP
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive headers that can be output in addition to the normal range of
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive headers for each file accessed. They appear rather like the
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive Apache .asis files, and are able to provide a crude way of
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive influencing the Expires: header, as well as providing other
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive curiosities. There are many ways to manage meta information,
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive this one was chosen because there is already a large number of
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive CERN users who can exploit this module.</p>
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive <p>More information on the <a
26556019355f6e007335c2d5d57013ac24ebf651nd href="http://www.w3.org/pub/WWW/Daemon/User/Config/General.html#MetaDir"
26556019355f6e007335c2d5d57013ac24ebf651nd >CERN metafile semantics</a> is available.</p>
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive</summary>
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive
130852d0f5f810207a3a064d270c239ac52ae820slive<seealso><module>mod_headers</module></seealso>
130852d0f5f810207a3a064d270c239ac52ae820slive<seealso><module>mod_asis</module></seealso>
130852d0f5f810207a3a064d270c239ac52ae820slive
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive<directivesynopsis>
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive<name>MetaFiles</name>
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive<description>Activates CERN meta-file processing</description>
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive<syntax>MetaFiles on|off</syntax>
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive<default>MetaFiles off</default>
c5b5a33885b820315a9cc5c4f8e1bf760973fb6ekess<contextlist><context>server config</context>
c5b5a33885b820315a9cc5c4f8e1bf760973fb6ekess<context>virtual host</context>
c5b5a33885b820315a9cc5c4f8e1bf760973fb6ekess<context>directory</context>
c5b5a33885b820315a9cc5c4f8e1bf760973fb6ekess<context>.htaccess</context></contextlist>
c5b5a33885b820315a9cc5c4f8e1bf760973fb6ekess<override>Indexes</override>
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive<usage>
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive <p>Turns on/off Meta file processing on a per-directory basis.</p>
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive</usage>
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive</directivesynopsis>
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive<directivesynopsis>
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive<name>MetaDir</name>
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive<description>Name of the directory to find CERN-style meta information
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslivefiles</description>
26556019355f6e007335c2d5d57013ac24ebf651nd<syntax>MetaDir <var>directory</var></syntax>
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive<default>MetaDir .web</default>
c5b5a33885b820315a9cc5c4f8e1bf760973fb6ekess<contextlist><context>server config</context>
c5b5a33885b820315a9cc5c4f8e1bf760973fb6ekess<context>virtual host</context>
c5b5a33885b820315a9cc5c4f8e1bf760973fb6ekess<context>directory</context>
c5b5a33885b820315a9cc5c4f8e1bf760973fb6ekess<context>.htaccess</context></contextlist>
c5b5a33885b820315a9cc5c4f8e1bf760973fb6ekess<override>Indexes</override>
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive<usage>
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive <p>Specifies the name of the directory in which Apache can find
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive meta information files. The directory is usually a 'hidden'
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive subdirectory of the directory that contains the file being
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive accessed. Set to "<code>.</code>" to look in the same directory
d43535d2b691837e9c1e2f01e42b76aa0a1ab98frbowen as the file:</p>
d43535d2b691837e9c1e2f01e42b76aa0a1ab98frbowen
d43535d2b691837e9c1e2f01e42b76aa0a1ab98frbowen <example>MetaDir .</example>
d43535d2b691837e9c1e2f01e42b76aa0a1ab98frbowen
d43535d2b691837e9c1e2f01e42b76aa0a1ab98frbowen <p>Or, to set it to a subdirectory of the directory containing the
d43535d2b691837e9c1e2f01e42b76aa0a1ab98frbowen files:</p>
d43535d2b691837e9c1e2f01e42b76aa0a1ab98frbowen
d43535d2b691837e9c1e2f01e42b76aa0a1ab98frbowen <example>MetaDir .meta</example>
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive</usage>
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive</directivesynopsis>
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive<directivesynopsis>
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive<name>MetaSuffix</name>
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive<description>File name suffix for the file containg CERN-style
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslivemeta information</description>
26556019355f6e007335c2d5d57013ac24ebf651nd<syntax>MetaSuffix <var>suffix</var></syntax>
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive<default>MetaSuffix .meta</default>
c5b5a33885b820315a9cc5c4f8e1bf760973fb6ekess<contextlist><context>server config</context>
c5b5a33885b820315a9cc5c4f8e1bf760973fb6ekess<context>virtual host</context>
c5b5a33885b820315a9cc5c4f8e1bf760973fb6ekess<context>directory</context>
c5b5a33885b820315a9cc5c4f8e1bf760973fb6ekess<context>.htaccess</context></contextlist>
c5b5a33885b820315a9cc5c4f8e1bf760973fb6ekess<override>Indexes</override>
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive<usage>
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive <p>Specifies the file name suffix for the file containing the
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive meta information. For example, the default values for the two
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive directives will cause a request to
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive <code>DOCUMENT_ROOT/somedir/index.html</code> to look in
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive <code>DOCUMENT_ROOT/somedir/.web/index.html.meta</code> and
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive will use its contents to generate additional MIME header
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive information.</p>
98129254d031689860ebe954c86f2ddd91abf23brbowen
26556019355f6e007335c2d5d57013ac24ebf651nd <example><title>Example:</title>
26556019355f6e007335c2d5d57013ac24ebf651nd MetaSuffix .meta
26556019355f6e007335c2d5d57013ac24ebf651nd </example>
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive</usage>
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive</directivesynopsis>
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive
71bdd7b1bc7c725bfd109a40fe690e5cdee02c2aslive</modulesynopsis>