Changes in sysfs-power

01d00914 - ABI: sysfs-power: fix a what tag

Mon, 10 Feb 2025 10:17:57 +0000

ABI: sysfs-power: fix a what tagThere is one What tag that it is using semicolon instead of colon.Fix it to comply with ABI description and produce right results whenconverted to html/pdf.Signed-off-by: Mauro Carvalho Chehab Signed-off-by: Jonathan Corbet Link: https://lore.kernel.org/r/508051136ea2e07e0dd7fa41ff40382387c24ba8.1739182025.git.mchehab+huawei@kernel.org List of files: /linux-6.15/Documentation/ABI/testing/sysfs-power

b52124a7 - PM: Add sysfs files to represent time spent in hardware sleep state

Mon, 17 Apr 2023 15:27:05 +0000

PM: Add sysfs files to represent time spent in hardware sleep stateUserspace can't easily discover how much of a sleep cycle was spent in ahardware sleep state without using kernel tracing and vendor specific sysfsor debugfs files.To make this information more discoverable, introduce 3 new sysfs files:1) The time spent in a hw sleep state for last cycle.2) The time spent in a hw sleep state since the kernel booted3) The maximum time that the hardware can report for a sleep cycle.All of these files will be present only if the system supports s2idle.Reviewed-by: Hans de Goede Signed-off-by: Mario Limonciello Signed-off-by: Rafael J. Wysocki List of files: /linux-6.15/Documentation/ABI/testing/sysfs-power

8a7f0e8a - Documentation/ABI: correct possessive "its" typos

Mon, 01 Aug 2022 02:52:07 +0000

Documentation/ABI: correct possessive "its" typosCorrect all uses of "it's" that are meant to be possessive "its".Signed-off-by: Randy Dunlap Cc: Jonathan Corbet Cc: Greg Kroah-Hartman Link: https://lore.kernel.org/r/20220801025207.29971-1-rdunlap@infradead.orgSigned-off-by: Jonathan Corbet List of files: /linux-6.15/Documentation/ABI/testing/sysfs-power

8599a12b - platform/x86: Update Mario Limonciello's email address in the docs

Tue, 10 Aug 2021 16:09:00 +0000

platform/x86: Update Mario Limonciello's email address in the docsVarious pdx86 docs under Documentation/ABI/testing still use Mario'sold, now defunct, address.Update the docs to point to either the new Dell.Client.Kernel@dell.comemail alias for Dell specific drivers, or to Mario's new @outlook.comaddress for other drivers.Cc: Dell.Client.Kernel@dell.comCc: Mario Limonciello Signed-off-by: Hans de Goede Link: https://lore.kernel.org/r/20210810160900.106512-1-hdegoede@redhat.com List of files: /linux-6.15/Documentation/ABI/testing/sysfs-power

54a19b4d - docs: ABI: cleanup several ABI documents

Fri, 30 Oct 2020 07:40:50 +0000

docs: ABI: cleanup several ABI documentsThere are some ABI documents that, while they don't generateany warnings, they have issues when parsed by get_abi.pl scripton its output result.Address them, in order to provide a clean output.Reviewed-by: Tom Rix # for fpga-managerReviewed-By: Kajol Jain # for sysfs-bus-event_source-devices-hv_gpci and sysfs-bus-event_source-devices-hv_24x7Acked-by: Jonathan Cameron #for IIOAcked-by: Oded Gabbay # for HabanalabsAcked-by: Vaibhav Jain # for sysfs-bus-papr-pmemAcked-by: Cezary Rojewski # for catptAcked-by: Suzuki K Poulose Acked-by: Ilya Dryomov # for rbdAcked-by: Jonathan Corbet Signed-off-by: Mauro Carvalho Chehab Link: https://lore.kernel.org/r/5bc78e5b68ed1e9e39135173857cb2e753be868f.1604042072.git.mchehab+huawei@kernel.orgSigned-off-by: Greg Kroah-Hartman List of files: /linux-6.15/Documentation/ABI/testing/sysfs-power

c052bf82 - PM: suspend: Add sysfs attribute to control the "sync on suspend" behavior

Thu, 16 Jan 2020 11:53:54 +0000

PM: suspend: Add sysfs attribute to control the "sync on suspend" behaviorThe sysfs attribute `/sys/power/sync_on_suspend` controls, whether or notfilesystems are synced by the kernel before system suspend.Congruously, the behaviour of build-time switch CONFIG_SUSPEND_SKIP_SYNCis slightly changed: It now defines the run-tim default for the new sysfsattribute `/sys/power/sync_on_suspend`.The run-time attribute is added because the existing correspondingbuild-time Kconfig flag for (`CONFIG_SUSPEND_SKIP_SYNC`) is not flexibleenough. E.g. Linux distributions that provide pre-compiled kernelsusually want to stick with the default (sync filesystems before suspend)but under special conditions this needs to be changed.One example for such a special condition is user-space handling ofsuspending block devices (e.g. using `cryptsetup luksSuspend` or `dmsetupsuspend`) before system suspend. The Kernel trying to sync filesystemsafter the underlying block device already got suspended obviously leadsto dead-locks. Be aware that you have to take care of the filesystem syncyourself before suspending the system in those scenarios.Signed-off-by: Jonas Meurer Signed-off-by: Rafael J. Wysocki List of files: /linux-6.15/Documentation/ABI/testing/sysfs-power

2c8db5be - PM/sleep: Expose suspend stats in sysfs

Wed, 31 Jul 2019 21:29:33 +0000

PM/sleep: Expose suspend stats in sysfsUserspace can get suspend stats from the suspend stats debugfs node.Since debugfs doesn't have stable ABI, expose suspend stats insysfs under /sys/power/suspend_stats.Signed-off-by: Kalesh Singh Reviewed-by: Greg Kroah-Hartman Signed-off-by: Rafael J. Wysocki List of files: /linux-6.15/Documentation/ABI/testing/sysfs-power

5004efbb - Documentation: ABI: power: Add missing newline at end of file

Mon, 01 Jul 2019 13:58:27 +0000

Documentation: ABI: power: Add missing newline at end of file"git diff" says: \ No newline at end of fileafter modifying the files.Signed-off-by: Geert Uytterhoeven Signed-off-by: Rafael J. Wysocki List of files: /linux-6.15/Documentation/ABI/testing/sysfs-power

3bb75644 - PM / hibernate: Documentation: fix image_size default value

Sat, 01 Sep 2018 04:51:15 +0000

PM / hibernate: Documentation: fix image_size default valueThis commit updates the default value of /sys/power/image_size inthe documentation.Since ac5c24ec1e983313ef0015258fba6f630e54e7cn the `image_size' value isset to about 2/5 of RAM, according to kernel/power/snapshot.c: image_size = ((totalram_pages * 2) / 5) * PAGE_SIZE;but this change was not reflected everywhere in the documentation.Signed-off-by: Vladimir D. Seleznev Signed-off-by: Rafael J. Wysocki List of files: /linux-6.15/Documentation/ABI/testing/sysfs-power

35506467 - PM / hibernate: Make passing hibernate offsets more friendly

Wed, 28 Mar 2018 17:01:09 +0000

PM / hibernate: Make passing hibernate offsets more friendlyCurrently the only way to specify a hibernate offset for aswap file is on the kernel command line.Add a new /sys/power/resume_offset that lets userspacespecify the offset and disk to use when initiating a hibernatecycle.Signed-off-by: Mario Limonciello Signed-off-by: Rafael J. Wysocki List of files: /linux-6.15/Documentation/ABI/testing/sysfs-power

3ba9b1b8 - Documentation: fix admin-guide doc refs

Tue, 10 Oct 2017 17:36:16 +0000

Documentation: fix admin-guide doc refsMake admin-guide document refs valid.Signed-off-by: Tom Saeger Acked-by: Rafael J. Wysocki Signed-off-by: Jonathan Corbet List of files: /linux-6.15/Documentation/ABI/testing/sysfs-power

e0a86312 - Update James Hogan's email address

Wed, 04 Oct 2017 22:10:59 +0000

Update James Hogan's email addressUpdate my imgtec.com and personal email address to my kernel.org one ina few places as MIPS will soon no longer be part of ImaginationTechnologies, and add mappings in .mailcap so get_maintainer.pl reportsthe right address.Signed-off-by: James Hogan Signed-off-by: Linus Torvalds List of files: /linux-6.15/Documentation/ABI/testing/sysfs-power

8d8b2441 - PM / sleep: Do not print debug messages by default

Wed, 19 Jul 2017 00:38:44 +0000

PM / sleep: Do not print debug messages by defaultDebug messages from the system suspend/hibernation infrastructure canfill up the entire kernel log buffer in some cases and anyway theyare only useful for debugging. They depend on CONFIG_PM_DEBUG, butthat is set as a rule as some generally useful diagnostic facilitiesdepend on it too.For this reason, avoid printing those messages by default, but makeit possible to turn them on as needed with the help of a new sysfsattribute under /sys/power/.Signed-off-by: Rafael J. Wysocki List of files: /linux-6.15/Documentation/ABI/testing/sysfs-power

406e7938 - PM / sleep: System sleep state selection interface rework

Mon, 21 Nov 2016 21:45:40 +0000

PM / sleep: System sleep state selection interface reworkThere are systems in which the platform doesn't support any specialsleep states, so suspend-to-idle (PM_SUSPEND_FREEZE) is the onlyavailable system sleep state. However, some user space frameworksonly use the "mem" and (sometimes) "standby" sleep state labels, sothe users of those systems need to modify user space in order to beable to use system suspend at all and that may be a pain in practice.Commit 0399d4db3edf (PM / sleep: Introduce command line argument forsleep state enumeration) attempted to address this problem by addinga command line argument to change the meaning of the "mem" string in/sys/power/state to make it trigger suspend-to-idle (instead ofsuspend-to-RAM).However, there also are systems in which the platform does supportspecial sleep states, but suspend-to-idle is the preferred one anyway(it even may save more energy than the platform-provided sleep statesin some cases) and the above commit doesn't help in those cases.For this reason, rework the system sleep state selection interfaceagain (but preserve backwards compatibiliby). Namely, add a newsysfs file, /sys/power/mem_sleep, that will control the systemsuspend mode triggered by writing "mem" to /sys/power/state (inanalogy with what /sys/power/disk does for hibernation). Make itselect suspend-to-RAM ("deep" sleep) by default (if supported) andfall back to suspend-to-idle ("s2idle") otherwise and add a newcommand line argument, mem_sleep_default, allowing that default tobe overridden if need be.At the same time, drop the relative_sleep_states command lineargument that doesn't make sense any more.Signed-off-by: Rafael J. Wysocki Tested-by: Mario Limonciello List of files: /linux-6.15/Documentation/ABI/testing/sysfs-power

a6f5f0dd - PM / sleep: Report interrupt that caused system wakeup

Tue, 15 Sep 2015 17:32:46 +0000

PM / sleep: Report interrupt that caused system wakeupAdd a sysfs attribute, /sys/power/pm_wakeup_irq, reporting the IRQnumber of the first wakeup interrupt (that is, the first interruptfrom an IRQ line armed for system wakeup) seen by the kernel duringthe most recent system suspend/resume cycle.This feature will be useful for system wakeup diagnostics ofspurious wakeup interrupts.Signed-off-by: Alexandra Yates [ rjw: Fixed up pm_wakeup_irq definition ]Signed-off-by: Rafael J. Wysocki List of files: /linux-6.15/Documentation/ABI/testing/sysfs-power

0399d4db - PM / sleep: Introduce command line argument for sleep state enumeration

Mon, 26 May 2014 11:40:59 +0000

PM / sleep: Introduce command line argument for sleep state enumerationOn some systems the platform doesn't support neitherPM_SUSPEND_MEM nor PM_SUSPEND_STANDBY, so PM_SUSPEND_FREEZE is theonly available system sleep state. However, some user space frameworksonly use the "mem" and (sometimes) "standby" sleep state labels, sothe users of those systems need to modify user space in order to beable to use system suspend at all and that is not always possible.For this reason, add a new kernel command line argument,relative_sleep_states, allowing the users of those systems to changethe way in which the kernel assigns labels to system sleep states.Namely, for relative_sleep_states=1, the "mem", "standby" and "freeze"labels will enumerate the available system sleem states from thedeepest to the shallowest, respectively, so that "mem" is alwayspresent in /sys/power/state and the other state strings may or maynot be presend depending on what is supported by the platform.Update system sleep states documentation to reflect this change.Signed-off-by: Rafael J. Wysocki List of files: /linux-6.15/Documentation/ABI/testing/sysfs-power

af02b5fd - PM: Add missing "freeze" state

Tue, 11 Mar 2014 11:08:11 +0000

PM: Add missing "freeze" stateFix descriptions of /sys/power/state in the documentation and ina code comment.Signed-off-by: Geert Uytterhoeven Reviewed-by: Srivatsa S. Bhat Acked-by: Pavel Machek [rjw: Changelog]Signed-off-by: Rafael J. Wysocki List of files: /linux-6.15/Documentation/ABI/testing/sysfs-power

49db1903 - MAINTAINERS / Documentation: Update Rafael's e-mail address

Tue, 08 Oct 2013 23:47:53 +0000

MAINTAINERS / Documentation: Update Rafael's e-mail addressThe e-mail address rjw@sisk.pl that I have been using for quite sometime is going to expire at one point, so replace it with a new one,rjw@rjwysocki.net, everywhere in MAINTAINERS and Documentation/ABI.Signed-off-by: Rafael J. Wysocki List of files: /linux-6.15/Documentation/ABI/testing/sysfs-power

4b7760ba - PM / Sleep: add knob for printing device resume times

Tue, 19 Jun 2012 20:23:33 +0000

PM / Sleep: add knob for printing device resume timesAdded a new knob called /sys/power/pm_print_times. Setting it to 1enables printing of time taken by devices to suspend and resume.Setting it to 0 disables this printing (unless overridden byinitcall_debug kernel command line option).Signed-off-by: Sameer Nanda Acked-by: Greg KH Signed-off-by: Rafael J. Wysocki List of files: /linux-6.15/Documentation/ABI/testing/sysfs-power

b86ff982 - PM / Sleep: Add user space interface for manipulating wakeup sources, v3

Sun, 29 Apr 2012 20:53:42 +0000

PM / Sleep: Add user space interface for manipulating wakeup sources, v3Android allows user space to manipulate wakelocks using twosysfs file located in /sys/power/, wake_lock and wake_unlock.Writing a wakelock name and optionally a timeout to the wake_lockfile causes the wakelock whose name was written to be acquired (itis created before is necessary), optionally with the given timeout.Writing the name of a wakelock to wake_unlock causes that wakelockto be released.Implement an analogous interface for user space using wakeup sources.Add the /sys/power/wake_lock and /sys/power/wake_unlock filesallowing user space to create, activate and deactivate wakeupsources, such that writing a name and optionally a timeout towake_lock causes the wakeup source of that name to be activated,optionally with the given timeout. If that wakeup source doesn'texist, it will be created and then activated. Writing a name towake_unlock causes the wakeup source of that name, if there is one,to be deactivated. Wakeup sources created with the help ofwake_lock that haven't been used for more than 5 minutes are garbagecollected and destroyed. Moreover, there can be only WL_NUMBER_LIMITwakeup sources created with the help of wake_lock present at a time.The data type used to track wakeup sources created by user space iscalled "struct wakelock" to indicate the origins of this feature.This version of the patch includes an rbtree manipulation fix from John Stultz.Signed-off-by: Rafael J. Wysocki Acked-by: Greg Kroah-Hartman Reviewed-by: NeilBrown List of files: /linux-6.15/Documentation/ABI/testing/sysfs-power