xref: /freebsd/usr.sbin/pw/pwupd.h (revision da7d7b9c861cf98e912c0bd1e549752d2dae4fb6)
1 /*-
2  * Copyright (C) 1996
3  *	David L. Nugent.  All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
8  * 1. Redistributions of source code must retain the above copyright
9  *    notice, this list of conditions and the following disclaimer.
10  * 2. Redistributions in binary form must reproduce the above copyright
11  *    notice, this list of conditions and the following disclaimer in the
12  *    documentation and/or other materials provided with the distribution.
13  *
14  * THIS SOFTWARE IS PROVIDED BY DAVID L. NUGENT AND CONTRIBUTORS ``AS IS'' AND
15  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17  * ARE DISCLAIMED.  IN NO EVENT SHALL DAVID L. NUGENT OR CONTRIBUTORS BE LIABLE
18  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
24  * SUCH DAMAGE.
25  *
26  * $FreeBSD$
27  */
28 
29 #ifndef _PWUPD_H_
30 #define _PWUPD_H_
31 
32 #include <sys/cdefs.h>
33 #include <sys/param.h>
34 #include <sys/types.h>
35 
36 #include <pwd.h>
37 #include <grp.h>
38 #include <stdbool.h>
39 
40 #if defined(__FreeBSD__)
41 #define	RET_SETGRENT	int
42 #else
43 #define	RET_SETGRENT	void
44 #endif
45 
46 struct pwf {
47 	int		    _altdir;
48 	void		  (*_setpwent)(void);
49 	void		  (*_endpwent)(void);
50 	struct passwd * (*_getpwent)(void);
51 	struct passwd	* (*_getpwuid)(uid_t uid);
52 	struct passwd	* (*_getpwnam)(const char * nam);
53 	RET_SETGRENT	  (*_setgrent)(void);
54 	void		  (*_endgrent)(void);
55 	struct group  * (*_getgrent)(void);
56 	struct group  * (*_getgrgid)(gid_t gid);
57 	struct group  * (*_getgrnam)(const char * nam);
58 };
59 
60 struct userconf {
61 	int	default_password;	/* Default password for new users? */
62 	int	reuse_uids;		/* Reuse uids? */
63 	int	reuse_gids;		/* Reuse gids? */
64 	char	*nispasswd;		/* Path to NIS version of the passwd file */
65 	char	*dotdir;		/* Where to obtain skeleton files */
66 	char	*newmail;		/* Mail to send to new accounts */
67 	char	*logfile;		/* Where to log changes */
68 	char	*home;			/* Where to create home directory */
69 	mode_t	homemode;		/* Home directory permissions */
70 	char	*shelldir;		/* Where shells are located */
71 	char	**shells;		/* List of shells */
72 	char	*shell_default;		/* Default shell */
73 	char	*default_group;		/* Default group number */
74 	char	**groups;		/* Default (additional) groups */
75 	char	*default_class;		/* Default user class */
76 	uid_t	min_uid, max_uid;	/* Allowed range of uids */
77 	gid_t	min_gid, max_gid;	/* Allowed range of gids */
78 	int	expire_days;		/* Days to expiry */
79 	int	password_days;		/* Days to password expiry */
80 	int	numgroups;		/* (internal) size of default_group array */
81 };
82 
83 struct pwconf {
84 	char		 rootdir[MAXPATHLEN];
85 	char		 etcpath[MAXPATHLEN];
86 	char		*newname;
87 	char		*config;
88 	int		 fd;
89 	bool		 dryrun;
90 	bool		 pretty;
91 	bool		 v7;
92 	bool		 checkduplicate;
93 	bool		 precrypted;
94 	struct userconf	*userconf;
95 };
96 
97 extern struct pwf PWF;
98 extern struct pwf VPWF;
99 extern struct pwconf conf;
100 
101 #define SETPWENT()	PWF._setpwent()
102 #define ENDPWENT()	PWF._endpwent()
103 #define GETPWENT()	PWF._getpwent()
104 #define GETPWUID(uid)	PWF._getpwuid(uid)
105 #define GETPWNAM(nam)	PWF._getpwnam(nam)
106 
107 #define SETGRENT()	PWF._setgrent()
108 #define ENDGRENT()	PWF._endgrent()
109 #define GETGRENT()	PWF._getgrent()
110 #define GETGRGID(gid)	PWF._getgrgid(gid)
111 #define GETGRNAM(nam)	PWF._getgrnam(nam)
112 
113 #define PWF_REGULAR 0
114 #define PWF_ALT 1
115 #define PWF_ROOTDIR 2
116 
117 #define PWALTDIR()	PWF._altdir
118 #ifndef _PATH_PWD
119 #define _PATH_PWD	"/etc"
120 #endif
121 #ifndef _GROUP
122 #define _GROUP		"group"
123 #endif
124 #ifndef _MASTERPASSWD
125 #define _MASTERPASSWD	"master.passwd"
126 #endif
127 
128 __BEGIN_DECLS
129 int addpwent(struct passwd * pwd);
130 int delpwent(struct passwd * pwd);
131 int chgpwent(char const * login, struct passwd * pwd);
132 
133 char * getpwpath(char const * file);
134 
135 int addgrent(struct group * grp);
136 int delgrent(struct group * grp);
137 int chggrent(char const * name, struct group * grp);
138 
139 char * getgrpath(const char *file);
140 
141 void vsetpwent(void);
142 void vendpwent(void);
143 struct passwd * vgetpwent(void);
144 struct passwd * vgetpwuid(uid_t uid);
145 struct passwd * vgetpwnam(const char * nam);
146 
147 struct group * vgetgrent(void);
148 struct group * vgetgrgid(gid_t gid);
149 struct group * vgetgrnam(const char * nam);
150 RET_SETGRENT   vsetgrent(void);
151 void           vendgrent(void);
152 
153 void copymkdir(char const * dir, char const * skel, mode_t mode, uid_t uid, gid_t gid);
154 void rm_r(char const * dir, uid_t uid);
155 int extendarray(char ***buf, int *buflen, int needed);
156 __END_DECLS
157 
158 #endif				/* !_PWUPD_H */
159