t_error(3N) — Dell System V Release 4 Issue 2.2



t_error(3N)       UNIX System V(Networking Support Utilities)       t_error(3N)


NAME
      terror - 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 terrno.  If terrno is TSYSERR, terror will also print the
      standard error message for the current value contained in errno [see
      intro(2)].

      terrlist is the array of message strings, to allow user message
      formatting.  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 ``tconnect 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
      Programmer's Guide:  Networking Interfaces






10/89                                                                    Page 1
Museum
