elf_errmsg(3elf) 맨 페이지 - 윈디하나의 솔라나라

개요

섹션
맨 페이지 이름
검색(S)

elf_errmsg(3elf)

elf_errmsg(3ELF)             ELF Library Functions            elf_errmsg(3ELF)



NAME
       elf_errmsg, elf_errno - error handling

SYNOPSIS
       cc [ flag ... ] file ... -lelf [ library ... ]
       #include <libelf.h>

       const char *elf_errmsg(int err);


       int elf_errno(void);

DESCRIPTION
       If  an  ELF  library  function fails, a program can call elf_errno() 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 elf_errmsg() 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, elf_errmsg() returns a pointer to an appropriate mes‐
       sage. This function does not have  the  side  effect  of  clearing  the
       internal error number.

EXAMPLES
       Example 1 A sample program of calling the elf_errmsg() function.




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


         (void)elf_errno();
         /* processing ... */
         while (more_to_do)
         {
              if ((err = elf_errno()) != 0)
              {
                   /* print msg */
                   msg = elf_errmsg(err);
              }
         }


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       tab()  box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) ATTRIBUTE TYPEAT‐
       TRIBUTE VALUE _ Interface StabilityCommitted _ MT-LevelMT-Safe


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



Oracle Solaris 11.4               11 Jul 2001                 elf_errmsg(3ELF)
맨 페이지 내용의 저작권은 맨 페이지 작성자에게 있습니다.
RSS ATOM XHTML 5 CSS3