Provided by: manpages-de-dev_2.5-1_all bug

BEZEICHNUNG

       times - Abfrage der Prozesszeiten

ÜBERSICHT

       #include <sys/times.h>

       clock_t times(struct tms *buf);

BESCHREIBUNG

       times()  speichert die aktuellen Prozesszeiten in der Struktur tms, auf die buf weist. Die
       tms-Struktur wird in <sys/times.h> wie folgt definiert:

           struct tms {
              clock_t tms_utime;  /* Benutzer-Zeit */
              clock_t tms_stime;  /* System-Zeit */
              clock_t tms_cutime; /* Benutzer-Zeit der Kindprozesse */
              clock_t tms_cstime; /* System-Zeit der Kindprozesse */
           };

       Das Feld tms_utime enthält die  CPU-Zeit,  die  mit  dem  Ausführen  von  Anweisungen  des
       aufrufenden Prozesses verbracht wurde. Das Feld tms_stime enthält die im Kernel verbrachte
       CPU-Zeit während der Ausführung von Aufgaben im Namen des aufrufenden Prozesses.

       Das Feld tms_cutime enthält die Summe  der  tms_utime-  und  tms_cutime  -Werte  für  alle
       Kindprozesse,  auf  deren  Abschluss gewartet wurde. Das Feld tms_cstime enthält die Summe
       der tms_stime- und tms_cstime-Werte für alle Kindprozesse, auf  deren  Abschluss  gewartet
       wurde.

       Zeiten  für  beendete Kindprozesse (und ihre Nachkommen) werden in dem Moment hinzugefügt,
       wenn wait(2) oder waitpid(2) deren Prozess-IDs zurückgeben. Insbesondere werden die Zeiten
       der Enkel, auf die die Kinder nicht gewarten haben, nicht erfasst.

       Alle Zeiten werden in Uhrticks angegeben.

RÜCKGABEWERT

       times()  gibt  die Zahl der Ticks an, die seit einem beliebigen Punkt in der Vergangenheit
       abgelaufen sind. Der Rückgabewert kann den möglichen Bereich von Typ  clock_t  überlaufen.
       Tritt ein Fehler auf, wird (clock_t) -1 zurückgegeben und errno entsprechend gesetzt.

FEHLER

       EFAULT tms zeigt außerhalb des adressierbaren Adressraums des Prozesses.

KONFORM ZU

       POSIX.1-2001, POSIX.1-2008, SVr4, 4.3BSD.

ANMERKUNGEN

       Die Zahl der Uhrticks pro Sekunde kann wie folgt bestimmt werden:

           sysconf(_SC_CLK_TCK);

       In  POSIX.1-1996  wird das Symbol CLK_TCK (definiert in <time.h>) als veraltet erwähnt. Es
       ist jetzt überholt.

       Falls in Linux-Kernel-Versionen vor 2.6.9  SIGCHLD  SIG_IGN  zugeordnet  ist,  werden  die
       Zeiten  der  beendeten  Kindprozesse  automatisch in den Feldern tms_cstime und tms_cutime
       eingetragen, obwohl POSIX.1-2001 sagt, dass dies nur geschehen soll, wenn  der  aufrufende
       Prozess  (mit  wait(2)) auf seine Kindprozesse wartet. Diese Nichtübereinstimmung wurde in
       Linux 2.6.9 und später behoben.

       Unter Linux kann das Argument buf als  NULL  angegeben  werden,  worauf  times()  nur  ein
       Funktionsergebnis  zurückgibt.  Dieses Verhalten wird aber nicht von POSIX beschrieben und
       die meisten UNIX-Implementierungen erfordern einen von NULL verschiedenen Wert für buf.

       Beachten Sie, dass auch clock(3) einen Wert vom Typ clock_t zurückgibt. Die Maßeinheit für
       diesen Wert ist CLOCKS_PER_SEC, nicht die von times() verwendeten Uhrticks.

       Unter  Linux  hat  sich  der  »beliebige  Punkt  in  der  Vergangenheit«, auf den sich der
       Rückgabewert von times() bezieht, über die Kernel-Versionen geändert. Unter Linux 2.4  und
       früher  war dieser Punkt der Moment, an dem das System gestartet wurde. Seit Linux 2.6 ist
       dieser Punkt (2^32/HZ)  -  300  Sekunden  vor  Systemstart.  Diese  Variabilität  zwischen
       Kernel-Versionen (und über UNIX-Implementierungen) und die Tatsache, dass der Rückgabewert
       den Bereich clock_t überlaufen lassen kann, bedeutet, dass eine  portable  Anwendung  klug
       daran tut, diesen Wert nicht zu verwenden. Um Änderungen der verstrichenen Zeit zu messen,
       verwenden Sie stattdessen clock_gettime(2).

   Geschichtliches
       SVr1-3 gibt long zurück und Bestandteile der Struktur sind  vom  Typ  time_t,  obwohl  sie
       Uhrticks  speichern  und  nicht Sekunden seit dem Beginn der Unix-Zeit. V7 verwendete long
       für die Bestandteile der Struktur, weil es damals noch keinen Typ time_t gab.

FEHLER

       Eine Beschränkung in den Linux-Konventionen für  Systemaufrufe  für  einige  Architekturen
       (insbesondere  i386)  bewirkt  unter  Linux 2.6 ein kleines Zeitfenster (41 Sekunden) kurz
       nach dem Systemstart, in dem times() -1 zurückgeben und damit  fälschlicherweise  anzeigen
       kann,  dass ein Fehler auftrat. Dasselbe Problem kann auftreten, wenn der Rückgabewert den
       größten in clock_t speicherbaren Wert überschreitet.

SIEHE AUCH

       time(1), getrusage(2), wait(2), clock(3), sysconf(3), time(7)

KOLOPHON

       Diese Seite  ist  Teil  der  Veröffentlichung  4.15  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 https://www.kernel.org/doc/man-pages/.

ÜBERSETZUNG

       Die deutsche Übersetzung dieser Handbuchseite wurde von Ralf Demmer  <rdemmer@rdemmer.de>,
       Martin     Eberhard    Schauer    <Martin.E.Schauer@gmx.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>.