NAME
ldapmodrdn - LDAP rename entry tool
SYNOPSIS
ldapmodrdn
[-r]
[-s newsup]
[-n]
[-v]
[-c]
[-M[M]]
[-d debuglevel]
[-D binddn]
[-W]
[-w passwd]
[-y passwdfile]
[-H ldapuri]
[-h ldaphost]
[-p ldapport]
[-P 2|_3]
[-O security-properties]
[-I]
[-Q]
[-U authcid]
[-R realm]
[-x]
[-X authzid]
[-Y mech]
[-Z[Z]]
[-f file]
[dn rdn]
DESCRIPTION
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 _f_i_l_e through
the use of the
option, or from the command-line pair _d_n and
_r_d_n.
OPTIONS
-
-r
-
Remove old RDN values from the entry. Default is to keep old values.
-
-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.
-
-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 output.
-
-c
-
Continuous operation mode. Errors are reported, but ldapmodrdn
will continue with modifications. The default is to exit after
reporting an error.
-
-M[M]
-
Enable manage DSA IT control.
-MM
makes control critical.
-
-d debuglevel
-
Set the LDAP debugging level to _d_e_b_u_g_l_e_v_e_l.
ldapmodrdn
must be
compiled with LDAP_DEBUG defined for this option to have any effect.
-
-f file
-
Read the entry modification information from _f_i_l_e instead of from
standard input or the command-line.
-
-x
-
Use simple authentication instead of SASL.
-
-D binddn
-
Use the Distinguished Name _b_i_n_d_d_n 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 _p_a_s_s_w_d as the password for simple authentication.
-
-y passwdfile
-
Use complete contents of _p_a_s_s_w_d_f_i_l_e as the password for
simple authentication.
-
-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.
-
_<_b_>_-_P_<_/_b_>_<_i_> _2|_3_<_/_i_>
_<_d_d_>
_S_p_e_c_i_f_y _t_h_e _L_D_A_P _p_r_o_t_o_c_o_l _v_e_r_s_i_o_n _t_o _u_s_e_.
_<_d_t_>
_<_b_>_-_O_<_/_b_>_<_i_> _s_e_c_u_r_i_t_y_-_p_r_o_p_e_r_t_i_e_s_<_/_i_>
_<_d_d_>
_S_p_e_c_i_f_y _S_A_S_L _s_e_c_u_r_i_t_y _p_r_o_p_e_r_t_i_e_s_.
_<_d_t_>
_<_b_>_-_I_<_/_b_>
_<_d_d_>
_E_n_a_b_l_e _S_A_S_L _I_n_t_e_r_a_c_t_i_v_e _m_o_d_e_. _A_l_w_a_y_s _p_r_o_m_p_t_. _D_e_f_a_u_l_t _i_s _t_o _p_r_o_m_p_t
_o_n_l_y _a_s _n_e_e_d_e_d_.
_<_d_t_>
_<_b_>_-_Q_<_/_b_>
_<_d_d_>
_E_n_a_b_l_e _S_A_S_L _Q_u_i_e_t _m_o_d_e_. _N_e_v_e_r _p_r_o_m_p_t_.
_<_d_t_>
_<_b_>_-_U_<_/_b_>_<_i_> _a_u_t_h_c_i_d_<_/_i_>
_<_d_d_>
_S_p_e_c_i_f_y _t_h_e _a_u_t_h_e_n_t_i_c_a_t_i_o_n _I_D _f_o_r _S_A_S_L _b_i_n_d_. _T_h_e _f_o_r_m _o_f _t_h_e _I_D
_d_e_p_e_n_d_s _o_n _t_h_e _a_c_t_u_a_l _S_A_S_L _m_e_c_h_a_n_i_s_m _u_s_e_d_.
_<_d_t_>
_<_b_>_-_R_<_/_b_>_<_i_> _r_e_a_l_m_<_/_i_>
_<_d_d_>
_S_p_e_c_i_f_y _t_h_e _r_e_a_l_m _o_f _a_u_t_h_e_n_t_i_c_a_t_i_o_n _I_D _f_o_r _S_A_S_L _b_i_n_d_. _T_h_e _f_o_r_m _o_f _t_h_e _r_e_a_l_m
_d_e_p_e_n_d_s _o_n _t_h_e _a_c_t_u_a_l _S_A_S_L _m_e_c_h_a_n_i_s_m _u_s_e_d_.
_<_d_t_>
_<_b_>_-_X_<_/_b_>_<_i_> _a_u_t_h_z_i_d_<_/_i_>
_<_d_d_>
_S_p_e_c_i_f_y _t_h_e _r_e_q_u_e_s_t_e_d _a_u_t_h_o_r_i_z_a_t_i_o_n _I_D _f_o_r _S_A_S_L _b_i_n_d_.
_<_i_>_a_u_t_h_z_i_d_<_/_i_>
_m_u_s_t _b_e _o_n_e _o_f _t_h_e _f_o_l_l_o_w_i_n_g _f_o_r_m_a_t_s_:
_<_b_>_d_n_:_<_i_>_<_d_i_s_t_i_n_g_u_i_s_h_e_d _n_a_m_e_>_<_/_i_>
_o_r
_<_b_>_u_:_<_i_>_<_u_s_e_r_n_a_m_e_>_<_/_i_>
_<_d_t_>
_<_b_>_-_Y_<_/_b_>_<_i_> _m_e_c_h_<_/_i_>
_<_d_d_>
_S_p_e_c_i_f_y _t_h_e _S_A_S_L _m_e_c_h_a_n_i_s_m _t_o _b_e _u_s_e_d _f_o_r _a_u_t_h_e_n_t_i_c_a_t_i_o_n_. _I_f _i_t_'_s _n_o_t
_s_p_e_c_i_f_i_e_d_, _t_h_e _p_r_o_g_r_a_m _w_i_l_l _c_h_o_o_s_e _t_h_e _b_e_s_t _m_e_c_h_a_n_i_s_m _t_h_e _s_e_r_v_e_r _k_n_o_w_s_.
_<_d_t_>
_<_b_>_-_Z_[_Z_]_<_/_b_>
_<_d_d_>
_I_s_s_u_e _S_t_a_r_t_T_L_S _(_T_r_a_n_s_p_o_r_t _L_a_y_e_r _S_e_c_u_r_i_t_y_) _e_x_t_e_n_d_e_d _o_p_e_r_a_t_i_o_n_. _I_f _y_o_u _u_s_e
_<_b_>_-_Z_Z_, _t_h_e _c_o_m_m_a_n_d _w_i_l_l _r_e_q_u_i_r_e _t_h_e _o_p_e_r_a_t_i_o_n _t_o _b_e _s_u_c_c_e_s_s_f_u_l_.
_<_/_d_l_>
_<_h_3 _i_d_=_"_I_N_P_U_T _F_O_R_M_A_T_"_> _I_N_P_U_T _F_O_R_M_A_T _<_/_h_3_>
_I_f _t_h_e _c_o_m_m_a_n_d_-_l_i_n_e _a_r_g_u_m_e_n_t_s _d_n _a_n_d _r_d_n _a_r_e _g_i_v_e_n_, _r_d_n
_w_i_l_l _r_e_p_l_a_c_e _t_h_e _R_D_N _o_f _t_h_e _e_n_t_r_y _s_p_e_c_i_f_i_e_d _b_y _t_h_e _D_N_, _d_n_.
_<_p_>
_O_t_h_e_r_w_i_s_e_, _t_h_e _c_o_n_t_e_n_t_s _o_f _f_i_l_e _(_o_r _s_t_a_n_d_a_r_d _i_n_p_u_t _i_f
_n_o
_f_l_a_g _i_s _g_i_v_e_n_) _s_h_o_u_l_d _c_o_n_s_i_s_t _o_f _o_n_e _o_r _m_o_r_e _e_n_t_r_i_e_s_.
_<_p_>
_<_b_r_>
_<_p_r_e_>
_D_i_s_t_i_n_g_u_i_s_h_e_d _N_a_m_e _(_D_N_)
_R_e_l_a_t_i_v_e _D_i_s_t_i_n_g_u_i_s_h_e_d _N_a_m_e _(_R_D_N_)
_<_/_p_r_e_>
_<_p_>
_O_n_e _o_r _m_o_r_e _b_l_a_n_k _l_i_n_e_s _m_a_y _b_e _u_s_e_d _t_o _s_e_p_a_r_a_t_e _e_a_c_h _D_N_/_R_D_N _p_a_i_r_.
_<_h_3 _i_d_=_"_E_X_A_M_P_L_E_"_> _E_X_A_M_P_L_E _<_/_h_3_>
_A_s_s_u_m_i_n_g _t_h_a_t _t_h_e _f_i_l_e
_<_b_>_/_t_m_p_/_e_n_t_r_y_m_o_d_s_<_/_b_>
_e_x_i_s_t_s _a_n_d _h_a_s _t_h_e _c_o_n_t_e_n_t_s_:
_<_p_>
_<_b_r_>
_<_p_r_e_>
_c_n_=_M_o_d_i_f_y _M_e_,_d_c_=_e_x_a_m_p_l_e_,_d_c_=_c_o_m
_c_n_=_T_h_e _N_e_w _M_e
_<_/_p_r_e_>
_<_p_>
_t_h_e _c_o_m_m_a_n_d_:
_<_p_>
_<_b_r_>
_<_p_r_e_>
_l_d_a_p_m_o_d_r_d_n _-_r _-_f _/_t_m_p_/_e_n_t_r_y_m_o_d_s
_<_/_p_r_e_>
_<_p_>
_w_i_l_l _c_h_a_n_g_e _t_h_e _R_D_N _o_f _t_h_e _"_M_o_d_i_f_y _M_e_" _e_n_t_r_y _f_r_o_m _"_M_o_d_i_f_y _M_e_" _t_o
_"_T_h_e _N_e_w _M_e_" _a_n_d _t_h_e _o_l_d _c_n_, _"_M_o_d_i_f_y _M_e_" _w_i_l_l _b_e _r_e_m_o_v_e_d_.
_<_p_>
_<_h_3 _i_d_=_"_D_I_A_G_N_O_S_T_I_C_S_"_> _D_I_A_G_N_O_S_T_I_C_S _<_/_h_3_>
_E_x_i_t _s_t_a_t_u_s _i_s _0 _i_f _n_o _e_r_r_o_r_s _o_c_c_u_r_. _E_r_r_o_r_s _r_e_s_u_l_t _i_n _a _n_o_n_-_z_e_r_o _e_x_i_t
_s_t_a_t_u_s _a_n_d _a _d_i_a_g_n_o_s_t_i_c _m_e_s_s_a_g_e _b_e_i_n_g _w_r_i_t_t_e_n _t_o _s_t_a_n_d_a_r_d _e_r_r_o_r_.
_<_h_3 _i_d_=_"_S_E_E _A_L_S_O_"_> _S_E_E _A_L_S_O _<_/_h_3_>
_<_a _h_r_e_f_=_"_._._/_h_t_m_l_1_/_l_d_a_p_a_d_d_._h_t_m_l_"_>_l_d_a_p_a_d_d_(_1_)_<_/_a_>
_<_a _h_r_e_f_=_"_._._/_h_t_m_l_1_/_l_d_a_p_d_e_l_e_t_e_._h_t_m_l_"_>_l_d_a_p_d_e_l_e_t_e_(_1_)_<_/_a_>
_<_a _h_r_e_f_=_"_._._/_h_t_m_l_1_/_l_d_a_p_m_o_d_i_f_y_._h_t_m_l_"_>_l_d_a_p_m_o_d_i_f_y_(_1_)_<_/_a_>
_<_a _h_r_e_f_=_"_._._/_h_t_m_l_1_/_l_d_a_p_s_e_a_r_c_h_._h_t_m_l_"_>_l_d_a_p_s_e_a_r_c_h_(_1_)_<_/_a_>
_<_a _h_r_e_f_=_"_._._/_h_t_m_l_5_/_l_d_a_p_._c_o_n_f_._h_t_m_l_"_>_l_d_a_p_._c_o_n_f_(_5_)_<_/_a_>
_<_a _h_r_e_f_=_"_._._/_h_t_m_l_3_/_l_d_a_p_._h_t_m_l_"_>_l_d_a_p_(_3_)_<_/_a_>
_<_a _h_r_e_f_=_"_._._/_h_t_m_l_3_/_l_d_a_p___r_e_n_a_m_e_._h_t_m_l_"_>_l_d_a_p___r_e_n_a_m_e_(_3_)_<_/_a_>
_<_h_3 _i_d_=_"_A_U_T_H_O_R_"_> _A_U_T_H_O_R _<_/_h_3_>
_T_h_e _O_p_e_n_L_D_A_P _P_r_o_j_e_c_t _<_h_t_t_p_:_/_/_w_w_w_._o_p_e_n_l_d_a_p_._o_r_g_/_>
_<_h_3 _i_d_=_"_A_C_K_N_O_W_L_E_D_G_E_M_E_N_T_S_"_> _A_C_K_N_O_W_L_E_D_G_E_M_E_N_T_S _<_/_h_3_>
_<_b_>_O_p_e_n_L_D_A_P _S_o_f_t_w_a_r_e_<_/_b_>
_i_s _d_e_v_e_l_o_p_e_d _a_n_d _m_a_i_n_t_a_i_n_e_d _b_y _T_h_e _O_p_e_n_L_D_A_P _P_r_o_j_e_c_t _<_h_t_t_p_:_/_/_w_w_w_._o_p_e_n_l_d_a_p_._o_r_g_/_>_.
_<_b_>_O_p_e_n_L_D_A_P _S_o_f_t_w_a_r_e_<_/_b_>
_i_s _d_e_r_i_v_e_d _f_r_o_m _U_n_i_v_e_r_s_i_t_y _o_f _M_i_c_h_i_g_a_n _L_D_A_P _3_._3 _R_e_l_e_a_s_e_.
_<_/_b_o_d_y_>
_<_/_h_t_m_l_>