1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
|
# s2idle debugging tool
`amd-s2idle` is a tool used for analyzing the entry and exit of the s2idle
state of a Linux system.
It is intended to use with Linux kernel 6.1 or later and works by hooking
into dynamic debugging messages and events that are generated by the kernel.
For analysis of power consumption issues it can be hooked into `systemd` to
run a command to capture data right before and after the system enters and
exits the s2idle state.
4 high level commands are supported.
## `amd-s2idle install`
This will install the systemd hook so that data will be captured before and
after the system enters and exits the s2idle state.
This will also install a bash completion script that can be used for other
commands.
**NOTE:** This command is only supported when run from a venv.
## `amd-s2idle uninstall`
This will uninstall the systemd hook and remove the bash completion script.
**NOTE:** This command is only supported when run from a venv.
## `amd-s2idle test`
This will run a suspend cycle with a timer based wakeup and capture relevant
data into a database and produce a report. This can also be used to run multiple cycles.
The following optional arguments are supported for this command:
--count COUNT Number of cycles to run
--duration DURATION Duration of the cycle in seconds
--wait WAIT Time to wait before starting the cycle in seconds
--format FORMAT Format of the report to produce (html, txt or md)
--report-file File to write the report to
--force Run a test cycle even if the system fails to pass prerequisite checks
--random Run sleep cycles for random durations and waits, using the --duration and --wait arguments as an upper bound
--logind Use logind to suspend the system
--tool-debug Enable debug logging
--bios-debug Enable BIOS debug logging instead of notify logging
If the tool is launched with an environment that can call `xdg-open`, the report
will be opened in a browser.
## `amd-s2idle report`
This will produce a report from the data captured by the `test` command
and/or from the systemd hook. The report will default to 60 days of data.
The following optional arguments are supported for this command:
--since SINCE Date to start the report from
--until UNTIL Date to end the report at
--format FORMAT Format of the report to produce (html, txt or md)
--report-file File to write the report to
--tool-debug Enable tool debug logging
--report-debug
--no-report-debug
Include debug messages in report (WARNING: can significantly increase report size)
If the tool is launched with an environment that can call `xdg-open`, the report
will be opened in a browser.
## `amd-s2idle --version`
This will print the version of the tool and exit.
## Debug output
All commands support the `--tool-debug` argument which will enable extra debug output. This is often needed for debugging issues with a particular cycle.
**NOTE:** enabling debug output significantly increases the size of the report.
It's suggested that you use `--since` and `--until` to focus on the cycles that you are interested in.
|
