Ns ictl

From AOLserver Wiki
Revision as of 21:14, 21 May 2008 by Tigre (talk | contribs) (ns_ictl cancel, as reported by Nathan Folkman on the AOLserver list, 2006-06-23)
Jump to navigation Jump to search

Man page: http://aolserver.com/docs/tcl/ns_ictl.html


NAME

ns_ictl - Manipulate and introspect Tcl interpreter internals

SYNOPSIS

ns_ictl option ?arg arg ...?

DESCRIPTION

This command provides a mechanism to control Tcl interpreter internals.
The legal options (which may be abbreviated) are:
  • ns_ictl addmodule module
Adds a module to the list of modules, and returns the new list as the result.
This command simply appends the module to the list. It doesn't perform any loading of modules themselves.
  • ns_ictl cancel threadId
Sends an asynchronous interrupt request to the specified thread, canceling any script currently executing on any AOLserver created interpreter (note the interrupt is not virtual-server specific).

This command utilizes the facilities of Tcl_AsyncMark() to mark as ready a callback registered with Tcl_AsyncCreate(). The callback places an error message in the interpreter result and returns TCL_ERROR to unwind the call stack. The underlying Tcl facility has limitations, e.g., the interrupt will only be noticed when Tcl checks via Tcl_AsyncReady() calls between commands and the interrupt can be caught with a "catch" command. See the man page for Tcl_AsyncCreate() for details.


  • ns_ictl cleanup
Runs all of the cleanup traces, and does any other necessary interpreter cleanup.
  • ns_ictl epoch
Returns the current epoch for the interpreter.
  • ns_ictl get
Returns the script that is executed at interpreter initialization time.
  • ns_ictl getmodules
Returns a list of currently loaded modules.
  • ns_ictl save script
Replaces the current interpreter initialization script with the new script.
  • ns_ictl update
Update the state (procs, namespaces) of an interpreter.
  • ns_ictl oncreate script
Registers a script to be executed at Tcl interpreter create time.
  • ns_ictl oncleanup script
Registers a script to be executed at Tcl interpreter cleanup time.
  • ns_ictl oninit script
Registers a script to be executed at Tcl interpreter init time. This can only be used during server initialization phase of server startup.
  • ns_ictl ondelete script
Registers a script to be executed at Tcl interpreter delete time.

EXAMPLES

   % ns_ictl epoch
   1
   % ns_ictl getmodules
   nsdb nslog nscp

SEE ALSO

ns_cleanup, ns_init, ns_markfordelete

Category Documentation - Category Core Tcl API