Skip to main content

A tool for obtaining your firmware's embedded AGESA version on Linux.

Project description

agesafetch

crates.io Version crates.io Downloads AUR Version License: MIT REUSE Status

A tool for obtaining your firmware's embedded AGESA version on Linux.

Installation

Binaries

Pre-compiled and signed binaries are provided with all GitLab releases.

From Source

cargo install agesafetch

Note

By default, Cargo installs binaries in ~/.cargo/bin, so that directory must be in $PATH for agesafetch to be found. However, not all methods of privilege escalation preserve the $PATH variable, e.g. sudo with a secure_path value.

When in doubt, refer to the complete path: sudo ~/.cargo/bin/agesafetch

From PyPI

agesafetch is available as a pre-built wheel from PyPI:

sudo pipx install --global agesafetch

Python Bindings

On top of the agesafetch command, the Python package also provides basic bindings to the AGESA search that you can invoke from your own code (which then also requires elevated privileges or capabilities):

import agesafetch

version: agesafetch.AGESAVersion | None = agesafetch.find_agesa_version()

Usage

agesafetch [-h]
🔒 The AGESA search requires elevated privileges or suitable capabilities.

Simply run agesafetch to invoke a search for the AGESA version in memory:

$ sudo agesafetch
:: Searching Reserved region #1 (1667 KiB)...
-> Found AGESA version: CezannePI-FP6 1.0.1.1

When run non-interactively, such as in pipes or redirections, agesafetch will automatically suppress all output except for the found version:

$ sudo agesafetch > found_version
$ cat found_version
CezannePI-FP6 1.0.1.1

Known Working Systems

So far, we have successfully tested agesafetch on the following platforms:

  • ASUS ROG STRIX X670E-E GAMING WIFI
  • Gigabyte
    • B450 AORUS PRO (F66d)
    • B550 AORUS ELITE V2 (F17)
    • B650 AORUS PRO AX (F32)
    • X570 GAMING X (F39)
  • Lenovo
    • ThinkPad P14s Gen 1 AMD (v1.51)
    • ThinkPad P14s Gen 2 AMD (v1.30)

🚀 If you would like to add to this list, get in touch!

Please feel free to open an issue if no version is found on your system even after a minute or two of searching.

License

This project is licensed under the MIT license. See the LICENSE file for more information.

Author

Thanks To

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

agesafetch-1.2.0-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (479.9 kB view details)

Uploaded CPython 3.9manylinux: glibc 2.17+ x86-64

File details

Details for the file agesafetch-1.2.0-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for agesafetch-1.2.0-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 22e70e1a530244ba4f91769fa93ad12eeadf81863bbbcd1e7a7001fcb885c87e
MD5 361d945296265ba4ae9bb0e7511184ad
BLAKE2b-256 e76a80700b6d5034b13c0972b1a03214d91e4909fe04d02ec4ffd7c44b79f1fc

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page