ar

Özet

      ar -d [-TLsv] archive file ...
      ar -m [-TLsv] archive file ...
      ar -m [-abiTLsv] position archive file ...
      ar -p [-TLsv] archive [file ...]
      ar -q [-cTLsv] archive file ...
      ar -r [-cuTLsv] archive file ...
      ar -r [-abciuTLsv] position archive file ...
      ar -t [-TLsv] archive [file ...]
      ar -x [-ouTLsv] archive [file ...]

Açıklama

ar aracı, bir arşiv içinde birleştirilmiş dosya grupları oluşturur ve sürdürür. Bir arşiv oluşturulduktan sonra, yeni dosyalar eklenebilir ve mevcut dosyalar çıkarılabilir, silinebilir veya değiştirilebilir.

Dosyalar arşivde tek bir bileşenle adlandırılır, yani eğik çizgi (``/'') içeren bir yol tarafından başvurulan bir dosya arşivlendiğinde, o yolun son bileşeniyle adlandırılır. Komut satırında listelenen yollar ile arşivde saklanan dosya adları eşleştirilirken, yolun yalnızca son bileşeni karşılaştırılır.

Tüm bilgilendirme ve hata iletilerinde, belirtilmişse komut satırında listelenen yol kullanılır, aksi takdirde arşivdeki ad kullanılır. Arşivde aynı ada sahip birden fazla dosya varsa ve bir işlem için arşiv dosyalarını ``seçmek'' üzere komut satırında yollar listelenmişse, yalnızca eşleşen ada sahip ilk dosya seçilecektir.

ar aracının normal kullanımı, yükleyici ile (bkz. ld(1)) kullanıma uygun kütüphanelerin oluşturulması ve sürdürülmesi amacıyla olsa da, bu amaçla sınırlandırılmamıştır. Seçenekler aşağıdaki gibidir:

• -a: -r ve -m seçenekleriyle birlikte kullanılan bir konumlandırma değiştiricidir. Dosyalar, belirtilmesi gereken arşiv üyesi konumundan sonrasına yerleştirilir veya taşınır.

• -b: -r ve -m seçenekleriyle birlikte kullanılan bir konumlandırma değiştiricidir. Dosyalar, belirtilmesi gereken arşiv üyesi konumundan öncesine yerleştirilir veya taşınır.

• -c: Bir arşiv oluşturulduğunda, standart hataya bu yönde bir bilgilendirme iletisi yazılır. -c seçeneği belirtilirse, ar arşivi sessizce oluşturur.

• -d: Belirtilen arşiv dosyalarını siler.

• -i: -b seçeneği ile aynıdır.

• -m: Belirtilen arşiv dosyalarını arşiv içinde taşır. -a, -b veya -i seçeneklerinden biri belirtilmişse, dosyalar arşivdeki konum dosyasından öncesine veya sonrasına taşınır. Bu seçeneklerden hiçbiri belirtilmemişse, dosyalar arşivin sonuna taşınır.

• -o: Çıkarılan dosyaların erişim ve değiştirme zamanlarını, arşiv dosyasına girildikleri zamanki değiştirme zamanına ayarlar. Kullanıcı çıkarılan dosyanın sahibi veya yetkili kullanıcı (super-user) değilse bu işlem başarısız olur.

• -p: Belirtilen arşiv dosyalarının içeriğini standart çıktıya yazar. Hiçbir dosya belirtilmemişse, arşivdeki tüm dosyaların içerikleri arşivde göründükleri sırayla yazılır.

• -q: (Quickly) ekleme seçeneği; belirtilen dosyaları arşive hızlıca ekler. Arşiv mevcut değilse yeni bir arşiv dosyası oluşturulur. Büyük bir arşivi parça parça oluştururken -r seçeneğinden çok daha hızlıdır, çünkü dosyaların arşivde zaten var olup olmadığını kontrol etmek için herhangi bir denetim yapılmaz.

• -r: Belirtilen dosyaları arşivde değiştirir veya arşive ekler. Arşiv mevcut değilse yeni bir arşiv dosyası oluşturulur. Mevcut dosyaların yerini alan dosyalar, arşiv içindeki dosyaların sırasını değiştirmez. -a, -b veya -i seçeneklerinden biri belirtilmediği sürece yeni dosyalar arşivin sonuna eklenir.

• -T: Yalnızca arşiv üyesinin veya komut satırı dosya adının ilk on beş karakterini kullanarak arşiv üyelerini seçer ve/veya adlandırır. Geçmişteki arşiv biçiminde ad için on altı bayt bulunuyordu, ancak bazı eski arşivleyici ve yükleyici uygulamaları tüm alanı kullanan adları işleyemiyordu. Bu durum, ilk on beş karakteri benzersiz olmayan dosya adlarının sonradan karıştırılabileceği anlamına gelir. Herhangi bir dosya adı kesilirse standart hata çıktısına bir uyarı iletisi yazdırılır. (Daha fazla bilgi için bkz. ar(5).)

• -L: Uzun arşiv üyesi adlarına izin vermek için genişletilmiş biçimi kullanır. Varsayılan davranış budur.

• -s: Arşivde başka hiçbir değişiklik yapılmasa bile arşive bir nesne dosyası dizini yazar veya mevcut olanı günceller. Bu değiştirici bayrağını herhangi bir işlemle birlikte veya tek başına kullanabilirsiniz. Bir arşiv üzerinde ar s' çalıştırmak, üzerinde ranlib' çalıştırmakla eşdeğerdir.

• -S: Bir arşiv sembol tablosu oluşturmaz. Bu, büyük bir kütüphaneyi birkaç adımda derlemeyi hızlandırabilir. Elde edilen arşiv bağlayıcı (linker) ile kullanılamaz. Bir sembol tablosu oluşturmak için, ar'ın son yürütülmesinde S değiştiricisini atlamalı veya arşiv üzerinde ranlib çalıştırmalısınız.

• -t: Belirtilen dosyaları arşivde göründükleri sırayla, her biri ayrı bir satırda olacak şekilde listeler. Hiçbir dosya belirtilmemişse, arşivdeki tüm dosyalar listelenir.

• -u: Dosyaları günceller. -r seçeneğiyle birlikte kullanıldığında, arşivdeki dosyalar yalnızca diskteki dosyanın değiştirme zamanı arşivdeki dosyadan daha yeniyse değiştirilir. -x seçeneğiyle birlikte kullanıldığında, arşivdeki dosyalar yalnızca arşiv dosyasının değiştirme zamanı diskteki dosyadan daha yeniyse çıkarılır.

• -v: Ayrıntılı çıktı sağlar. -d, -m, -q veya -x seçenekleriyle birlikte kullanıldığında, ar arşiv değişikliğinin dosya dosya açıklamasını verir. Bu açıklama, aralarında boşluk bulunan üç alandan oluşur: seçenek harfi, bir tire (-'') ve dosya adı. -r seçeneğiyle birlikte kullanıldığında, ar açıklamayı yukarıdaki gibi görüntüler, ancak dosya arşive eklenmişse başlangıç harfi a'', dosya arşivde zaten bulunan bir dosyanın yerini alıyorsa ``r'' olur.

  -p seçeneğiyle birlikte kullanıldığında, yazdırılan her dosyanın adı, dosya içeriğinden önce standart çıktıya yazılır; addan önce tek bir yeni satır karakteri, addan sonra ise küçüktür (<'') ve büyüktür (>'') karakterleri içine alınmış şekilde iki yeni satır karakteri gelir.

  -t seçeneğiyle birlikte kullanıldığında, ar arşiv üyeleri hakkında ls -l'' tarzında bir bilgi listesi görüntüler. Bu liste, aralarında boşluk bulunan sekiz alandan oluşur: dosya izinleri (bkz. strmode(3)), tek bir eğik çizgi (/'') ile ayrılmış ondalık kullanıcı ve grup kimlikleri (ID'leri), dosya boyutu (bayt cinsinden), dosya değiştirme zamanı (date(1) formatında ``%b %e %H:%M %Y'') ve dosya adı.

• -x: Belirtilen arşiv üyelerini, komut satırı argümanları tarafından adlandırılan dosyalara çıkarır. Hiçbir üye belirtilmemişse, arşivin tüm üyeleri geçerli dizine çıkarılır.

  Dosya mevcut değilse oluşturulur; mevcutsa, sahibi ve grubu değiştirilmeden kalır. Dosya erişim ve değiştirme zamanları, çıkarılma zamanı olarak ayarlanır (ancak -o seçeneğine bakın). Dosya izinleri, dosya arşive girildiğindeki izinlere ayarlanır; kullanıcı çıkarılan dosyanın sahibi veya yetkili kullanıcı değilse bu işlem başarısız olur.

ar aracı başarı durumunda 0 ile, bir hata oluşursa >0 ile çıkar.

Ortam

TMPDIR Geçici dosyalar oluşturulurken kullanılacak dizinin yol adı.

Dosyalar

/tmp varsayılan geçici dosya dizini ar.XXXXXX geçici dosya adları

Uyumluluk

Varsayılan olarak ar, on beş karakterden uzun adlara sahip arşiv üyelerini depolamak için kullanılan biçim değiştiğinden, eski arşivlerle uyumsuz olabilecek arşivler yazar. ar'ın bu sürümü, eski arşivleri okuyabilmesi ve yazabilmesi (-T seçeneği kullanılarak) bakımından ar'ın önceki sürümleriyle geriye dönük uyumludur. -T seçeneği yalnızca uyumluluk amacıyla sağlanmıştır ve gelecekteki bir sürümde kaldırılacaktır. Daha fazla bilgi için bkz. ar(5).

Standartlar

ar aracının IEEE Std 1003.2 (“POSIX.2”) işlevselliğinin bir üst kümesini sunması beklenmektedir.

Ayrıca Bkz.

ld(1), ranlib(1), strmode(3), ar(5)

Darwin 27 Temmuz 2005 Darwin