Documentation: intel_pstate: Describe hwp_dynamic_boost sysfs knob
authorRafael J. Wysocki <rafael.j.wysocki@intel.com>
Tue, 26 Jun 2018 15:20:43 +0000 (17:20 +0200)
committerRafael J. Wysocki <rafael.j.wysocki@intel.com>
Wed, 27 Jun 2018 11:02:06 +0000 (13:02 +0200)
Document the recently introduced hwp_dynamic_boost sysfs knob
allowing user space to tell intel_pstate to use iowait boosting
in the active mode with HWP enabled (to improve performance).

Signed-off-by: Rafael J. Wysocki <rafael.j.wysocki@intel.com>
Acked-by: Srinivas Pandruvada <srinivas.pandruvada@linux.intel.com>
Documentation/admin-guide/pm/intel_pstate.rst

index d74fb572f6cca2f982f201c9a07eb7a29157ffe8..8f1d3de449b53fedcc78d1aee506e6882f2be90c 100644 (file)
@@ -378,6 +378,17 @@ argument is passed to the kernel in the command line.
        but it affects the maximum possible value of per-policy P-state limits
        (see `Interpretation of Policy Attributes`_ below for details).
 
+``hwp_dynamic_boost``
+       This attribute is only present if ``intel_pstate`` works in the
+       `active mode with the HWP feature enabled <Active Mode With HWP_>`_ in
+       the processor.  If set (equal to 1), it causes the minimum P-state limit
+       to be increased dynamically for a short time whenever a task previously
+       waiting on I/O is selected to run on a given logical CPU (the purpose
+       of this mechanism is to improve performance).
+
+       This setting has no effect on logical CPUs whose minimum P-state limit
+       is directly set to the highest non-turbo P-state or above it.
+
 .. _status_attr:
 
 ``status``