T_ERROR(3N) (Networking Support Utilities) T_ERROR(3N)
NAME
t_error - produce error message
SYNOPSIS
#include <tiuser.h>
void terror(errmsg)
char *errmsg;
extern int terrno;
extern char *terrlist[];
extern int tnerr;
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 intro(2)].
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.
EXAMPLE
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");
Page 1 May 1989
T_ERROR(3N) (Networking Support Utilities) T_ERROR(3N)
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
Network Programmer's Guide, Vol. 1.
Page 2 May 1989