Back to Darwin Xnu

Host Get Clock Service

osfmk/man/host_get_clock_service.html

latest1.5 KB
Original Source

host_get_clock_service


Function - Return a send right to a kernel clock's service port.

SYNOPSIS

**kern\_return\_t host\_get\_clock\_service**** (host\_t **host,** clock\_id\_t **id,** clock\_t **clock\_name** );**

PARAMETERS

host[in host-name send right] The name (or control) port for the host owning the clock.

id[in scalar] The identification of the desired kernel clock. These values are defined in *L*O. Although an implementation may define additional values, the following values are always defined (although only the REALTIME clock is required to be implemented):

REALTIME_CLOCK A moderate resolution clock service that (typically) tracks time since the system last boot.

BATTERY_CLOCK A (typically) low resolution clock (to the second) that survives power failures or service outages.

HIGHRES_CLOCK A high resolution clock.

clock_name[out clock-name send right] Name port for the clock.

DESCRIPTION

The host_get_clock_service function returns a send right to the name port for a kernel clock object. This right is used to get the time and resolutions of the clock and to set clock alarms.

RETURN VALUES

Only generic errors apply.

Functions: clock_get_time, clock_get_attributes, clock_map_time, clock_sleep, clock_alarm, host_get_clock_control.