SLAPCAT

Section: Maintenance Commands (8C)
Updated: 2005/11/18
Index Return to Main Contents
 

名前

slapcat - SLAPD データベースからの LDIF の生成  

書式

/usr/local/sbin/slapcat [-v] [-c] [-g] [-d level] [-b suffix] [-n dbnum] [-a filter] [-s subtree-dn] [-f slapd.conf] [-F confdir] [-l ldif-file]

 

説明

slapcat は、 slapd(8) データベースの内容を基に LDAP データ交換フォーマット(LDAP Directory Interchange Format: LDIF)の出力を生成するために使われます。 slapcat は、データベース番号あるいは接尾辞によって決まるデータベースを オープンし、対応する LDIF を標準入力あるいは指定のファイルに 書き出します。 オプション -g を指定していなければ、 指定したデータベースの 下位データベース( subordinate )として設定したデータベースについても出力します。

このツールで生成した LDIF は slapadd(8) で利用できるようになっています。 この LDIF のエントリはデータベース内の順序で出力されており、 上位エントリから先に出力されるわけではないので、事前に整列しておかなければ ldapadd(1) でロードできません。  

オプション

-v
冗長モードにします。
-c
継続(エラー無視)モードにします。
-g
下位データベースの処理を無効にします。 指定のデータベースだけを処理し、 下位データベースについては(有ったとしても)処理しません。
-d level
指定のレベル level のデバッグメッセージを出力するようにします。
-b suffix
生成する出力に対応するデータベース決定するための接尾辞 suffix を指定します。この -b オプションは -n オプションと一緒に使えません。
-n dbnum
設定ファイルに定義されている dbnum 番目のデータベースから出力を生成します。この -n オプションは -b オプションと一緒に使えません。
-a filter
指定のフィルタに一致するエントリのみをダンプします。 たとえば次のように指定します。

slapcat -a \
    "(!(entryDN:dnSubtreeMatch:=ou=People,dc=example,dc=com))"

この場合、データベース "dc=example,dc=com" のサブツリー "ou=People,dc=example,dc=com" だけをダンプします。

-s subtree-dn
指定した DN 配下のサブツリーのエントリだけをダンプします。 オプション -b または -n は指定しないものとします。
-f slapd.conf
代替の slapd.conf(5) ファイルを指定します。
-F confdir
設定ディレクトリを指定します。 オプション -f-F の両方を指定した場合、設定ファイルが読み込まれ、設定ディレクトリの フォーマットに変換した後、指定の設定ディレクトリに書き込みます。 どちらのオプションも指定しなかった場合、 デフォルトの設定ファイルを利用しようとする前にデフォルトの 設定ディレクトリからの読み込みを試みます。 正しい設定ディレクトリが存在していればデフォルトの設定ファイルは 無視されます。
-l ldif-file
LDIF を標準出力にではなく指定したファイルに書き出します。
 

制限

一般に、データベースの一貫性を保証したいのであれば slapcat を実行している間は slapd(8) の実行を中断してください(少なくとも更新できないようにしてください)。  

使用例

SLAPD データベースのテキスト形式のバックアップを ldif というファイルに作成するには、次のようにコマンドを実行します。

        /usr/local/sbin/slapcat -l ldif
 

関連項目

ldap(3), ldif(5), slapadd(8), ldapadd(1), slapd(8)

"OpenLDAP 管理者ガイド" (http://www.OpenLDAP.org/doc/admin/)  

謝辞

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

和訳

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


 

Index

名前
書式
説明
オプション
制限
使用例
関連項目
謝辞
和訳