contrib/sendmail/include/sm/ldap.h

   1 /*
   2  * Copyright (c) 2001-2003, 2005-2007 Proofpoint, Inc. and its suppliers.
   3  *      All rights reserved.
   4  *
   5  * By using this file, you agree to the terms and conditions set
   6  * forth in the LICENSE file which can be found at the top level of
   7  * the sendmail distribution.
   8  *
   9  *      $Id: ldap.h,v 1.35 2013-11-22 20:51:31 ca Exp $
  10  */
  11
  12 #ifndef SM_LDAP_H
  13 # define SM_LDAP_H
  14
  15 # include <sm/conf.h>
  16 # include <sm/rpool.h>
  17
  18 /*
  19 **  NOTE: These should be changed from LDAPMAP_* to SM_LDAP_*
  20 **      in the next major release (8.x+1) of sendmail.
  21 */
  22
  23 # ifndef LDAPMAP_MAX_ATTR
  24 #  define LDAPMAP_MAX_ATTR      64
  25 # endif
  26 # ifndef LDAPMAP_MAX_FILTER
  27 #  define LDAPMAP_MAX_FILTER    1024
  28 # endif
  29 # ifndef LDAPMAP_MAX_PASSWD
  30 #  define LDAPMAP_MAX_PASSWD    256
  31 # endif
  32
  33 # if LDAPMAP
  34
  35 /* maximum number of arguments in a map lookup, see sendmail.h: MAX_MAP_ARGS */
  36 #  define SM_LDAP_ARGS          10
  37
  38 /* error codes from sm_ldap_search*() */
  39 #  define SM_LDAP_ERR           (-1)    /* generic error: ldap_search(3) */
  40 #  define SM_LDAP_ERR_ARG_MISS  (-2)    /* an argument is missing */
  41
  42 /* Attribute types */
  43 #  define SM_LDAP_ATTR_NONE             (-1)
  44 #  define SM_LDAP_ATTR_OBJCLASS 0
  45 #  define SM_LDAP_ATTR_NORMAL           1
  46 #  define SM_LDAP_ATTR_DN               2
  47 #  define SM_LDAP_ATTR_FILTER           3
  48 #  define SM_LDAP_ATTR_URL              4
  49
  50 /* sm_ldap_results() flags */
  51 #  define SM_LDAP_SINGLEMATCH   0x0001
  52 #  define SM_LDAP_MATCHONLY     0x0002
  53 #  define SM_LDAP_USE_ALLATTR   0x0004
  54 #  define SM_LDAP_SINGLEDN      0x0008
  55
  56 struct sm_ldap_struct
  57 {
  58         /* needed for ldap_open or ldap_init */
  59         char            *ldap_uri;
  60         char            *ldap_host;
  61         int             ldap_port;
  62         int             ldap_version;
  63         pid_t           ldap_pid;
  64
  65         /* options set in ld struct before ldap_bind_s */
  66         int             ldap_deref;
  67         time_t          ldap_timelimit;
  68         int             ldap_sizelimit;
  69         int             ldap_options;
  70
  71         /* args for ldap_bind_s */
  72         LDAP            *ldap_ld;
  73         char            *ldap_binddn;
  74         char            *ldap_secret;
  75         int             ldap_method;
  76
  77         /* args for ldap_search */
  78         char            *ldap_base;
  79         int             ldap_scope;
  80         char            *ldap_filter;
  81         char            *ldap_attr[LDAPMAP_MAX_ATTR + 1];
  82         int             ldap_attr_type[LDAPMAP_MAX_ATTR + 1];
  83         char            *ldap_attr_needobjclass[LDAPMAP_MAX_ATTR + 1];
  84         bool            ldap_attrsonly;
  85         bool            ldap_multi_args;
  86
  87         /* args for ldap_result */
  88         struct timeval  ldap_timeout;
  89         LDAPMessage     *ldap_res;
  90
  91         /* ldapmap_lookup options */
  92         char            ldap_attrsep;
  93
  94 #  if LDAP_NETWORK_TIMEOUT
  95         int             ldap_networktmo;
  96 #  endif
  97 #  if _FFR_SM_LDAP_DBG
  98         int             ldap_debug;
  99 #  endif
 100
 101         /* Linked list of maps sharing the same LDAP binding */
 102         void            *ldap_next;
 103 };
 104
 105 typedef struct sm_ldap_struct           SM_LDAP_STRUCT;
 106
 107 struct sm_ldap_recurse_entry
 108 {
 109         char            *lr_search;
 110         int             lr_type;
 111         LDAPURLDesc     *lr_ludp;
 112         char            **lr_attrs;
 113         bool            lr_done;
 114 };
 115
 116 struct sm_ldap_recurse_list
 117 {
 118         int                             lrl_size;
 119         int                             lrl_cnt;
 120         struct sm_ldap_recurse_entry    **lrl_data;
 121 };
 122
 123 typedef struct sm_ldap_recurse_entry    SM_LDAP_RECURSE_ENTRY;
 124 typedef struct sm_ldap_recurse_list     SM_LDAP_RECURSE_LIST;
 125
 126 /* functions */
 127 extern void     sm_ldap_clear __P((SM_LDAP_STRUCT *));
 128 extern bool     sm_ldap_start __P((char *, SM_LDAP_STRUCT *));
 129 extern int      sm_ldap_search __P((SM_LDAP_STRUCT *, char *));
 130 extern int      sm_ldap_search_m __P((SM_LDAP_STRUCT *, char **));
 131 extern int      sm_ldap_results __P((SM_LDAP_STRUCT *, int, int, int,
 132                                      SM_RPOOL_T *, char **, int *, int *,
 133                                      SM_LDAP_RECURSE_LIST *));
 134 extern void     sm_ldap_setopts __P((LDAP *, SM_LDAP_STRUCT *));
 135 extern int      sm_ldap_geterrno __P((LDAP *));
 136 extern void     sm_ldap_close __P((SM_LDAP_STRUCT *));
 137
 138 /* Portability defines */
 139 #  if !SM_CONF_LDAP_MEMFREE
 140 #   define ldap_memfree(x)      ((void) 0)
 141 #  endif
 142
 143 # endif /* LDAPMAP */
 144 #endif /* ! SM_LDAP_H */