NVIDIA Accelerated Linux Graphics Driver README and Installation Guide

NVIDIA Corporation

ALL NVIDIA DESIGN SPECIFICATIONS, REFERENCE BOARDS, FILES, DRAWINGS, DIAGNOSTICS, LISTS, AND OTHER DOCUMENTS (TOGETHER AND SEPARATELY, "MATERIALS") ARE BEING PROVIDED "AS IS." NVIDIA MAKES NO WARRANTIES, EXPRESSED, IMPLIED, STATUTORY, OR OTHERWISE WITH RESPECT TO THE MATERIALS, AND EXPRESSLY DISCLAIMS ALL IMPLIED WARRANTIES OF NONINFRINGEMENT, MERCHANTABILITY, AND FITNESS FOR A PARTICULAR PURPOSE. Information furnished is believed to be accurate and reliable. However, NVIDIA Corporation assumes no responsibility for the consequences of use of such information or for any infringement of patents or other rights of third parties that may result from its use. No license is granted by implication or otherwise under any patent or patent rights of NVIDIA Corporation. Specifications mentioned in this publication are subject to change without notice. This publication supersedes and replaces all information previously supplied. NVIDIA Corporation products are not authorized for use as critical components in life support devices or systems without express written approval of NVIDIA Corporation.

NVIDIA, the NVIDIA logo, NVIDIA nForce, GeForce, NVIDIA Quadro, Vanta, TNT2, TNT, RIVA, RIVA TNT, Tegra, and TwinView are registered trademarks or trademarks of NVIDIA Corporation in the United States and/or other countries.

Linux is a registered trademark of Linus Torvalds. Fedora and Red Hat are trademarks of Red Hat, Inc. SuSE is a registered trademark of SuSE AG. Mandriva is a registered trademark of Mandriva S.A. Intel and Pentium are registered trademarks of Intel Corporation. Athlon is a registered trademark of Advanced Micro Devices. OpenGL is a registered trademark of Silicon Graphics Inc. PCI Express is a registered trademark and/or service mark of PCI-SIG. Windows is a registered trademark of Microsoft Corporation in the United States and other countries. Other company and product names may be trademarks or registered trademarks of the respective owners with which they are associated.


Table of Contents

I. Installation and Configuration Instructions
1. Introduction
2. Minimum Requirements
3. Selecting and Downloading the NVIDIA Packages for Your System
4. Installing the NVIDIA Driver
5. Listing of Installed Components
6. Configuring X for the NVIDIA Driver
7. Frequently Asked Questions
8. Common Problems
9. Known Issues
10. Allocating DMA Buffers on 64-bit Platforms
11. Specifying OpenGL Environment Variable Settings
12. Configuring Multiple Display Devices on One X Screen
13. Configuring GLX in Xinerama
14. Configuring Multiple X Screens on One Card
15. Support for the X Resize and Rotate Extension
16. Configuring a Notebook
17. Using the NVIDIA Driver with Optimus Laptops
18. Programming Modes
19. Configuring Flipping and UBB
20. Using the /proc File System Interface
21. Configuring Power Management Support
22. PCI-Express Runtime D3 (RTD3) Power Management
23. Using the X Composite Extension
24. Using the nvidia-settings Utility
25. NVIDIA Spectre V2 Mitigation
26. Using the nvidia-smi Utility
27. The NVIDIA Management Library
28. Using the nvidia-debugdump Utility
29. Using the nvidia-persistenced Utility
30. Configuring SLI and Multi-GPU Mosaic
31. Configuring Frame Lock and Genlock
32. Configuring Depth 30 Displays
33. Offloading Graphics Display with RandR 1.4
34. PRIME Render Offload
35. Direct Rendering Manager Kernel Modesetting (DRM KMS)
36. Configuring External and Removable GPUs
37. NGX
38. OpenGL and Vulkan on Xwayland
39. GBM and GBM-based Wayland Compositors
40. Addressing Capabilities
41. GPUDirect RDMA Peer Memory Client
42. GSP Firmware
43. NVIDIA Contact Info and Additional Resources
44. Acknowledgements
II. Appendices
A. Supported NVIDIA GPU Products
B. X Config Options
C. Display Device Names
D. GLX Support
E. Dots Per Inch
F. i2c Bus Support
G. VDPAU Support
H. Audio Support
I. Tips for New Linux Users
J. Application Profiles
K. GPU Names