Penguin
Recent Changes
Blame: ldapmodrdn(1)
EditPageHistoryDiffInfoLikePages
Annotated edit history of ldapmodrdn(1) version 2, including all changes. View license author blame.
Rev Author # Line
1 perry 1 LDAPMODRDN
2 !!!LDAPMODRDN
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 OPTIONS
7 INPUT FORMAT
8 EXAMPLE
9 DIAGNOSTICS
10 SEE ALSO
11 BUGS
12 AUTHOR
13 ACKNOWLEDGEMENTS
14 ----
15 !!NAME
16
17
18 ldapmodrdn - LDAP rename entry tool
19 !!SYNOPSIS
20
21
22 __ldapmodrdn__ [[__-r__] [[__-n__] [[__-v__]
23 [[__-k__] [[__-K__] [[__-c__] [[__-M[[M]__]
24 [[__-d__ ''debuglevel''] [[__-D__ ''binddn'']
25 [[__-W__] [[__-w__ ''passwd''] [[__-H__
26 ''ldapuri''] [[__-h__ ''ldaphost''] [[__-p__
27 ''ldapport''] [[__-P__ ''2''|''3''] [[__-O__
28 security-properties__]__ [[__-I__] [[__-Q__]
29 [[__-U__ ''authcid''] [[__-x__] [[__-X__
30 ''authzid''] [[__-Y__ ''mech''] [[__-Z[[Z]__]
31 [[__-f__ ''file''] [[''dn rdn'']
32 !!DESCRIPTION
33
34
35 __ldapmodrdn__ is a shell-accessible interface to the
2 perry 36 ldap_modrdn2(3) library call.
1 perry 37
38
39 __ldapmodrdn__ opens a connection to an LDAP server,
40 binds, and modifies the RDN of entries. The entry
41 information is read from standard input, from ''file''
42 through the use of the -''f'' option, or from the
43 command-line pair ''dn'' and ''rdn''.
44 !!OPTIONS
45
46
47 __-r__
48
49
50 Remove old RDN values from the entry. Default is to keep old
51 values.
52
53
54 __-n__
55
56
57 Show what would be done, but don't actually change entries.
58 Useful for debugging in conjunction with -v.
59
60
61 __-v__
62
63
64 Use verbose mode, with many diagnostics written to standard
65 output.
66
67
68 __-k__
69
70
71 Use Kerberos IV authentication instead of simple
72 authentication. It is assumed that you already have a valid
73 ticket granting ticket. __ldapmodrdn__ must be compiled
74 with Kerberos support for this option to have
75 effect.
76
77
78 __-K__
79
80
81 Same as -k, but only does step 1 of the Kerberos IV bind.
82 This is useful when connecting to a slapd and there is no
83 x500dsa.hostname principal registered with your Kerberos
84 Domain Controller(s).
85
86
87 __-c__
88
89
90 Continuous operation mode. Errors are reported, but
91 ldapmodify will continue with modifications. The default is
92 to exit after reporting an error.
93
94
95 __-M[[M]__
96
97
98 Enable manage DSA IT control. __-MM__ makes control
99 critical.
100
101
102 __-d debuglevel__
103
104
105 Set the LDAP debugging level to ''debuglevel''.
106 __ldapmodrdn__ must be compiled with LDAP_DEBUG defined
107 for this option to have any effect.
108
109
110 __-f file__
111
112
113 Read the entry modification information from ''file''
114 instead of from standard input or the
115 command-line.
116
117
118 __-x__
119
120
121 Use simple authentication instead of SASL.
122
123
124 __-D binddn__
125
126
127 Use the Distinguished Name ''binddn'' to bind to the LDAP
128 directory.
129
130
131 __-W__
132
133
134 Prompt for simple authentication. This is used instead of
135 specifying the password on the command line.
136
137
138 __-w passwd__
139
140
141 Use ''passwd'' as the password for simple
142 authentication.
143
144
145 __-H__ ''ldapuri''
146
147
148 Specify URI(s) referring to the ldap server(s).
149
150
151 __-h__ ''ldaphost''
152
153
154 Specify an alternate host on which the ldap server is
155 running. Deprecated in favor of -H.
156
157
158 __-p__ ''ldapport''
159
160
161 Specify an alternate TCP port where the ldap server is
162 listening. Deprecated in favor of -H.
163
164
165 __-P__ ''2''|''3''
166
167
168 Specify the LDAP protocol version to use.
169
170
171 __-O__ ''security-properties''
172
173
174 Specify SASL security properties.
175
176
177 __-I__
178
179
180 Enable SASL Interactive mode. Always prompt. Default is to
181 prompt only as needed.
182
183
184 __-Q__
185
186
187 Enable SASL Quiet mode. Never prompt.
188
189
190 __-U__ ''authcid''
191
192
193 Specify the authentication ID for SASL bind. The form of the
194 ID depends on the actual SASL mechanism used.
195
196
197 __-X__ ''authzid''
198
199
200 Specify the requested authorization ID for SASL bind.
201 ''authzid'' must be one of the following formats:
202 __dn:__'''' or
203 __u:__''''
204
205
206 __-Y__ ''mech''
207
208
209 Specify the SASL mechanism to be used for authentication. If
210 it's not specified, the program will choose the best
211 mechanism the server knows.
212
213
214 __-Z[[Z]__
215
216
217 Issue StartTLS (Transport Layer Security) extended
218 operation. If you use __-ZZ__, the command will require
219 the operation to be successful.
220 !!INPUT FORMAT
221
222
223 If the command-line arguments ''dn'' and ''rdn'' are
224 given, ''rdn'' will replace the RDN of the entry
225 specified by the DN, ''dn''.
226
227
228 Otherwise, the contents of ''file'' (or standard input if
229 no -''f'' flag is given) should consist of one or more
230 entries.
231
232
233 Distinguished Name (DN)
234 Relative Distinguished Name (RDN)
235 One or more blank lines may be used to separate each DN/RDN pair.
236 !!EXAMPLE
237
238
239 Assuming that the file __/tmp/entrymods__ exists and has
240 the contents:
241
242
243 cn=Modify Me, dc=example, dc=com
244 cn=The New Me
245 the command:
246
247
248 ldapmodify -r -f /tmp/entrymods
249 will change the RDN of the
250 !!DIAGNOSTICS
251
252
253 Exit status is 0 if no errors occur. Errors result in a
254 non-zero exit status and a diagnostic message being written
255 to standard error.
256 !!SEE ALSO
257
258
259 ldapadd(1), ldapdelete(1),
260 ldapmodify(1), ldapsearch(1),
2 perry 261 ldap.conf(5), ldap(3),
262 ldap_modrdn2(3)
1 perry 263 !!BUGS
264
265
266 There is no interactive mode, but there probably should
267 be.
268 !!AUTHOR
269
270
271 The OpenLDAP Project
272 !!ACKNOWLEDGEMENTS
273
274
275 __OpenLDAP__ is developed and maintained by The OpenLDAP
276 Project (http://www.openldap.org/). __OpenLDAP__ is
277 derived from University of Michigan LDAP 3.3
278 Release.
279 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.