Synopsis
db_dump [-klNpRrV] [-d ahr] [-f output] [-h home] [-P password] [-s database] file
Description
db_dump aracı, veritabanı dosyası olan file dosyasını okur ve db_load aracı tarafından anlaşılan taşınabilir bir düz metin (flat-text) biçimi kullanarak standart çıktıya yazar. file argümanı, Berkeley DB kütüphane fonksiyonları kullanılarak üretilmiş bir dosya olmalıdır.
Seçenekler aşağıdaki gibidir:
-d Belirtilen veritabanını, Berkeley DB kütüphane yordamlarının (routines) hata ayıklamasına yardımcı olacak bir biçimde döker.
a Tüm bilgileri görüntüler.
h Yalnızca sayfa başlıklarını görüntüler.
r Serbest listeyi (free-list) veya serbest listedeki sayfaları görüntülemez. Bu mod, kurtarma (recovery) testleri tarafından kullanılır.
-d seçeneğinin çıktı biçimi standart değildir ve Berkeley DB kütüphanesinin sürümleri arasında önceden bildirilmeksizin değişebilir.
-f Standart çıktı yerine belirtilen dosyaya yazar.
-h Veritabanı ortamı için bir ana dizin (home directory) belirtir; varsayılan olarak geçerli çalışma dizini kullanılır.
-k Queue ve Recno veritabanlarındaki kayıt numaralarını anahtar (key) olarak döker.
-l Dosyada saklanan veritabanlarını listeler.
-N Çalışırken paylaşılan bölge karşılıklı dışlama kilitlerini (mutexes) edinmez. Berkeley DB'deki potansiyel olarak ölümcül hatalar gibi diğer sorunlar da yoksayılacaktır. Bu seçenek yalnızca hataların ayıklanması amacıyla tasarlanmıştır ve başka hiçbir koşulda kullanılmamalıdır.
-P Bir ortam parolası belirtir. Berkeley DB araçları parola dizelerini mümkün olan en kısa sürede geçersiz kılsa (overwrite) bile, ayrıcalıksız kullanıcıların komut satırı argümanlarını görebildiği veya araçların komut satırı argümanlarını içeren belleği geçersiz kılamadığı sistemlerde bir güvenlik açığı penceresi olabileceğini unutmayın.
-p Anahtar veya veri öğelerindeki karakterler yazdırılabilir karakterler (isprint(3) tarafından tanımlandığı gibi) ise, bunları temsil etmek için file dosyasında yazdırılabilir karakterler kullanır. Bu seçenek, kullanıcıların veritabanlarının içeriğini değiştirmek için standart metin düzenleyicilerini ve araçlarını kullanmalarına olanak tanır.
Not: Farklı sistemler, hangi karakterlerin yazdırılabilir karakterler olduğu konusunda farklı fikirlere sahip olabilir ve bu şekilde dökülen veritabanları harici sistemlere daha az taşınabilir olabilir.
-R Muhtemelen bozuk bir dosyadan agresif bir şekilde veri kurtarır (salvage). -R bayrağı, önceden silinmiş veya anlamsız öğeleri de döndürme riski pahasına dosyadan olası tüm verileri döndürmesi bakımından -r seçeneğinden ayrılır. Bu şekilde dökülen verilerin, başka bir veritabanına yeniden yüklenmeye hazır hale gelmeden önce el yordamıyla veya başka yollarla düzenlenmesi neredeyse kesinlikle gerekecektir.
-r Muhtemelen bozuk bir dosyadan veri kurtarır. Bozulmamış bir veritabanında kullanıldığında, bu seçenek normal bir dökümle eşdeğer verileri döndürmelidir, ancak büyük olasılıkla farklı bir sırada.
-s Dökmek için tek bir veritabanı belirtir. Herhangi bir veritabanı belirtilmezse, veritabanı dosyasındaki tüm veritabanları dökülür.
-V Kütüphane sürüm numarasını standart çıktıya yazar ve çıkar.
Kullanıcı tanımlı karma (hash) fonksiyonları kullanan Hash veritabanlarını dökmek ve yeniden yüklemek, varsayılan karma fonksiyonunu kullanan yeni veritabanlarıyla sonuçlanacaktır. Varsayılan karma fonksiyonunun kullanılması yeni veritabanı için en uygun (optimal) seçim olmasa da düzgün çalışmaya devam edecektir.
Kullanıcı tanımlı önek (prefix) veya karşılaştırma fonksiyonları kullanan Btree veritabanlarını dökmek ve yeniden yüklemek, varsayılan önek ve karşılaştırma fonksiyonlarını kullanan yeni veritabanlarıyla sonuçlanacaktır. Bu durumda, veritabanının ne kayıt depolamasına ne de geri getirmesine izin vermeyecek şekilde onarılamaz derecede hasar görmesi oldukça muhtemeldir.
Her iki durum için de mevcut tek geçici çözüm (workaround), db_load aracının kaynak kodlarını veritabanını doğru karma, önek ve karşılaştırma fonksiyonlarını kullanarak yükleyecek şekilde değiştirmektir.
db_dump aracının çıktı biçimi, Berkeley DB Reference Guide içindeki Dump Output Formats (Döküm Çıktı Biçimleri) bölümünde belgelenmiştir.
db_dump aracı, bir Berkeley DB ortamıyla birlikte kullanılabilir (-h seçeneği için açıklandığı gibi, DB_HOME ortam değişkeniyle veya araç bir Berkeley DB ortamı içeren bir dizinde çalıştırıldığı için). Bir Berkeley DB ortamı kullanırken ortamın bozulmasını önlemek için, db_dump aracına her zaman ortamdan ayrılma (detach) ve sorunsuz bir şekilde çıkma fırsatı verilmelidir. db_dump'ın tüm ortam kaynaklarını serbest bırakmasını ve temiz bir şekilde çıkmasını sağlamak için ona bir kesme sinyali (SIGINT) gönderin.
Bir Berkeley DB veritabanı ortamı kullanırken bile, db_dump aracı -d, -R veya -r argümanlarıyla çağrılırsa hiçbir şekilde veritabanı kilitlemesi (locking) kullanmaz. Bu argümanlardan biriyle kullanıldığında, db_dump aracı yalnızca başka hiçbir süreç tarafından değiştirilmeyen veritabanlarında güvenle çalıştırılabilir; aksi takdirde çıktı bozuk olabilir.
db_dump aracı başarı durumunda 0 ve bir hata oluşursa >0 ile çıkar.
Ortam Değişkenleri
DB_HOME Eğer -h seçeneği belirtilmemişse ve DB_HOME ortam değişkeni ayarlanmışsa, DB_ENV->open içinde açıklandığı gibi veritabanı dizininin yolu olarak kullanılır.
Ayrıca Bkz.
db_archive(1), db_checkpoint(1), db_deadlock(1), db_load(1), db_printlog(1), db_recover(1), db_stat(1), db_upgrade(1), db_verify(1)
Darwin December 3, 2003 Darwin