STRERROR

NAME

strerror, strerror_r - return string describing error code

SYNOPSIS

#include <string.h>

char *strerror(int errnum);


int strerror_r(int errnum, char *buf, size_t n);

DESCRIPTION

The fBstrerror()fP function returns a string describing the error code passed in the argument fIerrnumfP, possibly using the LC_MESSAGES part of the current locale to select the appropriate language. This string must not be modified by the application, but may be modified by a subsequent call to fBperror()fP or fBstrerror()fP. No library function will modify this string.

The fBstrerror_r()fP function is similar to fBstrerror()fP, but is thread safe. It returns the string in the user-supplied buffer buf of length n.

RETURN VALUE

The fBstrerror()fP function returns the appropriate error description string, or an unknown error message if the error code is unknown. The value of fIerrnofP is not changed for a successful call, and is set to a nonzero value upon error. The fBstrerror_r()fP function returns 0 on success and -1 on failure, setting fIerrnofP.

ERRORS

EINVAL: The value of errnum is not a valid error number.
ERANGE: Insufficient storage was supplied to contain the error description string.

CONFORMING TO

SVID 3, POSIX, BSD 4.3, ISO/IEC 9899:1990 (C89).
strerror_r() with prototype as given above is specified by SUSv3, and was in use under Digital Unix and HP Unix. An incompatible function, with prototype

char *strerror_r(int errnum, char *buf, size_t n);

is a GNU extension used by glibc (since 2.0), and must be regarded as obsolete in view of SUSv3. The GNU version may, but need not, use the user-supplied buffer. If it does, the result may be truncated in case the supplied buffer is too small. The result is always NUL-terminated.