Re: [PATCH 09/12] Introduce virDomainPinHypervisorFlags and virDomainGetHypervisorPinInfo functions.

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

 



On Wed, Jul 25, 2012 at 01:26:29PM +0800, tangchen wrote:
> From: Tang Chen <tangchen@xxxxxxxxxxxxxx>
> 
> Introduce 2 APIs for client to use.
>     1) virDomainPinHypervisorFlags: call remote driver api, such as remoteDomainPinHypervisorFlags.
>     2) virDomainGetHypervisorPinInfo: call remote driver api, such as remoteDomainGetHypervisorPinInfo.

Not true. These two APIs call underlying driver's corresponding
implementation.

> 
> Signed-off-by: Tang Chen <tangchen@xxxxxxxxxxxxxx>
> Signed-off-by: Hu Tao <hutao@xxxxxxxxxxxxxx>
> ---
>  include/libvirt/libvirt.h.in |   10 +++
>  src/driver.h                 |   13 +++-
>  src/libvirt.c                |  147 ++++++++++++++++++++++++++++++++++++++++++
>  src/libvirt_public.syms      |    2 +
>  4 files changed, 171 insertions(+), 1 deletion(-)
> 
> diff --git a/include/libvirt/libvirt.h.in b/include/libvirt/libvirt.h.in
> index fcef461..74d495f 100644
> --- a/include/libvirt/libvirt.h.in
> +++ b/include/libvirt/libvirt.h.in
> @@ -1863,6 +1863,16 @@ int                     virDomainGetVcpuPinInfo (virDomainPtr domain,
>                                                   int maplen,
>                                                   unsigned int flags);
>  
> +int                     virDomainPinHypervisorFlags   (virDomainPtr domain,
> +                                                       unsigned char *cpumap,
> +                                                       int maplen,
> +                                                       unsigned int flags);
> +
> +int                     virDomainGetHypervisorPinInfo (virDomainPtr domain,
> +                                                      unsigned char *cpumaps,
> +                                                      int maplen,
> +                                                      unsigned int flags);
> +
>  /**
>   * VIR_USE_CPU:
>   * @cpumap: pointer to a bit map of real CPUs (in 8-bit bytes) (IN/OUT)
> diff --git a/src/driver.h b/src/driver.h
> index 46d9846..a326754 100644
> --- a/src/driver.h
> +++ b/src/driver.h
> @@ -305,7 +305,16 @@ typedef int
>                                           unsigned char *cpumaps,
>                                           int maplen,
>                                           unsigned int flags);
> -
> + typedef int
> +        (*virDrvDomainPinHypervisorFlags)     (virDomainPtr domain,
> +                                               unsigned char *cpumap,
> +                                               int maplen,
> +                                               unsigned int flags);
> +typedef int
> +        (*virDrvDomainGetHypervisorPinInfo)   (virDomainPtr domain,
> +                                               unsigned char *cpumaps,
> +                                               int maplen,
> +                                               unsigned int flags);
>  typedef int
>          (*virDrvDomainGetVcpus)         (virDomainPtr domain,
>                                           virVcpuInfoPtr info,
> @@ -937,6 +946,8 @@ struct _virDriver {
>      virDrvDomainPinVcpu                 domainPinVcpu;
>      virDrvDomainPinVcpuFlags            domainPinVcpuFlags;
>      virDrvDomainGetVcpuPinInfo          domainGetVcpuPinInfo;
> +    virDrvDomainPinHypervisorFlags      domainPinHypervisorFlags;
> +    virDrvDomainGetHypervisorPinInfo    domainGetHypervisorPinInfo;
>      virDrvDomainGetVcpus                domainGetVcpus;
>      virDrvDomainGetMaxVcpus             domainGetMaxVcpus;
>      virDrvDomainGetSecurityLabel        domainGetSecurityLabel;
> diff --git a/src/libvirt.c b/src/libvirt.c
> index 8315b4f..a904cc5 100644
> --- a/src/libvirt.c
> +++ b/src/libvirt.c
> @@ -8845,6 +8845,153 @@ error:
>  }
>  
>  /**
> + * virDomainPinHypervisorFlags:
> + * @domain: pointer to domain object, or NULL for Domain0
> + * @cpumap: pointer to a bit map of real CPUs (in 8-bit bytes) (IN)
> + *      Each bit set to 1 means that corresponding CPU is usable.
> + *      Bytes are stored in little-endian order: CPU0-7, 8-15...
> + *      In each byte, lowest CPU number is least significant bit.
> + * @maplen: number of bytes in cpumap, from 1 up to size of CPU map in
> + *      underlying virtualization system (Xen...).
> + *      If maplen < size, missing bytes are set to zero.
> + *      If maplen > size, failure code is returned.
> + * @flags: bitwise-OR of virDomainModificationImpact
> + *
> + * Dynamically change the real CPUs which can be allocated to all hypervisor
> + * threads. This function may require privileged access to the hypervisor.
> + *
> + * @flags may include VIR_DOMAIN_AFFECT_LIVE or VIR_DOMAIN_AFFECT_CONFIG.
> + * Both flags may be set.
> + * If VIR_DOMAIN_AFFECT_LIVE is set, the change affects a running domain
> + * and may fail if domain is not alive.
> + * If VIR_DOMAIN_AFFECT_CONFIG is set, the change affects persistent state,
> + * and will fail for transient domains. If neither flag is specified (that is,
> + * @flags is VIR_DOMAIN_AFFECT_CURRENT), then an inactive domain modifies
> + * persistent setup, while an active domain is hypervisor-dependent on whether
> + * just live or both live and persistent state is changed.
> + * Not all hypervisors can support all flag combinations.
> + *
> + * See also virDomainGetHypervisorPinInfo for querying this information.
> + *
> + * Returns 0 in case of success, -1 in case of failure.
> + *
> + */
> +int
> +virDomainPinHypervisorFlags(virDomainPtr domain, unsigned char *cpumap,
> +                            int maplen, unsigned int flags)
> +{
> +    virConnectPtr conn;
> +
> +    VIR_DOMAIN_DEBUG(domain, "cpumap=%p, maplen=%d, flags=%x",
> +                     cpumap, maplen, flags);
> +
> +    virResetLastError();
> +
> +    if (!VIR_IS_CONNECTED_DOMAIN(domain)) {
> +        virLibDomainError(VIR_ERR_INVALID_DOMAIN, __FUNCTION__);
> +        virDispatchError(NULL);
> +        return -1;
> +    }
> +
> +    if (domain->conn->flags & VIR_CONNECT_RO) {
> +        virLibDomainError(VIR_ERR_OPERATION_DENIED, __FUNCTION__);
> +        goto error;
> +    }
> +
> +    if ((cpumap == NULL) || (maplen < 1)) {
> +        virLibDomainError(VIR_ERR_INVALID_ARG, __FUNCTION__);
> +        goto error;
> +    }
> +
> +    conn = domain->conn;
> +
> +    if (conn->driver->domainPinHypervisorFlags) {
> +        int ret;
> +        ret = conn->driver->domainPinHypervisorFlags (domain, cpumap, maplen, flags);
> +        if (ret < 0)
> +            goto error;
> +        return ret;
> +    }
> +
> +    virLibConnError(VIR_ERR_NO_SUPPORT, __FUNCTION__);
> +
> +error:
> +    virDispatchError(domain->conn);
> +    return -1;
> +}
> +
> +/**
> + * virDomainGetHypervisorPinInfo:
> + * @domain: pointer to domain object, or NULL for Domain0
> + * @cpumap: pointer to a bit map of real CPUs for all hypervisor threads of
> + *     this domain (in 8-bit bytes) (OUT)
> + *     There is only one cpumap for all hypervisor threads.
> + *     Must not be NULL.
> + * @maplen: the number of bytes in one cpumap, from 1 up to size of CPU map.
> + *     Must be positive.
> + * @flags: bitwise-OR of virDomainModificationImpact
> + *     Must not be VIR_DOMAIN_AFFECT_LIVE and
> + *     VIR_DOMAIN_AFFECT_CONFIG concurrently.
> + *
> + * Query the CPU affinity setting of all hypervisor threads of domain, store
> + * it in cpumap.
> + *
> + * Returns 1 in case of success,
> + * 0 in case of no hypervisor threads are pined to pcpus,
> + * -1 in case of failure.
> + */
> +int
> +virDomainGetHypervisorPinInfo(virDomainPtr domain, unsigned char *cpumap,
> +                              int maplen, unsigned int flags)
> +{
> +    virConnectPtr conn;
> +
> +    VIR_DOMAIN_DEBUG(domain, "cpumap=%p, maplen=%d, flags=%x",
> +                     cpumap, maplen, flags);
> +
> +    virResetLastError();
> +
> +    if (!VIR_IS_CONNECTED_DOMAIN(domain)) {
> +        virLibDomainError(VIR_ERR_INVALID_DOMAIN, __FUNCTION__);
> +        virDispatchError(NULL);
> +        return -1;
> +    }
> +
> +    if (!cpumap || maplen <= 0) {
> +        virLibDomainError(VIR_ERR_INVALID_ARG, __FUNCTION__);
> +        goto error;
> +    }
> +    if (INT_MULTIPLY_OVERFLOW(1, maplen)) {
> +        virLibDomainError(VIR_ERR_OVERFLOW, _("input too large: 1 * %d"),
> +                          maplen);
> +        goto error;
> +    }
> +
> +    /* At most one of these two flags should be set.  */
> +    if ((flags & VIR_DOMAIN_AFFECT_LIVE) &&
> +        (flags & VIR_DOMAIN_AFFECT_CONFIG)) {
> +        virLibDomainError(VIR_ERR_INVALID_ARG, __FUNCTION__);
> +        goto error;
> +    }
> +    conn = domain->conn;
> +
> +    if (conn->driver->domainGetHypervisorPinInfo) {
> +        int ret;
> +        ret = conn->driver->domainGetHypervisorPinInfo(domain, cpumap,
> +                                                       maplen, flags);
> +        if (ret < 0)
> +            goto error;
> +        return ret;
> +    }
> +
> +    virLibConnError(VIR_ERR_NO_SUPPORT, __FUNCTION__);
> +
> +error:
> +    virDispatchError(domain->conn);
> +    return -1;
> +}
> +
> +/**
>   * virDomainGetVcpus:
>   * @domain: pointer to domain object, or NULL for Domain0
>   * @info: pointer to an array of virVcpuInfo structures (OUT)
> diff --git a/src/libvirt_public.syms b/src/libvirt_public.syms
> index 1a8e58a..0a57331 100644
> --- a/src/libvirt_public.syms
> +++ b/src/libvirt_public.syms
> @@ -547,6 +547,8 @@ LIBVIRT_0.9.13 {
>  LIBVIRT_0.9.14 {
>      global:
>          virDomainGetHostname;
> +        virDomainPinHypervisorFlags;
> +        virDomainGetHypervisorPinInfo;
>  } LIBVIRT_0.9.13;
>  
>  # .... define new API here using predicted next version number ....
> -- 
> 1.7.10.2
> 
> --
> libvir-list mailing list
> libvir-list@xxxxxxxxxx
> https://www.redhat.com/mailman/listinfo/libvir-list

-- 
Thanks,
Hu Tao

--
libvir-list mailing list
libvir-list@xxxxxxxxxx
https://www.redhat.com/mailman/listinfo/libvir-list


[Index of Archives]     [Virt Tools]     [Libvirt Users]     [Lib OS Info]     [Fedora Users]     [Fedora Desktop]     [Fedora SELinux]     [Big List of Linux Books]     [Yosemite News]     [KDE Users]     [Fedora Tools]