NVIDIA/nvidia-drivers/ko

x11-drivers/nvidia-drivers는 nVidia 그래픽 카드용 상용 그래픽 드라이버입니다. 대신 사용하는 오픈 소스는 nouveau가 있습니다.

트리에 있는 엔비디아 드라이버는 nVidia가 출시하며 리눅스 커널에 대응하여 빌드합니다. 카드와의 엄청난 양의 데이터를 주고받는 바이너리 블롭이 포함되어 있습니다. 드라이버는 두 부분으로 나뉘는데 하나는 커널 모듈이고 다른 하나는 X11 드라이버 입니다. 두 부분은 단일 패키지에 포함되어 있습니다. nVidia가 자체적으로 드라이버를 꾸러미에 담아두므로 드라이버를 설치하기 전에 어떤걸 사용할지 선택해야 합니다.

nvidia-drivers 패키지에는 엔비디아의 모든 카드를 지원하는 최신 드라이버와 카드가 얼마나 오래됐는지의 여부에 따라 다양한 버전이 들어있습니다. 어떤 카드를 사용하는지 감지하는 eclass를 사용하므로 적당한 버전을 설치합니다.

하드웨어 호환성
꾸러미에서는 다양한 엔비디아 카드를 지원합니다. 가지고 있는 카드에 따라 설치할 여러가지 버전이 존재합니다. 어떤 nvidia-drivers 버전을 사용해야 하는지에 대해서는 구형 드라이버란 무엇인가? 라는 공식 엔비디아 문서를 보십시오. 여기 에서 제공하는 대화형 양식을 통해 꽤 괜찮은 방법으로 이 문서를 찾아 볼 수도 있습니다. 가지고 있는 그래픽 카드를 입력('제품 형식' 필드에 Legacy 옵션이 있습니다) 하면 양식 하단에서 지원하는 가장 최상의 버전을 찾을 수 있습니다.

The package supports a range of available nVidia cards. Multiple versions are available for installation, depending on the card(s) that the system has. See the official nVidia documentation, What's a legacy driver?, to find out what version of should be used. A pretty decent way to find this out through an interactive form. Enter the graphics card that is used by the system (mind the Legacy option in the 'Product Type' field) and the form should end up with the best supported version.

가지고 있는 카드가 구형 카드임을 확인했다면 의 최근 릴리즈를 가려야 합니다. 예를 들자면:

젠투에서는 71.86.xx 버전을 제공하지 않음을 참고하십시오. 이 드라이버가 필요하다면 nouveau 드라이버를 사용하시는것이 낫습니다.

커널
위에 말한 바와 같이 엔비디아 커널 드라이버는 현재 설치한 커널에 대해 빌드하고 실행합니다. 모듈로 빌드하기 때문에 커널에서 모듈 불러오기를 지원해야 합니다 (하단 참조).

As mentioned above, the nVidia kernel driver installs and runs against the current kernel. It builds as a module, so the kernel must support the loading of kernel modules (see below).

커널 모듈(nvidia.ko)은 그래픽 칩을 다루는 상업용 부분(일반적으로 "바이너리 블롭"이라고 함)과 바이너리 블롭과 커널간을 실행 시간에 중재하는 오픈소스 부분("접착제"역할)이 있습니다. 함께 제대로 동작해야 하는데 그렇지 않으면 데이터 손실(커널 망가짐, X 프로그램에서 데이터를 저장하지 않은 채로 X 서버 깨짐)에 직면하게 되고 심지어는 하드웨어 동작 실패 현상이 일어나기도 합니다(과열되거나 전원 관리 관련 문제가 떠오를 것입니다).

커널 호환성
때때로, 새 커널 릴리스에는 드라이버에 대한 내부 ABI가 바뀌는데, 이들 ABI를 사용하는 모든 드라이버는 즉시 바뀌어야 함을 의미합니다. 오픈소스 드라이버에서는 특히 커널에 배포하는 드라이버의 경우 드라이버들간의 호출 매개를 연결하는 전체적인 부분을 수정해야 함은 자명한 사실이며 커널의 다른 부분은 쉽게 검토해볼 수 있습니다. nvidia.ko와 같은 상업용 드라이버는 조금 동일하게 동작하는 것이 아닙니다. 내부 ABI가 바뀌면 "붙어 있는 요소"를 거의 수정할 수 없는데 상업 코드 부분에서 사용하는 고정물이 어떻게 사용되는지 알 수 없기 때문입니다. 이런 문제를 패치하기 위해 관리하고 제대로 동작하게끔 하려면 지원하지 않는 새 커널에서 nvidia.ko를 실행하는데 있어 위험성을 감수해야 하며, 데이터를 잃을 수 있고, 하드웨어가 망가질 수 있습니다.

From time to time, a new kernel release changes the internal ABI for drivers, which means all drivers that use those ABIs must be changed accordingly. For open source drivers, especially those distributed with the kernel, these changes are nearly trivial to fix since the entire chain of calls between drivers and other parts of the kernel can be reviewed quite easily. For proprietary drivers like nvidia.ko, it doesn't work quite the same. When the internal ABIs change, then it is not possible to merely fix the "glue", because nobody knows how the glue is used by the proprietary part. Even after managing to patch things up to have things seem to work nicely, the user still risks that running nvidia.ko in the new, unsupported kernel will lead to data loss and hardware failure.

비호환 새 커널버전이 출시되면 아마도 당분간은 새로 지원하는 커널에 그대로 의지하는 것이 좋을 것입니다. Nvidia 에서는 보통 사용하는데 적합하다고 생각하는 새로운 상업 릴리스를 준비하는데 몇 주가 걸립니다. 그냥 기다리십시오. 혼란속에 모든 위험성을 내던지고 싶은 여러분들을 위해 nvidia-drivers 이빌드는 eutils.eclass에서 지원하는 epatch_user 명령을 실행합니다. 이 명령으로 최신의 비 지원 커널 릴리스에 맞춰 nvidia-drivers를 패치할 수 있습니다. 문제 상황에 직면했을때 nvidia-drivers 메인테이너, Nvidia 회사 양측 그 어느 누구도 지원하지 않음을 참고하십시오. 하드웨어 보증이 무효가 될 수 있고, 젠투 메인테이너는 Nvidia만이 제대로 디버그 할 수 있는 상업용 드라이버를 수정할 수 없으며, 커널 메인테이너(젠투와 업스트림) 역시 상업용 드라이버 또는 문제 상황으로 치달아 "망가진" 시스템으로 간주된 대상은 지원하지 않습니다.

요구 커널 옵션
커널을 설정하는데 genkernel all 옵션을 사용했다면, 모든 항목이 설정되어 있습니다만, 그렇지 않다면 지원 기능을 활성화 했는지 커널 설정을 다시 확인하십시오:

If genkernel all was used to configure the kernel, then everything is all set. If not, double check the kernel configuration so that this support is enabled:

커널에서 Memory Type Range Register도 활성화해야 합니다:

또한 AGP 그래픽 카드를 보유하고 있다면, 추가적으로 커널에서 커널에 컴파일 하여 포함한 방식 또는 모듈로 agpgart 지원을 활성화 할 수 있습니다. 커널에 포함한 agpgart를 사용하지 않으면 드라이버에서는 NvAGP라는 자체 agpgart 구현체를 활용합니다. 어떤 시스템에서는 커널에 포함한 agpgart보다 더욱 우수한 성능을 보이며, 그렇지 않은 경우 그 반대의 성능을 보입니다. 여러분은 최상의 성능을 취하기 위해 드라이버를 시험해보려 할 것입니다. 무엇이 어떤지 확실하게 판단이 되지 않으면 커널에 있는 agpgart를 사용하십시오:

대신 사용하는 프레임버퍼 드라이버는 nvidia-drivers와 나란히 설치할 수 있는 uvesafb입니다.

nvidia-drivers 이빌드에서는 심볼릭 링크에 따라 자동으로 커널 버전을 찾습니다. 커널을 올바르게 설정한 올바른 소스로 심볼릭 링크를 연결했는지 확인하십시오. 커널 설정에 대한 자세한 내용은 젠투 핸드북의 "커널 설정하기" 장을 참고하십시오.

먼저 eselect 명령으로 올바른 커널 소스를 선택해야 합니다. gentoo-sources-3.7.10을 사용한다면, 아마 커널 목록은 다음 처럼 보일지도 모릅니다:

위의 출력 내용을 보시면 linux-3.7.10-gentoo 커널에 심볼릭 링크로 연결되었음을 나타내려고 별표(*)로 표시했음을 볼 수 있습니다.

심볼릭 링크가 올바른 소스를 가리키는 것이 아니면, 위 예에서 보신바와 같이 결정한 커널 소스의 번호를 선택하여 업데이트해야 합니다.

드라이버
이제 드라이버를 설치할 차례입니다. 먼저 X서버 설정하기 방법을 먼저 따르고 에 VIDEO_CARDS="nvidia" 설정을 넣으십시오. 그러면 X 서버를 설치할 때 올바른 버전의 nvidia-drivers를 알아서 설치합니다.

설치가 끝나면, modprobe nvidia를 실행하여 메모리로 커널 모듈을 불러내십시오. 업그레이드라면 이전 모듈을 먼저 제거해야 합니다.

부팅할 때마다 모듈을 수동으로 하나하나 불러오는 일을 피하려 시스템을 매번 부팅할 때 자동으로 처리하려 할테니, 를 편집하여 nvidia를 추가하십시오.

X 서버
알맞은 드라이버를 설치하면 기본 nv드라이버 대신 nvidia드라이버를 사용하도록 X 서버를 설정해야 합니다.

Once the appropriate drivers are installed, configure the X server to use the nvidia driver instead of the default nv driver.

eselect를 실행하여 X 서버에서 nVidia GLX 라이브러리를 사용하도록 하십시오:

카드 시험하기
nVidia 카드를 시험하려면, X를 실행 후 mesa-progs 꾸러미에 있는 glxinfo를 실행하십시오. 이 프로그램에서 DRM을 활성화했는지 나와야 합니다.

To test the nVidia card, fire up X and run glxinfo, which is part of the package. It should say that direct rendering is activated:

FPS를 확인하려면 glxgears를 실행하십시오.

nVidia 지원 활성화
mplayer나 xine-lib 같은 도구에서는 XvMCNVIDIA 지원을 활성화하는 xvmc USE 플래그를 사용하는데, 이 플래그는 고해상도 동영상을 감상할때 유용합니다. 의 USE 변수에 xvmc를 추가하거나, 에 media-video/mplayer 혹은 media-libs/xine-lib에 USE 플래그로 추가하십시오.

Some tools, such as and, use a local USE flag called   which enables XvMCNVIDIA support, useful when watching high resolution movies. Add in  in the USE variable in  or add it as USE flag to   and/or   in.

지포스 8 시리즈 이수의 GPU에서는 XvMCNVIDIA를 대신하는 VDPAU를 지원합니다. VDPAU 지원 활성화 내용은 VDPAU 내용을 살펴보십시오.

nvidia USE 플래그를 사용하는 일부 프로그램이 있으므로 에 추가하시는 것이 좋습니다.

그 다음 emerge -uD --newuse @world 명령을 실행하여 바뀐 USE 플래그의 효과를 보기 위해 여러 프로그램을 다시 빌드하십시오.

NVidia 설정 도구 사용
nVidia는 설정 도구도 함께 제공합니다. 이 도구는 X 서버를 다시 시작하지 않고도 그래픽 설정을 보고 바꿀 수 있게 하며 media-video/nvidia-settings 이름으로 포티지 트리에서 제공합니다. 이미 말씀드렸다시피, 또는  에서 gtk USE 플래그 설정 후 드라이버를 설치하면 도구가 자동으로 따라옵니다.

nVidia also provides a settings tool. This tool allows the user to monitor and change graphical settings without restarting the X server and is available through Portage as. As mentioned earlier, it will be pulled in automatically when installing the drivers with the  USE flag set in  or in.

OpenGL/OpenCL 활성화
OpenGL과 OpenCL을 활성화 하십시오.

위 사항을 바꾸는 동안 Xorg 서버가 동작중이 아닌지 반드시 확인해야 합니다.

문제 해결




MSI 인터럽트를 활성화 하면 드라이버 초기화에 실패하네요
리눅스 NVIDIA 드라이버는 메시지 신호 인터럽트(MSI)를 기본으로 사용합니다. 이 기능은 호환성과 확장성의 장점을 제공하는데, 주된 이유라면 IRQ 공유를 막기 위해서입니다. 어떤 시스템에서는 가상 연결 인터럽트로 제대로 동작하지만, 일부 시스템에서는 MSI 지원에 문제가 있어보입니다. 이 문제는 NVIDIA 드라이버로 X를 시작하는데 있어서 불가능한 것으로 보이며, 또는 CUDA 초기화 문제로 보이기도 합니다.

MSI 인터럽트는 NVIDIA 커널 모듈 매개변수에  값을 부여하여 비활성화 할 수 있습니다. 이 값은 모듈을 불러오는 과정에서, 또는 배포본에서 제공하는 커널 모듈 설정 파일( 같은 디렉터리에 있음)에서 설정할 수 있습니다.

예를 들자면:

4GB 이상 용량의 메모리를 가진 머신에서 2D 가속 활성화하기
nVidia 2D 가속에 문제가 있다면 아마도 MTRR의 라이트-컴바이닝 범위를 설정할 수 없는 경우일지도 모릅니다. 원인을 확인하려면 다음 명령으로 의 내용을 확인하십시오:

When nVidia 2D acceleration is giving problems, then it is likely that the system is unable to set up a write-combining range with MTRR. To verify, check the contents of :

모든 줄에 "write-back" 또는 "write-combining"이 있어야 합니다. "uncachable"이 있다면, 이 문제를 고치기 위해 BIOS 설정을 바꾸어야 합니다.

다시 부팅하고 BIOS로 들어가신 다음 MTRR 설정을 찾으십시오(아마 "CPU 설정"에 있을겁니다). "continuous"에서 "discrete"로 설정을 바꾸고 리눅스로 돌아가십시오. 더이상 "uncachable"이 없고, 튐 현상 없이 2D 가속이 잘 동작하는걸 보실 수 있습니다.

커널 모듈을 불러오려는데 "no such device" 메시지를 받았습니다
보통 다음 문제 중 하나가 원인입니다:

This is usually caused by one of the following issues:

1. 어쨌거나 nVidia 카드를 가지고 있지 않습니다. lspci 출력을 보고 nVidia 그래픽 카드를 설치했고 감지했는지 확인하십시오.

Xorg says it can't find any screens
When after booting the system, it ends up with a black screen or a console prompt instead of the GUI; then press to bring up a console prompt. Next, run:

to see the output of Xorg. If one of the first errors is that Xorg can't find any screens, then follow the following steps to resolve the issue.

It should be enough to run the following command before rebooting:

But if that doesn't work, run lspci and notice that the video card starts off like this:

Take the first bit,  and put it in the  file with the   option:

직접 렌더링이 활성화 되지 않아요
직접 렌더링이 동작하지 않는다면, 드라이버와 충돌하게끔 커널에서 직접 렌더링 관리자를 활성화했기 때문일 수도 있습니다. "카드 시험하기" 장의 절차를 따라 직접 렌더링 상태를 볼 수 있습니다.

먼저 직접 렌더링 관리자(CONFIG_DRM)을 커널에서 비활성화 하십시오:

그리고 커널 DRM 심볼에 대해 드라이버를 빌드했을터이니 x11-drivers/nvidia-drivers를 다시 빌드하십시오. 이리 하면 문제를 해결할 수 있습니다.

문서
nVidia 드라이버 꾸러미에는 실용적인 문서가 있습니다. 이 문서는 /usr/share/doc에 있으며 다음 명령으로 살펴볼 수 있습니다:

The nVidia driver package also comes with comprehensive documentation. This is installed into and can be viewed with the following command:

커널 모듈 매개 변수
nvidia 커널 모듈은 드라이버의 동작을 세밀하게 설정할 수 있는 몇가지 매개 변수(옵션)를 받아들입니다. 대부분 이 매개 변수 설명은 문서에 있습니다. 이 매개 변수의 값을 추가하거나 바꾸려면 /etc/modprobe.d/nvidia.conf 파일을 편집하십시오. 이 파일을 편집한 다음 update-modules실행을 잊지 마시고, 새 설정을 적용하기 전에 nvidia 모듈을 다시 불러와야 함도 잊지 마십시오.

The nvidia kernel module accepts a number of parameters (options) which can be used to tweak the behaviour of the driver. Most of these are mentioned in the documentation. To add or change the values of these parameters, edit the file. Remember to run update-modules after modifying this file, and bear in mind to reload the  module before the new settings take effect.

원하는 편집기에서 /etc/modprobe.d/nvidia.conf를 편집하십시오:

모듈 정보를 업데이트하십시오:

nvidia 모듈을 불러온 상태를 취소하십시오...

...그리고 다시 불러오십시오:

고급 X 설정
GLX 계층에는 설정 가능한 상당히 많은 옵션이 있습니다. TV 출력, 듀얼 디스플레이, 모니터 주파수 감지 등의 설정을 다룰 수 있습니다. 다시 말씀드리지만, 여기에 있는 모든 옵션은 문서에 자세히 설명되어 있습니다.

The GLX layer also has a plethora of options which can be configured. These control the configuration of TV out, dual displays, monitor frequency detection, etc. Again, all of the available options are detailed in the documentation.

이 옵션을 사용하려면 X 설정 파일의 관련 장치 섹션에 있는 목록을 살펴봐야 합니다(보통 /etc/X11/xorg.conf에 있음). 가령, 스플래시 로고를 비활성화 하려는 상황을 가정해보겠습니다.

추가 참조

 * nouveau & nvidia-drivers switching
 * NVIDIA Driver with Optimus Laptops

감사문
이 안내서에 제공한 노고에 대해 다음 작성자와 편집자분들께 감사의 말을 전하고자 합니다: Sven Vermeulen, Joshua Saddler, M Curtis Napier and Chris Gianelloni.