Netscape ENTERPRISE SERVER 6.1, Manual

Page: 254 / 373

Init SAFs
254 Netscape Enterprise Server NSAPI Programmer’s Guide • April 2002 (Draft)
See Also
send-cgi, send-wincgi, send-shellcgi
init-clf
Applicable in
Init
-class directives.
The
init-clf
function opens the named log files to be used for common logging.
The
common-log
function writes entries into the log files during the
AddLog
stage of
the request handling process. The log files stay open until the server is shut down
(at which time the log files are closed) or restarted (at which time the log files are
closed and reopened).
If you move, remove, or change the log file without shutting down or restarting the
server, client accesses might not be recorded. To save or backup a log file, you need
to rename the file (and for UNIX, send the
-HUP
signal) and then restart the server.
The server first looks for the log file by name, and if it doesn’t find it, creates a new
one (the renamed original log file is left for you to use).
For information on rotating log files, see
flex-rotate-init
.
Parameters
NOTE If the server has an AddLog stage directive that calls
common-log
,
common log files must be initialized by
init-clf
during
initialization.
NOTE This function should only be called once. If it is called again, the
new call will replace log file names from all previous calls.
logFileName The name of the parameter is the name of the log file. The
value of the parameter specifies either the full path to the log
file or a file name relative to the server’s
logs
directory. For
example:
access="/usr/netscape/servers/https-servernam
e/logs/access"
mylogfile = "log1"
You will use the log file name later, as a parameter to the
common-log
function.