Line data Source code
1 : /* Copyright (C) 1996-2018 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, see
16 : <http://www.gnu.org/licenses/>. */
17 :
18 : /* Declaration of types and functions for shadow password suite. */
19 :
20 : #ifndef _SHADOW_H
21 : #define _SHADOW_H 1
22 :
23 : #include <features.h>
24 :
25 : #include <paths.h>
26 :
27 : #define __need_size_t
28 : #include <stddef.h>
29 :
30 : #include <bits/types/FILE.h>
31 :
32 : /* Paths to the user database files. */
33 : #define SHADOW _PATH_SHADOW
34 :
35 :
36 : __BEGIN_DECLS
37 :
38 : /* Structure of the password file. */
39 : struct spwd
40 : {
41 : char *sp_namp; /* Login name. */
42 : char *sp_pwdp; /* Encrypted password. */
43 : long int sp_lstchg; /* Date of last change. */
44 : long int sp_min; /* Minimum number of days between changes. */
45 : long int sp_max; /* Maximum number of days between changes. */
46 : long int sp_warn; /* Number of days to warn user to change
47 : the password. */
48 : long int sp_inact; /* Number of days the account may be
49 : inactive. */
50 : long int sp_expire; /* Number of days since 1970-01-01 until
51 : account expires. */
52 : unsigned long int sp_flag; /* Reserved. */
53 : };
54 :
55 :
56 : /* Open database for reading.
57 :
58 : This function is not part of POSIX and therefore no official
59 : cancellation point. But due to similarity with an POSIX interface
60 : or due to the implementation it is a cancellation point and
61 : therefore not marked with __THROW. */
62 : extern void setspent (void);
63 :
64 : /* Close database.
65 :
66 : This function is not part of POSIX and therefore no official
67 : cancellation point. But due to similarity with an POSIX interface
68 : or due to the implementation it is a cancellation point and
69 : therefore not marked with __THROW. */
70 : extern void endspent (void);
71 :
72 : /* Get next entry from database, perhaps after opening the file.
73 :
74 : This function is not part of POSIX and therefore no official
75 : cancellation point. But due to similarity with an POSIX interface
76 : or due to the implementation it is a cancellation point and
77 : therefore not marked with __THROW. */
78 : extern struct spwd *getspent (void);
79 :
80 : /* Get shadow entry matching NAME.
81 :
82 : This function is not part of POSIX and therefore no official
83 : cancellation point. But due to similarity with an POSIX interface
84 : or due to the implementation it is a cancellation point and
85 : therefore not marked with __THROW. */
86 0 : extern struct spwd *getspnam (const char *__name);
87 :
88 : /* Read shadow entry from STRING.
89 :
90 0 : This function is not part of POSIX and therefore no official
91 : cancellation point. But due to similarity with an POSIX interface
92 : or due to the implementation it is a cancellation point and
93 : therefore not marked with __THROW. */
94 : extern struct spwd *sgetspent (const char *__string);
95 :
96 : /* Read next shadow entry from STREAM.
97 :
98 : This function is not part of POSIX and therefore no official
99 : cancellation point. But due to similarity with an POSIX interface
100 : or due to the implementation it is a cancellation point and
101 : therefore not marked with __THROW. */
102 : extern struct spwd *fgetspent (FILE *__stream);
103 :
104 : /* Write line containing shadow password entry to stream.
105 :
106 : This function is not part of POSIX and therefore no official
107 : cancellation point. But due to similarity with an POSIX interface
108 : or due to the implementation it is a cancellation point and
109 : therefore not marked with __THROW. */
110 : extern int putspent (const struct spwd *__p, FILE *__stream);
111 :
112 :
113 : #ifdef __USE_MISC
114 : /* Reentrant versions of some of the functions above.
115 :
116 : These functions are not part of POSIX and therefore no official
117 : cancellation point. But due to similarity with an POSIX interface
118 : or due to the implementation they are cancellation points and
119 : therefore not marked with __THROW. */
120 : extern int getspent_r (struct spwd *__result_buf, char *__buffer,
121 : size_t __buflen, struct spwd **__result);
122 :
123 : extern int getspnam_r (const char *__name, struct spwd *__result_buf,
124 : char *__buffer, size_t __buflen,
125 : struct spwd **__result);
126 :
127 : extern int sgetspent_r (const char *__string, struct spwd *__result_buf,
128 : char *__buffer, size_t __buflen,
129 : struct spwd **__result);
130 :
131 : extern int fgetspent_r (FILE *__stream, struct spwd *__result_buf,
132 : char *__buffer, size_t __buflen,
133 : struct spwd **__result);
134 : #endif /* misc */
135 :
136 :
137 : /* The simple locking functionality provided here is not suitable for
138 : multi-threaded applications. */
139 :
140 : /* Protect password file against multi writers. */
141 : extern int lckpwdf (void) __THROW;
142 :
143 : /* Unlock password file. */
144 : extern int ulckpwdf (void) __THROW;
145 :
146 : __END_DECLS
147 :
148 : #endif /* shadow.h */
|
