2002-06-13 11:59:10 +08:00
|
|
|
.TH LDAP_PARSE_REFERENCE 3 "RELEASEDATE" "OpenLDAP LDVERSION"
|
2001-09-26 18:35:54 +08:00
|
|
|
.\" $OpenLDAP$
|
2003-01-04 04:20:47 +08:00
|
|
|
.\" Copyright 1998-2003 The OpenLDAP Foundation All Rights Reserved.
|
2001-09-26 18:35:54 +08:00
|
|
|
.\" Copying restrictions apply. See COPYRIGHT/LICENSE.
|
|
|
|
|
.SH NAME
|
2001-09-27 10:51:22 +08:00
|
|
|
ldap_parse_reference \- Extract referrals and controls from a reference message
|
2002-06-21 15:32:54 +08:00
|
|
|
.SH LIBRARY
|
2002-06-22 05:25:38 +08:00
|
|
|
OpenLDAP LDAP (libldap, -lldap)
|
2001-09-26 18:35:54 +08:00
|
|
|
.SH SYNOPSIS
|
|
|
|
|
.nf
|
|
|
|
|
.ft B
|
|
|
|
|
#include <ldap.h>
|
|
|
|
|
.LP
|
|
|
|
|
.ft B
|
|
|
|
|
int ldap_parse_reference( LDAP *ld, LDAPMessage *reference,
|
|
|
|
|
char ***referralsp, LDAPControl ***serverctrlsp, int freeit )
|
|
|
|
|
.SH DESCRIPTION
|
|
|
|
|
.LP
|
|
|
|
|
The
|
|
|
|
|
.B ldap_parse_reference()
|
|
|
|
|
routine is used to extract referrals and controls from a reference message.
|
|
|
|
|
The \fIreference\fP parameter is a reference message as returned by a
|
|
|
|
|
call to
|
|
|
|
|
.BR ldap_first_reference (3) ,
|
|
|
|
|
.BR ldap_next_reference (3) ,
|
|
|
|
|
.BR ldap_first_message (3) ,
|
2001-09-27 10:51:22 +08:00
|
|
|
.BR ldap_next_message (3) ,
|
2001-09-26 18:35:54 +08:00
|
|
|
or
|
|
|
|
|
.BR ldap_result (3) .
|
|
|
|
|
.LP
|
|
|
|
|
The \fIreferralsp\fP parameter will be filled in with an allocated array of
|
|
|
|
|
character strings. The strings are copies of the referrals contained in
|
|
|
|
|
the parsed message. The array should be freed by calling
|
|
|
|
|
.BR ldap_value_free (3) .
|
|
|
|
|
If \fIreferralsp\fP is NULL, no referrals are returned.
|
|
|
|
|
If no referrals were returned, \fI*referralsp\fP is set to NULL.
|
|
|
|
|
.LP
|
|
|
|
|
The \fIserverctrlsp\fP parameter will be filled in with an allocated array of
|
|
|
|
|
controls copied from the parsed message. The array should be freed by calling
|
2002-12-16 15:31:13 +08:00
|
|
|
.BR ldap_controls_free (3).
|
2001-09-26 18:35:54 +08:00
|
|
|
If \fIserverctrlsp\fP is NULL, no controls are returned.
|
|
|
|
|
If no controls were returned, \fI*serverctrlsp\fP is set to NULL.
|
|
|
|
|
.LP
|
|
|
|
|
The \fIfreeit\fP parameter determines whether the parsed message is
|
|
|
|
|
freed or not after the extraction. Any non-zero value will make it
|
|
|
|
|
free the message. The
|
|
|
|
|
.BR ldap_msgfree (3)
|
|
|
|
|
routine can also be used to free the message later.
|
|
|
|
|
.SH ERRORS
|
|
|
|
|
Upon success LDAP_SUCCESS is returned. Otherwise the values of the
|
|
|
|
|
\fIreferralsp\fP and \fIserverctrlsp\fP parameters are undefined.
|
|
|
|
|
.SH SEE ALSO
|
2001-09-27 10:51:22 +08:00
|
|
|
.BR ldap (3),
|
|
|
|
|
.BR ldap_first_reference (3),
|
|
|
|
|
.BR ldap_first_message (3),
|
|
|
|
|
.BR ldap_result (3),
|
|
|
|
|
.BR ldap_get_values (3),
|
|
|
|
|
.BR ldap_controls_free (3)
|
2001-09-26 18:35:54 +08:00
|
|
|
.SH ACKNOWLEDGEMENTS
|
|
|
|
|
.B OpenLDAP
|
|
|
|
|
is developed and maintained by The OpenLDAP Project (http://www.openldap.org/).
|
|
|
|
|
.B OpenLDAP
|
|
|
|
|
is derived from University of Michigan LDAP 3.3 Release.
|
