1 /* 2 * Copyright (c) 2001-2003, 2005, 2006 Sendmail, 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.32 2006/08/30 22:56:58 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 /* ! LDAPMAP_MAX_ATTR */ 26 # ifndef LDAPMAP_MAX_FILTER 27 # define LDAPMAP_MAX_FILTER 1024 28 # endif /* ! LDAPMAP_MAX_FILTER */ 29 # ifndef LDAPMAP_MAX_PASSWD 30 # define LDAPMAP_MAX_PASSWD 256 31 # endif /* ! LDAPMAP_MAX_PASSWD */ 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 /* Linked list of maps sharing the same LDAP binding */ 95 void *ldap_next; 96 }; 97 98 typedef struct sm_ldap_struct SM_LDAP_STRUCT; 99 100 struct sm_ldap_recurse_entry 101 { 102 char *lr_search; 103 int lr_type; 104 LDAPURLDesc *lr_ludp; 105 char **lr_attrs; 106 bool lr_done; 107 }; 108 109 struct sm_ldap_recurse_list 110 { 111 int lrl_size; 112 int lrl_cnt; 113 struct sm_ldap_recurse_entry **lrl_data; 114 }; 115 116 typedef struct sm_ldap_recurse_entry SM_LDAP_RECURSE_ENTRY; 117 typedef struct sm_ldap_recurse_list SM_LDAP_RECURSE_LIST; 118 119 /* functions */ 120 extern void sm_ldap_clear __P((SM_LDAP_STRUCT *)); 121 extern bool sm_ldap_start __P((char *, SM_LDAP_STRUCT *)); 122 extern int sm_ldap_search __P((SM_LDAP_STRUCT *, char *)); 123 extern int sm_ldap_search_m __P((SM_LDAP_STRUCT *, char **)); 124 extern int sm_ldap_results __P((SM_LDAP_STRUCT *, int, int, int, 125 SM_RPOOL_T *, char **, int *, int *, 126 SM_LDAP_RECURSE_LIST *)); 127 extern void sm_ldap_setopts __P((LDAP *, SM_LDAP_STRUCT *)); 128 extern int sm_ldap_geterrno __P((LDAP *)); 129 extern void sm_ldap_close __P((SM_LDAP_STRUCT *)); 130 131 /* Portability defines */ 132 # if !SM_CONF_LDAP_MEMFREE 133 # define ldap_memfree(x) ((void) 0) 134 # endif /* !SM_CONF_LDAP_MEMFREE */ 135 136 # endif /* LDAPMAP */ 137 #endif /* ! SM_LDAP_H */ 138