DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 
(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.

See also

Intro(NET), netbuf(FP)

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) .


© 2003 Caldera International, Inc. All rights reserved.
SCO OpenServer Release 5.0.7 -- 11 February 2003