(TLI/XTI)

t_error(NET)

t_error -- produce error message

Syntax

TLI syntax

cc . . . -lnsl

#include <sys/tiuser.h>

void t_error (errmsg)
char *errmsg;
extern int t_errno;
extern char *t_errlist[];
extern int t_nerr;

XTI syntax

cc . . . -lxti

#include <xti.h>

void t_error (errmsg)
char *errmsg;
extern int t_errno;
extern char *t_errlist[];
extern int t_nerr;

Description

t_error produces a message on the standard error output which describes the last error encountered during a call to a transport function. The argument string errmsg is a user-supplied error message that gives context to the error.

t_error prints the user-supplied error message followed by a colon and the standard transport function error message for the current value contained in t_errno. If t_errno is TSYSERR, t_error will also print the standard error message for the current value contained in errno (see netbuf(FP)).

t_errlist is the array of message strings, to allow user message formatting. t_errno can be used as an index into this array to retrieve the error message string (without a terminating newline). t_nerr is the maximum index value for the t_errlist array.

t_errno is set when an error occurs and is not cleared on subsequent successful calls.

Examples

If a t_connect function fails on transport endpoint fd2 because a bad address was given, the following call might follow the failure:

   t_error("t_connect failed on fd2");

The diagnostic message would print as:

   t_connect failed on fd2:  Incorrect transport address format

where t_connect failed on fd2 tells the user which function failed on which transport endpoint, and Incorrect transport address format identifies the specific error that occurred.

Standards conformance

t_error is conformant with:

AT&T SVID Issue 3 ;
X/Open CAE Specification, Networking Services, Issue 4, 1994. ;
and Intel386 Binary Compatibility Specification, Edition 2 (iBCSe2) .