ttsession(1)ttsession(1)NAMEttsession - The ToolTalk message server
SYNOPSISttsession [ -A max_active_msgs ] [ -a level ] [ -d display ]
[ -s ] [ -t ] [ -v ] [ -h ] [ -c [command] ]
DESCRIPTIONttsession 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 a user's initialization 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.
Differences from SunSoft ToolTalk:
The Classing Engine is NOT supported on SGI. By default, the message
server reads the Types Database information from the XDR formatted files
described below.
The des authentication option is NOT supported on SGI.
By default, if ToolTalk clients are running in a CASEVision/ClearCase
view, the ttsession will be started in the view and dedicated only to
processes in the view. This overrides the SunSoft default mechanism. If
the ToolTalk client is not running in a CASEVision/ClearCase view, it
connects to the ttsession in the same manner as in the SunSoft
implementation. See CASEVision/ClearCase for details on what it means to
be in a view.
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.
Page 1
ttsession(1)ttsession(1)-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.
-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
~/.tt/types.xdr User's ToolTalk XDR format types file
/etc/tt/types.xdr System ToolTalk XDR format types file
SEE ALSOtt_type_comp(1)
Page 2
