1 | /* Copyright (C) 1996-2017 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_FILE |
28 | #include <stdio.h> |
29 | #define __need_size_t |
30 | #include <stddef.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 | extern struct spwd *getspnam (const char *__name); |
87 | |
88 | /* Read shadow entry from STRING. |
89 | |
90 | 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 */ |
149 | |