lstopo - 클라우드에서의 온라인

프로그램:

이름

lstopo, lstopo-no-graphics, hwloc-ls - 시스템의 토폴로지 표시

개요

이스토포 [ 옵션 ]... [ 파일 이름 ]

lstopo-no-그래픽 [ 옵션 ]... [ 파일 이름 ]

hwloc-ls [ 옵션 ]... [ 파일 이름 ]

참고 헐록(7) hwloc 시스템에 대한 자세한 설명을 제공합니다. 그것은 읽어야한다
이 매뉴얼 페이지를 읽기 전에

옵션

--NS , --출력 형식
주어진 형식으로 출력을 시행합니다. 아래 출력 형식 섹션을 참조하십시오.

-i , --입력
XML 파일에서 토폴로지 읽기 (토폴로지에서 토폴로지를 발견하는 대신
로컬 머신). 만약에 "-"이면 표준 입력이 사용됩니다. XML 지원은
이 옵션을 사용할 수 있도록 hwloc에 컴파일되었습니다.

-i , --입력
지정된 chroot에서 토폴로지 읽기 (발견하는 대신
로컬 시스템의 토폴로지). 이 옵션은 일반적으로 Linux에서만 사용할 수 있습니다.
chroot는 일반적으로 hwloc-을 사용하여 다른 머신 토폴로지를 수집하여 생성되었습니다.
수집 토폴로지.

-i , --입력
가짜 계층 구조를 시뮬레이트합니다(로컬에서 토폴로지를 발견하는 대신).
기계). 만약에 "node:2 pu:3"이면 토폴로지에 두 개의 NUMA가 포함됩니다.
각각에 3개의 처리 장치가 있는 노드. 그만큼 문자열은 끝나야 합니다
여러 PU가 있습니다.

--만약에 , --입력 형식
다음 중에서 주어진 형식으로 입력을 시행합니다. XML, fsroot 과 인조.

--내보내기-합성-플래그
합성 형식으로 내보낼 때 플래그를 적용합니다. 이 플래그는
hwloc_topology_export_synthetic(). 값 2는 hwloc 형식으로 되돌아갑니다.
v1.9. 값 3은 원래 최소 형식(v1.9 이전)으로 되돌아갑니다.

-v --말 수가 많은
추가 세부 정보를 포함합니다. hwloc-info 도구를 사용하여 더 많은 정보를 표시할 수 있습니다.
특정 개체에 대한 정보.

-s --조용한
표시할 세부 정보의 양을 줄입니다.

-f --힘
대상 파일이 이미 있으면 덮어씁니다.

-l --논리적
물리적/OS 인덱스 대신 hwloc 논리 인덱스 표시(콘솔의 경우 기본값)
산출). 이러한 색인에는 "L#" 접두사가 붙습니다. 일부 물리적 인덱스
개체(기본적으로 PU 및 노드, 자세한 경우 모든 개체)가 개체로 나타납니다.
속성 "P#...".

-p --물리적 인
hwloc 논리적 인덱스 대신 OS/물리적 인덱스를 표시합니다.
산출). 이러한 인덱스는 콘솔에서 "L#" 대신 "P#" 접두사가 붙습니다.
출력.

-c --cpuset
각 개체의 cpuset을 표시합니다.

-C --cpuset 전용
각 개체의 cpuset만 표시합니다. 에 대한 다른 내용을 표시하지 마십시오.
목적.

--작업 세트
taskset 명령줄 프로그램에서 인식하는 형식으로 CPU 집합 문자열 표시
hwloc 특정 CPU 세트 문자열 형식 대신. 이 옵션을 결합해야 합니다.
과 --cpuset or --cpuset 전용그렇지 않으면 다음을 의미합니다. --cpuset.

--오직
텍스트 출력에 지정된 유형의 개체만 표시합니다.

--무시하다
유형의 모든 객체 무시 토폴로지에서. hwloc은 무시를 지원합니다.
PU 및 I/O 장치를 제외한 유형입니다. 그러나 lstopo는 여전히 숨김으로써 PU 무시를 제공합니다.
그래픽 및 텍스트 출력의 PU 개체. PU는 무시할 수 없습니다.
XML 출력에서. 또한 최상위 개체 유형은 무시할 수 없습니다.
(일반적으로 기계 또는 시스템).

--캐시 없음
캐시를 표시하지 않습니다.

--쓸모없는 캐시
계층적 영향이 없는 캐시는 표시하지 마십시오. 이것은 호출
캐시 객체에 대한 hwloc_topology_ignore_type_keep_structure().

--no-icaches
명령 캐시를 표시하지 않고 데이터 및 통합 캐시만 표시됩니다.

--전체 시스템
관리 제한을 고려하지 마십시오.

-병합
계층적 영향이 없는 수준은 표시하지 마십시오. 이것은 호출
hwloc_topology_ignore_all_keep_structure().

--접지 않음
동일한 PCI 장치를 축소하지 마십시오. 기본적으로 동일한 형제 PCI 장치
(예: 단일 물리적 장치 내부의 많은 가상 기능)이 축소됩니다.

--얽매다
토폴로지를 지정된 cpuset로 제한합니다.

--얽매다 제본
토폴로지를 현재 프로세스 바인딩으로 제한합니다. 이 옵션을 사용하려면
실제 현재 머신 토폴로지(또는 다른 토폴로지 --이 시스템 or
환경에서 HWLOC_THISSYSTEM이 1로 설정됨).

--restrict-플래그
토폴로지를 제한할 때 플래그를 적용합니다. 기본값은 0. 이러한 플래그는
전달 hwloc_topology_restrict().

--no-io
I/O 장치나 브리지를 표시하지 마십시오. 기본적으로 일반 장치(GPU, NIC,
블록 장치, ...) 및 흥미로운 브리지가 표시됩니다.

--브리지 없음
호스트 브리지를 제외한 모든 I/O 브리지를 표시하지 마십시오. 기본적으로 일반 장치(GPU,
NIC, 블록 장치, ...) 및 흥미로운 브리지가 표시됩니다.

--전체-io
모든 I/O 장치 및 브리지를 표시합니다. 기본적으로 일반 장치(GPU, NIC,
블록 장치, ...) 및 흥미로운 브리지가 표시됩니다.

--이 시스템
선택한 백엔드가 우리가 사용하는 시스템의 토폴로지를 제공한다고 가정합니다.
실행 중입니다. 사용할 때 유용합니다. --얽매다 커스텀 바인딩 및 로드
XML 파일과 같은 토폴로지.

--pid
프로세스가 보는 토폴로지 감지 , 즉 마치 프로세스처럼 했다
발견 그 자체. 이것은 예를 들어 허용된 집합을 변경할 수 있습니다.
프로세서. 또한 다음을 표시하여 이 프로세스의 현재 CPU 바인딩을 표시합니다.
해당 PU(그래픽 출력의 녹색, 아래 COLORS 섹션 참조,
또는 추가하여 (제본) 자세한 텍스트 출력으로). 0이 pid로 주어지면,
lstopo 프로세스에 대한 현재 바인딩이 표시됩니다.

--추신 --맨 위
기존 프로세스를 출력에 기타 개체로 표시합니다. 쓸데없이 피하기 위해
출력을 어지럽히고, 일부로 제한된 프로세스만
기계가 표시됩니다. Linux에서는 커널 스레드가 표시되지 않습니다. 프로세스가 많은 경우
가 나타나면 출력을 읽기 어려워질 수 있으므로 hwloc-ps 프로그램이 더
실용적인.

--글꼴 크기
텍스트 글꼴의 크기를 설정합니다.

--격자 크기
요소 사이의 여백 크기를 설정합니다.

--horiz, --horiz=
거의 4/3 비율 대신 가로 그래픽 레이아웃. 쉼표로 구분된 목록인 경우
타입이 주어지면 레이아웃은 해당 컨테이너에만 적용됩니다.

--초록, --초록=
거의 4/3 비율 대신 수직 그래픽 레이아웃. 쉼표로 구분된 목록인 경우
타입이 주어지면 레이아웃은 해당 컨테이너에만 적용됩니다.

--직접, --직접=
NUMA를 배치할 때를 포함하여 거의 4/3 비율의 직사각형 그래픽 레이아웃
노드. 쉼표로 구분된 유형 목록이 제공되면 레이아웃은
해당 컨테이너.

--전설 없음
하단의 텍스트 범례를 제거하십시오.

--추가-범례
그래픽 모드에서 범례의 맨 아래에 텍스트 줄을 추가합니다. 만약 라인
너무 길면 출력에서 ​​잘립니다. 여러 줄을 추가하는 경우 각
이 옵션을 여러 번 전달하여 줄을 별도로 지정해야 합니다.

--번역
버전을 보고하고 종료합니다.

기술

lstopo 및 lstopo-no-graphics는 시스템의 토폴로지 맵을 다음과 같이 표시할 수 있습니다.
다양한 출력 형식. lstopo와 lstopo-no-의 유일한 차이점은
그래픽은 그래픽 출력이 lstopo에서만 지원된다는 것입니다.
외부 라이브러리. hwloc-ls는 lstopo-no-graphics와 동일합니다.

지정된 파일 이름은 사용될 출력 형식을 직접 의미합니다. 참조
아래 출력 형식 섹션. 색상을 지원하는 출력 형식은 특정
색상별 개별 CPU에 대한 특성 아래 색상 섹션을 참조하십시오.

출력 형식

기본적으로 특정 출력 파일 이름이 없으면 다음과 같은 경우 출력이 그래픽 창으로 전송됩니다.
현재 환경에서 가능합니다(Unix에서 설정한 DISPLAY 환경 변수 등).
그렇지 않으면 텍스트 요약이 콘솔에 표시됩니다.

일반적으로 명령줄의 파일 이름은 출력 형식을 결정합니다. 있다
특정 출력 형식 및 장치를 나타내는 몇 가지 파일 이름(예: "-"의 파일 이름)
stdout에 텍스트 요약을 출력하지만 대부분의 파일 이름은 원하는 출력을 나타냅니다.
접미사로 형식을 지정합니다(예: "topo.png" loading="lazy"는 PNG 형식 파일을 출력함).

출력 형식은 "--of"로 변경할 수도 있습니다. 예를 들어 "--of pdf"는
표준 출력에 PDF 형식 파일을 생성하는 반면 "--of fig toto"는
"toto"라는 이름의 Xfig 형식 파일입니다.

현재 지원되는 형식 목록은 다음과 같습니다. 그들 중 하나는 함께 사용할 수 있습니다
"--of" 또는 파일 이름 접미사.

디폴트 값
환경에 따라 출력을 창이나 콘솔로 보냅니다.

콘솔
stdout에 텍스트 요약을 보냅니다. 바인딩, 허용되지 않거나 오프라인 프로세서는
자세한 경우 이 모드에서 주석이 추가됩니다. 아래 색상 섹션을 참조하십시오.

아스키 지도의 ASCII 아트 표현을 출력합니다(이전에는 TXT). 출력하는 경우
stdout으로 변환하고 터미널에서 색상이 지원되는 경우 출력은
착색.

무화과 Xfig에서 로드할 수 있는 지도 표현을 출력합니다.

PDF lstopo가 적절한 지원으로 컴파일된 경우 lstopo는 PDF 표현을 출력합니다.
지도의.

ps lstopo가 적절한 지원으로 컴파일된 경우 lstopo는 포스트스크립트를 출력합니다.
지도의 표현.

PNG lstopo가 적절한 지원으로 컴파일된 경우 lstopo는 PNG 표현을 출력합니다.
지도의.

SVG lstopo가 적절한 지원으로 컴파일된 경우 lstopo는 SVG를 출력합니다.
지도의 표현.

인조
토폴로지가 대칭인 경우(루트 개체에
symmetric_subtree 필드 집합), lstopo는 합성 설명 문자열을 출력합니다. 이것
출력은 나중에 입력 합성 토폴로지 설명으로 재사용될 수 있습니다. 참고
I/O 장치는 종종 토폴로지 비대칭을 유발합니다. --no-io를 추가하면 다음과 같은 경우에 유용할 수 있습니다.
합성 내보내기가 실패합니다. 합성 토폴로지 섹션도 참조하십시오.
선적 서류 비치.

XML lstopo가 적절한 지원으로 컴파일된 경우 lstopo는 XML을 출력합니다.
지도의 표현. 나중에 다른 시스템에서도 재사용할 수 있습니다.
lstopo --input, HWLOC_XMLFILE 환경 변수 또는
hwloc_topology_set_xml() 함수.

다음 특수 이름을 사용할 수 있습니다.

- stdout에 텍스트 요약을 보냅니다.

/dev/stdout
stdout에 텍스트 요약을 보냅니다. 사실상 "-"를 지정하는 것과 동일합니다.

-.
전체 파일명이 "-. ", lstopo는 마치 "--of -" 였다
이는 주어진 형식의 파일이 표준 출력으로 전송됨을 의미합니다.

그래픽 출력 형식에 대한 특정 목록은 "lstopo --help"의 출력을 참조하십시오.
hwloc 설치에서 지원됩니다.

COLORS

개별 CPU는 서로 다른 것을 나타내기 위해 그래픽 출력 형식으로 색상이 지정됩니다.
형질:

녹색 토폴로지는 특정 프로세스에서 볼 수 있는 것으로 보고됩니다(참조: --pid), 주어진
CPU는 이 프로세스 CPU 바인딩 마스크에 있습니다.

흰색 CPU가 허용 세트에 있습니다(아래 참조). 토폴로지가 다음에서 본 것으로 보고되는 경우
특정 프로세스(참조 --pid), 주어진 CPU도 이 프로세스 CPU에 없습니다.
바인딩 마스크.

빨간색 CPU가 허용된 세트에 없습니다(아래 참조).

검은색 CPU가 오프라인 상태입니다(일부 OS는 오프라인 CPU 표시를 지원하지 않음).

"허용된 집합"은 현재 프로세스가 바인딩할 수 있는 CPU 집합입니다. 그만큼
허용되는 집합은 일반적으로 상위 프로세스에서 상속되거나 관리 관리자가 설정합니다.
시스템의 q정책. Linux cpusets는 허용되는 집합을 제한하는 한 가지 예입니다.
프로세스와 그 자식이 시스템의 전체 CPU 집합보다 작아야 합니다.

따라서 서로 다른 프로세스는 허용 세트에서 서로 다른 CPU를 가질 수 있습니다. 따라서 호출
lstopo는 다른 상황에서 및/또는 다른 사용자에 따라 다른 색상을 표시할 수 있습니다.
동일한 개별 CPU(예: 한 컨텍스트에서 lstopo를 실행하면 특정 CPU가 다음과 같이 표시될 수 있음)
빨간색이지만 다른 컨텍스트에서 lstopo를 실행하면 동일한 CPU가 흰색으로 표시될 수 있습니다.

일부 lstopo 출력 모드, 예를 들어 콘솔 모드(기본 비그래픽 출력)는
색상을 전혀 지원하지 않습니다. 콘솔 모드는 위의 특성을 추가하여 표시합니다.
상세 메시지가 활성화된 경우 각 PU 라인에 텍스트.

관습 COLORS

그래픽 출력에서 ​​각 개체의 색상은 다음을 지정하여 적용할 수 있습니다.
해당 개체의 "lstopoStyle" 정보 특성입니다. 해당 값은 세미콜론으로 구분되어야 합니다.
"의 목록 =#rrggbb" 여기서 rr, gg 및 bb는 각각 색상의 RGB 구성 요소입니다.
0에서 255 사이, 00진수(XNUMX에서 ff). 아마도

배경
주 개체 상자의 배경색을 설정합니다.

배경2
예를 들어 개체에 대한 추가 상자의 배경색을 설정합니다.
NUMA 노드 상자 내부의 메모리 상자.

본문 개체 이름, 유형, 색인 등을 표시하는 텍스트의 색상을 설정합니다.

텍스트2 개체 근처의 추가 텍스트 색상(예: 링크 속도)을 설정합니다.
PCI 브리지 뒤에 있습니다.

"lstopoStyle" 정보는 hwloc-를 사용하여 임시로 저장된 XML 토폴로지에 추가될 수 있습니다.
주석을 달거나 hwloc_obj_add_info()를 사용합니다. 예를 들어 모든 핵심 개체를 파란색으로 표시하려면
(흰색 이름 포함):

lstopo 저장.xml
hwloc-annotate save.xml save.xml 코어:모든 정보 lstopoStyle
"배경=#0000ff;텍스트=#ffffff"
lstopo -i save.xml

LAYOUT

그래픽 출력에서 ​​lstopo는 간단한 직사각형 휴리스틱을 사용하여 4/3을 달성하려고 시도합니다.
너비와 높이 사이의 비율. 그러나 특정 NUMA 노드의 경우 레이아웃
사용자가 특정 NUMA 토폴로지를 믿게 하지 않도록 항상 평평한 직사각형입니다.
(lstopo는 아직 렌더링할 수 없습니다). 레벨의 레이아웃은 다음과 같이 변경할 수 있습니다.
--vert, --horiz 및 --rect.

사용 예

텍스트 모드에서 머신 토폴로지를 표시하려면:

lstopo-no-그래픽

ascii-art 모드에서 머신 토폴로지를 표시하려면:

lstopo-no-graphics -.ascii

그래픽 모드로 표시하려면(DISPLAY 환경 변수가
관련 값):

이스토포

토폴로지를 PNG 파일로 내보내려면:

lstopo 파일.png

컴퓨터에서 XML 파일을 내보내고 나중에 해당 그래픽 출력을 컴퓨터에 표시하려면
다른 기계:

machine1$ lstopo 파일.xml

machine2$ lstopo --input file.xml

현재 머신 토폴로지를 XML로 저장하고 나중에 여전히 더 빠르게 다시 로드하려면
현재 머신으로 간주:

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

XML 토폴로지를 물리적 프로세서 0, 1, 4 및 5로만 제한하려면:

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

논리적 인덱스가 1인 numa 노드로만 XML 토폴로지를 제한하려면 다음을 수행하십시오.

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

토폴로지 요약을 표시하려면 다음을 수행하십시오.

lstopo -s

토폴로지에 대한 자세한 정보를 얻으려면 다음을 수행하십시오.

lstopo -v

코어만 표시하려면:

lstopo --코어만

cpusets를 표시하려면:

lstopo --cpuset

패키지의 cpuset만 표시하려면:

lstopo --only 패키지 --cpuset-only

가짜 계층 구조를 시뮬레이션합니다. 이 예는 프로세서 장치 2개의 NUMA 노드 2개를 보여줍니다.

lstopo --input "n:2 2"

시스템의 논리 프로세서 수를 계산하려면

lstopo --만 pu | 화장실 -l

그래픽 범례에 커널 릴리스 및 버전을 추가하려면:

lstopo --append-legend "커널 릴리스: $(uname -r)" --append-legend "커널 버전:
$(uname -v)"

onworks.net 서비스를 사용하여 온라인으로 lstopo를 사용하세요.