Adding JMCR-Stable version
[Benchmarks_CSolver.git] / JMCR-Stable / real-world application / jigsaw / WWW / User / Reference / w3c.jigsaw.http.LoggingProp.html
diff --git a/JMCR-Stable/real-world application/jigsaw/WWW/User/Reference/w3c.jigsaw.http.LoggingProp.html b/JMCR-Stable/real-world application/jigsaw/WWW/User/Reference/w3c.jigsaw.http.LoggingProp.html
new file mode 100644 (file)
index 0000000..a8121cf
--- /dev/null
@@ -0,0 +1,194 @@
+<HTML>\r
+<HEAD>\r
+  <!-- Created by GNNpress -->\r
+  <TITLE>LoggingProp reference manual</TITLE>\r
+<!-- Changed by: Anselm Baird-Smith,  4-Feb-1997 -->\r
+</HEAD>\r
+<BODY BGCOLOR="white">\r
+<A HREF="http://www.w3.org/pub/WWW/" TARGET="_top_">\r
+ <IMG SRC="/icons/WWW/w3c_home.gif"\r
+  ALT="W3C"\r
+  BORDER="0" WIDTH="72" HEIGHT="48"></A>\r
+<A HREF="http://www.w3.org/pub/WWW/Jigsaw/" TARGET="_top_">\r
+ <IMG SRC="/icons/jigsaw" ALT="Jigsaw" BORDER="0">\r
+</A>\r
+<HR>\r
+<A HREF="resources.html">All Resources</A>  \r
+<A HREF="filters.html">All filters </A>\r
+<HR>\r
+<H1>\r
+  LoggingProp\r
+</H1>\r
+<P>\r
+This resource class provides access to <B>Jigsaw</B> logging properties.\r
+It allows you to change the logging properties of <B>Jigsaw</B>.\r
+<P>\r
+<BR>\r
+  <HR>\r
+<H2>\r
+  Inherits\r
+</H2>\r
+<P>\r
+The <A HREF="../api/w3c.jigsaw.http.LoggingProp.html">LoggingProp</A> class\r
+inherits from the following classes:\r
+<UL>\r
+  <LI>\r
+    PropertySet (aka abstract class)\r
+</UL>\r
+<P>\r
+  <HR>\r
+<H2>\r
+  Attributes description\r
+</H2>\r
+<P>\r
+The HTTPResource defines the following attributes:\r
+<UL>\r
+  <LI>\r
+    <A HREF="#w3c.jigsaw.logger">w3c.jigsaw.logger</A>\r
+  <LI>\r
+    <A HREF="#w3c.jigsaw.logger.errlogname">w3c.jigsaw.logger.errlogname</A>\r
+  <LI>\r
+    <A HREF="#w3c.jigsaw.logger.logname">w3c.jigsaw.logger.logname</A>\r
+  <LI>\r
+    <A HREF="#w3c.jigsaw.logger.tracelogname">w3c.jigsaw.logger.tracelogname</A>\r
+  <LI>\r
+    <A HREF="#w3c.jigsaw.logger.bufferSize">w3c.jigsaw.logger.bufferSize</A>\r
+</UL>\r
+<P>\r
+  <HR>\r
+<P>\r
+<CODE><A NAME="w3c.jigsaw.logger">w3c.jigsaw.logger</A></CODE>\r
+<DL>\r
+  <DT>\r
+    <I>semantics</I>\r
+  <DD>\r
+    This property gives the name of the logger class to use. The logger class\r
+    can be any class that implements the\r
+    <A HREF="../api/w3c.jigsaw.http.Logger.html">logger interface</A>. Right\r
+    now, the only implemented logger is the\r
+    <A HREF="../api/w3c.jigsaw.http.CommonLogger.html">CommonLogger</A>. If\r
+    undefined, <B>Jigsaw</B> will <I>not</I> log any requests, and emit a warning\r
+    at startup time.\r
+  <DT>\r
+    <I>type</I>\r
+  <DD>\r
+    This attribute is a computed\r
+    <A HREF="../api/w3c.jigsaw.resources.ClassAttribute.html">ClassAttribute</A>\r
+  <DT>\r
+    <I>default value</I>\r
+  <DD>\r
+    This attribute has no default values, which means that <I>no logging</I>\r
+    will be performed unless you set it.\r
+</DL>\r
+<P>\r
+  <HR>\r
+<P>\r
+<CODE><A NAME="w3c.jigsaw.logger.errlogname">w3c.jigsaw.logger.errlogname</A></CODE>\r
+<DL>\r
+  <DT>\r
+    <I>semantics</I>\r
+  <DD>\r
+    This property should give the name of the error log file. The error log file\r
+    is used when some abnormal situation is encoutered inside the server. Abnormal,\r
+    here, means a situation that the server can't cope with (i.e., implementation\r
+    bugs), rather than just HTTP errors (which are logged in the above log\r
+    file).<BR>\r
+    This file is also used by the server to trace important configuration actions.\r
+  <DT>\r
+    <I>type</I>\r
+  <DD>\r
+    This attribute is a computed\r
+    <A HREF="../api/w3c.jigsaw.resources.FileAttribute.html">FileAttribute</A>\r
+  <DT>\r
+    <I>default value</I>\r
+  <DD>\r
+    If not defined, this property defaults to\r
+    <I>&lt;<A HREF="w3c.jigsaw.http.GeneralProp.html#w3c.jigsaw.root">w3c.jigsaw.root</A>&gt;</I>/logs/errlog\r
+</DL>\r
+<P>\r
+  <HR>\r
+<P>\r
+<CODE><A NAME="w3c.jigsaw.logger.logname">w3c.jigsaw.logger.logname</A></CODE>\r
+<DL>\r
+  <DT>\r
+    <I>semantics</I>\r
+  <DD>\r
+    This property should give the name of the log file to which the logging record\r
+    will be emited. Note that this property is a property of the CommonLogger\r
+    (and any of its subclasses), rather than a property of the logging system\r
+    as a whole.\r
+  <DT>\r
+    <I>type</I>\r
+  <DD>\r
+    This attribute is a computed\r
+    <A HREF="../api/w3c.jigsaw.resources.FileAttribute.html">FileAttribute</A>\r
+  <DT>\r
+    <I>default value</I>\r
+  <DD>\r
+    If not defined, this property defaults to\r
+    <I>&lt;<A HREF="w3c.jigsaw.http.GeneralProp.html#w3c.jigsaw.root">w3c.jigsaw.root</A>&gt;</I>/logs/log\r
+</DL>\r
+<P>\r
+  <HR>\r
+<P>\r
+<CODE><A NAME="w3c.jigsaw.logger.tracelogname">w3c.jigsaw.logger.tracelogname</A></CODE>\r
+<DL>\r
+  <DT>\r
+    <I>semantics</I>\r
+  <DD>\r
+    This property should provide the name of the trace log. The trace log is\r
+    used to output debugging information when the server is turned into debug\r
+    mode. To turn the server into debug mode, two properties have to be turned\r
+    to true (depending on what part of the server you want to debug):\r
+    <DL>\r
+      <DT>\r
+       <A HREF="w3c.jigsaw.http.GeneralProp.html#w3c.jigsaw.trace">w3c.jigsaw.trace</A>\r
+      <DD>\r
+       Make the core server emit traces.\r
+      <DT>\r
+       <A HREF="w3c.jigsaw.http.ConnectionProp.html#w3c.jigsaw.client.debug">w3c.jigsaw.client.debug</A>\r
+      <DD>\r
+       Make every clients emit traces.\r
+    </DL>\r
+  <DT>\r
+    <I>type</I>\r
+  <DD>\r
+    This attribute is a computed\r
+    <A HREF="../api/w3c.jigsaw.resources.FileAttribute.html">FileAttribute</A>\r
+  <DT>\r
+    <I>default value</I>\r
+  <DD>\r
+    If not defined, this property defaults to\r
+    <I>&lt;<A HREF="w3c.jigsaw.http.GeneralProp.html#w3c.jigsaw.root">w3c.jigsaw.root</A>&gt;</I>/logs/tracelog\r
+</DL>\r
+<P>\r
+  <HR>\r
+<P>\r
+<CODE><A NAME="w3c.jigsaw.logger.bufferSize">w3c.jigsaw.logger.bufferSize</A></CODE>\r
+<DL>\r
+  <DT>\r
+    <I>semantics</I>\r
+  <DD>\r
+    The size of the log buffer to use. This property defines the size of the\r
+    buffer used before flushing the output log. It is highly recommended to keep\r
+    this value at least as high as it is. You may still, however, set it to\r
+    <STRONG>0</STRONG> in order to prevent any buffering of log writing.\r
+  <DT>\r
+    <I>type</I>\r
+  <DD>\r
+    This attribute is a computed\r
+    <A HREF="../api/w3c.jigsaw.resources.IntegerAttribute.html">IntegerAttribute</A>\r
+  <DT>\r
+    <I>default value</I>\r
+  <DD>\r
+    This attribute defaults to <STRONG>4096</STRONG>.\r
+</DL>\r
+<P>\r
+  <HR>\r
+<I><A HREF="mailto:jigsaw@w3.org">Jigsaw Team</A><BR>\r
+</I>$Id: w3c.jigsaw.http.LoggingProp.html,v 1.1 1996/09/11 21:44:16 abaird\r
+Exp $\r
+<P>\r
+<P>\r
+<P>\r
+</BODY></HTML>\r