ldapmodrdn - LDAP rename entry tool


   ldapmodrdn  [-V[V]]  [-d debuglevel]  [-n]  [-v]  [-r] [-s newsup] [-c]
   [-f file] [-M[M]] [-x]  [-D binddn]  [-W]  [-w passwd]  [-y passwdfile]
   [-H ldapuri]        [-h ldaphost]        [-p ldapport]       [-P {2|3}]
   [-e [!]ext[=extparam]]    [-E [!]ext[=extparam]]    [-o opt[=optparam]]
   [-O security-properties]   [-I]   [-Q]   [-N]  [-U authcid]  [-R realm]
   [-X authzid] [-Y mech] [-Z[Z]] [dn rdn]


   ldapmodrdn  is  a  shell-accessible  interface  to  the  ldap_rename(3)
   library call.

   ldapmodrdn  opens  a  connection to an LDAP server, binds, and modifies
   the RDN of entries.  The entry information is read from standard input,
   from  file  through  the use of the -f option, or from the command-line
   pair dn and rdn.


   -V[V]  Print  version  info.   If  -VV  is  given,  only  the   version
          information is printed.

   -d debuglevel
          Set  the LDAP debugging level to debuglevel.  ldapmodrdn must be
          compiled with LDAP_DEBUG defined for this  option  to  have  any

   -n     Show  what  would  be  done,  but don't actually change entries.
          Useful for debugging in conjunction with -v.

   -v     Use verbose mode, with  many  diagnostics  written  to  standard

   -r     Remove  old  RDN  values from the entry.  Default is to keep old

   -s newsup
          Specify a new superior entry. (I.e., move the target  entry  and
          make  it  a  child  of  the  new  superior.)  This option is not
          supported in LDAPv2.

   -c     Continuous  operation  mode.   Errors    are    reported,    but
          ldapmodrdn will  continue  with  modifications.   The default is
          to exit after reporting an error.

   -f file
          Read the entry modification information  from  file  instead  of
          from standard input or the command-line.

   -M[M]  Enable manage DSA IT control.  -MM makes control critical.

   -x     Use simple authentication instead of SASL.

   -D binddn
          Use the Distinguished Name binddn to bind to the LDAP directory.
          For SASL binds, the server is expected to ignore this value.

   -W     Prompt for simple  authentication.   This  is  used  instead  of
          specifying the password on the command line.

   -w passwd
          Use passwd as the password for simple authentication.

   -y passwdfile
          Use  complete  contents of passwdfile as the password for simple

   -H ldapuri
          Specify  URI(s)  referring  to  the  ldap  server(s);  only  the
          protocol/host/port  fields are allowed; a list of URI, separated
          by whitespace or commas is expected.

   -h ldaphost
          Specify an alternate host on which the ldap server  is  running.
          Deprecated in favor of -H.

   -p ldapport
          Specify   an  alternate  TCP  port  where  the  ldap  server  is
          listening.  Deprecated in favor of -H.

   -P {2|3}
          Specify the LDAP protocol version to use.

   -e [!]ext[=extparam]

   -E [!]ext[=extparam]

          Specify general extensions with -e and  modrdn  extensions  with
          -E.  ! indicates criticality.

          General extensions:
            [!]assert=<filter>    (an RFC 4515 Filter)
            !authzid=<authzid>    ("dn:<dn>" or "u:<user>")
            [!]bauthzid           (RFC 3829 authzid control)
            [!]postread[=<attrs>] (a comma-separated attribute list)
            [!]preread[=<attrs>]  (a comma-separated attribute list)
            abandon,cancel,ignore (SIGINT sends abandon/cancel,
            or ignores response; if critical, doesn't wait for SIGINT.
            not really controls)

          Modrdn extensions:

   -o opt[=optparam]

          Specify general options.

          General options:
            nettimeout=<timeout>  (in seconds, or "none" or "max")
            ldif-wrap=<width>     (in columns, or "no" for no wrapping)

   -O security-properties
          Specify SASL security properties.

   -I     Enable  SASL  Interactive  mode.   Always prompt.  Default is to
          prompt only as needed.

   -Q     Enable SASL Quiet mode.  Never prompt.

   -N     Do not use reverse DNS to canonicalize SASL host name.

   -U authcid
          Specify the authentication ID for SASL bind. The form of the  ID
          depends on the actual SASL mechanism used.

   -R realm
          Specify  the  realm of authentication ID for SASL bind. The form
          of the realm depends on the actual SASL mechanism used.

   -X authzid
          Specify the requested authorization ID for SASL  bind.   authzid
          must be one of the following formats: dn:<distinguished name> or

   -Y mech
          Specify the SASL mechanism to be  used  for  authentication.  If
          it's  not  specified, the program will choose the best mechanism
          the server knows.

   -Z[Z]  Issue StartTLS (Transport Layer Security) extended operation. If
          you  use  -ZZ,  the  command  will  require  the operation to be


   If the command-line arguments dn and rdn are given,  rdn  will  replace
   the RDN of the entry specified by the DN, dn.

   Otherwise,  the  contents  of  file (or standard input if no -f flag is
   given) should consist of one or more entries.

       Distinguished Name (DN)
       Relative Distinguished Name (RDN)

   One or more blank lines may be used to separate each DN/RDN pair.


   Assuming that the file /tmp/entrymods exists and has the contents:

       cn=Modify Me,dc=example,dc=com
       cn=The New Me

   the command:

       ldapmodrdn -r -f /tmp/entrymods

   will change the RDN of the "Modify Me" entry from "Modify Me"  to  "The
   New Me" and the old cn, "Modify Me" will be removed.


   Exit  status is 0 if no errors occur.  Errors result in a non-zero exit
   status and a diagnostic message being written to standard error.


   ldapadd(1), ldapdelete(1), ldapmodify(1), ldapsearch(1),  ldap.conf(5),
   ldap(3), ldap_rename(3)


   The OpenLDAP Project <http://www.openldap.org/>


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

More Linux Commands

gapplication(1) DBus application launcher - Linux man page
gapplication is a commandline implementation of the client-side of the org.freedesktop.Application interface as specified by the freedesktop.org Desktop Entry S

gnutls_x509_crl_init(3) - API function - Linux manual page
This function will initialize a CRL structure. CRL stands for Certificate Revocation List. A revocation list usually contains lists of certificate serial number

base64(1) - base64 encode/decode data and print to standard
Base64 encode or decode FILE, or standard input, to standard output. Mandatory arguments to long options are mandatory for short options too. -d, --decode decod

vmsish(3pm) - Perl pragma to control VMS-specific language f
If no import list is supplied, all possible VMS-specific features are assumed. Currently, there are four VMS-specific features available: status (a.k.a $?), exi

ftrylockfile(3) - lock FILE for stdio - Linux manual page...
ftrylockfile.3 - The stdio functions are thread-safe. This is achieved by assigning to each FILE object a lockcount and (if the lockcount is nonzero) an owning

XpGetContext(3x) - Gets the current print context-id for a d
XpGetContext returns the id of the current print context associated with display. If a print context has not been set, a value of None is returned. XpGetContext

Apache::SizeLimit(3pm) - Because size does matter. (ManPage)
******************************** NOIICE ******************* This version is only for httpd 1.3.x and mod_perl 1.x series. For httpd 2.x / mod_perl 2.x Apache2::

refer(1) - preprocess bibliographic references for groff....
This file documents the GNU version of refer, which is part of the groff document formatting system. refer copies the contents of filename... to the standard ou

Tk_3DHorizontalBevel(3) - draw borders with three-dimensiona
These procedures provide facilities for drawing window borders in a way that produces a three-dimensional appearance. Tk_Alloc3DBorderFromObj allocates colors a

scanw(3ncurses) - convert formatted input from a curses wind
The scanw, wscanw and mvscanw routines are analogous to scanf [see scanf(3)]. The effect of these routines is as though wgetstr were called on the window, and t

svcerr_progvers(3) - library routines for remote procedure c
These routines allow C programs to make procedure calls on other machines across the network. First, the client calls a procedure to send a data packet to the s

openpty(3) - tty utility functions - Linux manual page......
The openpty() function finds an available pseudoterminal and returns file descriptors for the master and slave in amaster and aslave. If name is not NULL, the f

We can't live, work or learn in freedom unless the software we use is free.