diff options
author | Joshua Slive <slive@apache.org> | 2002-03-09 18:31:23 +0000 |
---|---|---|
committer | Joshua Slive <slive@apache.org> | 2002-03-09 18:31:23 +0000 |
commit | 2c8b203d042a286f1d72ff7f22c8bf60801dc0e0 (patch) | |
tree | e214d33d2b13b67c3bf0687a67346c6e15557a1d /docs/manual/mod/mod_usertrack.html | |
parent | adad84a7cebea4c2cc818a7e71365e49e9b89723 (diff) | |
download | httpd-2c8b203d042a286f1d72ff7f22c8bf60801dc0e0.tar.gz |
Update transformations.
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@93815 13f79535-47bb-0310-9956-ffa450edef68
Diffstat (limited to 'docs/manual/mod/mod_usertrack.html')
-rw-r--r-- | docs/manual/mod/mod_usertrack.html | 167 |
1 files changed, 29 insertions, 138 deletions
diff --git a/docs/manual/mod/mod_usertrack.html b/docs/manual/mod/mod_usertrack.html index 22d46b3cfe..5e94c5c117 100644 --- a/docs/manual/mod/mod_usertrack.html +++ b/docs/manual/mod/mod_usertrack.html @@ -1,34 +1,11 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - -<html xmlns="http://www.w3.org/1999/xhtml"> - <head> - <meta name="generator" content="HTML Tidy, see www.w3.org" /> - - <title>Apache module mod_usertrack</title> - </head> - <!-- Background white, links blue (unvisited), navy (visited), red (active) --> - - <body bgcolor="#FFFFFF" text="#000000" link="#0000FF" - vlink="#000080" alink="#FF0000"> - <!--#include virtual="header.html" --> - - <h1 align="CENTER">Module mod_usertrack</h1> - - <p>This module uses cookies to provide for a - <em>clickstream</em> log of user activity on a site.</p> - - <p><a href="module-dict.html#Status" - rel="Help"><strong>Status:</strong></a> Extension<br /> - <a href="module-dict.html#SourceFile" - rel="Help"><strong>Source File:</strong></a> - mod_usertrack.c<br /> - <a href="module-dict.html#ModuleIdentifier" - rel="Help"><strong>Module Identifier:</strong></a> - usertrack_module<br /> - <a href="module-dict.html#Compatibility" - rel="Help"><strong>Compatibility:</strong></a> Known as - mod_cookies prior to Apache 1.3.</p> +<html xmlns="http://www.w3.org/TR/xhtml1/strict"><head><!-- +XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT +XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX +--><title>mod_usertrack - Apache HTTP Server</title><link href="../style/manual.css" type="text/css" rel="stylesheet"/></head><body><blockquote><div align="center"><img alt="[APACHE DOCUMENTATION]" src="../images/sub.gif"/><h3>Apache HTTP Server Version 2.0</h3></div><h1 align="center">Apache Module mod_usertrack</h1><table cellspacing="1" cellpadding="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td valign="top"><span class="help">Description:</span></td><td><description> + This module uses cookies to provide for a + <em>clickstream</em> log of user activity on a site. +</description></td></tr><tr><td><a href="module-dict.html#Status" class="help">Status:</a></td><td>Extension</td></tr><tr><td><a href="module-dict.html#ModuleIdentifier" class="help">Module Identifier:</a></td><td>usertrack_module</td></tr><tr><td align="left" valign="top"><a href="module-dict.html#Compatibility" class="help">Compatibility:</a></td><td><compatibility>Known as mod_cookies prior to Apache 1.3.</compatibility></td></tr></table></td></tr></table><h2>Summary</h2><summary> <h2>Summary</h2> @@ -38,22 +15,8 @@ Apache 1.2 and later this module has been renamed the "user tracking" module, mod_usertrack. This module has been simplified and new directives added.</p> +</summary><h2>Directives</h2><ul><li><a href="#cookiedomain">CookieDomain</a></li><li><a href="#cookieexpires">CookieExpires</a></li><li><a href="#cookiename">CookieName</a></li><li><a href="#cookiestyle">CookieStyle</a></li><li><a href="#cookietracking">CookieTracking</a></li></ul><h2>Logging</h2> - <h2>Directives</h2> - - <ul> - <li><a href="#cookiedomain">CookieDomain</a></li> - - <li><a href="#cookieexpires">CookieExpires</a></li> - - <li><a href="#cookiename">CookieName</a></li> - - <li><a href="#cookiestyle">CookieStyle</a></li> - - <li><a href="#cookietracking">CookieTracking</a></li> - </ul> - - <h2>Logging</h2> <p>Previously, the cookies module (now the user tracking module) did its own logging, using the <tt>CookieLog</tt> @@ -63,15 +26,17 @@ now allows multiple log files. The cookie itself is logged by using the text <tt>%{cookie}n</tt> in the log file format. For example:</p> -<pre> +<blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><code> CustomLog logs/clickstream "%{cookie}n %r %t" -</pre> - For backward compatibility the configurable log module +</code></td></tr></table></blockquote> + + <p>For backward compatibility the configurable log module implements the old <tt>CookieLog</tt> directive, but this - should be upgraded to the above <tt>CustomLog</tt> directive. + should be upgraded to the above <tt>CustomLog</tt> directive. </p> +<h2>2-digit or 4-digit dates for cookies?</h2> + - <h2>2-digit or 4-digit dates for cookies?</h2> - (the following is from message + <p>(the following is from message <022701bda43d$9d32bbb0$1201a8c0@christian.office.sane.com> in the new-httpd archives) <pre> @@ -106,19 +71,9 @@ form, but also understands 4-digit years, which can probably reach up until 9999. Your best bet for sending a long-life cookie is to send it for some time late in the year "37". </pre> - <hr /> - - <h2><a id="cookiedomain" name="cookiedomain">CookieDomain</a> - directive</h2> - <a href="directive-dict.html#Syntax" - rel="Help"><b>Syntax:</b></a> CookieDomain <i>domain</i><br /> - <a href="directive-dict.html#Context" - rel="Help"><b>Context:</b></a> server config, virtual host, - directory, .htaccess<br /> - <a href="directive-dict.html#Status" - rel="Help"><b>Status:</b></a> optional<br /> - <a href="directive-dict.html#Module" - rel="Help"><b>Module:</b></a> mod_usertrack +</p> +<hr/><h2><a name="CookieDomain">CookieDomain</a> <a name="cookiedomain">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td><strong>Description: </strong></td><td>controls the setting of the domain to which + the tracking cookie applies.</td></tr><tr><td><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td><syntax>CookieDomain <i>domain</i></syntax></td></tr><tr><td><a href="directive-dict.html#Default" class="help">Default:</a></td><td><code>None</code></td></tr><tr><td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config, virtual host, directory, .htaccess</td></tr><tr><td><a href="directive-dict.html#Status" class="help">Status:</a></td><td>Extension</td></tr><tr><td><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mod_usertrack</td></tr></table></td></tr></table><usage> <p>This directive controls the setting of the domain to which the tracking cookie applies. If not present, no domain is @@ -127,23 +82,8 @@ time late in the year "37". <p>The domain string <b>must</b> begin with a dot, and <b>must</b> include at least one embedded dot. That is, ".foo.com" is legal, but "foo.bar.com" and ".com" are not.</p> - <hr /> - - <h2><a id="cookieexpires" - name="cookieexpires">CookieExpires</a> directive</h2> - <a href="directive-dict.html#Syntax" - rel="Help"><strong>Syntax:</strong></a> CookieExpires - <em>expiry-period</em><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Context:</strong></a> <b>1.3.20 and - earlier:</b> server config, virtual host; <b>1.3.21 and - later:</b> server config, virtual host, directory, - .htaccess<br /> - <a href="directive-dict.html#Status" - rel="Help"><strong>Status:</strong></a> optional<br /> - <a href="directive-dict.html#Module" - rel="Help"><strong>Module:</strong></a> mod_usertrack - +</usage><hr/><h2><a name="CookieExpires">CookieExpires</a> <a name="cookieexpires">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td><strong>Description: </strong></td><td/></tr><tr><td><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td><syntax>CookieExpires <em>expiry-period</em></syntax></td></tr><tr><td><a href="directive-dict.html#Default" class="help">Default:</a></td><td><code/></td></tr><tr><td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config, virtual host, directory, .htaccess</td></tr><tr><td><a href="directive-dict.html#Override" class="help">Override:</a></td><td/></tr><tr><td><a href="directive-dict.html#Status" class="help">Status:</a></td><td>Extension</td></tr><tr><td><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mod_usertrack</td></tr><tr><td align="left" valign="top"><a href="directive-dict.html#Compatibility" class="help">Compatibility:</a></td><td>In 1.3.20 and earlier, not usable in directory and +.htaccess</td></tr></table></td></tr></table><usage> <p>When used, this directive sets an expiry time on the cookie generated by the usertrack module. The <em>expiry-period</em> can be given either as a number of seconds, or in the format @@ -154,26 +94,7 @@ time late in the year "37". <p>If this directive is not used, cookies last only for the current browser session.</p> - <hr /> - - <h2><a id="cookiename" name="cookiename">CookieName</a> - directive</h2> - <a href="directive-dict.html#Syntax" - rel="Help"><strong>Syntax:</strong></a> CookieName - <em>token</em> <br /> - <a href="directive-dict.html#Default" - rel="Help"><strong>Default:</strong></a> <em>Apache</em> <br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Context:</strong></a> server config, virtual - host, directory, .htaccess<br /> - <a href="directive-dict.html#Status" - rel="Help"><strong>Status:</strong></a> optional<br /> - <a href="directive-dict.html#Module" - rel="Help"><strong>Module:</strong></a> mod_usertrack <br /> - <a href="directive-dict.html#Compatibility" - rel="Help"><strong>Compatibility:</strong></a> Apache 1.3.7 and - later - +</usage><hr/><h2><a name="CookieName">CookieName</a> <a name="cookiename">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td><strong>Description: </strong></td><td/></tr><tr><td><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td><syntax>CookieName <em>token</em></syntax></td></tr><tr><td><a href="directive-dict.html#Default" class="help">Default:</a></td><td><code>Apache</code></td></tr><tr><td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config, virtual host, directory, .htaccess</td></tr><tr><td><a href="directive-dict.html#Status" class="help">Status:</a></td><td>Extension</td></tr><tr><td><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mod_usertrack</td></tr></table></td></tr></table><usage> <p>This directive allows you to change the name of the cookie this module uses for its tracking purposes. By default the cookie is named "<code>Apache</code>".</p> @@ -181,21 +102,9 @@ time late in the year "37". <p>You must specify a valid cookie name; results are unpredictable if you use a name containing unusual characters. Valid characters include A-Z, a-z, 0-9, "_", and "-".</p> - <hr /> - - <h2><a id="cookiestyle" name="cookiestyle">CookieStyle</a> - directive</h2> - <a href="directive-dict.html#Syntax" - rel="Help"><b>Syntax:</b></a> CookieStyle - <i>Netscape|Cookie|Cookie2|RFC2109|RFC2965</i><br /> - <a href="directive-dict.html#Context" - rel="Help"><b>Context:</b></a> server config, virtual host, - directory, .htaccess<br /> - <a href="directive-dict.html#Status" - rel="Help"><b>Status:</b></a> optional<br /> - <a href="directive-dict.html#Module" - rel="Help"><b>Module:</b></a> mod_usertrack - +</usage><hr/><h2><a name="CookieStyle">CookieStyle</a> <a name="cookiestyle">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td><strong>Description: </strong></td><td>Controls the format of the cookie header + field</td></tr><tr><td><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td><syntax>CookieStyle + <i>Netscape|Cookie|Cookie2|RFC2109|RFC2965</i></syntax></td></tr><tr><td><a href="directive-dict.html#Default" class="help">Default:</a></td><td><code/></td></tr><tr><td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config, virtual host, directory, .htaccess</td></tr><tr><td><a href="directive-dict.html#Status" class="help">Status:</a></td><td>Extension</td></tr><tr><td><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mod_usertrack</td></tr></table></td></tr></table><usage> <p>This directive controls the format of the cookie header field. The three formats allowed are:</p> @@ -214,30 +123,12 @@ time late in the year "37". <p>Not all clients can understand all of these formats. but you should use the newest one that is generally acceptable to your users' browsers.</p> - <hr /> - - <h2><a id="cookietracking" - name="cookietracking">CookieTracking</a> directive</h2> - <a href="directive-dict.html#Syntax" - rel="Help"><strong>Syntax:</strong></a> CookieTracking - on|off<br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Context:</strong></a> server config, virtual - host, directory, .htaccess<br /> - <a href="directive-dict.html#Override" - rel="Help"><strong>Override:</strong></a> FileInfo<br /> - <a href="directive-dict.html#Status" - rel="Help"><strong>Status:</strong></a> optional<br /> - <a href="directive-dict.html#Module" - rel="Help"><strong>Module:</strong></a> mod_usertrack - +</usage><hr/><h2><a name="CookieTracking">CookieTracking</a> <a name="cookietracking">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td><strong>Description: </strong></td><td/></tr><tr><td><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td><syntax>CookieTracking on|off</syntax></td></tr><tr><td><a href="directive-dict.html#Default" class="help">Default:</a></td><td><code/></td></tr><tr><td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config, virtual host, directory, .htaccess</td></tr><tr><td><a href="directive-dict.html#Override" class="help">Override:</a></td><td>FileInfo</td></tr><tr><td><a href="directive-dict.html#Status" class="help">Status:</a></td><td>Extension</td></tr><tr><td><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mod_usertrack</td></tr></table></td></tr></table><usage> <p>When the user track module is compiled in, and "CookieTracking on" is set, Apache will start sending a user-tracking cookie for all new requests. This directive can be used to turn this behavior on or off on a per-server or per-directory basis. By default, compiling mod_usertrack will - not activate cookies. <!--#include virtual="footer.html" --> - </p> - </body> -</html> + not activate cookies. </p> +</usage><hr/><h3 align="center">Apache HTTP Server Version 2.0</h3><a href="./"><img alt="Index" src="../images/index.gif"/></a><a href="../"><img alt="Home" src="../images/home.gif"/></a></blockquote></body></html>
\ No newline at end of file |