.\" -*- coding: UTF-8 -*-
.\" Copyright (c) 1994 Michael Haardt (michael@moria.de), 1994-06-04
.\" Copyright (c) 1995 Michael Haardt
.\" (michael@cantor.informatik.rwth-aachen.de), 1995-03-16
.\" Copyright (c) 1996 Andries Brouwer (aeb@cwi.nl), 1996-01-13
.\"
.\" %%%LICENSE_START(GPLv2+_DOC_FULL)
.\" This is free documentation; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License as
.\" published by the Free Software Foundation; either version 2 of
.\" the License, or (at your option) any later version.
.\"
.\" The GNU General Public License's references to "object code"
.\" and "executables" are to be interpreted as the output of any
.\" document formatting or typesetting system, including
.\" intermediate and printed output.
.\"
.\" This manual is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public
.\" License along with this manual; if not, see
.\" .
.\" %%%LICENSE_END
.\"
.\" 1996-01-13 aeb: merged in some text contributed by Melvin Smith
.\" (msmith@falcon.mercer.peachnet.edu) and various other changes.
.\" Modified 1996-05-16 by Martin Schulze (joey@infodrom.north.de)
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH PERROR 3 "1 novembre 2020" "" "Manuel du programmeur Linux"
.SH NOM
perror \- Afficher un message d'erreur système
.SH SYNOPSIS
\fB#include \fP
.PP
\fBvoid perror(const char *\fP\fIs\fP\fB);\fP
\fB#include \fP
.PP
\fBconst char * const \fP\fIsys_errlist\fP\fB[];\fP
.br
\fBint \fP\fIsys_nerr\fP\fB;\fP
.br
\fBint \fP\fIerrno\fP\fB; \fP/* Pas exactement déclaré de cette façon\ ; consultez
errno(3). */
.PP
.RS -4
Exigences de macros de test de fonctionnalités pour la glibc (consulter
\fBfeature_test_macros\fP(7))\ :
.RE
.PP
\fIsys_errlist\fP,
\fIsys_nerr\fP :
De la glibc 2.19 à 2.31 :
_DEFAULT_SOURCE
Pour la glibc 2.19 et avant :
_BSD_SOURCE
.SH DESCRIPTION
La fonction \fBperror\fP() 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.
.PP
Premièrement, la chaîne \fIs\fP en argument est imprimée (si \fIs\fP n'est pas
NULL et \fI*s\fP n'est pas l’octet NULL («\ e0\ »), suivie d'une virgule et
d’espaces, puis un message d'erreur correspondant à la valeur courante de
\fIerrno\fP et un saut de ligne.
.PP
Pour être la plus utile possible, la chaîne en argument doit inclure le nom
de la fonction dans laquelle l'erreur est survenue.
.PP
La liste globale d'erreurs \fIsys_errlist\fP[] pouvant être indexée par
\fIerrno\fP 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
\fIsys_nerr\fP \- 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
\fIsys_errlist\fP[]. L'utilisation de \fIsys_errlist\fP[] est maintenant obsolète,
utilisez \fBstrerror\fP(2) à la place.
.PP
Quand un appel système échoue, il renvoie habituellement \fB\-1\fP, et place le
code d'erreur dans \fIerrno\fP (les codes sont décrits dans
\fI\fP). Beaucoup de fonctions de bibliothèque se comportent
également ainsi. La fonction \fBperror\fP() permet de traduire les codes
d'erreur en une forme humainement lisible. Notez que \fIerrno\fP est indéfinie
après un appel de fonction système ou de bibliothèque réussi. Une telle
fonction peut modifier \fIerrno\fP 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 \fBperror\fP, la valeur de \fIerrno\fP
doit être sauvegardée.
.SH VERSIONS
Depuis la version\ 2.32 de la glibc, les déclarations de \fIsys_nerr\fP et
\fIsys_errlist\fP ne sont plus contenues dans \fI\fP.
.SH ATTRIBUTS
Pour une explication des termes utilisés dans cette section, consulter
\fBattributes\fP(7).
.TS
allbox;
lb lb lb
l l l.
Interface Attribut Valeur
T{
\fBperror\fP()
T} Sécurité des threads MT\-Safe race:stderr
.TE
.sp 1
.SH CONFORMITÉ
\fBperror\fP(), \fIerrno\fP\ : POSIX.1\-2001, POSIX.1\-2008, C89, C99, 4.3BSD.
.PP
Les variables externes \fIsys_nerr\fP et \fIsys_errlist\fP proviennent de BSD mais
ne sont pas définies par POSIX.1.
.SH NOTES
.\" and only when _BSD_SOURCE is defined.
.\" When
.\" .B _GNU_SOURCE
.\" is defined, the symbols
.\" .I _sys_nerr
.\" and
.\" .I _sys_errlist
.\" are provided.
Les variables externes \fIsys_nerr\fP et \fIsys_errlist\fP sont définies par la
glibc, mais dans \fI\fP.
.SH "VOIR AUSSI"
\fBerr\fP(3), \fBerrno\fP(3), \fBerror\fP(3), \fBstrerror\fP(3)
.SH COLOPHON
Cette page fait partie de la publication\ 5.10 du projet \fIman\-pages\fP
Linux. Une description du projet et des instructions pour signaler des
anomalies et la dernière version de cette page peuvent être trouvées à
l'adresse \%https://www.kernel.org/doc/man\-pages/.
.PP
.SH TRADUCTION
La traduction française de cette page de manuel a été créée par
Christophe Blaess ,
Stéphan Rafin ,
Thierry Vignaud ,
François Micaux,
Alain Portal ,
Jean-Philippe Guérard ,
Jean-Luc Coulon (f5ibh) ,
Julien Cristau ,
Thomas Huriaux ,
Nicolas François ,
Florentin Duneau ,
Simon Paillard ,
Denis Barbier ,
David Prévot ,
Frédéric Hantrais
et
Grégoire Scano
.
.PP
Cette traduction est une documentation libre ; veuillez vous reporter à la
.UR https://www.gnu.org/licenses/gpl-3.0.html
GNU General Public License version 3
.UE
concernant les conditions de copie et
de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.
.PP
Si vous découvrez un bogue dans la traduction de cette page de manuel,
veuillez envoyer un message à
.MT debian-l10n-french@lists.debian.org
.ME .