starttrace command

Purpose

Records selected system events.

Syntax

starttrace [ -event Event[, Event ] ...]

Description

The starttrace command starts the trace daemon that configures a trace session and starts the collection of system events. The data collected by the trace function is recorded in the trace log. A report from the trace log can be generated with the cattracerpt command.

Flags

Flag name Description
-event Event[,Event] Specifies the user-defined events for which you want to collect trace data. The Event list items must be separated by commas.
Note: The following events are used to determine the pid, the cpuid, and the exec path name in the cattracerpt report:
  • 106 DISPATCH
  • 10C DISPATCH IDLE PROCESS
  • 134 EXEC SYSTEM CALL
  • 139 FORK SYSTEM CALL
  • 465 KTHREAD CREATE
If any of these events is missing, the information reported by the cattracerpt command is incomplete. When using the -event flag, you must include all these events in the Event list.

Exit Status

See Exit status for Virtual I/O Server commands.

Examples

  1. To trace hook 234 and the hooks that allow you to see the process names, enter: 
    starttrace -event 234,106,10C,134,139,465

Related Information

The stoptrace command and the cattracerpt command.