ksettimer-Kernel-Service

Zweck

Legt den systemweiten Zeitgeber für die Tageszeit fest.

Syntax

#include <sys/types.h>
#include <sys/errno.h>
#include <sys/time.h>

int ksettimer (nct) 
struct timestruc_t *nct;

Parameter

Element	Beschreibung
NCT	Verweist auf eine Zeitstruktur_t -Struktur, die die neue aktuelle Zeit enthält, die festgelegt werden soll Das Nanosekundenelement dieser Struktur ist nur gültig, wenn es größer-gleich 0 und kleiner als die Anzahl der Nanosekunden in einer Sekunde ist.

Beschreibung

Der ksettimer -Kernel-Service bietet eine Kernelerweiterung mit der Möglichkeit, den systemweiten Zeitgeber für die Tageszeit festzulegen. Kernelerweiterungen verwenden in der Regel diesen Kernel-Service, um die netzkoordinierte Zeit zu unterstützen. Dies ist die periodische Synchronisation aller Systemuhren mit einer gemeinsamen Zeit durch einen Zeitserver oder eine Gruppe von Zeitservern in einem Netz. Die neu festgelegte "aktuelle" Zeit muss die Zeit seit 00:00:00 GMT, 1. Januar 1970 darstellen.

Ausführungsumgebung

Der ksettimer -Kernel-Service kann nur aus der Prozess -Umgebung aufgerufen werden.

Rückgabewerte

Element	Beschreibung
0	Zeigt an, dass der Befehl erfolgreich ausgeführt wurde.
EINVAL	Gibt an, dass die mit dem Parameter NCT angegebene neue aktuelle Zeit außerhalb des Bereichs des systemweiten Zeitgebers liegt.
EIO	Zeigt an, dass beim Zugriff dieses Kernel-Service auf die Zeitgebereinheit ein Fehler aufgetreten ist.