aboutsummaryrefslogtreecommitdiffstats
path: root/info
diff options
context:
space:
mode:
authorMattias Andrée <maandree@operamail.com>2015-12-05 11:13:46 +0100
committerMattias Andrée <maandree@operamail.com>2015-12-05 11:13:46 +0100
commit8fb6e77a618ce1a8151fab27445e0c3cc0241134 (patch)
tree73608a9d6880fa65c8046a09b3e6a055d9608ed4 /info
parentaccept flags (diff)
downloadlibpassphrase-8fb6e77a618ce1a8151fab27445e0c3cc0241134.tar.gz
libpassphrase-8fb6e77a618ce1a8151fab27445e0c3cc0241134.tar.bz2
libpassphrase-8fb6e77a618ce1a8151fab27445e0c3cc0241134.tar.xz
beginning of issue #2 on github
Signed-off-by: Mattias Andrée <maandree@operamail.com>
Diffstat (limited to 'info')
-rw-r--r--info/libpassphrase.texinfo32
1 files changed, 30 insertions, 2 deletions
diff --git a/info/libpassphrase.texinfo b/info/libpassphrase.texinfo
index d55d12d..32f19c3 100644
--- a/info/libpassphrase.texinfo
+++ b/info/libpassphrase.texinfo
@@ -194,6 +194,7 @@ and is equivalent to
@code{passphrase_reenable_echo1(STDIN_FILENO)}.
@item void passphrase_wipe(char*, size_t)
+@itemx void passphrase_wipe1(char*)
When you are done using passhprase you should
erase it from the memory before freeing its
allocation. To do this securtly, call
@@ -201,6 +202,9 @@ allocation. To do this securtly, call
as the first argument and the length of the
passphrase as the second argument.
+@code{passphrase_wipe1} will determine the
+length of the passphrase by itself.
+
@end table
These three functions could be made into one
@@ -218,7 +222,6 @@ been disabled.
#include <passphrase.h> /* For libpassphrase */
#include <stdio.h> /* For output */
#include <stdlib.h> /* For free */
-#include <string.h> /* For strlen */
#include <fcntl.h> /* For open, O_RDONLY */
#include <unistd.h> /* For close */
@@ -257,7 +260,7 @@ int main(int argc, char** argv)
printf("You entered: %s\n", passphrase);
/* Wipe and free the passphrase */
- passphrase_wipe(passphrase, strlen(passphrase));
+ passphrase_wipe1(passphrase);
free(passphrase);
/* Stop hiding user input */
@@ -389,6 +392,31 @@ This options is not really needed, but not
using it means that you can get warnings
in @command{valgrind}.
+@item @code{PASSPHRASE_METER}
+When the @code{PASSPHRASE_READ_METER} flag
+is used, and @code{PASSPHRASE_READ_SCREEN_FREE}
+or @code{PASSPHRASE_READ_BELOW_FREE}, use
+@command{passcheck} to evaluate the strenght
+of the passphrase and display a passphrase
+strenght meter. @command{passcheck} will be
+started by the real user, not the effective
+user, and the real group.
+
+It possibly to select another program than
+@command{passcheck} by specifying it setting
+the environment variable @env{LIBPASSPHRASE_METER}.
+@env{LIBPASSPHRASE_METER} will be treated as
+one argument. The selected program must behave
+similar to @command{passcheck}: for each line
+to stdin, it must print a non-negative int
+integer, optinally coloured with one signal
+escape sequence, followed by a new line or
+whitespace; the rest of the is ignored. The
+program must also accept the flag @code{-r},
+telling it not to discard any input.
+
+
+
@end table