hashboot/README.md

35 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-02-24 08:25:57 -05:00
If there is a core- or libreboot bios and flashrom installed, **hashboot** can check bios for modifications too.
2015-10-17 17:23:50 -04:00
# Install
2015-10-17 18:03:22 -04:00
* Make hashboot executable
* Place hashboot anywhere in $PATH
2015-10-17 17:23:50 -04:00
* 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)
2019-02-24 09:34:16 -05:00
* To generate the manpage, install asciidoc and run `build_manpage.sh`.
2015-10-17 17:23:50 -04:00
# Usage
2019-02-24 08:31:10 -05:00
* First run creates a configuration file. Use bitmask to select desired checkroutines
2015-10-17 18:03:22 -04:00
* 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.
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.
```