NOM

       strerror, strerror_r - Obtenir le libellé d'un numéro d'erreur

SYNOPSIS

       #include <string.h>

       char *strerror(int errnum);

       int strerror_r(int errnum, char *buf, size_t buflen);
                   /* conforme XSI */

       char *strerror_r(int errnum, char *buf, size_t buflen);
                   /* spécifique GNU */

   Exigences de macros de test de fonctionnalités pour la glibc (consultez feature_test_macros(7)) :

       La version compatible XSI de strerror_r() est fournie si :
       (_POSIX_C_SOURCE >= 200112L || _XOPEN_SOURCE >= 600) && ! _GNU_SOURCE
       Autrement, c'est la version GNU qui est fournie.

DESCRIPTION

       La  fonction strerror() renvoie un pointeur vers une chaîne qui décrit le code d'erreur passé en argument
       errnum, en utilisant éventuellement la catégorie LC_MESSAGES de  la  localisation  pour  sélectionner  la
       langue  appropriée  (par  exemple,  si  errnum  est  EINVAL,  la  description  renvoyée  sera  « Argument
       invalide »). Cette chaîne ne doit pas être modifiée par l'application, mais  peut  être  écrasée  par  un
       appel  ultérieur  à  strerror().  Aucune  autre fonction de bibliothèque, y compris perror(3), ne modifie
       cette chaîne.

       La fonction strerror_r() est identique à strerror() mais fonctionne correctement  dans  un  environnement
       multithread.  Cette  fonction  est  disponible en deux versions : une version conforme XSI spécifiée dans
       POSIX.1-2001 (disponible depuis la glibc 2.3.4, mais non compatible POSIX avant  la  glibc 2.13)  et  une
       version  spécifique  GNU  (disponible  depuis la glibc 2.0). La version compatible XSI est fournie par la
       macro de test mentionnée dans le SYNOPSIS, sinon la version spécifique GNU est fournie. Si  aucune  macro
       de  test  n'est  définie  explicitement, alors (depuis la glibc 2.4) _POSIX_SOURCE est définie par défaut
       avec la valeur 200112L, de telle sorte que la version compatible XSI  de  strerror_r()  est  fournie  par
       défaut.

       La  version  de  strerror_r()  conforme XSI est préférée pour les applications portables. Elle renvoie la
       chaîne dans le tampon buf de longueur buflen fourni par l'appelant.

       La version de strerror_r() spécifique GNU renvoie  un  pointeur  sur  une  chaîne  contenant  le  message
       d'erreur.  Cela  peut  être  soit  un  pointeur  vers une chaîne que la fonction stocke dans buf, soit un
       pointeur vers une chaîne statique (immuable) (auquel cas buf n'est pas utilisé). Si  la  fonction  stocke
       une  chaîne dans buf, au plus buflen octets sont stockés (la chaîne peut être tronquée si buflen est trop
       petit et qu'errnum est inconnu). La chaîne inclut toujours l'octet nul final (« \0 »).

VALEUR RENVOYÉE

       La fonction strerror() et la fonction GNU strerror_r() renvoient la  description  correspondant  au  code
       transmis, ou un message « Unknown error nnn » si le numéro d'erreur n'existe pas.

       POSIX.1-2001 et POSIX.1-2008 exigent qu'un appel réussi de strerror() laisse errno non modifié. Remarquez
       que,  puisqu'aucune  valeur  de retour de fonction n'est réservée pour indiquer d'erreur, une application
       qui désire vérifier les erreurs devrait initialiser errno à zéro avant l'appel, et vérifier  errno  après
       l'appel.

       La  fonction  strerror_r()  conforme  XSI renvoie 0 si elle réussit. En cas d'erreur, un numéro (positif)
       d'erreur est renvoyé (depuis la glibc 2.13), ou -1  est  renvoyé  et  errno  est  définit  pour  indiquer
       l'erreur (pour les version de la glibc antérieures à 2.13).

ERREURS

       EINVAL La valeur de errnum n'est pas un code d'erreur valide.

       ERANGE Le tampon fourni n'est pas assez grand.

ATTRIBUTS

   Multithreading (voir pthreads(7))
       La fonction strerror() n'est pas sûre dans un contexte multithread.

       La fonction strerror_r() est sûre dans un contexte multithread.

CONFORMITÉ

       strerror() est spécifiée par POSIX.1-2001, C89 et C99. strerror_r() est spécifiée par POSIX.1-2001.

       La fonction strerror_r() spécifique GNU n'est pas une extension standard.

       POSIX.1-2001  permet  à  strerror()  d'écrire  errno si l'appel rencontre une erreur mais ne spécifie pas
       quelle valeur devrait être retournée comme résultat de fonction  dans  l'éventualité  d'une  erreur.  Sur
       certains  systèmes,  strerror()  renvoie NULL si le numéro d'erreur est inconnu. Sur d'autres, strerror()
       renvoie une chaîne du style « Error nnn occurred » et écrit EINVAL dans errno si le numéro  d'erreur  est
       inconnu. C99 et POSIX.1-2008 exigent que la valeur renvoyée ne soit pas NULL.

VOIR AUSSI

       err(3), errno(3), error(3), perror(3), strsignal(3)

COLOPHON

       Cette page fait partie de la publication 3.57 du projet man-pages Linux. Une description du projet et des
       instructions     pour     signaler     des     anomalies    peuvent    être    trouvées    à    l'adresse
       http://www.kernel.org/doc/man-pages/.

TRADUCTION

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

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

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

       Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la commande « man -L C
       <section> <page_de_man> ».

                                                  21 juin 2013                                       STRERROR(3)