gettimeofday(3C)                                           gettimeofday(3C)

NAME
     gettimeofday, settimeofday - Datum und Zeit lesen und setzen

SYNTAX
     #include <sys/time.h>

     int gettimeofday(struct timeval *tp, void *tzp);

     int settimeofday(struct timeval *tp);

BESCHREIBUNG
     gettimeofday() liest und settimeofday() setzt die aktuelle Zeit für
     das System. Die aktuelle Zeit wird in verstrichenen Sekunden und
     Mikrosekunden seit dem 1. Januar 1970, 00:00 (Coordinated Universal
     Time) angegeben. Die Auflösung der Systemuhr ist hardwareabhängig; die
     Zeit kann stetig oder in Zeittakten aktualisiert werden.

     tp zeigt auf eine Struktur vom Typ timeval, welche die folgenden Kom-
     ponenten enthält:

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

     Wenn tp ein Nullzeiger ist, wird die aktuelle Zeit weder gelesen 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 privilegierte Benutzer können die Zeit einstellen.

ERGEBNIS
     Der Rückgabewert -1 zeigt an, daß ein Fehler aufgetreten ist; errno
     wird dann gesetzt. Die folgenden Fehlercodes sind für errno möglich:

     EINVAL    tp gibt eine ungültige Zeit an.

     EPERM     Ein nichtprivilegierter Benutzer hat versucht, die Zeit oder
               die Zeitzone einzustellen.

HINWEISE
     Die Implementierung von settimeofday() ignoriert das Feld tvusec von
     tp. Wenn die Zeit mit größerer Genauigkeit als einer Sekunde einge-
     stellt werden muß, sollte settimeofday() für die Sekunden und danach
     adjtime() für die Feinabstimmung verwendet werden.

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





Seite 1                      Reliant UNIX 5.44               Gedruckt 11/98