ns_log

Overview

Write messages to the error log

Syntax

ns_log severity message

Description

While the AOLserver is running it logs various events from Notices to Fatal errors. Usually the AOLserver is running in the background, in which case these messages are placed in the server log. In absence of an ServerLog key in the AOLserver nsd.ini file, this file is the /log/error.log under the AOLserver installation directory. When the AOLserver is running in the foreground the messages are redirected to stderr.

ns_log writes the message to the server error log file. Allowable values for severity are:

Notice	Something interesting occurred.
Warning	Something that could mean something bad occurred.
Error	Something bad occurred.
Fatal	Something extremely bad occurred. The server will shut down after logging the message.
Bug	Something occurred that implies that there is a bug in the code.
Debug	If the server is in Debug mode, the message is printed. Debug mode is specified in the [ns/parameters] section of the configuration file. Otherwise, the message is not printed.

Example

This is an excerpt from an AOLserver error.log:

    [12/Jul/1995:18:10:13 -0700][1103] Notice: starting servers.

See Also

Ns_Log(), Ns_LogRaw() (C API)

nsd.ini (AOLserver Configuration File)