ORG.FREEDESKTOP.TIMESYNC1(5) org.freedesktop.timesync1 ORG.FREEDESKTOP.TIMESYNC1(5)

.SH "NAME" org.freedesktop.timesync1 - The D-Bus interface of systemd-timesyncd

.SH "INTRODUCTION"

.PP [**systemd-timesyncd.service**(8)](/man/os/systemd/systemd-timesyncd.service.8) is a system service that may be used to synchronize the local system clock with a remote Network Time Protocol (NTP) server. This page describes the D-Bus interface.

.SH "THE MANAGER OBJECT"

.PP The service exposes the following interfaces on the Manager object on the bus:

```
node /org/freedesktop/timesync1 {


  interface org.freedesktop.timesync1.Manager {


    methods:


      SetRuntimeNTPServers(in  as runtime_servers);


    properties:


      readonly as LinkNTPServers = ['...', ...];


      readonly as SystemNTPServers = ['...', ...];


      readonly as RuntimeNTPServers = ['...', ...];


      readonly as FallbackNTPServers = ['...', ...];


      @org.freedesktop.DBus.Property.EmitsChangedSignal("false")


      readonly s ServerName = '...';


      @org.freedesktop.DBus.Property.EmitsChangedSignal("false")


      readonly (iay) ServerAddress = ...;


      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")


      readonly t RootDistanceMaxUSec = ...;


      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")


      readonly t PollIntervalMinUSec = ...;


      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")


      readonly t PollIntervalMaxUSec = ...;


      @org.freedesktop.DBus.Property.EmitsChangedSignal("false")


      readonly t PollIntervalUSec = ...;


      readonly (uuuuittayttttbtt) NTPMessage = ...;


      @org.freedesktop.DBus.Property.EmitsChangedSignal("false")


      readonly x Frequency = ...;


  };


  interface org.freedesktop.DBus.Peer { ... };


  interface org.freedesktop.DBus.Introspectable { ... };


  interface org.freedesktop.DBus.Properties { ... };
};
```

.PP Provides information about the manager.

.SH "EXAMPLES"

.PP **Example 1. Introspect org.freedesktop.timesync1.Manager on the bus**

```
$ gdbus introspect --system \


  --dest org.freedesktop.timesync1 \


  --object-path /org/freedesktop/timesync1
```

.SH "VERSIONING"

.PP These D-Bus interfaces follow **the usual interface versioning guidelines**\[1].

.SH "SEE ALSO"

.PP [**systemd**(1)](/man/os/systemd/systemd.1), [**systemd-timesyncd.service**(8)](/man/os/systemd/systemd-timesyncd.service.8)

# [NOTES](#NOTES)

1\.

the usual interface versioning guidelines

https://0pointer.de/blog/projects/versioning-dbus.html

systemd 262.2

---

Document: org.freedesktop.timesync1(5) from systemd 262.2-r1 (Chainguard OS)
Source: https://github.com/systemd/systemd