strerror(3) Library Functions Manual strerror(3) NOM strerror, strerrorname_np, strerrordesc_np, strerror_r, strerror_l - Obtenir le libelle d'un numero d'erreur BIBLIOTHEQUE Bibliotheque C standard (libc, -lc) SYNOPSIS #include char *strerror(int errnum); const char *strerrorname_np(int errnum); const char *strerrordesc_np(int errnum); int strerror_r(int errnum, char buf[.buflen], size_t buflen); /* conforme a XSI */ char *strerror_r(int errnum, char buf[.buflen], size_t buflen); /* specifique a GNU */ char *strerror_l(int errnum, locale_t locale); Exigences de macros de test de fonctionnalites pour la glibc (consulter feature_test_macros(7)) : strerrorname_np(), strerrordesc_np() : _GNU_SOURCE strerror_r() : La version conforme a XSI est fournie si : (_POSIX_C_SOURCE >= 200112L) && ! _GNU_SOURCE Sinon la version specifique a GNU est fournie. DESCRIPTION The strerror() function returns a pointer to a string that describes the error code passed in the argument errnum, possibly using the LC_MESSAGES part of the current locale to select the appropriate language. (For example, if errnum is EINVAL, the returned description will be "Invalid argument".) This string must not be modified by the application, and the returned pointer will be invalidated on a subsequent call to strerror() or strerror_l(), or if the thread that obtained the string exits. No other library function, including perror(3), will modify this string. Comme strerror(), la fonction strerrordesc_np() renvoie un pointeur vers une chaine qui decrit le code d'erreur passe dans l'argument errnum, avec comme difference que la chaine renvoyee n'est pas traduite selon la regionalisation en cours. The strerrorname_np() function returns a pointer to a string containing the name of the error code passed in the argument errnum. For example, given EPERM as an argument, this function returns a pointer to the string "EPERM". Given 0 as an argument, this function returns a pointer to the string "0". strerror_r() strerror_r() is like strerror(), but might use the supplied buffer buf instead of allocating one internally. This function is available in two versions: an XSI-compliant version specified in POSIX.1-2001 (available since glibc 2.3.4, but not POSIX-compliant until glibc 2.13), and a GNU-specific version (available since glibc 2.0). The XSI-compliant version is provided with the feature test macros settings shown in the SYNOPSIS; otherwise the GNU-specific version is provided. If no feature test macros are explicitly defined, then (since glibc 2.4) _POSIX_C_SOURCE is defined by default with the value 200112L, so that the XSI-compliant version of strerror_r() is provided by default. La version de strerror_r() conforme XSI est preferee pour les applications portables. Elle renvoie la chaine d'erreur dans le tampon buf de longueur buflen fourni par l'appelant. La version de strerror_r() specifique GNU renvoie un pointeur sur une chaine contenant le message d'erreur. Cela peut etre soit un pointeur vers une chaine que la fonction stocke dans buf, soit un pointeur vers une chaine statique (immuable) (auquel cas buf n'est pas utilise). Si la fonction stocke une chaine dans buf, au plus buflen octets sont stockes (la chaine peut etre tronquee si buflen est trop petit et qu'errnum est inconnu). La chaine inclut toujours l'octet NULL final (<< \0 >>). strerror_l() strerror_l() est semblable a strerror(), mais fait correspondre a errnum un message d'erreur adapte a la localisation precisee par locale. Le comportement de strerror_l() n'est pas defini si la localisation locale est l'objet special de localisation LC_GLOBAL_LOCALE ou si elle n'a pas une valeur valable de localisation. VALEUR RENVOYEE Les fonctions strerror(), strerror_l() et la fonction GNU strerror_r() renvoient la description correspondante au code transmis, ou un message << Unknown error nnn >> si le numero d'erreur est inconnu. En cas de succes, strerrorname_np() et strerrordesc_np() renvoient la description correspondante au code transmis. Si errnum est un numero d'erreur non valable, elles renvoient NULL. La fonction strerror_r() conforme XSI renvoie 0 si elle reussit. En cas d'erreur, un numero (positif) d'erreur est renvoye (depuis la glibc 2.13), ou -1 est renvoye et errno est defini pour indiquer l'erreur (avant la glibc 2.13). POSIX.1-2001 et POSIX.1-2008 exigent qu'un appel reussi de strerror() ou strerror_l() laisse errno non modifie. Remarquez que, puisqu'aucune valeur de retour de fonction n'est reservee pour indiquer une erreur, une application qui desire verifier les erreurs devrait initialiser errno a zero avant l'appel, et verifier errno apres l'appel. ERREURS EINVAL La valeur de errnum n'est pas un code d'erreur valable. ERANGE Le tampon fourni n'est pas assez grand pour la chaine de description d'erreur. ATTRIBUTS Pour une explication des termes utilises dans cette section, consulter attributes(7). +-------------------+--------------------------+-----------------------+ |Interface | Attribut | Valeur | +-------------------+--------------------------+-----------------------+ |strerror() | Securite des threads | MT-Safe | +-------------------+--------------------------+-----------------------+ |strerrorname_np(), | Securite des threads | MT-Safe | |strerrordesc_np() | | | +-------------------+--------------------------+-----------------------+ |strerror_r(), | Securite des threads | MT-Safe | |strerror_l() | | | +-------------------+--------------------------+-----------------------+ Before glibc 2.32, strerror() is not MT-Safe. STANDARDS strerror() C11, POSIX.1-2008. strerror_r() strerror_l() POSIX.1-2008. strerrorname_np() strerrordesc_np() GNU. POSIX.1-2001 permet a strerror() d'ecrire errno si l'appel rencontre une erreur mais ne specifie pas quelle valeur devrait etre renvoyee comme resultat de fonction dans l'eventualite d'une erreur. Sur certains systemes, strerror() renvoie NULL si le numero d'erreur est inconnu. Sur d'autres, strerror() renvoie une chaine du style << Error nnn occurred >> et ecrit EINVAL dans errno si le numero d'erreur est inconnu. C99 et POSIX.1-2008 exigent que la valeur renvoyee ne soit pas NULL. HISTORIQUE strerror() POSIX.1-2001, C89. strerror_r() POSIX.1-2001. strerror_l() glibc 2.6. POSIX.1-2008. strerrorname_np() strerrordesc_np() glibc 2.32: NOTES strerrorname_np() et strerrordesc_np() sont thread-safe et async-signal-safe. VOIR AUSSI err(3), errno(3), error(3), perror(3), strsignal(3), locale(7), signal-safety(7) TRADUCTION La traduction francaise de cette page de manuel a ete creee par Christophe Blaess , Stephan Rafin , Thierry Vignaud , Francois Micaux, Alain Portal , Jean-Philippe Guerard , Jean-Luc Coulon (f5ibh) , Julien Cristau , Thomas Huriaux , Nicolas Francois , Florentin Duneau , Simon Paillard , Denis Barbier , David Prevot et Frederic Hantrais Cette traduction est une documentation libre ; veuillez vous reporter a la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITE LEGALE. Si vous decouvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message a . Pages du manuel de Linux 6.06 31 octobre 2023 strerror(3)