agesafetch 1.0.0

# agesafetch

[![License: MIT][License Badge]][LICENSE]
[![REUSE Status][REUSE Badge]][REUSE Status]

[License Badge]: https://img.shields.io/gitlab/license/BVollmerhaus%2Fagesafetch
[REUSE Status]: https://api.reuse.software/info/gitlab.com/BVollmerhaus/agesafetch
[REUSE Badge]: https://api.reuse.software/badge/gitlab.com/BVollmerhaus/agesafetch

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

[AGESA]: https://en.wikipedia.org/wiki/AGESA

## Installation

### Binaries

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

[GitLab releases]: https://gitlab.com/BVollmerhaus/agesafetch/-/releases

### From Source

```shell
cargo install agesafetch
```

## Usage

```shell
agesafetch [-h]
```

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

```shell
$ 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:

```shell
$ 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:

* ThinkPad P14s Gen 1 AMD (v1.51)
* ThinkPad P14s Gen 2 AMD (v1.26, v1.30)

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

On the other hand, please [open an issue] if no version was found on your
system even after a minute or two of searching.

[open an issue]: https://gitlab.com/BVollmerhaus/agesafetch/-/issues/new

## License

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

## Author

* [Benedikt Vollmerhaus](https://gitlab.com/BVollmerhaus)

[LICENSE]: https://gitlab.com/BVollmerhaus/agesafetch/blob/master/LICENSE