VxWorks Reference Manual : Libraries

straceLib

NAME

straceLib - WindNet STREAMS message trace utility (STREAMS Option)

ROUTINES

strace( ) - print STREAMS trace messages (STREAMS Option)
straceStop( ) - stop the strace( ) task (STREAMS Option)

DESCRIPTION

This library consists of routines to support the strace utility. The strace utility is used to print to the trace file the trace output generated by STREAMS drivers and modules.

SEE ALSO

straceLib


Libraries : Routines

strace( )

NAME

strace( ) - print STREAMS trace messages (STREAMS Option)

SYNOPSIS

strace
    (
    char * arg
    )

DESCRIPTION

This routine, when invoked without arguments, writes all STREAMS event trace messages from all drivers and modules to a file named streams.log in the directory STREAMS_STRACE_OUTPUT_DIR. This directory constant is set in configAll.h. If the module name is provided to strace( ) then its output is sent to a file named module-id.log in the STREAMS_STRACE_OUTPUT_DIR directory.

These messages are obtained from the STREAMS log driver. If arguments are provided, they must be in triplets of the form mid, sid, and level, where mid is a STREAMS module ID number, sid is a sub-ID number, and level is a tracing priority level. Each triplet indicates that tracing messages are to be received from the specified module/driver, sub-ID (usually indicating minor device), and priority level equal to or less than the specified level. The token all can be used for any member to indicate no restriction for that attribute.

For additional information, see the WindNet STREAMS for Tornado Component Release Supplement.

RETURNS

N/A

WindNet STREAMS for Tornado Component Release Supplement.

SEE ALSO

straceLib


Libraries : Routines

straceStop( )

NAME

straceStop( ) - stop the strace( ) task (STREAMS Option)

SYNOPSIS


void straceStop ( void )

DESCRIPTION

This routine deletes the strace( ) task from the system and performs a cleanup operation. It removes the file descriptor associated with strace( ) and flushes any remaining trace-log messages from the log device to the strace( ) output file.

SEE ALSO

straceLib, strace( )

RETURNS

N/A