Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
LDAP_DELETE(3)		   Library Functions Manual		LDAP_DELETE(3)

NAME
       ldap_delete,  ldap_delete_s,  ldap_delete_ext, ldap_delete_ext_s	- Per-
       form an LDAP delete operation.

LIBRARY
       OpenLDAP	LDAP (libldap, -lldap)

SYNOPSIS
       #include	<ldap.h>

       int ldap_delete_s(ld, dn)
       LDAP *ld;
       char *dn;

       int ldap_delete(ld, dn)
       LDAP *ld;
       char *dn;

       int ldap_delete_ext(ld, dn, serverctrls,	clientctrls, msgidp)
       LDAP *ld;
       char *dn;
       LDAPControl **serverctrls, **clientctrls;
       int *msgidp;

       int ldap_delete_ext_s(ld, dn, serverctrls, clientctrls)
       LDAP *ld;
       char *dn;
       LDAPControl **serverctrls, **clientctrls;

DESCRIPTION
       The ldap_delete_s() routine is used to perform an LDAP delete operation
       synchronously. It takes dn, the DN of the entry to be deleted.  It  re-
       turns  an LDAP error code, indicating the success or failure of the op-
       eration.

       The ldap_delete() routine is used to perform an LDAP  delete  operation
       asynchronously.	It  takes  the same parameters as ldap_delete_s(), but
       returns the message id of the request it	initiated. The result  of  the
       delete can be obtained by a subsequent call to ldap_result(3).

       The  ldap_delete_ext()  routine	allows	server	and client controls to
       be specified to extend the delete request. This routine is asynchronous
       like ldap_delete(), but its return value	is  an	LDAP  error  code.  It
       stores  the  message id of the request in the integer pointed to	by ms-
       gidp.

       The  ldap_delete_ext_s()	 routine  is  the   synchronous	  version   of
       ldap_delete_ext().   It also returns an LDAP error code indicating suc-
       cess or failure of the operation.

ERRORS
       ldap_delete_s() returns an LDAP error code which	can be interpreted  by
       calling one of ldap_perror(3) and friends.  ldap_delete() returns -1 if
       something  went	wrong initiating the request. It returns the non-nega-
       tive message id of the request if things	went ok.

       ldap_delete_ext() and ldap_delete_ext_s() return	some Non-zero value if
       something  went wrong initiating	the request, else return 0.

SEE ALSO
       ldap(3),	ldap_error(3)

ACKNOWLEDGEMENTS
       OpenLDAP	Software is developed and maintained by	The  OpenLDAP  Project
       <http://www.openldap.org/>.  OpenLDAP Software is derived from the Uni-
       versity of Michigan LDAP	3.3 Release.

OpenLDAP 2.6.9			  2024/11/26			LDAP_DELETE(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=ldap_delete_ext_s&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>

home | help