Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

cpufreq: intel_pstate: Documentation: Add references sections

Add separate refereces sections to the cpufreq.rst and
intel_pstate.rst documents under admin-quide/pm and list the
references to external documentation in there.

Update the ACPI specification URL while at it.

Signed-off-by: Rafael J. Wysocki <rafael.j.wysocki@intel.com>
Acked-by: Viresh Kumar <viresh.kumar@linaro.org>

+23 -12
+7 -3
Documentation/admin-guide/pm/cpufreq.rst
··· 396 396 the allowed maximum (that is, the ``scaling_max_freq`` policy limit). In turn, 397 397 if it is invoked by the CFS scheduling class, the governor will use the 398 398 Per-Entity Load Tracking (PELT) metric for the root control group of the 399 - given CPU as the CPU utilization estimate (see the `Per-entity load tracking`_ 400 - LWN.net article for a description of the PELT mechanism). Then, the new 399 + given CPU as the CPU utilization estimate (see the *Per-entity load tracking* 400 + LWN.net article [1]_ for a description of the PELT mechanism). Then, the new 401 401 CPU frequency to apply is computed in accordance with the formula 402 402 403 403 f = 1.25 * ``f_0`` * ``util`` / ``max`` ··· 698 698 :c:macro:`CONFIG_X86_ACPI_CPUFREQ_CPB` configuration option is set. 699 699 700 700 701 - .. _Per-entity load tracking: https://lwn.net/Articles/531853/ 701 + References 702 + ========== 703 + 704 + .. [1] Jonathan Corbet, *Per-entity load tracking*, 705 + https://lwn.net/Articles/531853/
+16 -9
Documentation/admin-guide/pm/intel_pstate.rst
··· 20 20 21 21 For the processors supported by ``intel_pstate``, the P-state concept is broader 22 22 than just an operating frequency or an operating performance point (see the 23 - `LinuxCon Europe 2015 presentation by Kristen Accardi <LCEU2015_>`_ for more 23 + LinuxCon Europe 2015 presentation by Kristen Accardi [1]_ for more 24 24 information about that). For this reason, the representation of P-states used 25 25 by ``intel_pstate`` internally follows the hardware specification (for details 26 - refer to `Intel® 64 and IA-32 Architectures Software Developer’s Manual 27 - Volume 3: System Programming Guide <SDM_>`_). However, the ``CPUFreq`` core 26 + refer to Intel Software Developer’s Manual [2]_). However, the ``CPUFreq`` core 28 27 uses frequencies for identifying operating performance points of CPUs and 29 28 frequencies are involved in the user space interface exposed by it, so 30 29 ``intel_pstate`` maps its internal representation of P-states to frequencies too ··· 560 561 561 562 On the majority of systems supported by ``intel_pstate``, the ACPI tables 562 563 provided by the platform firmware contain ``_PSS`` objects returning information 563 - that can be used for CPU performance scaling (refer to the `ACPI specification`_ 564 - for details on the ``_PSS`` objects and the format of the information returned 565 - by them). 564 + that can be used for CPU performance scaling (refer to the ACPI specification 565 + [3]_ for details on the ``_PSS`` objects and the format of the information 566 + returned by them). 566 567 567 568 The information returned by the ACPI ``_PSS`` objects is used by the 568 569 ``acpi-cpufreq`` scaling driver. On systems supported by ``intel_pstate`` ··· 727 728 <idle>-0 [000] ..s. 2537.654843: intel_pstate_set_pstate <-intel_pstate_timer_func 728 729 729 730 730 - .. _LCEU2015: http://events.linuxfoundation.org/sites/events/files/slides/LinuxConEurope_2015.pdf 731 - .. _SDM: http://www.intel.com/content/www/us/en/architecture-and-technology/64-ia-32-architectures-software-developer-system-programming-manual-325384.html 732 - .. _ACPI specification: http://www.uefi.org/sites/default/files/resources/ACPI_6_1.pdf 731 + References 732 + ========== 733 + 734 + .. [1] Kristen Accardi, *Balancing Power and Performance in the Linux Kernel*, 735 + http://events.linuxfoundation.org/sites/events/files/slides/LinuxConEurope_2015.pdf 736 + 737 + .. [2] *Intel® 64 and IA-32 Architectures Software Developer’s Manual Volume 3: System Programming Guide*, 738 + http://www.intel.com/content/www/us/en/architecture-and-technology/64-ia-32-architectures-software-developer-system-programming-manual-325384.html 739 + 740 + .. [3] *Advanced Configuration and Power Interface Specification*, 741 + https://uefi.org/sites/default/files/resources/ACPI_6_3_final_Jan30.pdf