summaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
authorGravatar Christian Hesse <mail@eworm.de>2014-03-26 23:50:27 +0100
committerGravatar Christian Hesse <mail@eworm.de>2014-03-26 23:50:27 +0100
commit03e54da070d7ac657452e20eda59d85a48efcf63 (patch)
tree77ced9c83499c9d42368fce1d17cdd0a8975dc77 /README.md
parentf1468a34e7be13749ee3e7e2e09517b0a0d302ac (diff)
downloadmkinitcpio-ykfde-03e54da070d7ac657452e20eda59d85a48efcf63.tar.gz
mkinitcpio-ykfde-03e54da070d7ac657452e20eda59d85a48efcf63.tar.zst
add some basic documentation
Diffstat (limited to 'README.md')
-rw-r--r--README.md47
1 files changed, 46 insertions, 1 deletions
diff --git a/README.md b/README.md
index d8f595f..d688afc 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,49 @@
mkinitcpio-ykfde
================
-Full disk encryption with Yubikey (Yubico key)
+**Full disk encryption with Yubikey (Yubico key)**
+
+This allows to automatically unlock a LUKS encrypted hard disk from `systemd`-
+enabled initramdfs.
+
+Requirements
+------------
+
+To compile and use yubico full disk encryption you need:
+
+* [iniparser](http://ndevilla.free.fr/iniparser/)
+* [systemd](http://www.freedesktop.org/wiki/Software/systemd/)
+* [mkinitcpio](https://projects.archlinux.org/mkinitcpio.git/) (Though
+ it may be easy to port this to any initramfs that uses systemd)
+* [markdown](http://daringfireball.net/projects/markdown/) (HTML documentation)
+
+Additionally it is expected to have `make` and `pkg-config` around to
+successfully compile.
+
+Build and install
+-----------------
+
+Building and installing is very easy. Just run:
+
+> make
+
+followed by:
+
+> make install
+
+This will place file to their desired places in filesystem.
+
+Usage
+-----
+
+First prepare the key. Plug it in, make sure it is configured for HMAC-
+SHA1, then run:
+
+> ykfde -d /dev/`LUKS-device`
+
+This will add a new slot to your LUKS device. Add `ykfde` to your hook
+list in `/etc/mkinitcpio.conf` and rebuild your initramfs with:
+
+> mkinitcpio -p linux
+
+Reboot and have fun!