Index for Section 4

Alphabetical listing for T

Bottom of page

tttracefile(4)
CDE
NAME
  tttracefile - script of settings for ToolTalk tracing

SYNOPSIS
  tttracefile

DESCRIPTION
  A tttrace script contains settings that control ToolTalk calls and
  messages. A tttrace script consists of commands separated by semicolons or
  newlines. The first command must be the version command.

  Commands

  If conflicting values are given for a setting, the last value wins.

  version n
      The version of the tttracefile command syntax used.  The current
      version is 1.

  follow [off | on]
      Sets whether to follow all children forked by the traced client or
      subsequently started in the traced session.  Default is off.

  [> | >>] outfile
      File to be used for the trace output.  By default, trace output goes to
      standard error.  Normal sh(1) interpretation of > and >> applies.

  functions [all | none | func...]
      ToolTalk API functions to trace. func may include sh(1) wildcard
      characters. Default is all.

  attributes [all | none]
      none means use only a single line when printing a message on the trace
      output. all means print all attributes, arguments, and context slots of
      traced messages.
       Default is none.

  states [none | edge | deliver | dispatch | Tt_state]...
      State(s) through which to trace messages.	 In addition to the Tt_states
      defined in tt_c.h, valid states are:

  none
      disable all message tracing

  edge
      messages entering initial (TT_SENT) and final (TT_HANDLED, TT_FAILED)
      states.

  deliver
      all state changes and all client deliveries.

  dispatch
      deliver + all patterns considered for matching.  (default)

  ops toTrace...

  sender_ptypes toTrace...

  handler_ptypes toTrace...
      Trace messages that have toTrace as a value for the indicated message
      attribute. toTrace may include sh(1) wildcard characters. If no toTrace
      argument is included for a given message attribute, then no value of
      that attribute excludes a message from tracing.

  Comments

  A word beginning with # causes that word and all the following characters
  up to a newline to be ignored.

EXAMPLES
  To trace all attribute-getting and -setting messages sent by ptype starting
  with "Dt",

  version 1ops Get* Set*sender_ptypes Dt*

  To trace only ToolTalk function calls (but not messages) in a process tree,

  version 1; follow on; states none

SEE ALSO
  ttsession(1), tttrace(1), the Session_Trace() ToolTalk request

Index for Section 4

Alphabetical listing for T

Top of page