1<h2>clock_set_attributes</h2>
2<hr>
3<p>
4<strong>Function</strong> - Set a particular clock's attributes.
5<h3>SYNOPSIS</h3>
6<pre>
7<strong>kern_return_t   clock_set_attributes</strong>
8                <strong>(clock_ctrl_t</strong>                     <var>clock_control</var>,
9                 <strong>clock_flavor_t</strong>                          <var>flavor</var>,
10                 <strong>clock_attr_t</strong>                         <var>attribute</var>,
11                 <strong>clock_control</strong>                  <var>attribute_count</var><strong>);</strong>
12</pre>
13<h3>PARAMETERS</h3>
14<dl>
15<p>
16<dt> <var>clock_control</var> 
17<dd>
18[in clock-control send right]
19The control port for the clock.
20<p>
21<dt> <var>flavor</var> 
22<dd>
23[in scalar]
24Type of information to be set.  Defined values are:
25<dl>
26<p>
27<dt> <strong>CLOCK_ALARM_CURRES</strong>
28<dd>
29The resolution, in nanoseconds, at which clock alarm and 
30sleep timers are currently serviced.  Increasing the current
31resolution will have no impact on any pending clock alarms (i.e. 
32they will go off as originally scheduled).  Decreasing the
33current resolution will truncate any pending alarms to the
34granularity of the new current resolution.  This value must be a 
35multiple of the minimum resolution and not greater than the 
36maximum resolution of the clock.
37</dl>
38<p>
39<dt> <var>attribute</var> 
40<dd>
41[pointer to in scalar]
42New attribute.
43<p>
44<dt> <var>attribute_count</var> 
45<dd>
46[in scalar]
47The size of the buffer (in natural-sized units).
48</dl>
49<h3>DESCRIPTION</h3>
50<p>
51The <strong>clock_set_attributes</strong> function sets attributes of
52a clock's operation.
53<h3>NOTES</h3>
54<p>
55The main reason a clock's current resolution would not always equal its
56minimum resolution is because the overhead of sustaining the
57minimum resolution, 
58when it is not needed by any existing alarm service client, may be prohibitive 
59for a given hardware platform and underlying clock device.
60<h3>RETURN VALUES</h3>
61<p>
62Only generic errors apply.
63<h3>RELATED INFORMATION</h3>
64<p>
65Functions:
66<a href="host_get_clock_control.html"><strong>host_get_clock_control</strong></a>,
67<a href="clock_set_time.html"><strong>clock_set_time</strong></a>,
68<a href="clock_get_attributes.html"><strong>clock_get_attributes</strong></a>.
69