Provided by: manpages-fr-dev_3.27fr1.4-1_all bug

NOM

       perror - Afficher un message d'erreur systeme

SYNOPSIS

       #include <stdio.h>

       void perror(const char *s);

       #include <errno.h>

       const char *sys_errlist[];
       int sys_nerr;
       int errno;

   Exigences  de  macros  de  test de fonctionnalites pour la glibc (consultez
   feature_test_macros(7)) :

       sys_errlist, sys_nerr : _BSD_SOURCE

DESCRIPTION

       La  fonction  perror()  affiche  un  message  sur  la  sortie  d'erreur
       standard,  decrivant  la  derniere  erreur  rencontree  durant un appel
       systeme ou une fonction de bibliotheque. D'abord, (si s n'est pas  NULL
       et  *s  n'est pas un octet nul), la chaine de caractere s est imprimee,
       suivie d'un deux points (<< : >>) ou d'un blanc, puis le message, suivi
       d'un saut de ligne.

       La  chaine de caracteres contient generalement le nom de la fonction ou
       s'est produit l'erreur. Le numero d'erreur est obtenu a  partir  de  la
       variable  externe  errno,  qui  contient  le  code  d'erreur  lorsqu'un
       probleme survient, mais  qui  n'est  pas  efface  lorsqu'un  appel  est
       reussi.

       La  liste  globale  d'erreurs sys_errlist[] indexee par errno peut etre
       utilisee pour obtenir le message d'erreur sans le  saut  de  ligne.  Le
       plus grand numero de message contenu dans cette table est sys_nerr - 1.
       Soyez prudents  lors  des  acces  directs  dans  cette  liste,  car  de
       nouvelles erreurs n'ont peut-etre pas de message dans sys_errlist[].

       Quand  un  appel systeme echoue, il renvoie habituellement -1, et place
       le code d'erreur dans errno (les codes sont  decrits  dans  <errno.h>).
       Beaucoup de fonctions de bibliotheque se comportent egalement ainsi. La
       fonction perror() permet de traduire les codes d'erreur  en  une  forme
       humainement  lisible.  Notez  que errno est indefinie apres un appel de
       fonction de bibliotheque reussi. Cette  fonction  peut  modifier  errno
       meme  si elle reussit, ne serait-ce que par des appels systeme internes
       qui  peuvent  echouer.  Ainsi,  si  un  appel  qui  echoue  n'est   pas
       immediatement   suivi   par  perror,  la  valeur  de  errno  doit  etre
       sauvegardee.

CONFORMIT'E

       La fonction perror() et la variable externe errno (consultez  errno(3))
       sont  conformes  a  C89,  C99,  BSD 4.3,  POSIX.1-2001.  Les  variables
       externes sys_nerr et sys_errlist sont conformes a BSD.

NOTES

       Les variables externes sys_nerr et sys_errlist  sont  definies  par  la
       glibc, mais dans <stdio.h>.

VOIR AUSSI

       err(3), errno(3), error(3), strerror(3)

COLOPHON

       Cette  page  fait  partie  de  la  publication 3.27 du projet man-pages
       Linux. Une description du projet et des instructions pour signaler  des
       anomalies       peuvent       etre       trouvees      a      l'adresse
       <URL:http://www.kernel.org/doc/man-pages/>.

TRADUCTION

       Depuis 2010, cette traduction est maintenue a l'aide  de  l'outil  po4a
       <URL:http://po4a.alioth.debian.org/>   par   l'equipe   de   traduction
       francophone       au       sein        du        projet        perkamon
       <URL:http://perkamon.alioth.debian.org/>.

       Christophe  Blaess  <URL:http://www.blaess.fr/christophe/> (1996-2003),
       Alain  Portal  <URL:http://manpagesfr.free.fr/>  (2003-2006).   Nicolas
       Francois et l'equipe francophone de traduction de Debian (2006-2009).

       Veuillez   signaler   toute   erreur   de   traduction  en  ecrivant  a
       <debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le
       paquet manpages-fr.

       Vous  pouvez  toujours avoir acces a la version anglaise de ce document
       en utilisant la commande << man -L C <section> <page_de_man> >>.

                                26 juillet 2007                      PERROR(3)