search..
No manual entry for -- in section 3
LDAP_DELETE(3)		    Library Functions Manual		 LDAP_DELETE(3)

NAME
       ldap_delete, ldap_delete_s, ldap_delete_ext, ldap_delete_ext_s - Perform
       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 oper-
       ation.

       The  ldap_delete()  routine  is used to perform an LDAP delete operation
       asynchronously. It takes the same parameters as ldap_delete_s(), but re-
       turns 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-negative
       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.10+dfsg-1		   2025/05/22			 LDAP_DELETE(3)