<!-- $Header: /home/cvs/gentoo/ko/en/nvidia-guide.xml,v 1.1.1.1 2005/03/14 02:54:19 jenix Exp $ -->

<!-- $Header: /home/cvs/gentoo/ko/ko/nvidia-guide.xml,v 1.2 2005/03/15 13:56:41 prdd Exp $ -->

<guide link="/doc/en/nvidia-guide.xml">

<guide link="/doc/ko/nvidia-guide.xml">

<title>Gentoo Linux nVidia Guide</title>

<title>Gentoo Linux nVidia 가이드</title>

Many Gentooists have an nVidia chipset on their system. nVidia provides specific

많은 젠투 사용자들은 nVidia 칩셋을 사용하는 시스템을 가지고 있습니다. nVidia 는 카드의 성능을 

Linux drivers to boost the performance of your card. This guide informs you how

향상시켜주기 위한 특화된 리눅스 트라이버를 제공합니다. 이 문서는 여러분에게 이러한 드라이버를 

to install and configure these drivers.

설치하고, 설정하는 방법을 설명할 것입니다.

<title>Configuring your Card</title>

<title>카드 설정하기</title>

<title>Installing the Appropriate Drivers</title>

<title>전용 드라이버 설치하기</title>

The nVidia drivers include kernel modules that must integrate in your current

nVidia 드라이버는 현재 커널에 통합되어야 하는 커널 모듈이 포함되어 있습니다. 이 드라이버를 

kernel. To accomplish this, your kernel must support the loading of kernel

사용하기 위해서는, 커널이 커널 모듈 로딩을 지원해야 합니다. 만약 <c>genkernel</c> 을 커널 

modules. If you used <c>genkernel</c> to configure the kernel for you then

설정에 이용했다면, 준비는 되어 있을 것입니다. 그렇지 않다면, 이 이러한 지원이 활성화 되어 있는지 

you're all set. If not, double check your kernel configuration so that this

다시 한번 확인해 주십시요:

support is enabled:

<pre caption="Enabling the Loading of Kernel Modules">

<pre caption="커널 모듈 로딩 켜기">

You also need to enable <e>Memory Type Range Register</e> in your kernel:

<e>Memory Type Range Register</e> 역시 커널에서 활성화할 필요가 있습니다:

<pre caption="Enabling MTRR">

<pre caption="MTRR 활성화">

nVidia's modules and libraries are combined in two packages: <c>nvidia-glx</c> 

nVidia 의 모듈과 라이브러리는 다음 두개의 패키지로 구성되어 있습니다: <c>nvidia-glx </c> 와

and <c>nvidia-kernel</c>. The former are the X11 GLX libraries while the latter 

<c>nvidia-kernel</c> 입니다. 하나는 X11 GLX 라이브러리이고, 다음은 커널 모듈입니다. 

are the kernel modules. Since <c>nvidia-glx</c> depends on <c>nvidia-kernel</c>,

<c>nvidia-glx</c>는 <c>nvidia-kernel</c>과 의존성 관계가 설정되어 있기 때문에 

installing <c>nvidia-glx</c> is sufficient:

<c>nvidia-glx</c>만 설치하면 됩니다:

<pre caption="Installing the nVidia modules">

<pre caption="nVidia 모듈 설치">

Once the installation has finished, run <c>modprobe nvidia</c> to load the

설치가 완료되면, 커널 모듈을 메모리에 올리기 위해 <c>modprobe nvidia</c> 명령을 실행합니다.

kernel module into memory.

<pre caption="Loading the kernel module">

<pre caption="커널 모듈 로딩">

You probably want to have this done each time you boot your system, so edit

시스템이 부팅할 때마다 자동으로 실행하고 싶다면,

<path>/etc/modules.autoload.d/kernel-2.6</path> (or <path>kernel-2.4</path>) and

<path>/etc/modules.autoload.d/kernel-2.6</path> (또는 <path>kernel-2.4</path>) 를

add <c>nvidia</c> to it. Don't forget to run <c>modules-update</c> afterwards!

열고 <c>nvidia</c> 를 추가합니다. 그 후에 <c>modules-update</c> 명령을 실행하는 것을 잊지 

않도록 합니다.

<pre caption="Running modules-update">

<pre caption="modules-update 실행">

<title>Configuring the X Server</title>

<title>X 서버 설정</title>

Once the appropriate drivers are installed you need to configure your X Server

드라이버를 올바르게 설치한 후에, 여러분은 기본으로 사용되는 <c>nv</c> 드라이버 대신 

(XFree86 or Xorg) to use the <c>nvidia</c> driver instead of the default

<c>nvidia</c> 드라이버를 이용하도록 X 서버(XFree86 또는 Xorg)를 설정해야 합니다. 

<c>nv</c> driver.

Open <path>/etc/X11/XF86Config</path> (or <path>/etc/X11/xorg.conf</path>) with

<path>/etc/X11/XF86Config</path> (또는 <path>/etc/X11/xorg.conf</path>) 를 

your favorite editor (such as <c>nano</c> or <c>vim</c>) and go to the

마음에 드는 편집기(<c>nano</c> 또는 <c>vim</c> 같은)로 열고, <c>Device</c> 부분을 

<c>Device</c> section. In that section, change the <c>Driver</c> line:

찾습니다. 이곳에서 <c>Driver</c> 줄을 다음과 같이 편집합니다:

<pre caption="Changing nv to nvidia in the X Server configuration">

<pre caption="X 서버 설정에서 nv 를 nvidia 로 바꾸기">

Then go to the <c>Module</c> section and make sure the <c>glx</c> module gets

그리고, <c>Module</c> 부분을 찾아서 <c>glx</c> 모듈이 올라오도록 하고 <c>dri</c> 는

loaded while the <c>dri</c> module doesn't:

올라오지 않도록 합니다:

<pre caption="Updating the Module section">

<pre caption="Module section 수정">

Run <c>opengl-update</c> so that the X Server uses the nVidia GLX libraries:

<c>opengl-update</c> 를 실행해서 X 서버가 nVidia GLX 라이브러리를 사용하도록 합니다.

<pre caption="Running opengl-update">

<pre caption="opengl-update 실행">

<title>Adding your Users to the video Group</title>

<title>vidia 그룹에 사용자 추가</title>

You have to add your user to the <c>video</c> group so he has access to the

nvidia 장치에 접근 권한을 가지기 위해서는 사용자를 <c>video</c> 그룹에 추가해야 합니다:

nvidia device files:

<pre caption="Adding your user to the video group">

<pre caption="video 그룹에 사용자 추가">

# <i>gpasswd -a youruser video</i>

# <i>gpasswd -a 사용자명 video</i>

This might not be totally necessary if you aren't used <c>udev</c> but it

여러분이 <c>udev</c> 를 사용하지 않으면 전혀 필요하지 않지만, 이것은 해가 되지도 않을 뿐더러, 

doesn't hurt either and makes your system future-proof :)

앞으로의 시스템에 대한 준비가 됩니다. :)

<title>Testing your Card</title>

<title>Card 테스트</title>

To test your nVidia card, fire up X and run the <c>glxinfo | grep direct</c>

여러분의 nVidia 카드를 테스트하려면, X 를 시작하고, <c>glxinfo | grep direct</c> 명령을 

command. It should say that direct rendering is activated:

실행합니다. 다이렉트 렌더링이 활성화 되어 있는지를 알려줍니다:

<pre caption="Checking the direct rendering status">

<pre caption="다이렉트 렌더링 상태 확인">

To monitor your FPS, run <c>glxgears</c>. 

FPS 측정하기 위해서는, <c>glxgears</c> 를 실행합니다. 

<title>Enabling nvidia Support</title>

<title>nvidia 지원 활성화</title>

Some tools, such as <c>mplayer</c> and <c>xine-lib</c>, use a local USE flag

<c>mplayer</c> 나 <c>xine-lib</c> 같은, 몇몇 도구들에서, "nvidia" 라는 로컬 USE 플래그를 

called "nvidia" which enables XvMCNVIDIA support, useful when watching high

사용하는데, 이것은  XvMCNVIDIA 지원을 활성화하여 고해상도 동영상을 볼 때 효과적으로 사용됩니다. 

resolution movies. Add in "nvidia" in your USE variable in

<path>/etc/make.conf</path> 파일의 USE 변수에 "nvidia" 를 추가하거나,  

<path>/etc/make.conf</path> or add it as USE flag to <c>media-video/mplayer</c>

<path>/etc/portage/package.use</path> 파일의 <c>media-vidia/mplayer</c> 나 

and/or <c>media-libs/xine-lib</c> in <path>/etc/portage/package.use</path>.

<c>media-libs/xine-lib</c> 에 USE 플래그로 추가합니다.

Then, run <c>emerge -uD --newuse world</c> to rebuild the applications that

그 후, 바뀐 USE 플래그를 반영하기 위해서, <c>emerge -uD --newuse world</c> 명령을 실행하여 

benefit from the USE flag change.

어플리케이션을 다시 빌드합니다.

<title>Troubleshooting</title>

<title>문제해결</title>

<title>Getting 2D to work on machines with 4Gb or more memory</title>

<title>4G 보다 큰 메모리를 사용하는 장비에서 2D 사용하기</title>

If you are having troubles with the nVidia 2D acceleration it is likely that you

nVidia 2D 가속에 문제가 있다면, 대게 MTRR 의 write-combining 설정을 할 수 없다는 말입니다. 

are unable to set up a write-combining range with MTRR. To verify, check the

확인하려면, <path>/proc/mtrr</path> 의 내용을 확인하세요:

contents of <path>/proc/mtrr</path>:

<pre caption="Checking if you have write-combining enabled">

<pre caption="write-combining 활성화 여부 확인">

Every line should contain "write-back" or "write-combining". If you see a line

모든 줄에는 "write-back" 또는 "write-combining" 이 포함되어 있을 것입니다. "uncachable" 이 

with "uncachable" in it you will need to change a BIOS setting to fix this.

들어있는 줄을 발견했다면, BIOS 설정을 변경할 필요가 있습니다. 

Reboot and enter the BIOS, then find the MTRR settings (probably under "CPU

리부트 후 BIOS 로 들어가, MTRR (아마도 "CPU Settings" 항목에 에 있을 것입니다) 설정을

Settings"). Change the setting from "continuous" to "discrete" and boot back

찾습니다. "continuous" 라고 된 것을 "discrete" 로 바꾸고, 다시 리눅스로 부팅하세요. 

into Linux. You will now find out that there is no "uncachable" entry anymore

여러분은 "uncachable" 항목을 더이상 찾을 수 없을 것이며, 2D 가속이 문제 없이 작동하는 것을 

and 2D acceleration now works without any glitches.

확인할 수 있을 것입니다.

<title>I receive warnings about unsupported 4K stack sizes</title>

<title>지원하지 않는 4K 스택 크기라는 경고 메시지</title>

<c>nvidia-kernel</c> packages older than 1.0.6106 only support kernels using an

1.0.6106 이전의 <c>nvidia-kernel</c> 패키지는 8K 스택 크기만 지원했습니다. 최근의 커널은 

8K stack size. More recent kernels (2.6.6 and higher) have support for 4K stack

(2.6.6 이상) 은 4K 스택을 지원합니다. 이와 같은 <c>nvidia-kernel</c> 패키지를 사용하고 

size's as well. Do not select 4K stack size in your kernel configuration if you

있으신 분은, 커널 설정에서 4K 스택을 선택하지 않도록 합니다. <c>Kernel Hacking</c> 

are using such an <c>nvidia-kernel</c> package. You can find this option in the

부분에서 해당 옵션을 찾을 수 있습니다.

section <c>Kernel Hacking</c>.