trc_logpath Subroutine

Purpose

Library

libtrace.a

Syntax

#include <sys/libtrace.h>

			char *trc_logpath(void)

Description

The trc_logpath subroutine returns the default trace logfile path name. This is normally /var/adm/ras/trcfile, unless changed with the trcctl command or SMIT. Any process that can access and link to the libtrace.a library can call the trc_logpath subroutine and retrieve the current path to the default trace file. With the addition of the trcctl command to the available administration options, system administrators can now set the default to any path rather than always having /var/adm/ras/trcfile as the hard-coded default. Trace Report trcrpt calls the library routines trc_open and trc_loginfo to access the trace file. Beginning with AIX® 5.3, trc_open and trc_loginfo both call trc_logpath to access the default file, if it is required. Calling trc_logpath is transparent to trcrpt and the Trace GUI; however, because trc_logpath is available and exported in libtrace.a, other components and third-party products can use it.

Return Values

The trc_logpath subroutine always returns a path name. The path name should be freed, free(path), by the user when appropriate.