actionpoint

Sets and gets action point properties

Format:

TV::actionpoint action [ object-id ] [ other-args ]

Arguments:

action

The action to perform, as follows:

commands

Lists the subcommands that you can use. The CLI responds by displaying the four subcommands shown here. No other arguments are used with this subcommand.

get

Retrieves the values of one or more action point properties. other-args can include one or more property names. The CLI returns values for these properties in a list whose order is the same as the property names you entered.

If you use the -all option as the object-id, the CLI returns a list containing one (sublist) element for each object.

properties

Lists the action point properties that TotalView can access. No other arguments are used with this subcommand.

set

Sets the values of one or more properties. other-args contains property name and value pairs.

object-id

An identifier for the action point.

other-args

Are arguments that the get and set actions use.

Description:

The TV::actionpoint command lets you examine and set action point properties and states. These states and properties are:

address

The address of the action point.

enabled

A value (either 1 or 0) indicating if the action point is enabled. 1 means enabled. (settable)

expression

The expression to be executed at an action point. (settable)

id

The ID of the action point.

language

The language in which the action point expression is written.

length

The length in bytes of a watched area. This property is only valid for watchpoints. (settable)

line

The source line at which the action point is set. This is not valid for watchpoints.

satisfaction_group

The group that must arrive at a barrier for the barrier to be satisfied. (settable)

share

A value (either 1 or 0) indicating if the action point is active in the entire share group. 1 means that it is. (settable)

stop_when_done

Indicates what is stopped when a barrier is satisfied (in addition to the satisfaction set). Values are process, group, or none. (settable)

stop_when_hit

Indicates what is stopped when an action point is hit (in addition to the thread that hit the action point). Values are process, group, or none. (settable)

type

The object's type. See type_values for a list of possible types.

type_values

Lists values that can be assigned to the type property: break, eval, process_barrier, thread_barrier, and watch.

Examples:

TV::actionpoint set 5 share 1 enable 1

Shares and enables action point 5.

f p3 TV::actionpoint set -all enable 0

Disables all the action points in process 3.

foreach p [TV::actionpoint properties] {
    puts [format "%20s %s" $p: [TV::actionpoint get 1 $p]]

Dumps all the properties for action point 1.