trc_perror Subroutine

Purpose

Prints all errors associated with a trace log object.

Library

libtrace.a

Syntax

#include <sys/libtrace.h>

void trc_perror (handle, rv, str)
void *handle;
int rv;
char *str;

Description

The trc_perror subroutine works like the perror subroutine. If the error in the rv parameter is an error from the errno.h file, it behaves exactly like the perror subroutine.

If there are multiple errors associated with the handle, the trc_perror subroutine prints all errors associated with the object. If the str parameter is NULL, the error's text is the only text printed. Errors are printed to standard error.

Parameters

Item	Description
handle	Contains the handle returned from the call to the trc_open subroutine, the trc_logpos_t object returned by the call to the trc_loginfo subroutine,or NULL. If a handle returned by the trc_open subroutine is passed, the trc_open subroutine need not have been successful, and the TRC_RETAIN_HANDLE option must have been used.
rv	The return value from a libtrace subroutine.
str	Used the same as the string passed to the perror subroutine. Errors printed by the trc_perror subroutine are printed as `str: error-message`.