add test + fix example in info manual1396888621

Signed-off-by: Mattias Andrée <maandree@operamail.com>

3 files changed, 101 insertions, 2 deletions

diff --git a/src/passphrase.h b/src/passphrase.h
index d6ecdce..932b6e5 100644
--- a/src/passphrase.h
+++ b/src/passphrase.h
@@ -16,8 +16,8 @@
  * You should have received a copy of the GNU General Public License
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
-#ifndef __PASSPHRASE_H__
-#define __PASSPHRASE_H__
+#ifndef PASSPHRASE_H
+#define PASSPHRASE_H
 
 
 /**
diff --git a/src/test.c b/src/test.c
new file mode 100644
index 0000000..1416be3
--- /dev/null
+++ b/src/test.c
@@ -0,0 +1,69 @@
+/**
+ * libpassphrase – Personalisable library for TTY passphrase reading
+ * 
+ * Copyright © 2013, 2014  Mattias Andrée (maandree@member.fsf.org)
+ * 
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ * 
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ * 
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+#include "test.h"
+
+
+/**
+ * Main test function
+ * 
+ * @param   argc  Number of elements in `argv`
+ * @param   argv  Command line arguments
+ * @return        Zero on success
+ */
+int main(int argc, char** argv)
+{
+  /* Variables for the passphrase */
+  char* passphrase;
+  char* passphrase_;
+  
+  /* Hide the passphrase */
+  passphrase_disable_echo();
+  
+  /* Do things needed before reading the passphrase */
+  printf("Passphrase: ");
+  fflush(stdout);
+  
+  /* Read the passphrase */
+  passphrase = passphrase_read();
+  if (passphrase == NULL)
+    {
+      /* Something went wrong, print what and exit */
+      perror(*argv);
+      return 1;
+    }
+  
+  /* Use the passphrase */
+  printf("You entered: %s\n", passphrase);
+  
+  /* Wipe and free the passphrase */
+  passphrase_ = passphrase;
+  while (*passphrase)
+    *passphrase++ = 0;
+  free(passphrase_);
+  
+  /* Stop hiding user input */
+  passphrase_reenable_echo();
+  
+  /* End of program */
+  return 0;
+  
+  /* `argc` was never used */
+  (void) argc;
+}
+
diff --git a/src/test.h b/src/test.h
new file mode 100644
index 0000000..12ddb4a
--- /dev/null
+++ b/src/test.h
@@ -0,0 +1,30 @@
+/**
+ * libpassphrase – Personalisable library for TTY passphrase reading
+ * 
+ * Copyright © 2013, 2014  Mattias Andrée (maandree@member.fsf.org)
+ * 
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ * 
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ * 
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+#ifndef TEST_H
+#define TEST_H
+
+
+#include <stdio.h>
+#include <stdlib.h>
+
+#include "passphrase.h"
+
+
+#endif
+