How to translate error number to 'errno' constant?
Suppose I have an application running on a UNIX box that is failing with a system error status of '13'. Now, I can easily look up this value in errno.h, to find out that it is a permission-denied problem.
> grep -w 13 /usr/include/errno.h
#define EACCES 13 /* Permission denied */
Is there a simpler command to retrieve this information? I'd like to be able to run something like this:
> lookuperror 13
EACCES (Permission denied)
Instead of grepping system header files. Does such a command/program exist?
Update: As pointed out in the answers below, the strerror() system call returns this information. Are there any UNIX operating systems that ship with an executable utility that makes this system call, or do I need to write my own program to do it?
I use to do
perl -MPOSIX -e 'print strerror($ARGV[0])."\n";' 13
You can just put the Perl code in a file and have it in the path.
Of course it can be done using C as well
~% perror 13
OS error code 13: Permission denied
~% rpm -qf =perror
mysql-server-5.0.45-7.el5
Try strerror(3).
From the manpage:
DESCRIPTION
The strerror(), strerror_r() and perror() functions look up the error
message string corresponding to an error number.
The strerror() function accepts an error number argument errnum and
returns a pointer to the corresponding message string.
The strerror_r() function renders the same result into strerrbuf for a
maximum of buflen characters and returns 0 upon success.
The perror() function finds the error message corresponding to the cur-
rent value of the global variable errno (intro(2)) and writes it, fol-
lowed by a newline, to the standard error file descriptor. If the argu-
ment string is non-NULL and does not point to the null character, this
string is prepended to the message string and separated from it by a
colon and space (``: ''); otherwise, only the error message string is
printed.
If the error number is not recognized, these functions return an error
message string containing ``Unknown error: '' followed by the error num-
ber in decimal. The strerror() and strerror_r() functions return EINVAL
as a warning. Error numbers recognized by this implementation fall in
the range 0 < errnum < sys_nerr.
If insufficient storage is provided in strerrbuf (as specified in buflen)
to contain the error string, strerror_r() returns ERANGE and strerrbuf
will contain an error message that has been truncated and NUL terminated
to fit the length specified by buflen.
The message strings can be accessed directly using the external array
sys_errlist. The external value sys_nerr contains a count of the mes-
sages in sys_errlist. The use of these variables is deprecated;
strerror() or strerror_r() should be used instead.