Message-ID: <a6c73b9e-577b-4a18-63a2-79f0b3fa1185@nvidia.com>
Date:   Fri, 11 Mar 2022 21:15:38 +0530
From:   Abhishek Sahu <abhsahu@...dia.com>
To:     Alex Williamson <alex.williamson@...hat.com>
Cc:     kvm@...r.kernel.org, Cornelia Huck <cohuck@...hat.com>,
        Max Gurtovoy <mgurtovoy@...dia.com>,
        Yishai Hadas <yishaih@...dia.com>,
        Zhen Lei <thunder.leizhen@...wei.com>,
        Jason Gunthorpe <jgg@...dia.com>, linux-kernel@...r.kernel.org
Subject: Re: [RFC PATCH v2 5/5] vfio/pci: add the support for PCI D3cold state

On 3/9/2022 10:56 PM, Alex Williamson wrote:
> On Mon, 24 Jan 2022 23:47:26 +0530
> Abhishek Sahu <abhsahu@...dia.com> wrote:
> 
>> Currently, if the runtime power management is enabled for vfio-pci
>> device in the guest OS, then guest OS will do the register write for
>> PCI_PM_CTRL register. This write request will be handled in
>> vfio_pm_config_write() where it will do the actual register write
>> of PCI_PM_CTRL register. With this, the maximum D3hot state can be
>> achieved for low power. If we can use the runtime PM framework,
>> then we can achieve the D3cold state which will help in saving
>> maximum power.
>>
>> 1. Since D3cold state can't be achieved by writing PCI standard
>>    PM config registers, so this patch adds a new IOCTL which change the
>>    PCI device from D3hot to D3cold state and then D3cold to D0 state.
>>
>> 2. The hypervisors can implement virtual ACPI methods. For
>>    example, in guest linux OS if PCI device ACPI node has _PR3 and _PR0
>>    power resources with _ON/_OFF method, then guest linux OS makes the
>>    _OFF call during D3cold transition and then _ON during D0 transition.
>>    The hypervisor can tap these virtual ACPI calls and then do the D3cold
>>    related IOCTL in the vfio driver.
>>
>> 3. The vfio driver uses runtime PM framework to achieve the
>>    D3cold state. For the D3cold transition, decrement the usage count and
>>    during D0 transition increment the usage count.
>>
>> 4. For D3cold, the device current power state should be D3hot.
>>    Then during runtime suspend, the pci_platform_power_transition() is
>>    required for D3cold state. If the D3cold state is not supported, then
>>    the device will still be in D3hot state. But with the runtime PM, the
>>    root port can now also go into suspended state.
>>
>> 5. For most of the systems, the D3cold is supported at the root
>>    port level. So, when root port will transition to D3cold state, then
>>    the vfio PCI device will go from D3hot to D3cold state during its
>>    runtime suspend. If root port does not support D3cold, then the root
>>    will go into D3hot state.
>>
>> 6. The runtime suspend callback can now happen for 2 cases: there
>>    is no user of vfio device and the case where user has initiated
>>    D3cold. The 'runtime_suspend_pending' flag can help to distinguish
>>    this case.
>>
>> 7. There are cases where guest has put PCI device into D3cold
>>    state and then on the host side, user has run lspci or any other
>>    command which requires access of the PCI config register. In this case,
>>    the kernel runtime PM framework will resume the PCI device internally,
>>    read the config space and put the device into D3cold state again. Some
>>    PCI device needs the SW involvement before going into D3cold state.
>>    For the first D3cold state, the driver running in guest side does the SW
>>    side steps. But the second D3cold transition will be without guest
>>    driver involvement. So, prevent this second d3cold transition by
>>    incrementing the device usage count. This will make the device
>>    unnecessary in D0 but it's better than failure. In future, we can some
>>    mechanism by which we can forward these wake-up request to guest and
>>    then the mentioned case can be handled also.
>>
>> 8. In D3cold, all kind of BAR related access needs to be disabled
>>    like D3hot. Additionally, the config space will also be disabled in
>>    D3cold state. To prevent access of config space in the D3cold state,
>>    increment the runtime PM usage count before doing any config space
>>    access. Also, most of the IOCTLs do the config space access, so
>>    maintain one safe list and skip the resume only for these safe IOCTLs
>>    alone. For other IOCTLs, the runtime PM usage count will be
>>    incremented first.
>>
>> 9. Now, runtime suspend/resume callbacks need to get the vdev
>>    reference which can be obtained by dev_get_drvdata(). Currently, the
>>    dev_set_drvdata() is being set after returning from
>>    vfio_pci_core_register_device(). The runtime callbacks can come
>>    anytime after enabling runtime PM so dev_set_drvdata() must happen
>>    before that. We can move dev_set_drvdata() inside
>>    vfio_pci_core_register_device() itself.
>>
>> 10. The vfio device user can close the device after putting
>>     the device into runtime suspended state so inside
>>     vfio_pci_core_disable(), increment the runtime PM usage count.
>>
>> 11. Runtime PM will be possible only if CONFIG_PM is enabled on
>>     the host. So, the IOCTL related code can be put under CONFIG_PM
>>     Kconfig.
>>
>> Signed-off-by: Abhishek Sahu <abhsahu@...dia.com>
>> ---
>>  drivers/vfio/pci/vfio_pci.c        |   1 -
>>  drivers/vfio/pci/vfio_pci_config.c |  11 +-
>>  drivers/vfio/pci/vfio_pci_core.c   | 186 +++++++++++++++++++++++++++--
>>  include/linux/vfio_pci_core.h      |   1 +
>>  include/uapi/linux/vfio.h          |  21 ++++
>>  5 files changed, 211 insertions(+), 9 deletions(-)
>>
>> diff --git a/drivers/vfio/pci/vfio_pci.c b/drivers/vfio/pci/vfio_pci.c
>> index c8695baf3b54..4ac3338c8fc7 100644
>> --- a/drivers/vfio/pci/vfio_pci.c
>> +++ b/drivers/vfio/pci/vfio_pci.c
>> @@ -153,7 +153,6 @@ static int vfio_pci_probe(struct pci_dev *pdev, const struct pci_device_id *id)
>>       ret = vfio_pci_core_register_device(vdev);
>>       if (ret)
>>               goto out_free;
>> -     dev_set_drvdata(&pdev->dev, vdev);
> 
> Relocating the setting of drvdata should be proposed separately rather
> than buried in this patch.  The driver owns drvdata, the driver is the
> only consumer of drvdata, so pushing this into the core to impose a
> standard for drvdata across all vfio-pci variants doesn't seem like a
> good idea to me.
> 
 
 I will check regarding this part.
 Mainly drvdata is needed for the runtime PM callbacks which are added
 inside core layer and we need to get vdev from struct device.

>>       return 0;
>>
>>  out_free:
>> diff --git a/drivers/vfio/pci/vfio_pci_config.c b/drivers/vfio/pci/vfio_pci_config.c
>> index dd9ed211ba6f..d20420657959 100644
>> --- a/drivers/vfio/pci/vfio_pci_config.c
>> +++ b/drivers/vfio/pci/vfio_pci_config.c
>> @@ -25,6 +25,7 @@
>>  #include <linux/uaccess.h>
>>  #include <linux/vfio.h>
>>  #include <linux/slab.h>
>> +#include <linux/pm_runtime.h>
>>
>>  #include <linux/vfio_pci_core.h>
>>
>> @@ -1919,16 +1920,23 @@ static ssize_t vfio_config_do_rw(struct vfio_pci_core_device *vdev, char __user
>>  ssize_t vfio_pci_config_rw(struct vfio_pci_core_device *vdev, char __user *buf,
>>                          size_t count, loff_t *ppos, bool iswrite)
>>  {
>> +     struct device *dev = &vdev->pdev->dev;
>>       size_t done = 0;
>>       int ret = 0;
>>       loff_t pos = *ppos;
>>
>>       pos &= VFIO_PCI_OFFSET_MASK;
>>
>> +     ret = pm_runtime_resume_and_get(dev);
>> +     if (ret < 0)
>> +             return ret;
>> +
>>       while (count) {
>>               ret = vfio_config_do_rw(vdev, buf, count, &pos, iswrite);
>> -             if (ret < 0)
>> +             if (ret < 0) {
>> +                     pm_runtime_put(dev);
>>                       return ret;
>> +             }
>>
>>               count -= ret;
>>               done += ret;
>> @@ -1936,6 +1944,7 @@ ssize_t vfio_pci_config_rw(struct vfio_pci_core_device *vdev, char __user *buf,
>>               pos += ret;
>>       }
>>
>> +     pm_runtime_put(dev);
> 
> What about other config accesses, ex. shared INTx?  We need to
> interact with the device command and status register on an incoming
> interrupt to test if our device sent an interrupt and to mask it.  The
> unmask eventfd can also trigger config space accesses.  Seems
> incomplete relative to config space.
> 

 I will check this path thoroughly.
 But from initial analysis, it seems we have 2 path here:

 Most of the mentioned functions are being called from
 vfio_pci_set_irqs_ioctl() and pm_runtime_resume_and_get()
 should be called for this ioctl also in this patch.

 Second path is when we are inside IRQ handler. For that, we need some
 other mechanism which I explained below.
 
>>       *ppos += done;
>>
>>       return done;
>> diff --git a/drivers/vfio/pci/vfio_pci_core.c b/drivers/vfio/pci/vfio_pci_core.c
>> index 38440d48973f..b70bb4fd940d 100644
>> --- a/drivers/vfio/pci/vfio_pci_core.c
>> +++ b/drivers/vfio/pci/vfio_pci_core.c
>> @@ -371,12 +371,23 @@ void vfio_pci_core_disable(struct vfio_pci_core_device *vdev)
>>       lockdep_assert_held(&vdev->vdev.dev_set->lock);
>>
>>       /*
>> -      * If disable has been called while the power state is other than D0,
>> -      * then set the power state in vfio driver to D0. It will help
>> -      * in running the logic needed for D0 power state. The subsequent
>> -      * runtime PM API's will put the device into the low power state again.
>> +      * The vfio device user can close the device after putting the device
>> +      * into runtime suspended state so wake up the device first in
>> +      * this case.
>>        */
>> -     vfio_pci_set_power_state_locked(vdev, PCI_D0);
>> +     if (vdev->runtime_suspend_pending) {
>> +             vdev->runtime_suspend_pending = false;
>> +             pm_runtime_resume_and_get(&pdev->dev);
> 
> Doesn't vdev->power_state become unsynchronized from the actual device
> state here and maybe elsewhere in this patch?  (I see below that maybe
> the resume handler accounts for this)
> 

 Yes. Inside runtime resume handler, it is being changed back to D0.

>> +     } else {
>> +             /*
>> +              * If disable has been called while the power state is other
>> +              * than D0, then set the power state in vfio driver to D0. It
>> +              * will help in running the logic needed for D0 power state.
>> +              * The subsequent runtime PM API's will put the device into
>> +              * the low power state again.
>> +              */
>> +             vfio_pci_set_power_state_locked(vdev, PCI_D0);
>> +     }
>>
>>       /* Stop the device from further DMA */
>>       pci_clear_master(pdev);
>> @@ -693,8 +704,8 @@ int vfio_pci_register_dev_region(struct vfio_pci_core_device *vdev,
>>  }
>>  EXPORT_SYMBOL_GPL(vfio_pci_register_dev_region);
>>
>> -long vfio_pci_core_ioctl(struct vfio_device *core_vdev, unsigned int cmd,
>> -             unsigned long arg)
>> +static long vfio_pci_core_ioctl_internal(struct vfio_device *core_vdev,
>> +                                      unsigned int cmd, unsigned long arg)
>>  {
>>       struct vfio_pci_core_device *vdev =
>>               container_of(core_vdev, struct vfio_pci_core_device, vdev);
>> @@ -1241,10 +1252,119 @@ long vfio_pci_core_ioctl(struct vfio_device *core_vdev, unsigned int cmd,
>>               default:
>>                       return -ENOTTY;
>>               }
>> +#ifdef CONFIG_PM
>> +     } else if (cmd == VFIO_DEVICE_POWER_MANAGEMENT) {
> 
> I'd suggest using a DEVICE_FEATURE ioctl for this.  This ioctl doesn't
> follow the vfio standard of argsz/flags and doesn't seem to do anything
> special that we couldn't achieve with a DEVICE_FEATURE ioctl.
> 

 Sure. DEVICE_FEATURE can help for this.

>> +             struct vfio_power_management vfio_pm;
>> +             struct pci_dev *pdev = vdev->pdev;
>> +             bool request_idle = false, request_resume = false;
>> +             int ret = 0;
>> +
>> +             if (copy_from_user(&vfio_pm, (void __user *)arg, sizeof(vfio_pm)))
>> +                     return -EFAULT;
>> +
>> +             /*
>> +              * The vdev power related fields are protected with memory_lock
>> +              * semaphore.
>> +              */
>> +             down_write(&vdev->memory_lock);
>> +             switch (vfio_pm.d3cold_state) {
>> +             case VFIO_DEVICE_D3COLD_STATE_ENTER:
>> +                     /*
>> +                      * For D3cold, the device should already in D3hot
>> +                      * state.
>> +                      */
>> +                     if (vdev->power_state < PCI_D3hot) {
>> +                             ret = EINVAL;
>> +                             break;
>> +                     }
>> +
>> +                     if (!vdev->runtime_suspend_pending) {
>> +                             vdev->runtime_suspend_pending = true;
>> +                             pm_runtime_put_noidle(&pdev->dev);
>> +                             request_idle = true;
>> +                     }
> 
> If I call this multiple times, runtime_suspend_pending prevents it from
> doing anything, but what should the return value be in that case?  Same
> question for exit.
> 

 For entry, the user should not call moving the device to D3cold, if it has
 already requested. So, we can return error in this case. For exit,
 currently, in this patch, I am clearing runtime_suspend_pending if the
 wake-up is triggered from the host side (with lspci or some other command).
 In that case, the exit should not return error. Should we add code to 
 detect multiple calling of these and ensure only one
 VFIO_DEVICE_D3COLD_STATE_ENTER/VFIO_DEVICE_D3COLD_STATE_EXIT can be called.

>> +
>> +                     break;
>> +
>> +             case VFIO_DEVICE_D3COLD_STATE_EXIT:
>> +                     /*
>> +                      * If the runtime resume has already been run, then
>> +                      * the device will be already in D0 state.
>> +                      */
>> +                     if (vdev->runtime_suspend_pending) {
>> +                             vdev->runtime_suspend_pending = false;
>> +                             pm_runtime_get_noresume(&pdev->dev);
>> +                             request_resume = true;
>> +                     }
>> +
>> +                     break;
>> +
>> +             default:
>> +                     ret = EINVAL;
>> +                     break;
>> +             }
>> +
>> +             up_write(&vdev->memory_lock);
>> +
>> +             /*
>> +              * Call the runtime PM API's without any lock. Inside vfio driver
>> +              * runtime suspend/resume, the locks can be acquired again.
>> +              */
>> +             if (request_idle)
>> +                     pm_request_idle(&pdev->dev);
>> +
>> +             if (request_resume)
>> +                     pm_runtime_resume(&pdev->dev);
>> +
>> +             return ret;
>> +#endif
>>       }
>>
>>       return -ENOTTY;
>>  }
>> +
>> +long vfio_pci_core_ioctl(struct vfio_device *core_vdev, unsigned int cmd,
>> +                      unsigned long arg)
>> +{
>> +#ifdef CONFIG_PM
>> +     struct vfio_pci_core_device *vdev =
>> +             container_of(core_vdev, struct vfio_pci_core_device, vdev);
>> +     struct device *dev = &vdev->pdev->dev;
>> +     bool skip_runtime_resume = false;
>> +     long ret;
>> +
>> +     /*
>> +      * The list of commands which are safe to execute when the PCI device
>> +      * is in D3cold state. In D3cold state, the PCI config or any other IO
>> +      * access won't work.
>> +      */
>> +     switch (cmd) {
>> +     case VFIO_DEVICE_POWER_MANAGEMENT:
>> +     case VFIO_DEVICE_GET_INFO:
>> +     case VFIO_DEVICE_FEATURE:
>> +             skip_runtime_resume = true;
>> +             break;
> 
> How can we know that there won't be DEVICE_FEATURE calls that touch the
> device, the recently added migration via DEVICE_FEATURE does already.
> DEVICE_GET_INFO seems equally as prone to breaking via capabilities
> that could touch the device.  It seems easier to maintain and more
> consistent to the user interface if we simply define that any device
> access will resume the device.

 In that case, we can resume the device for all case without
 maintaining the safe list.

> We need to do something about interrupts though. > Maybe we could error the user ioctl to set d3cold
> for devices running in INTx mode, but we also have numerous ways that
> the device could be resumed under the user, which might start
> triggering MSI/X interrupts?
> 

 All the resuming we are mainly to prevent any malicious sequence.
 If we see from normal OS side, then once the guest kernel has moved
 the device into D3cold, then it should not do any config space
 access. Similarly, from hypervisor, it should not invoke any
 ioctl other than moving the device into D0 again when the device
 is in D3cold. But, preventing the device to go into D3cold when
 any other ioctl or config space access is happening is not easy,
 so incrementing usage count before these access will ensure that
 the device won't go into D3cold. 

 For interrupts, can the interrupt happen (Both INTx and MSI/x)
 if the device is in D3cold? In D3cold, the PME events are possible
 and these events will anyway resume the device first. If the
 interrupts are not possible then can we disable all the interrupts
 somehow before going calling runtime PM API's to move the device into D3cold
 and enable it again during runtime resume. We can wait for all existing
 Interrupt to be finished first. I am not sure if this is possible. 
 
 Returning error for user ioctl to set d3cold while interrupts are
 happening needs some synchronization at both interrupt handler and
 ioctl code and using runtime resume inside interrupt handler
 may not be safe.
   
>> +
>> +     default:
>> +             break;
>> +     }
>> +
>> +     if (!skip_runtime_resume) {
>> +             ret = pm_runtime_resume_and_get(dev);
>> +             if (ret < 0)
>> +                     return ret;
>> +     }
>> +
>> +     ret = vfio_pci_core_ioctl_internal(core_vdev, cmd, arg);
>> +
> 
> I'm not a fan of wrapping the main ioctl interface for power management
> like this.
> 

 We need to increment the usage count at entry and decrement it
 again at exit. Currently, from lot of places directly, we are
 calling 'return' instead of going at function end. If we need to
 get rid of wrapper function, then I need to replace all return with
 'goto' for going at the function end and return after decrementing
 the usage count. Will this be fine ? 

>> +     if (!skip_runtime_resume)
>> +             pm_runtime_put(dev);
>> +
>> +     return ret;
>> +#else
>> +     return vfio_pci_core_ioctl_internal(core_vdev, cmd, arg);
>> +#endif
>> +}
>>  EXPORT_SYMBOL_GPL(vfio_pci_core_ioctl);
>>
>>  static ssize_t vfio_pci_rw(struct vfio_pci_core_device *vdev, char __user *buf,
>> @@ -1897,6 +2017,7 @@ int vfio_pci_core_register_device(struct vfio_pci_core_device *vdev)
>>               return -EBUSY;
>>       }
>>
>> +     dev_set_drvdata(&pdev->dev, vdev);
>>       if (pci_is_root_bus(pdev->bus)) {
>>               ret = vfio_assign_device_set(&vdev->vdev, vdev);
>>       } else if (!pci_probe_reset_slot(pdev->slot)) {
>> @@ -1966,6 +2087,7 @@ void vfio_pci_core_unregister_device(struct vfio_pci_core_device *vdev)
>>               pm_runtime_get_noresume(&pdev->dev);
>>
>>       pm_runtime_forbid(&pdev->dev);
>> +     dev_set_drvdata(&pdev->dev, NULL);
>>  }
>>  EXPORT_SYMBOL_GPL(vfio_pci_core_unregister_device);
>>
>> @@ -2219,11 +2341,61 @@ static void vfio_pci_dev_set_try_reset(struct vfio_device_set *dev_set)
>>  #ifdef CONFIG_PM
>>  static int vfio_pci_core_runtime_suspend(struct device *dev)
>>  {
>> +     struct pci_dev *pdev = to_pci_dev(dev);
>> +     struct vfio_pci_core_device *vdev = dev_get_drvdata(dev);
>> +
>> +     down_read(&vdev->memory_lock);
>> +
>> +     /*
>> +      * runtime_suspend_pending won't be set if there is no user of vfio pci
>> +      * device. In that case, return early and PCI core will take care of
>> +      * putting the device in the low power state.
>> +      */
>> +     if (!vdev->runtime_suspend_pending) {
>> +             up_read(&vdev->memory_lock);
>> +             return 0;
>> +     }
> 
> Doesn't this also mean that idle, unused devices can at best sit in
> d3hot rather than d3cold?
> 

 Sorry. I didn't get this point.

 For unused devices, the PCI core will move the device into D3cold directly.
 For the used devices, the config space write is happening first before
 this ioctl is called and the config space write is moving the device
 into D3hot so we need to do some manual thing here.

>> +
>> +     /*
>> +      * The runtime suspend will be called only if device is already at
>> +      * D3hot state. Now, change the device state from D3hot to D3cold by
>> +      * using platform power management. If setting of D3cold is not
>> +      * supported for the PCI device, then the device state will still be
>> +      * in D3hot state. The PCI core expects to save the PCI state, if
>> +      * driver runtime routine handles the power state management.
>> +      */
>> +     pci_save_state(pdev);
>> +     pci_platform_power_transition(pdev, PCI_D3cold);
>> +     up_read(&vdev->memory_lock);
>> +
>>       return 0;
>>  }
>>
>>  static int vfio_pci_core_runtime_resume(struct device *dev)
>>  {
>> +     struct pci_dev *pdev = to_pci_dev(dev);
>> +     struct vfio_pci_core_device *vdev = dev_get_drvdata(dev);
>> +
>> +     down_write(&vdev->memory_lock);
>> +
>> +     /*
>> +      * The PCI core will move the device to D0 state before calling the
>> +      * driver runtime resume.
>> +      */
>> +     vfio_pci_set_power_state_locked(vdev, PCI_D0);
> 
> Maybe this is where vdev->power_state is kept synchronized?
> 
 
 Yes. vdev->power_state will be changed here.

>> +
>> +     /*
>> +      * Some PCI device needs the SW involvement before going to D3cold
>> +      * state again. So if there is any wake-up which is not triggered
>> +      * by the guest, then increase the usage count to prevent the
>> +      * second runtime suspend.
>> +      */
> 
> Can you give examples of devices that need this and the reason they
> need this?  The interface is not terribly deterministic if a random
> unprivileged lspci on the host can move devices back to d3hot. 

 I am not sure about other device but this is happening for
 the nvidia GPU itself. 
 
 For nvidia GPU, during runtime suspend, we keep the GPU video memory
 in self-refresh mode for high video memory usage. Each video memory
 self refesh entry before D3cold requires nvidia SW involvement.
 Without SW self-refresh sequnece involvement, it won't work. 

 Details regarding runtime suspend with self-refresh can be found in

 https://download.nvidia.com/XFree86/Linux-x86_64/495.46/README/dynamicpowermanagement.html#VidMemThreshold

 But, if GPU video memory usage is low, then we turnoff video memory
 and save all the allocation in system memory. In this case, SW involvement 
 is not required. 

> How useful is this implementation if a notice to the guest of a resumed
> device is TBD?  Thanks,
> 
> Alex
> 

 I have prototyped this earlier by using eventfd_ctx for pme and whenever we get
 a resume triggered by host, then it will forward the same to hypervisor.
 Then in the hypervisor, it can write into virtual root port PME related registers
 and send PME event which will wake-up the PCI device in the guest side.
 It will help in handling PME events related wake-up also which are currently
 disabled in PATCH 2 of this patch series.
 
 Thanks,
 Abhishek

>> +     if (vdev->runtime_suspend_pending) {
>> +             vdev->runtime_suspend_pending = false;
>> +             pm_runtime_get_noresume(&pdev->dev);
>> +     }
>> +
>> +     up_write(&vdev->memory_lock);
>>       return 0;
>>  }
>>
>> diff --git a/include/linux/vfio_pci_core.h b/include/linux/vfio_pci_core.h
>> index 05db838e72cc..8bbfd028115a 100644
>> --- a/include/linux/vfio_pci_core.h
>> +++ b/include/linux/vfio_pci_core.h
>> @@ -124,6 +124,7 @@ struct vfio_pci_core_device {
>>       bool                    needs_reset;
>>       bool                    nointx;
>>       bool                    needs_pm_restore;
>> +     bool                    runtime_suspend_pending;
>>       pci_power_t             power_state;
>>       struct pci_saved_state  *pci_saved_state;
>>       struct pci_saved_state  *pm_save;
>> diff --git a/include/uapi/linux/vfio.h b/include/uapi/linux/vfio.h
>> index ef33ea002b0b..7b7dadc6df71 100644
>> --- a/include/uapi/linux/vfio.h
>> +++ b/include/uapi/linux/vfio.h
>> @@ -1002,6 +1002,27 @@ struct vfio_device_feature {
>>   */
>>  #define VFIO_DEVICE_FEATURE_PCI_VF_TOKEN     (0)
>>
>> +/**
>> + * VFIO_DEVICE_POWER_MANAGEMENT - _IOW(VFIO_TYPE, VFIO_BASE + 18,
>> + *                          struct vfio_power_management)
>> + *
>> + * Provide the support for device power management.  The native PCI power
>> + * management does not support the D3cold power state.  For moving the device
>> + * into D3cold state, change the PCI state to D3hot with standard
>> + * configuration registers and then call this IOCTL to setting the D3cold
>> + * state.  Similarly, if the device in D3cold state, then call this IOCTL
>> + * to exit from D3cold state.
>> + *
>> + * Return 0 on success, -errno on failure.
>> + */
>> +#define VFIO_DEVICE_POWER_MANAGEMENT         _IO(VFIO_TYPE, VFIO_BASE + 18)
>> +struct vfio_power_management {
>> +     __u32   argsz;
>> +#define VFIO_DEVICE_D3COLD_STATE_EXIT                0x0
>> +#define VFIO_DEVICE_D3COLD_STATE_ENTER               0x1
>> +     __u32   d3cold_state;
>> +};
>> +
>>  /* -------- API for Type1 VFIO IOMMU -------- */
>>
>>  /**
> 

Powered by blists - more mailing lists