diff options
author | Sean Whitton <spwhitton@spwhitton.name> | 2016-09-24 13:46:46 -0700 |
---|---|---|
committer | Sean Whitton <spwhitton@spwhitton.name> | 2022-04-10 13:45:03 -0700 |
commit | 1fe3389601d40ac732cb9e0a6f7737111a8dbe91 (patch) | |
tree | da1365951c329fb4403830f05c095d422ac1fa58 | |
parent | cf8879a1d08aaf80b0e245356b0e4048f5137043 (diff) | |
download | zxcvbn-c-1fe3389601d40ac732cb9e0a6f7737111a8dbe91.tar.gz |
patch README for Debian
Remove build instructions, and functions for when zxcvbn-c ws compiled
with USE_DICT_FILE (see README.source).
Forwarded: not-needed
Gbp-Pq: Name patch-README-for-Debian.patch
-rw-r--r-- | README.md | 29 |
1 files changed, 1 insertions, 28 deletions
@@ -11,42 +11,15 @@ The original CoffeeScript version is available at An article on the reasons for zxcvbn is at https://blogs.dropbox.com/tech/2012/04/zxcvbn-realistic-password-strength-estimation/ -## Building - -The makefile will build several test programs to test the code. It shows the steps needed -to use the code in C and C++ programs, using the dictionary data read from file or included -within the program executable. -The makefile has only been tried on Linux using GCC version 4.8.4, but should be fairly -portable to other systems. - -When dictionary data is included in your program's executable, the files `zxcvbn.c` , -`zxcvbn.h` , `dict-src.h` are used in your program. - -When dictionary data is read from file, the files `zxcvbn.c` , `zxcvbn.h` , `dict-crc.h` -and `zxcvbn.dict` are used in your program, compiled with `#define USE_DICT_FILE`. The CRC -of the dictionary data file is written to `dict-crc.h` so your executable can detect -corruption of the data. - -Rename `zxcvbn.c` to `zxcvbn.cpp` (or whatever your compiler uses) to compile as C++. - -The `dict*.h` and `zxcvbn.dict` files are generated by the dictgen program compiled from -dict-generate.cpp (see makefile for details). - ## Using -Initially call `ZxcvbnInit()` with the pathname of the `zxcvbn.dict` file. This can be -omitted when dictionary data is included in the executable. - Call `ZxcvbnMatch()` with the password and optional user dictionary to get the entropy estimation and optional information on the password parts (which will need freeing with `ZxcvbnFreeInfo()` after use). Do this for each password to be tested, or as each character of it is entered into your program. The optional user dictionary can change between each call. -Finally call `ZxcvbnUninit()` to free the dictionary data from read from file. This can be -omitted when dictionary data is included in the executable. - -Review the test program in `test.c` for an example. +Review the test program in `examples/test.c` for an example. ## Differences from the original version |