source3/include/tldap_util.h

   1 /*
   2    Unix SMB/CIFS implementation.
   3    Infrastructure for async ldap client requests
   4    Copyright (C) Volker Lendecke 2009
   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 3 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, see <http://www.gnu.org/licenses/>.
  18 */
  19
  20 #ifndef __TLDAP_UTIL_H__
  21 #define __TLDAP_UTIL_H__
  22
  23 #include "includes.h"
  24
  25 bool tldap_entry_values(struct tldap_message *msg, const char *attribute,
  26                         DATA_BLOB **values, int *num_values);
  27 bool tldap_get_single_valueblob(struct tldap_message *msg,
  28                                 const char *attribute, DATA_BLOB *blob);
  29 char *tldap_talloc_single_attribute(struct tldap_message *msg,
  30                                     const char *attribute,
  31                                     TALLOC_CTX *mem_ctx);
  32 bool tldap_pull_binsid(struct tldap_message *msg, const char *attribute,
  33                        struct dom_sid *sid);
  34 bool tldap_pull_guid(struct tldap_message *msg, const char *attribute,
  35                      struct GUID *guid);
  36 bool tldap_add_mod_blobs(TALLOC_CTX *mem_ctx,
  37                          struct tldap_mod **pmods, int *pnum_mods,
  38                          int mod_op, const char *attrib,
  39                          DATA_BLOB *newvals, int num_newvals);
  40 bool tldap_add_mod_str(TALLOC_CTX *mem_ctx,
  41                        struct tldap_mod **pmods, int *pnum_mods,
  42                        int mod_op, const char *attrib, const char *str);
  43 bool tldap_make_mod_blob(struct tldap_message *existing, TALLOC_CTX *mem_ctx,
  44                          struct tldap_mod **pmods, int *pnum_mods,
  45                          const char *attrib, DATA_BLOB newval);
  46 bool tldap_make_mod_fmt(struct tldap_message *existing, TALLOC_CTX *mem_ctx,
  47                         struct tldap_mod **pmods, int *pnum_mods,
  48                         const char *attrib, const char *fmt, ...);
  49
  50 const char *tldap_errstr(TALLOC_CTX *mem_ctx, struct tldap_context *ld,
  51                          int rc);
  52 int tldap_search_va(struct tldap_context *ld, const char *base, int scope,
  53                     const char *attrs[], int num_attrs, int attrsonly,
  54                     TALLOC_CTX *mem_ctx, struct tldap_message ***res,
  55                     const char *fmt, va_list ap);
  56 int tldap_search_fmt(struct tldap_context *ld, const char *base, int scope,
  57                      const char *attrs[], int num_attrs, int attrsonly,
  58                      TALLOC_CTX *mem_ctx, struct tldap_message ***res,
  59                      const char *fmt, ...);
  60 bool tldap_pull_uint64(struct tldap_message *msg, const char *attr,
  61                        uint64_t *presult);
  62 bool tldap_pull_uint32(struct tldap_message *msg, const char *attr,
  63                        uint32_t *presult);
  64
  65 struct tevent_req *tldap_fetch_rootdse_send(TALLOC_CTX *mem_ctx,
  66                                             struct tevent_context *ev,
  67                                             struct tldap_context *ld);
  68 int tldap_fetch_rootdse_recv(struct tevent_req *req);
  69 int tldap_fetch_rootdse(struct tldap_context *ld);
  70 struct tldap_message *tldap_rootdse(struct tldap_context *ld);
  71
  72 bool tldap_entry_has_attrvalue(struct tldap_message *msg,
  73                                const char *attribute,
  74                                const DATA_BLOB blob);
  75 bool tldap_supports_control(struct tldap_context *ld, const char *oid);
  76
  77 struct tldap_control *tldap_add_control(TALLOC_CTX *mem_ctx,
  78                                         struct tldap_control *ctrls,
  79                                         int num_ctrls,
  80                                         struct tldap_control *ctrl);
  81 struct tldap_control *tldap_msg_findcontrol(struct tldap_message *msg,
  82                                             const char *oid);
  83
  84 struct tevent_req *tldap_search_paged_send(TALLOC_CTX *mem_ctx,
  85                                            struct tevent_context *ev,
  86                                            struct tldap_context *ld,
  87                                            const char *base, int scope,
  88                                            const char *filter,
  89                                            const char **attrs,
  90                                            int num_attrs,
  91                                            int attrsonly,
  92                                            struct tldap_control *sctrls,
  93                                            int num_sctrls,
  94                                            struct tldap_control *cctrls,
  95                                            int num_cctrls,
  96                                            int timelimit,
  97                                            int sizelimit,
  98                                            int deref,
  99                                            int page_size);
 100 int tldap_search_paged_recv(struct tevent_req *req, TALLOC_CTX *mem_ctx,
 101                             struct tldap_message **pmsg);
 102
 103
 104 #endif