Tornado API Reference : WTX Tcl Library

wtxtclUtil [Tcl]

NAME

wtxtclUtil [Tcl] - WTX Tcl utilities

TCL PROCEDURES

wtxCpuInfoGet - explore target data base resource file to retrieve info
wtxInfoQ - return a list of existing servers
wtxUnregister - remove an entry from the Tornado registry
wtxRegister - add an entry to the Tornado registry
bindNamesToList - create variables in the caller that are bound to list values
wtxToolIdGet - return the tool identifier of the current tool

DESCRIPTION

This library contains all the WTX Tcl related utilities.

SEE ALSO

wtxtclUtil


WTX Tcl Library : Tcl Procedures

wtxCpuInfoGet

NAME

wtxCpuInfoGet - explore target data base resource file to retrieve info

LOCALE

WTX Tcl

SYNOPSIS

wtxUnregister [options] cpuNum

PARAMETERS

cpuNum - CPU number to get information on

OPTIONS

-a : returns only target architecture directory
  -d : returns target demangler
  -l : returns target symbol's leading character
  -n : returns target CPU name

DESCRIPTION

This command gets target CPU related information located in target architecture data base file.

SEE ALSO

wtxtclUtil, wtxtcl, wtxTsInfoGet


WTX Tcl Library : Tcl Procedures

wtxInfoQ

NAME

wtxInfoQ - return a list of existing servers

LOCALE

WTX Tcl

SYNOPSIS

wtxInfoQ [namePat [typePat [keyPat]]]

DESCRIPTION

wtxInfoQ queries the list of servers maintained by the Tornado target server registry, wtxregd. Each entry in the registry is a triple containing the name of the server, its type, and the communication key. The three pattern arguments are regular expressions that can be used to qualify the search. Patterns that are not specified will match any registry entry. If more than one pattern is specified, candidate entries must match both patterns.

RETURNS

A list of three-element lists, each of the form {name type key}.

EXAMPLE

The following command will list all target servers known to the registry:

tcl> wtxInfoQ .* tgtsvr
{julia@aven tgtsvr rpc/aven/147.11.80.6/570425351/1/tcp}
{irene@aven tgtsvr rpc/aven/147.11.80.6/570425346/1/tcp}
{lily@aven tgtsvr rpc/aven/147.11.80.6/570425347/1/tcp}

SEE ALSO

wtxtclUtil, wtxtcl, wtxToolAttach


WTX Tcl Library : Tcl Procedures

wtxUnregister

NAME

wtxUnregister - remove an entry from the Tornado registry

LOCALE

WTX Tcl

SYNOPSIS

wtxUnregister name

DESCRIPTION

This command removes the entry in the Tornado registry corresponding to name. Ordinarily, this command is not needed, as Tornado servers take care of registering and unregistering themselves if they exit normally.

SEE ALSO

wtxtclUtil, wtxtcl, wtxInfoQ


WTX Tcl Library : Tcl Procedures

wtxRegister

NAME

wtxRegister - add an entry to the Tornado registry

LOCALE

WTX Tcl

SYNOPSIS

wtxRegister name type key

DESCRIPTION

This command adds an entry, consisting of the given name, type, and key, to the Tornado registry. This command is only useful for programs that provide servers for the Tornado tool set.

SEE ALSO

wtxtclUtil, wtxtcl, wtxInfoQ


WTX Tcl Library : Tcl Procedures

bindNamesToList

NAME

bindNamesToList - create variables in the caller that are bound to list values

LOCALE

WTX Tcl

SYNOPSIS

bindNamesToList nameList valList

DESCRIPTION

This function can be used to assign names to list elements. For example, the following call will set the variables a, b, and c in the procedure scope with the values 10, 11, and 12, respectively:

    bindNamesToList {a b c} {10 11 12}
If there are more names than values, excess names will be given the value 0. If there are more values than names, excess values are ignored.

PARAMETERS

RETURNS

Standard Tcl return.

ERRORS

NONE

SEE ALSO

wtxtclUtil, wtxtcl


WTX Tcl Library : Tcl Procedures

wtxToolIdGet

NAME

wtxToolIdGet - return the tool identifier of the current tool

LOCALE

WTX Tcl

SYNOPSIS

wtxToolIdGet

RETURNS

The tool identifier of the current tool.

SEE ALSO

wtxtclUtil, wtxtcl, wtxToolName