[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]

Re: [libvirt] [PATCH] docs: mention domain <clock> improvements

On 05/17/2010 05:39 PM, Eric Blake wrote:
On 05/17/2010 03:27 PM, Chris Lalancette wrote:
+	<dt><code>track</code></dt>
+	<dd>
+	    The<code>track</code>  attribute specifies what the timer
+	    tracks, and can be "boot", "guest", or "wall".
+	    Only valid for<code>name="rtc"</code>
+	    or<code>name="platform"</code>.
Tough one.  This doesn't tell people much about what they should be
choosing for "track", and hence isn't that useful.  You may want to
add more about what this means.  From what I can tell, it's actually
keeping track of how the RTC is getting updated.  If it's set to "guest",
then it is always set relative to the number of guest cycles that have
passed.  If it's set to "wall", it's relative to the actual time that
has passed from the host's POV.  I'm not sure about "boot".
Now you see my quandary of why I asked for feedback!  I'm documenting
someone else's work, and getting lost in all the options.  Laine, since
you own the commit that added<timer>, would you care to lend a hand, so
we can make this documentation useful?  :-)

Actually, documenting that had bee on my to-do list, but constantly slipped due to the fact that I wrote the code based on specs provided by others, so I don't consider myself to be all that knowledgeable about the "why" of things either! :-)

I'll gladly help with shaping it up further, but first need a few days to get my dev environment back into shape and check on a pretty ugly bug that still bothers me.

Thanks for tackling this, btw. I agree that your time so far was well spent.

[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]