Difference between pages "Template:Infobox software/Doc" and "Package:NVIDIA Linux Display Drivers"

From Funtoo
(Difference between pages)
Jump to navigation Jump to search
m (Removed cite web unexisting template)
 
 
Line 1: Line 1:
 
{{Ebuild
== Usage ==
|Summary=NVIDIA accelerated graphics driver
<pre style="overflow:auto;">
|CatPkg=x11-drivers/nvidia-drivers
{{Infobox software
|Maintainer=Ricardo Bastos
| name                  =
|Repository=Funtoo Overlay
| title                  =  
|Overlay=Funtoo
| logo                  = <!-- [[File: ]] -->
| screenshot            = <!-- [[File: ]] -->
| caption                =
| collapsible            =
| author                =
| developer              =
| released              = <!-- {{Start date|YYYY|MM|DD|df=yes/no}} -->
| discontinued          =
| latest release version =
| latest release date    = <!-- YYYY-MM-DD -->
| latest preview version =
| latest preview date    = <!-- YYYY-MM-DD -->
| frequently updated    = <!-- DO NOT include this parameter unless you know what it does -->
| programming language  =
| operating system      =
| platform              =
| size                  =
| language              =
| status                =
| genre                  =  
| license                =  
| website                = example.org
}}
}}
</pre>
== Introduction ==


NVidia have proprietary graphics drivers for Linux under binary blob. The alternative open source driver is nouveau.


== Example ==
=== Preparing to Install ===
<div class="dablink">The following example is captured on 1 September 2010 from [[GIMP]] article and is include '''only with the purpose serving as an example.''' Information included in this example infobox are therefore bound to become obsolete as the time passes. Images in this example are published under free licenses.</div>
{{Infobox software
| name                  = GIMP
| logo                  = [[File:The GIMP icon - gnome.svg|64px|Wilber, The GIMP mascot]]
| screenshot            = [[File:Gimpscreen.png|250px]]
| caption                = Screenshot of GIMP 2.6
| developer              = The GIMP Development Team
| released              = 1996
| latest preview version = 2.7.1
| latest preview date    = 2010-06-29
| latest release version = 2.6.10
| latest release date    = 2010-07-08
| programming language  = [[C (programming language)|C]] and [[GTK+]]
| operating system      = [[Linux]], [[Mac OS X]], [[Microsoft Windows]], [[FreeBSD]], [[Solaris (operating system)|Solaris]]
| language              = 52 languages in GIMP 2.6, 37 fully translated, others partly translated.[http://www.gimp.org/docs/ GIMP - Documentation][http://l10n.gnome.org/module/gimp/ GNOME GIMP translation statistics, see GIMP 2.6]
| status                = Active
| genre                  = [[Raster graphics editor]]
| license                = [[GNU General Public License]]
| website                = www.gimp.org
}}


<pre style="overflow:auto;">
==== Hardware compatibility and driver versions ====  
{{Infobox software
| name                  = GIMP
| logo                  = [[File:The GIMP icon - gnome.svg|64px|Wilber, The GIMP mascot]]
| screenshot            = [[File:Gimpscreen.png|250px]]
| caption                = Screenshot of GIMP 2.6
| developer              = The GIMP Development Team
| released              = 1996
| latest preview version = 2.7.1
| latest preview date    = 2010-06-29
| latest release version = 2.6.10
| latest release date    = 2010-07-08
| programming language  = [[C (programming language)|C]] and [[GTK+]]
| operating system      = [[Linux]], [[Mac OS X]], [[Microsoft Windows]], [[FreeBSD]], [[Solaris (operating system)|Solaris]]
| language              = 52 languages in GIMP 2.6, 37 fully translated, others partly translated.[http://www.gimp.org/docs/ GIMP - Documentation][http://l10n.gnome.org/module/gimp/ GNOME GIMP translation statistics, see GIMP 2.6]
| status                = Active
| genre                  = [[Raster graphics editor]]
| license                = [[GNU General Public License]]
| website                = www.gimp.org
}}
</pre>
----


== Parameters ==
Currently there are five meta versions of nVidia Linux drivers each of which supports a specific group of GPUs. To check the type of driver that is related to your video card, check the link on this page of the official nVidia:
All parameters are optional.


; name: Name of the infobox. Usually, it is used to display the name software product but may be anything, as it used as an internal parameter for use with <code>frequently updated</code> parameter, and "Stable release" / "Preview release" fields. When modifying an article which already has an infobox, be careful not to edit this parameter when <code>frequently updated</code> parameter is set to ''yes''. In such cases, if you want to edit the title at the top of the infobox, use the <code>title</code> parameter instead.
[www.nvidia.com/object/IO_32667.html]
:'''ATTENTION:''' Please do not include a [[Help:Link#Wikilinks|wikilink]], [[hyperlink]] or image in this parameter. This parameter should be composed of pure text.


; title: Name of the software product as displayed above the infobox. When not specified, contents of ''name'' parameter will be displayed instead.
If you have identified as your driver version 337.25, for example, you need the mask(s) driver(s) latest(s) to which you want to install.
:'''Important note:''' Please do not include an image in this field. Wikipedia [[accessibility]] requirements mandates that this field should contain text that can be read by [[screen reader]]s.


; logo: Code for a small image to be displayed as software product's [[logo]] or [[computer icon]]. The contents of this field should look like:
<console>
::<tt>&#91;&#91;File:''File name.ext''{{!}}''Size''px&#93;&#93;</tt>
###i## echo “>x11-drivers/nvidia-drivers-340” >> /etc/portage/package.mask
:Replace ''Filename.ext'' with the name of your image and ''Size'' with width of your image in pixels. For more information regarding use of images and their syntax, please consult: [[Help:Contents/Images and media]].
</console>


; screenshot: Code for an image to be displayed as software product's [[screenshot]]. The contents of this field should look like:
==== The required kernel options ====
::<tt>&#91;&#91;File:''File name.ext''{{!}}''Size''px&#93;&#93;</tt>
:Replace ''Filename.ext'' with the name of your image and ''Size'' with width of your image in pixels. For more information regarding use of images and their syntax, please consult: [[Help:Contents/Images and media]].


; caption: A caption for screenshot that appears below it. Please include this parameter only when there is an image to display.
{{kernelop|desc=
[*] Enable loadable module support
}}


; collapsible: Whether this screenshot is by default hidden and is only shown when user clicks on a minuscule "Expand" button. Can be set to "yes". Especially useful in case of long vertical screenshot (see [[QQ]] for example)
{{kernelop|desc=
[*] MTRR (Memory Type Range Register) support
}}


; developer: Name of the current developer of the software product. It can be either an individual or an organization/business.
To we made a successful compilation of the legacy nVidia driver, we set before the removal of the native framebuffer drivers into the kernel in order to avoid conflicts for x86 and AMD64 processors, in this case.


; author: Name of the original author or publisher of the software product. It can be either an individual or an organization/business. Most of the times, it only needs to be specified when <code>developer</code> field is populated.
{{kernelop|desc=
Device Drivers >
  Graphics support >
    <*> Support for frame buffer devices >
      <> nVidia Framebuffer Support
      <> nVidia Riva support
}}
 
{{fancytip| An alternative is to [[uvesafb| uvesafb]] framebuffer, which can be installed in parallel with nvidia-drivers }}
 
==== Installation ====


; released: The date in which version 1.0 (or closely-matching release) of the software product in question reaches its [[Release to manufacturing]] (RTM) stage. In case the article is about a specific major release of a software product (for instance [[Internet Explorer 8]] or [[Microsoft Office 2007]]), this field should contain the date in which that specific major release reached RTM stage. In case the software product is still in development and has not reached its RTM stage, please ignore this field; do not use this field to specify the release date of the first preview/test release of the software product; there is already another parameter for that use.
Upgrade and/or configure VIDEO_CARDS variable "nvidia" in /etc/make.conf. This will serve to while you are installing the Server X, the correct version of nvidia-drivers to be provided for you.
:The content of this field should look like the following:
::''year''-''month''-''day''
:In case the article uses DMY as date format, use this code instead:
::''year''-''month''-''day''
:If you are unsure which date format to use, please consult [[WP:MOSDATES]].


; latest release version: The version number of the latest release of the software product. Please observe the following examples:
{{fancynote| Installing to the driver with the option in gtk use flags will make it installed the media-video/nvidia-settings which is a graphical tool for monitoring and various settings for your video card}}
: Example #1: If the article is about a product called ''Example Software'' whose latest version is 1.5, specify:
::v1.5
: Example #2: If the article is about a product called ''Example Software'' whose latest release is called ''Example Software 2008'' and whose latest version number is 12.2, specify:
::2008 (v12.2)
: Example #3: If the article is about ''Famous Example Software 2010'', which is a significant release of a product called ''Famous Example Software'' and whose latest version number is 14.0.0.25, just specify:
::v14.0.0.25
: Example #4: If the article is about ''Famous Example Software 2010'' for which no update is released since its initial release-to-manufacturing (RTM), please omit this parameter unless there is an evidence that it is necessary for the reader to know this number. One reason would be the presence of preview releases of the software product which can only be distinguished from the RTM by their version number.
:This parameter and <code>latest release date</code> complement each other but none strictly requires the other.


; latest release date: The release date of the latest released version. If no update is released for the software since its initial release, please omit this field; filling in the <code>released</code> field would be enough. The content of this field should look like the following:
==== Emerging the package ====
::''year''-''month''-''day''
:In case the article uses DMY as date format, use this code instead:
::''year''-''month''-''day''
:If you are unsure which date format to use, please consult [[WP:MOSDATES]].
:This parameter and <code>latest release version</code> complement each other but none strictly requires the presence of the other.


; discontinued: Whether this product is no longer being developed, thus changing the phrase "Latest release" in the infobox to "Discontinued". For technical reasons, anything for this parameter has the same effect, be it "yes", "no" or anything else. To nullify the effect of this parameter, you need to omit it.
<console>
###i## emerge x11-drivers/nvidia-drives
</console>


; latest preview version: The version number of the latest preview version or development branch. Should only be specified when development of a new version of the software product in question (newer than one specified in <code>latest release version</code>) is in progress. Please consult descriptions for <code>latest release version</code> provided above for best practices of specifying this parameter.
When the installation is complete run '''modprobe''' nvidia module to read kernel memory.


; latest preview date: Specifies the release date of the latest preview version or development branch. Should only be specified when development of a new version of the software product in question (newer than one specified in <code>latest release version</code>) is in progress. Please consult descriptions for <code>latest release date</code> provided above for best practices of specifying this parameter.
<console>
###i## lsmod | grep nvidia
</console>
If an update before remove the old module
<console>
###i## rmmod nvidia
###i## modprobe nvidia
</console>


; frequently updated: Specifies whether the infobox retrieves the software product's latest release version, latest release date, latest preview version and latest preview date from outside the article. Users visiting the article may click the numbers directly in the infobox to edit that external source. This mode is very useful for articles about software products whose vendors keep releasing updates or newer versions. With this mode is enabled, users can quickly and effectively edit the release data without affecting the articles.
==== Testing your Video Card ====
:For technical reasons, anything for this parameter has the same effect, be it "yes", "no", "true", "false" or anything else. To nullify the effect of this parameter, you need to omit this parameter or specify nothing for it. Note however, that if any of <code>latest release version</code>, <code>latest release date</code>, <code>latest preview version</code> or <code>latest preview date</code> parameters are specified, external source will be ignored.
:To make the infobox retrieve release data from outside the article:
#Delete <code>latest release version</code>, <code>latest release date</code>, <code>latest preview version</code> or <code>latest preview date</code> parameters from the infobox.
#Save the article.
#Create external source that supplies data for latest stable release. To do so:
##Copy and paste the following URL into your browser's address bar, replacing ''INFOBOX_NAME'' with the value supplied in <code>name</code> parameter of the infobox: <br/><span class="plainlinks"><code>{{fullurl:Template:Latest stable software release/INFOBOX_NAME|action=edit&preload=Template:LSR/syntax}}</code></span>
##In the page that opens, fill in the required information.
##Save the page.
#Create external source that supplies data for latest preview release. To do so:
##Copy and paste the following URL into your browser's address bar, replacing ''INFOBOX_NAME'' with the value suppplied in <code>name</code> parameter of the infobox: <br/><span class="plainlinks"><code>{{fullurl:Template:Latest preview software release/INFOBOX_NAME|action=edit&preload=Template:LPR/syntax}}</code></span>
##In the page that opens, fill in the required information.
##Save the page.
#Refresh the article.


; programming language: The [[programming language]] of that subject of the article. If the program language of the software product has a corresponding article in Wikipedia, please link to it. Here is an example:
To test your video card run the glxinfo program, which is part of the mesa-progs package. This will check if direct rendering is enabled.
::Code: <code><nowiki>[[C++]] and [[C Sharp (programming language)|C#]]</nowiki></code>
<console>
::Result: [[C++]] and [[C Sharp (programming language)|C#]]
$ ##i##glxinfo | grep direct
:When specifying the name of the programming language please make sure that you [[WP:V|cite your source]]. Unreferenced assertions in Wikipedia may be challenged or removed. If you have a source, do not include this parameter.
</console>


; operating system: The [[operating system]] on which the given software product works. Please be as accurate as possible in specifying this parameter (but also be mindful of the length) and avoid specifying vague phrases such as [[Cross-platform]] (or its redirect, [[Multi-platform]]). Please consider these examples:
== Configuring ==
:*If the software product works on all incarnations of [[Unix]], [[Linux]] and derived operating systems, please specify:
:**<code><nowiki>[[Unix-like]]</nowiki></code>
:*If the software works unconditionally on ALL incarnations of [[Microsoft Windows]], please specify:
:**<code><nowiki>[[Microsoft Windows]]</nowiki></code><br/>(Do not specify <code><nowiki>[[Microsoft Windows|Windows]]</nowiki></code>; always write the full name of a registered trademark when no length restriction is imposed upon you.)
:*If the software product works only on [[Windows XP]] and all subsequent releases of Microsoft Windows, please specify:
:**<code><nowiki>[[Windows XP]] and later</nowiki></code>
:*If the software product works only on [[Windows XP]] and all subsequent releases of consumers versions of Microsoft Windows, please specify:
:**<code><nowiki>[[Windows XP]], [[Windows Vista]] and [[Windows 7]]</nowiki></code><br/>(At the time of this writing, August 2010, Windows 7 was the latest consumers release of Microsoft Windows.)
:*If the software product is released for various families of different operating systems, (such as specific versions of BSD, Linux, Mac OS and Windows) so that listing them in the infobox gives it undue length, please leave the details to article body and specify:
:**<code><nowiki>[[BSD]], [[Linux]], [[Mac OS]] and [[Microsoft Windows|Windows]]</nowiki></code>
:*If the software is an operating system–independent [[web application]], ignore this parameter.


; platform: The [[computing platform]] under which the product runs. You might like to include the following information:
==== Loading at boot ====
:*'''Processor architecture:''' Some software products only run under a certain processor architecture. The most common architectures are [[IA-32]] (also known as ''x86'', ''i386'' and ''32-bit processor''), [[x86-64]] (also known as ''x64'', ''AMD64'', ''EM64T'' and ''64-bit'') and [[Itanium]]. Unfortunately, these information are very technical. Specially, a lot of people do not know that [[x86]] is not the same as [[IA-32]]. For that reason, please consider specifying the following phrases:
:**For software products that run on IA-32 processors, please specify: '''<code><nowiki>[[IA-32|Intel x86 - 32-bit]]</nowiki></code>''' or '''<code><nowiki>[[IA-32]]</nowiki></code>'''. Do ''not'' specify: <code><nowiki>[[x86]]</nowiki></code> or <code><nowiki>[[32-bit]]</nowiki></code>
:**For software products that run on x86-64 processors, please specify: '''<code><nowiki>[[x86-64|x64]]</nowiki></code>'''. Do ''not'' specify: <code><nowiki>[[64-bit]]</nowiki></code>, <code><nowiki>[[AMD64]]</nowiki></code> or <code><nowiki>[[EM64T]]</nowiki></code>
:*'''Software frameworks:''' Some software products run on [[Java platform]], [[.NET Framework]], [[Adobe Flash]], [[Adobe AIR]], [[Microsoft Silverlight]] or [[XUL]] without regard to the processor architecture. If so, you may ignore processor architecture and instead specify the framework.
:Please avoid specifying vague phrases such as [[Cross-platform]] unless the following conditions meet:
:#The software product has been released for numerous different platforms, so much so that including all of them causes the infobox size to grow unduly large.
:#The article body lists the platforms under which the product runs.
:If the above do not meet, then specifying such a vague phrase is the same as not specifying it.


; size: Size of the installer package. Only applies to software products that are available via download. For products distributed physically in boxes of packages, ignore this parameter. Do not forget to include your unit of measurements (i.e. Kilobytes, megabytes or gigabytes). Observe the following examples:
To automate the loading of the module when you boot your system, add '''nvidia''' in /etc/conf.d/modules.
:*<code><nowiki>760&#x26;nbsp&#x3B;[[Kilobyte|KB]]</nowiki></code> → 760&nbsp;[[Kilobyte|KB]]
:*<code><nowiki>32&#x26;nbsp&#x3B;[[Megabyte|MB]]</nowiki></code> → 32&nbsp;[[Megabyte|MB]]
:*<code><nowiki>1.5&#x26;nbsp&#x3B;[[Gigabyte|GB]]</nowiki></code> → 1.5&nbsp;[[Gigabyte|GB]]
:'''Note:''' "&#x26;nbsp&#x3B;" generates a non-breaking space. Words connected by this mark won't separate when "word wrapping" occurs.
:For more information, visit [[WP:UNITS]]


; language: Lists the Natural languages in which the software product user interface can interact with user. Please do not supply "Multilingual" or such vague phrases which do not add to the knowledge of the reader. When the list of languages is huge AND when those languages are listed in the article body, please specify number of the supported languages instead. Also please do not wikilink the name of languages: Readers are most likely unwilling to read about those languages.
==== Integration with X Server ====


; status: The development status of the computer program, such as: Planned, Active, Unmaintained, Discontinued, Stalled or [[Abandonware]]
When your X server is installed, the existing logo /etc/X11/xorg.conf you can run the nvidia-xconfig which will set in xorg.conf to identify the video card among other possible configurations.


; genre: Type of program.  Should be wikilinked to an article such as [[Geographic information system]]. For more information, consult [[List of software categories]]. Please do not use this field to briefly describe the role and function of the subject of the article. For example, instead of "SVG creator, editor and converter", consider using "[[Vector graphics editor]]". Instead of "PDF creator, editor, converter and viewer", consider using "[[Desktop publishing software]]". Instead of "DWG creator/editor", consider using "[[Computer-aided design]]".
{{file|name=/etc/X11/xorg.conf|body=
Section "Device"
    Identifier    "nvidia"
    Driver        "nvidia"
    VendorName    "NVIDIA Corporation"
    BoardName      "[Nome] [Modelo]"
EndSection
}}


; license: Type of the software license under which the consumer is allowed to use the product. You may specify it in two forms:
==== Enabling support nVidia ====
:*You may specify a type of well-known license. For example:
Include the use flag in '''nvidia''' /etc/portage/make.conf so due to applications that make use of this advantage may withdraw.
:**[[Proprietary software|Proprietary]] [[commercial software]] (<code><nowiki>[[Proprietary software|Proprietary]] [[commercial software]]</nowiki></code>): Software products which are licensed for use for a price. Most software today are published under this license type.
:**[[Freeware]]: Software products which are licensed for use (and sometimes redistribution) but free of charge.
:**[[Free software]]: Software products that can be used, studied, and modified without restriction, and which can be copied and redistributed in modified or unmodified form.
:*You may specify a well-known licensing scheme, such as:
:**[[GNU General Public License]]
:**[[GNU Lesser General Public License]]
:**[[BSD License]]
:Please avoid specifying phrases that makes no sense to the reader such as "Microsoft EULA", "Adobe End-User License Agreement" or "Symantec Terms of License", etc. (Always bear in mind that you are writing the article for those who do not know about the subject and come to the article to gain knowledge. You are not writing Wikipedia articles for your fellow co-editors who already know!)


;licence: Same as <code>license</code>. Pick either ''license'' (American English) or ''licence'' (Commonwealth English), not both - select the one which matches the content of the article the template is used in.
==== Enabling OpenGL / OpenCL ====
As a requirement, make sure that the Xorg server is not in use during this change. To enable OpenGL and OpenCL.


; website: Web site of software package. Please make sure that, whenever possible, the significant portion of the website address remains visible. For example, instead of "<code><nowiki>[http://www.example.com Example website]</nowiki></code>", specify "<code><nowiki>[http://www.example.com www.example.com]</nowiki></code>". You can also specify "<code><nowiki>http://www.example.com</nowiki></code>". The URL template will automatically generate compatible code.
<console>
###i## eselect opengl set nvidia
###i## eselect opencl set nvidia
</console>


{{delete}}
[[Category:Video Cards]]
[[Category:First Steps]]
{{EbuildFooter}}

Revision as of 03:32, September 30, 2014

NVIDIA Linux Display Drivers

   Tip

We welcome improvements to this page. To edit this page, Create a Funtoo account. Then log in and then click here to edit this page. See our editing guidelines to becoming a wiki-editing pro.

Introduction

NVidia have proprietary graphics drivers for Linux under binary blob. The alternative open source driver is nouveau.

Preparing to Install

Hardware compatibility and driver versions

Currently there are five meta versions of nVidia Linux drivers each of which supports a specific group of GPUs. To check the type of driver that is related to your video card, check the link on this page of the official nVidia:

[www.nvidia.com/object/IO_32667.html]

If you have identified as your driver version 337.25, for example, you need the mask(s) driver(s) latest(s) to which you want to install.

root # echo “>x11-drivers/nvidia-drivers-340” >> /etc/portage/package.mask

The required kernel options

[*] Enable loadable module support


[*] MTRR (Memory Type Range Register) support

To we made a successful compilation of the legacy nVidia driver, we set before the removal of the native framebuffer drivers into the kernel in order to avoid conflicts for x86 and AMD64 processors, in this case.


Device Drivers >
  Graphics support > 
    <*> Support for frame buffer devices >
      <> nVidia Framebuffer Support
      <> nVidia Riva support
   Tip
An alternative is to  uvesafb framebuffer, which can be installed in parallel with nvidia-drivers 

Installation

Upgrade and/or configure VIDEO_CARDS variable "nvidia" in /etc/make.conf. This will serve to while you are installing the Server X, the correct version of nvidia-drivers to be provided for you.

   Note
Installing to the driver with the option in gtk use flags will make it installed the media-video/nvidia-settings which is a graphical tool for monitoring and various settings for your video card

Emerging the package

root # emerge x11-drivers/nvidia-drives

When the installation is complete run modprobe nvidia module to read kernel memory.

root # lsmod | grep nvidia

If an update before remove the old module

root # rmmod nvidia
root # modprobe nvidia

Testing your Video Card

To test your video card run the glxinfo program, which is part of the mesa-progs package. This will check if direct rendering is enabled.

user $ glxinfo | grep direct

Configuring

Loading at boot

To automate the loading of the module when you boot your system, add nvidia in /etc/conf.d/modules.

Integration with X Server

When your X server is installed, the existing logo /etc/X11/xorg.conf you can run the nvidia-xconfig which will set in xorg.conf to identify the video card among other possible configurations.

   /etc/X11/xorg.conf
Section "Device"
    Identifier     "nvidia"
    Driver         "nvidia"
    VendorName     "NVIDIA Corporation"
    BoardName      "[Nome] [Modelo]"
EndSection

Enabling support nVidia

Include the use flag in nvidia /etc/portage/make.conf so due to applications that make use of this advantage may withdraw.

Enabling OpenGL / OpenCL

As a requirement, make sure that the Xorg server is not in use during this change. To enable OpenGL and OpenCL.

root # eselect opengl set nvidia
root # eselect opencl set nvidia