1 /* 2 * CDDL HEADER START 3 * 4 * The contents of this file are subject to the terms of the 5 * Common Development and Distribution License, Version 1.0 only 6 * (the "License"). You may not use this file except in compliance 7 * with the License. 8 * 9 * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE 10 * or http://www.opensolaris.org/os/licensing. 11 * See the License for the specific language governing permissions 12 * and limitations under the License. 13 * 14 * When distributing Covered Code, include this CDDL HEADER in each 15 * file and include the License file at usr/src/OPENSOLARIS.LICENSE. 16 * If applicable, add the following below this CDDL HEADER, with the 17 * fields enclosed by brackets "[]" replaced with your own identifying 18 * information: Portions Copyright [yyyy] [name of copyright owner] 19 * 20 * CDDL HEADER END 21 */ 22 /* 23 * Copyright 2004 Sun Microsystems, Inc. All rights reserved. 24 * Use is subject to license terms. 25 */ 26 27 28 #ifndef _NS_INTERNAL_H 29 #define _NS_INTERNAL_H 30 31 #pragma ident "%Z%%M% %I% %E% SMI" 32 33 #ifdef __cplusplus 34 extern "C" { 35 #endif 36 37 #include <stdio.h> 38 #include <sys/types.h> 39 #include <sys/time.h> 40 #include <thread.h> 41 #include <lber.h> 42 #include <ldap.h> 43 #include "ns_sldap.h" 44 45 /* 46 * INTERNALLY USED CONSTANTS 47 */ 48 49 #define MAXERROR 2000 50 #define TRUE 1 51 #define FALSE 0 52 #define NSLDAPDIRECTORY "/var/ldap" 53 #define NSCONFIGFILE "/var/ldap/ldap_client_file" 54 #define NSCONFIGREFRESH "/var/ldap/ldap_client_file.refresh" 55 #define NSCREDFILE "/var/ldap/ldap_client_cred" 56 #define NSCREDREFRESH "/var/ldap/ldap_client_cred.refresh" 57 #define ROTORSIZE 256 58 #define MASK 0377 59 #define LDAPMAXHARDLOOKUPTIME 256 60 #define DONOTEDIT \ 61 "Do not edit this file manually; your changes will be lost." \ 62 "Please use ldapclient (1M) instead." 63 #define MAXPORTNUMBER 65535 64 #define MAXPORTNUMBER_STR "65535" 65 #define CREDFILE 0 66 #define CONFIGFILE 1 67 #define UIDNUMFILTER "(&(objectclass=posixAccount)(uidnumber=%s))" 68 #define UIDNUMFILTER_SSD "(&(%%s)(uidnumber=%s))" 69 #define UIDFILTER "(&(objectclass=posixAccount)(uid=%s))" 70 #define UIDFILTER_SSD "(&(%%s)(uid=%s))" 71 #define HOSTFILTER "(&(objectclass=ipHost)(cn=%s))" 72 #define HOSTFILTER_SSD "(&(%%s)(cn=%s))" 73 74 #define SIMPLEPAGECTRLFLAG 1 75 #define VLVCTRLFLAG 2 76 77 #define LISTPAGESIZE 1000 78 #define ENUMPAGESIZE 100 79 #define SORTKEYLIST "cn uid" 80 81 #define DEFMAX 8 82 #define TOKENSEPARATOR '=' 83 #define QUOTETOK '"' 84 #define SPACETOK ' ' 85 #define COMMATOK ',' 86 #define COLONTOK ':' 87 #define QUESTTOK '?' 88 #define SEMITOK ';' 89 #define TABTOK '\t' 90 #define OPARATOK '(' 91 #define CPARATOK ')' 92 #define BSLTOK '\\' 93 #define DOORLINESEP "\07" 94 #define COMMASEP ", " 95 #define SPACESEP " " 96 #define SEMISEP ";" 97 #define COLONSEP ":" 98 #define COLSPSEP ": " 99 #define EQUALSEP "=" 100 #define EQUSPSEP "= " 101 #define LAST_VALUE (int)NS_LDAP_HOST_CERTPATH_P 102 #define BUFSIZE 1024 103 #define DEFAULTCONFIGNAME "__default_config" 104 #define EXP_DEFAULT_TTL "43200" /* 12 hours TTL */ 105 #define CRYPTMARK "{NS1}" 106 #define DOORBUFFERSIZE 8192 107 108 #define LDIF_FMT_STR "%s: %s" 109 #define FILE_FMT_STR "%s= %s" 110 #define DOOR_FMT_STR "%s=%s" 111 112 #define SESSION_CACHE_INC 8 113 #define CONID_OFFSET 1024 114 #define NS_DEFAULT_BIND_TIMEOUT 30 /* timeout value in seconds */ 115 #define NS_DEFAULT_SEARCH_TIMEOUT 30 /* timeout value in seconds */ 116 117 /* max rdn length in conversion routines used by __ns_ldap_addTypedEntry() */ 118 #define RDNSIZE 256 119 120 121 /* Phase 1 profile information */ 122 #define _PROFILE1_OBJECTCLASS "SolarisNamingProfile" 123 #define _PROFILE_CONTAINER "profile" 124 #define _PROFILE_FILTER "(&(|(objectclass=%s)(objectclass=%s))(cn=%s))" 125 126 /* Phase 2 profile information */ 127 #define _PROFILE2_OBJECTCLASS "DUAConfigProfile" 128 129 /* Common to all profiles */ 130 #define _P_CN "cn" 131 132 /* Native LDAP Phase 1 Specific Profile Attributes */ 133 #define _P1_SERVERS "SolarisLDAPServers" 134 #define _P1_SEARCHBASEDN "SolarisSearchBaseDN" 135 #define _P1_CACHETTL "SolarisCacheTTL" 136 #define _P1_BINDDN "SolarisBindDN" 137 #define _P1_BINDPASSWORD "SolarisBindPassword" 138 #define _P1_AUTHMETHOD "SolarisAuthMethod" 139 #define _P1_TRANSPORTSECURITY "SolarisTransportSecurity" 140 #define _P1_CERTIFICATEPATH "SolarisCertificatePath" 141 #define _P1_CERTIFICATEPASSWORD "SolarisCertificatePassword" 142 #define _P1_DATASEARCHDN "SolarisDataSearchDN" 143 #define _P1_SEARCHSCOPE "SolarisSearchScope" 144 #define _P1_SEARCHTIMELIMIT "SolarisSearchTimeLimit" 145 #define _P1_PREFERREDSERVER "SolarisPreferredServer" 146 #define _P1_PREFERREDSERVERONLY "SolarisPreferredServerOnly" 147 #define _P1_SEARCHREFERRAL "SolarisSearchReferral" 148 #define _P1_BINDTIMELIMIT "SolarisBindTimeLimit" 149 150 /* Native LDAP Phase 2 Specific Profile Attributes */ 151 #define _P2_PREFERREDSERVER "preferredServerList" 152 #define _P2_DEFAULTSERVER "defaultServerList" 153 #define _P2_SEARCHBASEDN "defaultSearchBase" 154 #define _P2_SEARCHSCOPE "defaultSearchScope" 155 #define _P2_AUTHMETHOD "authenticationMethod" 156 #define _P2_CREDENTIALLEVEL "credentialLevel" 157 #define _P2_SERVICESEARCHDESC "serviceSearchDescriptor" 158 #define _P2_SEARCHTIMELIMIT "searchTimeLimit" 159 #define _P2_BINDTIMELIMIT "bindTimeLimit" 160 #define _P2_FOLLOWREFERRALS "followReferrals" 161 #define _P2_PROFILETTL "profileTTL" 162 #define _P2_ATTRIBUTEMAP "attributeMap" 163 #define _P2_OBJECTCLASSMAP "objectClassMap" 164 #define _P2_SERVICECREDLEVEL "serviceCredentialLevel" 165 #define _P2_SERVICEAUTHMETHOD "serviceAuthenticationMethod" 166 167 /* Control & SASL information from RootDSE door call */ 168 #define _SASLMECHANISM "supportedSASLmechanisms" 169 #define _SASLMECHANISM_LEN 23 170 #define _SUPPORTEDCONTROL "supportedControl" 171 #define _SUPPORTEDCONTROL_LEN 16 172 173 #define NS_HASH_MAX 257 174 #define NS_HASH_SCHEMA_MAPPING_EXISTED "=MAPPING EXISTED=" 175 #define NS_HASH_RC_SUCCESS 1 176 #define NS_HASH_RC_NO_MEMORY -1 177 #define NS_HASH_RC_CONFIG_ERROR -2 178 #define NS_HASH_RC_EXISTED -3 179 #define NS_HASH_RC_SYNTAX_ERROR -4 180 181 /* Password management related error message from iDS ldap server */ 182 #define NS_PWDERR_MAXTRIES \ 183 "Exceed password retry limit." 184 #define NS_PWDERR_EXPIRED \ 185 "password expired!" 186 #define NS_PWDERR_ACCT_INACTIVATED \ 187 "Account inactivated. Contact system administrator." 188 #define NS_PWDERR_CHANGE_NOT_ALLOW \ 189 "user is not allowed to change password" 190 #define NS_PWDERR_INVALID_SYNTAX \ 191 "invalid password syntax" 192 #define NS_PWDERR_TRIVIAL_PASSWD \ 193 "Password failed triviality check" 194 #define NS_PWDERR_IN_HISTORY \ 195 "password in history" 196 #define NS_PWDERR_WITHIN_MIN_AGE \ 197 "within password minimum age" 198 199 /* 200 * INTERNALLY USED MACROS 201 */ 202 203 void __s_api_debug_pause(int priority, int st, const char *mesg); 204 205 #define NULL_OR_STR(str) (!(str) || *(str) == '\0' ? "<NULL>" : (str)) 206 207 /* 208 * MKERROR: builds the error structure and fills in the status and 209 * the message. The message must be a freeable (non-static) string. 210 * If it fails to allocate memory for the error structure, 211 * it will return the retErr. 212 */ 213 #define MKERROR(priority, err, st, mesg, retErr) \ 214 if (((err) = calloc(1, sizeof (struct ns_ldap_error))) == NULL) \ 215 return (retErr); \ 216 (err)->message = mesg; \ 217 (err)->status = (st); \ 218 __s_api_debug_pause(priority, st, (err)->message); 219 220 /* 221 * MKERROR_PWD_MGMT is almost the same as MKERROR 222 * except that it takes two more inputs to fill in the 223 * password management information part of the 224 * ns_ldap_error structure pointed to by err, 225 * and it does not log a syslog message. 226 */ 227 #define MKERROR_PWD_MGMT(err, st, mesg, pwd_status, sec_until_exp, retErr) \ 228 if (((err) = calloc(1, sizeof (struct ns_ldap_error))) == NULL) \ 229 return (retErr); \ 230 (err)->message = mesg; \ 231 (err)->status = (st); \ 232 (err)->pwd_mgmt.status = (pwd_status); \ 233 (err)->pwd_mgmt.sec_until_expired = (sec_until_exp); 234 235 #ifdef DEBUG 236 #define NSLDAPTRACE(variable, setequal, message) \ 237 if (variable > 0 || ((setequal != 0) && (variable == setequal))) { \ 238 char buf[BUFSIZ]; \ 239 (void) snprintf(buf, BUFSIZ, message); \ 240 (void) write(__ldap_debug_file, buf); \ 241 } 242 #endif 243 244 /* 245 * INTERNAL DATA STRUCTURES 246 */ 247 248 /* 249 * configuration entry type 250 */ 251 252 typedef enum { 253 SERVERCONFIG = 1, 254 CLIENTCONFIG = 2, 255 CREDCONFIG = 3 256 } ns_conftype_t; 257 258 /* 259 * datatype of a config entry 260 */ 261 262 typedef enum { 263 NS_UNKNOWN = 0, 264 CHARPTR = 1, /* Single character pointer */ 265 ARRAYCP = 2, /* comma sep array of char pointers */ 266 ARRAYAUTH = 3, /* Array of auths */ 267 TIMET = 4, /* time relative value (TTL) */ 268 INT = 5, /* single integer */ 269 SSDLIST = 6, /* service search descriptor */ 270 ATTRMAP = 7, /* attribute mapping */ 271 OBJMAP = 8, /* objectclass mapping */ 272 SERVLIST = 9, /* serverlist (SP sep array) */ 273 ARRAYCRED = 10, /* Array of credentialLevels */ 274 SAMLIST = 11, /* serviceAuthenticationMethod */ 275 SCLLIST = 12 /* serviceCredentialLevel */ 276 } ns_datatype_t; 277 278 typedef enum { 279 NS_SUCCESS, 280 NS_NOTFOUND, 281 NS_PARSE_ERR 282 } ns_parse_status; 283 284 typedef enum { 285 NS_DOOR_FMT = 1, 286 NS_LDIF_FMT = 2, 287 NS_FILE_FMT = 3 288 } ns_strfmt_t; 289 290 /* 291 * This enum reduces the number of version string compares 292 * against NS_LDAP_VERSION_1 and NS_LDAP_VERSION_2 293 */ 294 295 typedef enum { 296 NS_LDAP_V1 = 1000, 297 NS_LDAP_V2 = 2000 298 } ns_version_t; 299 300 /* 301 * enum<->string mapping construct 302 */ 303 304 typedef struct ns_enum_map { 305 int value; 306 char *name; 307 } ns_enum_map; 308 309 #define ENUM2INT(x) ((int)(x)) 310 311 #define INT2PARAMINDEXENUM(x) ((ParamIndexType)(x)) 312 #define INT2SEARCHREFENUM(x) ((SearchRef_t)(x)) 313 #define INT2SCOPEENUM(x) ((ScopeType_t)(x)) 314 #define INT2AUTHENUM(x) ((AuthType_t)(x)) 315 #define INT2SECENUM(x) ((TlsType_t)(x)) 316 #define INT2PREFONLYENUM(x) ((PrefOnly_t)(x)) 317 #define INT2CREDLEVELENUM(x) ((CredLevel_t)(x)) 318 319 #define INT2LDAPRETURN(x) ((ns_ldap_return_code)(x)) 320 #define INT2CONFIGRETURN(x) ((ns_ldap_config_return_code)(x)) 321 #define INT2PARTIALRETURN(x) ((ns_ldap_partial_return_code)(x)) 322 323 /* 324 * This structure maps service name to rdn components 325 * for use in __ns_getDNs. It also defines the SSD-to-use 326 * service for use in __s_api_get_SSDtoUse_service. 327 * The idea of an SSD-to-use service is to reduce the configuration 328 * complexity. For a service, which does not have its own entries in 329 * the LDAP directory, SSD for it is useless, and should not be set. 330 * But since this service must share the container with at least 331 * one other service which does have it own entries, the SSD for 332 * this other service will be shared by this service. 333 * This other service is called the SSD-to-use service. 334 * 335 */ 336 337 typedef struct ns_service_map { 338 char *service; 339 char *rdn; 340 char *SSDtoUse_service; 341 } ns_service_map; 342 343 /* 344 * This structure contains a single mapping from: 345 * service:orig -> list of mapped 346 */ 347 348 typedef enum { 349 NS_ATTR_MAP, 350 NS_OBJ_MAP 351 } ns_maptype_t; 352 353 typedef struct ns_mapping { 354 ns_maptype_t type; 355 char *service; 356 char *orig; 357 char **map; 358 } ns_mapping_t; 359 360 /* 361 * The following is the list of internal libsldap configuration data 362 * structures. The configuration is populated normally once per 363 * application. The assumption is that in applications can be 364 * relatively short lived (IE ls via nsswitch) so it is important to 365 * keep configuration to a minimum, but keep lookups fast. 366 * 367 * Assumptions: 368 * 1 configuration entry per domain, and almost always 1 domain 369 * per app. Hooks exist for multiple domains per app. 370 * 371 * Configurations are read in from client file cache or from LDAP. 372 * Attribute/objectclass mappings are hashed to improve lookup 373 * speed. 374 */ 375 376 /* 377 * Hash entry types 378 */ 379 typedef enum _ns_hashtype_t { 380 NS_HASH_AMAP = 1, /* attr map */ 381 NS_HASH_RAMAP = 2, /* reverse attr map */ 382 NS_HASH_OMAP = 3, /* oc map */ 383 NS_HASH_ROMAP = 4, /* reverse oc map */ 384 NS_HASH_VOID = 5 385 } ns_hashtype_t; 386 387 typedef struct ns_hash { 388 ns_hashtype_t h_type; 389 ns_mapping_t *h_map; 390 struct ns_hash *h_next; 391 struct ns_hash *h_llnext; 392 } ns_hash_t; 393 394 /* 395 * This structure defines the format of an internal configuration 396 * parameter for ns_ldap client. 397 */ 398 399 typedef struct ns_param { 400 ns_datatype_t ns_ptype; 401 int ns_acnt; 402 union { 403 char **ppc; 404 int *pi; 405 char *pc; 406 int i; 407 time_t tm; 408 } ns_pu; 409 } ns_param_t; 410 411 #define ns_ppc ns_pu.ppc 412 #define ns_pi ns_pu.pi 413 #define ns_pc ns_pu.pc 414 #define ns_i ns_pu.i 415 #define ns_tm ns_pu.tm 416 417 /* 418 * This structure defines an instance of a configuration structure. 419 * paramList contains the current ns_ldap parameter configuration 420 * and hashTbl contain the current attribute/objectclass mappings. 421 * Parameters are indexed by using the value assigned to the parameter 422 * in ParamIndexType. 423 */ 424 425 typedef struct ns_config { 426 char *domainName; 427 ns_version_t version; 428 ns_param_t paramList[NS_LDAP_MAX_PIT_P]; 429 ns_hash_t *hashTbl[NS_HASH_MAX]; 430 ns_hash_t *llHead; 431 ns_ldap_entry_t *RootDSE; 432 boolean_t delete; 433 mutex_t config_mutex; 434 int nUse; 435 } ns_config_t; 436 437 /* 438 * This structure defines the mapping of the NSCONFIGFILE file 439 * statements into their corresponding SolarisNamingProfile, 440 * Posix Mapping LDAP attributes, and to their corresponding 441 * ParamIndexType enum mapping. THe ParamIndexType enum 442 * definitions can be found in ns_ldap.h. This structure also 443 * defines the default values that are used when a value either 444 * does not exist or is undefined. 445 */ 446 447 typedef struct ns_default_config { 448 const char *name; /* config file parameter name */ 449 ParamIndexType index; /* config file enum index */ 450 ns_conftype_t config_type; /* CLIENT/SERVER/CREDCONFIG */ 451 ns_datatype_t data_type; /* ppc,pi,pc,int etc... */ 452 int single_valued; /* TRUE OR FALSE */ 453 ns_version_t version; /* Version # for attribute */ 454 const char *profile_name; /* profile schema attribute name */ 455 ns_param_t defval; /* config file parameter default */ 456 int (*ns_verify)(ParamIndexType i, 457 struct ns_default_config *def, 458 ns_param_t *param, 459 char *errbuf); 460 ns_enum_map *allowed; /* allowed values */ 461 } ns_default_config; 462 463 464 /* 465 * This typedef enumerates all the supported authentication 466 * mechanisms currently supported in this library 467 */ 468 469 typedef enum EnumAuthType { 470 NS_LDAP_EA_NONE = 0, 471 NS_LDAP_EA_SIMPLE = 1, 472 NS_LDAP_EA_SASL_NONE = 2, 473 NS_LDAP_EA_SASL_CRAM_MD5 = 3, 474 NS_LDAP_EA_SASL_DIGEST_MD5 = 4, 475 NS_LDAP_EA_SASL_DIGEST_MD5_INT = 5, 476 NS_LDAP_EA_SASL_DIGEST_MD5_CONF = 6, 477 NS_LDAP_EA_SASL_EXTERNAL = 7, 478 NS_LDAP_EA_SASL_GSSAPI = 8, /* unsupported */ 479 NS_LDAP_EA_SASL_SPNEGO = 9, /* unsupported */ 480 NS_LDAP_EA_TLS_NONE = 10, 481 NS_LDAP_EA_TLS_SIMPLE = 11, 482 NS_LDAP_EA_TLS_SASL_NONE = 12, 483 NS_LDAP_EA_TLS_SASL_CRAM_MD5 = 13, 484 NS_LDAP_EA_TLS_SASL_DIGEST_MD5 = 14, 485 NS_LDAP_EA_TLS_SASL_DIGEST_MD5_INT = 15, 486 NS_LDAP_EA_TLS_SASL_DIGEST_MD5_CONF = 16, 487 NS_LDAP_EA_TLS_SASL_EXTERNAL = 17, 488 NS_LDAP_EA_TLS_SASL_GSSAPI = 18, /* unsupported */ 489 NS_LDAP_EA_TLS_SASL_SPNEGO = 19 /* unsupported */ 490 } EnumAuthType_t; 491 492 493 /* 494 * this enum lists the various states of the search state machine 495 */ 496 497 typedef enum { 498 INIT = 1, 499 EXIT = 2, 500 NEXT_SEARCH_DESCRIPTOR = 3, 501 GET_SESSION = 4, 502 NEXT_SESSION = 5, 503 RESTART_SESSION = 6, 504 NEXT_SEARCH = 7, 505 NEXT_VLV = 8, 506 NEXT_PAGE = 9, 507 ONE_SEARCH = 10, 508 DO_SEARCH = 11, 509 NEXT_RESULT = 12, 510 MULTI_RESULT = 13, 511 PROCESS_RESULT = 14, 512 END_PROCESS_RESULT = 15, 513 END_RESULT = 16, 514 NEXT_REFERRAL = 17, 515 GET_REFERRAL_SESSION = 18, 516 ERROR = 19, 517 LDAP_ERROR = 20 518 } ns_state_t; 519 520 /* 521 * this enum lists the various states of the write state machine 522 */ 523 typedef enum { 524 W_INIT = 1, 525 W_EXIT = 2, 526 GET_CONNECTION = 3, 527 SELECT_OPERATION_SYNC = 4, 528 SELECT_OPERATION_ASYNC = 5, 529 DO_ADD_SYNC = 6, 530 DO_DELETE_SYNC = 7, 531 DO_MODIFY_SYNC = 8, 532 DO_ADD_ASYNC = 9, 533 DO_DELETE_ASYNC = 10, 534 DO_MODIFY_ASYNC = 11, 535 GET_RESULT_SYNC = 12, 536 GET_RESULT_ASYNC = 13, 537 PARSE_RESULT = 14, 538 GET_REFERRAL_CONNECTION = 15, 539 W_LDAP_ERROR = 16, 540 W_ERROR = 17 541 } ns_write_state_t; 542 543 544 typedef int ConnectionID; 545 546 /* 547 * This structure is used by ns_connect to create and manage 548 * one or more ldap connections within the library. 549 */ 550 typedef struct connection { 551 ConnectionID connectionId; 552 boolean_t usedBit; 553 char *serverAddr; 554 ns_cred_t *auth; 555 LDAP *ld; 556 thread_t threadID; /* thread ID using it */ 557 struct ns_ldap_cookie *cookieInfo; 558 char **controls; /* from server_info */ 559 char **saslMechanisms; /* from server_info */ 560 } Connection; 561 562 #define ONE_STEP 1 563 564 /* 565 * This structure is for referrals processing. 566 * The data are from referral URLs returned by 567 * LDAP servers 568 */ 569 typedef struct ns_referral_info { 570 struct ns_referral_info *next; 571 char *refHost; 572 int refScope; 573 char *refDN; 574 char *refFilter; 575 } ns_referral_info_t; 576 577 /* 578 * This structure used internally in searches 579 */ 580 581 typedef struct ns_ldap_cookie { 582 /* INPUTS */ 583 /* server list position */ 584 585 /* service search descriptor list & position */ 586 ns_ldap_search_desc_t **sdlist; 587 ns_ldap_search_desc_t **sdpos; 588 589 /* search filter callback */ 590 int use_filtercb; 591 int (*init_filter_cb)(const ns_ldap_search_desc_t *desc, 592 char **realfilter, const void *userdata); 593 594 /* user callback */ 595 int use_usercb; 596 int (*callback)(const ns_ldap_entry_t *entry, 597 const void *userdata); 598 const void *userdata; 599 600 int followRef; 601 int use_paging; 602 char *service; 603 char *i_filter; 604 const char * const *i_attr; 605 const ns_cred_t *i_auth; 606 int i_flags; 607 608 /* OUTPUTS */ 609 ns_ldap_result_t *result; 610 ns_ldap_entry_t *nextEntry; 611 /* Error data */ 612 int err_rc; 613 ns_ldap_error_t *errorp; 614 615 /* PRIVATE */ 616 ns_state_t state; 617 ns_state_t new_state; 618 ns_state_t next_state; 619 620 Connection *conn; 621 ConnectionID connectionId; 622 623 /* paging VLV/SIMPLEPAGE data */ 624 int listType; 625 unsigned long index; 626 LDAPControl **p_serverctrls; 627 628 int scope; 629 char *basedn; 630 char *filter; 631 char **attribute; 632 633 /* RESULT PROCESSING */ 634 int msgId; 635 LDAPMessage *resultMsg; 636 637 char **dns; 638 char *currentdn; 639 int flag; 640 struct berval *ctrlCookie; 641 642 /* REFERRALS PROCESSING */ 643 /* referralinfo list & position */ 644 ns_referral_info_t *reflist; 645 ns_referral_info_t *refpos; 646 /* search timeout value */ 647 struct timeval search_timeout; 648 } ns_ldap_cookie_t; 649 650 /* 651 * This structure is part of the return value information for 652 * __s_api_requestServer. The routine that requests a new server 653 * from the cache manager 654 */ 655 typedef struct ns_server_info { 656 char *server; 657 char **controls; 658 char **saslMechanisms; 659 } ns_server_info_t; 660 661 /* 662 * INTERNAL GLOBAL DEFINITIONS AND FUNCTION DECLARATIONS 663 */ 664 665 #ifdef DEBUG 666 extern int __ldap_debug_file; 667 extern int __ldap_debug_api; 668 extern int __ldap_debug_ldap; 669 extern int __ldap_debug_servers; 670 #endif 671 672 /* internal connection APIs */ 673 void DropConnection(ConnectionID, int); 674 int __s_api_getServers(char *** servers, ns_ldap_error_t ** error); 675 676 int __s_get_enum_value(ns_config_t *ptr, char *value, ParamIndexType i); 677 char *__s_get_auth_name(ns_config_t *ptr, AuthType_t type); 678 char *__s_get_security_name(ns_config_t *ptr, TlsType_t type); 679 char *__s_get_scope_name(ns_config_t *ptr, ScopeType_t type); 680 char *__s_get_pref_name(PrefOnly_t type); 681 char *__s_get_searchref_name(ns_config_t *ptr, SearchRef_t type); 682 char *__s_get_hostcertpath(void); 683 684 685 /* ************ internal sldap-api functions *********** */ 686 void __ns_ldap_freeEntry(ns_ldap_entry_t *ep); 687 void __s_api_split_key_value(char *buffer, char **name, char **value); 688 int __s_api_printResult(ns_ldap_result_t *); 689 int __s_api_getSearchScope(int *, ns_ldap_error_t **); 690 int __s_api_getDNs(char ***, const char *, 691 ns_ldap_error_t **); 692 int __s_api_get_search_DNs_v1(char ***, const char *, 693 ns_ldap_error_t **); 694 int __s_api_getConnection(const char *, const int, 695 const ns_cred_t *, int *, 696 Connection **, ns_ldap_error_t **, int); 697 char **__s_api_cp2dArray(char **); 698 void __s_api_free2dArray(char **); 699 700 int __s_api_isCtrlSupported(Connection *, char *); 701 ns_config_t *__ns_ldap_make_config(ns_ldap_result_t *result); 702 ns_auth_t *__s_api_AuthEnumtoStruct(const EnumAuthType_t i); 703 char *dvalue(char *); 704 char *evalue(char *); 705 706 extern void get_environment(); 707 708 /* internal Param APIs */ 709 int __ns_ldap_setParamValue(ns_config_t *ptr, 710 const ParamIndexType type, 711 const void *data, ns_ldap_error_t **error); 712 int __s_api_get_type(const char *value, ParamIndexType *type); 713 int __s_api_get_versiontype(ns_config_t *ptr, char *value, 714 ParamIndexType *type); 715 int __s_api_get_profiletype(char *value, ParamIndexType *type); 716 void __s_api_init_config(ns_config_t *ptr); 717 ns_parse_status __s_api_crosscheck(ns_config_t *domainptr, char *errstr, 718 int check_dn); 719 ns_config_t *__s_api_create_config(void); 720 ns_config_t *__s_api_get_default_config(void); 721 ns_config_t *__s_api_loadrefresh_config(); 722 void __s_api_destroy_config(ns_config_t *ptr); 723 int __s_api_get_configtype(ParamIndexType type); 724 const char *__s_api_get_configname(ParamIndexType type); 725 char *__s_api_strValue(ns_config_t *ptr, char *str, 726 int bufsz, ParamIndexType i, 727 ns_strfmt_t fmt); 728 void __s_api_release_config(ns_config_t *cfg); 729 730 /* internal attribute/objectclass mapping api's */ 731 int __s_api_add_map2hash(ns_config_t *config, 732 ns_hashtype_t type, ns_mapping_t *map); 733 void __s_api_destroy_hash(ns_config_t *config); 734 int __s_api_parse_map(char *cp, char **sid, 735 char **origA, char ***mapA); 736 char **__ns_ldap_mapAttributeList(const char *service, 737 const char * const *origAttrList); 738 739 /* internal configuration APIs */ 740 void __ns_ldap_setServer(int set); 741 ns_ldap_error_t *__ns_ldap_LoadConfiguration(); 742 ns_ldap_error_t *__ns_ldap_LoadDoorInfo(LineBuf *configinfo, char *domainname); 743 ns_ldap_error_t *__ns_ldap_DumpConfiguration(char *filename); 744 ns_ldap_error_t *__ns_ldap_DumpLdif(char *filename); 745 int __ns_ldap_cache_ping(); 746 747 /* internal un-exposed APIs */ 748 ns_cred_t *__ns_ldap_dupAuth(const ns_cred_t *authp); 749 int __s_api_get_SSD_from_SSDtoUse_service(const char *service, 750 ns_ldap_search_desc_t ***SSDlist, 751 ns_ldap_error_t **errorp); 752 int __s_api_prepend_automountmapname(const char *service, 753 ns_ldap_search_desc_t ***SSDlist, 754 ns_ldap_error_t ** errorp); 755 int __s_api_prepend_automountmapname_to_dn(const char *service, 756 char **basedn, 757 ns_ldap_error_t ** errorp); 758 int __s_api_convert_automountmapname(const char *service, 759 char **dn, ns_ldap_error_t ** errorp); 760 int __s_api_replace_mapped_attr_in_dn( 761 const char *orig_attr, const char *mapped_attr, 762 const char *dn, char **new_dn); 763 int __s_api_append_default_basedn( 764 const char *dn, 765 char **new_dn, 766 int *allocated, 767 ns_ldap_error_t ** errorp); 768 void __s_api_removeServer(const char *server); 769 770 /* internal referrals APIs */ 771 int __s_api_toFollowReferrals(const int flags, 772 int *toFollow, 773 ns_ldap_error_t **errorp); 774 int __s_api_addRefInfo(ns_referral_info_t **head, 775 char *url, char *baseDN, int *scope, 776 char *filter, LDAP *ld); 777 void __s_api_deleteRefInfo(ns_referral_info_t *head); 778 779 /* callback routine for SSD filters */ 780 int __s_api_merge_SSD_filter(const ns_ldap_search_desc_t *desc, 781 char **realfilter, 782 const void *userdata); 783 784 /* network address verification api */ 785 int __s_api_isipv4(char *addr); 786 int __s_api_isipv6(char *addr); 787 int __s_api_ishost(char *addr); 788 789 /* password management routine */ 790 ns_ldap_passwd_status_t 791 __s_api_set_passwd_status(int errnum, char *errmsg); 792 int __s_api_contain_passwd_control_oid(char **oids); 793 794 /* RFC 2307 section 5.6. Get a canonical name from entry */ 795 char *__s_api_get_canonical_name(ns_ldap_entry_t *entry, 796 ns_ldap_attr_t *attrptr, int case_ignore); 797 798 #ifdef __cplusplus 799 } 800 #endif 801 802 #endif /* _NS_INTERNAL_H */ 803