t_error(3N) — Reliant UNIX 5.44c4

t_error(3N)                                                     t_error(3N)

NAME
     terror - produce error message

SYNOPSIS
     #include <sys/tiuser.h>

     void terror(char *errmsg);

     extern int terrno;
     extern char *terrlist[];
     extern int tnerr;

DESCRIPTION
     terror 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.

     terror prints the user-supplied error message followed by a colon and
     the standard transport function error message for the current value
     contained in terrno. If terrno is TSYSERR, terror will also print
     the standard error message for the current value contained in errno
     [see introprm2(2)].

     terrlist is the array of message strings, to allow user message for-
     matting. terrno can be used as an index into this array to retrieve
     the error message string (without a terminating newline). tnerr is
     the maximum index value for the terrlist array.

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

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

          terror("tconnect failed on fd2");

     The diagnostic message would print as:

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










Page 1                       Reliant UNIX 5.44                Printed 11/98
Museum
