BEZEICHNUNG

       strerror, strerror_r - gibt eine Zeichenkette zurück, die den Fehlercode beschreibt

ÜBERSICHT

       #include <string.h>

       char *strerror(int errnum);

       int strerror_r(int errnum, char *buf, size_t buflen);
                   /* XSI-konform */

       char *strerror_r(int errnum, char *buf, size_t buflen);
                   /* GNU-spezifisch */

   Mit Glibc erforderliche Makros (siehe feature_test_macros(7)):

       Die XSI-konforme Version von strerror_r() wird bereitgestellt, falls:
       (_POSIX_C_SOURCE >= 200112L || _XOPEN_SOURCE >= 600) && ! _GNU_SOURCE
       Anderenfalls wird die GNU-spezifische Version bereitgestellt.

BESCHREIBUNG

       Die  Funktion strerror() gibt einen Zeiger auf eine Zeichenkette mit der Beschreibung des Fehlercodes für
       das übergebene Argument errnum zurück. Möglicherweise wertet sie dabei den LC_MESSAGES-Teil der aktuellen
       Locale aus, um die passende Sprache zu wählen. (Falls beispielsweise errnum EINVAL  ist,  dann  wird  die
       zurückgelieferte  Beschreibung »Invalid argument« sein.). Diese Zeichenkette darf nicht von der Anwendung
       verändert werden, wohl aber von einem nachfolgenden Aufruf von strerror(). Diese  Zeichenkette  wird  von
       keiner Bibliotheksfunktion, inklusive perror(3), verändert.

       Die  Funktion strerror_r() ähnelt strerror(), ist aber threadsicher. Diese Funktion ist in zwei Versionen
       verfügbar: eine in POSIX.1-2001 beschriebene XSI-konforme Version (verfügbar seit Glibc 2.3.4,  aber  vor
       Glibc  2.13  nicht  POSIX-konform)  und  eine  GNU-spezifische  Version  (verfügbar  seit Glibc 2.0). Die
       XSI-konforme Version  wird  durch  die  in  der  ÜBERSICHT  angegebenen   Feature-Test-Makroeinstellungen
       bereitgestellt;    anderenfalls    wird    die   GNU-Version   verwendet.   Ohne   explizit   vereinbarte
       Feature-Test-Makros wird (seit Glibc 2.4) standardmäßig _POSIX_SOURCE mit dem Wert 200112L belegt, sodass
       standardmäßig die XSI-Variante von strerror_r() verwendet wird.

       Die XSI-konforme strerror_r() ist für portable Anwendungen vorzuziehen. Sie gibt  die  Fehlerzeichenkette
       im vom Nutzer bereitgestellten Puffer buf der Länge buflen zurück.

       Die  GNU-spezifische strerror_r() gibt einen Zeiger auf eine Zeichenkette zurück, die die Fehlernachricht
       enthält. Dies kann entweder ein Zeiger auf eine Zeichenkette sein, die die  Funktion  in  buf  speichert,
       oder  ein  Zeiger  auf  irgendeine  (unveränderbare  statische) Zeichenkette(wobei dann buf nicht genutzt
       wird). Wenn die Funktion in buf eine Zeichenkette speichert, werden höchstens  buflen  Bytes  gespeichert
       (die  Zeichenkette  kann gekürzt werden, wenn buflen zu klein und errnum unbekannt ist). Die Zeichenkette
       enthält immer ein abschließendes Null-Byte ('\0').

RÜCKGABEWERT

       Die Funktionen strerror() und die GNU-spezifische strerror_r() gibt die  entsprechende  Zeichenkette  mit
       der  Fehlerbeschreibung  zurück  oder  eine  Nachricht  »Unbekannter  Fehler  nnn«, wenn die Fehlernummer
       unbekannt ist.

       POSIX.1-2001 und POSIX.1-2008 verlangen, dass ein erfolgreicher Aufruf von strerror()  errno  unverändert
       belässt.  Sie  merken  an,  dass wegen des nicht definierten Rückgabewerts zur Anzeige eines Fehlers eine
       Anwendung zur Fehlerprüfung vor dem Aufruf errno auf Null setzen und nach dem Aufruf überprüfen sollte.

       Die XSI-konforme Funktion strerror_r() gibt bei  Erfolg  0  zurück.  Im  Fehlerfall  wird  eine  positive
       Fehlernummer  (seit  Glibc  2.13)  oder  -1 zurückgegeben und errno mit einem Wert belegt, der den Fehler
       angibt (Glibc vor Version 2.13).

FEHLER

       EINVAL Der Wert von errnum ist keine gültige Fehlernummer.

       ERANGE Es wurde unzureichender Speicher für die Aufnahme der Fehler-Zeichenkette bereitgestellt.

ATTRIBUTE

   Multithreading (see pthreads(7))
       The strerror()  function is not thread-safe.

       The strerror_r()  function is thread-safe.

KONFORM ZU

       strerror() wird von POSIX.1-2001, C89, C99 spezifiziert. strerror_r() wird von POSIX.1-2001 spezifiziert.

       Die GNU-spezifische Funktion strerror_r() ist eine nicht standardisierte Erweiterung.

       POSIX.1-2001 gestattet strerror() das Setzen von errno wenn der Aufruf einen Fehler  bewirkt,  gibt  aber
       nicht  vor,  welchen  Wert  die  Funktion  im  Fehlerfall  zurückgeben  sollte. Auf einigen Systemen gibt
       strerror() NULL zurück, wenn die Fehlernummer nicht bekannt ist. Auf  anderen  Systemen  gibt  strerror()
       eine  Meldung  etwa  wie  »Fehler  nnn  aufgetreten«  und  setzt  errno auf EINVAL, wenn die Fehlernummer
       unbekannt ist. C99 und POSIX.1-2008 verlangen, dass der Rückgabewert von NULL verschieden ist.

SIEHE AUCH

       err(3), errno(3), error(3), perror(3), strsignal(3)

KOLOPHON

       This page is part of release 3.54 of the Linux man-pages project.  A  description  of  the  project,  and
       information about reporting bugs, can be found at http://www.kernel.org/doc/man-pages/.

ÜBERSETZUNG

       Die deutsche Übersetzung dieser Handbuchseite wurde von Martin Eberhard Schauer <Martin.E.Schauer@gmx.de>
       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
       <debian-l10n-german@lists.debian.org>.

                                                  21. Juni 2013                                      STRERROR(3)