Add example of dictionary search.
[platform/upstream/cryptsetup.git] / misc / dict_search / README
1 Simple example how to use libcryptsetup
2 for password search.
3
4 Run: luks_dict <device|image> <dictionary> [cpus]
5
6 <device|image> is LUKS device or image
7 <dictionary> is list of passphrases to try
8 (note trailing EOL is stripped)
9
10 cpus - number of processes to start in parallel
11
12 Format of dictionary file is simple one password per line,
13 if first char on line s # it is skiped as comment.
14
15 You have it run as root (device-mapper cannot
16 create dmcrypt devices as nrmal user. Code need
17 to map keyslots as temporary dmcrypt device.)