--- xeno-unstable-latest/tools/libxc/xc.h 2005-06-09 15:32:01.000000000 -0700 +++ xeno-unstable/tools/libxc/xc.h 2005-06-09 15:29:02.000000000 -0700 @@ -169,7 +169,11 @@ int vcpu, cpumap_t *cpumap); /** - * This function will return information about one or more domains. + * This function will return information about one or more domains. It is + * designed to iterate over the list of domains. If a single domain is + * requested, this function will return the next domain in the list - if + * one exists. It is, therefore, important in this case to make sure the + * domain requested was the one returned. * * @parm xc_handle a handle to an open hypervisor interface * @parm first_domid the first domain to enumerate information from. Domains