Provided by: manpages-fr-dev_4.26.0-1_all 
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;/* Pas exactement déclaré de cette façon ; consultez errno(3). */
[[obsolète]] const char *const sys_errlist[];
[[obsolète]] int sys_nerr;
Exigences de macros de test de fonctionnalités pour la glibc (consulter feature_test_macros(7)) :
sys_errlist, sys_nerr :
De la glibc 2.19 à la glibc 2.31 :
_DEFAULT_SOURCE
glibc 2.19 et antérieures :
_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
modifier errno même si elle réussit, ne serait-ce que parce que des appels 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.
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
errno
perror()
C11, POSIX.1-2008.
sys_nerr
sys_errlist
BSD.
HISTORIQUE
errno
perror()
POSIX.1-2001, C89, 4.3BSD.
sys_nerr
sys_errlist
supprimé dans la glibc 2.32.
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 Christophe Blaess
<https://www.blaess.fr/christophe/>, Stéphan Rafin <stephan.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.coulon@wanadoo.fr>, Julien Cristau
<jcristau@debian.org>, Thomas Huriaux <thomas.huriaux@gmail.com>, Nicolas François
<nicolas.francois@centraliens.net>, Florentin Duneau <fduneau@gmail.com>, Simon Paillard
<simon.paillard@resel.enst-bretagne.fr>, Denis Barbier <barbier@debian.org>, David Prévot
<david@tilapin.org>, Frédéric Hantrais <fhantrais@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 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.9.1 15 juin 2024 perror(3)