source/sam/gums.c

   1 /*
   2    Unix SMB/CIFS implementation.
   3    Grops and Users Management System initializations.
   4    Copyright (C) Simo Sorce 2002
   5
   6    This program is free software; you can redistribute it and/or modify
   7    it under the terms of the GNU General Public License as published by
   8    the Free Software Foundation; either version 2 of the License, or
   9    (at your option) any later version.
  10
  11    This program is distributed in the hope that it will be useful,
  12    but WITHOUT ANY WARRANTY; without even the implied warranty of
  13    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14    GNU General Public License for more details.
  15
  16    You should have received a copy of the GNU General Public License
  17    along with this program; if not, write to the Free Software
  18    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  19 */
  20
  21 #include "includes.h"
  22
  23 #undef DBGC_CLASS
  24 #define DBGC_CLASS DBGC_SAM
  25
  26 #define GMV_MAJOR 0
  27 #define GMV_MINOR 1
  28
  29 static GUMS_FUNCTIONS *gums_backend = NULL;
  30
  31 static struct gums_init_function_entry *backends = NULL;
  32
  33 static void lazy_initialize_gums(void)
  34 {
  35         static BOOL initialized = False;
  36
  37         if (initialized)
  38                 return;
  39
  40         static_init_gums;
  41         initialized = True;
  42 }
  43
  44 static struct gums_init_function_entry *gums_find_backend_entry(const char *name);
  45
  46 NTSTATUS gums_register_module(int version, const char *name, gums_init_function init_fn)
  47 {
  48         struct gums_init_function_entry *entry = backends;
  49
  50         if (version != GUMS_INTERFACE_VERSION) {
  51                 DEBUG(0,("Can't register gums backend!\n"
  52                          "You tried to register a gums module with"
  53                          "GUMS_INTERFACE_VERSION %d, while this version"
  54                          "of samba uses version %d\n", version,
  55                          GUMS_INTERFACE_VERSION));
  56
  57                 return NT_STATUS_OBJECT_TYPE_MISMATCH;
  58         }
  59
  60         if (!name || !init_fn) {
  61                 return NT_STATUS_INVALID_PARAMETER;
  62         }
  63
  64         DEBUG(5,("Attempting to register gums backend %s\n", name));
  65
  66         /* Check for duplicates */
  67         if (gums_find_backend_entry(name)) {
  68                 DEBUG(0,("There already is a gums backend registered"
  69                          "with the name %s!\n", name));
  70                 return NT_STATUS_OBJECT_NAME_COLLISION;
  71         }
  72
  73         entry = smb_xmalloc(sizeof(struct gums_init_function_entry));
  74         entry->name = smb_xstrdup(name);
  75         entry->init_fn = init_fn;
  76
  77         DLIST_ADD(backends, entry);
  78         DEBUG(5,("Successfully added gums backend '%s'\n", name));
  79         return NT_STATUS_OK;
  80 }
  81
  82 static struct gums_init_function_entry *gums_find_backend_entry(const char *name)
  83 {
  84         struct gums_init_function_entry *entry = backends;
  85
  86         while (entry) {
  87                 if (strcmp(entry->name, name) == 0)
  88                         return entry;
  89                 entry = entry->next;
  90         }
  91
  92         return NULL;
  93 }
  94
  95 NTSTATUS gums_setup_backend(const char *backend)
  96 {
  97
  98         TALLOC_CTX *mem_ctx;
  99         char *module_name = smb_xstrdup(backend);
 100         char *p, *module_data = NULL;
 101         struct gums_init_function_entry *entry;
 102         NTSTATUS ret = NT_STATUS_UNSUCCESSFUL;
 103
 104         lazy_initialize_gums();
 105
 106         p = strchr(module_name, ':');
 107         if (p) {
 108                 *p = 0;
 109                 module_data = p+1;
 110                 trim_string(module_data, " ", " ");
 111         }
 112
 113         trim_string(module_name, " ", " ");
 114
 115         DEBUG(5,("Attempting to find a gums backend to match %s (%s)\n", backend, module_name));
 116
 117         entry = gums_find_backend_entry(module_name);
 118
 119         /* Try to find a module that contains this module */
 120         if (!entry) {
 121                 DEBUG(2,("No builtin backend found, trying to load plugin\n"));
 122                 if(NT_STATUS_IS_OK(smb_probe_module("gums", module_name)) && !(entry = gums_find_backend_entry(module_name))) {
 123                         DEBUG(0,("Plugin is available, but doesn't register gums backend %s\n", module_name));
 124                         SAFE_FREE(module_name);
 125                         return NT_STATUS_UNSUCCESSFUL;
 126                 }
 127         }
 128
 129         /* No such backend found */
 130         if(!entry) {
 131                 DEBUG(0,("No builtin nor plugin backend for %s found\n", module_name));
 132                 SAFE_FREE(module_name);
 133                 return NT_STATUS_INVALID_PARAMETER;
 134         }
 135
 136         DEBUG(5,("Found gums backend %s\n", module_name));
 137
 138         /* free current functions structure if any */
 139         if (gums_backend) {
 140                 gums_backend->free_private_data(gums_backend->private_data);
 141                 talloc_destroy(gums_backend->mem_ctx);
 142                 gums_backend = NULL;
 143         }
 144
 145         /* allocate a new GUMS_FUNCTIONS structure and memory context */
 146         mem_ctx = talloc_init("gums_backend (%s)", module_name);
 147         if (!mem_ctx)
 148                 return NT_STATUS_NO_MEMORY;
 149         gums_backend = talloc(mem_ctx, sizeof(GUMS_FUNCTIONS));
 150         if (!gums_backend)
 151                 return NT_STATUS_NO_MEMORY;
 152         gums_backend->mem_ctx = mem_ctx;
 153
 154         /* init the requested backend module */
 155         if (NT_STATUS_IS_OK(ret = entry->init_fn(gums_backend, module_data))) {
 156                 DEBUG(5,("gums backend %s has a valid init\n", backend));
 157         } else {
 158                 DEBUG(0,("gums backend %s did not correctly init (error was %s)\n", backend, nt_errstr(ret)));
 159         }
 160         SAFE_FREE(module_name);
 161         return ret;
 162 }
 163
 164 NTSTATUS get_gums_fns(GUMS_FUNCTIONS **fns)
 165 {
 166         if (gums_backend != NULL) {
 167                 *fns = gums_backend;
 168                 return NT_STATUS_OK;
 169         }
 170
 171         DEBUG(2, ("get_gums_fns: unable to get gums functions! backend uninitialized?\n"));
 172         return NT_STATUS_UNSUCCESSFUL;
 173 }