Provided by:
manpages-de-dev_0.10-1_all 
BEZEICHNUNG
adjtimex - Kernel-Uhr einstellen
"UBERSICHT
#include <sys/timex.h>
int adjtimex(struct timex *buf);
BESCHREIBUNG
Linux verwendet den Algorithmus von David L. Mills fur die Einstellung
von Uhren (siehe RFC 1305). Der Systemaufruf adjtimex() liest und setzt
optional Einstellparameter fur diesen Algorithmus. Ihm wird ein Zeiger
auf eine Struktur timex ubergeben, aus deren Feldwerten er
Kernel-Parameter aktualisiert. AbschlieBend werden die geanderten
Parameter in der gleichen Struktur zuruckgegeben. Die Struktur ist wie
folgt deklariert:
struct timex
{
int mode; /* Auswahl des Modus */
long offset; /* Zeit-Offset (usek) */
long frequency; /* Frequenz-Offset (skalierte ppm) */
long maxerror; /* maximaler Fehler (usek) */
long esterror; /* geschatzter Fehler (usek) */
int status; /* Uhrbefehl/-status */
long time_constant; /* PLL-Zeitkonstante */
long precision; /* Uhrprazision (usek,
nur lesbar) */
long tolerance; /* Toleranz der Uhrfrequenz (ppm,
nur lesbar) */
struct timeval time; /* aktuelle Zeit (nur lesbar) */
long tick; /* usek zwischen Uhrticks */
};
Das Feld modes bestimmt, welche Parameter, falls vorhanden, zu setzen
sind. Es darf eine bitweise Oder-Verknupfung von Null oder mehr der
folgenden Bits enthalten:
#define ADJ_OFFSET 0x0001 /* Zeit-Offset */
#define ADJ_FREQUENCY 0x0002 /* Frequenz-Offset */
#define ADJ_MAXERROR 0x0004 /* maximaler Zeitfehler */
#define ADJ_ESTERROR 0x0008 /* geschatzter Zeitfehler */
#define ADJ_STATUS 0x0010 /* Uhrstatus */
#define ADJ_TIMECONST 0x0020 /* PLL-Zeitkonstante */
#define ADJ_TICK 0x4000 /* Tickwert */
#define ADJ_OFFSET_SINGLESHOT 0x8001 /* altmodisches adjtime() */
Normale Benutzer sind eingeschrankt auf einen Nullwert fur mode. Nur
der Superuser darf Parameter setzen.
R"UCKGABEWERT
Bei Erfolg gibt adjtimex() den Status der Uhr zuruck:
#define TIME_OK 0 /* Uhr synchronisiert */
#define TIME_INS 1 /* fugt Schaltsekunde ein */
#define TIME_DEL 2 /* loscht Schaltsekunde */
#define TIME_OOP 3 /* Schaltsekunde in Betrieb */
#define TIME_WAIT 4 /* Schaltsekunde ist aufgetreten */
#define TIME_BAD 5 /* Uhr nicht synchronisiert */
Im Fehlerfall gibt adjtimex -1 zuruck und setzt errno.
FEHLER
EFAULT buf zeigt nicht auf beschreibbaren Speicher.
EINVAL Es wurde versucht, buf.offset auf einen Wert auBerhalb des
Bereichs von -131071 bis +131071 zu setzen, buf.status auf einen
nicht oben aufgefuhrten Wert zu setzen oder buf.tick auf einen
Wert auBerhalb des Bereichs von 900000/HZ bis 1100000/HZ zu
setzen, wobei HZ die Interruptfrequenz des System-Zeitgebers
ist.
EPERM buf.mode ist ungleich Null und der aufrufende Prozess verfugt
nicht uber ausreichende Privilegien. Unter Linux ist die
CAP_SYS_TIME-Fahigkeit erforderlich.
KONFORM ZU
adjtimex() ist Linux-spezifisch und sollte nicht fur portable Programme
verwendet werden. adjtime(3) bietet eine besser portierbare, aber
weniger flexible Methode fur die Einstellung der Systemuhr.
SIEHE AUCH
settimeofday(2), adjtime(3), capabilities(7), time(7)
KOLOPHON
Diese Seite ist Teil der Veroffentlichung 3.32 des Projekts
Linux-man-pages. Eine Beschreibung des Projekts und Informationen, wie
Fehler gemeldet werden konnen, finden sich unter
http://www.kernel.org/doc/man-pages/.
"UBERSETZUNG
Die deutsche Ubersetzung dieser Handbuchseite wurde von Patrick Rother
<krd@gulu.net> und Martin Eberhard Schauer <Martin.E.Schauer@gmx.de>
erstellt.
Diese Ubersetzung ist Freie Dokumentation; lesen Sie die GNU General
Public License Version 3 oder neuer bezuglich der Copyright-
Bedingungen. Es wird KEINE HAFTUNG ubernommen.
Wenn Sie Fehler in der Ubersetzung dieser Handbuchseite finden,
schicken Sie bitte eine E-Mail an <debian-l10n-
german@lists.debian.org>.