TIMEDATECTL(1)

BEZEICHNUNG
timedatectl - Systemdatum und -uhrzeit steuern

ÜBERSICHT

timedatectl [OPTIONEN…] {BEFEHL}

BESCHREIBUNG

timedatectl kann zur Abfrage und Änderung der Systemuhr und ihrer Einstellungen 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 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 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 nnicht, 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 Druckeigenschaften mit show-timesync dargestellt 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 Container-Name angehängt werden, getrennt durch »:«, womit direkt zu einem bestimmten Container auf dem angegebenen Rechner verbunden wird. Dies verwendet SSH, um mit der Maschinen-Manager-Instanz auf dem Rechner in der Ferne zu sprechen. Container-Namen dürfen mit machinectl -H RECHNER aufgezählt werden.

-M, --machine=
    Führt die Aktion auf 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 einen Pager weiterleiten.

BEFEHLE

Die folgenden Befehle werden verstanden:

status
    Zeigt die aktuellen Einstellungen der Systemuhr und der RTC an, einschließlich der Tatsache, ob Netzwerkzeitsynchronisation mittels systemd-timesyncd.service aktiv ist. Selbst wenn es inaktiv ist, kann ein anderer Dienst dennoch die Uhr synchronisieren. Falls kein Befehl festgelegt ist, ist dies die implizite Vorgabe.

show
    Zeigt die gleichen Informationen wie status, aber in maschinenlesbarer Form. Dieser Befehl ist dazu gedacht, eingesetzt zu werden, wannimmer 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 Dienst, der in der Umgebungsvariablen $SYSTEMD_TIMEDATED_NTP_SERVICES von systemd-timedated.service aufgeführt ist. Falls das Argument falsch ist, dann deaktiviert und stoppt dies alle in $SYSTEMD_TIMEDATED_NTP_SERVICES aufgeführten Dienste.

  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 ist dazu gedacht, eingesetzt zu werden, wannimmer 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=.

RÜCKGABEWERT

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

UMGEBUNGSVARIABLEN

$SYSTEMD_PAGER
    Zu verwendender Pager, wenn --no-pager nicht angegeben ist, setzt $PAGER außer Kraft. Falls weder $SYSTEMD_PAGER noch $PAGER gesetzt sind, wird eine Reihe gut-bekannter Pagerimplementierungen der Reihe nach ausprobiert, einschließlich less(1) und more(1), bis einer gefunden wird. Falls keine Pager-Implementierung gefunden wird, wird keiner aufgerufen. Setzten der Umgebungsvariablen auf die leere Zeichenkette oder den Wert »cat« is äquivalent zur Übergabe von --no-pager.

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

$SYSTEMD_LESSCHARSET
    Setzt den an less weitergegebenen 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 (/usr/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 /usr/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>.