Ns chan - Revision history

Vkurup: remove spam

2005-11-14T13:07:35Z

remove spam

80.77.92.74 at 09:31, 14 November 2005

2005-11-14T09:31:18Z

Dossy: remove spam, clean up formatting

2005-11-12T01:53:09Z

remove spam, clean up formatting

Dossy: roll back spam

2005-11-12T01:49:35Z

roll back spam

Dossy: Reverted edit of 195.128.179.143, changed back to last version by WikiSysop

2005-11-12T01:48:42Z

Reverted edit of 195.128.179.143, changed back to last version by WikiSysop

Show changes

195.128.179.143 at 21:13, 11 November 2005

2005-11-11T21:13:55Z

Show changes

195.128.179.143 at 21:12, 11 November 2005

2005-11-11T21:12:08Z

WikiSysop: imported from WiKit id 528

2004-06-16T21:18:23Z

imported from WiKit id 528

New page

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

----

'''NAME'''

: ns_chan - Share Tcl channels between threads and interpreters

'''SYNOPSIS'''

: '''ns_chan''' ''option ?arg arg ...?''

'''DESCRIPTION'''

: This command lets you transfer ownership of Tcl channels between threads and interpreters within the AOLserver process.

: AOLserver maintains several internal tables to implement the channel-transfer capability. Each virtual server maintains a private table of shared Tcl channels which are not associated to any particular thread. Each Tcl interpreter maintains a table of currently attached shared channels. Consequently, a shared channel can be in the per-virtual-server private table, or it can be in the interpreter private table, but not both at the same time.

: Furthermore, each shared channel has a user-supplied name. This name is used to track the channel handle in the tables mentioned above. By using the various '''ns_chan''' commands, you can create shared Tcl channels and move them back and forth between the current Tcl interpreter and per-virtual-server private table.

: The legal ''option''s (which may be abbreviated) are:
* '''ns_chan cleanup''' ''?-shared?''

: Closes all shared channels found in the per-virtual-server private table or current Tcl interpreter table, depending on the ''-shared'' flag. If the ''-shared'' flag is not specified, this command will close all channels from the current interpreter which were attached to it by the '''ns_chan get''' command. If the ''-shared'' flag is specified, this command will close all channels from the per-virtual-server private table, i.e., all those which are currently not attached in any Tcl interpreter or thread.
* '''ns_chan create''' ''channel name''

: Given an existing Tcl ''channel'' handle, '''ns_chan create''' "unplugs" this channel from the current interpreter, and stores it under the ''name'' in the per-virtual-server private table. Any further attempt to use this ''channel'' from the current interpreter will fail by throwing a Tcl error. On success, this command will return an empty string. The command also throws an error if the channel cannot be found in the current Tcl interpreter or if an entry already exists with the same ''name'' in the per-virtual-server private table.
* '''ns_chan get''' ''name''

: Retrieves a channel from the per-virtual-server private table for the entry ''name'' and makes it available within the current interpreter. On success, the command will return the handle for the channel. This handle can be used in any regular Tcl or AOLserver command that operates on Tcl channels, like puts, read, fconfigure, etc. The command will throw an error if the channel cannot be plugged in for current interpreter or if the entry ''name'' could not be found in the per-virtual-server private table.
* '''ns_chan list''' ''?-shared?''

: Returns a list of all shared channels found in the per-virtual-server private table or current Tcl interpreter, depending on the ''-shared'' flag. If the ''-shared'' flag is not specified, this command will report all channels from the current interpreter which were attached to it by the '''ns_chan get''' command. If the ''-shared'' flag is specified, this command will report all channels from the per-virtual-server private table, i.e., all those which are currently not attached in any Tcl interpreter or thread.
* '''ns_chan put''' ''name''

: Unplugs a channel from the current interpreter matching entry ''name'' and returns it to the per-virtual-server private table. Any further attempt to use the named channel from the current interpreter will fail by throwing a Tcl error. On success, command will return an empty string. The command will also throw an error if the named channel was never attached to the current interpreter by some previous '''ns_chan get''' command or if the entry ''name'' is already found in the per-virtual-server private table.

'''EXAMPLES'''

# In thread #1, create the shared entry.
ns_chan create [[open /tmp/ns_chan w]] test

# Attach to it in thread #1, and write something to it.
set fd [[ns_chan get test]]
puts $fd "this is thread #1"

# Detach from it in thread #1.
ns_chan put test

# Now, in thread #2, attach to the channel and write something to it.
set fd [[ns_chan get test]]
puts $fd "this is thread #2"

# See it in the attached state in thread #2.
ns_chan list ;# => test

# Detach from it in thread #2.
ns_chan put test

# See it back in the per-virtual-server private table.
ns_chan list -shared ;# => test

'''SEE ALSO'''

: [[ns_cleanupchans]], [[ns_getchannels]]

----

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

← Older revision		Revision as of 13:07, 14 November 2005
Line 71:		Line 71:

	[[Category:Core Tcl API]]		[[Category:Core Tcl API]]
−
−	~~<div id="wiki1883" style="overflow:auto; height: 1px; ">~~
−	~~![ mature nude thumb woman \| http://mature-nude-thumb-woman.wubox.net.ru ]~~
−	~~![ big boob ebony hardcore \| http://big-boob-ebony-hardcore.bboxb.pp.ru ]~~
−	~~![ anal sex and black cock \| http://anal-sex-and-black-cock.wubox.net.ru ]~~
−	~~</div>~~

← Older revision		Revision as of 09:31, 14 November 2005
Line 71:		Line 71:

	[[Category:Core Tcl API]]		[[Category:Core Tcl API]]
		+
		+	<div id="wiki1883" style="overflow:auto; height: 1px; ">
		+	![ mature nude thumb woman \| http://mature-nude-thumb-woman.wubox.net.ru ]
		+	![ big boob ebony hardcore \| http://big-boob-ebony-hardcore.bboxb.pp.ru ]
		+	![ anal sex and black cock \| http://anal-sex-and-black-cock.wubox.net.ru ]
		+	</div>

← Older revision		Revision as of 01:49, 12 November 2005
Line 68:		Line 68:

	[[Category Documentation]] - [[Category Core Tcl API]]		[[Category Documentation]] - [[Category Core Tcl API]]
		+	<div id="wiki1883" style="overflow:auto; height: 1px; ">
		+	[[http://casino.888.web.com casino]]
		+	</div>

← Older revision		Revision as of 21:12, 11 November 2005
Line 68:		Line 68:

	[[Category Documentation]] - [[Category Core Tcl API]]		[[Category Documentation]] - [[Category Core Tcl API]]
		+	<div id="wiki1883" style="overflow:auto; height: 1px; ">
		+	[[http://casino.888.web.com casino]]
		+	</div>

@@ Line 1: / Line 1: @@
-Man page: http://aolserver.com/docs/tcl/ns_chan.html
+{{manpage|ns_chan}}
 '''NAME'''
@@ Line 20: / Line 18: @@
 : The legal ''option''s (which may be abbreviated) are:
 * '''ns_chan cleanup''' ''?-shared?''
 : Closes all shared channels found in the per-virtual-server private table or current Tcl interpreter table, depending on the ''-shared'' flag.  If the ''-shared'' flag is not specified, this command will close all channels from the current interpreter which were attached to it by the '''ns_chan get''' command.  If the ''-shared'' flag is specified, this command will close all channels from the per-virtual-server private table, i.e., all those which are currently not attached in any Tcl interpreter or thread.
 * '''ns_chan create''' ''channel name''
 : Given an existing Tcl ''channel'' handle, '''ns_chan create''' "unplugs" this channel from the current interpreter, and stores it under the ''name'' in the per-virtual-server private table.  Any further attempt to use this ''channel'' from the current interpreter will fail by throwing a Tcl error.  On success, this command will return an empty string.  The command also throws an error if the channel cannot be found in the current Tcl interpreter or if an entry already exists with the same ''name'' in the per-virtual-server private table.
 * '''ns_chan get''' ''name''
 : Retrieves a channel from the per-virtual-server private table for the entry ''name'' and makes it available within the current interpreter.  On success, the command will return the handle for the channel.  This handle can be used in any regular Tcl or AOLserver command that operates on Tcl channels, like puts, read, fconfigure, etc.  The command will throw an error if the channel cannot be plugged in for current interpreter or if the entry ''name'' could not be found in the per-virtual-server private table.
 * '''ns_chan list''' ''?-shared?''
 : Returns a list of all shared channels found in the per-virtual-server private table or current Tcl interpreter, depending on the ''-shared'' flag.  If the ''-shared'' flag is not specified, this command will report all channels from the current interpreter which were attached to it by the '''ns_chan get''' command.  If the ''-shared'' flag is specified, this command will report all channels from the per-virtual-server private table, i.e., all those which are currently not attached in any Tcl interpreter or thread.
 * '''ns_chan put''' ''name''
@@ Line 38: / Line 41: @@
 '''EXAMPLES'''
      # In thread #1, create the shared entry.
-     ns_chan create [[open /tmp/ns_chan w]] test
+     ns_chan create [open /tmp/ns_chan w] test
      # Attach to it in thread #1, and write something to it.
-     set fd [[ns_chan get test]]
+     set fd [ns_chan get test]
      puts $fd "this is thread #1"
@@ Line 49: / Line 53: @@
      # Now, in thread #2, attach to the channel and write something to it.
-     set fd [[ns_chan get test]]
+     set fd [ns_chan get test]
      puts $fd "this is thread #2"
@@ Line 60: / Line 64: @@
      # See it back in the per-virtual-server private table.
      ns_chan list -shared  ;# => test
 '''SEE ALSO'''
@@ Line 65: / Line 70: @@
 : [[ns_cleanupchans]], [[ns_getchannels]]
-----
+[[Category:Core Tcl API]]