t_error(3N) — svr4 — mips UMIPS RISC/os 5.01



TERROR(3N-SVR4)    RISC/os Reference Manual     TERROR(3N-SVR4)



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
     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 t_errno.  If t_errno is
     TSYSERR, terror 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");

     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.







                        Printed 11/19/92                   Page 1
Museum
