rte_power_pmd_mgmt.h

       Generated automatically by Doxygen for DPDK from the source code.

DPDK                                             Version 24.11.2                         rte_power_pmd_mgmt.h(3)

       RTE PMD Power Management

       Definition in file rte_power_pmd_mgmt.h.

enumrte_power_pmd_mgmt_type
       PMD Power Management Type

       EnumeratorRTE_POWER_MGMT_TYPE_MONITOR
              Use power-optimized monitoring to wait for incoming traffic

       RTE_POWER_MGMT_TYPE_PAUSE
              Use power-optimized sleep to avoid busy polling

       RTE_POWER_MGMT_TYPE_SCALE
              Use frequency scaling when traffic is low

       Definition at line 25 of file rte_power_pmd_mgmt.h.

intrte_power_ethdev_pmgmt_queue_enable(unsignedintlcore_id,uint16_tport_id,uint16_tqueue_id,enumrte_power_pmd_mgmt_typemode)
       Enable power management on a specified Ethernet device Rx queue and lcore.

       Note
           This function is not thread-safe.

       Warning
           This function must be called when all affected Ethernet  queues  are  stopped  and  no  Rx/Tx  is  in
           progress!

       Parameterslcore_id The lcore the Rx queue will be polled from.
           port_id The port identifier of the Ethernet device.
           queue_id The queue identifier of the Ethernet device.
           mode The power management scheme to use for specified Rx queue.

       Returns
           0 on success <0 on error

   intrte_power_ethdev_pmgmt_queue_disable(unsignedintlcore_id,uint16_tport_id,uint16_tqueue_id)
       Disable power management on a specified Ethernet device Rx queue and lcore.

       Note
           This function is not thread-safe.

       Warning
           This  function  must  be  called  when  all  affected  Ethernet queues are stopped and no Rx/Tx is in
           progress!

       Parameterslcore_id The lcore the Rx queue is polled from.
           port_id The port identifier of the Ethernet device.
           queue_id The queue identifier of the Ethernet device.

       Returns
           0 on success <0 on error

   voidrte_power_pmd_mgmt_set_emptypoll_max(unsignedintmax)
       Set a emptypoll_max to specified value. Used to specify the number of empty polls to wait before entering
       sleep state.

       Parametersmax The value to set emptypoll_max to.

   unsignedintrte_power_pmd_mgmt_get_emptypoll_max(void)
       Get the current value of emptypoll_max.

       Returns
           The current emptypoll_max value

   intrte_power_pmd_mgmt_set_pause_duration(unsignedintduration)
       Set the pause_duration. Used to adjust the pause mode callback duration.

       Note
           Duration must be greater than zero.

       Parametersduration The value to set pause_duration to.

       Returns
           0 on success <0 on error

   unsignedintrte_power_pmd_mgmt_get_pause_duration(void)
       Get the current value of pause_duration.

       Returns
           The current pause_duration value.

   intrte_power_pmd_mgmt_set_scaling_freq_min(unsignedintlcore,unsignedintmin)
       Set the min frequency to be used for frequency scaling or zero to use defaults.

       Note
           Supported by: Pstate mode.

       Parameterslcore The ID of the lcore to set the min frequency for.
           min The value, in KiloHertz, to set the minimum frequency to.

       Returns
           0 on success <0 on error

   intrte_power_pmd_mgmt_set_scaling_freq_max(unsignedintlcore,unsignedintmax)
       Set the max frequency to be used for frequency scaling or zero to use defaults.

       Note
           Supported by: Pstate mode.

       Parameterslcore The ID of the lcore to set the max frequency for.
           max The value, in KiloHertz, to set the maximum frequency to. If 'max' is 0, it  is  considered  'not
           set'.

       Returns
           0 on success <0 on error

   intrte_power_pmd_mgmt_get_scaling_freq_min(unsignedintlcore)
       Get the current configured min frequency used for frequency scaling.

       Note
           Supported by: Pstate mode.

       Parameterslcore The ID of the lcore to get the min frequency for.

       Returns
           0  if  no value has been configured via the 'set' API. >0 if a minimum frequency has been configured.
           Value is the minimum frequency , in KiloHertz, used for frequency scaling. <0 on error

   intrte_power_pmd_mgmt_get_scaling_freq_max(unsignedintlcore)
       Get the current configured max frequency used for frequency scaling.

       Note
           Supported by: Pstate mode.

       Parameterslcore The ID of the lcore to get the max frequency for.

       Returns
           0 if no value has been configured via the 'set' API. >0 if a maximum frequency has  been  configured.
           Value is the maximum frequency , in KiloHertz, used for frequency scaling. <0 on error

       rte_power_pmd_mgmt.h

       #include <stdint.h>
       #include <rte_log.h>
       #include <rte_power_cpufreq.h>

   Enumerations
       enum rte_power_pmd_mgmt_type { RTE_POWER_MGMT_TYPE_MONITOR = 1, RTE_POWER_MGMT_TYPE_PAUSE,
           RTE_POWER_MGMT_TYPE_SCALE }

   Functions
       int rte_power_ethdev_pmgmt_queue_enable (unsigned int lcore_id, uint16_t port_id, uint16_t queue_id, enum
           rte_power_pmd_mgmt_type mode)
       int rte_power_ethdev_pmgmt_queue_disable (unsigned int lcore_id, uint16_t port_id, uint16_t queue_id)
       void rte_power_pmd_mgmt_set_emptypoll_max (unsigned int max)
       unsigned int rte_power_pmd_mgmt_get_emptypoll_max (void)
       int rte_power_pmd_mgmt_set_pause_duration (unsigned int duration)
       unsigned int rte_power_pmd_mgmt_get_pause_duration (void)
       int rte_power_pmd_mgmt_set_scaling_freq_min (unsigned int lcore, unsigned int min)
       int rte_power_pmd_mgmt_set_scaling_freq_max (unsigned int lcore, unsigned int max)
       int rte_power_pmd_mgmt_get_scaling_freq_min (unsigned int lcore)
       int rte_power_pmd_mgmt_get_scaling_freq_max (unsigned int lcore)