thread

Gets and sets thread properties

Format

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

Arguments

action

The action to perform, as follows:

commands

Displays the subcommands that you can use. The CLI responds by displaying these four action subcommands. 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 names you enter.

If you use the -all option instead of 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 examines the following thread properties and states:

canonical_executable_name

The absolute file name of the program being debugged. If you had entered a relative name, TotalView find this absolute name.

continue_sig

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

current_ap_id

The ID of the action point at which the current thread is stopped.

dpid

The ID of the process associated with a thread.

duid

The internal unique ID associated with the thread.

held

A Boolean 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 Boolean value (either 1 or 0) indicating if this is a system manger thread. (1 means that it is a system manager thread.)

pc

The current PC at which the target is executing. (settable)

sp

The value of the stack pointer.

state

The current state of the target. See state_values for a list of states.

state_values

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

stop_reason_message

The reason why the current thread is stopped; for example, Stop Signal.

systid

The system thread ID.

target_architecture

The machine architecture upon which the current thread is executing.

target_byte_ordering

The bit ordering of the current machine. This is either little_endian or big_endian.

target_processor

The kind of processor upon which the current thread is executing. For example, this could be x86-64.

thread_ktid

The kernel thread ID.

thread_name

The name given to a thread by the application.

thread_utid

A user 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

 

proc set_signal {val} {

TV::thread set \

[f t TV::focus_threads] continue_sig $val

}

Sets the starting signal for the focus thread.

proc show-_signal {} {

foreach th [TV::focus_threads] {

puts "Continue_sig ($th): \

[TV::thread get $th continue_sig]";

}

}

Shows all starting signals.

Related Topics

Groups in TotalView

TV::focus_threads

TV::group

TV::process