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