SEARCH
NEW RPMS
DIRECTORIES
ABOUT
FAQ
VARIOUS
BLOG
DONATE


YUM REPOSITORY

 
 

MAN page from PLD openldap-2.0.27-1.i386.rpm

LDAPMODRDN

Section: User Commands (1)
Updated: 20 August 2001
Index 

NAME

ldapmodrdn - LDAP rename entry tool 

SYNOPSIS

ldapmodrdn[-r][-n][-v][-k][-K][-c][-M[M]][-d debuglevel][-D binddn][-W][-w passwd][-H ldapuri][-h ldaphost][-p ldapport][-P 2|3][-O security-properties][-I][-Q][-U authcid][-x][-X authzid][-Y mech][-Z[Z]][-f file][dn rdn] 

DESCRIPTION

ldapmodrdnis a shell-accessible interface to theldap_modrdn2(3)library call.

ldapmodrdnopens a connection to an LDAP server, binds, and modifies the RDN of entries.The entry information is read from standard input, from file throughthe use of the-foption, or from the command-line pair dn andrdn. 

OPTIONS

-r
Remove old RDN values from the entry. Default is to keep old values.
-n
Show what would be done, but don't actually change entries. Useful fordebugging in conjunction with -v.
-v
Use verbose mode, with many diagnostics written to standard output.
-k
Use Kerberos IV authentication instead of simple authentication. It isassumed that you already have a valid ticket granting ticket.ldapmodrdnmust be compiled with Kerberos support for this option to have effect.
-K
Same as -k, but only does step 1 of the Kerberos IV bind. This is usefulwhen connecting to a slapd and there is no x500dsa.hostname principalregistered with your Kerberos Domain Controller(s).
-c
Continuous operation mode. Errors are reported, but ldapmodifywill continue with modifications. The default is to exit afterreporting an error.
-M[M]
Enable manage DSA IT control.-MMmakes control critical.
-d debuglevel
Set the LDAP debugging level to debuglevel.ldapmodrdnmust becompiled with LDAP_DEBUG defined for this option to have any effect.
-f file
Read the entry modification information from file instead of fromstandard input or the command-line.
-x
Use simple authentication instead of SASL.
-D binddn
Use the Distinguished Name binddn to bind to the LDAP directory.
-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.
-H ldapuri
Specify URI(s) referring to the ldap server(s).
-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.
-O security-properties
Specify SASL security properties.
-I
Enable SASL Interactive mode. Always prompt. Default is to promptonly as needed.
-Q
Enable SASL Quiet mode. Never prompt.
-U authcid
Specify the authentication ID for SASL bind. The form of the IDdepends on the actual SASL mechanism used.
-X authzid
Specify the requested authorization ID for SASL bind.authzidmust be one of the following formats:dn:<distinguished name>oru:<username>
-Y mech
Specify the SASL mechanism to be used for authentication. If it's notspecified, 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 successful.
 

INPUT FORMAT

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

Otherwise, the contents of file (or standard input ifno-fflag 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. 

EXAMPLE

Assuming that the file/tmp/entrymodsexists and has the contents:

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

the command:

    ldapmodify -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.

 

DIAGNOSTICS

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

SEE ALSO

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

BUGS

There is no interactive mode, but there probably should be. 

AUTHOR

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

ACKNOWLEDGEMENTS

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


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
INPUT FORMAT
EXAMPLE
DIAGNOSTICS
SEE ALSO
BUGS
AUTHOR
ACKNOWLEDGEMENTS

This document was created byman2html,using the manual pages.