osfmk/man/clock_map_time.html
Function - Return a memory object that maps a clock.
**kern\_return\_t clock\_map\_time**** (clock\_t **clock\_name,** memory\_object\_t **clock\_memory** );**
clock_name[in clock-name send right] The name (or control) port for the clock.
clock_memory[out memory-object-representative send right] Mapped clock time memory object representative.
The clock_map_time function returns a memory object representative port representing read access to a memory object that contains (at offset zero) a mapped version of the clock time (structure mapped_tvalspec ). The returned right is suitable as an argument for vm_map.
Not all clocks provide this service, but the REALTIME clock must.
KERN_FAILURE The specified clock does not provide this service.
Functions: host_get_clock_service, clock_get_attributes, clock_get_time, clock_sleep, clock_alarm.
Data Structures: mapped_tvalspec.