uClibc/include/shadow.h

   1 /* Copyright (C) 1996, 1997, 1998, 1999, 2003 Free Software Foundation, Inc.
   2    This file is part of the GNU C Library.
   3
   4    The GNU C Library is free software; you can redistribute it and/or
   5    modify it under the terms of the GNU Lesser General Public
   6    License as published by the Free Software Foundation; either
   7    version 2.1 of the License, or (at your option) any later version.
   8
   9    The GNU C Library is distributed in the hope that it will be useful,
  10    but WITHOUT ANY WARRANTY; without even the implied warranty of
  11    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  12    Lesser General Public License for more details.
  13
  14    You should have received a copy of the GNU Lesser General Public
  15    License along with the GNU C Library; if not, write to the Free
  16    Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
  17    02111-1307 USA.  */
  18
  19 /* Declaration of types and functions for shadow password suite.  */
  20
  21 #ifndef _SHADOW_H
  22 #define _SHADOW_H       1
  23
  24 #include <features.h>
  25
  26 #include <paths.h>
  27
  28 #define __need_FILE
  29 #include <stdio.h>
  30 #define __need_size_t
  31 #include <stddef.h>
  32
  33 /* Paths to the user database files.  */
  34 #define SHADOW _PATH_SHADOW
  35
  36
  37 __BEGIN_DECLS
  38
  39 /* Structure of the password file.  */
  40 struct spwd
  41   {
  42     char *sp_namp;              /* Login name.  */
  43     char *sp_pwdp;              /* Encrypted password.  */
  44     long int sp_lstchg;         /* Date of last change.  */
  45     long int sp_min;            /* Minimum number of days between changes.  */
  46     long int sp_max;            /* Maximum number of days between changes.  */
  47     long int sp_warn;           /* Number of days to warn user to change
  48                                    the password.  */
  49     long int sp_inact;          /* Number of days the account may be
  50                                    inactive.  */
  51     long int sp_expire;         /* Number of days since 1970-01-01 until
  52                                    account expires.  */
  53     unsigned long int sp_flag;  /* Reserved.  */
  54   };
  55
  56
  57 /* Open database for reading.
  58
  59    This function is not part of POSIX and therefore no official
  60    cancellation point.  But due to similarity with an POSIX interface
  61    or due to the implementation it is a cancellation point and
  62    therefore not marked with __THROW.  */
  63 extern void setspent (void);
  64
  65 /* Close database.
  66
  67    This function is not part of POSIX and therefore no official
  68    cancellation point.  But due to similarity with an POSIX interface
  69    or due to the implementation it is a cancellation point and
  70    therefore not marked with __THROW.  */
  71 extern void endspent (void);
  72
  73 /* Get next entry from database, perhaps after opening the file.
  74
  75    This function is not part of POSIX and therefore no official
  76    cancellation point.  But due to similarity with an POSIX interface
  77    or due to the implementation it is a cancellation point and
  78    therefore not marked with __THROW.  */
  79 extern struct spwd *getspent (void);
  80
  81 /* Get shadow entry matching NAME.
  82
  83    This function is not part of POSIX and therefore no official
  84    cancellation point.  But due to similarity with an POSIX interface
  85    or due to the implementation it is a cancellation point and
  86    therefore not marked with __THROW.  */
  87 extern struct spwd *getspnam (__const char *__name);
  88
  89 /* Read shadow entry from STRING.
  90
  91    This function is not part of POSIX and therefore no official
  92    cancellation point.  But due to similarity with an POSIX interface
  93    or due to the implementation it is a cancellation point and
  94    therefore not marked with __THROW.  */
  95 extern struct spwd *sgetspent (__const char *__string);
  96
  97 /* Read next shadow entry from STREAM.
  98
  99    This function is not part of POSIX and therefore no official
 100    cancellation point.  But due to similarity with an POSIX interface
 101    or due to the implementation it is a cancellation point and
 102    therefore not marked with __THROW.  */
 103 extern struct spwd *fgetspent (FILE *__stream);
 104
 105 /* Write line containing shadow password entry to stream.
 106
 107    This function is not part of POSIX and therefore no official
 108    cancellation point.  But due to similarity with an POSIX interface
 109    or due to the implementation it is a cancellation point and
 110    therefore not marked with __THROW.  */
 111 extern int putspent (__const struct spwd *__p, FILE *__stream);
 112
 113
 114 #ifdef __USE_MISC
 115 /* Reentrant versions of some of the functions above.
 116
 117    These functions are not part of POSIX and therefore no official
 118    cancellation point.  But due to similarity with an POSIX interface
 119    or due to the implementation they are cancellation points and
 120    therefore not marked with __THROW.  */
 121 extern int getspent_r (struct spwd *__result_buf, char *__buffer,
 122                        size_t __buflen, struct spwd **__result);
 123 libc_hidden_proto(getspent_r)
 124
 125 extern int getspnam_r (__const char *__name, struct spwd *__result_buf,
 126                        char *__buffer, size_t __buflen,
 127                        struct spwd **__result);
 128 libc_hidden_proto(getspnam_r)
 129
 130 extern int sgetspent_r (__const char *__string, struct spwd *__result_buf,
 131                         char *__buffer, size_t __buflen,
 132                         struct spwd **__result);
 133 libc_hidden_proto(sgetspent_r)
 134
 135 extern int fgetspent_r (FILE *__stream, struct spwd *__result_buf,
 136                         char *__buffer, size_t __buflen,
 137                         struct spwd **__result);
 138 libc_hidden_proto(fgetspent_r)
 139 #endif  /* misc */
 140
 141
 142 /* The simple locking functionality provided here is not suitable for
 143    multi-threaded applications.  */
 144
 145 /* Protect password file against multi writers.  */
 146 extern int lckpwdf (void) __THROW;
 147
 148 /* Unlock password file.  */
 149 extern int ulckpwdf (void) __THROW;
 150
 151 __END_DECLS
 152
 153 #endif /* shadow.h */