    All Resources  All filters

# LoggingProp

This resource class provides access to Jigsaw logging properties. It allows you to change the logging properties of Jigsaw.

## Inherits

The LoggingProp class inherits from the following classes:

- PropertySet (aka abstract class)

## Attributes description

The HTTPResource defines the following attributes:

- w3c.jigsaw.logger
- w3c.jigsaw.logger.errlogname
- w3c.jigsaw.logger.logname
- w3c.jigsaw.logger.tracelogname
- w3c.jigsaw.logger.bufferSize

`w3c.jigsaw.logger`

semantics
  This property gives the name of the logger class to use. The logger class can be any class that implements the logger interface. Right now, the only implemented logger is the CommonLogger. If undefined, Jigsaw will not log any requests, and emit a warning at startup time.
type
  This attribute is a computed ClassAttribute
default value
  This attribute has no default values, which means that no logging will be performed unless you set it.

`w3c.jigsaw.logger.errlogname`

semantics
  This property should give the name of the error log file. The error log file is used when some abnormal situation is encoutered inside the server. Abnormal, here, means a situation that the server can't cope with (i.e., implementation bugs), rather than just HTTP errors (which are logged in the above log file).
  This file is also used by the server to trace important configuration actions.
type
  This attribute is a computed FileAttribute
default value
  If not defined, this property defaults to <w3c.jigsaw.root>/logs/errlog

`w3c.jigsaw.logger.logname`

semantics
  This property should give the name of the log file to which the logging record will be emited. Note that this property is a property of the CommonLogger (and any of its subclasses), rather than a property of the logging system as a whole.
type
  This attribute is a computed FileAttribute
default value
  If not defined, this property defaults to <w3c.jigsaw.root>/logs/log

`w3c.jigsaw.logger.tracelogname`

semantics
  This property should provide the name of the trace log. The trace log is used to output debugging information when the server is turned into debug mode. To turn the server into debug mode, two properties have to be turned to true (depending on what part of the server you want to debug):
  w3c.jigsaw.trace
    Make the core server emit traces.
  w3c.jigsaw.client.debug
    Make every clients emit traces.
type
  This attribute is a computed FileAttribute
default value
  If not defined, this property defaults to <w3c.jigsaw.root>/logs/tracelog

`w3c.jigsaw.logger.bufferSize`

semantics
  The size of the log buffer to use. This property defines the size of the buffer used before flushing the output log. It is highly recommended to keep this value at least as high as it is. You may still, however, set it to 0 in order to prevent any buffering of log writing.
type
  This attribute is a computed IntegerAttribute
default value
  This attribute defaults to 4096.

Anselm Baird-Smith
$Id: w3c.jigsaw.http.LoggingProp.html,v 1.1 1996/09/11 21:44:16 abaird Exp $