Insights
AI가 자동으로 큐레이션·번역·정리하는 기술 동향 피드입니다.
x3dctl은 Linux 시스템에서 AMD X3D CPU의 운영 모드를 제어하는 경량 커맨드라인 유틸리티입니다. 이 도구는 전역 X3D 모드 전환과 개별 애플리케이션에 대한 프로세스 정책을 분리하여, 사용자가 워크로드 특성에 맞는 최적화된 환경을 구축할 수 있게 합니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 GitHub ML Hardware의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기x3dctl은 Linux 시스템에서 AMD X3D CPU 운영 모드를 제어하는 경량의 커맨드라인 유틸리티입니다.
이 도구는 다음을 위한 안전하고 결정론적인 인터페이스를 제공합니다:
x3dctl은 데몬(daemon)을 실행하지 않으며 백그라운드 폴링(polling)도 수행하지 않습니다. 모든 동작은 명시적이고 커맨드 기반이며 런타임 전용입니다. 따라서 백그라운드 오버헤드가 없습니다.
x3dctl은 **시스템 상태(system posture)**와 **프로세스 정책(process policy)**을 분리합니다.
이를 통해 사용자는 다음 중 선택할 수 있습니다:
man x3dctl
| 명령어 | 설명 |
|---|---|
| gaming | 캐시 우선 모드로 전환하고 GPU IRQ를 제어합니다. |
| ... |
x3dctl은 두 가지 시스템 상태를 지원합니다:
프로필은 다음에서 정의됩니다:
/etc/x3dctl.conf
애플리케이션은 다음에서 매핑됩니다:
/etc/x3dctl.conf
x3dctl status
irqbalance 서비스는 하드웨어 인터럽트를 사용 가능한 CPU 전반에 걸쳐 분배합니다.
이는 멀티 코어 시스템에서 부하 균형을 개선하기 위해 IRQ를 동적으로 마이그레이션합니다.
이종(heterogeneous) CPU 설계(AMD X3D 프로세서와 같은)의 경우, 자동 IRQ 마이그레이션은 워크로드 및 구성에 따라 **캐시-투-캐시 지연 시간(cache-to-cache latency)**을 유발할 수 있습니다.
x3dctl은 모드를 전환할 때 결정론적 GPU IRQ 친화성(affinity)을 적용합니다. 만약 irqbalance가 활성화되어 있다면, 이 친화성 설정을 덮어쓸 수 있습니다.
완전히 결정론적인 동작을 위해서는 x3dctl 사용 시 irqbalance를 비활성화하거나 적절하게 구성하는 것이 권장됩니다.
x3dctl에 의해 이루어진 IRQ 친화성 변경은 런타임 전용이며 시스템 재부팅 시 유지되지 않습니다.
irqbalance 서비스는 수동으로 적용된 IRQ 친화성을 덮어쓸 수 있습니다.
x3dctl은 irqbalance에 의존하지 않으며, 서비스가 활성화되었는지 여부만 보고합니다.
x3dctl은 지원되는 AMD X3D 시스템에서 명시적인 워크로드 배치 및 정책을 적용합니다. 그 핵심 기능은 펌웨어의 선호 코어 가이드(preferred-core guidance)에 전적으로 의존하지 않습니다.
최상의 결과를 얻으려면, 해당되는 경우 amd_pstate가 활성화되어 있어야 하며 BIOS/펌웨어에서 CPPC Preferred Cores가 Driver로 설정되어야 합니다.
이는 커널과 스케줄러가 x3dctl의 명시적 배치 로직과 함께 선호 코어(preferred-core) 정보를 더 잘 활용할 수 있도록 합니다.
만약 CPPC Preferred Cores가 Driver로 설정되어 있지 않다면, x3dctl도 작동할 수는 있지만, 워크로드, 커널, 스케줄러 및 펌웨어 처리 방식에 따라 동작이 일관적이지 않을 수 있거나 더 일반적인 스케줄러 동작으로 되돌아갈 수 있습니다.
BIOS의 문구는 제조사마다 다를 수 있으며, x3dctl은 이 설정을 런타임에 수정하지 않습니다.
irqbalance 및 amd_pstate 문서 링크가 다음 업데이트에서 readme에 추가될 예정이며, 사용법은 man 페이지에 있을 것입니다.
| Profile | CPU Affinity | Nice | Scheduler | IO |
|---|---|---|---|---|
| gaming | cache CCD | -5 | SCHED_OTHER | BE/0 |
| ... |
unrestricted는 정책 적용을 비활성화하는 것이 아니라, 스케줄러, niceness(우선순위), I/O 우선순위는 계속 적용하면서 CPU 친화도만 건너뜁니다.
(워크로드 및 시스템 사용량에 따라 일부 게임이 이 모드에서 더 잘 실행될 수 있습니다)
프로파일은 특권 계층의 헬퍼 내부에서 강제되며, 동적 또는 런타임 중에는 정의할 수 없습니다. 애플리케이션 키는 실행 파일의 기본 이름과 일치해야 합니다.
make
sudo make install
sudo make uninstall
x3dctl은 수동 설치 시 비밀번호 프롬프트를 줄이거나 제거하려는 사용자를 위해 선택적인 기능 기반 편의 경로를 지원합니다.
확장 모드 (고급, 최선 노력):
커널 및 권한 모델에 따라 cap_sys_nice + cap_sys_admin은 전역 모드 작업에 대해 더 광범위한 비밀번호 없는 동작을 활성화할 수 있습니다.
활성화(Enable):
sudo make pw-install
비활성화(Disable):
sudo make pw-uninstall
이를 통해 권한을 제거하고 기본 sudo/sudoers 동작으로 되돌립니다.
/usr/local/bin/usr/local/share/man/man1.AUR 헬퍼 사용 시.
yay -S x3dctl
git clone https://aur.archlinux.org/x3dctl.git
cd x3dctl
makepkg -si
sudo pacman -R x3dctl
.이 패키지는 설치된 바이너리, man 페이지 및 sudoers 정책을 제거합니다.
.설정 파일은 보존됩니다.
sudo make pw-install
은 소스 설치 편의(source-install convenience) 타겟이며 AUR/패키지 설치 중에는 사용되지 않습니다.
AUR 사용자들은 설치 후 다음 명령어로 동일한 확장된 권한 모드를 활성화할 수 있습니다:
활성화(Enable):
sudo setcap 'cap_sys_nice,cap_sys_admin=ep' /usr/bin/x3dctl-helper
비활성화(Disable):
sudo setcap -r /usr/bin/x3dctl-helper