thread

Gets and sets thread properties

Format:

TV::thread 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. Do not use other arguments with this option.

get

Gets the values of one or more thread properties. The other-args argument can include one or more property names. The CLI returns these values in a list, and places them in the same order as the property names you entered.

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

properties

Lists an object's properties. Do not use other arguments with this option.

set

Sets the values of one or more properties. The other-args argument contains paired property names and values.

object-id

A thread ID. If you use the -all option, the operation is carried out on all threads in the current focus.

other-args

Arguments required by the get and set subcommands.

Description:

The TV::thread command lets you examine and set the thread properties and states. These states and properties are:

continuation_sig

The signal that should be passed to a thread the next time it runs. On some systems, the thread receiving the signal may not always be the one for which this property was set.

dpid

The ID of the process associated with a thread.

duid

The internal unique ID associated with the thread.

held

A value (either 1 or 0) indicating if the thread is held; 1 means that the thread is held. (settable)

id

The ID of the thread.

manager

A value (either 1 or 0) indicating if this is a system manger thread; 1 means that it is.

pc

Current PC at which the target is executing. (settable)

state

Current state of the target. See state_values for a list of states.

state_values

A list of values for the state property. These values are break, error, exited, running, stopped, and watch.

systid

The system thread ID.

Examples:

f p3 TV::thread get -all id

Returns a list of thread IDs for process 3. For example:

1.1 1.2 1.4