tttracefile(4)

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 1
ops Get∗ Set∗
sender_ptypes Dt∗

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

version 1; follow on; states none

Museum

Related Articles