Home Man
Search
Today's Posts
Register

Linux & Unix Commands - Search Man Pages

RedHat 9 (Linux i386) - man page for strerror (redhat section 3)

STRERROR(3)			    Linux Programmer's Manual			      STRERROR(3)

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  strerror() function returns a string describing the error code passed in the argument
       errnum, possibly using the LC_MESSAGES part of the current locale to select the	appropri-
       ate language.  This string must not be modified by the application, but may be modified by
       a subsequent call to perror() or strerror().  No library function will modify this string.

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

RETURN VALUE
       The  strerror()	function  returns the appropriate error description string, or an unknown
       error message if the error code is unknown.  The value of errno is not changed for a  suc-
       cessful call, and is set to a nonzero value upon error.	The strerror_r() function returns
       0 on success and -1 on failure, setting errno.

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.

SEE ALSO
       errno(3), perror(3), strsignal(3)

					    2001-10-16				      STRERROR(3)


All times are GMT -4. The time now is 05:12 PM.

Unix & Linux Forums Content Copyrightę1993-2018. All Rights Reserved.
UNIX.COM Login
Username:
Password:  
Show Password