Manual Pages for UNIX Operating System command usage for man strerror

Standard C Library Functions                         strerror(3C)



NAME
     strerror, strerror_r - get error message string

SYNOPSIS
     #include 

     char *strerror(int errnum);


     int strerror_r(int errnum, char *strerrbuf, size_t  buflen);


DESCRIPTION
     The strerror() function maps the error number in  errnum  to
     an  error  message  string,  and  returns  a pointer to that
     string.  It  uses  the  same  set  of  error   messages   as
     perror(3C). The returned string should not be overwritten.


     The strerror_r() function maps the error number in errnum to
     anerror  message string and returns the string in the buffer
     pointed to by strerrbuf with length buflen.

RETURN VALUES
     Upon successful completion, strerror() returns a pointer  to
     the  generated  message string. Otherwise, it sets errno and
     returns a pointer to an error message string. It returns the
     string  "Unknown  error"  if  errnum  is  not  a valid error
     number.


     Upon successful completion, strerror_r() returns 0.   Other-
     wise  it  sets errno and returns the value of errno to indi-
     cate the error. It returns the string "Unknown error" in the
     buffer  pointed  to  by  strerrbuf  if errnum is not a valid
     error number.

ERRORS
     These functions may fail if:

     EINVAL    The value of errnum is not a valid error number.



     The strerror_r() function may fail if:

     ERANGE    The buflen argument specifies insufficient storage
               to contain the generated message string.


USAGE




SunOS 5.11          Last change: 31 Mar 2005                    1






Standard C Library Functions                         strerror(3C)



     Messages returned from these functions  are  in  the  native
     language  specified  by the LC_MESSAGES locale category. See
     setlocale(3C).

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



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | Safe                        |
    |_____________________________|_____________________________|
    | Standard                    | See standards(5).           |
    |_____________________________|_____________________________|


SEE ALSO
     gettext(3C), perror(3C), setlocale(3C), attributes(5), stan-
     dards(5)































SunOS 5.11          Last change: 31 Mar 2005                    2