Ns info
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
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 (Tcl has to be built with thrdalloc, AOLserver has to be built with USE_THREAD_ALLOC. Works in Tcl 8.4.x. Does not work in Tcl 8.5.0 or 8.5.1, works again in Tcl 8.5.2 and later. Normally, disabled in Windows but is known to work at least with Tcl 8.5.5 or later if re-enabled in the sources and re-compiled.)
- ns_info scheduled
- returns a list of all scheduled tasks in the current process (all virtual servers). Each list element is itself a 9-element list of {id, flags, interval, nextqueue, lastqueue, laststart, lastend, procname, arg}:
- id - unique id returned by the scheduling command
- flags - Bitmap of one or more of:
- 1 -- NS_SCHED_THREAD
- 2 -- NS_SCHED_ONCE
- 4 -- NS_SCHED_DAILY
- 8 -- NS_SCHED_WEEKLY
- 16 - NS_SCHED_PAUSED
- 32 - NS_SCHED_RUNNING
- interval - interval specification (i.e. seconds from midnight for daily schedule)
- nextqueue - Next time to queue for run
- lastqueue - Last time queued for run
- laststart - Last time run started
- lastend - Last time run finished
- procname - for tasks scheduled with ns_schedule_proc this will be ns:tclschedproc and arg will be the actual scheduled tcl script.
- arg - client data
- Example:
- {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 in the current process (all virtual servers). Each list element is itself a 7-element list of {name, parent, id, flag, ctime, procname, arg}:
- name - current name of the thread
- parent - parent thread name
- id - id of the thread
- flag - 1 if this is a detached thread, 0 otherwise
- ctime - Thread creation time
- procname - for conn threads this will be ns:connthread
- arg - client data - for a running conn thread arg will be a 7-element list in the format returned by ns_server all - {conn id, peeraddr, state, method, url, running time, bytes sent}, where state is either "running" or "queued":
- {-default:3- -nssock:driver- 15480 0 1254437214 ns:connthread {3536 192.168.0.1 running GET /_stats 0.15624 0}}
- Note that running time is returned in seconds.microseconds format which is misleading because 0.100 does not mean a tenth of a second, it means 100 microseconds.
- 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
-