source4/lib/ldb/common/ldb.c

   1 /*
   2    ldb database library
   3
   4    Copyright (C) Andrew Tridgell  2004
   5
   6      ** NOTE! The following LGPL license applies to the ldb
   7      ** library. This does NOT imply that all of Samba is released
   8      ** under the LGPL
   9
  10    This library is free software; you can redistribute it and/or
  11    modify it under the terms of the GNU Lesser General Public
  12    License as published by the Free Software Foundation; either
  13    version 2 of the License, or (at your option) any later version.
  14
  15    This library is distributed in the hope that it will be useful,
  16    but WITHOUT ANY WARRANTY; without even the implied warranty of
  17    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  18    Lesser General Public License for more details.
  19
  20    You should have received a copy of the GNU Lesser General Public
  21    License along with this library; if not, write to the Free Software
  22    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  23 */
  24
  25 /*
  26  *  Name: ldb
  27  *
  28  *  Component: ldb core API
  29  *
  30  *  Description: core API routines interfacing to ldb backends
  31  *
  32  *  Author: Andrew Tridgell
  33  */
  34
  35 #include "includes.h"
  36
  37 /*
  38  connect to a database. The URL can either be one of the following forms
  39    ldb://path
  40    ldapi://path
  41
  42    flags is made up of LDB_FLG_*
  43
  44    the options are passed uninterpreted to the backend, and are
  45    backend specific
  46 */
  47 struct ldb_context *ldb_connect(const char *url, unsigned int flags,
  48                                 const char *options[])
  49 {
  50
  51         if (strncmp(url, "tdb:", 4) == 0) {
  52                 return ltdb_connect(url, flags, options);
  53         }
  54
  55 #ifdef HAVE_LDAP
  56         if (strncmp(url, "ldap", 4) == 0) {
  57                 return lldb_connect(url, flags, options);
  58         }
  59 #endif /*HAVE_LDAP*/
  60
  61         errno = EINVAL;
  62         return NULL;
  63 }
  64
  65 /*
  66   close the connection to the database
  67 */
  68 int ldb_close(struct ldb_context *ldb)
  69 {
  70         return ldb->ops->close(ldb);
  71 }
  72
  73
  74 /*
  75   search the database given a LDAP-like search expression
  76
  77   return the number of records found, or -1 on error
  78 */
  79 int ldb_search(struct ldb_context *ldb,
  80                const char *base,
  81                enum ldb_scope scope,
  82                const char *expression,
  83                const char *attrs[], struct ldb_message ***res)
  84 {
  85         return ldb->ops->search(ldb, base, scope, expression, attrs, res);
  86 }
  87
  88 /*
  89    free a set of messages returned by ldb_search
  90 */
  91 int ldb_search_free(struct ldb_context *ldb, struct ldb_message **msgs)
  92 {
  93         return ldb->ops->search_free(ldb, msgs);
  94 }
  95
  96
  97 /*
  98   add a record to the database. Will fail if a record with the given class and key
  99   already exists
 100 */
 101 int ldb_add(struct ldb_context *ldb,
 102             const struct ldb_message *message)
 103 {
 104         return ldb->ops->add(ldb, message);
 105 }
 106
 107 /*
 108   modify the specified attributes of a record
 109 */
 110 int ldb_modify(struct ldb_context *ldb,
 111                const struct ldb_message *message)
 112 {
 113         return ldb->ops->modify(ldb, message);
 114 }
 115
 116
 117 /*
 118   delete a record from the database
 119 */
 120 int ldb_delete(struct ldb_context *ldb, const char *dn)
 121 {
 122         return ldb->ops->delete(ldb, dn);
 123 }
 124
 125 /*
 126   return extended error information
 127 */
 128 const char *ldb_errstring(struct ldb_context *ldb)
 129 {
 130         return ldb->ops->errstring(ldb);
 131 }