perror(3) Library Functions Manual perror(3)
NOM
perror - Afficher un message d'erreur système
BIBLIOTHÈQUE
Bibliothèque C standard (libc, -lc)
SYNOPSIS
#include <stdio.h>
void perror(const char *s);
#include <errno.h>
int errno; /* Not really declared this way; see errno(3) */
[[deprecated]] const char *const sys_errlist[];
[[deprecated]] int sys_nerr;
Exigences de macros de test de fonctionnalités pour la glibc (consulter
feature_test_macros(7)) :
sys_errlist, sys_nerr :
From glibc 2.19 to glibc 2.31:
_DEFAULT_SOURCE
glibc 2.19 and earlier:
_BSD_SOURCE
DESCRIPTION
La fonction perror() produit un message sur la sortie d'erreur standard
décrivant la dernière erreur rencontrée lors d'un appel à une fonction
système ou de bibliothèque.
First (if s is not NULL and *s is not a null byte ('\0')), the argument
string s is printed, followed by a colon and a blank. Then an error
message corresponding to the current value of errno and a new-line.
Pour être la plus utile possible, la chaîne en argument doit inclure le
nom de la fonction dans laquelle l'erreur est survenue.
La liste globale d'erreurs sys_errlist[] pouvant être indexée par errno
peut être utilisée pour obtenir le message d'erreur sans le saut de
ligne. Le plus grand numéro de message contenu dans cette table est
sys_nerr - 1. Soyez prudents lors des accès directs à cette liste car
de nouvelles valeurs d’erreurs n'ont peut-être pas été ajoutées dans
sys_errlist[]. L'utilisation de sys_errlist[] est maintenant obsolète,
utilisez strerror(2) à la place.
Quand un appel système échoue, il renvoie habituellement -1, et place
le code d'erreur dans errno (les codes sont décrits dans <errno.h>).
Beaucoup de fonctions de bibliothèque se comportent également ainsi. La
fonction perror() permet de traduire les codes d'erreur en une forme
humainement lisible. Notez que errno est indéfinie après un appel de
fonction système ou de bibliothèque réussi. Une telle fonction peut mo-
difier errno même si elle réussit, ne serait-ce que parce que des ap-
pels système internes peuvent échouer. Ainsi, si un appel qui échoue
n'est pas immédiatement suivi par perror, la valeur de errno doit être
sauvegardée.
VERSIONS
Since glibc 2.32, the declarations of sys_errlist and sys_nerr are no
longer exposed by <stdio.h>.
ATTRIBUTS
Pour une explication des termes utilisés dans cette section, consulter
attributes(7).
┌─────────────────────────┬──────────────────────┬─────────────────────┐
│Interface │ Attribut │ Valeur │
├─────────────────────────┼──────────────────────┼─────────────────────┤
│perror() │ Sécurité des threads │ MT-Safe race:stderr │
└─────────────────────────┴──────────────────────┴─────────────────────┘
STANDARDS
perror(), errno: POSIX.1-2001, POSIX.1-2008, C99, 4.3BSD.
Les variables externes sys_nerr et sys_errlist proviennent de BSD mais
ne sont pas définies par POSIX.1.
NOTES
Les variables externes sys_nerr et sys_errlist sont définies par la
glibc, mais dans <stdio.h>.
VOIR AUSSI
err(3), errno(3), error(3), strerror(3)
TRADUCTION
La traduction française de cette page de manuel a été créée par Chris-
tophe Blaess <https://www.blaess.fr/christophe/>, Stéphan Rafin <ste-
phan.rafin@laposte.net>, Thierry Vignaud <tvignaud@mandriva.com>, Fran-
çois Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe Gué-
rard <fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-luc.cou-
lon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas Huriaux
<thomas.huriaux@gmail.com>, Nicolas François <nicolas.francois@centra-
liens.net>, Florentin Duneau <fduneau@gmail.com>, Simon Paillard <si-
mon.paillard@resel.enst-bretagne.fr>, Denis Barbier <barbier@de-
bian.org>, David Prévot <david@tilapin.org>, Frédéric Hantrais <fhan-
trais@gmail.com> et Grégoire Scano <gregoire.scano@malloc.fr>
Cette traduction est une documentation libre ; veuillez vous reporter à
la GNU General Public License version 3
⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ concernant les conditions
de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.
Si vous découvrez un bogue dans la traduction de cette page de manuel,
veuillez envoyer un message à ⟨debian-l10n-french@lists.debian.org⟩.
Pages du manuel de Linux 6.03 5 février 2023 perror(3)
Generated by dwww version 1.15 on Sat Jun 29 01:54:08 CEST 2024.