Gitiles
Code Review Sign In
192.168.1.100 / T106_DC / a24b314a599ea370df1b15bf132cfd288d0e80ff / . / ap / build / uClibc / include / shadow.h
blob: baad177016372d94808f3aff12592375bb4a5ab0 [file] [log] [blame]
lh9ed821d2023-04-07 01:36:19 -0700[diff] [blame]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. */
40struct 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. */
63extern 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. */
71extern 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. */
79extern 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. */
87extern 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. */
95extern 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. */
103extern 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. */
111extern 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. */
121extern int getspent_r (struct spwd *__result_buf, char *__buffer,
122 size_t __buflen, struct spwd **__result);
123libc_hidden_proto(getspent_r)
124
125extern int getspnam_r (__const char *__name, struct spwd *__result_buf,
126 char *__buffer, size_t __buflen,
127 struct spwd **__result);
128libc_hidden_proto(getspnam_r)
129
130extern int sgetspent_r (__const char *__string, struct spwd *__result_buf,
131 char *__buffer, size_t __buflen,
132 struct spwd **__result);
133libc_hidden_proto(sgetspent_r)
134
135extern int fgetspent_r (FILE *__stream, struct spwd *__result_buf,
136 char *__buffer, size_t __buflen,
137 struct spwd **__result);
138libc_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. */
146extern int lckpwdf (void) __THROW;
147
148/* Unlock password file. */
149extern int ulckpwdf (void) __THROW;
150
151__END_DECLS
152
153#endif /* shadow.h */