Company Innovation Man pages Tech News Developer Mirrors Search
 
LDAP_ADD   (3) manpage
LDAP_ADD
3
2005/01/24
OpenLDAP 2.2.23
  • NAME
      ldap_add, ldap_add_s, ldap_add_ext, ldap_add_ext_s - Perform an LDAP add operation
  • LIBRARY
      OpenLDAP LDAP (libldap, -lldap)
  • SYNOPSIS 
      
 #include <ldap.h>

 int ldap_add(LDAP * ld , const char * dn , LDAPMod * attrs []);


          int ldap_add_s(LDAP * ld , const char * dn , LDAPMod * attrs []); 

          int ldap_add_ext(LDAP * ld , const char * dn , LDAPMod * attrs [], 
          LDAPControl * sctrls [], LDAPControl * cctrls [], int * msgidp );    
        

           int ldap_add_ext_s(LDAP * ld , const char * dn , LDAPMod * attrs [],   
          LDAPControl * sctrls [], LDAPControl * cctrls []);
  • DESCRIPTION
      The
      ldap_add_s() routine is used to perform an LDAP add operation.
      It takes dn, the DN of the entry to add, and attrs, a
      null-terminated array of the entry's attributes.  The LDAPMod structure
      is used to represent attributes, with the mod_type and
      mod_values fields being used as described under
      ldap_modify(3) ,
       and the ldap_op field being used only if you need to specify
      the LDAP_MOD_BVALUES option. Otherwise, it should be set to zero.

      Note that all entries except that
      specified by the last component in the given DN must already exist.
      ldap_add_s() returns an LDAP error code indicating success or failure
      of the operation.  See
      ldap_error(3)
      for more details.

      The
      ldap_add() routine works just like
      ldap_add_s() ,
       but it is asynchronous.  It returns the message id of the request it
      initiated.  The result of this operation can be obtained by calling
      ldap_result(3) .
      The
      ldap_add_ext() routine allows server and client controls to be specified to extend
      the add request. This routine is asynchronous like
      ldap_add() ,
       but its return value is an LDAP error code.  It stores the message id
      of the request in the integer pointed to
      by
      msgidp .
      The
      ldap_add_ext_s() routine is the synchronous version of
      ldap_add_ext() .
       It also returns an LDAP error code indicating success or failure
      of the operation.
  • ERRORS
      ldap_add() returns -1 in case of error initiating the request, and
      will set the ld_errno field in the ld parameter
      to indicate the error.
      ldap_add_s() will return an LDAP error code
      directly (LDAP_SUCCESS if everything went ok, some error otherwise).
      ldap_add_ext() and
      ldap_add_ext_s() also directly return LDAP error codes.
  • SEE ALSO
  • ACKNOWLEDGEMENTS
      OpenLDAP is developed and maintained by The OpenLDAP Project (http://www.openldap.org/).
      OpenLDAP is derived from University of Michigan LDAP 3.3 Release.  
Current Users: 22 © 1999-2006 Linux.com.hk PenguinSoft
All trademarks and copyrights on this page are owned by their respective companies. Linux is a trademark of Linus Torvalds.