lstopo - Trực tuyến trên đám mây

CHƯƠNG TRÌNH:

TÊN

lstopo, lstopo-no-graphics, hwloc-ls - Hiển thị cấu trúc liên kết của hệ thống

SYNOPSIS

lstopo [ lựa chọn ] ... [ tên tập tin ]

lstopo-no-đồ họa [ lựa chọn ] ... [ tên tập tin ]

hwloc-ls [ lựa chọn ] ... [ tên tập tin ]

Lưu ý rằng thân tàu(7) cung cấp giải thích chi tiết về hệ thống hwloc; nó nên được đọc
trước khi đọc trang người đàn ông này

LỰA CHỌN

--của , --định dạng đầu ra
Thực thi đầu ra ở định dạng đã cho. Xem phần ĐỊNH DẠNG ĐẦU RA bên dưới.

-i , --đầu vào
Đọc cấu trúc liên kết từ tệp XML (thay vì khám phá cấu trúc liên kết trên
máy địa phương). Nếu như là "-", đầu vào chuẩn được sử dụng. Hỗ trợ XML phải
đã được biên dịch sang hwloc để tùy chọn này có thể sử dụng được.

-i , --đầu vào
Đọc cấu trúc liên kết từ chroot được chỉ định bởi (thay vì khám phá
cấu trúc liên kết trên máy cục bộ). Tùy chọn này thường chỉ có sẵn trên Linux.
Chroot thường được tạo bằng cách thu thập một cấu trúc liên kết máy khác với hwloc-
cấu trúc liên kết tập hợp.

-i , --đầu vào
Mô phỏng một hệ thống phân cấp giả mạo (thay vì khám phá cấu trúc liên kết trên cục bộ
cỗ máy). Nếu như là "nút: 2 pu: 3", cấu trúc liên kết sẽ chứa hai NUMA
các nút với 3 đơn vị xử lý trong mỗi nút. Các chuỗi phải kết thúc
với một số PU.

--nếu như , --định dạng đầu vào
Thực thi đầu vào theo định dạng đã cho, trong số xml, fsroot và sợi tổng hợp.

--xuất-tổng-hợp-cờ
Thực thi cờ khi xuất sang định dạng tổng hợp. Những lá cờ này được chuyển đến
hwloc_topology_export_synthetic (). Giá trị của 2 hoàn nguyên về định dạng hwloc
v1.9. Giá trị 3 hoàn nguyên về định dạng tối giản ban đầu (trước phiên bản 1.9).

-v --dài dòng
Bao gồm chi tiết bổ sung. Công cụ thông tin hwloc có thể được sử dụng để hiển thị nhiều hơn nữa
thông tin về các đối tượng cụ thể.

-s --im lặng
Giảm số lượng chi tiết để hiển thị.

-f --lực lượng
Nếu tệp đích đã tồn tại, hãy ghi đè tệp đó.

-l --hợp lý
Hiển thị chỉ mục logic hwloc thay vì chỉ mục vật lý / hệ điều hành (mặc định cho bảng điều khiển
đầu ra). Các chỉ mục này có tiền tố là "L #". Các chỉ số vật lý của một số
các đối tượng (PU và Node theo mặc định, tất cả các đối tượng nếu dài dòng) sẽ xuất hiện dưới dạng đối tượng
thuộc tính "P # ...".

-p --vật lý
Hiển thị chỉ mục hệ điều hành / vật lý thay vì chỉ mục logic hwloc (mặc định cho đồ họa
đầu ra). Các chỉ mục này có tiền tố là "P #" thay vì "L #" trong bảng điều khiển
đầu ra.

-c --cpuset
Hiển thị cpuset của từng đối tượng.

-C --chỉ -cpuset
Chỉ hiển thị cpuset của từng đối tượng; không hiển thị bất cứ điều gì khác về
vật.

--tác vụ
Hiển thị chuỗi bộ CPU ở định dạng được chương trình dòng lệnh bộ tác vụ công nhận
thay vì định dạng chuỗi bộ CPU dành riêng cho hwloc. Tùy chọn này nên được kết hợp
với --cpuset or --chỉ -cpuset, nếu không nó sẽ ngụ ý --cpuset.

--chỉ một
Chỉ hiển thị các đối tượng của kiểu đã cho trong đầu ra dạng văn bản.

--phớt lờ
Bỏ qua tất cả các đối tượng thuộc loại trong cấu trúc liên kết. hwloc hỗ trợ bỏ qua bất kỳ
loại trừ PU và thiết bị I / O. Tuy nhiên lstopo vẫn cung cấp PU bỏ qua bằng cách ẩn
Các đối tượng PU trong đầu ra đồ họa và văn bản. Lưu ý rằng không thể bỏ qua PU
trong đầu ra XML. Cũng lưu ý rằng không thể bỏ qua loại đối tượng cấp cao nhất
(thường là Máy hoặc Hệ thống).

- không có bộ nhớ đệm
Không hiển thị bộ nhớ đệm.

--không-vô-dụng-bộ nhớ đệm
Không hiển thị bộ nhớ đệm không có tác động phân cấp. Cuộc gọi này
hwloc_topology_ignore_type_keep_osystem () cho các đối tượng bộ nhớ cache.

--no-icach
Không hiển thị bộ nhớ đệm Hướng dẫn, chỉ bộ đệm Dữ liệu và bộ nhớ cache Hợp nhất mới được hiển thị.

--Toàn bộ hệ thống
Không xem xét các giới hạn quản lý.

- hợp nhất
Không hiển thị các cấp không có tác động phân cấp. Cuộc gọi này
hwloc_topology_ignore_all_keep_osystem ().

--không sụp đổ
Không thu gọn các thiết bị PCI giống hệt nhau. Theo mặc định, các thiết bị PCI anh em giống hệt nhau
(chẳng hạn như nhiều chức năng ảo bên trong một thiết bị vật lý) bị thu gọn.

--hạn chế
Giới hạn cấu trúc liên kết đối với cpuset đã cho.

--hạn chế ràng buộc
Hạn chế cấu trúc liên kết đối với ràng buộc quy trình hiện tại. Tùy chọn này yêu cầu sử dụng
của cấu trúc liên kết máy hiện tại thực tế (hoặc bất kỳ cấu trúc liên kết nào khác với - hệ thống or
với HWLOC_THISSYSTEM được đặt thành 1 trong môi trường).

--cờ hạn chế
Thực thi cờ khi hạn chế cấu trúc liên kết. Mặc định là 0. Những lá cờ này là
đã vượt qua hwloc_topology_restrict ().

--không-io
Không hiển thị bất kỳ thiết bị hoặc cầu nối I / O nào. Theo mặc định, các thiết bị phổ biến (GPU, NIC,
thiết bị khối, ...) và các cây cầu thú vị được hiển thị.

- không cầu
Không hiển thị bất kỳ cầu nối I / O nào ngoại trừ cầu nối máy chủ. Theo mặc định, các thiết bị phổ biến (GPU,
NIC, thiết bị khối, ...) và các cầu nối thú vị được hiển thị.

--toàn bộ-io
Hiển thị tất cả các thiết bị và cầu nối I / O. Theo mặc định, chỉ các thiết bị phổ biến (GPU, NIC,
thiết bị khối, ...) và các cây cầu thú vị được hiển thị.

- hệ thống
Giả sử rằng phần phụ trợ đã chọn cung cấp cấu trúc liên kết cho hệ thống mà chúng tôi
đang chạy. Điều này rất hữu ích khi sử dụng --hạn chế ràng buộc và tải một tùy chỉnh
cấu trúc liên kết chẳng hạn như tệp XML.

- lipid
Phát hiện cấu trúc liên kết như được thấy bởi quá trình , tức là như thể quá trình đã làm
khám phá chính nó. Lưu ý rằng ví dụ như điều này có thể thay đổi nhóm được phép
bộ vi xử lý. Đồng thời hiển thị quá trình này ràng buộc CPU hiện tại bằng cách đánh dấu
PUs tương ứng (màu Xanh lá cây trong đầu ra đồ họa, xem phần MÀU SẮC bên dưới,
hoặc bằng cách thêm vào (ràng buộc) đến đầu ra văn bản dài dòng). Nếu 0 được cho dưới dạng pid,
ràng buộc hiện tại cho quá trình lstopo sẽ được hiển thị.

--ps --đứng đầu
Hiển thị các quy trình hiện có dưới dạng các đối tượng khác trong đầu ra. Để tránh một cách vô ích
lộn xộn đầu ra, chỉ các quy trình bị hạn chế ở một số phần của
máy được hiển thị. Trên Linux, các luồng nhân không được hiển thị. Nếu nhiều quy trình
xuất hiện, đầu ra có thể trở nên khó đọc dù sao, làm cho chương trình hwloc-ps nhiều hơn
thực dụng.

--cỡ chữ
Đặt kích thước của phông chữ văn bản.

- kích thước
Đặt kích thước lề giữa các phần tử.

--horiz, --horiz=
Bố cục đồ họa theo chiều ngang thay vì tỷ lệ gần 4/3. Nếu một danh sách được phân tách bằng dấu phẩy
trong số các loại được đưa ra, cách bố trí chỉ áp dụng cho các vùng chứa tương ứng.

--đảo ngược, --đảo ngược=
Bố cục đồ họa theo chiều dọc thay vì tỷ lệ gần 4/3. Nếu một danh sách được phân tách bằng dấu phẩy
trong số các loại được đưa ra, cách bố trí chỉ áp dụng cho các vùng chứa tương ứng.

- dựng lên, - dựng lên=
Bố cục đồ họa hình chữ nhật với tỷ lệ gần 4/3, kể cả khi đặt NUMA
điểm giao. Nếu danh sách các loại được phân tách bằng dấu phẩy được đưa ra, thì bố cục chỉ áp dụng cho
các thùng chứa tương ứng.

--không có huyền thoại
Xóa chú giải văn bản ở dưới cùng.

--append-chú giải
Nối dòng văn bản vào cuối chú giải ở chế độ đồ họa. Nếu dòng
quá dài, nó sẽ bị cắt bớt trong đầu ra. Nếu thêm nhiều dòng, mỗi dòng
dòng phải được cung cấp riêng bằng cách chuyển tùy chọn này nhiều lần.

--phiên bản
Báo cáo phiên bản và thoát.

MÔ TẢ

lstopo và lstopo-no-graphics có khả năng hiển thị bản đồ cấu trúc liên kết của hệ thống trong
nhiều định dạng đầu ra khác nhau. Sự khác biệt duy nhất giữa lstopo và lstopo-no-
đồ họa là đầu ra đồ họa chỉ được hỗ trợ bởi lstopo, để giảm bớt sự phụ thuộc vào
thư viện bên ngoài. hwloc-ls giống hệt với lstopo-no-graphics.

Tên tệp được chỉ định trực tiếp ngụ ý định dạng đầu ra sẽ được sử dụng; xem
Phần ĐỊNH DẠNG ĐẦU RA bên dưới. Định dạng đầu ra hỗ trợ màu sẽ cho biết cụ thể
đặc điểm về từng CPU theo màu sắc của chúng; xem phần MÀU SẮC bên dưới.

OUTPUT M FORU ĐƠN

Theo mặc định, nếu không có tên tệp đầu ra nào cụ thể, đầu ra sẽ được gửi đến cửa sổ đồ họa nếu
có thể trong môi trường hiện tại (biến môi trường DISPLAY được đặt trên Unix, v.v.).
Nếu không, một bản tóm tắt văn bản được hiển thị trong bảng điều khiển.

Tên tệp trên dòng lệnh thường xác định định dạng của đầu ra. Có một
một số tên tệp cho biết định dạng và thiết bị đầu ra cụ thể (ví dụ: tên tệp là "-"
sẽ xuất bản tóm tắt văn bản sang stdout), nhưng hầu hết các tên tệp cho biết kết quả đầu ra mong muốn
định dạng theo hậu tố của chúng (ví dụ: "topo.png" loading = "lazy" sẽ xuất ra tệp định dạng PNG).

Định dạng của đầu ra cũng có thể được thay đổi bằng "--of". Ví dụ: "--of pdf" sẽ
tạo tệp định dạng PDF trên đầu ra tiêu chuẩn, trong khi "--of fig toto" sẽ xuất ra
Tệp định dạng xfig có tên là "toto".

Dưới đây là danh sách các định dạng được hỗ trợ. Bất kỳ trong số chúng có thể được sử dụng với
"--of" hoặc ở dạng hậu tố tên tệp.

mặc định
Gửi đầu ra đến một cửa sổ hoặc đến bảng điều khiển tùy thuộc vào môi trường.

giao diện điều khiển
Gửi một bản tóm tắt văn bản đến stdout. Bộ xử lý ràng buộc, không được phép hoặc bộ xử lý ngoại tuyến chỉ
chú thích trong chế độ này nếu dài dòng; xem phần MÀU SẮC bên dưới.

ascii Đưa ra một biểu diễn nghệ thuật ASCII của bản đồ (trước đây được gọi là txt). Nếu xuất ra
sang trang trí và nếu màu sắc được hỗ trợ trên thiết bị đầu cuối, đầu ra sẽ là
tô màu.

sung Đưa ra một biểu diễn của bản đồ có thể được tải trong Xfig.

pdf Nếu lstopo được biên dịch với sự hỗ trợ thích hợp, lstopo sẽ xuất ra một bản biểu diễn PDF
của bản đồ.

ps Nếu lstopo được biên dịch với sự hỗ trợ thích hợp, lstopo sẽ xuất ra một Postscript
biểu diễn của bản đồ.

png Nếu lstopo được biên dịch với sự hỗ trợ thích hợp, lstopo sẽ xuất ra biểu diễn PNG
của bản đồ.

svg Nếu lstopo được biên dịch với sự hỗ trợ thích hợp, lstopo sẽ xuất ra một SVG
biểu diễn của bản đồ.

sợi tổng hợp
Nếu cấu trúc liên kết là đối xứng (yêu cầu đối tượng gốc phải
tập trường đối xứng_subtree), lstopo xuất ra một chuỗi mô tả tổng hợp. Cái này
đầu ra có thể được sử dụng lại như một mô tả cấu trúc liên kết tổng hợp đầu vào sau này. Lưu ý rằng
Các thiết bị I / O thường gây ra sự bất đối xứng về cấu trúc liên kết. Thêm --no-io sau đó có thể hữu ích khi
xuất khẩu tổng hợp không thành công. Xem thêm phần Cấu trúc liên kết tổng hợp trong
tài liệu hướng dẫn.

xml Nếu lstopo được biên dịch với sự hỗ trợ thích hợp, thì lstopo sẽ xuất ra một tệp XML
biểu diễn của bản đồ. Nó có thể được sử dụng lại sau này, ngay cả trên một máy khác, với
lstopo --input, biến môi trường HWLOC_XMLFILE hoặc
hàm hwloc_topology_set_xml ().

Các tên đặc biệt sau có thể được sử dụng:

- Gửi một bản tóm tắt văn bản đến stdout.

/ dev / stdout
Gửi một bản tóm tắt văn bản đến stdout. Nó có hiệu quả giống như việc chỉ định "-".

-.
Nếu toàn bộ tên tệp là "-. ", lstopo cư xử như thể" --of -" là
đã cho, có nghĩa là một tệp có định dạng nhất định sẽ được gửi đến đầu ra chuẩn.

Xem đầu ra của "lstopo --help" để biết danh sách cụ thể về các định dạng đầu ra đồ họa là gì
được hỗ trợ trong cài đặt hwloc của bạn.

MÀU

Các CPU riêng lẻ được tô màu theo các định dạng đầu ra đồ họa để biểu thị các
đặc điểm:

Màu xanh lá cây Cấu trúc liên kết được báo cáo như được nhìn thấy bởi một quá trình cụ thể (xem - lipid), và đã cho
CPU nằm trong quá trình này mặt nạ ràng buộc CPU.

Màu trắng CPU nằm trong bộ được phép (xem bên dưới). Nếu cấu trúc liên kết được báo cáo như được thấy bởi
một quy trình cụ thể (xem - lipid), CPU đã cho cũng không phải là CPU quá trình này
mặt nạ ràng buộc.

Màu đỏ CPU không nằm trong bộ được phép (xem bên dưới).

Màu đen CPU đang ngoại tuyến (không phải tất cả hệ điều hành đều hỗ trợ hiển thị CPU ngoại tuyến).

"Tập hợp được phép" là tập hợp các CPU mà tiến trình hiện tại được phép liên kết. Các
tập hợp được phép thường được kế thừa từ quy trình mẹ hoặc được thiết lập bởi quản trị viên
qpolicies trên hệ thống. Bộ vi xử lý Linux là một ví dụ về việc giới hạn tập hợp được phép cho một
xử lý và con của nó nhỏ hơn bộ CPU đầy đủ trên hệ thống.

Do đó, các quy trình khác nhau có thể có các CPU khác nhau trong bộ được phép. Do đó, kêu gọi
lstopo trong các ngữ cảnh khác nhau và / hoặc khi những người dùng khác nhau có thể hiển thị các màu khác nhau cho
cùng một CPU riêng lẻ (ví dụ: chạy lstopo trong một ngữ cảnh có thể hiển thị một CPU cụ thể là
màu đỏ, nhưng chạy lstopo trong một ngữ cảnh khác có thể hiển thị cùng một CPU với màu trắng).

Một số chế độ đầu ra lstopo, ví dụ như chế độ bàn điều khiển (đầu ra không phải đồ họa mặc định), không
hỗ trợ màu sắc ở tất cả. Chế độ bảng điều khiển hiển thị các đặc điểm trên bằng cách thêm vào
văn bản vào mỗi dòng PU nếu thông báo dài được bật.

CUSTOM MÀU

Màu của mỗi đối tượng trong đầu ra đồ họa có thể được thực thi bằng cách chỉ định
thuộc tính thông tin "lstopoStyle" trong đối tượng đó. Giá trị của nó phải được phân tách bằng dấu chấm phẩy
danh sách của " = # rrggbb "trong đó rr, gg và bb là các thành phần RGB của một màu, mỗi màu
từ 0 đến 255, trong hệ thập lục phân (00 đến ff). có lẽ

Tiểu sử
Đặt màu nền của hộp đối tượng chính.

Bối cảnh2
Đặt màu nền của hộp bổ sung cho đối tượng, ví dụ:
hộp bộ nhớ bên trong hộp nút NUMA.

bản văn Đặt màu của văn bản hiển thị tên đối tượng, loại, chỉ mục, v.v.

Văn bản 2 Đặt màu của văn bản bổ sung gần đối tượng, chẳng hạn như tốc độ liên kết
đằng sau một cầu PCI.

Thông tin "lstopoStyle" có thể được thêm vào cấu trúc liên kết XML được lưu tạm thời với hwloc-
chú thích hoặc với hwloc_obj_add_info (). Ví dụ: để hiển thị tất cả các đối tượng cốt lõi bằng màu xanh lam
(với tên màu trắng):

lstopo save.xml
hwloc-annotate save.xml save.xml core: all info lstopoStyle
"Nền = # 0000ff; Văn bản = # ffffff"
lstopo -i save.xml

BỐ TRÍ

Trong đầu ra đồ họa của nó, lstopo sử dụng phương pháp phỏng đoán hình chữ nhật đơn giản để cố gắng đạt được 4/3
tỷ lệ giữa chiều rộng và chiều cao. Tuy nhiên, trong trường hợp cụ thể của NUMA nút, bố cục
luôn là một hình chữ nhật phẳng, để tránh cho người dùng tin vào bất kỳ cấu trúc liên kết NUMA cụ thể nào
(lstopo chưa thể kết xuất điều đó). Bố cục của một cấp có thể được thay đổi với
--vert, --horiz và --rect.

VÍ DỤ

Để hiển thị cấu trúc liên kết máy ở chế độ văn bản:

lstopo-no-đồ họa

Để hiển thị cấu trúc liên kết của máy ở chế độ ascii-art:

lstopo-no-đồ họa -.ascii

Để hiển thị ở chế độ đồ họa (giả sử rằng biến môi trường DISPLAY được đặt thành
giá trị liên quan):

lstopo

Để xuất cấu trúc liên kết sang tệp PNG:

tập tin lstopo.png

Để xuất tệp XML trên một máy và sau đó hiển thị kết quả đầu ra đồ họa tương ứng trên
máy khác:

machine1 $ lstopo file.xml

machine2 $ lstopo --input file.xml

Để lưu cấu trúc liên kết của máy hiện tại thành XML và sau đó tải lại nhanh hơn trong khi vẫn
coi nó như một chiếc máy hiện tại:

$ lstopo tập tin.xml
<...>
$ lstopo --input file.xml --thissystem

Để hạn chế cấu trúc liên kết XML chỉ với các bộ xử lý vật lý 0, 1, 4 và 5:

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

Để hạn chế cấu trúc liên kết XML chỉ với nút numa có chỉ mục lôgic là 1:

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

Để hiển thị một bản tóm tắt về cấu trúc liên kết:

lstopo -s

Để biết thêm chi tiết về cấu trúc liên kết:

lstopo -v

Để chỉ hiển thị lõi:

lstopo - chỉ cốt lõi

Để hiển thị bộ vi xử lý:

lstopo --cpuset

Để chỉ hiển thị các cpus của gói:

lstopo - chỉ gói - chỉ dành cho chuột

Mô phỏng một hệ thống phân cấp giả mạo; ví dụ này hiển thị với 2 NUMA nút của 2 đơn vị bộ xử lý:

lstopo --input "n: 2 2"

Để đếm số lượng bộ xử lý logic trong hệ thống

lstopo - chỉ pu | wc -l

Để nối phiên bản và phiên bản phát hành hạt nhân vào chú giải đồ họa:

lstopo --append-legend "Kernel release: $ (uname -r)" --append-legend "Phiên bản Kernel:
$ (uname -v) "

Sử dụng lstopo trực tuyến bằng các dịch vụ onworks.net