mirror of https://schlomp.space/tastytea/hashboot
67 lines
1.9 KiB
Markdown
67 lines
1.9 KiB
Markdown
**hashboot** hashes all files in `/boot` and the MBR to check them during early
|
|
boot. It is intended for when you have encrypted the root partition but not the
|
|
boot partition. The checksums and a backup of the contents of `/boot` are stored
|
|
in `/var/lib/hashboot` by default. If a checksum doesn't match, you have the
|
|
option to restore the file from backup.
|
|
|
|
If there is a core- or libreboot BIOS and [flashrom](https://flashrom.org/)
|
|
installed, **hashboot** can check the BIOS for modifications too.
|
|
|
|
# Install
|
|
|
|
## Packages
|
|
|
|
### Void Linux
|
|
|
|
``` shellsession
|
|
xbps-install -S hashboot
|
|
```
|
|
|
|
### Gentoo
|
|
|
|
Ebuilds are available via the
|
|
[tastytea repository](https://schlomp.space/tastytea/overlay).
|
|
|
|
``` shellsession
|
|
emerge -a sys-apps/hashboot
|
|
rc-update add hashboot boot
|
|
```
|
|
|
|
## Manual
|
|
|
|
### Arch Linux
|
|
|
|
Go to [the Arch installation instructions](arch_instructions.md).
|
|
|
|
### Any distro
|
|
|
|
* Make hashboot executable
|
|
* Place hashboot anywhere in ${PATH}
|
|
* Install the appropriate init script
|
|
* If applicable, copy kernel-hook to /etc/kernel/post{inst,rm}.d/zzz-hashboot
|
|
(make sure it is called after all other hooks)
|
|
* To generate the manpage, install [asciidoc](http://asciidoc.org/) and run
|
|
`build_manpage.sh`.
|
|
|
|
# Usage
|
|
|
|
* First run creates a configuration file. Select the desired checkroutines
|
|
* Run `hashboot index` to generate checksums and a backup for /boot and MBR
|
|
* Run `hashboot check` to check /boot and MBR
|
|
* Run `hashboot recover` to replace corrupted files with the backup
|
|
|
|
# Notes
|
|
|
|
* You can't use the openrc/sysv init scripts with parallel boot.
|
|
* The systemd and SysVinit init scripts have not been tested in a while, but
|
|
will probably work.
|
|
|
|
# License
|
|
|
|
```PLAIN
|
|
"THE HUG-WARE LICENSE" (Revision 2):
|
|
teldra <teldra@rotce.de> and tastytea <tastytea@tastytea.de> wrote this.
|
|
As long as you retain this notice you can do whatever you want with this.
|
|
If we meet some day, and you think this is nice, you can give us a hug.
|
|
```
|