oracular (3) errno.3.gz

Provided by: manpages-de-dev_4.23.1-1_all bug

BEZEICHNUNG

       errno - Nummer des letzten aufgetretenen Fehlers

BIBLIOTHEK

       Standard-C-Bibliothek (libc, -lc)

ÜBERSICHT

       #include <errno.h>

BESCHREIBUNG

       Die  Header-Datei  <errno.h>  definiert  die Variable errno mit Typ integer. Sie  wird von Systemaufrufen
       (und einigen Bibliotheksfunktionen) gesetzt, um anzuzeigen, was schief gelaufen ist.

   errno
       Der Wert in errno 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 darf den Wert von errno ändern. Der Wert von errno wird niemals von
       irgendeinem Systemaufruf oder einer Bibliotheksfunktion auf Null gesetzt.

       Für  einige  Systemaufrufe  und  Bibliotheksfunktionen  (wie  z.B.  getpriority(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 errno auf Null
       gesetzt wird und wenn der Rückgabestatus einen Fehler anzeigt, errno untersucht wird.

       Der ISO-C-Standard definiert errno als veränderbaren lvalue des Typs int, der nicht  explizit  deklariert
       sein  muss;  errno  darf ein Makro sein. Jeder Thread erhält eine eigene, lokale errno; wird sie in einem
       Thread gesetzt, wirkt sich das nicht auf ihren Wert in anderen Threads aus.

   Fehlernummern und -namen
       Gültige Fehlernummer sind alle positiven Zahlen. Die  Header-Datei  <errno.h>  definiert  für  jeden  der
       möglichen Fehlernummern, die in errno auftreten können, symbolische Namen.

       Mit einer Ausnahme müssen alle von POSIX.1 beschriebenen Fehlernamen unterschiedliche Werte haben. EAGAIN
       und EWOULDBLOCK dürfen gleich sein. Unter Linux haben diese beiden Variablen auf allen Architekturen  den
       gleichen Wert.

       Die  Fehlernummern,  die  jedem symbolischen Namen entsprechen, unterscheiden sich zwischen UNIX-Systemen
       und selbst zwischen verschiedenen Architekturen unter  Linux.  Daher  ist  der  numerische  Wert  in  der
       nachfolgenden Liste der Fehlernamen nicht enthalten. Die Funktionen perror(3) und strerror(3) können dazu
       verwandt werden, diese Namen in die entsprechenden textuellen Fehlermeldungen umzuwandeln.

       Auf einem konkreten Linux-System kann die Liste aller symbolischen  Fehlernamen  und  der  entsprechenden
       Fehlernummern mittels des Befehls errno(1) (Teil des Pakets moreutils) erhalten werden:

           $ errno -l
           EPERM 1 Die Operation ist nicht erlaubt
           ENOENT 2 Datei oder Verzeichnis nicht gefunden
           ESRCH 3 Kein passender Prozess gefunden
           EINTR 4 Unterbrechung während des Betriebssystemaufrufs
           EIO 5 Eingabe-/Ausgabefehler
           …

       Der  Befehl  errno(1)  kann  auch  zum Nachschlagen einzelner Fehlernummern und -namen und der Suche nach
       Zeichenketten aus den Fehlerbeschreibungen wie in dem nachfolgenden Beispiel verwandt werden:

           $ errno 2
           ENOENT 2 Datei oder Verzeichnis nicht gefunden
           $ errno ESRCH
           ESRCH 3 Kein passender Prozess gefunden
           $ errno -s Berechtigung
           EACCES 13 Keine Berechtigung

   Liste der Fehlernamen
       In der nachfolgenden Liste der symbolischen Fehlernamen sind verschiedene Namen wie folgt gekennzeichnet:

       POSIX.1-2001
              Der Name ist durch POSIX.1-2001 definiert und wird in neueren POSIX.1-Versionen  definiert,  außer
              es ist anderweitig angegeben.

       POSIX.1-2008
              Der Name ist in POSIX.1-2008 definiert, war aber nicht in älteren POSIX.1-Standards verfügbar.

       C99    Der Name ist durch C99 definiert.

       Es folgt eine Liste von symbolischen Fehlernamen, die unter Linux definiert sind:

       E2BIG           Argumentliste zu lang (POSIX.1-2001)

       EACCES          Keine Berechtigung (POSIX.1-2001)

       EADDRINUSE      Adresse schon in Gebrauch (POSIX.1-2001)

       EADDRNOTAVAIL   Adresse nicht verfügbar (POSIX.1-2001)

       EAFNOSUPPORT    Adressfamilie nicht unterstützt (POSIX.1-2001)

       EAGAIN          Ressource  zeitweise  nicht  verfügbar  (darf  der  gleiche  Wert  wie  EWOULDBLOCK sein,
                       POSIX.1-2001)

       EALREADY        Verbindung ist schon aufgebaut (POSIX.1-2001)

       EBADE           Austausch ungültig

       EBADF           Schlechter Dateideskriptor (POSIX.1-2001)

       EBADFD          Dateideskriptor in schlechtem Zustand

       EBADMSG         Ungültige Nachricht (POSIX.1-2001)

       EBADR           Ungültiger Anforderungsdeskriptor

       EBADRQC         Ungültiger Anforderungscode

       EBADSLT         Ungültiger Slot

       EBUSY           Gerät oder Ressource beschäftigt/belegt (POSIX.1-2001)

       ECANCELED       Aktion abgebrochen (POSIX.1-2001)

       ECHILD          Keine Kindprozesse (POSIX.1-2001)

       ECHRNG          Kanalnummer außerhalb des zulässigen Bereichs

       ECOMM           Kommunikationsfehler beim Senden

       ECONNABORTED    Verbindung abgebrochen (POSIX.1-2001)

       ECONNREFUSED    Verbindung abgelehnt (POSIX.1-2001)

       ECONNRESET      Verbindung zurückgesetzt (POSIX.1-2001)

       EDEADLK         Verklemmung beim Zugriff auf eine Resource (deadlock) vermieden (POSIX.1-2001)

       EDEADLOCK       Auf den meisten Architekturen ein Synonym für EDEADLK.  Auf  einigen  Architekturen  (zum
                       Beispiel  Linux MIPS, PowerPC, SPARC) ist es ein separater Fehlercode »Verklemmungsfehler
                       bei Dateisperrung«.

       EDESTADDRREQ    Zieladresse erforderlich (POSIX.1-2001)

       EDOM            Argument einer mathematischen Funktion außerhalb des Definitionsbereichs (POSIX.1, C99)

       EDQUOT          Festplattenkontingent (disk quota) überschritten (POSIX.1-2001)

       EEXIST          Datei schon vorhanden (POSIX.1-2001)

       EFAULT          Ungültige Adresse (POSIX.1-2001)

       EFBIG           Datei zu groß (POSIX.1-2001)

       EHOSTDOWN       Host/Rechner ist nicht in Betrieb

       EHOSTUNREACH    Host/Rechner nicht erreichbar (POSIX.1-2001)

       EHWPOISON       Speicherseite hat einen Hardware-Fehler

       EIDRM           Identifier/Bezeichner/Kennung entfernt (POSIX.1-2001)

       EILSEQ          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.

       EINPROGRESS     Aktion wird gerade ausgeführt (POSIX.1-2001)

       EINTR           Unterbrochener Funktionsaufruf (POSIX.1-2001); siehe signal(7)

       EINVAL          Ungültiges Argument (POSIX.1-2001)

       EIO             Ein-/Ausgabefehler (POSIX.1-2001)

       EISCONN         Socket ist verbunden (POSIX.1-2001)

       EISDIR          Ist ein Verzeichnis (POSIX.1-2001)

       EISNAM          Ist eine Datei benannten Typs

       EKEYEXPIRED     Schlüssel ist abgelaufen

       EKEYREJECTED    Schlüssel wurde vom Dienst zurückgewiesen

       EKEYREVOKED     Schlüssel wurde widerrufen

       EL2HLT          Stufe 2 angehalten

       EL2NSYNC        Stufe 2 nicht synchronisiert

       EL3HLT          Stufe 3 angehalten

       EL3RST          Stufe 3 zurückgesetzt

       ELIBACC         Zugriff auf notwendige dynamische Bibliothek nicht möglich

       ELIBBAD         Zugriff auf eine beschädigte dynamische Bibliothek

       ELIBMAX         Versuch, zu viele dynamische Bibliotheken zu linken

       ELIBSCN         Abschnitt .lib in a.out defekt

       ELIBEXEC        Eine dynamische Bibliothek kann nicht direkt ausgeführt werden

       ELNRNG          Link-Nummer außerhalb des zulässigen Bereichs

       ELOOP           Zu viele Ebenen von symbolischen Links (POSIX.1-2001)

       EMEDIUMTYPE     Falscher Medientyp

       EMFILE          Zu  viele offene Dateien (POSIX.1-2001). Typischerweise wird dies durch Überschreiten der
                       in getrlimit(2) beschriebenen Ressourcenbegrenzung RLIMIT_NOFILE hervorgerufen.  Es  kann
                       aber  auch  durch  Überschreiten  der  in  /proc/sys/fs/nr_open festgelegten Beschränkung
                       hervorgerufen werden.

       EMLINK          Zu viele Links (POSIX.1-2001)

       EMSGSIZE        Nachricht zu lang (POSIX.1-2001)

       EMULTIHOP       Multihop (mehrere Etappen) versucht (POSIX.1-2001)

       ENAMETOOLONG    Dateiname zu lang (POSIX.1-2001)

       ENETDOWN        Netzwerk außer Betrieb (POSIX.1-2001)

       ENETRESET       Verbindungsabbruch durch das Netzwerk (POSIX.1-2001)

       ENETUNREACH     Netzwerk nicht erreichbar (POSIX.1-2001)

       ENFILE          Zu viele offene Dateien (POSIX.1-2001). Unter Linux ist dies wahrscheinlich ein  Ergebnis
                       der Beschränkung /proc/sys/fs/file-max (siehe proc(5)).

       ENOANO          Keine Anode

       ENOBUFS         Kein Platz für Puffer verfügbar (POSIX.1 (XSI-STREAMS-Option))

       ENODATA         Das  benannte  Attribut  existiert  nicht  oder der Prozess hat keinen Zugriff auf dieses
                       Attribut; siehe xattr(7).

                       In POSIX.1-2001 (Option »XSI STREAMS«) wurde dieser Fehler als »No message  is  available
                       on the STREAM head read queue« beschrieben.

       ENODEV          Kein solches Gerät vorhanden (POSIX.1-2001)

       ENOENT          Keine solche Datei oder kein solches Verzeichnis vorhanden (POSIX.1-2001)

                       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.

       ENOEXEC         Fehler im Format der Programmdatei (POSIX.1-2001)

       ENOKEY          Erforderlicher Schlüssel nicht verfügbar

       ENOLCK          Keine Sperren verfügbar (POSIX.1-2001)

       ENOLINK         Link wurde abgetrennt (POSIX.1-2001)

       ENOMEDIUM       Kein Medium gefunden

       ENOMEM          Nicht genügend Platz/Nicht genügend Hauptspeicher verfügbar (POSIX.1-2001)

       ENOMSG          Keine Nachricht vom gewünschten Typ (POSIX.1-2001)

       ENONET          Machine ist nicht an das Netzwerk angeschlossen

       ENOPKG          Paket nicht installiert

       ENOPROTOOPT     Protokoll nicht verfügbar (POSIX.1-2001)

       ENOSPC          Auf dem Gerät ist kein Speicherplatz mehr verfügbar (POSIX.1-2001)

       ENOSR           Keine STREAM-Ressourcen (POSIX.1 (Option XSI STREAMS))

       ENOSTR          Ist kein STREAM (POSIX.1 (XSI-STREAMS-Option))

       ENOSYS          Funktion nicht implementiert (POSIX.1-2001)

       ENOTBLK         Blockgerät erforderlich

       ENOTCONN        Der Socket ist nicht verbunden (POSIX.1-2001)

       ENOTDIR         Ist kein Verzeichnis (POSIX.1-2001)

       ENOTEMPTY       Das Verzeichnis ist nicht leer (POSIX.1-2001)

       ENOTRECOVERABLE Zustand nicht wiederherstellbar (POSIX.1-2008)

       ENOTSOCK        Ist kein Socket (POSIX.1-2001)

       ENOTSUP         Aktion wird nicht unterstützt (POSIX.1-2001)

       ENOTTY          Unpassende E/A-Steuerungsaktion (POSIX.1-2001)

       ENOTUNIQ        Name ist im Netzwerk nicht eindeutig

       ENXIO           Kein solches Gerät/Adresse (POSIX.1-2001)

       EOPNOTSUPP      Aktion für Sockets nicht unterstützt (POSIX.1-2001)

                       (ENOTSUP  und  EOPNOTSUPP  haben auf Linux den gleichen Wert, gemäß POSIX.1 sollten diese
                       Fehlerwerte unterschiedlich sein.)

       EOVERFLOW       Wert zu groß für Speicherung im Datentyp (POSIX.1-2001)

       EOWNERDEAD      Eigentümer verstarb (POSIX.1-2008)

       EPERM           Aktion nicht gestattet (POSIX.1-2001)

       EPFNOSUPPORT    Protokollfamilie nicht unterstützt

       EPIPE           Pipe unterbrochen (POSIX.1-2001)

       EPROTO          Protokollfehler (POSIX.1-2001)

       EPROTONOSUPPORT Protokoll nicht unterstützt (POSIX.1-2001)

       EPROTOTYPE      Falscher Protokolltyp für Socket (POSIX.1-2001)

       ERANGE          Ergebnis zu groß (POSIX.1, C99)

       EREMCHG         Adresse in der Ferne geändert

       EREMOTE         Objekt ist in der Ferne/nicht lokal

       EREMOTEIO       E/A-Fehler in der Ferne

       ERESTART        Unterbrochener Systemaufruf sollte erneut gestart werden

       ERFKILL         Aktion aufgrund von RF-Kill nicht möglich

       EROFS           Nur-lesbares Dateisystem (POSIX.1-2001)

       ESHUTDOWN       Senden nach Herunterfahren des Transport-Endpunktes nicht möglich

       ESPIPE          Ungültiger Seek (POSIX.1-2001)

       ESOCKTNOSUPPORT Socket-Typ nicht unterstützt

       ESRCH           Kein solcher Prozess vorhanden (POSIX.1-2001)

       ESTALE          Veraltete Dateizugriffsnummer (file handle) (POSIX.1-2001)

                       Dieser Fehler kann für NFS- und für andere Dateisysteme auftreten.

       ESTRPIPE        Stream-Pipe-Fehler

       ETIME           Timer abgelaufen (POSIX.1 (XSI-STREAMS-Option))

                       (POSIX.1 nennt das »STREAM ioctl(2)-Zeitüberschreitung«)

       ETIMEDOUT       Verbindung ist abgelaufen (POSIX.1-2001)

       ETOOMANYREFS    Zu viele Referenzen: Zusammenfügen nicht möglich

       ETXTBSY         Textdatei belegt (POSIX.1-2001)

       EUCLEAN         Struktur muss aufgeräumt werden

       EUNATCH         Kein zugeordneter Treiber für Protokoll

       EUSERS          Zu viele Benutzer

       EWOULDBLOCK     Aktion würden blockieren (kann der gleiche Wert wie EAGAIN sein) (POSIX.1-2001)

       EXDEV           Ungültiger Geräte-Querverweis (POSIX.1-2001)

       EXFULL          Austausch/Vermittlungsstelle voll

ANMERKUNGEN

       Ein verbreiteter Programmierfehler ist

           if (somecall() == -1) {
               printf("somecall() fehlgeschlagen\n");
               if (errno == …) { … }
           }

       Hier muss errno nicht mehr den Wert haben, den er bei der Rückkehr aussomecall() hatte. (D.h.,  der  Wert
       konnte  durch  den  Aufruf  von  printf(3)  verändert  werden).  Wenn  der  Wert  von  errno  über  einen
       Bibliotheksaufruf erhalten bleiben soll, muss er gespeichert werden:

           if (somecall() == -1) {
               int errsv = errno;
               printf("somecall() fehlgeschlagen\n");
               if (errsv == ...) { ... }
           }

       Beachten Sie, dass POSIX-Thread-APIs errno  im  Fehlerfall  nicht  setzen.  Stattdessen  liefern  sie  im
       Fehlerfall  eine  Fehlernummer  als  Funktionsergebnis  zurück.  Diese  Fehlernummern  haben die gleichen
       Bedeutungen wie die in errno durch andere APIs zurückgelieferten Fehlernummern.

       Bei einigen Uraltsystemen war <errno.h> nicht vorhanden  oder  deklarierte  errno  nicht,  so  dass  eine
       manuelle Deklaration von errno notwendig war (d.h. extern int errno). Machen Sie das nicht. Das ist schon
       seit langer Zeit nicht mehr notwendig und wird bei  modernen  Versionen  der  C-Bibliothek  zu  Problemen
       führen.

SIEHE AUCH

       errno(1), err(3), error(3), perror(3), strerror(3)

ÜBERSETZUNG

       Die    deutsche    Übersetzung    dieser    Handbuchseite    wurde    von    Martin    Eberhard   Schauer
       <Martin.E.Schauer@gmx.de>,  Mario  Blättermann  <mario.blaettermann@gmail.com>   und   Helge   Kreutzmann
       <debian@helgefjell.de> erstellt.

       Diese  Übersetzung  ist  Freie  Dokumentation;  lesen  Sie  die  GNU  General  Public  License  Version 3
       ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ 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 die
       Mailingliste der Übersetzer ⟨debian-l10n-german@lists.debian.org⟩.