hashboot/README.md

39 lines
1.4 KiB
Markdown
Raw Normal View History

2019-02-24 07:06:10 -05:00
**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.
2015-10-17 17:45:49 -04:00
2019-03-29 18:08:03 -04:00
If there is a core- or libreboot BIOS and [flashrom](https://flashrom.org/)
installed, **hashboot** can check the BIOS for modifications too.
2019-02-24 08:25:57 -05:00
2015-10-17 17:23:50 -04:00
# Install
2015-10-17 18:03:22 -04:00
* Make hashboot executable
2019-03-29 18:08:03 -04:00
* Place hashboot anywhere in ${PATH}
2015-10-17 17:23:50 -04:00
* Install the appropriate init script
2019-03-29 18:08:03 -04:00
* 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`.
2015-10-17 17:23:50 -04:00
# Usage
2019-03-29 18:08:03 -04:00
* 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
2015-10-17 17:23:50 -04:00
# Notes
2015-10-17 17:57:38 -04:00
* You can't use the openrc/sysv init scripts with parallel boot.
# License
```PLAIN
2019-02-24 09:30:04 -05:00
"THE HUG-WARE LICENSE" (Revision 2):
teldra <teldra@rotce.de> and tastytea <tastytea@tastytea.de> wrote this.
2019-03-29 18:08:03 -04:00
As long as you retain this notice you can do whatever you want with this.
2019-02-24 09:30:04 -05:00
If we meet some day, and you think this is nice, you can give us a hug.
```