source3/include/passdb.h

   1 /*
   2    Unix SMB/CIFS implementation.
   3    passdb structures and parameters
   4    Copyright (C) Gerald Carter 2001
   5    Copyright (C) Luke Kenneth Casson Leighton 1998 - 2000
   6    Copyright (C) Andrew Bartlett 2002
   7    Copyright (C) Simo Sorce 2003
   8
   9    This program is free software; you can redistribute it and/or modify
  10    it under the terms of the GNU General Public License as published by
  11    the Free Software Foundation; either version 2 of the License, or
  12    (at your option) any later version.
  13
  14    This program is distributed in the hope that it will be useful,
  15    but WITHOUT ANY WARRANTY; without even the implied warranty of
  16    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  17    GNU General Public License for more details.
  18
  19    You should have received a copy of the GNU General Public License
  20    along with this program; if not, write to the Free Software
  21    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  22 */
  23
  24 #ifndef _PASSDB_H
  25 #define _PASSDB_H
  26
  27
  28 /*
  29  * bit flags representing initialized fields in SAM_ACCOUNT
  30  */
  31 enum pdb_elements {
  32         PDB_UNINIT,
  33         PDB_SMBHOME,
  34         PDB_PROFILE,
  35         PDB_DRIVE,
  36         PDB_LOGONSCRIPT,
  37         PDB_LOGONTIME,
  38         PDB_LOGOFFTIME,
  39         PDB_KICKOFFTIME,
  40         PDB_CANCHANGETIME,
  41         PDB_MUSTCHANGETIME,
  42         PDB_PLAINTEXT_PW,
  43         PDB_USERNAME,
  44         PDB_FULLNAME,
  45         PDB_DOMAIN,
  46         PDB_NTUSERNAME,
  47         PDB_HOURSLEN,
  48         PDB_LOGONDIVS,
  49         PDB_USERSID,
  50         PDB_GROUPSID,
  51         PDB_ACCTCTRL,
  52         PDB_PASSLASTSET,
  53         PDB_UNIXHOMEDIR,
  54         PDB_ACCTDESC,
  55         PDB_WORKSTATIONS,
  56         PDB_UNKNOWNSTR,
  57         PDB_MUNGEDDIAL,
  58         PDB_HOURS,
  59         PDB_UNKNOWN3,
  60         PDB_BAD_PASSWORD_COUNT,
  61         PDB_LOGON_COUNT,
  62         PDB_UNKNOWN6,
  63         PDB_LMPASSWD,
  64         PDB_NTPASSWD,
  65         PDB_BACKEND_PRIVATE_DATA,
  66
  67         /* this must be the last element */
  68         PDB_COUNT
  69 };
  70
  71 enum pdb_group_elements {
  72         PDB_GROUP_NAME,
  73         PDB_GROUP_SID,
  74         PDB_GROUP_SID_NAME_USE,
  75         PDB_GROUP_MEMBERS,
  76
  77         /* this must be the last element */
  78         PDB_GROUP_COUNT
  79 };
  80
  81
  82 enum pdb_value_state {
  83         PDB_DEFAULT=0,
  84         PDB_SET,
  85         PDB_CHANGED
  86 };
  87
  88 #define IS_SAM_SET(x, flag)     (pdb_get_init_flags(x, flag) == PDB_SET)
  89 #define IS_SAM_CHANGED(x, flag) (pdb_get_init_flags(x, flag) == PDB_CHANGED)
  90 #define IS_SAM_DEFAULT(x, flag) (pdb_get_init_flags(x, flag) == PDB_DEFAULT)
  91
  92 typedef struct sam_passwd
  93 {
  94         TALLOC_CTX *mem_ctx;
  95
  96         void (*free_fn)(struct sam_passwd **);
  97
  98         struct pdb_methods *methods;
  99
 100         struct user_data {
 101                 /* initialization flags */
 102                 struct bitmap *change_flags;
 103                 struct bitmap *set_flags;
 104
 105                 time_t logon_time;            /* logon time */
 106                 time_t logoff_time;           /* logoff time */
 107                 time_t kickoff_time;          /* kickoff time */
 108                 time_t pass_last_set_time;    /* password last set time */
 109                 time_t pass_can_change_time;  /* password can change time */
 110                 time_t pass_must_change_time; /* password must change time */
 111
 112                 const char * username;     /* UNIX username string */
 113                 const char * domain;       /* Windows Domain name */
 114                 const char * nt_username;  /* Windows username string */
 115                 const char * full_name;    /* user's full name string */
 116                 const char * unix_home_dir;     /* UNIX home directory string */
 117                 const char * home_dir;     /* home directory string */
 118                 const char * dir_drive;    /* home directory drive string */
 119                 const char * logon_script; /* logon script string */
 120                 const char * profile_path; /* profile path string */
 121                 const char * acct_desc  ;  /* user description string */
 122                 const char * workstations; /* login from workstations string */
 123                 const char * unknown_str ; /* don't know what this is, yet. */
 124                 const char * munged_dial ; /* munged path name and dial-back tel number */
 125
 126                 DOM_SID user_sid;    /* Primary User SID */
 127                 DOM_SID group_sid;   /* Primary Group SID */
 128
 129                 DATA_BLOB lm_pw; /* .data is Null if no password */
 130                 DATA_BLOB nt_pw; /* .data is Null if no password */
 131                 char* plaintext_pw; /* is Null if not available */
 132
 133                 uint16 acct_ctrl; /* account info (ACB_xxxx bit-mask) */
 134                 uint32 unknown_3; /* 0x00ff ffff */
 135
 136                 uint16 logon_divs; /* 168 - number of hours in a week */
 137                 uint32 hours_len; /* normally 21 bytes */
 138                 uint8 hours[MAX_HOURS_LEN];
 139
 140                 /* Was unknown_5. */
 141                 uint16 bad_password_count;
 142                 uint16 logon_count;
 143
 144                 uint32 unknown_6; /* 0x0000 04ec */
 145                 /* a tag for who added the private methods */
 146                 const struct pdb_methods *backend_private_methods;
 147                 void *backend_private_data;
 148                 void (*backend_private_data_free_fn)(void **);
 149         } private;
 150
 151         /* Lets see if the remaining code can get the hint that you
 152            are meant to use the pdb_...() functions. */
 153
 154 } SAM_ACCOUNT;
 155
 156 typedef struct sam_group {
 157         TALLOC_CTX *mem_ctx;
 158
 159         void (*free_fn)(struct sam_group **);
 160
 161         struct pdb_methods *methods;
 162
 163         struct group_data {
 164                 /* initialization flags */
 165                 struct bitmap *change_flags;
 166                 struct bitmap *set_flags;
 167
 168                 const char *name;               /* Windows group name string */
 169
 170                 DOM_SID sid;                    /* Group SID */
 171                 enum SID_NAME_USE sid_name_use; /* Group type */
 172
 173                 uint32 mem_num;                 /* Number of member SIDs */
 174                 DOM_SID *members;               /* SID array */
 175         } private;
 176
 177 } SAM_GROUP;
 178
 179
 180 /*****************************************************************
 181  Functions to be implemented by the new (v2) passdb API
 182 ****************************************************************/
 183
 184 /*
 185  * This next constant specifies the version number of the PASSDB interface
 186  * this SAMBA will load. Increment this if *ANY* changes are made to the interface.
 187  */
 188
 189 #define PASSDB_INTERFACE_VERSION 4
 190
 191 typedef struct pdb_context
 192 {
 193         struct pdb_methods *pdb_methods;
 194         struct pdb_methods *pwent_methods;
 195
 196         /* These functions are wrappers for the functions listed above.
 197            They may do extra things like re-reading a SAM_ACCOUNT on update */
 198
 199         NTSTATUS (*pdb_setsampwent)(struct pdb_context *, BOOL update);
 200
 201         void (*pdb_endsampwent)(struct pdb_context *);
 202
 203         NTSTATUS (*pdb_getsampwent)(struct pdb_context *, SAM_ACCOUNT *user);
 204
 205         NTSTATUS (*pdb_getsampwnam)(struct pdb_context *, SAM_ACCOUNT *sam_acct, const char *username);
 206
 207         NTSTATUS (*pdb_getsampwsid)(struct pdb_context *, SAM_ACCOUNT *sam_acct, const DOM_SID *sid);
 208
 209         NTSTATUS (*pdb_add_sam_account)(struct pdb_context *, SAM_ACCOUNT *sampass);
 210
 211         NTSTATUS (*pdb_update_sam_account)(struct pdb_context *, SAM_ACCOUNT *sampass);
 212
 213         NTSTATUS (*pdb_delete_sam_account)(struct pdb_context *, SAM_ACCOUNT *username);
 214
 215         NTSTATUS (*pdb_getgrsid)(struct pdb_context *context, GROUP_MAP *map, DOM_SID sid);
 216
 217         NTSTATUS (*pdb_getgrgid)(struct pdb_context *context, GROUP_MAP *map, gid_t gid);
 218
 219         NTSTATUS (*pdb_getgrnam)(struct pdb_context *context, GROUP_MAP *map, const char *name);
 220
 221         NTSTATUS (*pdb_add_group_mapping_entry)(struct pdb_context *context,
 222                                                 GROUP_MAP *map);
 223
 224         NTSTATUS (*pdb_update_group_mapping_entry)(struct pdb_context *context,
 225                                                    GROUP_MAP *map);
 226
 227         NTSTATUS (*pdb_delete_group_mapping_entry)(struct pdb_context *context,
 228                                                    DOM_SID sid);
 229
 230         NTSTATUS (*pdb_enum_group_mapping)(struct pdb_context *context,
 231                                            enum SID_NAME_USE sid_name_use,
 232                                            GROUP_MAP **rmap, int *num_entries,
 233                                            BOOL unix_only);
 234
 235         void (*free_fn)(struct pdb_context **);
 236
 237         TALLOC_CTX *mem_ctx;
 238
 239 } PDB_CONTEXT;
 240
 241 typedef struct pdb_methods
 242 {
 243         const char *name; /* What name got this module */
 244         struct pdb_context *parent;
 245
 246         /* Use macros from dlinklist.h on these two */
 247         struct pdb_methods *next;
 248         struct pdb_methods *prev;
 249
 250         NTSTATUS (*setsampwent)(struct pdb_methods *, BOOL update);
 251
 252         void (*endsampwent)(struct pdb_methods *);
 253
 254         NTSTATUS (*getsampwent)(struct pdb_methods *, SAM_ACCOUNT *user);
 255
 256         NTSTATUS (*getsampwnam)(struct pdb_methods *, SAM_ACCOUNT *sam_acct, const char *username);
 257
 258         NTSTATUS (*getsampwsid)(struct pdb_methods *, SAM_ACCOUNT *sam_acct, const DOM_SID *sid);
 259
 260         NTSTATUS (*add_sam_account)(struct pdb_methods *, SAM_ACCOUNT *sampass);
 261
 262         NTSTATUS (*update_sam_account)(struct pdb_methods *, SAM_ACCOUNT *sampass);
 263
 264         NTSTATUS (*delete_sam_account)(struct pdb_methods *, SAM_ACCOUNT *username);
 265
 266         NTSTATUS (*getgrsid)(struct pdb_methods *methods, GROUP_MAP *map, DOM_SID sid);
 267
 268         NTSTATUS (*getgrgid)(struct pdb_methods *methods, GROUP_MAP *map, gid_t gid);
 269
 270         NTSTATUS (*getgrnam)(struct pdb_methods *methods, GROUP_MAP *map, const char *name);
 271
 272         NTSTATUS (*add_group_mapping_entry)(struct pdb_methods *methods,
 273                                             GROUP_MAP *map);
 274
 275         NTSTATUS (*update_group_mapping_entry)(struct pdb_methods *methods,
 276                                                GROUP_MAP *map);
 277
 278         NTSTATUS (*delete_group_mapping_entry)(struct pdb_methods *methods,
 279                                                DOM_SID sid);
 280
 281         NTSTATUS (*enum_group_mapping)(struct pdb_methods *methods,
 282                                        enum SID_NAME_USE sid_name_use,
 283                                        GROUP_MAP **rmap, int *num_entries,
 284                                        BOOL unix_only);
 285
 286         void *private_data;  /* Private data of some kind */
 287
 288         void (*free_private_data)(void **);
 289
 290 } PDB_METHODS;
 291
 292 typedef NTSTATUS (*pdb_init_function)(struct pdb_context *,
 293                          struct pdb_methods **,
 294                          const char *);
 295
 296 struct pdb_init_function_entry {
 297         const char *name;
 298         /* Function to create a member of the pdb_methods list */
 299         pdb_init_function init;
 300         struct pdb_init_function_entry *prev, *next;
 301 };
 302
 303 #endif /* _PASSDB_H */