perror(3)                  Library Functions Manual                  perror(3)

NOM
       perror - Afficher un message d'erreur systeme

BIBLIOTHEQUE
       Bibliotheque C standard (libc, -lc)

SYNOPSIS
       #include <stdio.h>

       void perror(const char *s);

       #include <errno.h>

       int errno;/* Pas exactement declare de cette facon ; consultez errno(3). */

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

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

       sys_errlist, sys_nerr :
           De la glibc 2.19 a la glibc 2.31 :
               _DEFAULT_SOURCE
           glibc 2.19 et anterieures :
               _BSD_SOURCE

DESCRIPTION
       La fonction perror() produit un message sur la sortie d'erreur standard
       decrivant la derniere erreur rencontree lors d'un appel a une fonction
       systeme ou de bibliotheque.

       Premierement, la chaine s en argument est imprimee (si s n'est pas NULL
       et *s n'est pas un octet NULL (<< e0 >>), suivie d'une virgule et
       d'espaces, puis un message d'erreur correspondant a la valeur courante
       de errno et un saut de ligne.

       Pour etre la plus utile possible, la chaine en argument doit inclure le
       nom de la fonction dans laquelle l'erreur est survenue.

       La liste globale d'erreurs sys_errlist[] pouvant etre 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 a cette liste car
       de nouvelles valeurs d'erreurs n'ont peut-etre pas ete ajoutees dans
       sys_errlist[]. L'utilisation de sys_errlist[] est maintenant obsolete,
       utilisez strerror(2) a la place.

       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 systeme ou de bibliotheque reussi. Une telle fonction peut
       modifier errno meme si elle reussit, ne serait-ce que parce que des
       appels systeme internes peuvent echouer. Ainsi, si un appel qui echoue
       n'est pas immediatement suivi par perror, la valeur de errno doit etre
       sauvegardee.

ATTRIBUTS
       Pour une explication des termes utilises dans cette section, consulter
       attributes(7).

       +---------------------+--------------------------+---------------------+
       |Interface            | Attribut                 | Valeur              |
       +---------------------+--------------------------+---------------------+
       |perror()             | Securite 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
              supprime dans la glibc 2.32.

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

TRADUCTION
       La traduction francaise de cette page de manuel a ete creee par
       Christophe Blaess <https://www.blaess.fr/christophe/>, Stephan Rafin
       <stephan.rafin@laposte.net>, Thierry Vignaud <tvignaud@mandriva.com>,
       Francois Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe
       Guerard <fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-
       luc.coulon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas
       Huriaux <thomas.huriaux@gmail.com>, Nicolas Francois
       <nicolas.francois@centraliens.net>, Florentin Duneau
       <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-
       bretagne.fr>, Denis Barbier <barbier@debian.org>, David Prevot
       <david@tilapin.org>, Frederic Hantrais <fhantrais@gmail.com> et
       Gregoire Scano <gregoire.scano@malloc.fr>

       Cette traduction est une documentation libre ; veuillez vous reporter a
       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 RESPONSABILITE LEGALE.

       Si vous decouvrez un bogue dans la traduction de cette page de manuel,
       veuillez envoyer un message a <debian-l10n-french@lists.debian.org>.

Pages du manuel de Linux 6.06   31 octobre 2023                      perror(3)