trcevgrp Command

Purpose

Manipulates trace event groups.

Syntax

List event groups

trcevgrp -l [ event-group [ ... ] ]

Remove event groups

trcevgrp -r [ event-group [ ... ] ]

Add an event group

trcevgrp -a -d "group-description" -h "hook-list" event-group

Update an event group

trcevgrp -u [ -d "group-description" ] [ -h "hook-list" ] event-group ]

Description

The trcevgrp command is used to maintain the trace event groups. You must be in the system group to add, delete, or change trace event groups. You cannot modify or delete event groups whose type is reserved.

In AIX® version older than AIX 6.1, you can specify only three-digit hook IDs. In AIX 6.1 or later, you can specify four-digit hook IDs.

Flags

Item Description
-a [ -d group-description | -h hook-list ] Creates a new event group. Only one event group name can be specified. Both -d description and -h hook-list must be specified when using the -a flag. If either -d or -h is not specified, an error is produced.
-d group-description Designates the hook description. A description is required for all new groups.
-h hook-list The hook list consists of trace hook IDs. The -h flag is required when using the -a flag. When updating an event group (-u flag), the hook-list, if specified, must contain all hook IDs for the group. List parameter items can be separated by commas or enclosed in double quotation marks and separated by commas or blanks.
-l event-group

The specified groups are listed to standard output. If no event group is specified, all are listed. The format of the listing is as follows:

group name - group-description (type) "hook list"

The following examples shows the listing of the group:
  • * -l tidhk - Hooks needed to display thread name (reserved)
    "106,10C,134,139,465"
  • * -l gka - GENERAL KERNEL ACTIVITY (files,execs,dispatches) (reserved)
    "106,10C,134,139,465,107,135,15b,12e,116,117,200,20E,20F" 
  • * -l mydriver - My Driver (files,execs,dispatches) (reserved)
    "106,1AB1,0AC0" 
-r event-group Removes the specified event-groups.
-u [ -d "group-description" | -h "hook-list" ] event-group Used to update the information for an event-group. Either -d description or -h hook-list must be specified.

Security

Attention RBAC users and Trusted AIX users: This command can perform privileged operations. Only privileged users can run privileged operations. For more information about authorizations and privileges, see Privileged Command Database in AIX Version 7.1 Security. For a list of privileges and the authorizations associated with this command, see the lssecattr command or the getcmdattr subcommand.

Examples

  1. To get a listing of all event groups, enter the following command:
    trcevgrp -l
  2. To add a new group, enter the following command:
    trcevgrp -a -d "my group description" -h "500,501,502" mygrp

    This will add the group called mygrp, give it the description my group description, and will have hooks of 500, 501, and 502.

  3. To add another hook to mygrp, enter the following command:
    trcevgrp -u -d "my group description" -h "500,501,502,503" mygrp
    Note: You must specify all of the hook IDs.

    Files the event groups are currently kept in the SWserveAt ODM database.