lstopo - Dalam talian di Awan

JADUAL:

NAMA

lstopo, lstopo-no-graphics, hwloc-ls - Tunjukkan topologi sistem

SINOPSIS

lstopo [ pilihan ]... [ nama fail ]

lstopo-tiada-grafik [ pilihan ]... [ nama fail ]

hwloc-ls [ pilihan ]... [ nama fail ]

Perhatikan bahawa hulloc(7) memberikan penjelasan terperinci tentang sistem hwloc; ia harus dibaca
sebelum membaca halaman lelaki ini

PILIHAN

--daripada , --format-output
Kuatkuasakan output dalam format yang diberikan. Lihat bahagian FORMAT OUTPUT di bawah.

-i , --input
Baca topologi daripada fail XML (bukannya menemui topologi pada
mesin tempatan). Jika ialah "-", input standard digunakan. Sokongan XML mesti
telah disusun ke dalam hwloc untuk pilihan ini boleh digunakan.

-i , --input
Baca topologi dari chroot yang ditentukan oleh (bukannya menemui
topologi pada mesin tempatan). Pilihan ini biasanya hanya tersedia di Linux.
Chroot biasanya dicipta dengan mengumpulkan topologi mesin lain dengan hwloc-
kumpul-topologi.

-i , --input
Simulasikan hierarki palsu (bukannya menemui topologi pada tempatan
mesin). Jika ialah "nod:2 pu:3", topologi akan mengandungi dua NUMA
nod dengan 3 unit pemprosesan dalam setiap satunya. The rentetan mesti berakhir
dengan beberapa PU.

--jika , --format-input
Kuatkuasakan input dalam format yang diberikan, antara xml, fsroot and sintetik.

--eksport-sintetik-bendera
Kuatkuasakan bendera apabila mengeksport ke format sintetik. Bendera ini diserahkan kepada
hwloc_topology_export_synthetic(). Nilai 2 kembali kepada format hwloc
v1.9. Nilai 3 kembali kepada format minimalis asal (sebelum v1.9).

-v --verbose
Sertakan butiran tambahan. Alat hwloc-info boleh digunakan untuk memaparkan lebih banyak lagi
maklumat tentang objek tertentu.

-s --senyap
Kurangkan jumlah butiran untuk ditunjukkan.

-f - kekuatan
Jika fail destinasi sudah wujud, tulis gantinya.

-l --logik
Paparkan indeks logik hwloc dan bukannya indeks fizikal/OS (lalai untuk console
pengeluaran). Indeks ini diawali dengan "L#". Indeks fizikal sesetengah
objek (PU dan Nod secara lalai, semua objek jika verbose) akan muncul sebagai objek
atribut "P#...".

-p --fizikal
Paparkan indeks OS/fizikal dan bukannya indeks logik hwloc (lalai untuk grafik
pengeluaran). Indeks ini diawali dengan "P#" dan bukannya "L#" dalam konsol
output.

-c --cpuset
Paparkan cpuset setiap objek.

-C --cpuset-sahaja
Hanya paparkan cpuset setiap objek; jangan paparkan apa-apa lagi tentang
objek.

--set tugasan
Tunjukkan rentetan set CPU dalam format yang diiktiraf oleh program baris arahan set tugas
bukannya format rentetan set CPU khusus hwloc. Pilihan ini harus digabungkan
bersama --cpuset or --cpuset-sahaja, jika tidak ia akan membayangkan --cpuset.

--sahaja
Hanya tunjukkan objek jenis yang diberikan dalam output teks.

--abai
Abaikan semua objek jenis dalam topologi. hwloc menyokong mengabaikan mana-mana
jenis kecuali PU dan peranti I/O. Walau bagaimanapun lstopo masih menawarkan PU mengabaikan dengan bersembunyi
Objek PU dalam output grafik dan teks. Ambil perhatian bahawa PU mungkin tidak diabaikan
dalam output XML. Perhatikan juga bahawa jenis objek peringkat atas tidak boleh diabaikan
(biasanya Mesin atau Sistem).

--tiada-cache
Jangan tunjukkan cache.

--no-sia-sia-cache
Jangan tunjukkan cache yang tidak mempunyai kesan hierarki. Ini memanggil
hwloc_topology_ignore_type_keep_structure() untuk objek cache.

--tiada-cache
Jangan tunjukkan cache Arahan, hanya cache Data dan Unified dipaparkan.

--keseluruhan-sistem
Jangan pertimbangkan had pentadbiran.

--bercantum
Jangan tunjukkan tahap yang tidak mempunyai kesan hierarki. Ini memanggil
hwloc_topology_ignore_all_keep_structure().

--tidak-runtuh
Jangan runtuhkan peranti PCI yang serupa. Secara lalai, peranti PCI adik beradik yang serupa
(seperti banyak fungsi maya dalam satu peranti fizikal) runtuh.

--menyekat
Hadkan topologi kepada cpuset yang diberikan.

--menyekat mengikat
Hadkan topologi kepada pengikatan proses semasa. Pilihan ini memerlukan penggunaan
daripada topologi mesin semasa sebenar (atau mana-mana topologi lain dengan --sistem ini or
dengan HWLOC_THISSYSTEM ditetapkan kepada 1 dalam persekitaran).

--sekat-bendera
Kuatkuasakan bendera apabila mengehadkan topologi. Lalainya ialah 0. Bendera ini adalah
berlalu ke hwloc_topology_restrict().

--tidak-io
Jangan tunjukkan sebarang peranti I/O atau jambatan. Secara lalai, peranti biasa (GPU, NIC,
peranti blok, ...) dan jambatan yang menarik ditunjukkan.

--tiada-jambatan
Jangan tunjukkan sebarang jambatan I/O kecuali jambatan hos. Secara lalai, peranti biasa (GPU,
NIC, peranti blok, ...) dan jambatan yang menarik ditunjukkan.

--keseluruhan-io
Tunjukkan semua peranti I/O dan jambatan. Secara lalai, hanya peranti biasa (GPU, NIC,
peranti blok, ...) dan jambatan yang menarik ditunjukkan.

--sistem ini
Andaikan bahawa bahagian belakang yang dipilih menyediakan topologi untuk sistem yang kami gunakan
sedang berjalan. Ini berguna apabila menggunakan --menyekat mengikat dan memuatkan adat
topologi seperti fail XML.

--pid
Mengesan topologi seperti yang dilihat oleh proses , iaitu seolah-olah proses melakukan
penemuan itu sendiri. Ambil perhatian bahawa ini boleh misalnya menukar set yang dibenarkan
pemproses. Tunjukkan juga proses ini mengikat CPU semasa dengan menandakan
PU yang sepadan (dalam Hijau dalam output grafik, lihat bahagian WARNA di bawah,
atau dengan melampirkan (mengikat) kepada output teks verbose). Jika 0 diberikan sebagai pid, maka
pengikatan semasa untuk proses lstopo akan ditunjukkan.

--ps --atas
Tunjukkan proses sedia ada sebagai objek misc dalam output. Untuk mengelak sia-sia
mengacaukan output, hanya proses yang terhad kepada beberapa bahagian
mesin ditunjukkan. Di Linux, benang kernel tidak ditunjukkan. Jika banyak proses
muncul, output mungkin menjadi sukar untuk dibaca, menjadikan program hwloc-ps lebih banyak
praktikal.

--Saiz huruf
Tetapkan saiz fon teks.

--saiz grid
Tetapkan saiz jidar antara elemen.

--horiz, --horiz=
Reka letak grafik mendatar dan bukannya nisbah hampir 4/3. Jika senarai dipisahkan koma
jenis diberikan, reka letak hanya terpakai pada bekas yang sepadan.

--vert, --vert=
Reka letak grafik menegak dan bukannya nisbah hampir 4/3. Jika senarai dipisahkan koma
jenis diberikan, reka letak hanya terpakai pada bekas yang sepadan.

--betul, --betul=
Reka letak grafik segi empat tepat dengan nisbah hampir 4/3, termasuk semasa meletakkan NUMA
nod. Jika senarai jenis yang dipisahkan koma diberikan, reka letak hanya terpakai pada
bekas yang sepadan.

--tiada-legenda
Alih keluar legenda teks di bahagian bawah.

--tambah-legenda
Tambahkan baris teks ke bahagian bawah legenda dalam mod grafik. Jika talian
terlalu panjang, ia akan dipotong dalam output. Jika menambah berbilang baris, setiap satu
baris hendaklah diberikan secara berasingan dengan melepasi pilihan ini beberapa kali.

--versi
Laporkan versi dan keluar.

DESCRIPTION

lstopo dan lstopo-no-graphics mampu memaparkan peta topologi sistem dalam
pelbagai format output yang berbeza. Satu-satunya perbezaan antara lstopo dan lstopo-no-
grafik ialah output grafik hanya disokong oleh lstopo, untuk mengurangkan kebergantungan pada
perpustakaan luar. hwloc-ls adalah sama dengan lstopo-no-graphics.

Nama fail yang dinyatakan secara langsung membayangkan format output yang akan digunakan; lihat
bahagian FORMAT OUTPUT, di bawah. Format output yang menyokong warna akan menunjukkan khusus
ciri tentang CPU individu mengikut warnanya; lihat bahagian WARNA, di bawah.

OUTPUT FORMATS

Secara lalai, jika tiada nama fail output adalah khusus, output dihantar ke tetingkap grafik jika
mungkin dalam persekitaran semasa (pembolehubah persekitaran DISPLAY ditetapkan pada Unix, dsb.).
Jika tidak, ringkasan teks dipaparkan dalam konsol.

Nama fail pada baris arahan biasanya menentukan format output. Terdapat a
beberapa nama fail yang menunjukkan format dan peranti output tertentu (cth, nama fail "-"
akan mengeluarkan ringkasan teks ke stdout), tetapi kebanyakan nama fail menunjukkan output yang dikehendaki
format dengan akhiran mereka (cth, "topo.png" loading="lazy" akan mengeluarkan fail format PNG).

Format output juga boleh ditukar dengan "--of". Sebagai contoh, "--of pdf" akan
menjana fail format PDF pada output standard, manakala "--of fig toto" akan mengeluarkan a
Fail format Xfig bernama "toto".

Senarai format yang disokong pada masa ini diberikan di bawah. Mana-mana daripada mereka boleh digunakan dengan
"--of" atau sebagai akhiran nama fail.

lalai
Hantar output ke tetingkap atau ke konsol bergantung pada persekitaran.

konsul
Hantar ringkasan teks ke stdout. Pemproses yang mengikat, tidak dibenarkan atau luar talian adalah sahaja
dianotasi dalam mod ini jika verbose; lihat bahagian WARNA, di bawah.

ASCII Keluarkan perwakilan seni ASCII bagi peta (dahulunya dipanggil txt). Jika mengeluarkan
ke stdout dan jika warna disokong pada terminal, outputnya ialah
berwarna.

ara Keluarkan perwakilan peta yang boleh dimuatkan dalam Xfig.

pdf Jika lstopo telah disusun dengan sokongan yang betul, lstopo mengeluarkan perwakilan PDF
daripada peta itu.

ps Jika lstopo telah disusun dengan sokongan yang betul, lstopo mengeluarkan Postscript
perwakilan peta.

png Jika lstopo telah disusun dengan sokongan yang betul, lstopo mengeluarkan perwakilan PNG
daripada peta itu.

svg Jika lstopo telah disusun dengan sokongan yang betul, lstopo mengeluarkan SVG
perwakilan peta.

sintetik
Jika topologi adalah simetri (yang memerlukan objek akar mempunyainya
set medan symmetric_subtree), lstopo mengeluarkan rentetan penerangan sintetik. ini
output boleh digunakan semula sebagai penerangan topologi sintetik input kemudian. Perhatikan bahawa
Peranti I/O selalunya menyebabkan asimetri topologi. Menambah --no-io kemudiannya mungkin berguna apabila
eksport sintetik gagal. Lihat juga bahagian Topologi sintetik dalam
dokumentasi.

xml Jika lstopo telah disusun dengan sokongan yang betul, lstopo mengeluarkan XML
perwakilan peta. Ia boleh digunakan semula kemudian, walaupun pada mesin lain, dengan
lstopo --input, pembolehubah persekitaran HWLOC_XMLFILE, atau
hwloc_topology_set_xml() fungsi.

Nama khas berikut boleh digunakan:

- Hantar ringkasan teks ke stdout.

/dev/stdout
Hantar ringkasan teks ke stdout. Ia berkesan sama dengan menyatakan "-".

-.
Jika keseluruhan nama fail ialah "-. ", lstopo berkelakuan seolah-olah "--of -" adalah
diberikan, yang bermaksud fail dengan format yang diberikan dihantar ke output standard.

Lihat output "lstopo --help" untuk senarai khusus tentang format output grafik
disokong dalam pemasangan hwloc anda.

COLORS

CPU individu diwarnakan dalam format output grafik untuk menunjukkan perbezaan
ciri-ciri:

Hijau Topologi dilaporkan seperti yang dilihat oleh proses tertentu (lihat --pid), dan yang diberikan
CPU sedang dalam proses ini topeng pengikat CPU.

Putih CPU berada dalam set yang dibenarkan (lihat di bawah). Jika topologi dilaporkan seperti yang dilihat oleh
proses tertentu (lihat --pid), CPU yang diberikan juga tidak berada dalam CPU proses ini
topeng pengikat.

Merah CPU tidak berada dalam set yang dibenarkan (lihat di bawah).

Hitam CPU di luar talian (bukan semua sokongan OS memaparkan CPU luar talian).

"Set yang dibenarkan" ialah set CPU yang mana proses semasa dibenarkan untuk mengikat. The
set dibenarkan biasanya sama ada diwarisi daripada proses induk atau ditetapkan oleh pentadbiran
qpolicies pada sistem. Cpuset Linux adalah satu contoh mengehadkan set yang dibenarkan untuk a
proses dan anak-anaknya menjadi kurang daripada set penuh CPU pada sistem.

Oleh itu, proses yang berbeza mungkin mempunyai CPU yang berbeza dalam set yang dibenarkan. Oleh itu, menyeru
lstopo dalam konteks yang berbeza dan/atau kerana pengguna yang berbeza mungkin memaparkan warna yang berbeza untuk
CPU individu yang sama (cth, menjalankan lstopo dalam satu konteks mungkin menunjukkan CPU tertentu sebagai
merah, tetapi menjalankan lstopo dalam konteks yang berbeza mungkin menunjukkan CPU yang sama seperti putih).

Beberapa mod output lstopo, cth mod konsol (output bukan grafik lalai), jangan
menyokong warna sama sekali. Mod konsol memaparkan ciri di atas dengan melampirkan
teks ke setiap baris PU jika mesej verbose didayakan.

CUSTOM COLORS

Warna setiap objek dalam output grafik boleh dikuatkuasakan dengan menyatakan a
Atribut maklumat "lstopoStyle" dalam objek itu. Nilainya hendaklah dipisahkan dengan koma bertitik
senarai " =#rrggbb" dengan rr, gg dan bb ialah komponen RGB bagi sesuatu warna, setiap satu
antara 0 dan 255, dalam perenambelasan (00 hingga ff). mungkin

Latar Belakang
Menetapkan warna latar belakang kotak objek utama.

Latar belakang2
Menetapkan warna latar belakang kotak tambahan untuk objek, contohnya
kotak memori di dalam kotak nod NUMA.

teks Menetapkan warna teks yang menunjukkan nama objek, jenis, indeks, dsb.

Teks2 Menetapkan warna teks tambahan berhampiran objek, contohnya kelajuan pautan
di belakang jambatan PCI.

Maklumat "lstopoStyle" boleh ditambah pada topologi XML yang disimpan sementara dengan hwloc-
anotasi, atau dengan hwloc_obj_add_info(). Sebagai contoh, untuk memaparkan semua objek teras dalam warna biru
(dengan nama putih):

lstopo save.xml
hwloc-annotate save.xml save.xml core:semua maklumat lstopoStyle
"Latar Belakang=#0000ff;Teks=#ffffff"
lstopo -i save.xml

LAYOUT

Dalam output grafiknya, lstopo menggunakan heuristik segi empat tepat mudah untuk cuba mencapai 4/3
nisbah antara lebar dan tinggi. Walau bagaimanapun, dalam kes tertentu nod NUMA, susun atur
sentiasa berbentuk segi empat tepat, untuk mengelakkan pengguna mempercayai mana-mana topologi NUMA tertentu
(lstopo tidak dapat memberikannya lagi). Reka letak tahap boleh diubah dengan
--vert, --horiz, dan --rect.

CONTOH

Untuk memaparkan topologi mesin dalam mod teks:

lstopo-tiada-grafik

Untuk memaparkan topologi mesin dalam mod seni ascii:

lstopo-no-graphics -.ascii

Untuk memaparkan dalam mod grafik (dengan mengandaikan bahawa pembolehubah persekitaran DISPLAY ditetapkan kepada a
nilai yang berkaitan):

lstopo

Untuk mengeksport topologi ke fail PNG:

fail lstopo.png

Untuk mengeksport fail XML pada mesin dan kemudian memaparkan output grafik yang sepadan dihidupkan
mesin lain:

machine1$ fail lstopo.xml

machine2$ lstopo --input file.xml

Untuk menyimpan topologi mesin semasa ke XML dan kemudian muat semula dengan lebih pantas semasa diam
menganggapnya sebagai mesin semasa:

$ lstopo file.xml
<...>
$ lstopo --input file.xml --thissystem

Untuk mengehadkan topologi XML kepada hanya pemproses fizikal 0, 1, 4 dan 5:

lstopo --input file.xml --restrict 0x33 newfile.xml

Untuk mengehadkan topologi XML kepada nod numa sahaja yang indeks logiknya ialah 1:

lstopo --input file.xml --restrict $(hwloc-calc --input file.xml nod:1) newfile.xml

Untuk memaparkan ringkasan topologi:

lstopo -s

Untuk mendapatkan butiran lanjut tentang topologi:

lstopo -v

Untuk hanya menunjukkan teras:

lstopo --teras sahaja

Untuk menunjukkan cpuset:

lstopo --cpuset

Untuk hanya menunjukkan cpuset pakej:

lstopo --only package --cpuset-only

Simulasikan hierarki palsu; contoh ini ditunjukkan dengan 2 nod NUMA daripada 2 unit pemproses:

lstopo --input "n:2 2"

Untuk mengira bilangan pemproses logik dalam sistem

lstopo --hanya pu | wc -l

Untuk menambahkan keluaran kernel dan versi kepada legenda grafik:

lstopo --append-legend "Keluaran kernel: $(uname -r)" --append-legend "Versi kernel:
$(uname -v)"

Gunakan lstopo dalam talian menggunakan perkhidmatan onworks.net