2 * Copyright (c) 1993-1996, 1998-2005, 2007-2008
3 * Todd C. Miller <Todd.Miller@courtesan.com>
5 * Permission to use, copy, modify, and distribute this software for any
6 * purpose with or without fee is hereby granted, provided that the above
7 * copyright notice and this permission notice appear in all copies.
9 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
10 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
11 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
12 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
13 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
14 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
15 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
17 * Sponsored in part by the Defense Advanced Research Projects
18 * Agency (DARPA) and Air Force Research Laboratory, Air Force
19 * Materiel Command, USAF, under agreement number F39502-99-1-0512.
21 * $Sudo: sudo.h,v 1.269 2008/11/25 17:01:34 millert Exp $
27 #include <pathnames.h>
37 * Info pertaining to the invoking user.
41 struct passwd *_runas_pw;
42 struct group *_runas_gr;
43 struct stat *cmnd_stat;
61 struct list_member *env_vars;
70 * Return values for sudoers_lookup(), also used as arguments for log_auth()
71 * Note: cannot use '0' as a value here.
73 /* XXX - VALIDATE_SUCCESS and VALIDATE_FAILURE instead? */
74 #define VALIDATE_ERROR 0x001
75 #define VALIDATE_OK 0x002
76 #define VALIDATE_NOT_OK 0x004
77 #define FLAG_CHECK_USER 0x010
78 #define FLAG_NO_USER 0x020
79 #define FLAG_NO_HOST 0x040
80 #define FLAG_NO_CHECK 0x080
83 * Pseudo-boolean values
91 * find_path()/load_cmnd() return values
95 #define NOT_FOUND_DOT -1
98 * Various modes sudo can be in (based on arguments) in hex
100 #define MODE_RUN 0x00000001
101 #define MODE_EDIT 0x00000002
102 #define MODE_VALIDATE 0x00000004
103 #define MODE_INVALIDATE 0x00000008
104 #define MODE_KILL 0x00000010
105 #define MODE_VERSION 0x00000020
106 #define MODE_HELP 0x00000040
107 #define MODE_LIST 0x00000080
108 #define MODE_CHECK 0x00000100
109 #define MODE_LISTDEFS 0x00000200
110 #define MODE_MASK 0x0000ffff
113 #define MODE_BACKGROUND 0x00010000
114 #define MODE_SHELL 0x00020000
115 #define MODE_LOGIN_SHELL 0x00040000
116 #define MODE_IMPLIED_SHELL 0x00080000
117 #define MODE_RESET_HOME 0x00100000
118 #define MODE_PRESERVE_GROUPS 0x00200000
119 #define MODE_PRESERVE_ENV 0x00400000
120 #define MODE_NONINTERACTIVE 0x00800000
123 * Used with set_perms()
125 #define PERM_ROOT 0x00
126 #define PERM_USER 0x01
127 #define PERM_FULL_USER 0x02
128 #define PERM_SUDOERS 0x03
129 #define PERM_RUNAS 0x04
130 #define PERM_FULL_RUNAS 0x05
131 #define PERM_TIMESTAMP 0x06
134 * Shortcuts for sudo_user contents.
136 #define user_name (sudo_user.pw->pw_name)
137 #define user_passwd (sudo_user.pw->pw_passwd)
138 #define user_uid (sudo_user.pw->pw_uid)
139 #define user_gid (sudo_user.pw->pw_gid)
140 #define user_dir (sudo_user.pw->pw_dir)
141 #define user_shell (sudo_user.shell)
142 #define user_ngroups (sudo_user.ngroups)
143 #define user_groups (sudo_user.groups)
144 #define user_tty (sudo_user.tty)
145 #define user_ttypath (sudo_user.ttypath)
146 #define user_cwd (sudo_user.cwd)
147 #define user_cmnd (sudo_user.cmnd)
148 #define user_args (sudo_user.cmnd_args)
149 #define user_base (sudo_user.cmnd_base)
150 #define user_stat (sudo_user.cmnd_stat)
151 #define user_path (sudo_user.path)
152 #define user_prompt (sudo_user.prompt)
153 #define user_host (sudo_user.host)
154 #define user_shost (sudo_user.shost)
155 #define user_ccname (sudo_user.krb5_ccname)
156 #define user_display (sudo_user.display)
157 #define user_askpass (sudo_user.askpass)
158 #define safe_cmnd (sudo_user.cmnd_safe)
159 #define login_class (sudo_user.class_name)
160 #define runas_pw (sudo_user._runas_pw)
161 #define runas_gr (sudo_user._runas_gr)
162 #define user_role (sudo_user.role)
163 #define user_type (sudo_user.type)
166 * We used to use the system definition of PASS_MAX or _PASSWD_LEN,
167 * but that caused problems with various alternate authentication
168 * methods. So, we just define our own and assume that it is >= the
171 #define SUDO_PASS_MAX 256
174 * Flags for lock_file()
176 #define SUDO_LOCK 1 /* lock a file */
177 #define SUDO_TLOCK 2 /* test & lock a file (non-blocking) */
178 #define SUDO_UNLOCK 4 /* unlock a file */
181 * Flags for tgetpass()
183 #define TGP_ECHO 0x01 /* leave echo on when reading passwd */
184 #define TGP_STDIN 0x02 /* read from stdin, not /dev/tty */
185 #define TGP_ASKPASS 0x04 /* read from askpass helper program */
193 * Function prototypes
195 #define YY_DECL int yylex __P((void))
197 #ifndef HAVE_CLOSEFROM
198 void closefrom __P((int));
201 char *getcwd __P((char *, size_t size));
204 int utimes __P((const char *, const struct timeval *));
207 int futimes __P((int, const struct timeval *));
209 #ifndef HAVE_SNPRINTF
210 int snprintf __P((char *, size_t, const char *, ...))
213 #ifndef HAVE_VSNPRINTF
214 int vsnprintf __P((char *, size_t, const char *, va_list))
217 #ifndef HAVE_ASPRINTF
218 int asprintf __P((char **, const char *, ...))
221 #ifndef HAVE_VASPRINTF
222 int vasprintf __P((char **, const char *, va_list))
225 #ifndef HAVE_STRCASECMP
226 int strcasecmp __P((const char *, const char *));
229 size_t strlcat __P((char *, const char *, size_t));
232 size_t strlcpy __P((char *, const char *, size_t));
235 void *memrchr __P((const void *, int, size_t));
238 int mkstemp __P((char *));
240 char *sudo_goodpath __P((const char *, struct stat *));
241 char *tgetpass __P((const char *, int, int));
242 int find_path __P((char *, char **, struct stat *, char *));
243 int tty_present __P((void));
244 void check_user __P((int, int));
245 void verify_user __P((struct passwd *, char *));
247 int sudo_ldap_open __P((struct sudo_nss *));
248 int sudo_ldap_close __P((struct sudo_nss *));
249 int sudo_ldap_setdefs __P((struct sudo_nss *));
250 int sudo_ldap_lookup __P((struct sudo_nss *, int, int));
251 int sudo_ldap_parse __P((struct sudo_nss *));
252 int sudo_ldap_display_cmnd __P((struct sudo_nss *, struct passwd *));
253 int sudo_ldap_display_defaults __P((struct sudo_nss *, struct passwd *, struct lbuf *));
254 int sudo_ldap_display_bound_defaults __P((struct sudo_nss *, struct passwd *, struct lbuf *));
255 int sudo_ldap_display_privs __P((struct sudo_nss *, struct passwd *, struct lbuf *));
257 int sudo_file_open __P((struct sudo_nss *));
258 int sudo_file_close __P((struct sudo_nss *));
259 int sudo_file_setdefs __P((struct sudo_nss *));
260 int sudo_file_lookup __P((struct sudo_nss *, int, int));
261 int sudo_file_parse __P((struct sudo_nss *));
262 int sudo_file_display_cmnd __P((struct sudo_nss *, struct passwd *));
263 int sudo_file_display_defaults __P((struct sudo_nss *, struct passwd *, struct lbuf *));
264 int sudo_file_display_bound_defaults __P((struct sudo_nss *, struct passwd *, struct lbuf *));
265 int sudo_file_display_privs __P((struct sudo_nss *, struct passwd *, struct lbuf *));
266 void set_perms __P((int));
267 void remove_timestamp __P((int));
268 int check_secureware __P((char *));
269 void sia_attempt_auth __P((void));
270 void pam_attempt_auth __P((void));
271 int yyparse __P((void));
272 void pass_warn __P((FILE *));
273 void *emalloc __P((size_t));
274 void *emalloc2 __P((size_t, size_t));
275 void *erealloc __P((void *, size_t));
276 void *erealloc3 __P((void *, size_t, size_t));
277 char *estrdup __P((const char *));
278 int easprintf __P((char **, const char *, ...))
280 int evasprintf __P((char **, const char *, va_list))
282 void efree __P((void *));
283 void dump_defaults __P((void));
284 void dump_auth_methods __P((void));
285 void init_envtables __P((void));
286 void read_env_file __P((const char *, int));
287 int lock_file __P((int, int));
288 int touch __P((int, char *, struct timespec *));
289 int user_is_exempt __P((void));
290 void set_fqdn __P((void));
291 char *sudo_getepw __P((const struct passwd *));
292 int pam_prep_user __P((struct passwd *));
293 void zero_bytes __P((volatile void *, size_t));
294 int gettime __P((struct timespec *));
295 FILE *open_sudoers __P((const char *, int *));
296 void display_privs __P((struct sudo_nss_list *, struct passwd *));
297 int display_cmnd __P((struct sudo_nss_list *, struct passwd *));
298 int get_ttycols __P((void));
299 char *sudo_parseln __P((FILE *));
300 void sudo_setenv __P((const char *, const char *, int));
301 void sudo_unsetenv __P((const char *));
302 void sudo_setgrent __P((void));
303 void sudo_endgrent __P((void));
304 void sudo_setpwent __P((void));
305 void sudo_endpwent __P((void));
306 void sudo_setspent __P((void));
307 void sudo_endspent __P((void));
308 void cleanup __P((int));
309 struct passwd *sudo_getpwnam __P((const char *));
310 struct passwd *sudo_fakepwnam __P((const char *, gid_t));
311 struct passwd *sudo_getpwuid __P((uid_t));
312 struct group *sudo_getgrnam __P((const char *));
313 struct group *sudo_fakegrnam __P((const char *));
314 struct group *sudo_getgrgid __P((gid_t));
316 void selinux_exec __P((char *, char *, char **, int));
318 #ifdef HAVE_GETUSERATTR
319 void aix_setlimits __P((char *));
323 /* Only provide extern declarations outside of sudo.c. */
325 extern struct sudo_user sudo_user;
326 extern struct passwd *auth_pw, *list_pw;
328 extern int tgetpass_flags;
329 extern int long_list;
330 extern uid_t timestamp_uid;
336 #endif /* _SUDO_SUDO_H */