.\" -*- coding: UTF-8 -*-
.\" Copyright (c) 1996 Andries Brouwer (aeb@cwi.nl)
.\"
.\" %%%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
.\"
.\" 5 Oct 2002, Modified by Michael Kerrisk
.\" Updated for POSIX.1 2001
.\" 2004-12-17 Martin Schulze , mtk
.\" Removed errno declaration prototype, added notes
.\" 2006-02-09 Kurt Wall, mtk
.\" Added non-POSIX errors
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH ERRNO 3 "12. Dezember 2016" "" Linux\-Programmierhandbuch
.SH BEZEICHNUNG
errno \- Nummer des letzten aufgetretenen Fehlers
.SH ÜBERSICHT
.\".sp
.\".BI "extern int " errno ;
\fB#include \fP
.SH BESCHREIBUNG
Die Header\-Datei \fI\fP definiert die Integer\-Variable
\fIerrno\fP. Sie wird von Systemaufrufen (und einigen Bibliotheksfunktionen)
gesetzt, um anzuzeigen, was schief gelaufen ist. Ihr Wert ist nur dann von
Bedeutung, wenn der Rückgabewert des Funktionsaufrufs einen Fehler anzeigt
(d.h. \-1 bei den meisten Systemaufrufen; \-1 oder NULL bei den meisten
Bibliotheksfunktionen). Eine erfolgreich aufgerufene Funktion \fIdarf\fP den
Wert von \fIerrno\fP ändern.
Gültige Fehlernummern sind allesamt ungleich 0; kein Systemaufruf und keine
Bibliotheksfunktion setzt \fIerrno\fP auf 0.
Für einige Systemaufrufe und Bibliotheksfunktionen (wie
z.B. \fBgetpriority\fP(2)) ist \-1 ein gültiger Rückgabewert bei erfolgreichem
Funktionsaufruf. In solchen Fällen kann eine erfolgreiche von einer
fehlgeschlagenen Ausführung der Funktion unterschieden werden, indem vor dem
Aufruf \fIerrno\fP auf Null gesetzt wird und wenn der Rückgabestatus einen
Fehler anzeigt, \fIerrno\fP untersucht wird.
Der ISO\-C\-Standard definiert \fIerrno\fP als veränderbaren lvalue des Typs
\fIint\fP, der nicht explizit deklariert sein muss; \fIerrno\fP darf ein Makro
sein. Jeder Thread erhält eine eigene, lokale \fBerrno\fP; wird sie in einem
Thread gesetzt, wirkt sich das nicht auf ihren Wert in anderen Threads aus.
Mit einer Ausnahme müssen alle von POSIX.1 beschriebenen Fehlernamen
unterschiedliche Werte haben. \fBEAGAIN\fP und \fBEWOULDBLOCK\fP dürfen gleich
sein.
.\" The following is now
.\" POSIX.1 (2001 edition) lists the following symbolic error names. Of
.\" these, \fBEDOM\fP and \fBERANGE\fP are in the ISO C standard. ISO C
.\" Amendment 1 defines the additional error number \fBEILSEQ\fP for
.\" coding errors in multibyte or wide characters.
.\"
.\" FIXME This list should be updated for POSIX.1-2008
Es folgt eine Liste der symbolischen Fehlernamen, die für Linux definiert
sind. Einige von ihnen sind mit \fIPOSIX.1\fP gekennzeichnet, weil der Name von
POSIX.1\-2001 definiert wird; analog weist \fIC99\fP auf C99 hin.
.TP 16
\fBE2BIG\fP
Argumentliste zu lang (POSIX.1)
.TP
\fBEACCES\fP
Keine Berechtigung (POSIX.1)
.TP
\fBEADDRINUSE\fP
Adresse schon in Gebrauch (POSIX.1)
.TP
\fBEADDRNOTAVAIL\fP
.\" EADV is only an error on HURD(?)
Adresse nicht verfügbar (POSIX.1)
.TP
\fBEAFNOSUPPORT\fP
Adressfamilie nicht unterstützt (POSIX.1)
.TP
\fBEAGAIN\fP
Ressource zeitweise nicht verfügbar (darf der gleiche Wert sein wie
\fBEWOULDBLOCK\fP, POSIX.1)
.TP
\fBEALREADY\fP
Verbindung ist schon aufgebaut (POSIX.1)
.TP
\fBEBADE\fP
Austausch ungültig
.TP
\fBEBADF\fP
Schlechter Dateideskriptor (POSIX.1)
.TP
\fBEBADFD\fP
Dateideskriptor in schlechtem Zustand
.TP
\fBEBADMSG\fP
Ungültige Nachricht (POSIX.1)
.TP
\fBEBADR\fP
Ungültiger Anforderungsdeskriptor
.TP
\fBEBADRQC\fP
Ungültiger Anforderungscode
.TP
\fBEBADSLT\fP
.\" EBFONT is defined but appears not to be used by kernel or glibc.
Ungültiger Slot
.TP
\fBEBUSY\fP
Gerät oder Ressource beschäftigt/belegt (POSIX.1)
.TP
\fBECANCELED\fP
Aktion abgebrochen (POSIX.1)
.TP
\fBECHILD\fP
Keine Kind\-Prozesse (POSIX.1)
.TP
\fBECHRNG\fP
Kanalnummer außerhalb des zulässigen Bereichs
.TP
\fBECOMM\fP
Kommunikationsfehler beim Senden
.TP
\fBECONNABORTED\fP
Verbindung abgebrochen (POSIX.1)
.TP
\fBECONNREFUSED\fP
Verbindung abgelehnt (POSIX.1)
.TP
\fBECONNRESET\fP
Verbindung zurückgesetzt (POSIX.1)
.TP
\fBEDEADLK\fP
Verklemmung beim Zugriff auf eine Resource (deadlock) vermieden (POSIX.1)
.TP
\fBEDEADLOCK\fP
Synonym für \fBEDEADLK\fP
.TP
\fBEDESTADDRREQ\fP
Zieladresse erforderlich (POSIX.1)
.TP
\fBEDOM\fP
.\" EDOTDOT is defined but appears to be unused
Argument einer mathematischen Funktion außerhalb des Definitionsbereichs
(POSIX.1, C99)
.TP
\fBEDQUOT\fP
.\" POSIX just says "Reserved"
Festplattenkontingent (disk quota) überschritten (POSIX.1)
.TP
\fBEEXIST\fP
Datei schon vorhanden (POSIX.1)
.TP
\fBEFAULT\fP
Ungültige Adresse (POSIX.1)
.TP
\fBEFBIG\fP
Datei zu groß (POSIX.1)
.TP
\fBEHOSTDOWN\fP
Host/Rechner ist nicht in Betrieb
.TP
\fBEHOSTUNREACH\fP
Host/Rechner nicht erreichbar (POSIX.1)
.TP
\fBEIDRM\fP
Identifier/Bezeichner/Kennung entfernt (POSIX.1)
.TP
\fBEILSEQ\fP
Ungültiger oder unvollständiger Multibyte oder weites Zeichen (POSIX.1, C99)
Der hier gezeigte Text ist eine Glibc\-Fehlerbeschreibung: in POSIX.1 wird
dieser Fehler als »Ungültige Byte\-Sequenz« beschrieben.
.TP
\fBEINPROGRESS\fP
Aktion wird gerade ausgeführt (POSIX.1)
.TP
\fBEINTR\fP
Aufruf einer unterbrochenen Funktion (POSIX.1); siehe \fBsignal\fP(7)
.TP
\fBEINVAL\fP
Ungültiges Argument (POSIX.1)
.TP
\fBEIO\fP
Eingabe\-/Ausagebefehler (POSIX.1)
.TP
\fBEISCONN\fP
Socket ist verbunden (POSIX.1)
.TP
\fBEISDIR\fP
Ist ein Verzeichnis (POSIX.1)
.TP
\fBEISNAM\fP
Ist eine Datei benannten Typs
.TP
\fBEKEYEXPIRED\fP
Schlüssel ist abgelaufen
.TP
\fBEKEYREJECTED\fP
Schlüssel wurde vom Dienst zurückgewiesen
.TP
\fBEKEYREVOKED\fP
Schlüssel wurde widerrufen
.TP
\fBEL2HLT\fP
Stufe 2 angehalten
.TP
\fBEL2NSYNC\fP
Stufe 2 nicht synchronisiert
.TP
\fBEL3HLT\fP
Stufe 3 angehalten
.TP
\fBEL3RST\fP
Stufe 3 angehalten
.TP
\fBELIBACC\fP
Zugriff auf notwendige Laufzeitbibliothek nicht möglich
.TP
\fBELIBBAD\fP
Zugriff auf eine beschädigte Laufzeitbibliothek
.TP
\fBELIBMAX\fP
Versuch, zu viele Laufzeitbibliotheken zu linken
.TP
\fBELIBSCN\fP
Abschnitt \&.lib in a.out defekt
.TP
\fBELIBEXEC\fP
Eine Laufzeitbibliothek kann nicht direkt ausgeführt werden
.TP
\fBELOOP\fP
.\" ELNRNG is defined but appears to be unused
Zu viele Ebenen von symbolischen Links (POSIX.1)
.TP
\fBEMEDIUMTYPE\fP
Falscher Medientyp
.TP
\fBEMFILE\fP
Zu viele offene Dateien (POSIX.1). Typischerweise wird dies durch
Überschreiten der in \fBgetrlimit\fP(2) beschriebenen Ressourcenbegrenzung
\fBRLIMIT_NOFILE\fP hervorgerufen
.TP
\fBEMLINK\fP
Zu viele Links (POSIX.1)
.TP
\fBEMSGSIZE\fP
Nachricht zu lang (POSIX.1)
.TP
\fBEMULTIHOP\fP
.\" POSIX says "Reserved"
Multihop (mehrere Etappen) versucht (POSIX.1)
.TP
\fBENAMETOOLONG\fP
.\" ENAVAIL is defined, but appears not to be used
Dateiname zu lang (POSIX.1)
.TP
\fBENETDOWN\fP
Netzwerk außer Betrieb (POSIX.1)
.TP
\fBENETRESET\fP
Verbindungsabbruch durch das Netzwerk (POSIX.1)
.TP
\fBENETUNREACH\fP
Netzwerk nicht erreichbar (POSIX.1)
.TP
\fBENFILE\fP
.\" ENOANO is defined but appears to be unused.
Zu viele offene Dateien (POSIX.1). Unter Linux ist dies wahrscheinlich ein
Ergebnis der Beschränkung \fI/proc/sys/fs/file\-max\fP (siehe \fBproc\fP(5)).
.TP
\fBENOBUFS\fP
.\" ENOCSI is defined but appears to be unused.
Kein Platz für Puffer verfügbar (POSIX.1 (XSI\-STREAMS\-Option))
.TP
\fBENODATA\fP
Im STREAM\-Head der Lese\-Warteschlange ist keine Nachricht verfügbar
(POSIX.1)
.TP
\fBENODEV\fP
Kein solches Gerät vorhanden (POSIX.1)
.TP
\fBENOENT\fP
Keine solche Datei oder kein solches Verzeichnis vorhanden (POSIX.1)
Typischerweise tritt dieser Fehler auf, wenn der angegebene Pfadname nicht
existiert, einer der Komponenten in dem Verzeichnispräfix eines Pfadnamens
nicht existiert oder der angegebene Pfadname ein hängender symbolischer Link
ist.
.TP
\fBENOEXEC\fP
Fehler im Format der Programmdatei (POSIX.1)
.TP
\fBENOKEY\fP
Erforderlicher Schlüssel nicht verfügbar
.TP
\fBENOLCK\fP
Keine Sperren verfügbar (POSIX.1)
.TP
\fBENOLINK\fP
.\" POSIX says "Reserved"
Link wurde abgetrennt (POSIX.1)
.TP
\fBENOMEDIUM\fP
Kein Medium gefunden
.TP
\fBENOMEM\fP
Nicht genügend Platz (POSIX.1)
.TP
\fBENOMSG\fP
Keine Nachricht vom gewünschten Typ (POSIX.1)
.TP
\fBENONET\fP
Machine ist nicht an das Netzwerk angeschlossen
.TP
\fBENOPKG\fP
Paket nicht installiert
.TP
\fBENOPROTOOPT\fP
Protokoll nicht verfügbar (POSIX.1)
.TP
\fBENOSPC\fP
Auf dem Gerät ist kein Speicherplatz mehr verfügbar (POSIX.1)
.TP
\fBENOSR\fP
Keine STREAM\-Ressourcen (POSIX.1 (Option XSI STREAMS))
.TP
\fBENOSTR\fP
Ist kein STREAM (POSIX.1 (XSI\-STREAMS\-Option))
.TP
\fBENOSYS\fP
Funktion nicht implementiert (POSIX.1)
.TP
\fBENOTBLK\fP
Blockgerät erforderlich
.TP
\fBENOTCONN\fP
Der Socket ist nicht verbunden (POSIX.1)
.TP
\fBENOTDIR\fP
Ist kein Verzeichnis (POSIX.1)
.TP
\fBENOTEMPTY\fP
.\" ENOTNAM is defined but appears to be unused.
Das Verzeichnis ist nicht leer (POSIX.1)
.TP
\fBENOTSOCK\fP
Ist kein Socket (POSIX.1)
.TP
\fBENOTSUP\fP
Aktion wird nicht unterstützt (POSIX.1)
.TP
\fBENOTTY\fP
Unpassende E/A\-Steuerungsaktion (POSIX.1)
.TP
\fBENOTUNIQ\fP
Name ist im Netzwerk nicht eindeutig
.TP
\fBENXIO\fP
Kein solches Gerät/Adresse (POSIX.1)
.TP
\fBEOPNOTSUPP\fP
Aktion für Sockets nicht unterstützt (POSIX.1)
.sp
(\fBENOTSUP\fP und \fBEOPNOTSUPP\fP haben auf Linux den gleichen Wert, gemäß
POSIX.1 sollten diese Fehlerwerte unterschiedlich sein.)
.TP
\fBEOVERFLOW\fP
Wert zu groß für Speicherung im Datentyp (POSIX.1)
.TP
\fBEPERM\fP
Aktion nicht gestattet (POSIX.1)
.TP
\fBEPFNOSUPPORT\fP
Protokollfamilie nicht unterstützt
.TP
\fBEPIPE\fP
Pipe unterbrochen (POSIX.1)
.TP
\fBEPROTO\fP
Protokollfehler (POSIX.1)
.TP
\fBEPROTONOSUPPORT\fP
Protokoll nicht unterstützt (POSIX.1)
.TP
\fBEPROTOTYPE\fP
Falscher Protokolltyp für Socket (POSIX.1)
.TP
\fBERANGE\fP
Ergebnis zu groß (POSIX.1, C99)
.TP
\fBEREMCHG\fP
Adresse in der Ferne geändert
.TP
\fBEREMOTE\fP
Objekt ist in der Ferne/nicht lokal
.TP
\fBEREMOTEIO\fP
E/A\-Fehler in der Ferne
.TP
\fBERESTART\fP
Unterbrochener Systemaufruf sollte erneut gestart werden
.TP
\fBEROFS\fP
Nur\-lesbares Dateisystem (POSIX.1)
.TP
\fBESHUTDOWN\fP
Senden nach Herunterfahren des Transport\-Endpunktes nicht möglich
.TP
\fBESPIPE\fP
Ungültiger Seek (POSIX.1)
.TP
\fBESOCKTNOSUPPORT\fP
Socket\-Typ nicht unterstützt
.TP
\fBESRCH\fP
.\" ESRMNT is defined but appears not to be used
Kein solcher Prozess vorhanden (POSIX.1)
.TP
\fBESTALE\fP
»Abgestandener« Datei\-Handle (POSIX.1)
.sp
Dieser Fehler kann für NFS\- und für andere Dateisysteme auftreten.
.TP
\fBESTRPIPE\fP
Stream\-Pipe\-Fehler
.TP
\fBETIME\fP
Zeitnehmer abgelaufen (POSIX.1 (XSI\-STREAMS\-Option))
.sp
(POSIX.1 nennt das »STREAM \fBioctl\fP(2)\-Zeitüberschreitung«)
.TP
\fBETIMEDOUT\fP
.\" ETOOMANYREFS is defined, but appears not to be used.
Verbindung ist abgelaufen (POSIX.1)
.TP
\fBETXTBSY\fP
Textdatei belegt (POSIX.1)
.TP
\fBEUCLEAN\fP
Struktur muss aufgeräumt werden
.TP
\fBEUNATCH\fP
Kein zugeordneter Treiber für Protokoll
.TP
\fBEUSERS\fP
Zu viele Benutzer
.TP
\fBEWOULDBLOCK\fP
Aktion würden blockieren (darf der gleiche Wert wie \fBEAGAIN\fP sein)
(POSIX.1)
.TP
\fBEXDEV\fP
Ungültiger Link (POSIX.1)
.TP
\fBEXFULL\fP
Austausch/Vermittlungsstelle voll
.SH ANMERKUNGEN
Ein verbreiteter Programmierfehler ist
.in +4n
.nf
if (somecall() == \-1) {
printf("somecall() fehlgeschlagen\en");
if (errno == …) { … }
}
.fi
.in
Hier muss \fIerrno\fP nicht mehr den Wert haben, den er bei der Rückkehr
aus\fIsomecall\fP() hatte. (D.h., der Wert konnte durch den Aufruf von
\fBprintf\fP(3) verändert werden). Wenn der Wert von \fIerrno\fP über einen
Bibliotheksaufruf erhalten bleiben soll, muss er gespeichert werden:
.in +4n
.nf
if (somecall() == \-1) {
int errsv = errno;
printf("somecall() fehlgeschlagen\en");
if (errsv == ...) { ... }
}
.fi
.in
.PP
Im traditionellen C war es gebräuchlich, \fIerrno\fP manuell (mittels \fIextern
int errno\fP) zu deklarieren anstatt \fI\fP
einzubinden. \fBUnterlassen Sie das\fP. Das wird mit modernen Versionen der
C\-Bibliothek nicht funktionieren. Es kann aber auf (sehr) alten
UNIX\-Systemen vorkommen, dass \fI\fP fehlt und die Deklaration
erforderlich ist.
.SH "SIEHE AUCH"
.\" In the moreutils package
\fBerrno\fP(1), \fBerr\fP(3), \fBerror\fP(3), \fBperror\fP(3), \fBstrerror\fP(3)
.SH KOLOPHON
Diese Seite ist Teil der Veröffentlichung 4.09 des Projekts
Linux\-\fIman\-pages\fP. Eine Beschreibung des Projekts, Informationen, wie
Fehler gemeldet werden können sowie die aktuelle Version dieser Seite finden
sich unter \%https://www.kernel.org/doc/man\-pages/.
.SH ÜBERSETZUNG
Die deutsche Übersetzung dieser Handbuchseite wurde von
Martin Eberhard Schauer ,
Mario Blättermann
und
Helge Kreutzmann
erstellt.
Diese Übersetzung ist Freie Dokumentation; lesen Sie die
GNU General Public License Version 3 oder neuer bezüglich der
Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.
Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden,
schicken Sie bitte eine E-Mail an .