git.gag.com Git - debian/sudo/blob - sudo.h

   1 /*
   2  * Copyright (c) 1993-1996, 1998-2005, 2007-2009
   3  *      Todd C. Miller <Todd.Miller@courtesan.com>
   4  *
   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.
   8  *
   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.
  16  *
  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.
  20  *
  21  * $Sudo: sudo.h,v 1.273 2009/05/25 12:02:41 millert Exp $
  22  */
  23
  24 #ifndef _SUDO_SUDO_H
  25 #define _SUDO_SUDO_H
  26
  27 #include <pathnames.h>
  28 #include <limits.h>
  29 #include "compat.h"
  30 #include "defaults.h"
  31 #include "error.h"
  32 #include "list.h"
  33 #include "logging.h"
  34 #include "sudo_nss.h"
  35
  36 /*
  37  * Info pertaining to the invoking user.
  38  */
  39 struct sudo_user {
  40     struct passwd *pw;
  41     struct passwd *_runas_pw;
  42     struct group *_runas_gr;
  43     struct stat *cmnd_stat;
  44     char *path;
  45     char *shell;
  46     char *tty;
  47     char *ttypath;
  48     char *host;
  49     char *shost;
  50     int   host_fqdn_queried;
  51     char **runas;
  52     char *prompt;
  53     char *cmnd;
  54     char *cmnd_args;
  55     char *cmnd_base;
  56     char *cmnd_safe;
  57     char *class_name;
  58     char *krb5_ccname;
  59     char *display;
  60     char *askpass;
  61     int   ngroups;
  62     GETGROUPS_T *groups;
  63     struct list_member *env_vars;
  64 #ifdef HAVE_SELINUX
  65     char *role;
  66     char *type;
  67 #endif
  68     char  cwd[PATH_MAX];
  69 };
  70
  71 /*
  72  * Return values for sudoers_lookup(), also used as arguments for log_auth()
  73  * Note: cannot use '0' as a value here.
  74  */
  75 /* XXX - VALIDATE_SUCCESS and VALIDATE_FAILURE instead? */
  76 #define VALIDATE_ERROR          0x001
  77 #define VALIDATE_OK             0x002
  78 #define VALIDATE_NOT_OK         0x004
  79 #define FLAG_CHECK_USER         0x010
  80 #define FLAG_NO_USER            0x020
  81 #define FLAG_NO_HOST            0x040
  82 #define FLAG_NO_CHECK           0x080
  83
  84 /*
  85  * Pseudo-boolean values
  86  */
  87 #undef TRUE
  88 #define TRUE                     1
  89 #undef FALSE
  90 #define FALSE                    0
  91
  92 /*
  93  * find_path()/load_cmnd() return values
  94  */
  95 #define FOUND                    1
  96 #define NOT_FOUND                0
  97 #define NOT_FOUND_DOT           -1
  98
  99 /*
 100  * Various modes sudo can be in (based on arguments) in hex
 101  */
 102 #define MODE_RUN                0x00000001
 103 #define MODE_EDIT               0x00000002
 104 #define MODE_VALIDATE           0x00000004
 105 #define MODE_INVALIDATE         0x00000008
 106 #define MODE_KILL               0x00000010
 107 #define MODE_VERSION            0x00000020
 108 #define MODE_HELP               0x00000040
 109 #define MODE_LIST               0x00000080
 110 #define MODE_CHECK              0x00000100
 111 #define MODE_LISTDEFS           0x00000200
 112 #define MODE_MASK               0x0000ffff
 113
 114 /* Mode flags */
 115 #define MODE_BACKGROUND         0x00010000
 116 #define MODE_SHELL              0x00020000
 117 #define MODE_LOGIN_SHELL        0x00040000
 118 #define MODE_IMPLIED_SHELL      0x00080000
 119 #define MODE_RESET_HOME         0x00100000
 120 #define MODE_PRESERVE_GROUPS    0x00200000
 121 #define MODE_PRESERVE_ENV       0x00400000
 122 #define MODE_NONINTERACTIVE     0x00800000
 123
 124 /*
 125  * Used with set_perms()
 126  */
 127 #define PERM_ROOT                0x00
 128 #define PERM_USER                0x01
 129 #define PERM_FULL_USER           0x02
 130 #define PERM_SUDOERS             0x03
 131 #define PERM_RUNAS               0x04
 132 #define PERM_FULL_RUNAS          0x05
 133 #define PERM_TIMESTAMP           0x06
 134 #define PERM_NOEXIT              0x10 /* flag */
 135 #define PERM_MASK                0xf0
 136
 137 /*
 138  * Shortcuts for sudo_user contents.
 139  */
 140 #define user_name               (sudo_user.pw->pw_name)
 141 #define user_passwd             (sudo_user.pw->pw_passwd)
 142 #define user_uid                (sudo_user.pw->pw_uid)
 143 #define user_gid                (sudo_user.pw->pw_gid)
 144 #define user_dir                (sudo_user.pw->pw_dir)
 145 #define user_shell              (sudo_user.shell)
 146 #define user_ngroups            (sudo_user.ngroups)
 147 #define user_groups             (sudo_user.groups)
 148 #define user_tty                (sudo_user.tty)
 149 #define user_ttypath            (sudo_user.ttypath)
 150 #define user_cwd                (sudo_user.cwd)
 151 #define user_cmnd               (sudo_user.cmnd)
 152 #define user_args               (sudo_user.cmnd_args)
 153 #define user_base               (sudo_user.cmnd_base)
 154 #define user_stat               (sudo_user.cmnd_stat)
 155 #define user_path               (sudo_user.path)
 156 #define user_prompt             (sudo_user.prompt)
 157 #define user_host               (sudo_user.host)
 158 #define user_shost              (sudo_user.shost)
 159 #define user_ccname             (sudo_user.krb5_ccname)
 160 #define user_display            (sudo_user.display)
 161 #define user_askpass            (sudo_user.askpass)
 162 #define safe_cmnd               (sudo_user.cmnd_safe)
 163 #define login_class             (sudo_user.class_name)
 164 #define runas_pw                (sudo_user._runas_pw)
 165 #define runas_gr                (sudo_user._runas_gr)
 166 #define user_role               (sudo_user.role)
 167 #define user_type               (sudo_user.type)
 168
 169 /*
 170  * We used to use the system definition of PASS_MAX or _PASSWD_LEN,
 171  * but that caused problems with various alternate authentication
 172  * methods.  So, we just define our own and assume that it is >= the
 173  * system max.
 174  */
 175 #define SUDO_PASS_MAX   256
 176
 177 /*
 178  * Flags for lock_file()
 179  */
 180 #define SUDO_LOCK       1               /* lock a file */
 181 #define SUDO_TLOCK      2               /* test & lock a file (non-blocking) */
 182 #define SUDO_UNLOCK     4               /* unlock a file */
 183
 184 /*
 185  * Flags for tgetpass()
 186  */
 187 #define TGP_ECHO        0x01            /* leave echo on when reading passwd */
 188 #define TGP_STDIN       0x02            /* read from stdin, not /dev/tty */
 189 #define TGP_ASKPASS     0x04            /* read from askpass helper program */
 190
 191 struct lbuf;
 192 struct passwd;
 193 struct timespec;
 194 struct timeval;
 195
 196 /*
 197  * Function prototypes
 198  */
 199 #define YY_DECL int yylex __P((void))
 200
 201 #ifndef HAVE_CLOSEFROM
 202 void closefrom          __P((int));
 203 #endif
 204 #ifndef HAVE_GETCWD
 205 char *getcwd            __P((char *, size_t size));
 206 #endif
 207 #ifndef HAVE_UTIMES
 208 int utimes              __P((const char *, const struct timeval *));
 209 #endif
 210 #ifdef HAVE_FUTIME
 211 int futimes             __P((int, const struct timeval *));
 212 #endif
 213 #ifndef HAVE_SNPRINTF
 214 int snprintf            __P((char *, size_t, const char *, ...))
 215                             __printflike(3, 4);
 216 #endif
 217 #ifndef HAVE_VSNPRINTF
 218 int vsnprintf           __P((char *, size_t, const char *, va_list))
 219                             __printflike(3, 0);
 220 #endif
 221 #ifndef HAVE_ASPRINTF
 222 int asprintf            __P((char **, const char *, ...))
 223                             __printflike(2, 3);
 224 #endif
 225 #ifndef HAVE_VASPRINTF
 226 int vasprintf           __P((char **, const char *, va_list))
 227                             __printflike(2, 0);
 228 #endif
 229 #ifndef HAVE_STRCASECMP
 230 int strcasecmp          __P((const char *, const char *));
 231 #endif
 232 #ifndef HAVE_STRLCAT
 233 size_t strlcat          __P((char *, const char *, size_t));
 234 #endif
 235 #ifndef HAVE_STRLCPY
 236 size_t strlcpy          __P((char *, const char *, size_t));
 237 #endif
 238 #ifndef HAVE_MEMRCHR
 239 void *memrchr           __P((const void *, int, size_t));
 240 #endif
 241 #ifndef HAVE_MKSTEMP
 242 int mkstemp             __P((char *));
 243 #endif
 244 #ifndef HAVE_SETENV
 245 int setenv              __P((const char *, const char *, int));
 246 #endif
 247 #ifndef HAVE_UNSETENV
 248 int unsetenv            __P((const char *));
 249 #endif
 250 char *sudo_goodpath     __P((const char *, struct stat *));
 251 char *tgetpass          __P((const char *, int, int));
 252 int find_path           __P((char *, char **, struct stat *, char *));
 253 int tty_present         __P((void));
 254 void check_user         __P((int, int));
 255 void verify_user        __P((struct passwd *, char *));
 256 #ifdef HAVE_LDAP
 257 int sudo_ldap_open      __P((struct sudo_nss *));
 258 int sudo_ldap_close     __P((struct sudo_nss *));
 259 int sudo_ldap_setdefs   __P((struct sudo_nss *));
 260 int sudo_ldap_lookup    __P((struct sudo_nss *, int, int));
 261 int sudo_ldap_parse     __P((struct sudo_nss *));
 262 int sudo_ldap_display_cmnd __P((struct sudo_nss *, struct passwd *));
 263 int sudo_ldap_display_defaults __P((struct sudo_nss *, struct passwd *, struct lbuf *));
 264 int sudo_ldap_display_bound_defaults __P((struct sudo_nss *, struct passwd *, struct lbuf *));
 265 int sudo_ldap_display_privs __P((struct sudo_nss *, struct passwd *, struct lbuf *));
 266 #endif
 267 int sudo_file_open      __P((struct sudo_nss *));
 268 int sudo_file_close     __P((struct sudo_nss *));
 269 int sudo_file_setdefs   __P((struct sudo_nss *));
 270 int sudo_file_lookup    __P((struct sudo_nss *, int, int));
 271 int sudo_file_parse     __P((struct sudo_nss *));
 272 int sudo_file_display_cmnd __P((struct sudo_nss *, struct passwd *));
 273 int sudo_file_display_defaults __P((struct sudo_nss *, struct passwd *, struct lbuf *));
 274 int sudo_file_display_bound_defaults __P((struct sudo_nss *, struct passwd *, struct lbuf *));
 275 int sudo_file_display_privs __P((struct sudo_nss *, struct passwd *, struct lbuf *));
 276 int set_perms           __P((int));
 277 void remove_timestamp   __P((int));
 278 int check_secureware    __P((char *));
 279 void sia_attempt_auth   __P((void));
 280 void pam_attempt_auth   __P((void));
 281 int yyparse             __P((void));
 282 void pass_warn          __P((FILE *));
 283 void *emalloc           __P((size_t));
 284 void *emalloc2          __P((size_t, size_t));
 285 void *erealloc          __P((void *, size_t));
 286 void *erealloc3         __P((void *, size_t, size_t));
 287 char *estrdup           __P((const char *));
 288 int easprintf           __P((char **, const char *, ...))
 289                             __printflike(2, 3);
 290 int evasprintf          __P((char **, const char *, va_list))
 291                             __printflike(2, 0);
 292 void efree              __P((void *));
 293 void dump_defaults      __P((void));
 294 void dump_auth_methods  __P((void));
 295 void init_envtables     __P((void));
 296 void read_env_file      __P((const char *, int));
 297 int lock_file           __P((int, int));
 298 int touch               __P((int, char *, struct timespec *));
 299 int user_is_exempt      __P((void));
 300 void set_fqdn           __P((void));
 301 char *sudo_getepw       __P((const struct passwd *));
 302 int pam_prep_user       __P((struct passwd *));
 303 void zero_bytes         __P((volatile void *, size_t));
 304 int gettime             __P((struct timespec *));
 305 FILE *open_sudoers      __P((const char *, int, int *));
 306 void display_privs      __P((struct sudo_nss_list *, struct passwd *));
 307 int display_cmnd        __P((struct sudo_nss_list *, struct passwd *));
 308 int get_ttycols         __P((void));
 309 char *sudo_parseln      __P((FILE *));
 310 void sudo_setgrent      __P((void));
 311 void sudo_endgrent      __P((void));
 312 void sudo_setpwent      __P((void));
 313 void sudo_endpwent      __P((void));
 314 void sudo_setspent      __P((void));
 315 void sudo_endspent      __P((void));
 316 void cleanup            __P((int));
 317 struct passwd *sudo_getpwnam __P((const char *));
 318 struct passwd *sudo_fakepwnam __P((const char *, gid_t));
 319 struct passwd *sudo_getpwuid __P((uid_t));
 320 struct group *sudo_getgrnam __P((const char *));
 321 struct group *sudo_fakegrnam __P((const char *));
 322 struct group *sudo_getgrgid __P((gid_t));
 323 #ifdef HAVE_SELINUX
 324 void selinux_exec __P((char *, char *, char **, int));
 325 #endif
 326 #ifdef HAVE_GETUSERATTR
 327 void aix_setlimits __P((char *));
 328 #endif
 329 YY_DECL;
 330
 331 /* Only provide extern declarations outside of sudo.c. */
 332 #ifndef _SUDO_MAIN
 333 extern struct sudo_user sudo_user;
 334 extern struct passwd *auth_pw, *list_pw;
 335
 336 extern int tgetpass_flags;
 337 extern int long_list;
 338 extern uid_t timestamp_uid;
 339 #endif
 340 #ifndef errno
 341 extern int errno;
 342 #endif
 343
 344 #endif /* _SUDO_SUDO_H */