group

Sets and gets group properties

Format

TV::group 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 additional arguments with this subcommand.

get

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

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

properties

Displays the properties that the CLI can access. Do not use additional arguments with this option.

set

Sets the values of one or more properties. The other-args argument is a sequence of property name and value pairs.

object-id

The group ID. If you use the -all option, TotalView executes this operation on all groups in the current focus.

other-args

Arguments required by the get and set subcommands.

Description

The TV::group command lets you examine and set the following group properties and states:

actionpoint_count

The number of shared action points planted in the group. This is only valid for share groups and shared action points that are associated with the share group containing the process, rather than with the process itself.

When you obtain the results of this read-only value, the number may not look correct as this number also includes “magic breakpoints”. These are breakpoints that TotalView sets behind the scene; they are not usually visible. In addition, these magic breakpoints seldom appear when you use the dactions command.

canonical_execution_name

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

count

The number of members in a group.

executable

Like canonical_execution_name, this is the absolute file name of the program being debugged. It differs in that it contains symbolic links and the like that exist for the program.

id

The ID of the object.

member_type

The type of the group’s members, either process or thread.

member_type_values

A list of all possible values for the member_type property. For all groups, this is a two-item list with the first being the number of proess groups and the second being the number of thread groups. In many ways, this is related to the type_values property, which is a list values the type property may take.

members

A list of a group’s processes or threads.

type

The group’s type. Possible values are control, lockstep, share, user, and workers.

type_values

A list of all possible values for the type property.

Examples

TV::group get 1 count

Returns the number of objects in group 1.

Related Topics

dfocus

dworker

TV::focus_processes

TV::focus_threads

TV::process

TV::thread

Groups in TotalView