Ns ictl

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