.\" -*- coding: UTF-8 -*- '\" t .\" 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 .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" .\" 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 "20 juillet 2023" "Pages du manuel de Linux 6.05.01" .SH NOM perror \- Afficher un message d'erreur système .SH BIBLIOTHÈQUE Bibliothèque C standard (\fIlibc\fP, \fI\-lc\fP) .SH SYNOPSIS .nf \fB#include \fP .PP \fBvoid perror(const char *\fP\fIs\fP\fB);\fP .PP \fB#include \fP .PP \fBint \fP\fIerrno\fP\fB;\fP/* Pas exactement déclaré de cette façon\ ; consultez errno(3). */ .PP \fB[[obsolète]] const char *const \fP\fIsys_errlist\fP\fB[];\fP \fB[[obsolète]] int \fP\fIsys_nerr\fP\fB;\fP .fi .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\ : .nf De la glibc 2.19 à la glibc 2.31 : _DEFAULT_SOURCE glibc 2.19 et antérieures : _BSD_SOURCE .fi .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 un 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 ATTRIBUTS Pour une explication des termes utilisés dans cette section, consulter \fBattributes\fP(7). .TS allbox; lbx lb lb l l l. Interface Attribut Valeur T{ .na .nh \fBperror\fP() T} Sécurité des threads MT\-Safe race:stderr .TE .sp 1 .SH STANDARDS .TP \fIerrno\fP .TQ \fBperror\fP() C11, POSIX.1\-2008. .TP \fIsys_nerr\fP .TQ \fIsys_errlist\fP BSD. .SH HISTORIQUE .TP \fIerrno\fP .TQ \fBperror\fP() POSIX.1\-2001, C89, 4.3BSD. .TP \fIsys_nerr\fP .TQ \fIsys_errlist\fP supprimé dans la glibc 2.32. .SH "VOIR AUSSI" \fBerr\fP(3), \fBerrno\fP(3), \fBerror\fP(3), \fBstrerror\fP(3) .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 .