Google is committed to advancing racial equity for Black communities. See how.

fuchsia.time

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

NameType

Response

NameType
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

NameType

Response

NameType
state UtcState

STRUCTS

ENUMS

UtcSource

Type: uint32

Defined in fuchsia.time/utc.fidl

Describes the source from which the current UTC approximation was retrieved.

NameValueDescription
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.

OrdinalNameTypeDescription
1 timestamp zx/time

The monotonic time at which this UtcState was observed.

2 source UtcSource

The source of our current UTC approximation.