.\" -*- 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 "2. Mai 2024" "Linux man\-pages 6.8" .SH BEZEICHNUNG perror \- eine Systemfehlermeldung ausgeben .SH BIBLIOTHEK Standard\-C\-Bibliothek (\fIlibc\fP, \fI\-lc\fP) .SH ÜBERSICHT .nf \fB#include \fP .P \fBvoid perror(const char *\fP\fIs\fP\fB);\fP .P \fB#include \fP .P \fBint \fP\fIerrno\fP\fB; \fP/* Nicht wirklich auf diese Weise deklariert; siehe errno(3). */ .P \fB[[veraltet]] const char *const \fP\fIsys_errlist\fP\fB[];\fP \fB[[veraltet]] int \fP\fIsys_nerr\fP\fB;\fP .fi .P .RS -4 Mit Glibc erforderliche Feature\-Test\-Makros (siehe \fBfeature_test_macros\fP(7)): .RE .P \fIsys_errlist\fP, \fIsys_nerr\fP: .nf Von Glibc 2.19 bis 2.31: _DEFAULT_SOURCE Glibc 2.19 und älter: _BSD_SOURCE .fi .SH BESCHREIBUNG Die Funktion \fBperror\fP() schreibt eine Meldung auf die Standardfehlerausgabe, die den zuletzt aufgetretenen Fehler beschreibt, der während eines Aufrufs einer System\- oder Bibliotheksfunktion aufgetreten ist. .P Zuerst wird (falls \fIs\fP nicht NULL und \fI*s\fP kein Nullbyte (»\e0\«) ist) die Argumentenzeichenkette \fIs\fP, danach ein Doppelpunkt, ein Leerzeichen und dann die eine Fehlermeldung, die dem aktuellen Wert von \fIerrno\fP entspricht, gefolgt von einem Zeilenvorschub ausgegeben. .P Um am nützlichsten zu sein, sollte die Argumentenzeichenkette den Namen der Funktion enthalten, die den Fehler auslöste. .P Die globale Fehlerliste \fIsys_errlist\fP[], die mit \fIerrno\fP indiziert werden kann, kann verwandt werden, um die Fehlermeldungen ohne den Zeilenumbruch zu erhalten. Der größte gültige Index für \fIsys_errlist\fP[] ist \fIsys_nerr\fP\-1. Vorsicht ist geboten, wenn direkt auf diese Liste zugegriffen wird, denn neue Fehlerwerte sind eventuell noch nicht hinzugefügt worden. Die Verwendung von \fIsys_errlist\fP[] ist heutzutage missbilligt, verwenden Sie stattdessen \fBstrerror\fP(3). .P Wenn ein Systemaufruf fehlschlägt, gibt er normalerweise \-1 zurück und setzt die Variable \fIerrno\fP auf einen Wert, der beschreibt, was falsch lief. (Diese Werte können in \fI\fP gefunden werden.) Viele Bibliotheksfunktionen verhalten sich genauso. Die Funktion \fBperror\fP() übersetzt diesen Fehlercode in eine für Menschen lesbare Form. Beachten Sie, dass \fIerrno\fP nach erfolgreichem System\- oder Bibliotheksfunktionsaufruf undefiniert ist: Dieser Aufruf kann die Variable aber sehr wohl ändern, auch wenn er erfolgreich ist – zum Beispiel, wenn er intern weitere Bibliotheksfunktionen verwendet, die fehlschlagen. Daher sollte der Wert von \fIerrno\fP gespeichert werden, wenn auf den fehlgeschlagenen Aufruf nicht sofort ein Aufruf von \fBperror\fP() folgt. .SH ATTRIBUTE Siehe \fBattributes\fP(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke. .TS allbox; lbx lb lb l l l. Schnittstelle Attribut Wert T{ .na .nh \fBperror\fP() T} Multithread\-Fähigkeit MT\-Sicher race:stderr .TE .SH STANDARDS .TP \fIerrno\fP .TQ \fBperror\fP() C11, POSIX.1\-2008. .TP \fIsys_nerr\fP .TQ \fIsys_errlist\fP BSD. .SH GESCHICHTE .TP \fIerrno\fP .TQ \fBperror\fP() POSIX.1\-2001, C89, 4.3BSD. .TP \fIsys_nerr\fP .TQ \fIsys_errlist\fP Wurde in Glibc 2.32 entfernt. .SH "SIEHE AUCH" \fBerr\fP(3), \fBerrno\fP(3), \fBerror\fP(3), \fBstrerror\fP(3) .PP .SH ÜBERSETZUNG Die deutsche Übersetzung dieser Handbuchseite wurde von Martin Schulze , Patrick Rother , Chris Leick und Mario Blättermann erstellt. .PP Diese Übersetzung ist Freie Dokumentation; lesen Sie die .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License Version 3 .UE oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen. .PP Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die .MT debian-l10n-german@lists.debian.org Mailingliste der Übersetzer .ME .