TRACE(1,C) AIX Commands Reference TRACE(1,C) ------------------------------------------------------------------------------- trace PURPOSE Starts the trace function. SYNTAX +-------------+ +- /etc/trcprofile -+ trace ---| +---------+ |---| |---| +-| -f |-+ +----- profile -----+ ^| -n num || || -o name || || -s size || |+---------+| +-----------+ DESCRIPTION The trace command starts the trace function in the background. This trace function provides a base for debugging the system. The trace command monitors the occurrence of selected events in the system and records on disk important data specific to each of these events. You can format this output with the trcrpt command. Any user or program that needs the trace process enabled for debugging or error determination can start the trace command. When starting trace, you must provide a profile. This allows you to tailor the output of the trace session to individual needs. The default profile is /etc/trcprofile. There may be more than one trace profile in the file system at a time. The trace profile contains the classes of events that you can select to trace, listed by event class and by a descriptive label. See "Example" for a sample profile. You may keep different profiles to trace different combinations of event classes. The trace command also takes additional information about the trace session from the configuration file /etc/rasconf (see AIX Operating System Technical Reference for a discussion of this file). You set the name and size of the output file in this configuration file. In a multiuser environment, the trace command records all system events, not just events at one virtual terminal. FLAGS -f Disables filtering action. If this flag is set, then the trace daemon's own activity will be logged. If this flag is not set (the default), then the trace daemon's activity will be filtered out from the report. Processed November 8, 1991 TRACE(1,C) 1 TRACE(1,C) AIX Commands Reference TRACE(1,C) -n num Specifies the number of entries a buffer will hold. -o name Specifies the name of the log file into which the trace demon stores the trace data. -s size Specifies the size (in words) of entries. EXAMPLE ***************************************************************************** * SYSTEM TRACE PROFILE ***************************************************************************** * To set trace on for an event class, remove the comment mark (*) from the * first column of the line containing the event you wish to trace. * Add a comment mark (*) in the first column of lines containing event types * you wish to stop tracing. ***** Event * Type Description ***** Applications ***** AIX Extensions * 36 Config ***** AIX System Calls * 60 Shared Memory * 61 Messages * 62 Semaphores * 63 Signals * 64 Time * 65 File system * 66 File Handling * 67 Directory Handling * 68 Process FILES /etc/trcprofile Default profile. /usr/adm/ras/trcfile Output file defined in /etc/rasconf. /etc/rasconf Configuration file. RELATED INFORMATION See the following commands: "trcstop" and "trcrpt." See the rasconf configuration file in AIX Operating System Technical Reference. See the discussion of trace in AIX Operating System Programming Tools and Interfaces. Processed November 8, 1991 TRACE(1,C) 2