Loading .mailmap +2 −0 Original line number Original line Diff line number Diff line Loading @@ -68,6 +68,8 @@ Jacob Shin <Jacob.Shin@amd.com> James Bottomley <jejb@mulgrave.(none)> James Bottomley <jejb@mulgrave.(none)> James Bottomley <jejb@titanic.il.steeleye.com> James Bottomley <jejb@titanic.il.steeleye.com> James E Wilson <wilson@specifix.com> James E Wilson <wilson@specifix.com> James Hogan <jhogan@kernel.org> <james.hogan@imgtec.com> James Hogan <jhogan@kernel.org> <james@albanarts.com> James Ketrenos <jketreno@io.(none)> James Ketrenos <jketreno@io.(none)> Javi Merino <javi.merino@kernel.org> <javi.merino@arm.com> Javi Merino <javi.merino@kernel.org> <javi.merino@arm.com> <javier@osg.samsung.com> <javier.martinez@collabora.co.uk> <javier@osg.samsung.com> <javier.martinez@collabora.co.uk> Loading Documentation/ABI/testing/sysfs-devices-power +3 −17 Original line number Original line Diff line number Diff line Loading @@ -211,7 +211,9 @@ Description: device, after it has been suspended at run time, from a resume device, after it has been suspended at run time, from a resume request to the moment the device will be ready to process I/O, request to the moment the device will be ready to process I/O, in microseconds. If it is equal to 0, however, this means that in microseconds. If it is equal to 0, however, this means that the PM QoS resume latency may be arbitrary. the PM QoS resume latency may be arbitrary and the special value "n/a" means that user space cannot accept any resume latency at all for the given device. Not all drivers support this attribute. If it isn't supported, Not all drivers support this attribute. If it isn't supported, it is not present. it is not present. Loading Loading @@ -258,19 +260,3 @@ Description: This attribute has no effect on system-wide suspend/resume and This attribute has no effect on system-wide suspend/resume and hibernation. hibernation. What: /sys/devices/.../power/pm_qos_remote_wakeup Date: September 2012 Contact: Rafael J. Wysocki <rjw@rjwysocki.net> Description: The /sys/devices/.../power/pm_qos_remote_wakeup attribute is used for manipulating the PM QoS "remote wakeup required" flag. If set, this flag indicates to the kernel that the device is a source of user events that have to be signaled from its low-power states. Not all drivers support this attribute. If it isn't supported, it is not present. This attribute has no effect on system-wide suspend/resume and hibernation. Documentation/ABI/testing/sysfs-power +1 −1 Original line number Original line Diff line number Diff line Loading @@ -127,7 +127,7 @@ Description: What; /sys/power/pm_trace_dev_match What; /sys/power/pm_trace_dev_match Date: October 2010 Date: October 2010 Contact: James Hogan <james@albanarts.com> Contact: James Hogan <jhogan@kernel.org> Description: Description: The /sys/power/pm_trace_dev_match file contains the name of the The /sys/power/pm_trace_dev_match file contains the name of the device associated with the last PM event point saved in the RTC device associated with the last PM event point saved in the RTC Loading Documentation/core-api/workqueue.rst +6 −6 Original line number Original line Diff line number Diff line Loading @@ -39,8 +39,8 @@ up. Although MT wq wasted a lot of resource, the level of concurrency Although MT wq wasted a lot of resource, the level of concurrency provided was unsatisfactory. The limitation was common to both ST and provided was unsatisfactory. The limitation was common to both ST and MT wq albeit less severe on MT. Each wq maintained its own separate MT wq albeit less severe on MT. Each wq maintained its own separate worker pool. A MT wq could provide only one execution context per CPU worker pool. An MT wq could provide only one execution context per CPU while a ST wq one for the whole system. Work items had to compete for while an ST wq one for the whole system. Work items had to compete for those very limited execution contexts leading to various problems those very limited execution contexts leading to various problems including proneness to deadlocks around the single execution context. including proneness to deadlocks around the single execution context. Loading Loading @@ -151,7 +151,7 @@ Application Programming Interface (API) ``alloc_workqueue()`` allocates a wq. The original ``alloc_workqueue()`` allocates a wq. The original ``create_*workqueue()`` functions are deprecated and scheduled for ``create_*workqueue()`` functions are deprecated and scheduled for removal. ``alloc_workqueue()`` takes three arguments - @``name``, removal. ``alloc_workqueue()`` takes three arguments - ``@name``, ``@flags`` and ``@max_active``. ``@name`` is the name of the wq and ``@flags`` and ``@max_active``. ``@name`` is the name of the wq and also used as the name of the rescuer thread if there is one. also used as the name of the rescuer thread if there is one. Loading Loading @@ -197,7 +197,7 @@ resources, scheduled and executed. served by worker threads with elevated nice level. served by worker threads with elevated nice level. Note that normal and highpri worker-pools don't interact with Note that normal and highpri worker-pools don't interact with each other. Each maintain its separate pool of workers and each other. Each maintains its separate pool of workers and implements concurrency management among its workers. implements concurrency management among its workers. ``WQ_CPU_INTENSIVE`` ``WQ_CPU_INTENSIVE`` Loading Loading @@ -249,8 +249,8 @@ unbound worker-pools and only one work item could be active at any given time thus achieving the same ordering property as ST wq. time thus achieving the same ordering property as ST wq. In the current implementation the above configuration only guarantees In the current implementation the above configuration only guarantees ST behavior within a given NUMA node. Instead alloc_ordered_queue should ST behavior within a given NUMA node. Instead ``alloc_ordered_queue()`` should be used to achieve system wide ST behavior. be used to achieve system-wide ST behavior. Example Execution Scenarios Example Execution Scenarios Loading Documentation/cpu-freq/index.txt +0 −2 Original line number Original line Diff line number Diff line Loading @@ -32,8 +32,6 @@ cpufreq-stats.txt - General description of sysfs cpufreq stats. index.txt - File index, Mailing list and Links (this document) index.txt - File index, Mailing list and Links (this document) intel-pstate.txt - Intel pstate cpufreq driver specific file. pcc-cpufreq.txt - PCC cpufreq driver specific file. pcc-cpufreq.txt - PCC cpufreq driver specific file. Loading Loading
.mailmap +2 −0 Original line number Original line Diff line number Diff line Loading @@ -68,6 +68,8 @@ Jacob Shin <Jacob.Shin@amd.com> James Bottomley <jejb@mulgrave.(none)> James Bottomley <jejb@mulgrave.(none)> James Bottomley <jejb@titanic.il.steeleye.com> James Bottomley <jejb@titanic.il.steeleye.com> James E Wilson <wilson@specifix.com> James E Wilson <wilson@specifix.com> James Hogan <jhogan@kernel.org> <james.hogan@imgtec.com> James Hogan <jhogan@kernel.org> <james@albanarts.com> James Ketrenos <jketreno@io.(none)> James Ketrenos <jketreno@io.(none)> Javi Merino <javi.merino@kernel.org> <javi.merino@arm.com> Javi Merino <javi.merino@kernel.org> <javi.merino@arm.com> <javier@osg.samsung.com> <javier.martinez@collabora.co.uk> <javier@osg.samsung.com> <javier.martinez@collabora.co.uk> Loading
Documentation/ABI/testing/sysfs-devices-power +3 −17 Original line number Original line Diff line number Diff line Loading @@ -211,7 +211,9 @@ Description: device, after it has been suspended at run time, from a resume device, after it has been suspended at run time, from a resume request to the moment the device will be ready to process I/O, request to the moment the device will be ready to process I/O, in microseconds. If it is equal to 0, however, this means that in microseconds. If it is equal to 0, however, this means that the PM QoS resume latency may be arbitrary. the PM QoS resume latency may be arbitrary and the special value "n/a" means that user space cannot accept any resume latency at all for the given device. Not all drivers support this attribute. If it isn't supported, Not all drivers support this attribute. If it isn't supported, it is not present. it is not present. Loading Loading @@ -258,19 +260,3 @@ Description: This attribute has no effect on system-wide suspend/resume and This attribute has no effect on system-wide suspend/resume and hibernation. hibernation. What: /sys/devices/.../power/pm_qos_remote_wakeup Date: September 2012 Contact: Rafael J. Wysocki <rjw@rjwysocki.net> Description: The /sys/devices/.../power/pm_qos_remote_wakeup attribute is used for manipulating the PM QoS "remote wakeup required" flag. If set, this flag indicates to the kernel that the device is a source of user events that have to be signaled from its low-power states. Not all drivers support this attribute. If it isn't supported, it is not present. This attribute has no effect on system-wide suspend/resume and hibernation.
Documentation/ABI/testing/sysfs-power +1 −1 Original line number Original line Diff line number Diff line Loading @@ -127,7 +127,7 @@ Description: What; /sys/power/pm_trace_dev_match What; /sys/power/pm_trace_dev_match Date: October 2010 Date: October 2010 Contact: James Hogan <james@albanarts.com> Contact: James Hogan <jhogan@kernel.org> Description: Description: The /sys/power/pm_trace_dev_match file contains the name of the The /sys/power/pm_trace_dev_match file contains the name of the device associated with the last PM event point saved in the RTC device associated with the last PM event point saved in the RTC Loading
Documentation/core-api/workqueue.rst +6 −6 Original line number Original line Diff line number Diff line Loading @@ -39,8 +39,8 @@ up. Although MT wq wasted a lot of resource, the level of concurrency Although MT wq wasted a lot of resource, the level of concurrency provided was unsatisfactory. The limitation was common to both ST and provided was unsatisfactory. The limitation was common to both ST and MT wq albeit less severe on MT. Each wq maintained its own separate MT wq albeit less severe on MT. Each wq maintained its own separate worker pool. A MT wq could provide only one execution context per CPU worker pool. An MT wq could provide only one execution context per CPU while a ST wq one for the whole system. Work items had to compete for while an ST wq one for the whole system. Work items had to compete for those very limited execution contexts leading to various problems those very limited execution contexts leading to various problems including proneness to deadlocks around the single execution context. including proneness to deadlocks around the single execution context. Loading Loading @@ -151,7 +151,7 @@ Application Programming Interface (API) ``alloc_workqueue()`` allocates a wq. The original ``alloc_workqueue()`` allocates a wq. The original ``create_*workqueue()`` functions are deprecated and scheduled for ``create_*workqueue()`` functions are deprecated and scheduled for removal. ``alloc_workqueue()`` takes three arguments - @``name``, removal. ``alloc_workqueue()`` takes three arguments - ``@name``, ``@flags`` and ``@max_active``. ``@name`` is the name of the wq and ``@flags`` and ``@max_active``. ``@name`` is the name of the wq and also used as the name of the rescuer thread if there is one. also used as the name of the rescuer thread if there is one. Loading Loading @@ -197,7 +197,7 @@ resources, scheduled and executed. served by worker threads with elevated nice level. served by worker threads with elevated nice level. Note that normal and highpri worker-pools don't interact with Note that normal and highpri worker-pools don't interact with each other. Each maintain its separate pool of workers and each other. Each maintains its separate pool of workers and implements concurrency management among its workers. implements concurrency management among its workers. ``WQ_CPU_INTENSIVE`` ``WQ_CPU_INTENSIVE`` Loading Loading @@ -249,8 +249,8 @@ unbound worker-pools and only one work item could be active at any given time thus achieving the same ordering property as ST wq. time thus achieving the same ordering property as ST wq. In the current implementation the above configuration only guarantees In the current implementation the above configuration only guarantees ST behavior within a given NUMA node. Instead alloc_ordered_queue should ST behavior within a given NUMA node. Instead ``alloc_ordered_queue()`` should be used to achieve system wide ST behavior. be used to achieve system-wide ST behavior. Example Execution Scenarios Example Execution Scenarios Loading
Documentation/cpu-freq/index.txt +0 −2 Original line number Original line Diff line number Diff line Loading @@ -32,8 +32,6 @@ cpufreq-stats.txt - General description of sysfs cpufreq stats. index.txt - File index, Mailing list and Links (this document) index.txt - File index, Mailing list and Links (this document) intel-pstate.txt - Intel pstate cpufreq driver specific file. pcc-cpufreq.txt - PCC cpufreq driver specific file. pcc-cpufreq.txt - PCC cpufreq driver specific file. Loading