On Wed, Nov 30, 2011 at 03:03:40PM -0600, Anthony Liguori wrote: > +## > +# @qom-get: > +# > +# This command will get a property from a device model path and return the > +# value. > +# > +# @path: The path within the device model. There are two forms of supported > +# paths--absolute and partial paths. > +# > +# Absolute paths are derived from the root device and can follow > child<> > +# or link<> properties. Since they can follow link<> properties, they > +# can be arbitrarily long. Absolute paths look like absolute > filenames > +# and are prefixed with a leading slash. > +# > +# Partial paths are look like relative filenames. They do not begin
s/are// > +# with a prefix. The matching rules for partial paths are subtle but > +# designed to make specifying devices easy. At each level of the > +# composition tree, the partial path is matched as an absolute path. > +# The first match is not returned. At least two matches are searched > +# for. A successful result is only returned if only one match is > +# founded. If more than one match is found, a flag is return to s/founded/found/
