include/shadow_.h

   1 /* vi: set sw=4 ts=4: */
   2 /* Copyright (C) 1996, 1997, 1998, 1999 Free Software Foundation, Inc.
   3    This file is part of the GNU C Library.
   4
   5    The GNU C Library is free software; you can redistribute it and/or
   6    modify it under the terms of the GNU Lesser General Public
   7    License as published by the Free Software Foundation; either
   8    version 2.1 of the License, or (at your option) any later version.
   9
  10    The GNU C Library is distributed in the hope that it will be useful,
  11    but WITHOUT ANY WARRANTY; without even the implied warranty of
  12    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  13    Lesser General Public License for more details.
  14
  15    You should have received a copy of the GNU Lesser General Public
  16    License along with the GNU C Library; if not, write to the Free
  17    Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
  18    02111-1307 USA.  */
  19
  20 /* Declaration of types and functions for shadow password suite */
  21
  22 #ifndef BB_SHADOW_H
  23 #define BB_SHADOW_H 1
  24
  25 #if __GNUC_PREREQ(4,1)
  26 # pragma GCC visibility push(hidden)
  27 #endif
  28
  29 /* This file is #included after #include <shadow.h>
  30  * We will use libc-defined structures, but will #define function names
  31  * so that function calls are directed to bb_internal_XXX replacements
  32  */
  33
  34 /* Paths to the user database files */
  35 #ifndef _PATH_SHADOW
  36 #define _PATH_SHADOW "/etc/shadow"
  37 #endif
  38
  39 #define setspent    bb_internal_setspent
  40 #define endspent    bb_internal_endspent
  41 #define getspent    bb_internal_getspent
  42 #define getspnam    bb_internal_getspnam
  43 #define sgetspent   bb_internal_sgetspent
  44 #define fgetspent   bb_internal_fgetspent
  45 #define putspent    bb_internal_putspent
  46 #define getspent_r  bb_internal_getspent_r
  47 #define getspnam_r  bb_internal_getspnam_r
  48 #define sgetspent_r bb_internal_sgetspent_r
  49 #define fgetspent_r bb_internal_fgetspent_r
  50 #define lckpwdf     bb_internal_lckpwdf
  51 #define ulckpwdf    bb_internal_ulckpwdf
  52
  53
  54 /* All function names below should be remapped by #defines above
  55  * in order to not collide with libc names. */
  56
  57
  58 /* Open database for reading */
  59 extern void setspent(void);
  60
  61 /* Close database */
  62 extern void endspent(void);
  63
  64 /* Get next entry from database, perhaps after opening the file */
  65 extern struct spwd *getspent(void);
  66
  67 /* Get shadow entry matching NAME */
  68 extern struct spwd *getspnam(const char *__name);
  69
  70 /* Read shadow entry from STRING */
  71 extern struct spwd *sgetspent(const char *__string);
  72
  73 /* Read next shadow entry from STREAM */
  74 extern struct spwd *fgetspent(FILE *__stream);
  75
  76 /* Write line containing shadow password entry to stream */
  77 extern int putspent(const struct spwd *__p, FILE *__stream);
  78
  79 /* Reentrant versions of some of the functions above */
  80 extern int getspent_r(struct spwd *__result_buf, char *__buffer,
  81                        size_t __buflen, struct spwd **__result);
  82
  83 extern int getspnam_r(const char *__name, struct spwd *__result_buf,
  84                        char *__buffer, size_t __buflen,
  85                        struct spwd **__result);
  86
  87 extern int sgetspent_r(const char *__string, struct spwd *__result_buf,
  88                         char *__buffer, size_t __buflen,
  89                         struct spwd **__result);
  90
  91 extern int fgetspent_r(FILE *__stream, struct spwd *__result_buf,
  92                         char *__buffer, size_t __buflen,
  93                         struct spwd **__result);
  94 /* Protect password file against multi writers */
  95 extern int lckpwdf(void);
  96
  97 /* Unlock password file */
  98 extern int ulckpwdf(void);
  99
 100 #if __GNUC_PREREQ(4,1)
 101 # pragma GCC visibility pop
 102 #endif
 103
 104 #endif /* shadow.h */