.\" -*- coding: UTF-8 -*- '\" t .\" Copyright (c) 2006 by Michael Kerrisk .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH adjtime 3 "20. Juli 2023" "Linux man\-pages 6.05.01" .SH BEZEICHNUNG adjtime \- Die Zeit zur Synchronisierung der Systemuhr korrigieren .SH BIBLIOTHEK Standard\-C\-Bibliothek (\fIlibc\fP, \fI\-lc\fP) .SH ÜBERSICHT .nf \fB#include \fP .PP \fBint adjtime(const struct timeval *\fP\fIDelta\fP\fB, struct timeval *\fP\fIAltesdelta\fP\fB);\fP .fi .PP .RS -4 Mit Glibc erforderliche Feature\-Test\-Makros (siehe \fBfeature_test_macros\fP(7)): .RE .PP \fBadjtime\fP(): .nf Seit Glibc 2.19: _DEFAULT_SOURCE Glibc 2.19 und älter: _BSD_SOURCE .fi .SH BESCHREIBUNG Die Funktion \fBadjtime\fP() passt die Systemuhr (wie mittels \fBgettimeofday\fP(2) zurückgeliefert) graduell an. Der Zeitumfang, mit dem die Uhr angepasst werden soll, wird in der Struktur festgelegt, auf die \fIDelta\fP zeigt. Diese Struktur hat die folgende Form: .PP .in +4n .EX struct timeval { time_t tv_sec; /* Sekunden */ suseconds_t tv_usec; /* Mikrosekunden */ }; .EE .in .PP Falls die Anpassung in \fIDelta\fP positiv ist, dann wird die Systemuhr nur um einen kleinen Prozentsatz (d.h. jede Sekunde durch Hinzufügen einer kleinen Zeiteinheit zum Uhrenwert) beschleunigt, bis die Anpassung abgeschlossen ist. Falls die Anpassung in \fIDelta\fP negativ ist, wird die Uhr auf eine ähnliche Art verlangsamt. .PP Falls eine Uhranpassung von einem früherern Aufruf von \fBadjtime\fP() breits zum Zeitpunkt eines späteren Aufrufs von \fBadjtime\fP() in Arbeit ist und \fIDelta\fP beim späteren Aufruf nicht NULL ist, dann wird die frühere Anpassung gestoppt, aber der bereits durchgeführte Anteil der Anpassung wird nicht zurückgenommen. .PP Falls \fIAltesdelta\fP nicht NULL ist, dann wird der Puffer, auf den es zeigt, zur Rückgabe der Zeitmenge verwandt, die von vorhergehenden, noch nicht abgeschlossenen Anpassungen verbleibt. .SH RÜCKGABEWERT Bei Erfolg gibt die Funktion \fBadjtime\fP() 0 zurück. Bei einem Fehler wird \-1 zurückgegeben und \fIerrno\fP gesetzt, um den Fehler anzuzeigen. .SH FEHLER .TP \fBEINVAL\fP Die Anpassung in \fIDelta\fP ist außerhalb des erlaubten Bereichs. .TP \fBEPERM\fP Der Aufrufende hat keine ausreichenden Privilegien zur Zeitanpassung. Unter Linux wird die Capability \fBCAP_SYS_TIME\fP benötigt. .SH ATTRIBUTE Siehe \fBattributes\fP(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke. .TS allbox; lbx lb lb l l l. Schnittstelle Attribut Wert T{ .na .nh \fBadjtime\fP() T} Multithread\-Fähigkeit MT\-Sicher .TE .sp 1 .SH STANDARDS Keine. .SH GESCHICHTE 4.3BSD, System V. .SH ANMERKUNGEN Die von \fBadjtime\fP() vorgenommenen Anpassungen der Uhr werden so ausgeführt, dass die Uhr immer monoton fortschreitet. Mit der Zeitanpassung durch \fBadjtime\fP() werden für bestimmte Anwendungen (z.B. \fBmake\fP(1)) Probleme vermieden, die durch plötzliche positive oder negative Sprünge der Systemzeit hervorgerufen werden. .PP \fBadjtime\fP() ist zur Durchführung kleiner Anpassungen der Systemzeit gedacht. Die meisten Systeme beschränken die in \fIDelta\fP mögliche Anpassung. In der Glibc\-Implementierung muss \fIDelta\fP kleiner oder gleich (INT_MAX / 1000000 \- 2) und größer oder gleich (INT_MIN / 1000000 + 2) (2145 bzw. \-2145 Sekunden auf I386) sein. .SH FEHLER .\" http://sourceware.org/bugzilla/show_bug?id=2449 .\" http://bugzilla.kernel.org/show_bug.cgi?id=6761 .\" Thanks to the new adjtimex() ADJ_OFFSET_SS_READ flag Lange existierte ein Fehler, der bei der Angabe von \fIDelta\fP als NULL dazu führte, dass keine gültigen Informationen über die ausstehenden Uhranpassungen in \fIAltesdelta\fP zurückgeliefert wurden. (In diesem Fall soll \fBadjtime\fP() die ausstehende Uhranpassung ohne sie zu ändern zurückliefern.) Dieser Fehler wurde in Systemen mit Glibc 2.8 oder neuer und Linux\-Kernel 2.6.26 oder neuer behoben. .SH "SIEHE AUCH" \fBadjtimex\fP(2), \fBgettimeofday\fP(2), \fBtime\fP(7) .PP .SH ÜBERSETZUNG Die deutsche Übersetzung dieser Handbuchseite wurde von Helge Kreutzmann erstellt. .PP Diese Übersetzung ist Freie Dokumentation; lesen Sie die .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License Version 3 .UE oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen. .PP Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die .MT debian-l10n-german@lists.debian.org Mailingliste der Übersetzer .ME .