ttsession(1)

NAME
     ttsession - The ToolTalk message server

SYNOPSIS
     ttsession [ -A max_active_msgs ] [ -a level ] [ -d display ]
     [ -s ] [ -t ] [ -v ] [ -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 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.
     -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 ALSO
     tt_type_comp(1)