NOMBRE

       perror - muestra un mensaje correspondiente a un error del sistema

SINOPSIS

       #include <stdio.h>

       void perror(const char *s);

       #include <errno.h>

       const char *sys_errlist[];
       int sys_nerr;

DESCRIPCIÓN

       La rutina perror() produce un mensaje que va a la salida estándar de errores, describiendo
       el último error encontrado durante una  llamada  al  sistema  o  a  ciertas  funciones  de
       biblioteca.   Primero  (si  s  es  distinto de NULL y *s no es NUL) se imprime la cadena s
       pasada como argumento, seguida de un signo de dos puntos y un espacio en blanco.   Después
       se imprime el mensaje y un salto de línea.

       Para ser de más utilidad, la cadena de caracteres pasada como argumento debería incluir el
       nombre de la función que incurrió en el error. El código del error se toma de la  variable
       externa  errno,  que  toma un valor cuando ocurre un error pero no es puesta a cero en una
       llamada no errónea.

       Puede utilizarse la lista global  de  errores  sys_errlist[],  indexada  por  errno,  para
       obtener  el  mensaje  del  error  sin  el  salto  de línea.  El número más alto de mensaje
       proporcionado en la tabla es sys_nerr -1.  Tenga cuidado cuando acceda directamente a esta
       lista porque puede que no se hayan añadido aún nuevos valores de error a sys_errlist[].

       Cuando  una  llamada al sistema falla, normalmente devuelve -1 y pone en la variable errno
       un valor que describe qué fue  mal.  (Estos  valores  pueden  encontrarse  en  <errno.h>.)
       Muchas  funciones  de  biblioteca  también  hacen  esto.   La  función perror() sirve para
       traducir este código de error a una forma que los humanos puedan  entender.   Observe  que
       errno  tiene  un  valor sin definir tras una llamada exitosa: esta llamada podría muy bien
       cambiar incluso el valor de esta variable, a pesar de  haber  acabado  bien,  por  ejemplo
       porque  internamente empleara alguna otra función de biblioteca que hubiera fallado.  Así,
       si una llamada fallida no es seguida inmediatamente por una llamada a perror, el valor  de
       errno debe guardarse.

CONFORME A

       C ANSI, BSD 4.3, POSIX, X/OPEN

VÉASE TAMBIÉN

       strerror(3)