## clock_set_time

Function - Set the current time.

### SYNOPSIS

    kern_return_t   clock_set_time
                    (clock_ctrl_t                     clock_control,
                     tvalspec_t                            new_time);

### PARAMETERS

clock_control
  [in clock-control send right] The control port for the clock.

new_time
  [in structure] New time

### DESCRIPTION

The clock_set_time function sets the time kept by a clock. Setting the clock time will cause all pending clock alarms and sleeps to be terminated with timestamps set to the current clock time just prior to the new time being set with a return code of KERN_ABORTED.

### CAUTIONS

The use of this function is \*Vstrongly discouraged\*O since it could affect the monotonically increasing nature of the clock.

### RETURN VALUES

Only generic errors apply.

### RELATED INFORMATION

Functions: host_get_clock_control, clock_set_attributes, clock_get_time, clock_alarm, clock_sleep.

Data Structures: tvalspec.