src/auth.h

   1 /* auth.h -- generic header file for authentification routines
   2  *           for vlock, the VT locking program for linux
   3  *
   4  * This program is copyright (C) 2007 Frank Benkstein, and is free
   5  * software which is freely distributable under the terms of the
   6  * GNU General Public License version 2, included as the file COPYING in this
   7  * distribution.  It is NOT public domain software, and any
   8  * redistribution not permitted by the GNU General Public License is
   9  * expressly forbidden without prior written permission from
  10  * the author.
  11  *
  12  */
  13
  14 #include <stdbool.h>
  15
  16 /* forward declaration */
  17 struct timespec;
  18
  19 /* Try to authenticate the user.  When the user is successfully authenticated
  20  * this function returns true.  When the authentication fails for whatever
  21  * reason the function returns false.  The timeout is passed to the prompt
  22  * functions below if they are called.
  23  */
  24 bool auth(const char *user, struct timespec *timeout);