| SETPCI(8) | Sistem Yönetim Komutları | SETPCI(8) |
İSİM
setpci — PCI aygıtlarını yapılandırır
KULLANIM
setpci |
[SEÇENEKLER] AYGITLAR İŞLEMLER... |
AÇIKLAMA
setpci, PCI aygıtlarını yapılandırmak ve sorgulamak için kullanılan bir araçtır.
Bütün sayılar onaltılık tabanda girilir.
Bazı işletim sistemlerinde yapılandırma alanının standart başlığının okumaları hariç, hemen hemen tüm işlemler için root ayrıcalıkları gerektirir. Erişim haklarıyla ilgili ayrıntılar için bkz: lspci(8)
SEÇENEKLER
Genel seçenekler
-
-v -
Sonuçlar daha ayrıntılı olur ve yapılandırma alanı erişimleri hakkında ayrıntılı bilgi gösterilir.
-
-f -
Şayet yapılacak bir işlem yoksa (mesela bir pci kart belirtilememişse) setpci aracının bir çıktı vermemesini sağlar. Bu seçenek genellikle dağıtımların yapılandırma betikleri tarafından, sorgudaki pci kartın makinede olup olmadığının ya da düzgün çalışıp çalışmadığının tespiti için kullanılır.
-
-D -
'Gösteri kipi' -- Yapılanırma yazmaçlarına hiçbir şey yazmaz. Komutu
setpci -vDşeklinde kullanarak oldukça karmaşık olan komut diziminin sonucu gerçekte komut uygulanmadan görülebilir. -
-r -
Her işlem belirli bir aygıtı seçerse veri yolu taramasını önler (
-sseçiciyi belirli etki alanı, veri yolu, yuva ve işlevle kullanır). Bu daha hızlıdır, ancak aygıt yoksa, boş bir aygıt kümesini eşleştirmek yerine başarısız olur. -
--version -
setpci aracının sürüm bilgilerini gösterir. Bu seçenek tek başına kullanılmalıdır.
-
--dumpregs -
Tüm PCI yazmaçlarının ve yeteneklerinin listesini gösterir. Bu seçenek tek başına kullanılmalıdır.
PCI erişim seçenekleri
PCI araçları, PCI aygıtları ile haberleşmek için PCI kütüphanesini kullanır (Bkz: pcilib(7)). Davranışı etkilemek için aşağıdaki seçenekler kullanılabilir:
-
-AYÖNTEM -
Kütüphanede, PCI donanımına erişmek için çeşitli yöntemler bulunmaktadır. Ön tanımlı olarak, kullanılabilir ilk erişim yöntemini kullanır, ancak bu seçenekle, bu davranış geçersiz kılınaabilir. Kullanılabilir yöntemlerin listesi ve açıklamaları için
-A helpçıktısından yaralanılabilir. -
-OİSİM=DEĞER -
Kitaplığın davranışı, birkaç değişkenle denetlenir. Bu seçenekle, herhangi bir değişkenin değeri ayarlanabilir. Bilinen değişken isimlerinin listesi ve bunların ön tanımlı değerleri için
-O helpçıktısından yaralanılabilir. -
-H1 -
Intel yapılandırma mekanizması 1 üzerinden doğrudan donanım erişimi kullanılır.
-A intel-conf1seçeneği için bir kısayoldur. -
-H2 -
Intel yapılandırma mekanizması 2 üzerinden doğrudan donanım erişimi kullanılır.
-A intel-conf2seçeneği için bir kısayoldur. -
-G -
Kütüphanenin hata ayıklama seviyesini artırır.
Aygıt seçimi
-
-s[[[[ETKİ_ALANI]:]VERİ_YOLU]:][AYGIT][.[İŞLEV]] -
Yalnızca belirtilen etki alanındaki aygıtlar gösterilir (makinede birkaç konak köprüsü olması durumunda, bunlar ortak bir veri yolu numarası alanını paylaşabilir veya her biri kendi PCI etki alanını adresleyebilir; etki alanları
0'danffff'ye kadar numaralandırılmıştır: veri yolu (0ilaff), aygıt (0ila1) ve işlev (0ila7). Aygıt adresinin her bileşeni atlanabilir veya "*" ile belirtilebilir, her ikisi de "herhangi bir değer" anlamına gelir. Tüm sayılar onaltılıktır. Örneğin, "0:" veri yolu0üzerindeki tüm aygıtlar; "0" ise herhangi bir veri yolu üzerindeki aygıt0'ın tüm işlevleri anlamına gelir; "0.3" tüm veri yollarında aygıt0'ın üçüncü işlevini seçer ve ".4" her birinin yalnızca dördüncü işlevini gösterir. -
-d[SATICI]:[AYGIT][:SINIF[:ARAYÜZ]] -
Yalnızca belirtilen satıcı, aygıt, sınıf kimliği ve yazılım geliştirme arayüzüne sahip aygıtları gösterir. Kimlikler onaltılık olarak verilir ve belirtilmeyebilir veya her ikisi de "herhangi bir değer" anlamına gelen "
*" olarak verilebilir. Sınıf kimliği, "herhangi bir rakam" anlamına gelen "x" karakterlerini içerebilir.
-s ve -d birlikte kullanılırsa, yalnızca her iki seçime de uyan aygıtlar seçilir. Aynı türde birden fazla seçenek belirtildiğinde, en sağdaki diğerlerini geçersiz kılar.
İŞLEMLER
İki çeşit işlem vardır: okumak ve yazmak. Bir yazmacı okumak için adını belirtmeniz yeterlidir. Yazma işlemleri isim=değer,değer... biçimindedir; burada her değer ya bir onaltılık sayıdır ya da hem veri hem de maskenin onaltılık sayılar olduğu veri:maske türünde bir ifadedir. İkinci durumda, yalnızca maskedeki ikil bitlere karşılık gelen bitler değiştirilir (teknik olarak bu bir okuma-değiştirme-yazma işlemidir).
Bir yazmacı tanımlamanın birkaç yolu vardır:
-
Onaltılık tabanda adresi belirtilir.
-
Adı belirtilir. setpci, standart yapılandırma başlıklarındaki tüm yazmaçların isimlerini bilir. Tam listeyi almak için setpci --dumpregs kullanılabilir. Bu yazmaçların kesin anlamı için PCI veri yolu özelliklerine veya kısa bir taslak için
header.hveya/usr/include/pci/pci.hdosyasına bakılabilir. -
Yazmaç bir PCI yeteneğinin parçasıysa, ilk yazmacının adresini almak için yeteneğin adı belirtilebilir.
--dumpregsçıktısında 'CAP_' veya 'ECAP_' ile başlayan adlara bakılabilir. -
Yeteneğin adı setpci tarafından bilinmiyorsa, buna
CAPnumveyaECAPnumbiçiminde numarasıyla başvurulabilir; buradanum, yeteneğin onaltılık tabanda sayısal tanıtıcısıdır. -
Adrese bir
konum(onaltılık sayı) eklemek için önceki biçimlerin her birinin ardından+konumgelebilir. Bu özellik, bir yetenek içindeki yazmaçların adreslenmesi veya standart yazmaçların parçalarını değiştirmek için faydalı olabilir. -
Kaç bayt (1, 2 veya 4) aktarılacağını seçmek için bir genişlik belirteci olarak
.B,.Wveya.Leklenebilir. Bir yazmaçtan ismiyle bahsediliyorsa ve yazmacın genişliği iyi biliniyorsa genişlik atlanabilir. -
Son olarak, birden çok yetenek varsa,
@numarakullanılarak hangisinin hedefleneceği belirtilebilir. Sıralama0'dan başlar.
Tüm yazmaç adları ve genişlik belirteçleri büyük/küçük harfe duyarsızdır.
ÖRNEKLER
-
COMMAND -
16 bitlik komut yazmacı için sorgu.
-
4.w -
Aynı yazmacın sayısal adresi.
-
COMMAND.l -
Komut yazmacının konumundan başlayan 32 bitlik bir kelime ister; yani komut ve durum yazmaçlarını birlikte ister.
-
VENDOR_ID+1.b -
Satıcı kimliği yazmacının önemli baytını belirtir (PCI önemsiz baytı önce alır).
-
CAP_PM+2.w -
Güç yönetimi yeteneğinin ikinci kelimesine karşılık gelir.
-
ECAP108.l -
ID 0x108 ile genişletilmiş yeteneğin ilk 32 bitlik kelimesini ister.
İLGİLİ BELGELER
lspci(8), pcilib(7).
YAZAN
Linux PCI Araçlarının bakımı Martin Mares tarafından yürütülmektedir.
ÇEVİREN
* Özgün Belgenin Lisans ve Telif Hakkı bilgileri: * * The PCI Utilities -- List All PCI Devices * * Copyright (c) 1997--2020 Martin Mares <mj@ucw.cz> * * This program is free software: you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation, either version 2 of the License, or * (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program. If not, see <http://www.gnu.org/licenses/>.