amd-debug-tools 0.2.7__py3-none-any.whl → 0.2.9__py3-none-any.whl

amd_debug_tools-0.2.7.dist-info/METADATA

@@ -1,184 +0,0 @@
-Metadata-Version: 2.4
-Name: amd-debug-tools
-Version: 0.2.7
-Summary: debug tools for AMD systems
-Author-email: Mario Limonciello <superm1@kernel.org>
-License-Expression: MIT
-Project-URL: Homepage, https://web.git.kernel.org/pub/scm/linux/kernel/git/superm1/amd-debug-tools.git/
-Classifier: Programming Language :: Python :: 3
-Classifier: Operating System :: POSIX :: Linux
-Requires-Python: >=3.7
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: pyudev
-Requires-Dist: packaging
-Requires-Dist: pandas
-Requires-Dist: jinja2
-Requires-Dist: tabulate
-Requires-Dist: seaborn
-Requires-Dist: cysystemd
-Requires-Dist: Jinja2
-Requires-Dist: matplotlib
-Requires-Dist: seaborn
-Dynamic: license-file
-
-# Helpful tools for debugging AMD Zen systems
-[![codecov](https://codecov.io/github/superm1/amd-debug-tools/graph/badge.svg?token=Z9WTBZADGT)](https://codecov.io/github/superm1/amd-debug-tools)
-[![PyPI](https://img.shields.io/pypi/v/amd-debug-tools.svg)](https://pypi.org/project/amd-debug-tools/)
-
-This repository hosts open tools that are useful for debugging issues on AMD systems.
-
-## Installation
-It is suggested to install tools in a virtual environment either using
-`pipx` or `python3 -m venv`.
-
-### From PyPI
-`amd-debug-tools` is distributed as a python wheel, which is a
-binary package format for Python. To install from PyPI, run the following
-command:
-
-    pipx install amd-debug-tools
-
-### From source
-To build the package from source, you will need to the `python3-build`
-package natively installed by your distribution package manager. Then you
-can generate and install a wheel by running the following commands:
-
-    python3 -m build
-    pipx install dist/amd-debug-tools-*.whl
-
-### Ensuring path
-If you have not used a `pipx` environment before, you may need to run the following command
-to set up the environment:
-
-    pipx ensurepath
-
-This will add the `pipx` environment to your path.
-
-### Running in tree
-If you want to run the tools in tree, you need to make sure that distro dependencies
-that would normally install into a venv are installed. This can be done by running:
-
-    ./install_deps.py
-
-After dependencies are installed, you can run the tools by running:
-
-    ./amd_s2idle.py
-    ./amd_bios.py
-    ./amd_pstate.py
-
-## amd-s2idle
-`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.
-
-## amd-bios
-`amd-bios` is a a tool that can be used to enable or disable BIOS AML debug logging
--and to parse a kernel log that contains BIOS logs.
-
-### `amd-bios trace`
-Modify BIOS AML trace debug logging.
-
-One of the following arguments must be set for this command:
-
-        --enable       Enable BIOS AML tracing
-        --disable      Disable BIOS AML tracing
-
-The following optional arguments are supported for this command:
-
-        --tool-debug   Enable tool debug logging
-
-### `amd-bios parse`
-Parses a kernel log that contains BIOS AML debug logging and produces a report.
-
-The following optional arguments are supported for this command:
-
-        --input INPUT  Optional input file to parse
-        --tool-debug   Enable tool debug logging
-
-### `amd-bios --version`
-This will print the version of the tool and exit.
-
-## amd-pstate
-`amd-pstate` is a tool used for identification of issues with amd-pstate.
-It will capture some state from the system as well as from the machine specific registers that
-amd-pstate uses.
-
-## amd-ttm
-`amd-ttm` is a tool used for managing the TTM memory settings on AMD systems.
-
-## Compatibility scripts
-
-Compatibility scripts are provided for the previous names the tools went by:
-`amd_s2idle.py`, `amd_bios.py` and `amd_pstate.py`.
-These allow cloning the repository and running the scripts without installing
-the package.
-

amd_debug_tools-0.2.7.dist-info/RECORD

@@ -1,47 +0,0 @@
-launcher.py,sha256=M8kT9DtyZoQgZaKWDbSBu4jsS6tZF1gWko3sovNVyag,947
-test_acpi.py,sha256=wtS43Rz95h7YEEJBeFa6Mswaeo4syBZrw4hY8i0YbJY,3117
-test_batteries.py,sha256=nN5pfP5El7Whypq3HHEpW8bufdf5EWSTVGbayfNQYP4,3360
-test_bios.py,sha256=x_KLmQqGEbQhTugyWCHGXjGp2H1dCdhRz0kgw2Big8w,9276
-test_common.py,sha256=EYbyObC9vIXquT3EbgQ_98V4Zw2ebUCY9cfS9VOoywE,19722
-test_database.py,sha256=q5ZjI5u20f7ki6iCY5o1iPi0YOvPz1_W0LTDraU8mN4,10040
-test_display.py,sha256=hHggv-zBthF1BlwWWSjzAm7BBw1DWcElwil5xAuz87g,5822
-test_failures.py,sha256=H1UxXeVjhJs9-j9yas4vwAha676GX1Es7Kz8RN2B590,6845
-test_installer.py,sha256=oDMCvaKqqAWjTggltacnasQ-s1gyUvXPDcNrCUGnux4,10216
-test_kernel.py,sha256=2EXrLht5ZWdT4N5pb_F3zqZl9NEghjnDpcMGCMw3obI,7917
-test_launcher.py,sha256=8g8CBTvLX64Us4RmHtRPSdpV5E2kQFaudBl7VIsxLhE,1733
-test_prerequisites.py,sha256=-q6v80QXDMB_Mdek2KZTmKfKcRVZnHf8SBEhcT0RyIY,88498
-test_pstate.py,sha256=a9oAJ9-LANX32XNQhplz6Y75VNYc__QqoSBKIrwvANg,6058
-test_s2idle.py,sha256=FxsyujgX9Px3m56VzHNeA8yMTHmJiRLWxYt-fh1m5gw,33585
-test_sleep_report.py,sha256=ANuxYi_C1oSKAi4xUU2wBu4SwJtcZA7VPpazBe3_WUQ,6922
-test_ttm.py,sha256=QrCdRodQ_CD3nyDqKodb6yR158mgE0iIM5f1fV1Axu8,10515
-test_validator.py,sha256=RpjyzxDpExhLcSJfQ0UDuonr4sTFAfa7sTtY5g7tc_Q,36410
-test_wake.py,sha256=6zi5GVFHQKU1sTWw3O5-aGriB9uu5713QLn4l2wjhpM,7152
-amd_debug/__init__.py,sha256=66Ya61av8RCws6bEY_vdujGmjBIZ6_UqfuWHgMNNOJY,1271
-amd_debug/acpi.py,sha256=fkD3Sov8cRT5ryPlakRlT7Z9jiCLT9x_MPWxt3xU_tc,3161
-amd_debug/battery.py,sha256=WN-6ys9PHCZIwg7PdwyBOa62GjBp8WKG0v1YZt5_W5s,3122
-amd_debug/bios.py,sha256=y1iwDqX-mXCkoUtHSi-XO9pN-oLfaqbAMzANGI12zHs,4041
-amd_debug/common.py,sha256=fHrmSEVerVAE7KXjspf60eOAetUO7K9s1yhNyE2xi94,11598
-amd_debug/database.py,sha256=GkRg3cmaNceyQ2_hy0MBAlMbnTDPHo2co2o4ObWpnQg,10621
-amd_debug/display.py,sha256=5L9x9tI_UoulHpIvuxuVASRtdXta7UCW_JjTb5StEB0,953
-amd_debug/failures.py,sha256=z4O4Q-akv3xYGssSZFCqE0cDE4P9F_aw1hxil3McoD4,22910
-amd_debug/installer.py,sha256=6_Y0oHypW-oh_P8N9JW7fzbqidpsi5jphw9_8s5Qvso,14288
-amd_debug/kernel.py,sha256=HpX-QRh8tgkvqKnExfo2JrYqfcbMY8GNgDrC2VVV0Oc,11638
-amd_debug/prerequisites.py,sha256=zK-IXL52p_jomA1SsS-6btIHuaapNKW4sD-Fy0wBr68,51399
-amd_debug/pstate.py,sha256=AOKCvUb0ngwHU2C59uSKrFwdLzEyn8r1w2DgWhZAMKM,9583
-amd_debug/s2idle-hook,sha256=LLiaqPtGd0qetu9n6EYxKHZaIdHpVQDONdOuSc0pfFg,1695
-amd_debug/s2idle.py,sha256=4cxHNfmvq11BE-AtkEthIqR-xrWmxW2LTa6oVDtGztY,13284
-amd_debug/sleep_report.py,sha256=hhqu711AKtjeYF2xmGcejyCyyPtmq4-gC_hROUCrC0g,17317
-amd_debug/ttm.py,sha256=huXDqdcNrn0JIn-UGNTS7pXTBL5YB3gmi_OP9rfXskA,4664
-amd_debug/validator.py,sha256=X-cNFVvHWKzFgT4aR0Td3I2kwQRBOK4vQUk6L276VCQ,34153
-amd_debug/wake.py,sha256=xT8WrFrN6voCmXWo5dsn4mQ7iR2QJxHrrYBd3EREG-Q,3936
-amd_debug/bash/amd-s2idle,sha256=g_cle1ElCJpwE4wcLezL6y-BdasDKTnNMhrtzKLE9ks,1142
-amd_debug/templates/html,sha256=JfGhpmHIB2C2GItdGI1kuC8uayqEVgrpQvAWAj35eZ4,14580
-amd_debug/templates/md,sha256=r8X2aehnH2gzj0WHYTZ5K9wAqC5y39i_3nkDORSC0uM,787
-amd_debug/templates/stdout,sha256=hyoOJ96K2dJfnWRWhyCuariLKbEHXvs9mstV_g5aMdI,469
-amd_debug/templates/txt,sha256=nNdsvbPFOhGdL7VA-_4k5aN3nB-6ouGQt6AsWst7T3w,649
-amd_debug_tools-0.2.7.dist-info/licenses/LICENSE,sha256=RBlZI6r3MRGzymI2VDX2iW__D2APDbMhu_Xg5t6BWeo,1066
-amd_debug_tools-0.2.7.dist-info/METADATA,sha256=02ahxaxXDJf3w6V3xoGItmpby-iDiyJskFc_rhhYNQw,6971
-amd_debug_tools-0.2.7.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-amd_debug_tools-0.2.7.dist-info/entry_points.txt,sha256=hIskDz6k0_6q1qpqWCpVFsca_djxAqkLrUAwzAyEGuE,144
-amd_debug_tools-0.2.7.dist-info/top_level.txt,sha256=VvGkkY5I7O3HoLNrc2VfgjCA-to3PUjnnKd7juONaFw,243
-amd_debug_tools-0.2.7.dist-info/RECORD,,