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
- 名前
-
- 書式
-
- 説明
-
- オプション
-
- 制限
-
- 使用例
-
- 関連項目
-
- 謝辞
-
- 和訳
-