Manual Pages for UNIX Operating System command usage for man ldap_add

LDAP Library Functions                            ldap_add(3LDAP)



NAME
     ldap_add, ldap_add_s, ldap_add_ext, ldap_add_ext_s - perform
     an LDAP add operation

SYNOPSIS
     cc[ flag... ] file... -lldap[ library... ]
     #include 
     #include 

     intldap_add(LDAP *ld, char *dn, LDAPMod *attrs[]);


     intldap_add_s(LDAP *ld, char *dn, LDAPMod *attrs[]);


     int ldap_add_ext(LDAP *ld, char *dn, LDAPMod **attrs,
          LDAPControl **serverctrls, int * msgidp);


     int ldap_add_ext_s(LDAP *ld, char *dn, LDAPMod **attrs,
          LDAPControl **serverctrls, LDAPControl **clientctrls);


DESCRIPTION
     The ldap_add_s() function 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(3LDAP),  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 com-
     ponent  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(3LDAP) for more details.


     The ldap_add() function 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(3LDAP).


     The  ldap_add_ext() function initiates an  asynchronous  add
     operation and  returns  LDAP_SUCCESS if the request was suc-
     cessfully sent to the server,  or else  it  returns  a  LDAP
     error  code  if not (see  ldap_error(3LDAP)). If successful,
     ldap_add_ext() places the message id of  *msgidp.  A  subse-
     quent  call  to   ldap_result(),  can  be used to obtain the



SunOS 5.11          Last change: 27 Jan 2002                    1






LDAP Library Functions                            ldap_add(3LDAP)



     result of the  add request.


     The  ldap_add_ext_s() function initiates a  synchronous  add
     operation and returns the result of the operation itself.

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.

ATTRIBUTES
     See attributes(5) for a description of the following  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    | Availability                | system/library (32-bit)     |
    |                             | SUNWcslx (64-bit)           |
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|


SEE ALSO
     ldap(3LDAP), ldap_error(3LDAP),  ldap_modify(3LDAP),  attri-
     butes(5)


























SunOS 5.11          Last change: 27 Jan 2002                    2