Index objects commands are applicable to all experiments. An index object list is a list of objects for whom an index can be computed from the recorded data. Index objects are predefined for Threads, CPUs, Samples, and Seconds, among others. You can get the full list with the indxobj_list command. You can define other index objects with the indxobj_define command.
The following commands control the index-object lists.
Write the list of the index objects that match the given type, along with their metrics. Metrics and sorting for index objects is the same as those for the function list, but containing exclusive metrics only. The name indxobj-type can also be used directly as the command.
Write the list of known types of index objects, as used for indxobj-type in the indxobj command. Index objects are predefined for Threads, CPUs, Samples, and Seconds, among others.
Define a new type of index object with a mapping of packets to the object given by the index-exp. The syntax of the expression is described in Expression Grammar.
The indxobj-type must not already be defined. Its name is case-insensitive, must be entirely composed of alphanumeric characters or the ’_’ character, and begin with an alphabetic character.
The index-exp must be syntactically correct, or an error is returned and the definition is ignored. If the index-exp contains any blanks, it must be surrounded by double quotes (“).
The <Unknown> index object has an index of -1, and the expression used to define a new index object should support recognizing <Unknown>.
For example, for index objects based on virtual or physical PC, the expression should be of the following form: