PROTOCOLS
Maintenance
Defined in fuchsia.time/maintenance.fidl
Provides access to a UTC clock for the purposes of keeping it up-to-date with external time sources.
The client does not own the UTC clock, but is given a lease in order to keep the time synchronized.
GetWritableUtcClock
Retrieve a UTC clock handle with write rights.
Request
| Name | Type |
|---|
Response
| Name | Type |
|---|---|
utc_clock |
handle<clock>
|
Utc
Defined in fuchsia.time/utc.fidl
Metadata about a device's approximation of UTC time, commonly referred to as "system time".
WatchState
Notifies clients of updates to the UTC timeline. The first call on a channel returns immediately, and subsequent calls on the same channel will return when the state has changed.
Request
| Name | Type |
|---|
Response
| Name | Type |
|---|---|
state |
UtcState
|
STRUCTS
ENUMS
UtcSource
Type: uint32
Defined in fuchsia.time/utc.fidl
Describes the source from which the current UTC approximation was retrieved.
| Name | Value | Description |
|---|---|---|
BACKSTOP |
2 |
The clock has been initialized to a known-prior reference time but may be highly inaccurate. |
UNVERIFIED |
4 |
The clock has been initialized from a time source that is believed to be to accurate but that could not be verified. An example might be a battery-backed real time clock. |
EXTERNAL |
3 |
The clock has been initialized from a suitably accurate and verified external time source. For many devices the most common external time source is a network time server using some protocol with cryptographic authentication such as Roughtime or HTTPSdate. |
TABLES
UtcState
Defined in fuchsia.time/utc.fidl
Describes the state of the clock.
| Ordinal | Name | Type | Description |
|---|---|---|---|
| 1 | timestamp |
zx/time
|
The monotonic time at which this |
| 2 | source |
UtcSource
|
The source of our current UTC approximation. |