Ns eval - Revision history

Gustafn at 19:03, 7 February 2009

2009-02-07T19:03:53Z

Gustafn at 14:14, 31 January 2009

2009-01-31T14:14:56Z

64.119.133.99 at 20:40, 12 January 2006

2006-01-12T20:40:40Z

64.119.133.99 at 20:39, 12 January 2006

2006-01-12T20:39:10Z

64.119.133.99 at 20:37, 12 January 2006

2006-01-12T20:37:56Z

WikiSysop: imported from WiKit id 1306

2004-06-18T15:07:05Z

imported from WiKit id 1306

New page

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

----

'''NAME'''

: ns_eval - Evaluate tcl in multiple interpreters

'''SYNOPSIS'''

: '''ns_eval''' ''?-sync? ?-pending? ?args?''

'''DESCRIPTION'''

: This command causes ''args'' to be sourced as a script in all Tcl interpreters for the current virtual server. Normally, the '''ns_eval''' is asynchronous and the script isn't immediately evaluated in the other interpreters until their next atalloc event. If the ''-sync'' option is specified, '''ns_eval''' blocks until all servers have executed the script.

: The ''-pending'' flag, which cannot be specified with any other flags or ''args'', returns a list of the scritps still waiting to be evaluated in the various interpreters.

: '''NOTE:''' This command is currently implemented in Tcl, in the source file nsd/init.tcl.

'''EXAMPLES'''

# Set a global variable accessible from all interpreters
ns_eval set myGlobal 1

# Create a proc accessible from all interpreters, and wait
# for it to be define in all of them before returning
ns_eval -sync proc doSomething {args} { # do something }

# Get the list of pending scripts to be eval'd
ns_eval -pending

'''SEE ALSO'''

: [[ns_cleanup]], [[ns_ictl]], [[ns_init]], [[ns_markfordelete]], [[ns_reinit]]

----

[[Category Documentation]] - [[Category Core Tcl API]]

← Older revision		Revision as of 19:03, 7 February 2009
Line 46:		Line 46:
	----		----

−	[[Category Documentation]] - [[Category Core Tcl API]]	+	[[Category:Documentation]] - [[Category:Core Tcl API]]

@@ Line 20: / Line 20: @@
 : '''ns_eval''' is designed to work whether you pass your script as one argument or many arguments. In order to accomplish this, the arguments are passed through:
-<pre>uplevel 1 [eval concat $args]</pre>
+<pre>   uplevel 1 [eval concat $args]</pre>
 : which means that there are two rounds of '''concat''' behavior, unlike a straight '''eval'''.  See the example below of unsetting a global variable to see how this can play out.

@@ Line 21: / Line 21: @@
 : '''ns_eval''' is designed to work whether you pass your script as one argument or many arguments. In order to accomplish this, the arguments are passed through:
 <pre>uplevel 1 [eval concat $args]</pre>
-: which means that there are two rounds of '''concat''' behavior, unlike a straight '''eval'''.
+: which means that there are two rounds of '''concat''' behavior, unlike a straight '''eval'''.  See the example below of unsetting a global variable to see how this can play out.
 '''EXAMPLES'''

@@ Line 42: / Line 42: @@
 '''SEE ALSO'''
-: [[ns_cleanup]], [[ns_ictl]], [[ns_init]], [[ns_markfordelete]], [[ns_reinit]]
+: [[ns_cleanup]], [[ns_ictl]], [[ns_init]], [[ns_markfordelete]], [[ns_reinit]], [[nsproxy]]
 ----
 [[Category Documentation]] - [[Category Core Tcl API]]

@@ Line 18: / Line 18: @@
 : '''NOTE:''' This command is currently implemented in Tcl, in the source file nsd/init.tcl.
 '''EXAMPLES'''
@@ Line 30: / Line 34: @@
      # Get the list of pending scripts to be eval'd
      ns_eval -pending
 '''SEE ALSO'''