https://github.com/linuxboot/fiano
Go-based tools for modifying UEFI firmware
https://github.com/linuxboot/fiano
firmware go hacktoberfest uefi uefi-utils
Last synced: 9 days ago
JSON representation
Go-based tools for modifying UEFI firmware
- Host: GitHub
- URL: https://github.com/linuxboot/fiano
- Owner: linuxboot
- License: bsd-3-clause
- Created: 2018-02-23T17:50:49.000Z (about 7 years ago)
- Default Branch: main
- Last Pushed: 2025-01-21T19:19:17.000Z (3 months ago)
- Last Synced: 2025-03-31T21:46:19.782Z (16 days ago)
- Topics: firmware, go, hacktoberfest, uefi, uefi-utils
- Language: Go
- Homepage:
- Size: 7.09 MB
- Stars: 318
- Watchers: 29
- Forks: 53
- Open Issues: 59
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- awesome-uefi-security - fiano
README
# fiano
Go-based tools for modifying UEFI firmware.
[](https://circleci.com/gh/linuxboot/fiano)
[](https://goreportcard.com/report/github.com/linuxboot/fiano)
[](https://godoc.org/github.com/linuxboot/fiano)
[](https://codecov.io/gh/linuxboot/fiano/)
[](https://github.com/linuxboot/fiano/blob/master/LICENSE)
# Contributing
For information about contributing, including how we sign off commits, please see
CONTRIBUTING.md
## UTK: Generic UEFI tool kit meant to handle rom images
Example usage:
```
# For a comprehensive list of commands
utk -h
# Display the image in a compact table form:
utk winterfell.rom table
# Summarize everything in JSON:
utk winterfell.rom json
# List information about a single file in JSON (using regex):
utk winterfell.rom find Shell
# Dump an EFI file to an ffs
utk winterfell.rom dump DxeCore dxecore.ffs
# Insert an EFI file into an FV near another Dxe
utk winterfell.rom insert_before Shell dxecore.ffs save inserted.rom
utk winterfell.rom insert_after Shell dxecore.ffs save inserted.rom
# Insert an EFI file into an FV at the front or the end
# "Shell" is just a means of specifying the FV that contains Shell
utk winterfell.rom insert_front Shell dxecore.ffs save inserted.rom
utk winterfell.rom insert_end Shell dxecore.ffs save inserted.rom
# Remove a file and pad the firmware volume to maintain offsets for the following files
utk winterfell.rom remove_pad Shell save removed.rom
# Remove two files by their GUID without padding and replace shell with Linux:
utk winterfell.rom \
remove 12345678-9abc-def0-1234-567890abcdef \
remove 23830293-3029-3823-0922-328328330939 \
replace_pe32 Shell linux.efi \
save winterfell2.rom
# Extract everything into a directory:
utk winterfell.rom extract winterfell/
# Re-assemble the directory into an image:
utk winterfell/ save winterfell2.rom
```
### DXE Cleaner
Delete unnecessary DXEs from your firmware. Free up space, speed up boot times
and decrease the attack surface area! See the demo:
[](https://asciinema.org/a/233950)
## FMAP: Parses flash maps.
Example usage:
+ `fmap checksum [md5|sha1|sha256] FILE`
+ `fmap extract i FILE`
+ `fmap jget JSONFILE FILE`
+ `fmap jput JSONFILE FILE`
+ `fmap summary FILE`
+ `fmap usage FILE`
+ `fmap verify FILE`
## Installation
# Golang version 1.13 is required:
go version
# For UTK:
go install github.com/linuxboot/fiano/cmds/utk@latest
# For fmap:
go install github.com/linuxboot/fiano/cmds/fmap@latest
The executables are installed in `$HOME/go/bin`.
## Updating Dependencies
# Fiano utilizes Go modules.
Use the following to download the dependencies:
```
go mod download
go mod verify
```
If you desire to update a existing dependency to a newer version:
```
go get path/to/dependency/module@tag
```
Execute this in any directory of fiano repository