LDAPMODRDN

Section: User Commands (1)
Updated: 2005/11/18
Index Return to Main Contents
 

名前

ldapmodrdn - LDAP エントリ改名ツール  

書式

ldapmodrdn [-r] [-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]  

説明

ldapmodrdn は、 ldap_modrdn2(3) ライブラリ関数に対応するコマンドラインインタフェースです。

ldapmodrdn は LDAP サーバへに対してコネクションを張り、バインドした後、 エントリの RDN を更新します。 エントリ情報は、標準入力、オプション -f で指定したファイル file、 コマンドライン上の dnrdn のペアのいずれかから読み込みます、  

オプション

-r
エントリから古い RDN 値を除去します。デフォルトでは古い値を残します。
-n
何が行われるのかを示しますが、実際にエントリを変更しません。デバッグを 目的に -v とともに使います。
-v
冗長モードにします。標準出力に多くの診断情報を書き出します。
-c
継続操作モードになります。エラーが報告されても、 ldapmodrdn は削除を継続します。このオプションを指定しなければ、エラーを報告した後に 終了します。
-M[M]
ManageDsaIT 制御を有効にします(referral エントリを通常の エントリと同様に扱います)。 -MM の指定は、サーバで ManageDsaIT 制御を利用できない場合に、 操作を実行しないようにします。
-d debuglevel
LDAP のデバッグレベルを debuglevel に設定します。 このオプションが効果を持つためには、 ldapmodrdn をマクロ LDAP_DEBUG 付きでコンパイルしておかなければなりません。
-f file
標準入力またはコマンドラインから更新情報を読み込む代わりに ファイル file から読み込みます。
-x
SASL の代わりに簡易認証を使います。
-D binddn
LDAP ディレクトリにバインドするのに binddn を使います。
-W
簡易認証のためのプロンプトを出します。 これはコマンドラインにパスワードを指定する代わりに使います。
-w passwd
簡易認証のためのパスワードに passwd を使います。
-y passwdfile
簡易認証のためのパスワードにファイル passwdfile の内容すべてを使います。
-H ldapuri
LDAP サーバを参照する URI を指定します。 URI 中にはプロトコル、ホスト、ポートのみを指定できます。 URI のリストを指定する場合には各 URI を空白かカンマで区切ってください。
-h ldaphost
LDAP サーバが動作しているホストを明示します。 このオプションは時代遅れなので -H を使ってください。
-p ldapport
LDAP サーバに接続するための TCP ポートを明示します。 このオプションは時代遅れなので -H を使ってください。
-P 2|3
利用する LDAP プロトコルのバージョンを指定します。
-O security-properties
SASL のセキュリティプロパティを指定します。
-I
SASL 対話モードにします。常にプロンプトを出します。 デフォルトでは必要なときにだけプロンプトを出します。
-Q
SASL 非対話モードにします。プロンプトは出しません。
-U authcid
SASL バインドのための認証 ID を指定します。 認証 ID の型式は実際に使用する SASL 機構に依存します。
-R realm
SASL バインドのための認証IDのレルム(realm)を指定します。 レルムの形式は実際に使用する SASL 機構に依存します。
-X authzid
authzid は次のフォーマットのいずれかでなければなりません。 dn:<識別名> あるいは u:<ユーザ名>
-Y mech
認証に使う SASL 機構を指定します。このオプションを指定しなければ、 サーバがサポートする最良の機構が選ばれます。
-Z[Z]
StartTLS (Transport Layer Security)拡張操作を発行します。 もし -ZZが指定されたならば、コマンドはこの操作の成功を要求します。
 

入力フォーマット

コマンドライン引数 dnrdn が与えられていれば、 DN dn によって指定されたエントリの RDN を rdn で 置き換えます。

no そうではない場合、ファイル file ( -f フラグが与えられていなければ標準入力)の内容は、 次に示す1個以上のエントリから成ります。

    識別名 (DN)
    相対識別名 (RDN)

個々の DN/RDN ペアを区切るには、1個以上のブランク行を使います。  

使用例

ファイル /tmp/entrymods があり、その内容は次のものであるとします。

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

次のコマンドを実行します。

    ldapmodrdn -r -f /tmp/entrymods

これは、"Modify Me" の RDN を "Modify Me" から "The New Me" に変更し、古い cn "Modify Me" は除去されます。

 

診断

エラーが起きなければ終了ステータスは 0 です。エラーが起きれば、 0 でない終了ステータスが返り、標準エラーに診断メッセージを書き出します。  

関連項目

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

作者

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

謝辞

OpenLDAP は OpenLDAP プロジェクト (http://www.openldap.org/) が開発/管理しています。 OpenLDAP はミシガン大学の LDAP 3.3 リリースより派生しました。  

和訳

稲地 稔 <inachi@kkd.biglobe.ne.jp>


 

Index

名前
書式
説明
オプション
入力フォーマット
使用例
診断
関連項目
作者
謝辞
和訳