NVIDIA Accelerated FreeBSD 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, Quincunx Antialiasing, and TwinView are registered trademarks or trademarks of NVIDIA Corporation in the United States and/or other countries.

FreeBSD is a registered trademark of the FreeBSD Foundation. Linux is a registered trademark of Linus Torvalds. 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 Software Requirements
3. Installing the NVIDIA Driver
4. Installed Components
5. Using Linux Compatibility Support
6. Configuring X for the NVIDIA Driver
Using nvidia-xconfig to configure the X server
Manually Editing the Configuration File
7. Frequently Asked Questions
8. Common Problems
9. Known Issues
10. Specifying OpenGL Environment Variable Settings
11. Configuring AGP
12. Configuring TwinView
13. Configuring GLX in Xinerama
14. Configuring Multiple X Screens on One Card
15. Configuring TV-Out
16. Using the XRandR Extension
17. Configuring a Notebook
18. Programming Modes
19. Configuring Flipping and UBB
20. The Sysctl Interface
21. Configuring Low-level Parameters
22. Using the X Composite Extension
23. Using the nvidia-settings Utility
24. Configuring SLI and Multi-GPU FrameRendering
25. Configuring Frame Lock and Genlock
26. Configuring SDI Video Output
27. Configuring Depth 30 Displays
28. NVIDIA Contact Info and Additional Resources
29. Credits
30. Acknowledgements
II. Appendices
A. Supported NVIDIA GPU Products
B. X Config Options
C. Display Device Names
D. GLX Support
E. Dots Per Inch
F. XvMC Support
G. VDPAU Support
Implementation Limits
VdpVideoSurface
VdpBitmapSurface
VdpOutputSurface
VdpDecoder
VdpVideoMixer
VdpPresentationQueue
Performance Levels
Getting the Best Performance from the API
Additional Notes
Debugging and Tracing
H. Tips for New FreeBSD Users