ELF Library Functions                            elferrmsg(3ELF)



NAME
     elferrmsg, elferrno - error handling

SYNOPSIS
     cc [ flag ... ] file ... -lelf [ library ... ]
     #include 

     const char *elferrmsg(int err);


     int elferrno(void);


DESCRIPTION
     If an  ELF  library  function  fails,  a  program  can  call
     elferrno() to retrieve the library's internal error number.
     As a side effect, this function resets  the  internal  error
     number to 0, which indicates no error.


     The elferrmsg() function takes an error  number,  err,  and
     returns  a  null-terminated  error message (with no trailing
     new-line) that describes the problem. A zero err retrieves a
     message for the most recent error. If no error has occurred,
     the return value is a null pointer (not  a  pointer  to  the
     null string). Using err of -1 also retrieves the most recent
     error, except it guarantees a non-null  return  value,  even
     when  no  error has occurred. If no message is available for
     the given number,  elferrmsg()  returns  a  pointer  to  an
     appropriate  message.  This  function does not have the side
     effect of clearing the internal error number.

EXAMPLES
     Example 1 A sample program of calling the elferrmsg() func-
     tion.


     The following fragment clears the internal error number  and
     checks it later for errors. Unless an error occurs after the
     first call to elferrno(), the next call will return 0.


       (void)elferrno();
       /* processing ... */
       while (moretodo)
       {
            if ((err = elferrno()) != 0)
            {
                 /* print msg */
                 msg = elferrmsg(err);
            }
       }



SunOS 5.11          Last change: 11 Jul 2001                    1






ELF Library Functions                            elferrmsg(3ELF)



ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Stable                      
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     elf(3ELF), libelf(3LIB), attributes(5)






































SunOS 5.11          Last change: 11 Jul 2001                    2