X-Git-Url: http://git.annexia.org/?a=blobdiff_plain;f=lib%2Fdiskimage.mli;h=8cdd7a99258a00697e1fe96e0ffd6833370f7a02;hb=248e97bdc87fc0c53b532861c209e68fadfa02ff;hp=22ba927b58c693e8268170973a83af5542d8081e;hpb=aedea1300349e088286d63a4bcd16a85d12c6a7c;p=virt-df.git diff --git a/lib/diskimage.mli b/lib/diskimage.mli index 22ba927..8cdd7a9 100644 --- a/lib/diskimage.mli +++ b/lib/diskimage.mli @@ -308,12 +308,17 @@ type owner = | `Partitions of partitions | `PhysicalVolume of pv ] -val get_owners : - machine -> ownership -> device -> Int63.t -> (owner * Int63.t) list - (** [get_owners machine ownership disk offset] returns the - owners (filesystems, etc.) which reside on block device [disk] - at the given byte offset. [disk] must be a block device - of the machine. +val get_owners_lookup : machine -> ownership -> device -> + (Int63.t -> (owner * Int63.t) list) + (** [get_owners_lookup machine disk] returns a specialized + function for looking up owners (filesystems, etc.) + which reside on block device [disk]. + + [disk] must be a block device of the machine. + + The specialized lookup function that is returned + can be called as [lookup offset] to look up the + owners of byte offset [offset]. Returns a list of [(owner, owner_offset)] where [owner] is the filesystem, etc., and [owner_offset] is the byte @@ -324,8 +329,8 @@ val get_owners : both the filesystem ([`Filesystem fs]) and partition scheme ([`Partitions parts]) will be returned. - This function is efficient. {!create_ownership} creates - a tree structure which allows ownership to be determined + The specialized function is efficient. {!create_ownership} + creates a tree structure which allows ownership to be determined in just a few steps. *) (** {2 Debugging} *)