perror(3C)




NAME

     perror, errno - print system error messages


SYNOPSIS

     #include <stdio.h>

     void perror(const char *s);
     #include <errno.h>
     int errno;


DESCRIPTION

     The perror() function produces a  message  on  the  standard
     error  output  (file descriptor 2) describing the last error
     encountered during a call to a system or  library  function.
     The  argument string s is printed, followed by a colon and a
     blank, followed by the message and a NEWLINE character.   If
     s is a null pointer or points to a null string, the colon is
     not printed. The argument string should include the name  of
     the  program  that  incurred  the error. The error number is
     taken from the external variable errno, which  is  set  when
     errors  occur  but  not cleared when non-erroneous calls are
     made. See  intro(2).


USAGE

     If the application is  linked  with  -lintl,  then  messages
     printed from this function are in the native language speci-
     fied by the LC_MESSAGES locale category.  See setlocale(3C).


ATTRIBUTES

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

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe                     |
    |_____________________________|_____________________________|


SEE ALSO

     intro(2),    fmtmsg(3C),     gettext(3C),     setlocale(3C),
     strerror(3C), attributes(5)


Man(1) output converted with man2html