## host_get_clock_control

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

### SYNOPSIS

    kern_return_t   host_get_clock_control
                    (host_priv_t                          host_priv,
                     clock_id_t                                  id,
                     clock_ctrl_t                     clock_control);

### PARAMETERS

host_priv
  [in host-control send right] The 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_control
  [out clock-control send right] Control port for the clock.

### DESCRIPTION

The host_get_clock_control function returns a send right to the control port for a kernel clock object. This right is used to set the clock's resolution and time.

### RETURN VALUES

Only generic errors apply.

### RELATED INFORMATION

Functions: clock_set_time, clock_set_attributes, host_get_clock_service.