Ns info

From AOLserver Wiki
Revision as of 01:35, 4 October 2009 by Akhassin (talk | contribs)
Jump to navigation Jump to search

Man page: http://aolserver.com/man/4.0/tcl/ns_info.html


NAME

ns_info - Return information about various aspects of the running AOLserver

SYNOPSIS

ns_info option ?arg arg ...?

DESCRIPTION

This command provides information about the current state of the running AOLserver. The legal options (which may be abbreviated) are:
  • ns_info address
returns the primary IP address of this machine, or "0.0.0.0" if unable to determine
  • ns_info argv0
returns the currently running nsd binary as launched and prior to normalizing path
  • ns_info boottime
returns the time in epoch seconds since the current server was started
  • ns_info builddate
returns the date and time at which the current server was compiled, e.g.: "Jul 20 2004 at 14:57:20"
  • ns_info callbacks
returns a list of all registered startup, pre-startup, shutdown, server shutdown, exit, and SIGHUP signal procs (e.g. scripts registered for SIGHUP with ns_atsignal). Each list element is itself a 3-element list like this:
{shutdown logclose d:/AOLserver/servers/server1/modules/nslog/access1.log}
  • ns_info config
returns the absolute path to the config file used to start the server
  • ns_info home
returns the current working directory of the server
  • ns_info hostname
returns the value of gethostname(), or "localhost" if that fails
  • ns_info label
returns the value of NSD_LABEL from nsd.h, e.g. "aolserver4_0"
  • ns_info locks
lists the mutexes that currently exist. A 5-element list is returned for each mutex: mutex name, {}, unique id, lock counter, busy counter
  • ns_info log
returns the name of the error log specified by the "serverlog" parameter in the "ns/parameters" section, or "server.log" if not defined. Prepends the server's current working directory
  • ns_info major
returns the value of NS_MAJOR_VERSION from ns.h, e.g. "4"
  • ns_info minor
returns the value of NS_MINOR_VERSION from ns.h, e.g. "0"
  • ns_info name
returns the value of NSD_NAME from nsd.h (currently 'AOLserver')
  • ns_info nsd
returns the absolute path to the currently running nsd binary
  • ns_info pageroot
returns the absolute path to the page root
  • ns_info patchlevel
returns the value of NS_PATCH_LEVEL from ns.h, e.g. "4.0.7"
  • ns_info pid
returns the process ID of the current nsd process
  • ns_info platform
returns the name of the current platform, or "?" if unable to determine
  • ns_info pools
returns the results of Tcl_GetMemoryInfo() function if exported by the Tcl build
  • ns_info scheduled
returns a list of all scheduled tasks in the current virtual server. Each list element is itself a list like this:
{4 4 10800 1254650400 1254564000 1254564000 1254564004 logroll d:/AOLserver/servers/dncscrub1/modules/nslog/access.log}
  • ns_info server
returns the name of the current virtual server. During the bootstrap process, when processing the config file, ns_info server returns the value of the -s parameter in AOLserver builds after 2004-12-02.
  • ns_info servers
returns a list of virtual servers in the current nsd process
  • ns_info sockcallbacks
returns a list of all socket callbacks such as the socket listening callback for the nscp module. Each list element is itself a 4-element list like this:
{540 {read exit} nscp {127.0.0.1 9999}}
  • ns_info tag
returns the CVS tag (NSD_TAG from nsd.h); not guaranteed to be useful
  • ns_info tcllib
returns the path the virtual server's private tcl library - identical to [[[ns_library]] private]
  • ns_info threads
returns a list of all threads for the virtual server. Each list element is itself a list like this:
{-default:3- -nssock:driver- 15480 0 1254437214 ns:connthread {3536 192.168.0.1 running GET /_stats 0.15624 0}}
  • ns_info uptime
returns the number of seconds since the process started
  • ns_info version
returns the major.minor version string (i.e. 4.5)
  • ns_info winnt
returns 1 if the platform is Windows, 0 otherwise

EXAMPLES

SEE ALSO


-