Provided by: manpages-es_1.55-10_all bug

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)