ns_cport auth login password
ns_cport channel
ns_cport db ?pool?
ns_cport echo on | off
ns_cport exec command
ns_cport initcmds
ns_cport inputrc login
ns_cport isauth
ns_cport auth authenticates the specified login/password combination and returns an error if it is invalid.
ns_cport channel returns the name of the Tcl channel associated with the control port. For example:
proc get_name { } {
set channel [ns_cport channel]
puts $channel "Enter your name."
gets $channel username
puts $channel "Hello, $username"
}
|
The above example would then allow the following interaction over the control port:
server1> get_name Enter your name. George Hello, George server1> |
ns_cport db allows you to enter DB mode, meaning you can enter SQL commands instead of Tcl commands in the control port interface. If a pool is specified, the control port will begin interpreting commands as SQL commands. SQL commands must be terminated with a semicolon and may span more than one line. To exit DB mode and begin entering Tcl commands again, enter a semicolon by itself. If no pool is specified, a list of available database pools and their descriptions is displayed.
ns_cport echo turns echoing on or off. It is used only in conjunction with:
gets [ns_cport channel] |
ns_cport exec runs the specified command in the control port. For example:
ns_cport exec "tail -f log/server.log&" |
ns_cport initcmds returns the value of the InitCmds configuration file parameter.
ns_cport inputrc returns the path to the inputrc file for the specified username (login).
ns_cport isauth determines if the user has already logged into the control port. It returns 1 if the user is authorized and 0 if not.