Özet
installer [-dominfo] [-volinfo] [-pkginfo] [-showChoicesXML]
[-showChoicesAfterApplyingChangesXML <XMLDosyaYolu>]
[-applyChoiceChangesXML <XMLDosyaYolu>] [-query <bayrak>] [-allow] [-dumplog] [-help]
[-verbose | -verboseR] [-vers] [-config] [-plist] [-file <dosyaYolu>]
[-lang <ISODilKodu>] [-listiso] -pkg <paketYolu> -target aygıt
Açıklama
installer komutu, macOS yükleyici paketlerini belirtilen bir etki alanına (domain) veya birime (volume) yüklemek için kullanılır. installer komutu, her çağrıda, -package parametresi (-pkg eş anlamlı olarak kabul edilir) ile belirtilen tek bir paket yükler. Bu, tek bir paket veya bir meta paket (metapackage) olabilir. Meta paket durumunda, bir paketin kontrol araçları tarafından elenmediği sürece varsayılan yüklemenin parçası olan paketler yüklenecektir.
Hedef birim -target parametresi (-tgt eş anlamlı olarak kabul edilir) ile belirtilir. installer komutu çağrıldığında hedef birimin halihazırda bağlanmış (mounted) olması gerekir.
installer komutunun çalışması için root ayrıcalıkları gerekir. Eğer bir paket kimlik doğrulaması gerektiriyorsa (paketin .info dosyasında ayarlanır), yükleyicinin root olarak veya sudo(8) komutuyla çalıştırılması gerekir (ancak -store seçeneği altındaki ek tartışmalara bakın).
Yükleyici, kurulumdan sonra makineyi yeniden başlatmaktan sorumlu değildir. Sistemi yeniden başlatmak için reboot(8) veya shutdown(8) -r now komutunu kullanın.
Yükleyici iki tür çıktı görüntüler. Varsayılan kısa (terse) çıktı, kurulumları otomatikleştirmek (veya betik haline getirmek) için betik dilleri tarafından ayrıştırılmak üzere tasarlanmıştır; ayrıntılı (verbose) çıktı ise ek bilgiler ve açıklayıcı hata mesajları sağlar.
Seçenek bayraklarının listesi ve açıklamaları:
-dominfo Yazılım paketinin yüklenebileceği etki alanlarının (domains) bir listesini görüntüler. Örneğin: LocalSystem veya CurrentUserHomeDirectory. Listelenen etki alanları, komut çalıştırıldığında kullanılabilir ve etkin olanlardır.
-volinfo Yazılım paketinin yüklenebileceği birimlerin (volumes) bir listesini görüntüler. Listelenen birimler, komut çalıştırıldığında bağlı ve kullanılabilir durumda olan birimlerdir.
-pkginfo Hedef birime yüklenebilecek paketlerin bir listesini görüntüler. Paket kaynağı olarak bir meta paket verilirse, onun tüm alt paketleri listelenir.
-query bayrak Bir paketi, meta verileri hakkındaki bilgiler için sorgular. Desteklenen bayraklar için -help seçeneğine bakın.
-allowUntrusted Güvenilmeyen (veya süresi dolmuş) bir sertifika ile imzalanmış bir paketin yüklenmesine izin verir.
-dumplog Ayrıntılı günlük (log) bilgileri, LOG_INSTALL özelliği kullanılarak her zaman syslog'a gönderilir (ve /var/log/install.log dosyasına yazılır). -dumplog ek olarak bu günlüğü standart hata çıktısına yazar.
-help: Parametre listesini açıklayan yardım ekranını görüntüler.
-verbose Varsayılan çıktıdan daha açıklayıcı bilgiler görüntüler. Daha okunabilir bir çıktı görmek için bu parametreyi -pkginfo ve -volinfo bilgi talepleriyle birlikte kullanın. Varsayılan çıktı betik yazımı için biçimlendirilmiştir.
-verboseR Çıktının kolay ayrıştırma için biçimlendirilmesi dışında -verbose ile aynı bilgileri görüntüler.
-vers: Bu komutun sürümünü görüntüler.
-config Komut satırı yükleme argümanlarını daha sonra kullanmak üzere biçimlendirir. Çıktı stdout'a gönderilir ancak bir yapılandırma dosyası oluşturmak için bir dosyaya yönlendirilebilir. Bu seçenek belirtildiğinde, aslında bir kurulum gerçekleştirilmez. Bu yapılandırma dosyası, uzun bir yükleme argümanları serisi yazmak yerine -file parametresine argüman olarak sağlanabilir. Yapılandırma dosyası, birden fazla özdeş kurulum gerçekleştirmek için kullanılabilir. Bir yapılandırma dosyasını aşağıdaki gibi oluşturabilirsiniz:
installer -pkg ~/Documents/Foo.pkg -target / -config > /tmp/configfile.plist
-plist: Yükleyici çıktısını bir XML dosyası olarak biçimlendirir ve varsayılan olarak stdout'a gönderir. Bu parametreyi -dominfo, -volinfo ve -pkginfo için kullanın.
-file dosyaYolu Anahtar/değer sözlüğünde parametre bilgilerini içeren XML dosyasının yolunu belirtir. Bu dosya, komut satırı parametreleri yerine kullanılabilir ve komut satırındaki tüm parametrelerin yerine geçer. Bu parametreyi yazdığınızda, XML dosyasının yolunu yazarsınız. -config tarafından üretilen yapılandırma dosyası ile kullanın. Örneğin:
installer -file /tmp/configfile.plist
-lang ISODilKodu Yüklenen sistemin varsayılan dili (ISO biçiminde). Bu yalnızca bir sistem (işletim sistemi) yüklemesi gerçekleştirirken gereklidir, aksi takdirde yoksayılır. Ayarlanan dilin makinede gerçekten var olduğundan emin olmak için herhangi bir doğrulama yapılmaz, ancak ISO dil kodunun geçerli olduğundan emin olmak için doğrulama yapılır.
-listiso Yükleyicinin tanıdığı geçerli ISO dil kodlarının listesini görüntüler.
-showChoiceChangesXML Paketin ( -pkg ile belirtilen) yükleme seçeneklerini XML biçiminde stdout'a yazdırır. Bu, seçim özniteliklerinin değiştirilmesine ve kurulum sırasında
-applyChoiceChangesXML.seçeneği kullanılarak uygulanmasına olanak tanır. Bu XML biçiminin ayrıntıları için SEÇİM DEĞİŞİKLİKLERİ DOSYASI (CHOICE CHANGES FILE) bölümüne bakın.
-applyChoiceChangesXML XMLDosyaYolu Kurulumdan önce, XMLDosyaYolu ile belirtilen yükleme seçimi değişikliklerini paketteki varsayılan seçimlere uygular. Bu, komut satırı yükleyicisinin nelerin yükleneceğini özelleştirmesine olanak tanır. Bu XML biçiminin ayrıntıları için SEÇİM DEĞİŞİKLİKLERİ DOSYASI bölümüne bakın. Seçim değişiklikleri uygulanırken karşılaşılan sorunlar LOG_INSTALL özelliğine (yani /var/log/install.log dosyasına) ve -dumplog kullanılıyorsa stdout'a bildirilecektir.
-showChoicesAfterApplyingChangesXML XMLDosyaYolu XMLDosyaYolu ile belirtilen yükleme seçimi değişikliklerini paketteki varsayılan seçimlere uygular ve ardından elde edilen seçim durumunu stdout'a döker. Girdi ve çıktı XML biçimi SEÇİM DEĞİŞİKLİKLERİ DOSYASI bölümünde açıklandığı gibidir. Bir paketteki bir seçimi değiştirmek dolaylı olarak diğer seçimleri de değiştirebileceğinden, bu seçenek belirli bir choiceChanges dosyasının istenen etkiye sahip olacağını onaylamanıza olanak tanır. Bu seçeneği kullanırken bir -target belirtmeniz gerekir, çünkü değerlendirilen seçimler hedef diskin durumuna göre de değişebilir.
-showChoicesXML Paketin ( -pkg ile belirtilen) yükleme seçeneklerini hiyerarşik bir XML biçiminde stdout'a yazdırır. Bu,
-applyChoiceChangesXML.ile kullanılan biçimle aynı değildir. Bu seçenek yalnızca System Image Utility için sağlanmıştır.-store: -package ile belirtilen ürün arşivini, Mac App Store üzerinden yüklenecekmiş gibi yükler. Bu modda diğer hiçbir seçenek desteklenmez. (-target belirtebilirsiniz, ancak izin verilen tek değer kök birim bağlama noktası olan / dizinidir). En iyi Mac App Store sadakati için yükleyiciyi bir yönetici (admin) kullanıcısı olarak çalıştırın (sudo kullanmadan); yükleme başlamadan önce yönetici kullanıcınızın şifresi istenecektir.
Bu mod, Mac App Store'a gönderilmeden önce bir ürün arşivini test etmek için sağlanmıştır. Bir ürün arşivinin nasıl oluşturulacağı hakkında bilgi için productbuild(1) sayfasına bakın.
Aygıtlar
Hedef için bir aygıt (device) parametresi aşağıdakilerden herhangi biri olabilir:
- -dominfo tarafından döndürülen değerlerden herhangi biri
- Aygıt düğümü (device node) girdisi. /dev/disk* biçimindeki herhangi bir girdi. Örn: /dev/disk2
- Disk belirteci. disk* biçimindeki herhangi bir girdi. Örn: disk1s9
- Birim bağlama noktası. /Volumes/BağlamaNoktası biçimindeki herhangi bir girdi. Örn: /Volumes/Untitled
- Birim UUID'si. Örn: 376C4046-083E-334F-AF08-62FAFBC4E352
Seçim Değişiklikleri Dosyası
Bir “choiceChanges” dosyası, tek tek yükleyici seçimlerinin seçilmesine veya seçiminin kaldırılmasına olanak tanır. Verilen bir paket için şablon bir choiceChanges dosyası, -showChoiceChangesXML seçeneğiyle oluşturulabilir ve aşağıdaki gibi yorumlanır.
choiceChanges dosyası, bir sözlükler dizisi içeren bir özellik listesidir (property list). Her sözlük aşağıdaki üç anahtara sahiptir:
Key Description choiceIdentifier Değiştirilecek seçim için belirteç (string) choiceAttribute Aşağıda açıklanan öznitelik adlarından biri (string) attributeSetting Seçim özniteliğine (choiceAttribute) bağlı bir ayar, aşağıda açıklanmıştır (number veya string)
choiceAttribute ve attributeSetting değerleri aşağıdaki gibidir:
choiceAttribute attributeSetting Description selected (number) seçimi işaretlemek için 1, işaretini kaldırmak için 0 enabled (number) seçimi etkinleştirmek için 1, devre dışı bırakmak için 0 visible (number) seçimi göstermek için 1, gizlemek için 0 customLocation (string) seçimin yükleneceği yol (aşağıya bakın)
Tek bir seçim için ayarlanmış birden fazla öznitelik olabileceğinden, aynı choiceIdentifier için birden fazla sözlük bulunabileceğini unutmayın.
customLocation özniteliği, bir seçim için yalnızca o seçim açıkça kullanıcı tanımlı bir yola izin veriyorsa ayarlanabilir. Yani, Yükleyici (Installer) uygulamasının Özelleştir (Customize) bölmesinde görüntülendiğinde seçimin bir Konum (Location) açılır penceresi varsa, customLocation aracılığıyla ayarlanabilir. (Aksi takdirde, kurulumun düzgün çalışması için paket yazarının özel yükleme konumlarını hesaba katması gerektiğinden, kurulum yolları keyfi olarak değiştirilemez.)
Örnekler
installer -dominfo -pkg InstallMe.pkg
installer -volinfo -pkg InstallMe.pkg
installer -pkginfo -pkg DeveloperTools.mpkg
installer -pkg OSInstall.mpkg -target LocalSystem
installer -pkg OSInstall.mpkg -target / -lang en
installer -pkg DeveloperTools.mpkg -target /
installer -pkg InstallMe.pkg -target "/Volumes/Macintosh HD2"
installer -pkg InstallMe.pkg -file /tmp/InstallConfigFile
installer -pkg InstallMe.pkg -target /dev/disk0s5
Çevre
COMMAND_LINE_INSTALL installer komutu kullanılarak bir kurulum gerçekleştirildiğinde ayarlanır.
Dosyalar
/usr/sbin/installer Yazılım paketi yükleme aracı
Ayrıca Bakınız
syslog.conf(5) reboot(8) shutdown(8) softwareupdate(8) sudo(8) systemsetup(8)
Geçmiş
Komut satırı yükleme aracı ilk olarak Mac OS X'in 10.2 sürümünde ortaya çıkmıştır.
macOS April 19, 2007 macOS