İsim
install – ikili dosyaları (binaries) yükler
Sinopsis
install [-bCcpSsUv] [-B uzantı] [-D hedef_dizini] [-f bayraklar] [-g grup] [-h özet] [-l bağ_bayrakları]
[-M metalog] [-m mod] [-o sahip] [-T etiketler] dosya1 dosya2
install [-bCcpSsUv] [-B uzantı] [-D hedef_dizini] [-f bayraklar] [-g grup] [-h özet] [-l bağ_bayrakları]
[-M metalog] [-m mod] [-o sahip] [-T etiketler] dosya1 ... dosyaN dizin
install -d [-Uv] [-D hedef_dizini] [-g grup] [-h özet] [-M metalog] [-m mod] [-o sahip] [-T etiketler]
dizin ...
Açıklama
Dosya(lar), hedef dosyaya veya dizine kopyalanır (veya -l seçeneği belirtilmişse bağlanır). Eğer hedef bir dizinse, dosya kendi orijinal adıyla o dizinin içine kopyalanır. Eğer hedef dosya zaten mevcutsa, -b seçeneği verilmişse dosya.old olarak yeniden adlandırılır veya izinler elveriyorsa üzerine yazılır. Farklı bir yedekleme uzantısı, -B seçeneğinin argümanı aracılığıyla belirtilebilir.
Seçenekler aşağıdaki gibidir:
-B uzantı -b seçeneği verildiğinde yedekleme uzantısı olarak bu uzantıyı kullanır.
-b: Üzerine yazmadan önce mevcut dosyaları dosya.old olarak yeniden adlandırarak yedekler. Farklı bir yedekleme uzantısı belirtmek için -B seçeneğine bakın.-C: Dosyayı kopyalar. Eğer hedef dosya zaten mevcutsa ve dosyalar aynıysa, hedefin değiştirilme zamanını (modification time) değiştirmez. Eğer hedefin dosya bayrakları ve modunun değiştirilmesi gerekmiyorsa, hedefin inode değişim zamanı da değiştirilmeden kalır.-c: Dosyayı kopyalar. Bu aslında varsayılan davranıştır. -c seçeneği yalnızca geriye dönük uyumluluk amacıyla dahil edilmiştir.
-D hedef_dizini Ögelerin yükleneceği DESTDIR (dosya hiyerarşisinin en üstü) yolunu belirtir. Eğer -M metalog kullanılıyorsa, metalog dosyasına kaydedilen dosya adlarının başındaki “hedef_dizini” (destdir) ifadesi kaldırılır. Bu seçenek, gerçek dosyaların nereye yükleneceğini etkilemez.
-d: Dizinleri oluşturur. Eksik üst dizinler gerektiğinde otomatik olarak oluşturulur.
-f bayraklar Hedef dosyanın dosya bayraklarını belirtir; kullanılabilir bayraklar ve anlamlarının listesi için chflags(1) kılavuz sayfasına bakın.
-g grup Bir grup belirtir. Sayısal GID değerine izin verilir.
-h özet Kopyalama sırasında, -M metalog dosyasına kaydedilmek üzere dosyaların özetini (digest) belirtilen özet algoritmasıyla hesaplar. -d seçeneği verildiğinde herhangi bir özet değeri üretilmez. Desteklenen özet algoritmaları:
none Özet yok. Varsayılan değer budur.
sha1 SHA-1 kriptografik mesaj özeti.
sha256 Dosyanın 256 bitlik SHA-2 kriptografik mesaj özeti.
sha512 Dosyanın 512 bitlik SHA-2 kriptografik mesaj özeti.
-l bağ_bayrakları Dosyayı kopyalamak yerine kaynağa bir bağlantı (link) oluşturur. Bağlantının türü bağ_bayrakları argümanı tarafından belirlenir. Geçerli bağ_bayrakları şunlardır: a (mutlak - absolute), r (göreli - relative), h (sabit - hard), s (sembolik - symbolic), m (karışık - mixed). Mutlak ve göreli seçenekleri yalnızca sembolik bağlantılar için etkilidir. Karışık (mixed) bağlantılar, aynı dosya sistemindeki dosyalar için sabit bağlantı, aksi takdirde sembolik bağlantıdır.
-M metalog Yüklenen her bir ögeyle ilişkili meta verileri, mtree(8) "tam yol" (full path) belirtim satırı biçiminde metalog dosyasına yazar. Meta veriler şunları içerir: dosya adı ve dosya türü; diğer seçeneklere bağlı olarak sahip, grup, dosya bayrakları, değiştirilme zamanı ve etiketler.
-m mod Alternatif bir mod belirtir. Varsayılan mod rwxr-xr-x (0755) olarak ayarlanmıştır. Belirtilen mod sekizlik (octal) veya sembolik bir değer olabilir; kullanılabilir mod değerlerinin açıklaması için chmod(1) kılavuz sayfasına bakın.
-o sahip Bir sahip belirtir. Sayısal UID değerine izin verilir.
-p: Erişim ve değiştirilme zamanlarını korur. Hedef dosya henüz mevcut değilse veya farklıysa kaynak dosyanın erişim ve değiştirilme zamanlarını koruması dışında, -C (karşılaştır ve kopyala) seçeneği belirtilmiş gibi dosyayı kopyalar.-S: Kopyalama işleminden sonra her dosyayı diske boşaltır (flush). Bu seçeneğin performans üzerinde göz ardı edilemeyecek bir etkisi vardır, ancak sistemin çökmesi veya yükleme tamamlandıktan kısa bir süre sonra gücün kesilmesi durumunda kısmi bir dosya ile kalma riskini azaltır.
Tarihsel olarak -S, mevcut bir hedefin değiştirilmesi sırasında bölünmezliği (atomicity) sağlamak için geçici dosyaların kullanılmasını da etkinleştiriyordu. Geçici dosyalar artık isteğe bağlı değildir.
-s: install, ikili dosyaları ayıklamak (strip) için strip(1) komutunu çalıştırır; böylece install çok sayıda sistem ve ikili dosya türü arasında taşınabilir olabilir. install aracının ikili dosyaları ayıklamak için başka bir programı kullanacak şekilde nasıl yönlendirileceği hakkında bilgi için aşağıya bakın.
-T etiketler -M metalog kullanılırken dosya için yazılacak mtree(8) etiketlerini belirtir.
-U: install aracının yetkisiz (unprivileged) olarak çalıştığını ve hedefin sahibini, grubunu veya dosya bayraklarını değiştirmeye çalışmaması gerektiğini belirtir. Güncellenmiş olması gereken bilgiler, -M metalog seçeneğiyle bir günlük dosyasına kaydedilebilir.-v: install aracının ayrıntılı modda çalışmasını sağlayarak, dosyaları yüklendikçe veya yedeklendikçe gösterir.
Varsayılan olarak install, “nodump” bayrağı hariç tüm dosya bayraklarını korur.
install aracı, bir dosyayı kendi üzerine taşımayı engellemeye çalışır.
/dev/null yüklemek boş bir dosya oluşturur.
Çevre Değişkenleri
install aracı, STRIPBIN çevre değişkeninin varlığını kontrol eder ve eğer mevcutsa, -s seçeneği belirtildiğinde çalıştırılacak program olarak bu değişkenin değerini kullanır.
DONTSTRIP çevre değişkeni mevcutsa, install aracı -s seçeneğinin herhangi bir belirtimini göz ardı eder.
Dosyalar
Hedef dizinde, XXXXXX kısmının mkstemp(3) tarafından belirlendiği INS@XXXXXX adında geçici dosyalar oluşturulur.
Çıkış Durumu
install aracı başarı durumunda 0, bir hata oluştuğunda ise >0 değeriyle sonlanır.
Uyumluluk
Tarihsel olarak install, dosyaları varsayılan olarak taşırdı. Bu varsayılan davranış FreeBSD 4.4 sürümünde kopyalama olarak değiştirilmiştir.
Ayrıca Bakınız
chflags(1), chgrp(1), chmod(1), cp(1), mv(1), strip(1), getgrnam(3), getpwnam(3), chown(8)
Geçmiş
install aracı ilk olarak 4.2BSD sürümünde yer almıştır.
Hatalar
-M seçeneğinin anlamı FreeBSD 9.2 sürümünden itibaren değişmiştir ve artık bir argüman almaktadır. Eski -M seçeneğini kullanan komut satırları bir hata alacaktır veya nadir durumlarda, yükleme yapmak yerine günlükleri birden fazla kaynak dosyadan ilkinin sonuna ekleyecektir.
install aracı anormal şekilde sonlanırsa, hedef dizinde geçici dosyalar kalabilir.
Dosya bayrakları, bir NFS dosya sistemi üzerinde fchflags(2) ile ayarlanamaz. Diğer dosya sistemlerinde bayrak kavramı yoktur. install aracı, bayrakları desteklemeyen bir dosya sisteminde bayraklar ayarlanamadığında yalnızca bir uyarı verecektir.
install aracı, -C sabit bağlantıları kopardığında -v seçeneği ile bir dosyanın kopyalandığını yanlış bir şekilde belirtir.
macOS 26.4 April 16, 2024 macOS 26.4