mirror/openldap
2
0
Fork 0
mirror of https://git.openldap.org/openldap/openldap.git synced 2024-12-21 03:10:25 +08:00
Code Issues Packages Projects Releases Wiki Activity

Comment out rebind stuff until someone has a chance to

Browse Source 
rewrite it.
This commit is contained in:
Kurt Zeilenga 2001-06-11 20:25:02 +00:00
parent c0ce193879
commit 9969deb348
1 changed files with 39 additions and 39 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

78
doc/man/man3/ldap_bind.3
View File

@ -3,7 +3,7 @@
.\" Copyright 1998-2000 The OpenLDAP Foundation All Rights Reserved. .\" Copyright 1998-2000 The OpenLDAP Foundation All Rights Reserved.
.\" Copying restrictions apply. See COPYRIGHT/LICENSE. .\" Copying restrictions apply. See COPYRIGHT/LICENSE.
.SH NAME .SH NAME
ldap_bind, ldap_bind_s, ldap_simple_bind, ldap_simple_bind_s, ldap_kerberos_bind_s, ldap_kerberos_bind1, ldap_kerberos_bind1_s, ldap_kerberos_bind2, ldap_kerberos_bind2_s, ldap_unbind, ldap_unbind_s, ldap_set_rebind_proc \- LDAP bind routines ldap_bind, ldap_bind_s, ldap_simple_bind, ldap_simple_bind_s, ldap_kerberos_bind_s, ldap_kerberos_bind1, ldap_kerberos_bind1_s, ldap_kerberos_bind2, ldap_kerberos_bind2_s, ldap_unbind, ldap_unbind_s \- LDAP bind routines
.SH SYNOPSIS .SH SYNOPSIS
.nf .nf
.ft B .ft B
@ -74,12 +74,12 @@ LDAP *ld;
int ldap_unbind_s(ld) int ldap_unbind_s(ld)
.ft .ft
LDAP *ld; LDAP *ld;
.LP .\" .LP
.ft B .\" .ft B
void ldap_set_rebind_proc( ld, rebindproc ) .\" void ldap_set_rebind_proc( ld, rebindproc )
.ft .\" .ft
LDAP *ld; .\" LDAP *ld;
int (*rebindproc)(); .\" int (*rebindproc)();
.SH DESCRIPTION .SH DESCRIPTION
.LP .LP
These routines provide various interfaces to the LDAP bind operation. These routines provide various interfaces to the LDAP bind operation.
@ -154,38 +154,38 @@ The
call is just another name for call is just another name for
.BR ldap_unbind() ; .BR ldap_unbind() ;
both of these calls are synchronous in nature. both of these calls are synchronous in nature.
.SH RE-BINDING WHILE FOLLOWING REFERRALS .\" .SH RE-BINDING WHILE FOLLOWING REFERRALS
The .\" The
.B ldap_set_rebind_proc() .\" .B ldap_set_rebind_proc()
call is used to set a routine that will be called back to obtain bind .\" call is used to set a routine that will be called back to obtain bind
credentials used when a new server is contacted during the following of .\" credentials used when a new server is contacted during the following of
an LDAP referral. Note that this function is only available when the .\" an LDAP referral. Note that this function is only available when the
LDAP libraries are compiled with LDAP_REFERRALS defined and is only .\" LDAP libraries are compiled with LDAP_REFERRALS defined and is only
used when the ld_options field in the LDAP structure has .\" used when the ld_options field in the LDAP structure has
LDAP_OPT_REFERRALS set (this is the default). If .\" LDAP_OPT_REFERRALS set (this is the default). If
.B ldap_set_rebind_proc() .\" .B ldap_set_rebind_proc()
is never called, or if it is called with a NULL \fIrebindproc\fP .\" is never called, or if it is called with a NULL \fIrebindproc\fP
parameter, an unauthenticated simple LDAP bind will always be done .\" parameter, an unauthenticated simple LDAP bind will always be done
when chasing referrals. .\" when chasing referrals.
.LP .\" .LP
\fIrebindproc\fP should be a function that is declared like this: .\" \fIrebindproc\fP should be a function that is declared like this:
.LP .\" .LP
.nf .\" .nf
int rebindproc( LDAP *ld, char **whop, char **credp, .\" int rebindproc( LDAP *ld, char **whop, char **credp,
int *methodp, int freeit ); .\" int *methodp, int freeit );
.fi .\" .fi
.LP .\" .LP
The LDAP library will first call the rebindproc to obtain the .\" The LDAP library will first call the rebindproc to obtain the
referral bind credentials, and the \fIfreeit\fP parameter will be .\" referral bind credentials, and the \fIfreeit\fP parameter will be
zero. The \fIwhop\fP, \fIcredp\fP, and \fImethodp\fP should be .\" zero. The \fIwhop\fP, \fIcredp\fP, and \fImethodp\fP should be
set as appropriate. If the rebindproc returns LDAP_SUCCESS, referral .\" set as appropriate. If the rebindproc returns LDAP_SUCCESS, referral
processing continues, and the rebindproc will be called a second .\" processing continues, and the rebindproc will be called a second
time with \fIfreeit\fP non-zero to give your application a chance to .\" time with \fIfreeit\fP non-zero to give your application a chance to
free any memory allocated in the previous call. .\" free any memory allocated in the previous call.
.LP .\" .LP
If anything but LDAP_SUCCESS is returned by the first call to .\" If anything but LDAP_SUCCESS is returned by the first call to
the rebindproc, then referral processing is stopped and that error code .\" the rebindproc, then referral processing is stopped and that error code
is returned for the original LDAP operation. .\" is returned for the original LDAP operation.
.SH ERRORS .SH ERRORS
Asynchronous routines will return -1 in case of error, setting the Asynchronous routines will return -1 in case of error, setting the
\fIld_errno\fP parameter of the \fIld\fP structure. Synchronous \fIld_errno\fP parameter of the \fIld\fP structure. Synchronous