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)