adjtime(2) adjtime(2)
NAME
adjtime - Synchronisation mit Systemuhr korrigieren
SYNTAX
#include <sys/time.h>
int adjtime(struct timeval *delta, struct timeval *olddelta);
BESCHREIBUNG
adjtime korrigiert die aktuelle Zeit, die von gettimeofday(3C) zurück-
geliefert wird. Die Zeit wird um den Zeitraum, der in struct timeval
angegeben ist, auf den delta zeigt, verändert.
Die Veränderung wird dadurch erreicht, daß die Systemuhr beschleunigt
oder verzögert wird, abhängig davon, ob der Zeitraum positiv oder
negativ ist. Ist der Zeitraum positiv, läuft die Zeit doppelt so
schnell als vorher. Ist der Zeitraum negativ, läuft die Zeit etwa halb
so schnell. Die Zeit ist immer eine monoton wachsende Funktion. Eine
Zeitkorrektur durch einen vorhergehenden Aufruf von adjtime kann nicht
beendet werden, wenn adjtime nochmals aufgerufen wird. Wenn delta 0
ist, dann liefert olddelta den Status der Wirkung des letzten
adjtime-Aufrufs zurück; dieser Aufruf hat keine Korrekturwirkung. Wenn
olddelta kein Nullzeiger ist, dann enthält die referenzierte Struktur
nach Beendigung des Aufrufs die Anzahl der Sekunden und/oder Mikrose-
kunden, die vom vorhergehenden Aufruf korrigiert wurden. Wenn olddelta
ein Nullzeiger ist, wird die entsprechende Information nicht zurückge-
liefert.
Dieser Aufruf kann für Zeit-Server verwendet werden, welche die Uhren
von Rechnern in lokalen Netzwerken synchronisieren. Solche Zeit-Server
verlangsamen die Uhren auf einigen Maschinen und beschleunigen die
Uhren auf anderen, um eine gemittelte Netzwerk-Zeit einzurichten.
Nur der Systemverwalter kann die Zeit korrigieren.
Der Anpassungswert wird auf die Auflösung der Systemuhr gerundet.
adjtime ist erfolglos, wenn einer oder mehrere der folgenden Punkte
zutreffen:
EFAULT delta oder olddelta zeigt außerhalb des Prozeßbereichs, oder
olddelta zeigt auf einen Prozeßbereich, der nicht beschreib-
bar ist.
EPERM Die effektive Benutzernummer des Prozesses ist nicht die des
Systemverwalters.
ERGEBNIS
Ein Rückgabewert von 0 zeigt an, daß der Aufruf erfolgreich war. -1
zeigt einen Fehler an, dessen Fehlercode aus der globalen Variablen
errno gelesen werden kann.
Seite 1 Reliant UNIX 5.44 Gedruckt 11/98
adjtime(2) adjtime(2)
SIEHE AUCH
date(1), gettimeofday(3C).
Seite 2 Reliant UNIX 5.44 Gedruckt 11/98