Kullanımdan Kaldırma Uyarısı
xar artık Apple tarafından aktif olarak geliştirilmemektedir. xar istemcileri alternatif arşiv formatlarına yönelmelidir.
Özet
xar -[ctx][v] ...
Açıklama
XAR projesi, kolayca genişletilebilir bir arşiv formatı sağlamayı amaçlamaktadır. Önemli tasarım kararları arasında; arşivlenmiş dosyalara rastgele erişim için kolayca genişletilebilir bir XML içerik tablosu (TOC), akış halindeki arşivlerin verimli bir şekilde işlenmesini sağlamak amacıyla TOC'un arşivin başında saklanması, isteğe bağlı büyüklükteki dosya boyutlarının işlenebilmesi, arşivdeki bireysel dosyalar için bağımsız kodlamaların seçilebilmesi, bireysel dosyalar için hem sıkıştırılmış hem de sıkıştırılmamış biçimde sağlama toplamlarının (checksum) saklanabilmesi ve içerik tablosunun zengin meta verilerinin sorgulanabilmesi yer almaktadır.
Fonksiyonlar
Aşağıdaki seçeneklerden biri kullanılmalıdır:
-c: Bir arşiv oluşturur-t: Bir arşivin içeriğini listeler-x: Bir arşivi çıkartır
NOT: Yukarıdakilerin tümü -f seçeneğinin (dosya adı) kullanılmasını gerektirir, çünkü xar'ın bu sürümü boru hatlarını (pipe) veya soketleri doğru şekilde işleyememektedir.
-f: Oluşturma, listeleme veya çıkartma için kullanılacak dosya adı. Çıkartma işleminde bu, bir POSIX düzenli ifadesi (regular expression) olabilir.
Seçenekler
--compression Kullanılacak sıkıştırma türünü belirtir. Geçerli değerler: none, gzip, bzip2, lzma (bazı sistemlerde). Varsayılan değer: gzip
-C
-a: --compression=lzma seçeneğinin eş anlamlısıdır.-j: --compression=bzip2 seçeneğinin eş anlamlısıdır.-z: --compression=gzip seçeneğinin eş anlamlısıdır.
--compression-args=<argümanlar> Seçilen sıkıştırma motoruna yönelik argümanları belirtir. gzip, bzip2 ve lzma seçeneklerinin hepsi, kullanılacak sıkıştırma seviyesini belirten 0 ile 9 arasında tek bir tam sayı argümanı alır.
--dump-toc=<dosya_adı> xar'ın XML üstbilgisini belirtilen dosyaya dökmesini sağlar. Standart çıktıyı (stdout) belirtmek için "-" kullanılabilir.
--dump-toc-cksum TOC sağlama toplamını (checksum), TOC algoritmasıyla birlikte standart çıktıya (stdout) döker.
--dump-header xar'ın xar ikili (binary) üstbilgi bilgilerini standart çıktıya (stdout) yazdırmasını sağlar.
--extract-subdoc=<ad>.xml olarak adlandırılan bir belgeye çıkartır.
--list-subdocs XML üstbilgisindeki alt belgeleri listeler
--toc-cksum XML üstbilgisi doğrulaması için kullanılacak özetleme (hashing) algoritmasını belirtir. Geçerli değerler: md5 (bazı sistemlerde), sha1, sha256 ve sha512. Varsayılan değer: sha1
--file-cksum Dosya içeriği doğrulaması için kullanılacak özetleme (hashing) algoritmasını belirtir. Geçerli değerler: md5 (bazı sistemlerde), sha1, sha256 ve sha512. Varsayılan değer: sha1
-l: Arşivleme sırasında yerel cihazda kalır.-P: Çıkartma sırasında, sahipliği uid/gid değerlerine göre ayarlar. Çıkartılan dosya üzerinde uid/gid ayarlanabiliyorsa, setuid/setgid bitleri de korunur.-p: Çıkartma sırasında, mümkünse sahipliği sembolik adlara göre ayarlar. Çıkartılan dosya üzerinde uid/gid ayarlanabiliyorsa, setuid/setgid bitleri de korunur.
-s <dosya_adı> Çıkartma sırasında, alt belgelerin çıkartılacağı dosyayı belirtir. Arşivleme sırasında, alt belge olarak eklenecek bir XML dosyasını belirtir.
-v: Ayrıntılı çıktı
--exclude Oluşturma sırasında arşive eklenmeyecek veya çıkartma sırasında çıkartılmayacak dosyaları belirten bir POSIX düzenli ifadesi (regular expression) tanımlar. Bu seçenek birden fazla kez belirtilebilir.
--rsize Girdi/Çıktı (I/O) işlemleri gerçekleştirilirken dahili libxar okuma arabelleği için bir boyut (bayt cinsinden) belirtir.
--coalesce-heap Arşivdeki birden fazla dosya aynı olduğunda, verinin yığında (heap) yalnızca tek bir kopyasını saklar. Bu daha küçük arşivler oluşturur, ancak oluşturulan arşivler akışa uygun (streamable) değildir.
--link-same Birden fazla dosyanın veri bölümü aynı olduğunda, bunları arşiv içinde sabit bağ (hardlink) ile bağlar.
--no-compress Arşivlenecek ancak sıkıştırılmayacak dosyaları belirten bir POSIX düzenli ifadesi tanımlar. Arşivlenen dosyalar arşive ham (raw) olarak kopyalanacaktır. Bu, zaten gzipped olan dosyaların arşivleme işlemi sırasında tekrar gzipped olmasını önlemek için kullanılabilir.
--prop-include Arşive dahil edilecek bir dosya özelliğini belirtir. Bu seçenek belirtildiğinde, yalnızca belirtilen seçenekler dahil edilecektir. Bu seçenekle özel olarak dahil edilmeyen her şey hariç tutulacaktır. Bu seçenek birden fazla kez kullanılabilir.
--prop-exclude Arşivden hariç tutulacak bir dosya özelliğini belirtir. Bu seçenek belirtildiğinde, belirtilen özellikler dışındaki tüm dosya özellikleri dahil edilecektir. Bu seçenek birden fazla kez kullanılabilir.
--distribution Yalnızca dosya dağıtımı için güvenli olan dosya özelliklerini içeren bir arşiv oluşturur. Şu anda bu seçenekle yalnızca name (ad), type (tür), mode (mod) ve data (veri) korunmaktadır.
--keep-existing Çıkartma sırasında mevcut dosyaların üzerine yazmaz. Çıkartma işlemi gerçekleştirilirken önceden var olan tüm dosyaları korur.
-k: --keep-existing seçeneğinin eş anlamlısıdır.
--keep-setuid -p veya -P seçenekleri olmadan çıkartma yapıldığında, xar dosyaları çıkartan işlemin uid/gid değerleriyle çıkartır. Bu durumda xar, güvenlik nedenleriyle çıkartılan dosyalardan setuid/setgid bitlerini temizler. --keep-setuid seçeneği, çıkartılan dosyanın uid/gid değeri arşivlenen dosya ile aynı olmasa bile setuid/setgid bitlerini korur.
Örnekler
xar -cf sample.xar /home/uid
/home/uid dizinindeki tüm dosyaların bir xar arşivini oluşturur
xar -tf sample.xar
sample.xar arşivinin içeriğini listeler
xar -xf sample.xar
sample.xar arşivinin içeriğini geçerli çalışma dizinine çıkartır
Hatalar
Şu anda boru hatları (pipe) veya akışlar (stream) ile çalışmamaktadır. Gelecekteki bir sürümde düzeltilebilir.
Muhtemelen oralarda bir yerlerde bir veya iki hata daha vardır. Eğer bir hata bulursanız lütfen http://code.google.com/p/xar/ adresine bildirin.
Yazarlar
Rob Braun
sürüm 1.8 4 Haziran 2015 XAR(1)