aw_perror(3TSOL)

NAME | SYNOPSIS | DESCRIPTION | ATTRIBUTES | SEE ALSO | NOTES

NAME

aw_strerror, aw_errno, aw_geterrno, aw_perror, aw_perror_r- Obtain and display error messages

SYNOPSIS

cc [flag...] file... -lbsm -lsocket -lnsl -lintl -ltsol [library...]


#include <bsm/auditwrite.h> 
int aw_errno

int aw_geterrno(int rd);
char *aw_strerror(const int status);
void aw_perror(const char *s);
void aw_perror_r(int rd, const char *s);

DESCRIPTION

aw_errno is a variable set by auditwrite(3TSOL) to indicate the type of error encountered during its execution, in much the same manner as errno(3C) is set during a system or library call. However, aw_errno cannot be accessed directly in an MT-safe way; in multithreaded environments, aw_geterrno() should be used instead. Supporting functions convert auditwrite(3TSOL) error numbers into text strings.

aw_geterrno() takes a record descriptor, rd, and returns the aw_errno value associated with that descriptor.

aw_strerror() takes a specified return value status and returns a pointer to a string constant that is the error string.

aw_perror() prints the error message corresponding to status as "s: error_message" to standard error. This interface is not MT-safe.

aw_perror_r() prints the error message corresponding to status associated with the specified record descriptor as "s: error_message".

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWcsu
MT-Level	MT-Safe with Exceptions

SEE ALSO

Trusted Solaris 8 4/01 Reference Manual

auditwrite(3TSOL)

SunOS 5.8 Reference Manual

errno(3C), perror(3C), strerror(3C), attributes(5)

NOTES

The functions aw_strerror(), aw_geterrno(), and aw_perror_r() are MT-Safe. The aw_errno global variable and the aw_perror() function are not MT-Safe.

The returned string must not be overwritten. If string manipulation is required, work on a local copy.

SunOS 5.8  Last Revised 3 Oct 2000

NAME | SYNOPSIS | DESCRIPTION | ATTRIBUTES | SEE ALSO | NOTES