Provided by:
manpages-es_1.55-10_all 
NOMBRE
strerror, strerror_r - devuelve una cadena de caracteres describiendo
un codigo de error
SINOPSIS
#include <string.h>
char *strerror(int errnum);
int strerror_r(int errnum, char *buf, size_t n);
DESCRIPCI'ON
La funcion strerror() devuelve una cadena de caracteres que describe el
codigo de error pasado en el argumento errnum, usando posiblemente la
categoria LC_MESSAGES de la localizacion actual para seleccionar el
idioma apropiado. Esta cadena no debe ser modificada por la
aplicacion, pero puede ser modificada por una llamada posterior a
perror() o strerror(). Ninguna funcion de biblioteca modificara esta
cadena.
La funcion strerror_r() es similar a strerror(), pero es una funcion
hilo seguro. Devuelve la cadena en el buffer suministrado por el
usuario buf de longitud n.
VALOR DEVUELTO
La funcion strerror() devuelve la cadena de descripcion del error
apropiada, o un mensaje de error desconocido si el codigo de error es
invalido. El valor de errno no se modifica en una llamada con exito, y
toma un valor distinto de cero en caso de error. La funcion
strerror_r() devuelve 0 en caso de exito y -1 si falla, modificando la
variable errno.
ERRORES
EINVAL El valor de errnum no es un numero de error valido.
ERANGE El buffer pasado tiene un tamano insuficiente para contener la
cadena de descripcion del error.
CONFORME A
SVID 3, POSIX, BSD 4.3, ISO/IEC 9899:1990 (C89).
strerror_r() con el prototipo dado arriba esta especificada por SUSv3,
y estuvo en uso bajo Digital Unix y HP Unix. Una funcion incompatible,
con el prototipo
char *strerror_r(int errnum, char *buf, size_t n);
es una extension de GNU usada por glibc (desde 2.0), y debe ser
considerada obsoleta en favor de SUSv3. La version de GNU puede, pero
no necesita, usar el buffer suministrado por el usuario. Si lo hace,
el resultado puede ser truncado en caso de que el buffer sea demasiado
pequeno. El resultado termina siempre con el caracter NUL.
V'EASE TAMBI'EN
errno(3), perror(3), strsignal(3)
16 octubre 2001 STRERROR(3)