gettimeofday(3C-ucb)    (BSD Compatibility Package)    gettimeofday(3C-ucb)

NAME
     gettimeofday, settimeofday - Datum und Uhrzeit abrufen oder setzen

SYNTAX
     /usr/ucb/cc [flag ...] file ... -lucb

     #include <sys/time.h>

     int gettimeofday(tp, tzp)
     struct timeval *tp;
     struct timezone *tzp;      /* obsolete */

     int settimeofday(tp, tzp)
     struct timeval *tp;
     struct timezone *tzp;      /* obsolete */

BESCHREIBUNG
     Die aktuelle Uhrzeit für das System wird mit dem Aufruf gettimeofday
     abgerufen und mit dem Aufruf settimeofday gesetzt. Die aktuelle Uhr-
     zeit wird in Sekunden und Mikrosekunden angegeben, die seit dem 1.
     Januar 1970, 00:00 Uhr (WEZ) vergangen sind. Die Schritte der Syste-
     muhr sind hardwareabhängig. Die Zeit kann fortlaufend oder in Zeittak-
     ten (Ticks) aktualisiert werden.

     tp zeigt auf eine Struktur vom Typ timeval, die folgende Elemente ent-
     hält:

          long    tvsec;     /* Sekunden seit 1. Jan. 1970 */
          long    tvusec;    /* und Mikrosekunden */

     Ist tp ein NULL-Zeiger, werden die aktuellen Uhrzeitangaben weder
     zurückgegeben noch gesetzt.

     tzp ist ein veralteter Zeiger, der früher zum Abfragen und Setzen von
     Zeitzonen verwendet wurde. tzp wird jetzt ignoriert. Die Zeitzonen
     werden mit Hilfe der Umgebungsvariablen TZ bearbeitet [siehe
     timezone(4)].

     Nur ein dazu berechtigter Benutzer darf die Tageszeit einstellen.

RÜCKGABEWERT
     Der Return-Wert -1 zeigt an, daß ein Fehler aufgetreten ist. In diesem
     Fall wird ein Fehlercode in der globalen Variablen errno gespeichert.

DIAGNOSE
     Die folgenden Fehlercodes können in errno gesetzt sein:

     EINVAL    tp gibt eine ungültige Uhrzeit an.

     EPERM     Ein nichtberechtigter Benutzer hat versucht, die Uhrzeit
               einzustellen.




Seite 1                      Reliant UNIX 5.44               Gedruckt 11/98

gettimeofday(3C-ucb)    (BSD Compatibility Package)    gettimeofday(3C-ucb)

HINWEISE
     Die Uhrzeit ist nie so genau, daß Sie sich auf die in Mikrosekunden
     angegebenen Werte verlassen können.

     tzp wird ignoriert.

SIEHE AUCH
     date(1), adjtime(2), ctime(3C), gettimeofday(3C), timezone(4).














































Seite 2                      Reliant UNIX 5.44               Gedruckt 11/98