NAME

ttsession − the ToolTalk message server

SYNOPSIS

ttsession [ -A max_active_msgs ] [ -a level ] [ -d display ] [-s] [-t] [-v] [ - { E|X } ] [-h]
[ -c [command] ]

DESCRIPTION

ttsession is the ToolTalk message server.  This background process must be running before any messages can be sent or received.  Each message server defines a "session". 

The message server has no user interface and typically runs in the background, started either by the user’s .xinitrc file or automatically by any program which needs to send a message.  The message server reacts to two signals.  If it receives the USR1 signal, it toggles trace mode on or off (see the -t option below).  If it receives the USR2 signal, it rereads the types file. 

OPTIONS

−A max_active_msgs
Specify the maximum number of messages in-progress before a TT_ERR_OVERFLOW condition is returned. Default is 2000.

−a level
Set the server authentication level.  The level must be unix,xauth, or des.

-c [command] Starts a process tree session and runs the given command.  The special environment variable _SUN_TT_SESSION will be set to the name of this session.  Any process started with this variable in the environment will default to being in this session. If command is omitted the value of $SHELL is used instead. Everything after −c on the command line is taken as the command to be executed, so −c should be the last option.

−d display
Directs ttsession to start an X session for the given display.  Normally, ttsession uses the DISPLAY environment variable. 

−s Silent - don’t print any warning messages. 

−t Turn on trace mode.  Tracing is very helpful for seeing how messages are dispatched and delivered.  The output is very voluminous.  See the signals above for how to turn tracing on and off during execution. Tracing displays the state of a message when it is first seen by ttsession.  The lifetime of the message is then shown by showing the result of matching the message against type signatures (dispatch stage) and then showing the result of matching the message against any registered message patterns (delivery stage). Any attempt to send the message to a given process is also shown together with the success of that attempt. 

−v Print out the version number and exit. 

−E Read in the types from the Classing Engine database.  This option is the default. 

−X Read in the types from the alternate XDR format databases in $HOME/.tt/types.xdr and /etc/tt/types.xdr. 

−h Print help on invoking ttsession and exit. 

ENVIRONMENT

 
SUN_TTSESSION_CMD if set will be used by all ToolTalk clients as the command to use for auto-starting ttsession. 
 

FILES

$OPENWINHOME/lib/cetables/cetables
Classing Engine database containing the ToolTalk type definitions

~/.tt/types.xdr User’s ToolTalk XDR format types file

/etc/tt/types.xdr System ToolTalk XDR format types file

SEE ALSO

tt_type_comp(1)

SunOS 5.1  —  Last change: 21 May 1991