BEZEICHNUNG

       perror - eine Systemfehlermeldung ausgeben

ÜBERSICHT

       #include <stdio.h>

       void perror(const char *s);

       #include <errno.h>

       const char * const sys_errlist[];
       int sys_nerr;
       int errno; /* Nicht wirklich auf diese Weise deklariert; siehe errno(3). */

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

       sys_errlist, sys_nerr: _BSD_SOURCE

BESCHREIBUNG

       The  perror()  function produces a message on standard error describing the last error encountered during
       a call to a system or library function.

       First (if s is not NULL and *s is not a null byte ('\0')), the argument string s is printed, followed  by
       a colon and a blank. Then an error message corresponding to the current value of errno and a new-line.

       To be of most use, the argument string should include the name of the function that incurred the error.

       The  global  error  list  sys_errlist[],  which  can be indexed by errno, can be used to obtain the error
       message without the newline. The largest message number provided in the table is sys_nerr-1.  Be  careful
       when directly accessing this list, because new error values may not have been added to sys_errlist[]. The
       use of sys_errlist[] is nowadays deprecated.

       When  a  system  call fails, it usually returns -1 and sets the variable errno to a value describing what
       went wrong. (These values can be found in <errno.h>.) Many library functions do  likewise.  The  function
       perror()   serves  to  translate  this  error code into human-readable form. Note that errno is undefined
       after a successful sysme call or library function call: this call may well  change  this  variable,  even
       though it succeeds, for example because it internally used some other library function that failed. Thus,
       if a failing call is not immediately followed by a call to perror(), the value of errno should be saved.

ATTRIBUTE

       Siehe attributes(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke.
       ┌───────────────┬───────────────────────┬─────────────────────┐
       │ Schnittstelle │ Attribut              │ Wert                │
       ├───────────────┼───────────────────────┼─────────────────────┤
       │ perror()      │ Multithread-Fähigkeit │ MT-Safe race:stderr │
       └───────────────┴───────────────────────┴─────────────────────┘

KONFORM ZU

       perror(), errno: POSIX.1-2001, POSIX.1-2008, C89, C99, 4.3BSD.

       The externals sys_nerr and sys_errlist derive from BSD, but are not specified in POSIX.1.

ANMERKUNGEN

       Die externen sys_nerr und sys_errlist sind durch Glibc definiert, befinden sich aber in <stdio.h>.

SIEHE AUCH

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

KOLOPHON

       Diese  Seite  ist  Teil  der  Veröffentlichung  4.04  des Projekts Linux-man-pages. Eine Beschreibung des
       Projekts, Informationen, wie Fehler gemeldet werden können sowie die aktuelle Version dieser Seite finden
       sich unter http://www.kernel.org/doc/man-pages/.

ÜBERSETZUNG

       Die deutsche Übersetzung dieser Handbuchseite wurde von Patrick  Rother  <krd@gulu.net>,  Martin  Schulze
       <joey@infodrom.org>,      Chris      Leick      <c.leick@vollbio.de>      und      Mario      Blättermann
       <mario.blaettermann@gmail.com> 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>.

                                                  23. Juli 2015                                        PERROR(3)