TIMEDATECTL(1)

BEZEICHNUNG
timedatectl - Systemdatum und -uhrzeit steuern

ÜBERSICHT

timedatectl [OPTIONEN…] {BEFEHL}

BESCHREIBUNG

timedatectl kann zur Abfrage und Änderung der Systemuhr und ihrer Einstellungen sowie zur (De)aktivierung der Zeitsynchronisationsdienste verwandt werden.

Verwenden Sie systemd-firstboot(1), um die Systemzeitzone für eingehängte (aber nicht gestartete) System-Abbilder zu initialisieren.

timedatectl kann zur Anzeige des aktuellen Status von Zeitsynchronisationsdiensten wie beispielsweise systemd-timesyncd.service(8) verwandt werden.

OPTIONEN

Die folgenden Optionen werden verstanden:

--no-ask-password
    Den Benutzer nicht für Authentifizierung für privilegierte Aktionen befragen.

--adjust-system-clock
    Falls set-local-rtc aufgerufen und diese Option übergeben wird, wird die Systemuhr von der RTC (Echtzeituhr, »Real Time Clock«) erneut synchronisiert. Dabei werden die neuen Einstellungen berücksichtigt. Andernfalls wird die RTC von der Systemuhr synchronisiert.

--monitor
    Falls timesync-status aufgerufen und diese Option übergeben wird, dann überwacht timedatectl den Status von systemd-timesyncd.service(8) und aktualisiert die Ausgaben. Verwenden Sie Strg+C, um die Überwachung zu beenden.

-a, --all
    Beim Zeigen der Eigenschaften von systemd-timesyncd.service(8) werden alle Eigenschaften unabhängig davon, ob sie gesetzt sind oder nicht, angezeigt.

-p, --property=
    Beim Anzeigen der Eigenschaften von systemd-timesyncd.service(8) wird die Anzeige auf bestimmte, als Argument festgelegte Eigenschaften begrenzt. Falls nicht angegeben, werden alle gesetzten Eigenschaften angezeigt. Das Argument sollte ein Eigenschaftsname wie »ServerName« sein. Falls mehr als einmal festgelegt, werden alle Eigenschaften mit den festgelegten Namen angezeigt.

--value
    Wenn Eigenschaften mit show-timesync ausgegeben werden, wird nur der Wert ausgegeben und der Eigenschaftsname und »=« übersprungen.

-H, --host=
    Führt die Aktion aus der Ferne aus. Geben Sie den Rechnernamen oder einen Benutzernamen und Rechnernamen (getrennt durch »@«) an, zu dem verbunden werden soll. Dem Rechnernamen darf optional ein Port, auf dem SSH auf Anfragen wartet, getrennt durch »:« und dann ein Container auf dem festgelegten Host angehängt werden, womit direkt zu einem bestimmten Container auf dem angegebenen Rechner verbunden wird. Dies verwendet SSH, um mit der Maschinen-Verwalterinstanz auf dem Rechner in der Ferne zu kommunizieren. Container-Namen dürfen mit machinectl -H RECHNER aufgezählt werden. Stellen Sie IPv6-Adressen in Klammern.

-M, --machine=
    Führt die Aktion in einem lokalen Container aus. Geben Sie den Namen des Containers an, zu dem verbunden werden soll.

-h, --help
    Zeigt einen kurzen Hilfetext an und beendet das Programm.

--version
    Zeigt eine kurze Versionszeichenkette an und beendet das Programm.

--no-pager
    Die Ausgabe nicht an ein Textanzeigeprogramm weiterleiten.

BEFEHLE

Die folgenden Befehle werden verstanden:

status
    Zeigt die aktuellen Einstellungen der Systemuhr und der RTC an, einschließlich der Tatsache, ob Netzwerkzeitsynchronisation aktiv ist. Falls kein Befehl festgelegt ist, ist dies die implizite Vorgabe.

show
    Zeigt die gleichen Informationen wie status, aber in maschinenlesbarer Form. Dieser Befehl kann immer dann eingesetzt werden, wenn eine Computer-auswertbare Ausgabe benötigt wird. Verwenden Sie status, wenn Sie menschenlesbare, formatierte Ausgabe wünschen.

    Standardmäßig werden leere Eigenschaften unterdrückt. Verwenden Sie --all, um diese auch anzuzeigen. Um die anzuzeigenden Eigenschaften auszuwählen, verwenden Sie --property=.

set-time [ZEIT]
    Setzt die Systemuhr auf die festgelegte Zeit. Dies wird auch die RTC-Zeit entsprechend aktualisieren. Die Zeit kann im Format »2012-10-30 18:17:16« festgelegt werden.

set-timezone [ZEITZONE]
    Setzt die Systemzeitzone auf den festgelegten Wert. Verfügbare Zeitzonen können mit list-timezones aufgelistet werden. Falls die RTC konfiguriert wurde, in der lokalen Zeit zu sein, wird dies auch die RTC-Zeit aktualisieren. Dieser Aufruf wird den Symlink /etc/localtime ändern. Siehe localtime(5) für weitere Informationen.

list-timezones
    Listet die verfügbaren Zeitzonen, eine pro Zeile, auf. Einträge aus dieser Liste können mit set-timezone als Systemzeitzone gesetzt werden.

set-local-rtc [LOGISCH]
    Akzeptiert ein logisches Argument. Falls »0«, ist das System konfiguriert, die RTC in Weltzeit zu halten. Falls »1«, wird es die RTC stattdessen in lokaler Zeit halten. Beachten Sie, dass das Halten der RTC in der lokalen Zeitzone nicht vollständig unterstützt und verschiedene Probleme bei Zeitzonenänderungen und Sommerzeitanpassungen hervorrufen wird. Falls irgendwie möglich, halten Sie die RTC im UTC-Modus. Beachten Sie, dass dieser Aufruf auch die RTC aus der Systemuhr synchronisieren wird, außer --adjust-system-clock wird übergeben (siehe oben). Wie in hwclock(8) dokumentiert, wird dieser Befehl die dritte Zeile von /etc/adjtime ändern.

set-ntp [LOGISCH]
    Akzeptiert ein logisches Argument. Steuert, ob Netzwerkzeitsynchronisation aktiviert und aktiv ist (falls verfügbar). Falls das Argument wahr ist, aktiviert und startet dies den ersten bestehenden Netzwerksynchronisationsdienst. Falls das Argument falsch ist, dann deaktiviert und stoppt dies alle bekannten Netzwerksynchronisationsdienste. Die Art, wie die Liste der Dienste aufgebaut wird, ist nachfolgend beschrieben.

  systemd-timesyncd-Befehle

Die folgenden Befehle sind für systemd-timesyncd.service(8) spezifisch.

timesync-status
    Zeigt den aktuellen Status von systemd-timesyncd.service(8). Falls --monitor festgelegt ist, dann wird dies die Statusaktualisierungen überwachen.

show-timesync
    Zeigt die gleichen Informationen wie timesync-status, aber in maschinenlesbarer Form. Dieser Befehl kann immer dann eingesetzt werden, wenn eine Computer-auswertbare Ausgabe benötigt wird. Verwenden Sie timesync-status, wenn Sie menschenlesbare, formatierte Ausgabe wünschen.

    Standardmäßig werden leere Eigenschaften unterdrückt. Verwenden Sie --all, um diese auch anzuzeigen. Um die anzuzeigenden Eigenschaften auszuwählen, verwenden Sie --property=.

ntp-servers SCHNITTSTELLE SERVER…
    Setzt die für die NTP-Dienste spezifische Schnittstelle. Dieser Befehl kann nur verwandt werden, wenn die Schnittstelle durch systemd-networkd verwaltet wird.

revert SCHNITTSTELLE
    Nimmt die schnittstellenspezifischen NTP-Server zurück. Dieser Befehl kann nur verwandt werden, wenn die Schnittstelle durch systemd-networkd verwaltet wird.

EXIT-STATUS

Bei Erfolg wird 0 zurückgegeben, anderenfalls ein Fehlercode ungleich Null.

UMGEBUNGSVARIABLEN

$SYSTEMD_PAGER
    Zu verwendendes Textanzeigeprogramm, wenn --no-pager nicht angegeben ist, setzt $PAGER außer Kraft. Falls weder $SYSTEMD_PAGER noch $PAGER gesetzt sind, wird eine Reihe wohlbekannter Textanzeigeprogrammimplementierungen der Reihe nach ausprobiert, einschließlich less(1) und more(1), bis eines gefunden wird. Falls keine Textanzeigeprogrammimplementierung gefunden wird, wird keines aufgerufen. Setzen der Umgebungsvariablen auf die leere Zeichenkette oder den Wert »cat« ist äquivalent zur Übergabe von --no-pager.

$SYSTEMD_LESS
    Setzt die an less übergebenen Optionen (standardmäßig »FRSXMK«) außer Kraft.

    Benutzer könnten insbesondere zwei Optionen ändern wollen:

    K
        Diese Option weist den Seitenbetrachter an, sich sofort beim Druck von Strg-C zu beenden. Um less die Handhabung von Strg-C selbst zum Umschalten auf die Eingabeaufforderung zu erlauben, setzen Sie diese Option zurück.

        Falls der Wert von $SYSTEMD_LESS kein »K« enthält und less das aufgerufene Textanzeigeprogramm ist, wird Strg+C durch das Programm ignoriert und muss durch das Textanzeigeprogramm selbst gehandhabt werden.

    X
        Diese Option weist den Seitenbetrachter an, keine Termcap-Initialisierungs- und -Deinitalisierungszeichenketten an das Terminal zu senden. Dies ist standardmäßig gesetzt, damit die Darstellung von Befehlen selbst nach dem Beenden des Seitenanzeigeprogramms sichtbar bleibt. Allerdings verhindert dies, dass ein Teil der Funktionalität des Seitenbetrachtungsprogramms funktioniert, insbesondere kann die Ausgabe des Seitenbetrachtungsprogramms nicht mit der Maus durchlaufen werden.

    Siehe less(1) für weitere Ausführungen.

$SYSTEMD_LESSCHARSET
    Setzt den an less übergebenen Zeichensatz (standardmäßig »utf-8«, falls das aufrufende Terminal als UTF-8-kompatibel erkannt wurde) außer Kraft.

BEISPIELE

Aktuelle Einstellungen anzeigen:

    $ timedatectl
                   Local time: Thu 2017-09-21 16:08:56 CEST
               Universal time: Thu 2017-09-21 14:08:56 UTC
                     RTC time: Thu 2017-09-21 14:08:56
                    Time zone: Europe/Warsaw (CEST, +0200)
    System clock synchronized: yes
                  NTP service: active
              RTC in local TZ: no

Netzwerkzeitsynchronisierung aktivieren:

    $ timedatectl set-ntp true
    ==== AUTHENTICATING FOR org.freedesktop.timedate1.set-ntp ===
    Authentication is required to control whether network time synchronization shall be enabled.
    Authenticating as: user
    Password: ********
    ==== AUTHENTICATION COMPLETE ===

    $ systemctl status systemd-timesyncd.service
    â systemd-timesyncd.service - Network Time Synchronization
       Loaded: loaded (/lib/systemd/system/systemd-timesyncd.service; enabled)
       Active: active (running) since Mo 2015-03-30 14:20:38 CEST; 5s ago
         Docs: man:systemd-timesyncd.service(8)
     Main PID: 595 (systemd-timesyn)
       Status: "Using Time Server 216.239.38.15:123 (time4.google.com)."
       CGroup: /system.slice/systemd-timesyncd.service
               ââ595 /lib/systemd/systemd-timesyncd
    ...

Zeigt aktuellen Status von systemd-timesyncd.service(8):

    $ timedatectl timesync-status
           Server: 216.239.38.15 (time4.google.com)
    Poll interval: 1min 4s (min: 32s; max 34min 8s)
             Leap: normal
          Version: 4
          Stratum: 1
        Reference: GPS
        Precision: 1us (-20)
    Root distance: 335us (max: 5s)
           Offset: +316us
            Delay: 349us
           Jitter: 0
     Packet count: 1
        Frequency: -8.802ppm

SIEHE AUCH

systemd(1), hwclock(8), date(1), localtime(5), systemctl(1), systemd-timedated.service(8), systemd-timesyncd.service(8), systemd-firstboot(1)

ÜBERSETZUNG
Die deutsche Übersetzung dieser Handbuchseite wurde von Helge Kreutzmann <debian@helgefjell.de> erstellt.

Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.

Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an <debian-l10n-german@lists.debian.org>.