Bu belge pisi'nin komut satırında (pisi-cli) kullanımı hakkında çeşitli bilgiler içerir.

Depo işlemleri

Depo eklemek

Depo eklemek için add-repo komutunu depo adı depo adresi parametreleriyle çalıştırıyoruz.
n
npisi add-repo depo_adı http://depo.adresi.com/depo/dizini/pisi-index.xml
n
n'depo adresi' parametresinin alabileceği değerler:
n
nYerel adresler (örn /home/groni/pisi/depom/pisi-index.xml)
n
nİnternet adresleri (https://pisilinux.org/pisi-index.xml ya da ftp://pisilinux.org.com/pub/pisi-index.xml)
n
nDepo indeks dosyasının adı öntanımlı olarak pisi-index.xml'dir, fakat tercihe bağlı olarak aynı dosyanın sıkıştırılmış hali pisi-index.xml.xz adıyla sunulur, bu sayede bant genişliğinden tasarruf edilir. PiSi'nin 148'inci yayımından itibaren depo eklerken dağıtım sürümü ve mimarisi kontrolü desteği gelmiştir. Özellikle bu desteği kapamak istiyorsanız --ignore-check parametresini kullanabilirsiniz.

Depo kaldırmak

Depo kaldırmak için remove-repo komutunu sadece bir depo adıyla birlikte çağrıyoruz, pisi remove-repo depo_adı  eğer birden fazla depoyu birden kaldırmak istiyorsak depoların isimlerini boşlukla ayırarak yazıyoruz. pisi remove-repo birinci_deponun_adı ikinci_deponun_adı

Depoları listelemek

Depoları listelemek için list-repo komutunu kullanıyoruz. pisi list-repo Burada aktif olan depolar yeşil, pasif olan depolarsa kırmızı renkte görülecektir.
n
nDepoları pasifleştirmek
n
nSisteminizdeki depoları isterseniz kapatabilirsiniz. Kapatılan depolar işlemlerde dikkate alınmaz. Depoları kapatmak için disable-repo komutunu kullanıyoruz.
npisi disable-repo depo_adı
n
nEğer birden fazla depoyu birden kapatmak istiyorsak depoların isimlerini boşlukla ayırarak yazıyoruz.
npisi disable-repo birinci_deponun_adı ikinci_deponun_adı
n
nDepoları etkinleştirmek
nKapattığınız depoları açmak içinse enable-repo komutunu kullanıyoruz.
npisi enable-repo depo_adı

Eğer birden fazla depoyu birden açmak istiyorsak depoların isimlerini boşlukla ayırarak yazıyoruz.
npisi enable-repo birinci_deponun_adı ikinci_deponun_adı
n
nDepo güncellemek
nBir depoyu güncellemek istiyorsak update-repo komutunu kullanıyoruz,
npisi update-repo
n
nHerhangi bir parametre vermezseniz etkin olan bütün depolar güncellenir. PiSi'nin normal davranışı, mevcut veritabanı depodakiyle aynıysa depodaki index dosyasını indirmemek şeklinde tasarlanmıştır. Veritabanını her halükârda güncellemek istiyorsanız --force parametresini kullanabilirsiniz. Eğer bir ya da daha fazla depoyu güncellemek istiyorsak depo isimlerini boşlukla ayırarak komutun sonuna ekliyoruz. Örneğin belirli bir depo için:
npisi update-repo depo_adı ve birden fazla depo için: pisi update-repo depo_adı diger_bir_depo_adı 
n
nBileşenleri listelemek
n
nTüm bileşenleri listelemek için list-components komutunu kullanıyoruz,
npisi list-components
n
nÇıktının bileşenler hakkında daha ayrıntılı bilgi vermesini istiyorsanız --long parametresini verebilirsiniz.
npisi list-components --long

eğer belirli bir depodaki bileşenleri listelemek istiyorsak --repository depo_adı parametresini veriyoruz.
npisi list-components --repository depo_adı
n
nDepo indeksi oluşturmak
nEğer herhangi bir kaynak ya da ikili paket deposunun indeksini oluşturmak istiyorsak ana dizine gidip index komutunu veriyoruz.
npisi index --skip-signing
n
nBu komut bir dizinde PiSi dosyaları arar, onlardan PiSi etiketlerini çıkarır ve bilgiyi pisi-index.xml adında bir XML dosyasında toplar. Birden fazla dizin verirseniz, komut yine çalışır, fakat herşeyi tek bir katalog dosyasına koyar.
nindex komutunun alabileceği parametrelerden bazıları ve açılamaları şu şekildedir:

--absolute-urls Kataloglanan dosyalar için mutlak bağlar sakla.
n--output arg Katalog çıktı dosyası
n--compression-types arg Katalog dosyası için virgülle ayrılmış sıkıştırma türleri
n--skip-sources PiSi spec dosyalarını kataloglama.
n--skip-signing Kataloğu imzalama.

2.Paket işlemleri

nPaket kurmak
nPisi paketlerini kurmak için install komutunu kullanıyoruz, eğer birden fazla paket kuracaksak isimlerini boşlukla ayırarak komutun sonuna ekliyoruz,
npisi install paketadı başka-bir-paket-adı
n
neğer yerel bir dosyadan kuracaksak dosyanın tam adını giriyoruz, birden fazla paket kuracaksak isimlerini boşlukla ayırarak yazıyoruz.
npisi install /home/evdizini/pisi_depom/paketadı.pisi
n
nHalihazırda kurulu paketleri yeniden kurmak için --reinstall parametresini kullanıyoruz.
npisi install --reinstall paketadı
n
nDağıtım sürümü ve mimarisi kontrolünü atlayarak paket kurmak için --ignore-check parametresini kullanıyoruz.
npisi install --ignore-check paketadı
n
nDosya çakışmalarını gözardı ederek paket kurmak için --ignore-file-conflicts parametresini kullanıyoruz.
npisi install --ignore-file-conflicts paketadı
n
nPaket çakışmalarını gözardı ederek paket kurmak için --ignore-package-conflicts parametresini kullanıyoruz.
npisi install --ignore-package-conflicts paketadı
n
nPaket kaldırmak
nPisi paketlerini kaldırmak için remove komutunu kullanıyoruz.
npisi remove paketadı
n
nEğer birden fazla paket kaldırmak istiyorsak isimlerini boşlukla ayırarak komutun sonuna ekliyoruz. Ayrıca --component parametresiyle paket isimleri yerine bileşen de belirtilebilir, bu durumda bileşen altındaki tüm paketler kaldırılır. Çomar yapılandırma ajanını es geçerek paket kaldırmak için --ignore-comar parametresi kullanılabilir.
npisi remove --ignore-comar paketadı
n
nBağımlılık bilgilerini dikkate almadan paket kaldırmak için --ignore-dependency parametresi kullanılabilir.
npisi remove --ignore-dependency paketadı
n
nGerçekte hiçbir eylem gerçekleştirmeden, sadece neler olacağını görmek için --dry-run parametresi kullanılabilir.
npisi remove --dry-run paketadı
n
nDeğiştirilen ayar dosyaları dahil paketin tüm dosyalarını kaldırmak için --purge parametresi kullanılabilir.
npisi remove --purge paketadı
n
nEmniyet mandalını yok sayarak paket kaldırmak için --ignore-safety parametresi kullanılabilir.
npisi remove --ignore-safety paketadı
n
nPaket güncellemek
n
nPaket güncellemek için upgrade komutunu kullanıyoruz, eğer birden fazla paketi güncelleyeceksek isimlerini boşlukla ayırarak komutun sonuna ekliyoruz.
npisi upgrade paketadi
n
nDepodaki tüm güncellemeleri yapmak istiyorsak upgrade komutunu parametresiz kullanıyoruz.
npisi upgrade
n
nPaket hakkında bilgi almak 
nPaket bilgilerini görüntülemek için info komutunu kullanıyoruz, birden fazla paketin bilgisini görmek istiyorsak isimlerini boşlukla ayırarak komutun sonuna yazıyoruz. 
npisi info paketadı
n
nPaketteki dosyaların bir listesini görmek için --files parametresini kullanıyoruz.
npisi info --files paketadı
n
nPaketteki dosyaların sadece yollarını görmek içinse --files-path parametresini kullanıyoruz.
npisi info --files-path paketadı
n
nKaynaktan paket inşa etmek
nBir paketi kaynaktan inşa etmek istediğimizde build komutunu kullanıyoruz. Yerel veya uzak bir adresteki pspec.xml dosyasının adresinin verilmesi yeterlidir, PiSi gerekli dosyaları indirip paketi inşa edecektir. Kaynak depo kullanıyorsanız, doğrudan kaynak depoda bulunan bir paketin adını vererek PiSi'nin o paketi inşa etmesini sağlayabilirsiniz. Örneğin yereldeki bir paketin pspec.xml dosyasını kullanarak şu şekilde paket inşası yapılabilir.
npisi build /home/groni/ornek/pisi/pspec.xml
n
nBir sunucudaki paket inşa edilmek isteniyorsa da şöyle bir komut kullanılabilir:
npisi build http://sunucu.adresi.com/paketler/pspec.xml
n
nİnşa işleminin değişik safhalarını işletmek istediğinizde ya da inşa işleminin sizin kontrolünüzde gerçekleşmesini istediğinizde çeşitli parametreler kullanabilirsiniz:
n--fetch Kaynak arşivi indirdikten sonra inşayı sonlandır.
n--unpack Kaynak arşivini açtıktan, sha1sum denetimi yaptıktan ve yamaları uyguladıktan sonra inşayı sonlandır.
n--setup Yapılandırma adımından sonra inşayı sonlandır.
n--build Derleme adımından sonra inşayı sonlandır.
n--check Test adımından sonra inşayı sonlandır.
n--install Kurulum adımından sonra inşayı sonlandır.
n--package PiSi paketi oluştur.
n
ninşa seçenekleriyle ilgili bazı önemli parametrelerse şu şekildedir:
n--ignore-dependency Bağımlılık bilgilerini dikkate alma.
n--ignore-action-errors ActionsAPI kaynaklı hataları yoksay.
n--ignore-safety Emniyet mandalını yoksay.
n--ignore-check Test adımını yoksay.
n--ignore-sandbox İnşa işlemini inşa klasörüyle sınırlama.
n
nKaynak depodan paket kurmak
nKaynak depodaki bir paketi inşa edip kurmak istediğimizde emerge komutunu kullanıyoruz, bu komut paketi tüm bağımlılıklarıyla birlikte kuruyor.
npisi emerge paketadı
n
nBir bileşen altındaki tüm paketler de derlenip kurulabilir. Örneğin:
npisi emerge -c game
n
nDepodaki paketleri listelemek
nlist-available komutu, belirtilen depolarda yayınlanan PiSi paketlerinin kısa bir listesini verir. Eğer tek bir depodaki paketleri listelemek istiyorsak list-available komutuna bir depo adını parametre olarak veriyoruz,
npisi list-available depo_adi

eğer tüm açık depolardaki paketleri listelemek istiyorsak list-available komutunu parametresiz çalıştırıyoruz.
npisi list-available
n
nSadece kurulu olmayan paketleri göstermek için de --uninstalled parametresini kullanıyoruz.
npisi list-available --uninstalled
n
nVerilen bileşendeki paketleri listelemek içinse --component parametresi kullanılabilir.  Örneğin:
npisi list-available --component game
n
nGüncellemeleri listelemek
nGüncellemeleri listelemek için list-upgrades komutunu kullanıyoruz,
npisi list-upgrades
n
nKurulu paketleri listelemek
nKurulu paketleri listelemek için list-installed komutunu kullanıyoruz.
npisi list-installed
n
nSadece verilen makine tarafından inşa edilmiş paketleri listelemek için --with-build-host parametresi kullanılabilir. Örneğin:
npisi list-installed --with-build-host localhost
n
nSadece verilen bileşen altındaki kurulu paketleri listelemek için --component parametresi kullanılabilir. Örneğin:
npisi list-installed -c game
n
nAyrıca --install-info parametresiyle detaylı kurulum bilgisi, --long parametresiyle de uzun biçimli çıktılar alınabilir.
n
nBekleyen paketleri listelemek
nYapılandırılmayı bekleyen paketleri listelemek için list-pending komutunu kullanıyoruz.
npisi list-pending
n
nKaynakları listelemek
nKullanılabilir kaynak paketleri listelemek için list-sources komutunu kullanıyoruz.
npisi list-sources
n
nKalan paketleri yapılandırmak
nEğer kurulum sırasında bazı paketlerin ÇOMAR yapılandırması atlandıysa, o paketler yapılandırılmayı bekleyen paketler listesine eklenir. ÇOMAR yapılandırması yapılmamış bu tip paketleri yapılandırmak içinconfigure-pending komutunu kullanıyoruz.
npisi configure-pending
n
nPaket aramak
nPaket aramak için search komutunu kullanıyoruz. Bu komut; özet, açıklama ve paket ismi alanlarında belirtilen kavramı içeren paketlerin listesini çıkarır. Öntanımlı arama paket veritabanında yapılır. Kurulum veritabanında arama yapmak için --installdb parametresi ve veya kaynak veritabanında arama yapmak için --sourcedb parametreleri kullanılabilir.
npisi search anahtar_kelime diğer_anahtar_kelime
n
nArama sadece belli bir depoda da yapılabilir.
npisi search anahtar_kelime --repository depo_adı
n
nAramalar --name ile sadece paket isimlerinde, --summary ile paket özetlerinde veya --description ile paket açıklamalarında da yapılabilir. Kurulumu denetlemek Yüklenen her dosya için bir kontrol toplamı tutulur. check komutu paketin kurulumunun doğruluğunu kontrol etmek için bu toplamları kullanır. Paketlerin adlarını vermeniz yeterlidir. Eğer hiç paket adı verilmemişse, kurulu durumdaki bütün paketler doğrulanır.
npisi check paketadı
n
ncheck komutu -c parametresiyle birlikte kullanılarak bir bileşendeki tüm paketlerin kontrolünüde yapılabilir.
npisi check -c bileşenadı

Diğer işlemler

PiSi veritabanlarını yeniden inşa etmek
nPiSi veritabanlarını yeniden inşa etmek için rebuild-db komutunu kullanıyoruz.
npisi rebuild-db
n
nÖnbellek dosyalarını temizlemek
nKaynaklar, paketler ve geçici dosyalar /var dizinine kaydedilir. Bu dosyalar uzun vadede çok yer kaplayabilir. Önbellekteki bu dosyaları silmek için delete-cache komutunu kullanıyoruz.
npisi delete-cache
n
nDosya aramak
nBir dosyanın hangi pakete ait olduğunu bulmak için search-file komutunu kullanıyoruz.
npisi search-file /path/dosya
n
nPaket ilişkilerinin grafiğini çıkarmak
nVerilen paketlerden başlayarak, bağımlılık ve paket çakışmalarını da dikkate alarak paket ilişkilerinin grafiğini çıkarmak için graph komutunu kullanıyoruz. graph komutu, öntanımlı olarak depo paketleri arasındaki ilişkileri çıkarır ve dosyayı graphviz biçiminde 'pgraph.dot' dosyasına yazar.
npisi graph paketadi
n
nKullanılmayan kilitleri temizlemek
nPiSi veritabanı erişimini yönetmek için dosya kilitleri kullanır. Kullanılmayan kilit dosyalarını veritabanı dizininden kaldırmak için clean komutunu kullanıyoruz.
npisi clean

Yardım almak
nKomut satırında pisi kullanımı hakkında yardım almak için help komutunu kullanıyoruz.
npisi help
n
nEğer belirli bir komut için yardım almak istiyorsak şu şekilde kullanıyoruz.
npisi help komut