Synopsis
db_upgrade [-NsV] [-h home] [-P password] file ...
Description
db_upgrade aracı, bir veya daha fazla dosyanın ve içerdikleri veritabanlarının Berkeley DB sürümünü geçerli sürüm versiyonuna yükseltir (upgrade).
Seçenekler aşağıdaki gibidir:
-h Veritabanı ortamı için bir ana dizin (home directory) belirtir; varsayılan olarak geçerli çalışma dizini kullanılır.
-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.
-s Bu bayrak yalnızca veritabanları Berkeley DB 3.1 sürümünden önceki sürümlerden yükseltilirken anlamlıdır.
Berkeley DB 3.0 sürümünden 3.1 sürümüne yapılan yükseltmenin bir parçası olarak, disk üzerindeki yinelenen (duplicate) veri öğelerinin biçimi değişti. Biçimi doğru bir şekilde yükseltmek için uygulamaların veritabanındaki yinelenen veri öğelerinin sıralı olup olmadığını belirtmesi gerekir. -s bayrağının belirtilmesi yinelenenlerin sıralı olduğu anlamına gelir; aksi takdirde sıralanmamış oldukları varsayılır. Bu bayrağın değerinin yanlış belirtilmesi veritabanı bozulmasına yol açabilir.
db_upgrade aracı fiziksel bir dosyayı (içerdiği tüm veritabanları dahil) yükselttiğinden, içerdiği veritabanlarının bazılarında sıralı yinelenen veri öğeleri, bazılarında ise sıralanmamış yinelenen veri öğeleri bulunan dosyaları yükseltmek için db_upgrade kullanılması mümkün değildir. Dosya birden fazla veritabanı içermiyorsa, veritabanları yinelenen veri öğelerini desteklemiyorsa veya yinelenen veri öğelerini destekleyen tüm veritabanları aynı yinelenen stilini destekliyorsa (sıralı veya sıralanmamış), -s bayrağı doğru belirtildiği sürece db_upgrade düzgün çalışacaktır. Aksi takdirde, dosya db_upgrade kullanılarak yükseltilemez ve db_dump ile db_load araçları kullanılarak manuel olarak yükseltilmelidir.
-V Kütüphane sürüm numarasını standart çıktıya yazar ve çıkar.
Berkeley DB veritabanı yükseltmelerinin yerinde (in place) yapıldığını ve bu nedenle potansiyel olarak yıkıcı olduğunu fark etmek önemlidir. Bu, yükseltme işlemi sırasında sistem çökerse veya yükseltme işlemi için disk alanı tükenirse, veritabanlarının kararsız ve kurtarılamaz bir durumda kalabileceği anlamına gelir. Daha fazla bilgi için Upgrading databases (Veritabanlarını yükseltme) bölümüne bakın.
db_upgrade 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_upgrade aracına her zaman ortamdan ayrılma (detach) ve sorunsuz bir şekilde çıkma fırsatı verilmelidir. db_upgrade'in 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.
db_upgrade 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_dump(1), db_load(1), db_printlog(1), db_recover(1), db_stat(1), db_verify(1)
Darwin December 3, 2003 Darwin