NAME

interpretTrace - converts binary ring buffer files to readable text format

SYNOPSIS

interpretTrace [-rrep] [-mmode] [-spid] [-ffile] [- ] [files...]

ARGUMENTS

[-rrep] Specifies the byte ordering used to represent unsigned longs in the binary ring buffer file. The rep argument is a series of hexadecimal digits. The number of digits indicates the word size. The first digit indicates the relative position of the least significant byte, with subsequent digits indicating the position of increasingly more significant bytes, as in -r3210 (SunOS® 4, RS/AIX 3.2, and HP-UX® 9.0 platforms) or -r01234567 (Alpha OSF/1 platform). This option can be used to format a ring buffer dump generated on a platform with a different unsigned long representation. 

[-mmode] Specifies the format mode of the output. The format mode controls the amount of information that is displayed. The default format mode displays the thread identifier, process identifier, timestamp, trace identifier, trace class abbreviation, and message. A format mode of 0 (zero) displays only the thread identifier, trace class abbreviation, and message. 

[-spid] Specifies the process identifier associated with a ring buffer file. This identifier is used to produce the name of the ring buffer file, as in EncinaTraceBuffer .pid, where pid is the process identifier. 

[-ffile] Specifies the name of an input file. 

[- ] Specifies the server’s standard input stream as an input file. By default, the standard input device is used as the input file with interpretTrace unless other filenames are specified on the command line. In that case, - (dash) can be used to specify the standard input device along with other filenames. 

[files...] Specifies one or more names of files to be used as input. Separate each filename with a space. 

DESCRIPTION

The interpretTrace program is used to convert binary ring buffer files into readable text format. By default, interpretTrace reads input from the server’s standard input stream and sends output to the server’s standard output stream. Command options can be used to specify input from other sources. The process identifier associated with a ring buffer dump can be specified by the -s option, or a filename can be specified by the -f option. Multiple filenames may also be specified. The - (dash) option can be used to specify the standard input device along with other filenames. The -m option allows a format mode for the output to be specified. Do not leave any space between options and their associated arguments. 

EXAMPLES

The following command specifies a process identifier, 3390, associated with a ring buffer dump file. The process identifier produces the filename EncinaTraceBuffer.3390, which is used as the input file. 

% interpretTrace -s3390

The following command specifies the filename EncinaTraceBuffer.3390, which is used as the input file:

% interpretTrace -fEncinaTraceBuffer.3390

The following command uses a - (dash) to specify the standard input device, ringbuffer.out, and EncinaTraceBuffer.3390, which are used as input files:

% interpretTrace - ringbuffer.out EncinaTraceBuffer.3390

OUTPUT

The following is an example of output using a format mode of 0:

1 >  ReadCMRuntimeRecords cmAd1.c tpm
1 >  cmFs_ReadyByKey cmFs.c tpm
1 E  Opened file mySfs/myCell_cellRuntime_v1_0.
1 >  ConsKey cmFs.c tpm
1 <  ConsKey cmFs.c tpm
1 >  ConsRecord cmFs.c tpm
1 <  ConsRecord cmFs.c tpm
1 >  monUtil_StatusToString monUtil.c tpm
1 <R monUtil_StatusToString monUtil.c tpm -> 4001bd18
1 <R cmFs_ReadByKey cmFs.c tpm -> 00000000
1 <R ReadCMRuntimeRecords cmAd1.c tpm -> 00000000

Note: The indentTrace program can be used to make this output more readable. See the reference page for the indentTrace program for more details. 

RELATED INFORMATION

indentTrace

  —  March 1997