Sözdizimi
/usr/sbin/slapcat [-afilter] [-bsuffix] [-c] [-ddebug-level] [-fslapd.conf] [-Fconfdir] [-g]
[-HURI] [-lldif-file] [-ndbnum] [-ooption[=value]] [-ssubtree-dn] [-v]
Açıklama
Slapcat, bir slapd(8) veri tabanının içeriğine dayalı olarak bir LDAP Dizin Değişim Biçimi (LDIF) çıktısı üretmek için kullanılır. Veri tabanı numarası veya son ekiyle (suffix) belirlenen ilgili veri tabanını açar ve karşılık gelen LDIF'i standart çıktıya veya belirtilen dosyaya yazar. -g seçeneği belirtilmedikçe, bu veri tabanının alt bileşeni (subordinate) olarak yapılandırılmış veri tabanları da çıktıya dahil edilir.
Girdi kayıtları, üst öncelikli sırada (superior first) değil, veri tabanı sırasında sunulur. Girdi kayıtları, veri tabanında saklanan tüm (kullanıcı ve işletimsel) öznitelikleri içerecektir. Girdi kayıtları, dinamik olarak üretilen öznitelikleri (örneğin subschemaSubentry) içermeyecektir.
Slapcat çıktısı, slapadd(8) programına girdi olarak verilmek üzere tasarlanmıştır. Slapcat çıktısı, üzerinde önceden düzenleme yapılmadan genellikle ldapadd(1) veya diğer LDAP istemcilerine girdi olarak kullanılamaz. Bu düzenleme normalde, kayıtların üst öncelikli sıraya göre yeniden sıralanmasını ve kullanıcı tarafından değiştirilemeyen işletimsel özniteliklerin kaldırılmasını içerir.
Seçenekler
-a_filter Yalnızca belirtilen filtreyle eşleşen girdilerin dökümünü alır (dump). Örneğin,
slapcat -a
"(!(entryDN:dnSubtreeMatch:=ou=People,dc=example,dc=com))"
komutu, "dc=example,dc=com" veri tabanındaki "ou=People,dc=example,dc=com" alt ağacı dışındaki tüm girdilerin dökümünü alacaktır. Kullanımdan kaldırılmıştır (deprecated); bunun yerine -H ldap:///???(filter) kullanın.
-b_suffix
Çıktının hangi veri tabanı için üretileceğini belirlemek üzere belirtilen son eki (suffix) kullanır. -b seçeneği, -n seçeneği ile birlikte kullanılamaz.
-c: Devam et (hataları yoksay) modunu etkinleştirir. Birden fazla-ckullanımı slapcat(8) programının daha fazla çaba göstermesini sağlar.
-d_debug-level Belirtilen hata ayıklama düzeyine (debug-level) göre hata ayıklama iletilerini etkinleştirir; ayrıntılar için slapd(8) sayfasına bakın.
-f_slapd.conf Alternatif bir slapd.conf(5) dosyası belirtir.
-F_confdir
Bir yapılandırma dizini belirtir. Hem -f hem de -F belirtilirse, yapılandırma dosyası okunur, yapılandırma dizini biçimine dönüştürülür ve belirtilen dizine yazılır. İki seçenek de belirtilmezse, varsayılan yapılandırma dosyası kullanılmaya çalışılmadan önce varsayılan yapılandırma dizini okunmaya çalışılır. Geçerli bir yapılandırma dizini varsa, varsayılan yapılandırma dosyası yoksayılır.
-g: Alt bileşen bağlamayı (subordinate gluing) devre dışı bırakır. Yalnızca belirtilen veri tabanı işlenir, varsa ona bağlı alt bileşenler işlenmez.-H: URI Yalnızca eşleşen girdileri işlemek için URI içindeki DN, kapsam (scope) ve filtreyi kullanır.
-l_ldif-file LDIF'i standart çıktı yerine belirtilen dosyaya yazar.
-n_dbnum
Yapılandırma dosyasında listelenen dbnum-uncu veri tabanı için çıktı üretir. Yapılandırma veri tabanı olan slapd-config(5) her zaman ilk veri tabanıdır, bu nedenle onu seçmek için -n 0 kullanın.
-n seçeneği, -b seçeneği ile birlikte kullanılamaz.
-o_option[=value] (İsteğe bağlı) bir değere sahip bir seçenek belirtir. Olası genel seçenekler/değerler şunlardır:
syslog=-s seçeneğine bakın)
syslog-level=-S seçeneğine bakın)
syslog-user=<kullanıcı> (slapd(8) içindeki -l seçeneğine bakın)
ldif-wrap={no|
n, LDIF çıktısı için izin verilen sütun sayısıdır (n değeri 0 olduğunda varsayılan değer olan 76 kullanılır). Satır kaydırmayı kapatmak için no seçeneğini kullanın.
-s_subtree-dn
Yalnızca bu DN tarafından belirtilen alt ağaçtaki girdilerin dökümünü alır.
Eğer herhangi bir -b veya -n seçeneği verilmemişse, -b subtree-dn seçeneğini ima eder.
Kullanımdan kaldırılmıştır (deprecated); bunun yerine -H ldap:///subtree-dn kullanın.
-v: Ayrıntılı (verbose) modu etkinleştirir.
Sınırlamalar
Veri tabanının tutarlılığını sağlamak için bazı arka uç (backend) türlerinde, bu işlemi yaparken slapd(8) sunucunuz çalışıyor olmamalıdır (en azından oku-yaz modunda olmamalıdır). Slapcat programını slapd-bdb(5), slapd-hdb(5) ve slapd-null(5) arka uçlarıyla çalıştırmak her zaman güvenlidir.
Örnekler
SLAPD veri tabanınızın metin tabanlı bir yedeğini almak ve bunu ldif adlı bir dosyaya kaydetmek için şu komutu verin:
/usr/sbin/slapcat -l ldif
Ayrıca Bakınız
ldap(3), ldif(5), slapadd(8), ldapadd(1), slapd(8)
"OpenLDAP Administrator's Guide" (http://www.OpenLDAP.org/doc/admin/)
Teşekkürler
OpenLDAP Yazılımı, The OpenLDAP Project http://www.openldap.org/ tarafından geliştirilmekte ve sürdürülmektedir. OpenLDAP Yazılımı, University of Michigan LDAP 3.3 Sürümünden türetilmiştir.