cchtml.com - User contributions [en]

Category:Distributions

2012-09-02T13:41:57Z

Spina: Reverted edits by 23.21.117.82 (talk) to last revision by Mooninite

The list of GNU/Linux flavors that are documented for the ATI Linux driver.

Although ATI can only actively support a small number of distributions, distribution vendors are encouraged to work with ATI to ensure that native packages can be created for their distribution. The current actively supported distributions are the Red Hat Enterprise Linux and Novell/SuSE suite of products.

Also note that the End User License Agreement explicitly provides for repackaging and redistribution of ATI's drivers. If your favourite distribution is not listed below, please work with them to contact ATI and either get support in the installer, or natively in the distribution.

Category:Distributions

2012-09-02T13:40:21Z

Spina: Undo revision 8977 by 23.21.117.82 (talk)

Забавно, тоже держу панель actions внизу прикрепленной, если что-то делаю в Flash IDE. Вообще, имхо, CS4 опять рассчитан только на аниматаров и дизайнеров. С редактором кода все обстоит по-прежнему ужасно. Причем, зачем-то добавили нормальный Project Panel видимо, раньше чем в CS6 нам нормального редактора кода не дождаться.Кстати, а под Маком Вы на чем пишете классы? TextMate? Flex Builder?

Slackware: ATI SlackBuild (ITA)

2012-01-22T16:34:00Z

Spina: Undo revision 7972 by 66.41.99.209 (talk)

= Introduzione =
Questo wiki spiega come installare i driver propritari ATI con la distribuzione linux Slackware, creando, grazie ad uno SlackBuild, dei pacchetti che possono essere installati tramite il comando '''installpkg'''.

Il wiki NON spiega come migliorare le prestazioni. In particolare fornisce solo una descrizione minimale di come impostare il server X.Org con l'unico scopo di far funzionare i driver proprietari (una descrizione su come configurare il server X.Org per ottenere prestazioni più elevate la potete trovare [http://www.slacky.eu/wikislack/index.php?title=Installazione_driver_ATI_su_Slackware_GNU/Linux qui]).

Tutti i comandi che iniziano con un '#>' devono essere eseguiti con i diritti dell'utente root, mentre quello che iniziano con '$>' possono essere eseguiti anche da un utente senza tali diritti.

= ATI Proprietary Driver e ATI Catalyst =
A partire dal 21 Novembre 2007 i driver ATI hanno cambiato nome e numero di versione. I nuovi driver, che prima venivano indicati solo come '''ATI Proprietary Driver''', ora si chiamano '''ATI Catalyst'''. Non solo, il numero di versione è passato da '''8.XX.X''' a '''7.XX'''.

Quando in questo articolo si parlerà dei driver ''versione < 8.37.6'', ci si riferirà implicitamente ai vecchi driver, ovvero agli ATI Proprietary Driver, i nuovi ATI Catalyst sono da considerarsi ''versione >= 8.37.6'', anche se, ad esempio, hanno come numero di release 7.11.

= Come ottenere tutto il software necessario =
L'installer può essere scaricato direttamente dal [http://support.amd.com/us/gpudownload/Pages/index.aspx sito ufficiale].
{{Warning|Attenzione|Se la versione dei driver che si è scaricata è minore della 8.37.6 allora dovete sapere fin d'ora che non funzioneranno con il server X.Org 7.2 (o 1.3) o successivi.}}
{{Helpful Hint|Nota|I driver per le architetture x86 e x86_64 sono equivalenti. L'installer infatti contiene i file per entrambe le architetture, sarà poi il processo di compilazione e creazione dei pacchetti che sceglierà i file adeguati.
Questo vuol dire che lo SlackBuild andrà bene sia per la Slackware sia la Slackware64, sia per le varie versioni porting a 64 bit (Slamd64, Bluewhite64, etc...).}}

Dato che i driver contengono anche un modulo del kernel che verrà compilato direttamente sul vostro sistema, è necessario avere anche i sorgenti del kernel attualmente in uso.

= Come creare i pacchetti per la Slackware =
== ATI Proprietary Driver o ATI Catalyst < 11.3 ==
Per questi driver lo SlackBuild produce due pacchetti (vedere [[#Cosa contengono i pacchetti creati?]]).
=== Versione dei driver < 8.37.6 (SlackBuild esterno) ===
Per questi tipi di driver ho creato uno '''SlackBuild esterno''' per la Slackware di cui ho fatto [http://www.slacky.eu/~spina/fglrx/ati-slack-packager-1.1.9-noarch-1.tgz questo pacchetto].

Per creare i pacchetti Slackware basta eseguire:
#> installpkg ati-slack-packager-1.1.9-noarch-1.tgz
#> sh ati-driver-installer-<versione>-x86.x86_64.run --buildpkg custom-package/Slackware

=== Versione dei driver >= 8.37.6 o nuovi ATI Catalyst (SlackBuild interno) ===
Per questi driver lo SlackBuild l'ho inviato direttamente alla ATI che ha provveduto ad inserirlo all'interno dell'installer, quindi basta eseguire:
#> sh ati-driver-installer-<versione>-x86.x86_64.run --buildpkg Slackware/All
o, se i driver sono abbastanza recenti, basta un semplice:
#> sh ati-driver-installer-<versione>-x86.x86_64.run --buildpkg
Oppure, per creare ed installare direttamente i pacchetti, si può usare (sempre con versioni recenti dei driver):
#> sh intaller.run --buildandinstallpkg

=== Cosa contengono i pacchetti creati? ===
I due pacchetti creati dallo SlackBuild, che chiameremo ''fglrx-module'' e ''fglrx-x'', contengono, rispettivamente, il modulo per il kernel attualmente installato sul sistema, e i driver per la versione del server X.Org installata. In questo modo, se si aggiorna il kernel oppure il server X.Org si può creare solo il relativo pacchetto.

==== Creare solo il pacchetto fglrx-module ====
Per creare solo il pacchetto contenente il modulo per il kernel attualmente installato, basta lanciare l'installer con l'opzione ''Only_Module ''.

Quindi, con lo '''SlackBuild esterno''':
#> sh ati-driver-installer-<versione>-x86.x86_64.run --buildpkg custom-package/Only_Module
Con lo '''SlackBuild interno''':
#> sh ati-driver-installer-<versione>-x86.x86_64.run --buildpkg Slackware/Only_Module

==== Creare solo il pacchetto fglrx-x ====
Per creare solo il pacchetto contenente i driver per il server X.Org attualmente installato sul sistema, basta lanciare l'installer con l'opzione ''Only_X''.

Con lo '''SlackBuild esterno''':
#> sh ati-driver-installer-<versione>-x86.x86_64.run --buildpkg custom-package/Only_X
Con lo '''SlackBuild interno''':
#> sh ati-driver-installer-<versione>-x86.x86_64.run --buildpkg Slackware/Only_X

== ATI Catalyst >= 11.3 ==
A partire da questi driver lo '''SlackBuild interno''' produce un solo pacchetto, chiamato ''fglrx-<versione>-<architettura>-<release>.tgz'', che può essere creato con:
#> sh ati-driver-installer-<versione>-x86.x86_64.run --buildpkg
Si può anche creare ed installare direttamente il pacchetto con:
#> sh ati-driver-installer-<versione>-x86.x86_64.run --buildandinstallpkg

= Configurazione minimale del server X.Org =
Una volta installati i due pacchetti bisogna segnalare al server X.Org di usare i driver proprietari ATI, per fare questo bisogna controllare che il file xorg.conf, che generalmente è situato nella directory /etc/X11/, contenga le seguenti voci:

Section "Module"
....
Load "dri"
Load "glx"
....
EndSection

Section "Device"
....
Driver "fglrx"
....
EndSection

Section "DRI"
Group 0
Mode 0666
EndSection

{{Useful Information|Nota|Il comando:
#> aticonfig --initial
può essere di aiuto. Eseguire '''aticonfig''' senza opzioni per maggiori informazioni}}

= Verifica =
Per verificare se i driver proprietari ATI sono stati correttamente installati si può eseguire il comando:
$> fglrxinfo
Sulla mia macchina l'output è:
display: :0.0 screen: 0
OpenGL vendor string: ATI Technologies Inc.
OpenGL renderer string: ATI Mobility Radeon X1400
OpenGL version string: 2.0.6650 (8.39.4)

= Rimuovere i pacchetti installati =
== ATI Proprietary Driver o ATI Catalyst < 11.3 ==
Per rimuovere i pacchetti installati si può tranquillamente usare l'utility '''removepkg'''. Ci sono però aspetti che vanno considerati:
* La rimozione dei pacchetti non elimina i file di configurazione del driver fglrx, questi file sono situati nella directory ''/etc/ati''
{{Be Careful|Occhio|La directory ''/etc/ati/custom-package'' se esiste, contiene lo '''SlackBuild esterno''' e quindi non va cancellata.}}
*Il pacchetto ''fglrx-x'' contiene le librerie OpenGL della ATI, e queste librerie sono posizionate nella stessa directory di quelle Mesa, indi per cui quando si installa il pacchetto ''fglrx-x'' vengono sovrascritte le OpenGL Mesa. Per ripristinare la situazione si deve semplicemente reinstallare il pacchetto contenente queste librerie, ovvero il pacchetto:
::x11
:si usa la Slackware 11, oppure:
::mesa
:se si usa la Slackware 12.

== ATI Catalyst >= 11.3 ==
Durante l'installazione del pacchetto ''fglrx-<versione>-<architettura>-<release>.tgz'' alcune librerie che sarebbero sovrascritte vengono rinominate in FGL.renamed.nome_libreria. Per disinstallare il pacchetto in maniera "pulita" si dovrebbe eseguire il comando:
#> aticonfig --uninstall
oppure direttamente lo script:
#> /usr/share/ati/amd-uninstall.sh
o, ancora, con un qualsiasi installer >= 11.3, con:
#> ati-driver-installer-<versione>-x86.x86_64.run --uninstall
Dopo di ciò rimarrà solo la directory ''/etc/ati'' con i file di configurazione dei driver.

= Patchare i driver =
I driver ATI sono noti per essere sempre in ritardo rispetto all'aggiornamento del kernel linux. Spesso occorre quindi patchare i driver in modo tale che la creazione del modulo per il kernel abbia successo. A partire dagli ATI Catalist > 8.11 ho inserito nello '''SlackBuild interno''' la possibilità di patchare i driver ATI prima che lo SlackBuild stesso esegua la compilazione del modulo per il kernel.

Per fare questo basta creare (o scaricare da internet) una patch e dargli questo path:

''/etc/ati/patch/patch-ATI_DRIVER_VERSION-KERNEL_VERSION''

dove:

ATI_DRIVER_VERSION deve essere uguale al risultato del comando:
$> sh ati-driver-installer-<versione>-x86.x86_64.run -i | head -n1 | cut -d'-' -f2
KERNEL_VERSION deve essere uguale al risultato del comando:
$> uname -r

se la directory ''/et/ati/patch'' non esiste, va ovviamente creata.

Quindi, ad esempio, se si il primo dei due comandi da come risultato '''8.56''' e il secondo '''2.6.27.6''', la patch va chiamata: ''/etc/ati/patch/patch-8.56-2.6.27.6''.

Lo '''SlackBuild interno''' automaticamente noterà la patch, e, se si è in possesso del programma '''patch''', eseguirà:
#> patch -p0 < /etc/ati/patch/patch-8.56-2.6.27.6

== Alcune patch ==
Di seguito alcune patch note e come usarle:

=== ATI Catalyst 10.3, 10.4 e kernel == 2.6.33.x ===
Scaricate la [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.3-4_with_2.6.33.x.diff patch] nella directory ''/tmp'', quindi:

* Per i '''Catalyst 10.3''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.3-4_with_2.6.33.x.diff /etc/ati/patch/patch-8.712-$(uname -r)
#> sh ati-driver-installer-10-3-x86.x86_64.run --buildpkg

* Per i '''Catalyst 10.4''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.3-4_with_2.6.33.x.diff /etc/ati/patch/patch-8.723-$(uname -r)
#> sh ati-driver-installer-10-4-x86.x86_64.run --buildpkg

=== ATI Catalyst 10.4, 10.5 e kernel == 2.6.34 ===
Scaricate la [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.4-5_with_2.6.34.diff patch] nella directory ''/tmp'', quindi:

* Per i '''Catalyst 10.4''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.4-5_with_2.6.34.diff /etc/ati/patch/patch-8.723-$(uname -r)
#> sh ati-driver-installer-10-4-x86.x86_64.run --buildpkg

* Per i '''Catalyst 10.5''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.4-5_with_2.6.34.diff /etc/ati/patch/patch-8.732-$(uname -r)
#> sh ati-driver-installer-10-4-x86.x86_64.run --buildpkg

=== ATI Catalyst 10.9 e Slackware64 13.1 o current ===
Scaricate la [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.9_with_Slackware64-13.1.diff patch] nella directory ''/tmp'', quindi fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.9_with_Slackware64-13.1.diff /etc/ati/patch/patch-8.771-$(uname -r)
#> sh ati-driver-installer-10-9-x86.x86_64.run --buildpkg
ad un certo punto l'installazione chiede:
<PRE>
can't find file to patch at input line 4
Perhaps you should have used the -p or --strip option?
The text leading up to this was:
--------------------------
|diff -ru ./2.6.x/Makefile ../../../../../../fglrx-install.uZLF8t/common/lib/modules/fglrx/build_mod//2.6.x/Makefile
|--- ./2.6.x/Makefile 2010-09-01 16:05:31.000000000 +0200
|+++ ../../../../../../fglrx-install.uZLF8t/common/lib/modules/fglrx/build_mod//2.6.x/Makefile 2010-09-23 08:47:24.000000000 +0200
--------------------------
File to patch:
</PRE>
quindi inserire:
./2.6.x/Makefile

=== ATI Catalyst 10.10, 10.11 e kernel == 2.6.36.x ===
Scaricate la [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.10-11_with_2.6.36.x.diff patch] nella directory ''/tmp'', quindi:
* Per i '''Catalyst 10.10''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-11_with_2.6.36.x.diff /etc/ati/patch/patch-8.783-$(uname -r)
#> sh ati-driver-installer-10-10-x86.x86_64.run --buildpkg

* Per i '''Catalyst 10.11''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-11_with_2.6.36.x.diff /etc/ati/patch/patch-8.791-$(uname -r)
#> sh ati-driver-installer-10-11-x86.x86_64.run --buildpkg

=== ATI Catalyst 10.10, 10.11 e 10.12 e kernel == 2.6.37.x ===
Scaricate la [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.10-12_with_2.6.37.x.diff patch] nella directory ''/tmp'', quindi:
* Per i '''Catalyst 10.10''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-12_with_2.6.37.x.diff /etc/ati/patch/patch-8.783-$(uname -r)
#> sh ati-driver-installer-10-10-x86.x86_64.run --buildpkg

* Per i '''Catalyst 10.11''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-12_with_2.6.37.x.diff /etc/ati/patch/patch-8.791-$(uname -r)
#> sh ati-driver-installer-10-11-x86.x86_64.run --buildpkg

* Per i '''Catalyst 10.12''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-12_with_2.6.37.x.diff /etc/ati/patch/patch-8.801-$(uname -r)
#> sh ati-driver-installer-10-12-x86.x86_64.run --buildpkg

= Problemi noti =
== error: implicit declaration of function 'lock_kernel' and error: implicit declaration of function 'unlock_kernel' ==
Dovete abilitare l'opzione '''Big Kernel Lock''' nella vostra configurazione del kernel. La voce si trova nel menù '''Kernel hacking'''. Per controllare se questa opzione è abilitata potete fare:
$> zcat /proc/config.gz | grep BKL
CONFIG_BKL=y

== FATAL: modpost: GPL-incompatible module fglrx.ko uses GPL-only symbol 'paravirt_ops' ==
L'errore accade in fase di compilazione del modulo ed è dovuto al fatto che il kernel è stato compilato con l'opzione di paravirtualizzazione attiva. Questa opzione tra le altre cose, impedisce di caricare, e quindi di compilare, moduli che non hanno la licenza GPL. Visto che i driver ATI non hanno questo tipo di licenza, non vengono compilati.

Per ovviare al problema si può:
=== Disabilitare la paravirtualizzazione nel kernel ===
L'opzione di paravirtualizzazione si chiama '''CONFIG_PARAVIRT''' e generalmente si trova nel sottomenù '''Processor type and features''' del kernel.
=== Patchare i driver ATI ===
Questa operazione è illegale poichè si deve modificare il tipo di licenza rilasciata dalla ATI in GPL. Ho scritto la patch:

[http://www.slacky.eu/~spina/fglrx/patch/ati_to_gpl.patch ati_to_gpl.patch] (md5sum: 4207f41a71035dc2eed3ea9346b881bb)

di cui non mi prendo nessuna responsabilità, io non la uso e ne sconsiglio l'uso preferendo l'alternativa di disabilitare la paravirtualizzazione del kernel.
Per usare questa patch bisogna:

'''SlackBuild esterno''':
* Copiare la patch nella directory ''/etc/ati/custom-package/patch''

'''SlackBuild interno''' (solo con ATI Catalist > 8.11):
* Copiare la patch nella directory ''/etc/ati/patch'' (se non esiste, va creata)

Lo SlackBuild noterà la presenza della patch e la applicherà. Per disinstallare la patch basterà quindi cancellarla.

== Using GLX_SGIX_pbuffer FGLTexMgr: open of shared memory object failed (Permission denied) __FGLTexMgrCreateObject: __FGLTexMgrSHMmalloc failed!!! ==
Questo problema è dovuto alla mancanza nel sistema del filesystem SHM (oggi chiamato tmpfs), ovvero il virtual memory filesystem. Per ovviare al problema si deve:
* Aggiungere al file ''/etc/fstab'' la seguente riga:
shm /dev/shm tmpfs defaults 0 0
* Quindi montare il filesystem tramite:
#> mount /dev/shm
Ovviamente il kernel deve essero predisposto al "montaggio" di questo filesystem, in particolare l'opzione del kernel che deve essere abilitata è '''CONFIG_TMPFS''' che generalmente è sistuata nel sottomenù del kernel '''File systems --> Pseudo filesystems'''. C'è da dire però che tutti i kernel precompilati hanno generalmente questa opzione abilitata.

== kernel includes at /lib/modules/`uname -r`/build/include do not match current kernel ==
L'errore completo è qualcosa del genere:

Error:
kernel includes at /lib/modules/`uname -r`/build/include do not match current kernel.
they are versioned as ""
instead of "`uname -r`".
you might need to adjust your symlinks:
- /usr/include
- /usr/src/linux

L'errore, se pur spiegato può non essere chiaro. In pratica deriva dal fatto che i link simbolici:
/lib/modules/`uname -r`/source
/lib/modules/`uname -r`/build
non puntano alla directory in cui sono inseriti i sorgenti del kernel attuale (che generalmente è /usr/src/linux-`uname -r`). Accade a coloro che usano uno dei kernel contenuto nella Slackware, per cui cercherò di spiegarlo in termini di "pacchetti" Slackware. Questo può succedere:
* O perchè i sorgenti del kernel effettivamente non sono stati installati. In questo caso dovrebbe bastare installare il pacchetto dei sorgenti che si trova nella directory k/ della Slackware. Non è detto però che il problema venga risolto, si veda il secondo motivo per cui sussiste l'errore.
* O perchè i sorgenti (se pur installati) non rispecchiano le impostazioni dell'attuale kernel. La nuova Slackware 12 ha al suo interno un pò di kernel precompilati (che vuol dire impostazioni differenti) mentre un solo pacchetto per i sorgenti (a meno di vedere nel ramo extra/). In particolare i sorgenti sono per un kernel SMP e quindi se si utilizza un kernel precompilato non SMP può accadere che si verifichi l'errore suddetto. Per ovviare basta fare quanto segue, dopo essersi assicurati che il pacchetto dei sorgenti è stato installato:
#> cd /usr/src/linux
#> cp /boot/config .config
#> make
:eseguendo il make, oltre a compilare il kernel e relativi moduli (che poi non useremo), si rigenerano alcuni file headers che rispecchiano la configurazione del kernel (per come impostata nel file .config).

<<edit by 414N>>: Questo problema può presentarsi anche in caso di kernel ricompilati manualmente ai quali si è aggiunta una qualche tag in fase di configurazione.
Per risolvere è sufficiente un make prepare nella directory dei sorgenti del kernel in uso, in modo da avere gli header necessari allo script (make andrebbe a compilare tutto il kernel).

== Logo nei driver 8.39.4 ==
Questo "bug" nei driver 8.39.4 deriva dal fatto che gli sviluppatori ATI non aggiornano i packager mantainer prima della release ufficiale. Sarebbe carino se facessero testare prima a noi le release ufficiali, in modo da certificare il corretto funzionamento degli script per creare i pacchetti. Per risolvere il problema si deve usare lo '''SlackBuild esterno''' come descritto [[#Versione dei driver < 8.37.6 (SlackBuild esterno) | qui]].

== amdcccle non parte con la Slackware 12 ==
Molti utenti che utilizzano la versione del server X.Org 7.2 (o 1.3) non riescono a lanciare correttamente il Catalyst. Il comando per eseguire il Catalyst è:
#> amdcccle
Per questo problema sembra non esserci ancora soluzione, ma stiamo lavorando per risolverlo.

= Link utili =
Il thread di discussione da cui è stato tratto questo articolo:
http://www.slacky.eu/forum/viewtopic.php?t=18134&highlight=

Un alternativa ai driver ufficiali ATI:
http://www.x.org/wiki/radeon

Una guida su come installare e configurare i driver (open source e proprietary) ATI:
http://www.slacky.eu/wikislack/index.php?title=Installazione_driver_ATI_su_Slackware_GNU/Linux

= Ringraziamenti =
Ringrazio Ezio Ghibaudo e Federico Rota per aver iniziato questo wiki e per l'aiuto che mi hanno dato con lo SlackBuild. Vorrei anche ringraziare tutti gli utenti della community [http://www.slacky.eu Slacky] per i feedback e consigli.

[[User:Spina|Spina]]

Slackware: ATI SlackBuild (ITA)

2012-01-22T16:03:24Z

Spina: Undo revision 7968 by 200.176.13.217 (talk)

Slackware SlackBuild esterno (ITA)

2012-01-22T12:44:46Z

Spina: Ripristinata

#REDIRECT [[Slackware: SlackBuild esterno (ITA)]]

Slackware: ATI SlackBuild (ENG)

2012-01-22T12:31:33Z

Spina: Ripristinata la versione modificata da me in maniera anonima

= Introduction =
This wiki explains how to install the proprietary ATI drivers in a Slackware Linux distribution, creating, thanks to a SlackBuild, packages that can be installed through the '''installpkg''' command.

This wiki DOES NOT explain how to improve performance. In particular, It provides only a minimal description of how to set up the X.Org server with the only purpose of loading the proprietary drivers (a description on how to configure the X.Org server to increase performance can be found, in italian, [http://www.slacky.eu/wikislack/index.php?title=Installazione_driver_ATI_su_Slackware_GNU/Linux here]).

All commands starting with a '#>' must be executed with root rights, while commands beginning with '$>' can be performed by a user without such rights.

= Proprietary ATI Drivers and ATI Catalyst =
Since 21 November 2007, ATI drivers have changed the name and the number version. The new drivers, which were first mentioned only as Proprietary ATI Driver, are now called ATI Catalyst. Moreover, the version number has passed from 8.XX.X to 7.XX.

When in this wiki we will talk about drivers version <8.37.6, we will refer implicitly to the old driver, such as Proprietary ATI Driver, while the new ATI Catalyst have a number version >= 8.37.6, even if, for instance, have a release number 7.11.

= Getting all the necessary =
The installer can be downloaded from the [http://ati.amd.com/support/driver.html official web site] directly.
{{Warning|Warning|If the downloaded driver version is less than 8.37.6, then you need to know from now that it will not work onto X.Org 7.2 server (or 1.3) or later.}}
{{Helpful Hint|Note|Drivers for x86 and x86_64 architectures are equivalent. The installer contains files for both architectures, then It will be the compilation process and the package creation process to choose the appropriate files.
This means that the SlackBuild will be good for Slackware, Slackware64 and for Slackware 64-bit portings (Slamd64, Bluewhite64, etc. ...).}}

Since drivers also contain a kernel module which will be compiled directly on your system, you'll need the kernel source in use.

= How to create Slackware packages =
== ATI Proprietary drivers or ATI Catalyst < 11.3 ==
For these drivers will be produced two packages (see [[#What do created packages contain?]]).
=== Drivers version < 8.37.6 (external SlackBuild) ===
For these types of drivers I've created an '''external SlackBuild''' for Slackware and I made [http://www.slacky.eu/~spina/fglrx/ati-slack-packager-1.1.9-noarch-1.tgz this package].

To create Slackware packages simply run:
#> installpkg ati-slack-packager-1.1.9-noarch-1.tgz
#> sh ati-driver-installer-<version>-x86.x86_64.run -- buildpkg custom-package/Slackware

=== Drivers version >= 8.37.6 or new ATI Catalyst (internal SlackBuild) ===
For these drivers I've sent the SlackBuild directly to ATI which inserted it into the installer, then simply run:
#> sh ati-driver-installer-<version>-x86.x86_64.run --buildpkg Slackware/All
or, if drivers are quite recent, it suffices:
#> sh ati-driver-installer-<version>-x86.x86_64.run --buildpkg
Otherwise, in order to create and install directly the packages you can use (always with recent versions of the driver):
#> sh ati-driver-installer-<version>-x86.x86_64.run --buildandinstallpkg

此处的意思是：如果是新装的系统，直接运行本处的最后一个命令即可同时完成创建包和安装包的过程。

=== What do created packages contain? ===
The two packages created by SlackBuild, that we'll call ''fglrx-module'' and ''fglrx-x'' contain, respectively, the kernel module and the X.Org server driver currently installed in the system. In this way, if you upgrade the kernel or the X.Org server, you can create only one package.

==== Creating only fglrx-module package ====
To create just the package containing the kernel module for the currently installed kernel, simply run the installer with the ''Only_Module'' option.

So with '''external SlackBuild''':
#> sh ati-driver-installer-<version>-x86.x86_64.run --buildpkg custom-package/Only_Module
With '''internal SlackBuild''':
#> sh ati-driver-installer-<version>-x86.x86_64.run --buildpkg Slackware/Only_Module

==== Creating only fglrx-x package ====
To create just the package containing the X.Org driver currently installed in your system, simply run installer with ''Only_X'' option.

With '''external SlackBuild''':
#> sh ati-driver-installer-<version>-x86.x86_64.run --buildpkg custom-package/Only_X
With '''internal SlackBuild''':
#> sh ati-driver-installer-<version>-x86.x86_64.run --buildpkg Slackware/Only_X

（如果进行了上一小节的 --buildandinstallpkg则本小节的命令可不必再执行）

接下来，执行

#> sh ati-driver-installer-<version>-x86.x86_64.run

即可进入ATI配置的界面，完成显卡的简单配置。

== ATI Catalyst >= 11.3 ==
Since these drivers the '''internal SlackBuild''' make only one package, named ''fglrx-<version>-<architecture>-<release>.tgz'', that you can create with:
#> sh ati-driver-installer-<version>-x86.x86_64.run --buildpkg
You can also make and install the package directly with:
#> sh ati-driver-installer-<versione>-x86.x86_64.run --buildandinstallpkg

= Minimal X.Org server configuration =
Once installed the two indicated packages, you must tell to the X.Org server to use ATI proprietary drivers, to do this we must check if the xorg.conf file, which is usually located in the ''/etc/X11/'' directory, contains the following items:

Section "Module"
...
Load "dri"
Load "glx"
...
EndSection

Section "Device"
...
Driver "fglrx"
...
EndSection

Section "DRI"
Group 0
Mode 0666
EndSection

{{Useful Information|Note|The command:
#> aticonfig --initial
can help you. Do '''aticonfig''' without options for more infos.}}

= Installation checking =
To see if proprietary ATI drivers are properly installed run the command:
$> fglrxinfo
On my computer the output is:
display::0.0 screen: 0
OpenGL vendor string: ATI Technologies Inc.
OpenGL renderer string: ATI Mobility Radeon X1400
OpenGL version string: 2.0.6650 (8.39.4)

= Remove installed packages =
== ATI Proprietary drivers or ATI Catalyst < 11.3 ==
To remove installed packages you can use the '''removepkg''' utility. However, there are aspects that should be considered:
* The packages' removing don't delete fglrx's driver configuration files, these files are located in ''/etc/ati'' directory
{{Be Careful|Be Careful|The /etc/ati/custom-package directory, if exists, contains the '''external SlackBuild''' and therefore should not be deleted.}}
* The fglrx-x package contains ATI's OpenGL libraries, and these libraries are located in the same directory of the Mesa libraries, so when you install the fglrx-x package Mesa OpenGL libraries are overridden. To restore the situation you should simply reinstall the package containing these libraries, like:
::x11
:for Slackware 11, or:
::mesa
:for Slackware 12.

== ATI Catalyst >= 11.3 ==
During installation of the package ''fglrx-<version>-<architecture>-<release>.tgz'' some libraries that would be overwritten are renamed as FGL.renamed.library_name. Due to remove this package “cleanly” you should do:
#> aticonfig --uninstall
or, directly with the script:
#> /usr/share/ati/amd-uninstall.sh
or, also with any installer >= 11.3, with:
#> ati-driver-installer-<versione>-x86.x86_64.run --uninstall
Will remain only the directory ''/etc/ati'' with the configuration files.

= Patching the drivers =
Ati drivers are usually not compatible with brand new version of kernel linux. You often need to patch the driver so that you can create the kernel module successfully. Since Ati Catalyst > 8.11 you can patch Ati drivers within the '''internal SlackBuild''' before that same SlackBuild compiles the kernel module.

In order to do that, you just have to create (or download from the Internet) a patch and rename it like this:

''/etc/ati/patch/patch-ATI_DRIVER_VERSION-KERNEL_VERSION''

where:

ATI_DRIVER_VERSION must be equal to the output of:
$> sh ati-driver-installer-<version>-x86.x86_64.run -i | head -n1 | cut -d'-' -f2
KERNEL_VERSION must be equal to the output of:
$> uname -r

If ''/etc/ati/patch'' doesn't exist, it must be made.

For example, if the former command outputs "8.55" and the latter "2.6.27.6", you need to name the patch ''/etc/ati/patch/patch-8.56-2.6.27.6''.

The '''internal SlackBuild''' will find the patch automatically and, if the command '''patch''' is installed, it will run:
#> patch -p0 < /etc/ati/patch/patch-8.56-2.6.27.6

== Patches ==
Here some patches and how to use there:

=== ATI Catalyst 10.3, 10.4 and kernel == 2.6.33.x ===
Download the [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.3-4_with_2.6.33.x.diff patch] into ''/tmp'', so:

* For '''Catalyst 10.3''' do:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.3-4_with_2.6.33.x.diff /etc/ati/patch/patch-8.712-$(uname -r)
#> sh ati-driver-installer-10-3-x86.x86_64.run --buildpkg

* For '''Catalyst 10.4''' do:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.3-4_with_2.6.33.x.diff /etc/ati/patch/patch-8.723-$(uname -r)
#> sh ati-driver-installer-10-4-x86.x86_64.run --buildpkg

=== ATI Catalyst 10.4, 10.5 and kernel == 2.6.34 ===
Download the [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.4-5_with_2.6.34.diff patch] into ''/tmp'', so:

* For '''Catalyst 10.4''' do:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.4-5_with_2.6.34.diff /etc/ati/patch/patch-8.723-$(uname -r)
#> sh ati-driver-installer-10-4-x86.x86_64.run --buildpkg

* For '''Catalyst 10.5''' do:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.4-5_with_2.6.34.diff /etc/ati/patch/patch-8.732-$(uname -r)
#> sh ati-driver-installer-10-4-x86.x86_64.run --buildpkg

=== ATI Catalyst 10.9 and Slackware64 13.1 or current ===
Download the [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.9_with_Slackware64-13.1.diff patch] into ''/tmp'', so to do:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.9_with_Slackware64-13.1.diff /etc/ati/patch/patch-8.771-$(uname -r)
#> sh ati-driver-installer-10-9-x86.x86_64.run --buildpkg
at one point the installer asks:
<PRE>
can't find file to patch at input line 4
Perhaps you should have used the -p or --strip option?
The text leading up to this was:
--------------------------
|diff -ru ./2.6.x/Makefile ../../../../../../fglrx-install.uZLF8t/common/lib/modules/fglrx/build_mod//2.6.x/Makefile
|--- ./2.6.x/Makefile 2010-09-01 16:05:31.000000000 +0200
|+++ ../../../../../../fglrx-install.uZLF8t/common/lib/modules/fglrx/build_mod//2.6.x/Makefile 2010-09-23 08:47:24.000000000 +0200
--------------------------
File to patch:
</PRE>
insert:
./2.6.x/Makefile

=== ATI Catalyst 10.10, 10.11 and kernel == 2.6.36.x ===
Download the [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.10-11_with_2.6.36.x.diff patch] into ''/tmp'', so:

* For '''Catalyst 10.10''' do:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-11_with_2.6.36.x.diff /etc/ati/patch/patch-8.783-$(uname -r)
#> sh ati-driver-installer-10-10-x86.x86_64.run --buildpkg

* For '''Catalyst 10.11''' do:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-11_with_2.6.36.x.diff /etc/ati/patch/patch-8.791-$(uname -r)
#> sh ati-driver-installer-10-11-x86.x86_64.run --buildpkg

=== ATI Catalyst 10.10, 10.11 e 10.12 e kernel == 2.6.37.x ===
Download the [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.10-12_with_2.6.37.x.diff patch] into ''/tmp'', so:
* For '''Catalyst 10.10''' do:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-12_with_2.6.37.x.diff /etc/ati/patch/patch-8.783-$(uname -r)
#> sh ati-driver-installer-10-10-x86.x86_64.run --buildpkg

* For '''Catalyst 10.11''' do:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-12_with_2.6.37.x.diff /etc/ati/patch/patch-8.791-$(uname -r)
#> sh ati-driver-installer-10-11-x86.x86_64.run --buildpkg

* For '''Catalyst 10.12''' do:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-12_with_2.6.37.x.diff /etc/ati/patch/patch-8.801-$(uname -r)
#> sh ati-driver-installer-10-12-x86.x86_64.run --buildpkg

= Known problems =
== error: implicit declaration of function 'lock_kernel' and error: implicit declaration of function 'unlock_kernel' ==
You need to enable the '''Big Kernel Lock''' in your kernel configuration. You find it under the '''Kernel hacking''' menu. You can check if this option is enable with:
$> zcat /proc/config.gz | grep BKL
CONFIG_BKL=y

== FATAL: modpost: GPL-incompatible module fglrx.ko uses GPL-only symbol 'paravirt_ops' ==
The error occurs during module compilation and It's due to the fact that the kernel was compiled with the option of paravirtualization active. This option among other things, prevents to load, and then to compile, modules that do not have the GPL license. Since that ATI drivers don't have this type of license, they aren't compiled.

To work around this problem you can:
==== Disable kernel paravirtualization option ====
The paravirtualization option is called '''CONFIG_PARAVIRT''' and generally is in the '''Processor type and features''' kernel submenu.
==== Patch ATI drivers ====
This operation is illegal because It changes the type of license issued by ATI in a GPL license. I wrote the patch:

[http://www.slacky.eu/~spina/fglrx/patch/ati_to_gpl.patch ati_to_gpl.patch] (md5sum: 4207f41a71035dc2eed3ea9346b881bb)

but I do not take any responsibility, I do not use It and I discourage the use in order to prefer the alternative to disable the paravirtualization kernel option. To use this patch You need to:

'''External SlackBuild'''
* Copy the patch in the ''/etc/ati/custom-package/patch'' directory

'''Internal SlackBuild''' (only with Ati Catalyst > 8.11):
* Copy the patch in the ''/etc/ati/patch'' directory (if it doesn't exist you must create it)

The SlackBuild will find and apply the patch automatically. In order to uninstall it you simply need to delete it. In order to uninstall the patch simply delete It from ''/etc/ati/custom-package/patch'' directory.

== Using GLX_SGIX_pbuffer FGLTexMgr: open of shared memory object failed (Permission denied) __FGLTexMgrCreateObject: __FGLTexMgrSHMmalloc failed!!! ==
This problem is due to the lack of SHM filesystem (now called tmpfs), that is virtual memory filesystem. To work around this problem you must:
* Add into ''/etc/fstab'' file the following line:
shm /dev/shm tmpfs defaults 0 0
* Then mount the filesystem through:
#> mount /dev/shm
Obviously the kernel must be predisposed for the "mounting" of this filesystem, in particular the kernel option that must be enabled is '''CONFIG_TMPFS''' that is generally placed in '''File system --> Pseudo filesystems''' submenu. However all the compiled kernel generally have this option enabled.

== kernel includes at /lib/modules/`uname -r`/build/include do not match current kernel ==
The complete mistake is something like this:

Error:
kernel includes at /lib/modules/`uname -r`/build/include do not match current kernel.
they are versioned as ""
instead of "`uname -r`".
you might need to adjust your symlinks:
- /usr/include
- /usr/src/linux

The error, also if explained, could be not clear. In practice It results from the fact that the symbolic link:
/lib/modules/`uname -r`/source
/lib/modules/`uname -r`/build
don't point to the directory where are inserted the current kernel sources (which is generally ''/usr/src/linux- 'uname-r'''). It happens to those who use a kernel contained in Slackware, so I will try to explain It in terms of Slackware "packages". This can happen:
* because the kernel source were not installed. In this case should be enough to install the source package which can be found in Slackware k/ directory. However, It is not granted that the problem will be solved, You'll need to see the second reason why there is an error.
* because sources (also if installed) do not reflect the settings of the current kernel. The new Slackware 12 has some precompiled kernels (which means different settings), while just a single package for the sources (unless seeing the branch extra/). In particular, the sources are for the SMP kernel and so if you use a non-SMP kernel can appear this error. To avoid this, after making sure that the package source has been installed, do simply the following:
#> cd /usr/src/linux
#> cp /boot/config .config
#> make
:running make, in addition to compiling the kernel modules (which we will not use), some header files are regenerated, and they will reflect the kernel configuration (as it's set in the .config file).

== Driver 8.39.4 logo ==
This "bug" in 8.39.4 drivers results from the fact that ATI developers don't update the packager maintainers before the official releases. It should be nice first if they did test us official releases in order to certify the proper functioning of the scripts for creating packages. To solve the problem it's necessary to use the '''external SlackBuild''' as described here.

== amdcccle don't start on Slackware 12 ==
Many users of the X.Org 7.2 (or 1.3) server version fail to start properly the Catalyst. The command to run the Catalyst is:
#> amdcccle
For this problem it seems there is no solution yet, but we are working on to solve it.

= Useful links =
The discussion thread from which it was derived this article:
http://www.slacky.eu/forum/viewtopic.php?t=18134&highlight=

An alternative to official ATI drivers:
http://www.x.org/wiki/radeon

A wiki in italian about installing and configuring ATI drivers (open source and proprietary):
http://www.slacky.eu/wikislack/index.php?title=Installazione_driver_ATI_su_Slackware_GNU/Linux

= Acknowledgement =
Thank you at Ezio Ghibaudo and Federico Rota who have started this wiki and for help with the SlackBuild. Thanks also at all the [http://www.slacky.eu/ Italian Slackware Community] users for their feedback and support.

[[User:Spina|Spina]]

Slackware: ATI SlackBuild (ITA)

2012-01-22T12:25:01Z

Spina: Rirpistinato il wiki all'ultima versione modificata da 414N

User:Spina

2011-02-27T23:14:57Z

Spina: Created page with 'Emanuele Tomasi <tomasiATcli.di.unipi.it>'

Emanuele Tomasi <tomasiATcli.di.unipi.it>

Slackware: ATI SlackBuild (ENG)

2011-02-27T23:12:15Z

Spina: Updated for 11.3 Catalyst

= Introduction =
This wiki explains how to install the proprietary ATI drivers in a Slackware Linux distribution, creating, thanks to a SlackBuild, packages that can be installed through the '''installpkg''' command.

This wiki DOES NOT explain how to improve performance. In particular, It provides only a minimal description of how to set up the X.Org server with the only purpose of loading the proprietary drivers (a description on how to configure the X.Org server to increase performance can be found, in italian, [http://www.slacky.eu/wikislack/index.php?title=Installazione_driver_ATI_su_Slackware_GNU/Linux here]).

All commands starting with a '#>' must be executed with root rights, while commands beginning with '$>' can be performed by a user without such rights.

= Proprietary ATI Drivers and ATI Catalyst =
Since 21 November 2007, ATI drivers have changed the name and the number version. The new drivers, which were first mentioned only as Proprietary ATI Driver, are now called ATI Catalyst. Moreover, the version number has passed from 8.XX.X to 7.XX.

When in this wiki we will talk about drivers version <8.37.6, we will refer implicitly to the old driver, such as Proprietary ATI Driver, while the new ATI Catalyst have a number version >= 8.37.6, even if, for instance, have a release number 7.11.

= Getting all the necessary =
The installer can be downloaded from the [http://ati.amd.com/support/driver.html official web site] directly.
{{Warning|Warning|If the downloaded driver version is less than 8.37.6, then you need to know from now that it will not work onto X.Org 7.2 server (or 1.3) or later.}}
{{Helpful Hint|Note|Drivers for x86 and x86_64 architectures are equivalent. The installer contains files for both architectures, then It will be the compilation process and the package creation process to choose the appropriate files.
This means that the SlackBuild will be good for Slackware, Slackware64 and for Slackware 64-bit portings (Slamd64, Bluewhite64, etc. ...).}}

Since drivers also contain a kernel module which will be compiled directly on your system, you'll need the kernel source in use.

= How to create Slackware packages =
== ATI Proprietary drivers or ATI Catalyst < 11.3 ==
For these drivers will be produced two packages (see [[#What do created packages contain?]]).
=== Drivers version < 8.37.6 (external SlackBuild) ===
For these types of drivers I've created an '''external SlackBuild''' for Slackware and I made [http://www.slacky.eu/~spina/fglrx/ati-slack-packager-1.1.9-noarch-1.tgz this package].

To create Slackware packages simply run:
#> installpkg ati-slack-packager-1.1.9-noarch-1.tgz
#> sh ati-driver-installer-<version>-x86.x86_64.run -- buildpkg custom-package/Slackware

=== Drivers version >= 8.37.6 or new ATI Catalyst (internal SlackBuild) ===
For these drivers I've sent the SlackBuild directly to ATI which inserted it into the installer, then simply run:
#> sh ati-driver-installer-<version>-x86.x86_64.run --buildpkg Slackware/All
or, if drivers are quite recent, it suffices:
#> sh ati-driver-installer-<version>-x86.x86_64.run --buildpkg
Otherwise, in order to create and install directly the packages you can use (always with recent versions of the driver):
#> sh ati-driver-installer-<version>-x86.x86_64.run --buildandinstallpkg

此处的意思是：如果是新装的系统，直接运行本处的最后一个命令即可同时完成创建包和安装包的过程。

=== What do created packages contain? ===
The two packages created by SlackBuild, that we'll call ''fglrx-module'' and ''fglrx-x'' contain, respectively, the kernel module and the X.Org server driver currently installed in the system. In this way, if you upgrade the kernel or the X.Org server, you can create only one package.

==== Creating only fglrx-module package ====
To create just the package containing the kernel module for the currently installed kernel, simply run the installer with the ''Only_Module'' option.

So with '''external SlackBuild''':
#> sh ati-driver-installer-<version>-x86.x86_64.run --buildpkg custom-package/Only_Module
With '''internal SlackBuild''':
#> sh ati-driver-installer-<version>-x86.x86_64.run --buildpkg Slackware/Only_Module

==== Creating only fglrx-x package ====
To create just the package containing the X.Org driver currently installed in your system, simply run installer with ''Only_X'' option.

With '''external SlackBuild''':
#> sh ati-driver-installer-<version>-x86.x86_64.run --buildpkg custom-package/Only_X
With '''internal SlackBuild''':
#> sh ati-driver-installer-<version>-x86.x86_64.run --buildpkg Slackware/Only_X

（如果进行了上一小节的 --buildandinstallpkg则本小节的命令可不必再执行）

接下来，执行

#> sh ati-driver-installer-<version>-x86.x86_64.run

即可进入ATI配置的界面，完成显卡的简单配置。

== ATI Catalyst >= 11.3 ==
Since these drivers the '''internal SlackBuild''' make only one package, named ''fglrx-<version>-<architecture>-<release>.tgz'', that you can create with:
#> sh ati-driver-installer-<version>-x86.x86_64.run --buildpkg
You can also make and install the package directly with:
#> sh ati-driver-installer-<versione>-x86.x86_64.run --buildandinstallpkg

= Minimal X.Org server configuration =
Once installed the two indicated packages, you must tell to the X.Org server to use ATI proprietary drivers, to do this we must check if the xorg.conf file, which is usually located in the ''/etc/X11/'' directory, contains the following items:

Section "Module"
...
Load "dri"
Load "glx"
...
EndSection

Section "Device"
...
Driver "fglrx"
...
EndSection

Section "DRI"
Group 0
Mode 0666
EndSection

{{Useful Information|Note|The command:
#> aticonfig --initial
can help you. Do '''aticonfig''' without options for more infos.}}

= Installation checking =
To see if proprietary ATI drivers are properly installed run the command:
$> fglrxinfo
On my computer the output is:
display::0.0 screen: 0
OpenGL vendor string: ATI Technologies Inc.
OpenGL renderer string: ATI Mobility Radeon X1400
OpenGL version string: 2.0.6650 (8.39.4)

= Remove installed packages =
== ATI Proprietary drivers or ATI Catalyst < 11.3 ==
To remove installed packages you can use the '''removepkg''' utility. However, there are aspects that should be considered:
* The packages' removing don't delete fglrx's driver configuration files, these files are located in ''/etc/ati'' directory
{{Be Careful|Be Careful|The /etc/ati/custom-package directory, if exists, contains the '''external SlackBuild''' and therefore should not be deleted.}}
* The fglrx-x package contains ATI's OpenGL libraries, and these libraries are located in the same directory of the Mesa libraries, so when you install the fglrx-x package Mesa OpenGL libraries are overridden. To restore the situation you should simply reinstall the package containing these libraries, like:
::x11
:for Slackware 11, or:
::mesa
:for Slackware 12.

== ATI Catalyst >= 11.3 ==
During installation of the package ''fglrx-<version>-<architecture>-<release>.tgz'' some libraries that would be overwritten are renamed as FGL.renamed.library_name. Due to remove this package cleanly you should do:
#> aticonfig --uninstall
or, directly with the script:
#> /usr/share/ati/amd-uninstall.sh
or, also with any installer >= 11.3, with:
#> ati-driver-installer-<versione>-x86.x86_64.run --uninstall
Will remain only the directory ''/etc/ati'' with the configuration files.

= Patching the drivers =
Ati drivers are usually not compatible with brand new version of kernel linux. You often need to patch the driver so that you can create the kernel module successfully. Since Ati Catalyst > 8.11 you can patch Ati drivers within the '''internal SlackBuild''' before that same SlackBuild compiles the kernel module.

In order to do that, you just have to create (or download from the Internet) a patch and rename it like this:

''/etc/ati/patch/patch-ATI_DRIVER_VERSION-KERNEL_VERSION''

where:

ATI_DRIVER_VERSION must be equal to the output of:
$> sh ati-driver-installer-<version>-x86.x86_64.run -i | head -n1 | cut -d'-' -f2
KERNEL_VERSION must be equal to the output of:
$> uname -r

If ''/etc/ati/patch'' doesn't exist, it must be made.

For example, if the former command outputs "8.55" and the latter "2.6.27.6", you need to name the patch ''/etc/ati/patch/patch-8.56-2.6.27.6''.

The '''internal SlackBuild''' will find the patch automatically and, if the command '''patch''' is installed, it will run:
#> patch -p0 < /etc/ati/patch/patch-8.56-2.6.27.6

== Patches ==
Here some patches and how to use there:

=== ATI Catalyst 10.3, 10.4 and kernel == 2.6.33.x ===
Download the [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.3-4_with_2.6.33.x.diff patch] into ''/tmp'', so:

* For '''Catalyst 10.3''' do:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.3-4_with_2.6.33.x.diff /etc/ati/patch/patch-8.712-$(uname -r)
#> sh ati-driver-installer-10-3-x86.x86_64.run --buildpkg

* For '''Catalyst 10.4''' do:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.3-4_with_2.6.33.x.diff /etc/ati/patch/patch-8.723-$(uname -r)
#> sh ati-driver-installer-10-4-x86.x86_64.run --buildpkg

=== ATI Catalyst 10.4, 10.5 and kernel == 2.6.34 ===
Download the [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.4-5_with_2.6.34.diff patch] into ''/tmp'', so:

* For '''Catalyst 10.4''' do:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.4-5_with_2.6.34.diff /etc/ati/patch/patch-8.723-$(uname -r)
#> sh ati-driver-installer-10-4-x86.x86_64.run --buildpkg

* For '''Catalyst 10.5''' do:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.4-5_with_2.6.34.diff /etc/ati/patch/patch-8.732-$(uname -r)
#> sh ati-driver-installer-10-4-x86.x86_64.run --buildpkg

=== ATI Catalyst 10.9 and Slackware64 13.1 or current ===
Download the [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.9_with_Slackware64-13.1.diff patch] into ''/tmp'', so to do:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.9_with_Slackware64-13.1.diff /etc/ati/patch/patch-8.771-$(uname -r)
#> sh ati-driver-installer-10-9-x86.x86_64.run --buildpkg
at one point the installer asks:
<PRE>
can't find file to patch at input line 4
Perhaps you should have used the -p or --strip option?
The text leading up to this was:
--------------------------
|diff -ru ./2.6.x/Makefile ../../../../../../fglrx-install.uZLF8t/common/lib/modules/fglrx/build_mod//2.6.x/Makefile
|--- ./2.6.x/Makefile 2010-09-01 16:05:31.000000000 +0200
|+++ ../../../../../../fglrx-install.uZLF8t/common/lib/modules/fglrx/build_mod//2.6.x/Makefile 2010-09-23 08:47:24.000000000 +0200
--------------------------
File to patch:
</PRE>
insert:
./2.6.x/Makefile

=== ATI Catalyst 10.10, 10.11 and kernel == 2.6.36.x ===
Download the [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.10-11_with_2.6.36.x.diff patch] into ''/tmp'', so:

* For '''Catalyst 10.10''' do:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-11_with_2.6.36.x.diff /etc/ati/patch/patch-8.783-$(uname -r)
#> sh ati-driver-installer-10-10-x86.x86_64.run --buildpkg

* For '''Catalyst 10.11''' do:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-11_with_2.6.36.x.diff /etc/ati/patch/patch-8.791-$(uname -r)
#> sh ati-driver-installer-10-11-x86.x86_64.run --buildpkg

=== ATI Catalyst 10.10, 10.11 e 10.12 e kernel == 2.6.37.x ===
Download the [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.10-12_with_2.6.37.x.diff patch] into ''/tmp'', so:
* For '''Catalyst 10.10''' do:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-12_with_2.6.37.x.diff /etc/ati/patch/patch-8.783-$(uname -r)
#> sh ati-driver-installer-10-10-x86.x86_64.run --buildpkg

* For '''Catalyst 10.11''' do:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-12_with_2.6.37.x.diff /etc/ati/patch/patch-8.791-$(uname -r)
#> sh ati-driver-installer-10-11-x86.x86_64.run --buildpkg

* For '''Catalyst 10.12''' do:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-12_with_2.6.37.x.diff /etc/ati/patch/patch-8.801-$(uname -r)
#> sh ati-driver-installer-10-12-x86.x86_64.run --buildpkg

= Known problems =
== error: implicit declaration of function 'lock_kernel' and error: implicit declaration of function 'unlock_kernel' ==
You need to enable the '''Big Kernel Lock''' in your kernel configuration. You find it under the '''Kernel hacking''' menu. You can check if this option is enable with:
$> zcat /proc/config.gz | grep BKL
CONFIG_BKL=y

== FATAL: modpost: GPL-incompatible module fglrx.ko uses GPL-only symbol 'paravirt_ops' ==
The error occurs during module compilation and It's due to the fact that the kernel was compiled with the option of paravirtualization active. This option among other things, prevents to load, and then to compile, modules that do not have the GPL license. Since that ATI drivers don't have this type of license, they aren't compiled.

To work around this problem you can:
==== Disable kernel paravirtualization option ====
The paravirtualization option is called '''CONFIG_PARAVIRT''' and generally is in the '''Processor type and features''' kernel submenu.
==== Patch ATI drivers ====
This operation is illegal because It changes the type of license issued by ATI in a GPL license. I wrote the patch:

[http://www.slacky.eu/~spina/fglrx/patch/ati_to_gpl.patch ati_to_gpl.patch] (md5sum: 4207f41a71035dc2eed3ea9346b881bb)

but I do not take any responsibility, I do not use It and I discourage the use in order to prefer the alternative to disable the paravirtualization kernel option. To use this patch You need to:

'''External SlackBuild'''
* Copy the patch in the ''/etc/ati/custom-package/patch'' directory

'''Internal SlackBuild''' (only with Ati Catalyst > 8.11):
* Copy the patch in the ''/etc/ati/patch'' directory (if it doesn't exist you must create it)

The SlackBuild will find and apply the patch automatically. In order to uninstall it you simply need to delete it. In order to uninstall the patch simply delete It from ''/etc/ati/custom-package/patch'' directory.

== Using GLX_SGIX_pbuffer FGLTexMgr: open of shared memory object failed (Permission denied) __FGLTexMgrCreateObject: __FGLTexMgrSHMmalloc failed!!! ==
This problem is due to the lack of SHM filesystem (now called tmpfs), that is virtual memory filesystem. To work around this problem you must:
* Add into ''/etc/fstab'' file the following line:
shm /dev/shm tmpfs defaults 0 0
* Then mount the filesystem through:
#> mount /dev/shm
Obviously the kernel must be predisposed for the "mounting" of this filesystem, in particular the kernel option that must be enabled is '''CONFIG_TMPFS''' that is generally placed in '''File system --> Pseudo filesystems''' submenu. However all the compiled kernel generally have this option enabled.

== kernel includes at /lib/modules/`uname -r`/build/include do not match current kernel ==
The complete mistake is something like this:

Error:
kernel includes at /lib/modules/`uname -r`/build/include do not match current kernel.
they are versioned as ""
instead of "`uname -r`".
you might need to adjust your symlinks:
- /usr/include
- /usr/src/linux

The error, also if explained, could be not clear. In practice It results from the fact that the symbolic link:
/lib/modules/`uname -r`/source
/lib/modules/`uname -r`/build
don't point to the directory where are inserted the current kernel sources (which is generally ''/usr/src/linux- 'uname-r'''). It happens to those who use a kernel contained in Slackware, so I will try to explain It in terms of Slackware "packages". This can happen:
* because the kernel source were not installed. In this case should be enough to install the source package which can be found in Slackware k/ directory. However, It is not granted that the problem will be solved, You'll need to see the second reason why there is an error.
* because sources (also if installed) do not reflect the settings of the current kernel. The new Slackware 12 has some precompiled kernels (which means different settings), while just a single package for the sources (unless seeing the branch extra/). In particular, the sources are for the SMP kernel and so if you use a non-SMP kernel can appear this error. To avoid this, after making sure that the package source has been installed, do simply the following:
#> cd /usr/src/linux
#> cp /boot/config .config
#> make
:running make, in addition to compiling the kernel modules (which we will not use), some header files are regenerated, and they will reflect the kernel configuration (as it's set in the .config file).

== Driver 8.39.4 logo ==
This "bug" in 8.39.4 drivers results from the fact that ATI developers don't update the packager maintainers before the official releases. It should be nice first if they did test us official releases in order to certify the proper functioning of the scripts for creating packages. To solve the problem it's necessary to use the '''external SlackBuild''' as described here.

== amdcccle don't start on Slackware 12 ==
Many users of the X.Org 7.2 (or 1.3) server version fail to start properly the Catalyst. The command to run the Catalyst is:
#> amdcccle
For this problem it seems there is no solution yet, but we are working on to solve it.

= Useful links =
The discussion thread from which it was derived this article:
http://www.slacky.eu/forum/viewtopic.php?t=18134&highlight=

An alternative to official ATI drivers:
http://www.x.org/wiki/radeon

A wiki in italian about installing and configuring ATI drivers (open source and proprietary):
http://www.slacky.eu/wikislack/index.php?title=Installazione_driver_ATI_su_Slackware_GNU/Linux

= Acknowledgement =
Thank you at Ezio Ghibaudo and Federico Rota who have started this wiki and for help with the SlackBuild. Thanks also at all the [http://www.slacky.eu/ Italian Slackware Community] users for their feedback and support.

[[User:Spina|Spina]]

Slackware: ATI SlackBuild (ITA)

2011-02-27T23:11:10Z

Spina: Aggiunto l'uso del comando 'aticonfig'

= Introduzione =
Questo wiki spiega come installare i driver propritari ATI con la distribuzione linux Slackware, creando, grazie ad uno SlackBuild, dei pacchetti che possono essere installati tramite il comando '''installpkg'''.

Il wiki NON spiega come migliorare le prestazioni. In particolare fornisce solo una descrizione minimale di come impostare il server X.Org con l'unico scopo di far funzionare i driver proprietari (una descrizione su come configurare il server X.Org per ottenere prestazioni più elevate la potete trovare [http://www.slacky.eu/wikislack/index.php?title=Installazione_driver_ATI_su_Slackware_GNU/Linux qui]).

Tutti i comandi che iniziano con un '#>' devono essere eseguiti con i diritti dell'utente root, mentre quello che iniziano con '$>' possono essere eseguiti anche da un utente senza tali diritti.

= ATI Proprietary Driver e ATI Catalyst =
A partire dal 21 Novembre 2007 i driver ATI hanno cambiato nome e numero di versione. I nuovi driver, che prima venivano indicati solo come '''ATI Proprietary Driver''', ora si chiamano '''ATI Catalyst'''. Non solo, il numero di versione è passato da '''8.XX.X''' a '''7.XX'''.

Quando in questo articolo si parlerà dei driver ''versione < 8.37.6'', ci si riferirà implicitamente ai vecchi driver, ovvero agli ATI Proprietary Driver, i nuovi ATI Catalyst sono da considerarsi ''versione >= 8.37.6'', anche se, ad esempio, hanno come numero di release 7.11.

= Come ottenere tutto il software necessario =
L'installer può essere scaricato direttamente dal [http://support.amd.com/us/gpudownload/Pages/index.aspx sito ufficiale].
{{Warning|Attenzione|Se la versione dei driver che si è scaricata è minore della 8.37.6 allora dovete sapere fin d'ora che non funzioneranno con il server X.Org 7.2 (o 1.3) o successivi.}}
{{Helpful Hint|Nota|I driver per le architetture x86 e x86_64 sono equivalenti. L'installer infatti contiene i file per entrambe le architetture, sarà poi il processo di compilazione e creazione dei pacchetti che sceglierà i file adeguati.
Questo vuol dire che lo SlackBuild andrà bene sia per la Slackware sia la Slackware64, sia per le varie versioni porting a 64 bit (Slamd64, Bluewhite64, etc...).}}

Dato che i driver contengono anche un modulo del kernel che verrà compilato direttamente sul vostro sistema, è necessario avere anche i sorgenti del kernel attualmente in uso.

= Come creare i pacchetti per la Slackware =
== ATI Proprietary Driver o ATI Catalyst < 11.3 ==
Per questi driver lo SlackBuild produce due pacchetti (vedere [[#Cosa contengono i pacchetti creati?]]).
=== Versione dei driver < 8.37.6 (SlackBuild esterno) ===
Per questi tipi di driver ho creato uno '''SlackBuild esterno''' per la Slackware di cui ho fatto [http://www.slacky.eu/~spina/fglrx/ati-slack-packager-1.1.9-noarch-1.tgz questo pacchetto].

Per creare i pacchetti Slackware basta eseguire:
#> installpkg ati-slack-packager-1.1.9-noarch-1.tgz
#> sh ati-driver-installer-<versione>-x86.x86_64.run --buildpkg custom-package/Slackware

=== Versione dei driver >= 8.37.6 o nuovi ATI Catalyst (SlackBuild interno) ===
Per questi driver lo SlackBuild l'ho inviato direttamente alla ATI che ha provveduto ad inserirlo all'interno dell'installer, quindi basta eseguire:
#> sh ati-driver-installer-<versione>-x86.x86_64.run --buildpkg Slackware/All
o, se i driver sono abbastanza recenti, basta un semplice:
#> sh ati-driver-installer-<versione>-x86.x86_64.run --buildpkg
Oppure, per creare ed installare direttamente i pacchetti, si può usare (sempre con versioni recenti dei driver):
#> sh intaller.run --buildandinstallpkg

=== Cosa contengono i pacchetti creati? ===
I due pacchetti creati dallo SlackBuild, che chiameremo ''fglrx-module'' e ''fglrx-x'', contengono, rispettivamente, il modulo per il kernel attualmente installato sul sistema, e i driver per la versione del server X.Org installata. In questo modo, se si aggiorna il kernel oppure il server X.Org si può creare solo il relativo pacchetto.

==== Creare solo il pacchetto fglrx-module ====
Per creare solo il pacchetto contenente il modulo per il kernel attualmente installato, basta lanciare l'installer con l'opzione ''Only_Module ''.

Quindi, con lo '''SlackBuild esterno''':
#> sh ati-driver-installer-<versione>-x86.x86_64.run --buildpkg custom-package/Only_Module
Con lo '''SlackBuild interno''':
#> sh ati-driver-installer-<versione>-x86.x86_64.run --buildpkg Slackware/Only_Module

==== Creare solo il pacchetto fglrx-x ====
Per creare solo il pacchetto contenente i driver per il server X.Org attualmente installato sul sistema, basta lanciare l'installer con l'opzione ''Only_X''.

Con lo '''SlackBuild esterno''':
#> sh ati-driver-installer-<versione>-x86.x86_64.run --buildpkg custom-package/Only_X
Con lo '''SlackBuild interno''':
#> sh ati-driver-installer-<versione>-x86.x86_64.run --buildpkg Slackware/Only_X

== ATI Catalyst >= 11.3 ==
A partire da questi driver lo '''SlackBuild interno''' produce un solo pacchetto, chiamato ''fglrx-<versione>-<architettura>-<release>.tgz'', che può essere creato con:
#> sh ati-driver-installer-<versione>-x86.x86_64.run --buildpkg
Si può anche creare ed installare direttamente il pacchetto con:
#> sh ati-driver-installer-<versione>-x86.x86_64.run --buildandinstallpkg

= Configurazione minimale del server X.Org =
Una volta installati i due pacchetti bisogna segnalare al server X.Org di usare i driver proprietari ATI, per fare questo bisogna controllare che il file xorg.conf, che generalmente è situato nella directory /etc/X11/, contenga le seguenti voci:

Section "Module"
....
Load "dri"
Load "glx"
....
EndSection

Section "Device"
....
Driver "fglrx"
....
EndSection

Section "DRI"
Group 0
Mode 0666
EndSection

{{Useful Information|Nota|Il comando:
#> aticonfig --initial
può essere di aiuto. Eseguire '''aticonfig''' senza opzioni per maggiori informazioni}}

= Verifica =
Per verificare se i driver proprietari ATI sono stati correttamente installati si può eseguire il comando:
$> fglrxinfo
Sulla mia macchina l'output è:
display: :0.0 screen: 0
OpenGL vendor string: ATI Technologies Inc.
OpenGL renderer string: ATI Mobility Radeon X1400
OpenGL version string: 2.0.6650 (8.39.4)

= Rimuovere i pacchetti installati =
== ATI Proprietary Driver o ATI Catalyst < 11.3 ==
Per rimuovere i pacchetti installati si può tranquillamente usare l'utility '''removepkg'''. Ci sono però aspetti che vanno considerati:
* La rimozione dei pacchetti non elimina i file di configurazione del driver fglrx, questi file sono situati nella directory ''/etc/ati''
{{Be Careful|Occhio|La directory ''/etc/ati/custom-package'' se esiste, contiene lo '''SlackBuild esterno''' e quindi non va cancellata.}}
*Il pacchetto ''fglrx-x'' contiene le librerie OpenGL della ATI, e queste librerie sono posizionate nella stessa directory di quelle Mesa, indi per cui quando si installa il pacchetto ''fglrx-x'' vengono sovrascritte le OpenGL Mesa. Per ripristinare la situazione si deve semplicemente reinstallare il pacchetto contenente queste librerie, ovvero il pacchetto:
::x11
:si usa la Slackware 11, oppure:
::mesa
:se si usa la Slackware 12.

== ATI Catalyst >= 11.3 ==
Durante l'installazione del pacchetto ''fglrx-<versione>-<architettura>-<release>.tgz'' alcune librerie che sarebbero sovrascritte vengono rinominate in FGL.renamed.nome_libreria. Per disinstallare il pacchetto in maniera "pulita" si dovrebbe eseguire il comando:
#> aticonfig --uninstall
oppure direttamente lo script:
#> /usr/share/ati/amd-uninstall.sh
o, ancora, con un qualsiasi installer >= 11.3, con:
#> ati-driver-installer-<versione>-x86.x86_64.run --uninstall
Dopo di ciò rimarrà solo la directory ''/etc/ati'' con i file di configurazione dei driver.

= Patchare i driver =
I driver ATI sono noti per essere sempre in ritardo rispetto all'aggiornamento del kernel linux. Spesso occorre quindi patchare i driver in modo tale che la creazione del modulo per il kernel abbia successo. A partire dagli ATI Catalist > 8.11 ho inserito nello '''SlackBuild interno''' la possibilità di patchare i driver ATI prima che lo SlackBuild stesso esegua la compilazione del modulo per il kernel.

Per fare questo basta creare (o scaricare da internet) una patch e dargli questo path:

''/etc/ati/patch/patch-ATI_DRIVER_VERSION-KERNEL_VERSION''

dove:

ATI_DRIVER_VERSION deve essere uguale al risultato del comando:
$> sh ati-driver-installer-<versione>-x86.x86_64.run -i | head -n1 | cut -d'-' -f2
KERNEL_VERSION deve essere uguale al risultato del comando:
$> uname -r

se la directory ''/et/ati/patch'' non esiste, va ovviamente creata.

Quindi, ad esempio, se si il primo dei due comandi da come risultato '''8.56''' e il secondo '''2.6.27.6''', la patch va chiamata: ''/etc/ati/patch/patch-8.56-2.6.27.6''.

Lo '''SlackBuild interno''' automaticamente noterà la patch, e, se si è in possesso del programma '''patch''', eseguirà:
#> patch -p0 < /etc/ati/patch/patch-8.56-2.6.27.6

== Alcune patch ==
Di seguito alcune patch note e come usarle:

=== ATI Catalyst 10.3, 10.4 e kernel == 2.6.33.x ===
Scaricate la [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.3-4_with_2.6.33.x.diff patch] nella directory ''/tmp'', quindi:

* Per i '''Catalyst 10.3''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.3-4_with_2.6.33.x.diff /etc/ati/patch/patch-8.712-$(uname -r)
#> sh ati-driver-installer-10-3-x86.x86_64.run --buildpkg

* Per i '''Catalyst 10.4''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.3-4_with_2.6.33.x.diff /etc/ati/patch/patch-8.723-$(uname -r)
#> sh ati-driver-installer-10-4-x86.x86_64.run --buildpkg

=== ATI Catalyst 10.4, 10.5 e kernel == 2.6.34 ===
Scaricate la [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.4-5_with_2.6.34.diff patch] nella directory ''/tmp'', quindi:

* Per i '''Catalyst 10.4''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.4-5_with_2.6.34.diff /etc/ati/patch/patch-8.723-$(uname -r)
#> sh ati-driver-installer-10-4-x86.x86_64.run --buildpkg

* Per i '''Catalyst 10.5''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.4-5_with_2.6.34.diff /etc/ati/patch/patch-8.732-$(uname -r)
#> sh ati-driver-installer-10-4-x86.x86_64.run --buildpkg

=== ATI Catalyst 10.9 e Slackware64 13.1 o current ===
Scaricate la [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.9_with_Slackware64-13.1.diff patch] nella directory ''/tmp'', quindi fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.9_with_Slackware64-13.1.diff /etc/ati/patch/patch-8.771-$(uname -r)
#> sh ati-driver-installer-10-9-x86.x86_64.run --buildpkg
ad un certo punto l'installazione chiede:
<PRE>
can't find file to patch at input line 4
Perhaps you should have used the -p or --strip option?
The text leading up to this was:
--------------------------
|diff -ru ./2.6.x/Makefile ../../../../../../fglrx-install.uZLF8t/common/lib/modules/fglrx/build_mod//2.6.x/Makefile
|--- ./2.6.x/Makefile 2010-09-01 16:05:31.000000000 +0200
|+++ ../../../../../../fglrx-install.uZLF8t/common/lib/modules/fglrx/build_mod//2.6.x/Makefile 2010-09-23 08:47:24.000000000 +0200
--------------------------
File to patch:
</PRE>
quindi inserire:
./2.6.x/Makefile

=== ATI Catalyst 10.10, 10.11 e kernel == 2.6.36.x ===
Scaricate la [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.10-11_with_2.6.36.x.diff patch] nella directory ''/tmp'', quindi:
* Per i '''Catalyst 10.10''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-11_with_2.6.36.x.diff /etc/ati/patch/patch-8.783-$(uname -r)
#> sh ati-driver-installer-10-10-x86.x86_64.run --buildpkg

* Per i '''Catalyst 10.11''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-11_with_2.6.36.x.diff /etc/ati/patch/patch-8.791-$(uname -r)
#> sh ati-driver-installer-10-11-x86.x86_64.run --buildpkg

=== ATI Catalyst 10.10, 10.11 e 10.12 e kernel == 2.6.37.x ===
Scaricate la [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.10-12_with_2.6.37.x.diff patch] nella directory ''/tmp'', quindi:
* Per i '''Catalyst 10.10''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-12_with_2.6.37.x.diff /etc/ati/patch/patch-8.783-$(uname -r)
#> sh ati-driver-installer-10-10-x86.x86_64.run --buildpkg

* Per i '''Catalyst 10.11''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-12_with_2.6.37.x.diff /etc/ati/patch/patch-8.791-$(uname -r)
#> sh ati-driver-installer-10-11-x86.x86_64.run --buildpkg

* Per i '''Catalyst 10.12''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-12_with_2.6.37.x.diff /etc/ati/patch/patch-8.801-$(uname -r)
#> sh ati-driver-installer-10-12-x86.x86_64.run --buildpkg

= Problemi noti =
== error: implicit declaration of function 'lock_kernel' and error: implicit declaration of function 'unlock_kernel' ==
Dovete abilitare l'opzione '''Big Kernel Lock''' nella vostra configurazione del kernel. La voce si trova nel menù '''Kernel hacking'''. Per controllare se questa opzione è abilitata potete fare:
$> zcat /proc/config.gz | grep BKL
CONFIG_BKL=y

== FATAL: modpost: GPL-incompatible module fglrx.ko uses GPL-only symbol 'paravirt_ops' ==
L'errore accade in fase di compilazione del modulo ed è dovuto al fatto che il kernel è stato compilato con l'opzione di paravirtualizzazione attiva. Questa opzione tra le altre cose, impedisce di caricare, e quindi di compilare, moduli che non hanno la licenza GPL. Visto che i driver ATI non hanno questo tipo di licenza, non vengono compilati.

Per ovviare al problema si può:
=== Disabilitare la paravirtualizzazione nel kernel ===
L'opzione di paravirtualizzazione si chiama '''CONFIG_PARAVIRT''' e generalmente si trova nel sottomenù '''Processor type and features''' del kernel.
=== Patchare i driver ATI ===
Questa operazione è illegale poichè si deve modificare il tipo di licenza rilasciata dalla ATI in GPL. Ho scritto la patch:

[http://www.slacky.eu/~spina/fglrx/patch/ati_to_gpl.patch ati_to_gpl.patch] (md5sum: 4207f41a71035dc2eed3ea9346b881bb)

di cui non mi prendo nessuna responsabilità, io non la uso e ne sconsiglio l'uso preferendo l'alternativa di disabilitare la paravirtualizzazione del kernel.
Per usare questa patch bisogna:

'''SlackBuild esterno''':
* Copiare la patch nella directory ''/etc/ati/custom-package/patch''

'''SlackBuild interno''' (solo con ATI Catalist > 8.11):
* Copiare la patch nella directory ''/etc/ati/patch'' (se non esiste, va creata)

Lo SlackBuild noterà la presenza della patch e la applicherà. Per disinstallare la patch basterà quindi cancellarla.

== Using GLX_SGIX_pbuffer FGLTexMgr: open of shared memory object failed (Permission denied) __FGLTexMgrCreateObject: __FGLTexMgrSHMmalloc failed!!! ==
Questo problema è dovuto alla mancanza nel sistema del filesystem SHM (oggi chiamato tmpfs), ovvero il virtual memory filesystem. Per ovviare al problema si deve:
* Aggiungere al file ''/etc/fstab'' la seguente riga:
shm /dev/shm tmpfs defaults 0 0
* Quindi montare il filesystem tramite:
#> mount /dev/shm
Ovviamente il kernel deve essero predisposto al "montaggio" di questo filesystem, in particolare l'opzione del kernel che deve essere abilitata è '''CONFIG_TMPFS''' che generalmente è sistuata nel sottomenù del kernel '''File systems --> Pseudo filesystems'''. C'è da dire però che tutti i kernel precompilati hanno generalmente questa opzione abilitata.

== kernel includes at /lib/modules/`uname -r`/build/include do not match current kernel ==
L'errore completo è qualcosa del genere:

Error:
kernel includes at /lib/modules/`uname -r`/build/include do not match current kernel.
they are versioned as ""
instead of "`uname -r`".
you might need to adjust your symlinks:
- /usr/include
- /usr/src/linux

L'errore, se pur spiegato può non essere chiaro. In pratica deriva dal fatto che i link simbolici:
/lib/modules/`uname -r`/source
/lib/modules/`uname -r`/build
non puntano alla directory in cui sono inseriti i sorgenti del kernel attuale (che generalmente è /usr/src/linux-`uname -r`). Accade a coloro che usano uno dei kernel contenuto nella Slackware, per cui cercherò di spiegarlo in termini di "pacchetti" Slackware. Questo può succedere:
* O perchè i sorgenti del kernel effettivamente non sono stati installati. In questo caso dovrebbe bastare installare il pacchetto dei sorgenti che si trova nella directory k/ della Slackware. Non è detto però che il problema venga risolto, si veda il secondo motivo per cui sussiste l'errore.
* O perchè i sorgenti (se pur installati) non rispecchiano le impostazioni dell'attuale kernel. La nuova Slackware 12 ha al suo interno un pò di kernel precompilati (che vuol dire impostazioni differenti) mentre un solo pacchetto per i sorgenti (a meno di vedere nel ramo extra/). In particolare i sorgenti sono per un kernel SMP e quindi se si utilizza un kernel precompilato non SMP può accare che si verifichi l'errore suddetto. Per ovviare basta fare quanto segue, dopo essersi assicurati che il pacchetto dei sorgenti è stato installato:
#> cd /usr/src/linux
#> cp /boot/config .config
#> make
:eseguendo il make, oltre a compilare il kernel e relativi moduli (che poi non useremo), si rigenerano alcuni file headers che rispecchiano la configurazione del kernel (per come impostata nel file .config).

== Logo nei driver 8.39.4 ==
Questo "bug" nei driver 8.39.4 deriva dal fatto che gli sviluppatori ATI non aggiornano i packager mantainer prima della release ufficiale. Sarebbe carino se facessero testare prima a noi le release ufficiali, in modo da certificare il corretto funzionamento degli script per creare i pacchetti. Per risolvere il problema si deve usare lo '''SlackBuild esterno''' come descritto [[#Versione dei driver < 8.37.6 (SlackBuild esterno) | qui]].

== amdcccle non parte con la Slackware 12 ==
Molti utenti che utilizzano la versione del server X.Org 7.2 (o 1.3) non riescono a lanciare correttamente il Catalyst. Il comando per eseguire il Catalyst è:
#> amdcccle
Per questo problema sembra non esserci ancora soluzione, ma stiamo lavorando per risolverlo.

= Link utili =
Il thread di discussione da cui è stato tratto questo articolo:
http://www.slacky.eu/forum/viewtopic.php?t=18134&highlight=

Un alternativa ai driver ufficiali ATI:
http://www.x.org/wiki/radeon

Una guida su come installare e configurare i driver (open source e proprietary) ATI:
http://www.slacky.eu/wikislack/index.php?title=Installazione_driver_ATI_su_Slackware_GNU/Linux

= Ringraziamenti =
Ringrazio Ezio Ghibaudo e Federico Rota per aver iniziato questo wiki e per l'aiuto che mi hanno dato con lo SlackBuild. Vorrei anche ringraziare tutti gli utenti della community [http://www.slacky.eu Slacky] per i feedback e consigli.

[[User:Spina|Spina]]

Slackware: ATI SlackBuild (ITA)

2011-02-27T23:03:28Z

Spina: Aggiornato per i Catalyst 11.3

= Introduzione =
Questo wiki spiega come installare i driver propritari ATI con la distribuzione linux Slackware, creando, grazie ad uno SlackBuild, dei pacchetti che possono essere installati tramite il comando '''installpkg'''.

Il wiki NON spiega come migliorare le prestazioni. In particolare fornisce solo una descrizione minimale di come impostare il server X.Org con l'unico scopo di far funzionare i driver proprietari (una descrizione su come configurare il server X.Org per ottenere prestazioni più elevate la potete trovare [http://www.slacky.eu/wikislack/index.php?title=Installazione_driver_ATI_su_Slackware_GNU/Linux qui]).

Tutti i comandi che iniziano con un '#>' devono essere eseguiti con i diritti dell'utente root, mentre quello che iniziano con '$>' possono essere eseguiti anche da un utente senza tali diritti.

= ATI Proprietary Driver e ATI Catalyst =
A partire dal 21 Novembre 2007 i driver ATI hanno cambiato nome e numero di versione. I nuovi driver, che prima venivano indicati solo come '''ATI Proprietary Driver''', ora si chiamano '''ATI Catalyst'''. Non solo, il numero di versione è passato da '''8.XX.X''' a '''7.XX'''.

Quando in questo articolo si parlerà dei driver ''versione < 8.37.6'', ci si riferirà implicitamente ai vecchi driver, ovvero agli ATI Proprietary Driver, i nuovi ATI Catalyst sono da considerarsi ''versione >= 8.37.6'', anche se, ad esempio, hanno come numero di release 7.11.

= Come ottenere tutto il software necessario =
L'installer può essere scaricato direttamente dal [http://support.amd.com/us/gpudownload/Pages/index.aspx sito ufficiale].
{{Warning|Attenzione|Se la versione dei driver che si è scaricata è minore della 8.37.6 allora dovete sapere fin d'ora che non funzioneranno con il server X.Org 7.2 (o 1.3) o successivi.}}
{{Helpful Hint|Nota|I driver per le architetture x86 e x86_64 sono equivalenti. L'installer infatti contiene i file per entrambe le architetture, sarà poi il processo di compilazione e creazione dei pacchetti che sceglierà i file adeguati.
Questo vuol dire che lo SlackBuild andrà bene sia per la Slackware sia la Slackware64, sia per le varie versioni porting a 64 bit (Slamd64, Bluewhite64, etc...).}}

Dato che i driver contengono anche un modulo del kernel che verrà compilato direttamente sul vostro sistema, è necessario avere anche i sorgenti del kernel attualmente in uso.

= Come creare i pacchetti per la Slackware =
== ATI Proprietary Driver o ATI Catalyst < 11.3 ==
Per questi driver lo SlackBuild produce due pacchetti (vedere [[#Cosa contengono i pacchetti creati?]]).
=== Versione dei driver < 8.37.6 (SlackBuild esterno) ===
Per questi tipi di driver ho creato uno '''SlackBuild esterno''' per la Slackware di cui ho fatto [http://www.slacky.eu/~spina/fglrx/ati-slack-packager-1.1.9-noarch-1.tgz questo pacchetto].

Per creare i pacchetti Slackware basta eseguire:
#> installpkg ati-slack-packager-1.1.9-noarch-1.tgz
#> sh ati-driver-installer-<versione>-x86.x86_64.run --buildpkg custom-package/Slackware

=== Versione dei driver >= 8.37.6 o nuovi ATI Catalyst (SlackBuild interno) ===
Per questi driver lo SlackBuild l'ho inviato direttamente alla ATI che ha provveduto ad inserirlo all'interno dell'installer, quindi basta eseguire:
#> sh ati-driver-installer-<versione>-x86.x86_64.run --buildpkg Slackware/All
o, se i driver sono abbastanza recenti, basta un semplice:
#> sh ati-driver-installer-<versione>-x86.x86_64.run --buildpkg
Oppure, per creare ed installare direttamente i pacchetti, si può usare (sempre con versioni recenti dei driver):
#> sh intaller.run --buildandinstallpkg

=== Cosa contengono i pacchetti creati? ===
I due pacchetti creati dallo SlackBuild, che chiameremo ''fglrx-module'' e ''fglrx-x'', contengono, rispettivamente, il modulo per il kernel attualmente installato sul sistema, e i driver per la versione del server X.Org installata. In questo modo, se si aggiorna il kernel oppure il server X.Org si può creare solo il relativo pacchetto.

==== Creare solo il pacchetto fglrx-module ====
Per creare solo il pacchetto contenente il modulo per il kernel attualmente installato, basta lanciare l'installer con l'opzione ''Only_Module ''.

Quindi, con lo '''SlackBuild esterno''':
#> sh ati-driver-installer-<versione>-x86.x86_64.run --buildpkg custom-package/Only_Module
Con lo '''SlackBuild interno''':
#> sh ati-driver-installer-<versione>-x86.x86_64.run --buildpkg Slackware/Only_Module

==== Creare solo il pacchetto fglrx-x ====
Per creare solo il pacchetto contenente i driver per il server X.Org attualmente installato sul sistema, basta lanciare l'installer con l'opzione ''Only_X''.

Con lo '''SlackBuild esterno''':
#> sh ati-driver-installer-<versione>-x86.x86_64.run --buildpkg custom-package/Only_X
Con lo '''SlackBuild interno''':
#> sh ati-driver-installer-<versione>-x86.x86_64.run --buildpkg Slackware/Only_X

== ATI Catalyst >= 11.3 ==
A partire da questi driver lo '''SlackBuild interno''' produce un solo pacchetto, chiamato ''fglrx-<versione>-<architettura>-<release>.tgz'', che può essere creato con:
#> sh ati-driver-installer-<versione>-x86.x86_64.run --buildpkg
Si può anche creare ed installare direttamente il pacchetto con:
#> sh ati-driver-installer-<versione>-x86.x86_64.run --buildandinstallpkg

= Configurazione minimale del server X.Org =
Una volta installati i due pacchetti bisogna segnalare al server X.Org di usare i driver proprietari ATI, per fare questo bisogna controllare che il file xorg.conf, che generalmente è situato nella directory /etc/X11/, contenga le seguenti voci:

Section "Module"
....
Load "dri"
Load "glx"
....
EndSection

Section "Device"
....
Driver "fglrx"
....
EndSection

Section "DRI"
Group 0
Mode 0666
EndSection

= Verifica =
Per verificare se i driver proprietari ATI sono stati correttamente installati si può eseguire il comando:
$> fglrxinfo
Sulla mia macchina l'output è:
display: :0.0 screen: 0
OpenGL vendor string: ATI Technologies Inc.
OpenGL renderer string: ATI Mobility Radeon X1400
OpenGL version string: 2.0.6650 (8.39.4)

= Rimuovere i pacchetti installati =
== ATI Proprietary Driver o ATI Catalyst < 11.3 ==
Per rimuovere i pacchetti installati si può tranquillamente usare l'utility '''removepkg'''. Ci sono però aspetti che vanno considerati:
* La rimozione dei pacchetti non elimina i file di configurazione del driver fglrx, questi file sono situati nella directory ''/etc/ati''
{{Be Careful|Occhio|La directory ''/etc/ati/custom-package'' se esiste, contiene lo '''SlackBuild esterno''' e quindi non va cancellata.}}
*Il pacchetto ''fglrx-x'' contiene le librerie OpenGL della ATI, e queste librerie sono posizionate nella stessa directory di quelle Mesa, indi per cui quando si installa il pacchetto ''fglrx-x'' vengono sovrascritte le OpenGL Mesa. Per ripristinare la situazione si deve semplicemente reinstallare il pacchetto contenente queste librerie, ovvero il pacchetto:
::x11
:si usa la Slackware 11, oppure:
::mesa
:se si usa la Slackware 12.

== ATI Catalyst >= 11.3 ==
Durante l'installazione del pacchetto ''fglrx-<versione>-<architettura>-<release>.tgz'' alcune librerie che sarebbero sovrascritte vengono rinominate in FGL.renamed.nome_libreria. Per disinstallare il pacchetto in maniera "pulita" si dovrebbe eseguire il comando:
#> aticonfig --uninstall
oppure direttamente lo script:
#> /usr/share/ati/amd-uninstall.sh
o, ancora, con un qualsiasi installer >= 11.3, con:
#> ati-driver-installer-<versione>-x86.x86_64.run --uninstall
Dopo di ciò rimarrà solo la directory ''/etc/ati'' con i file di configurazione dei driver.

= Patchare i driver =
I driver ATI sono noti per essere sempre in ritardo rispetto all'aggiornamento del kernel linux. Spesso occorre quindi patchare i driver in modo tale che la creazione del modulo per il kernel abbia successo. A partire dagli ATI Catalist > 8.11 ho inserito nello '''SlackBuild interno''' la possibilità di patchare i driver ATI prima che lo SlackBuild stesso esegua la compilazione del modulo per il kernel.

Per fare questo basta creare (o scaricare da internet) una patch e dargli questo path:

''/etc/ati/patch/patch-ATI_DRIVER_VERSION-KERNEL_VERSION''

dove:

ATI_DRIVER_VERSION deve essere uguale al risultato del comando:
$> sh ati-driver-installer-<versione>-x86.x86_64.run -i | head -n1 | cut -d'-' -f2
KERNEL_VERSION deve essere uguale al risultato del comando:
$> uname -r

se la directory ''/et/ati/patch'' non esiste, va ovviamente creata.

Quindi, ad esempio, se si il primo dei due comandi da come risultato '''8.56''' e il secondo '''2.6.27.6''', la patch va chiamata: ''/etc/ati/patch/patch-8.56-2.6.27.6''.

Lo '''SlackBuild interno''' automaticamente noterà la patch, e, se si è in possesso del programma '''patch''', eseguirà:
#> patch -p0 < /etc/ati/patch/patch-8.56-2.6.27.6

== Alcune patch ==
Di seguito alcune patch note e come usarle:

=== ATI Catalyst 10.3, 10.4 e kernel == 2.6.33.x ===
Scaricate la [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.3-4_with_2.6.33.x.diff patch] nella directory ''/tmp'', quindi:

* Per i '''Catalyst 10.3''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.3-4_with_2.6.33.x.diff /etc/ati/patch/patch-8.712-$(uname -r)
#> sh ati-driver-installer-10-3-x86.x86_64.run --buildpkg

* Per i '''Catalyst 10.4''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.3-4_with_2.6.33.x.diff /etc/ati/patch/patch-8.723-$(uname -r)
#> sh ati-driver-installer-10-4-x86.x86_64.run --buildpkg

=== ATI Catalyst 10.4, 10.5 e kernel == 2.6.34 ===
Scaricate la [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.4-5_with_2.6.34.diff patch] nella directory ''/tmp'', quindi:

* Per i '''Catalyst 10.4''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.4-5_with_2.6.34.diff /etc/ati/patch/patch-8.723-$(uname -r)
#> sh ati-driver-installer-10-4-x86.x86_64.run --buildpkg

* Per i '''Catalyst 10.5''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.4-5_with_2.6.34.diff /etc/ati/patch/patch-8.732-$(uname -r)
#> sh ati-driver-installer-10-4-x86.x86_64.run --buildpkg

=== ATI Catalyst 10.9 e Slackware64 13.1 o current ===
Scaricate la [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.9_with_Slackware64-13.1.diff patch] nella directory ''/tmp'', quindi fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.9_with_Slackware64-13.1.diff /etc/ati/patch/patch-8.771-$(uname -r)
#> sh ati-driver-installer-10-9-x86.x86_64.run --buildpkg
ad un certo punto l'installazione chiede:
<PRE>
can't find file to patch at input line 4
Perhaps you should have used the -p or --strip option?
The text leading up to this was:
--------------------------
|diff -ru ./2.6.x/Makefile ../../../../../../fglrx-install.uZLF8t/common/lib/modules/fglrx/build_mod//2.6.x/Makefile
|--- ./2.6.x/Makefile 2010-09-01 16:05:31.000000000 +0200
|+++ ../../../../../../fglrx-install.uZLF8t/common/lib/modules/fglrx/build_mod//2.6.x/Makefile 2010-09-23 08:47:24.000000000 +0200
--------------------------
File to patch:
</PRE>
quindi inserire:
./2.6.x/Makefile

=== ATI Catalyst 10.10, 10.11 e kernel == 2.6.36.x ===
Scaricate la [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.10-11_with_2.6.36.x.diff patch] nella directory ''/tmp'', quindi:
* Per i '''Catalyst 10.10''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-11_with_2.6.36.x.diff /etc/ati/patch/patch-8.783-$(uname -r)
#> sh ati-driver-installer-10-10-x86.x86_64.run --buildpkg

* Per i '''Catalyst 10.11''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-11_with_2.6.36.x.diff /etc/ati/patch/patch-8.791-$(uname -r)
#> sh ati-driver-installer-10-11-x86.x86_64.run --buildpkg

=== ATI Catalyst 10.10, 10.11 e 10.12 e kernel == 2.6.37.x ===
Scaricate la [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.10-12_with_2.6.37.x.diff patch] nella directory ''/tmp'', quindi:
* Per i '''Catalyst 10.10''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-12_with_2.6.37.x.diff /etc/ati/patch/patch-8.783-$(uname -r)
#> sh ati-driver-installer-10-10-x86.x86_64.run --buildpkg

* Per i '''Catalyst 10.11''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-12_with_2.6.37.x.diff /etc/ati/patch/patch-8.791-$(uname -r)
#> sh ati-driver-installer-10-11-x86.x86_64.run --buildpkg

* Per i '''Catalyst 10.12''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-12_with_2.6.37.x.diff /etc/ati/patch/patch-8.801-$(uname -r)
#> sh ati-driver-installer-10-12-x86.x86_64.run --buildpkg

= Problemi noti =
== error: implicit declaration of function 'lock_kernel' and error: implicit declaration of function 'unlock_kernel' ==
Dovete abilitare l'opzione '''Big Kernel Lock''' nella vostra configurazione del kernel. La voce si trova nel menù '''Kernel hacking'''. Per controllare se questa opzione è abilitata potete fare:
$> zcat /proc/config.gz | grep BKL
CONFIG_BKL=y

== FATAL: modpost: GPL-incompatible module fglrx.ko uses GPL-only symbol 'paravirt_ops' ==
L'errore accade in fase di compilazione del modulo ed è dovuto al fatto che il kernel è stato compilato con l'opzione di paravirtualizzazione attiva. Questa opzione tra le altre cose, impedisce di caricare, e quindi di compilare, moduli che non hanno la licenza GPL. Visto che i driver ATI non hanno questo tipo di licenza, non vengono compilati.

Per ovviare al problema si può:
=== Disabilitare la paravirtualizzazione nel kernel ===
L'opzione di paravirtualizzazione si chiama '''CONFIG_PARAVIRT''' e generalmente si trova nel sottomenù '''Processor type and features''' del kernel.
=== Patchare i driver ATI ===
Questa operazione è illegale poichè si deve modificare il tipo di licenza rilasciata dalla ATI in GPL. Ho scritto la patch:

[http://www.slacky.eu/~spina/fglrx/patch/ati_to_gpl.patch ati_to_gpl.patch] (md5sum: 4207f41a71035dc2eed3ea9346b881bb)

di cui non mi prendo nessuna responsabilità, io non la uso e ne sconsiglio l'uso preferendo l'alternativa di disabilitare la paravirtualizzazione del kernel.
Per usare questa patch bisogna:

'''SlackBuild esterno''':
* Copiare la patch nella directory ''/etc/ati/custom-package/patch''

'''SlackBuild interno''' (solo con ATI Catalist > 8.11):
* Copiare la patch nella directory ''/etc/ati/patch'' (se non esiste, va creata)

Lo SlackBuild noterà la presenza della patch e la applicherà. Per disinstallare la patch basterà quindi cancellarla.

== Using GLX_SGIX_pbuffer FGLTexMgr: open of shared memory object failed (Permission denied) __FGLTexMgrCreateObject: __FGLTexMgrSHMmalloc failed!!! ==
Questo problema è dovuto alla mancanza nel sistema del filesystem SHM (oggi chiamato tmpfs), ovvero il virtual memory filesystem. Per ovviare al problema si deve:
* Aggiungere al file ''/etc/fstab'' la seguente riga:
shm /dev/shm tmpfs defaults 0 0
* Quindi montare il filesystem tramite:
#> mount /dev/shm
Ovviamente il kernel deve essero predisposto al "montaggio" di questo filesystem, in particolare l'opzione del kernel che deve essere abilitata è '''CONFIG_TMPFS''' che generalmente è sistuata nel sottomenù del kernel '''File systems --> Pseudo filesystems'''. C'è da dire però che tutti i kernel precompilati hanno generalmente questa opzione abilitata.

== kernel includes at /lib/modules/`uname -r`/build/include do not match current kernel ==
L'errore completo è qualcosa del genere:

Error:
kernel includes at /lib/modules/`uname -r`/build/include do not match current kernel.
they are versioned as ""
instead of "`uname -r`".
you might need to adjust your symlinks:
- /usr/include
- /usr/src/linux

L'errore, se pur spiegato può non essere chiaro. In pratica deriva dal fatto che i link simbolici:
/lib/modules/`uname -r`/source
/lib/modules/`uname -r`/build
non puntano alla directory in cui sono inseriti i sorgenti del kernel attuale (che generalmente è /usr/src/linux-`uname -r`). Accade a coloro che usano uno dei kernel contenuto nella Slackware, per cui cercherò di spiegarlo in termini di "pacchetti" Slackware. Questo può succedere:
* O perchè i sorgenti del kernel effettivamente non sono stati installati. In questo caso dovrebbe bastare installare il pacchetto dei sorgenti che si trova nella directory k/ della Slackware. Non è detto però che il problema venga risolto, si veda il secondo motivo per cui sussiste l'errore.
* O perchè i sorgenti (se pur installati) non rispecchiano le impostazioni dell'attuale kernel. La nuova Slackware 12 ha al suo interno un pò di kernel precompilati (che vuol dire impostazioni differenti) mentre un solo pacchetto per i sorgenti (a meno di vedere nel ramo extra/). In particolare i sorgenti sono per un kernel SMP e quindi se si utilizza un kernel precompilato non SMP può accare che si verifichi l'errore suddetto. Per ovviare basta fare quanto segue, dopo essersi assicurati che il pacchetto dei sorgenti è stato installato:
#> cd /usr/src/linux
#> cp /boot/config .config
#> make
:eseguendo il make, oltre a compilare il kernel e relativi moduli (che poi non useremo), si rigenerano alcuni file headers che rispecchiano la configurazione del kernel (per come impostata nel file .config).

== Logo nei driver 8.39.4 ==
Questo "bug" nei driver 8.39.4 deriva dal fatto che gli sviluppatori ATI non aggiornano i packager mantainer prima della release ufficiale. Sarebbe carino se facessero testare prima a noi le release ufficiali, in modo da certificare il corretto funzionamento degli script per creare i pacchetti. Per risolvere il problema si deve usare lo '''SlackBuild esterno''' come descritto [[#Versione dei driver < 8.37.6 (SlackBuild esterno) | qui]].

== amdcccle non parte con la Slackware 12 ==
Molti utenti che utilizzano la versione del server X.Org 7.2 (o 1.3) non riescono a lanciare correttamente il Catalyst. Il comando per eseguire il Catalyst è:
#> amdcccle
Per questo problema sembra non esserci ancora soluzione, ma stiamo lavorando per risolverlo.

= Link utili =
Il thread di discussione da cui è stato tratto questo articolo:
http://www.slacky.eu/forum/viewtopic.php?t=18134&highlight=

Un alternativa ai driver ufficiali ATI:
http://www.x.org/wiki/radeon

Una guida su come installare e configurare i driver (open source e proprietary) ATI:
http://www.slacky.eu/wikislack/index.php?title=Installazione_driver_ATI_su_Slackware_GNU/Linux

= Ringraziamenti =
Ringrazio Ezio Ghibaudo e Federico Rota per aver iniziato questo wiki e per l'aiuto che mi hanno dato con lo SlackBuild. Vorrei anche ringraziare tutti gli utenti della community [http://www.slacky.eu Slacky] per i feedback e consigli.

[[User:Spina|Spina]]

Slackware

2011-02-27T22:05:36Z

Spina:

[[Category:Distributions]]
Welcome. This bare-bone little FAQ details how to get fglrx working on Slackware, Slackware64 and 64 bit porting.

Enjoy!

*[[Slackware: ATI SlackBuild (ENG)|ATI SlackBuild (ENG)]]
*[[Slackware: ATI SlackBuild (ITA)|ATI SlackBuild (ITA)]]

{{VCT}}

Slackware: external SlackBuild (ENG)

2011-02-27T22:04:11Z

Spina: Replaced content with '{{Warning|Attenzione|This wiki has been moved here}} Spina'

{{Warning|Attenzione|This wiki has been moved [[Slackware:_ATI_SlackBuild_(ENG) | here]]}}

[[User:Spina|Spina]]

Slackware: internal SlackBuild (ENG)

2011-02-27T22:03:53Z

Spina: moved Slackware: internal SlackBuild (ENG) to Slackware: ATI SlackBuild (ENG)

#REDIRECT [[Slackware: ATI SlackBuild (ENG)]]

Slackware: ATI SlackBuild (ENG)

2011-02-27T22:03:53Z

Spina: moved Slackware: internal SlackBuild (ENG) to Slackware: ATI SlackBuild (ENG)

== Introduction ==
This wiki explains how to install the proprietary ATI drivers in a Slackware Linux distribution, creating, thanks to a SlackBuild, packages that can be installed through the '''installpkg''' command.

This wiki DOES NOT explain how to improve performance. In particular, It provides only a minimal description of how to set up the X.Org server with the only purpose of loading the proprietary drivers (a description on how to configure the X.Org server to increase performance can be found here).

All commands starting with a '#>' must be executed with root rights, while commands beginning with '$>' can be performed by a user without such rights.

== Proprietary ATI Drivers and ATI Catalyst ==
Since 21 November 2007, ATI drivers have changed the name and the number version. The new drivers, which were first mentioned only as Proprietary ATI Driver, are now called ATI Catalyst. Moreover, the version number has passed from 8.XX.X to 7.XX.

When in this wiki we will talk about drivers version <8.37.6, we will refer implicitly to the old driver, such as Proprietary ATI Driver, while the new ATI Catalyst have a number version >= 8.37.6, even if, for instance, have a release number 7.11.

== Getting all the necessary ==
The proprietary ATI drivers can be downloaded from the [http://ati.amd.com/support/driver.html official web site], after selecting the Linux x86 operating system (or Linux x86_64) and selecting your video card, pressing the “go” button takes you directly into the download page from which you can download the installer (which henceforth we call installer.run).
Since drivers also contain a kernel module which will be compiled directly on your system, you'll need the kernel source currently installed in the system as well.

{{Helpful Hint|Note|Drivers for x86 and x86_64 architectures are equivalent. The installer contains files for both architectures, then It will be the compilation process and the package creation process to choose the appropriate files.
This means that '''the SlackBuild will be good for Slackware, Slackware64 and for Slackware 64-bit portings (Slamd64, Bluewhite64, etc. ...)'''.}}

{{Warning|Warning|If the downloaded driver version is less than 8.37.6, then you need to know from now that it will not work onto X.Org 7.2 server (or 1.3) or later.}}

== How to create Slackware packages ==
The packages creation follows two different ways depending on whether you use the official driver version '''< 8.37.6''' or '''>= 8.37.6''' or new '''ATI Catalyst'''.
The first way uses what is called '''external SlackBuild''' while the second way what we will call '''internal SlackBuild'''.
In both cases the two packages will be created and they can be installed by Slackware '''installpkg''' utility.
So let's see the two cases saying that the program that here is called installer.run is the installer downloaded from ATI web site.

=== Drivers version < 8.37.6 (external SlackBuild) ===
For these types of drivers I've created an '''external SlackBuild''' for Slackware and I made [http://www.slacky.eu/~spina/fglrx/ati-slack-packager-1.1.9-noarch-1.tgz this package].

To create Slackware packages simply run:
#> installpkg ati-slack-packager-current-noarch-1.tgz
#> sh installer.run -- buildpkg custom-package/Slackware

{{Useful Information|Note|The '''external SlackBuild''' use is limited to the driver '''< 8.37.6''' since from new '''Catalyst 8.11''' you can pass the patches at the '''internal SlackBuild'''.}}

=== Drivers version >= 8.37.6 or new ATI Catalyst (internal SlackBuild) ===
For these drivers I've sent the SlackBuild directly to ATI which inserted it into the installer, then simply run:
#> sh installer.run --buildpkg Slackware/All
or, if drivers are quite recent, it suffices:
#> sh installer.run --buildpkg
Otherwise, in order to create and install directly the packages you can use (always with recent versions of the driver):
#> sh installer.run --buildandinstallpkg

此处的意思是：如果是新装的系统，直接运行本处的最后一个命令即可同时完成创建包和安装包的过程。

== What do created packages contain? ==
The two packages created by SlackBuild, that we'll call ''fglrx-module'' and ''fglrx-x'' contain, respectively, the kernel module and the X.Org server driver currently installed in the system.
In this way, if you upgrade the kernel or the X.Org server, you can create only one package.

=== Creating only fglrx-module package ===
To create just the package containing the kernel module for the currently installed kernel, simply run the installer with the ''Only_Module'' option.

So with '''external SlackBuild''':
#> sh installer.run --buildpkg custom-package/Only_Module
With '''internal SlackBuild''':
#> sh installer.run --buildpkg Slackware/Only_Module

=== Creating only fglrx-x package ===
To create just the package containing the X.Org driver currently installed in your system, simply run installer with ''Only_X'' option.

With '''external SlackBuild''':
#> sh installer.run --buildpkg custom-package/Only_X
With '''internal SlackBuild''':
#> sh installer.run --buildpkg Slackware/Only_X

（如果进行了上一小节的 --buildandinstallpkg则本小节的命令可不必再执行）

接下来，执行

#> sh installer.run

即可进入ATI配置的界面，完成显卡的简单配置。

== Minimal X.Org server configuration ==
Once installed the two indicated packages, you must tell to the X.Org server to use ATI proprietary drivers, to do this we must check if the xorg.conf file, which is usually located in the ''/etc/X11/'' directory, contains the following items:

Section "Module"
...
Load "dri"
Load "glx"
...
EndSection

Section "Device"
...
Driver "fglrx"
...
EndSection

Section "DRI"
Group 0
Mode 0666
EndSection

== Installation checking ==
To see if proprietary ATI drivers are properly installed run the command:
$> fglrxinfo
On my computer the output is:
display::0.0 screen: 0
OpenGL vendor string: ATI Technologies Inc.
OpenGL renderer string: ATI Mobility Radeon X1400
OpenGL version string: 2.0.6650 (8.39.4)

== Remove installed packages ==
To remove installed packages you can use the '''removepkg''' utility. However, there are aspects that should be considered:
* The packages' removing don't delete fglrx's driver configuration files, these files are located in ''/etc/ati'' directory
{{Be Careful|Be Careful|The /etc/ati/custom-package directory, if exists, contains the '''external SlackBuild''' and therefore should not be deleted.}}
* The fglrx-x package contains ATI's OpenGL libraries, and these libraries are located in the same directory of the Mesa libraries, so when you install the fglrx-x package Mesa OpenGL libraries are overridden. To restore the situation you should simply reinstall the package containing these libraries, like:
::x11
:for Slackware 11, or:
::mesa
:for Slackware 12.

= Patching the drivers =
Ati drivers are usually not compatible with brand new version of kernel linux. You often need to patch the driver so that you can create the kernel module successfully. Since Ati Catalyst > 8.11 you can patch Ati drivers within the '''internal SlackBuild''' before that same SlackBuild compiles the kernel module.

In order to do that, you just have to create (or download from the Internet) a patch and rename it like this:

''/etc/ati/patch/patch-ATI_DRIVER_VERSION-KERNEL_VERSION''

where:

ATI_DRIVER_VERSION must be equal to the output of:
$> sh installer.run -i | head -n1 | cut -d'-' -f2
KERNEL_VERSION must be equal to the output of:
$> uname -r

If ''/etc/ati/patch'' doesn't exist, it must be made.

For example, if the former command outputs "8.55" and the latter "2.6.27.6", you need to name the patch ''/etc/ati/patch/patch-8.56-2.6.27.6''.

The '''internal SlackBuild''' will find the patch automatically and, if the command '''patch''' is installed, it will run:
#> patch -p0 < /etc/ati/patch/patch-8.56-2.6.27.6

== Patches ==
Here some patches and how to use there:

=== ATI Catalyst 10.3, 10.4 and kernel == 2.6.33.x ===
Download the [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.3-4_with_2.6.33.x.diff patch] into ''/tmp'', so:

* For '''Catalyst 10.3''' do:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.3-4_with_2.6.33.x.diff /etc/ati/patch/patch-8.712-$(uname -r)
#> sh ati-driver-installer-10-3-x86.x86_64.run --buildpkg

* For '''Catalyst 10.4''' do:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.3-4_with_2.6.33.x.diff /etc/ati/patch/patch-8.723-$(uname -r)
#> sh ati-driver-installer-10-4-x86.x86_64.run --buildpkg

=== ATI Catalyst 10.4, 10.5 and kernel == 2.6.34 ===
Download the [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.4-5_with_2.6.34.diff patch] into ''/tmp'', so:

* For '''Catalyst 10.4''' do:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.4-5_with_2.6.34.diff /etc/ati/patch/patch-8.723-$(uname -r)
#> sh ati-driver-installer-10-4-x86.x86_64.run --buildpkg

* For '''Catalyst 10.5''' do:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.4-5_with_2.6.34.diff /etc/ati/patch/patch-8.732-$(uname -r)
#> sh ati-driver-installer-10-4-x86.x86_64.run --buildpkg

=== ATI Catalyst 10.9 and Slackware64 13.1 or current ===
Download the [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.9_with_Slackware64-13.1.diff patch] into ''/tmp'', so to do:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.9_with_Slackware64-13.1.diff /etc/ati/patch/patch-8.771-$(uname -r)
#> sh ati-driver-installer-10-9-x86.x86_64.run --buildpkg
at one point the installer asks:
<PRE>
can't find file to patch at input line 4
Perhaps you should have used the -p or --strip option?
The text leading up to this was:
--------------------------
|diff -ru ./2.6.x/Makefile ../../../../../../fglrx-install.uZLF8t/common/lib/modules/fglrx/build_mod//2.6.x/Makefile
|--- ./2.6.x/Makefile 2010-09-01 16:05:31.000000000 +0200
|+++ ../../../../../../fglrx-install.uZLF8t/common/lib/modules/fglrx/build_mod//2.6.x/Makefile 2010-09-23 08:47:24.000000000 +0200
--------------------------
File to patch:
</PRE>
insert:
./2.6.x/Makefile

=== ATI Catalyst 10.10, 10.11 and kernel == 2.6.36.x ===
Download the [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.10-11_with_2.6.36.x.diff patch] into ''/tmp'', so:

* For '''Catalyst 10.10''' do:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-11_with_2.6.36.x.diff /etc/ati/patch/patch-8.783-$(uname -r)
#> sh ati-driver-installer-10-10-x86.x86_64.run --buildpkg

* For '''Catalyst 10.11''' do:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-11_with_2.6.36.x.diff /etc/ati/patch/patch-8.791-$(uname -r)
#> sh ati-driver-installer-10-11-x86.x86_64.run --buildpkg

=== ATI Catalyst 10.10, 10.11 e 10.12 e kernel == 2.6.37.x ===
Download the [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.10-12_with_2.6.37.x.diff patch] into ''/tmp'', so:
* For '''Catalyst 10.10''' do:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-12_with_2.6.37.x.diff /etc/ati/patch/patch-8.783-$(uname -r)
#> sh ati-driver-installer-10-10-x86.x86_64.run --buildpkg

* For '''Catalyst 10.11''' do:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-12_with_2.6.37.x.diff /etc/ati/patch/patch-8.791-$(uname -r)
#> sh ati-driver-installer-10-11-x86.x86_64.run --buildpkg

* For '''Catalyst 10.12''' do:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-12_with_2.6.37.x.diff /etc/ati/patch/patch-8.801-$(uname -r)
#> sh ati-driver-installer-10-12-x86.x86_64.run --buildpkg

= Known problems =
== error: implicit declaration of function 'lock_kernel' and error: implicit declaration of function 'unlock_kernel' ==
You need to enable the '''Big Kernel Lock''' in your kernel configuration. You find it under the '''Kernel hacking''' menu. You can check if this option is enable with:
$> zcat /proc/config.gz | grep BKL
CONFIG_BKL=y

== FATAL: modpost: GPL-incompatible module fglrx.ko uses GPL-only symbol 'paravirt_ops' ==
The error occurs during module compilation and It's due to the fact that the kernel was compiled with the option of paravirtualization active. This option among other things, prevents to load, and then to compile, modules that do not have the GPL license. Since that ATI drivers don't have this type of license, they aren't compiled.

To work around this problem you can:
==== Disable kernel paravirtualization option ====
The paravirtualization option is called '''CONFIG_PARAVIRT''' and generally is in the '''Processor type and features''' kernel submenu.
==== Patch ATI drivers ====
This operation is illegal because It changes the type of license issued by ATI in a GPL license. I wrote the patch:

[http://www.slacky.eu/~spina/fglrx/patch/ati_to_gpl.patch ati_to_gpl.patch] (md5sum: 4207f41a71035dc2eed3ea9346b881bb)

but I do not take any responsibility, I do not use It and I discourage the use in order to prefer the alternative to disable the paravirtualization kernel option. To use this patch You need to:

'''External SlackBuild'''
* Copy the patch in the ''/etc/ati/custom-package/patch'' directory

'''Internal SlackBuild''' (only with Ati Catalyst > 8.11):
* Copy the patch in the ''/etc/ati/patch'' directory (if it doesn't exist you must create it)

The SlackBuild will find and apply the patch automatically. In order to uninstall it you simply need to delete it. In order to uninstall the patch simply delete It from ''/etc/ati/custom-package/patch'' directory.

== Using GLX_SGIX_pbuffer FGLTexMgr: open of shared memory object failed (Permission denied) __FGLTexMgrCreateObject: __FGLTexMgrSHMmalloc failed!!! ==
This problem is due to the lack of SHM filesystem (now called tmpfs), that is virtual memory filesystem. To work around this problem you must:
* Add into ''/etc/fstab'' file the following line:
shm /dev/shm tmpfs defaults 0 0
* Then mount the filesystem through:
#> mount /dev/shm
Obviously the kernel must be predisposed for the "mounting" of this filesystem, in particular the
kernel option that must be enabled is '''CONFIG_TMPFS''' that is generally placed in '''File system --> Pseudo filesystems''' submenu. However all the compiled kernel generally have this option enabled.

== kernel includes at /lib/modules/`uname -r`/build/include do not match current kernel ==
The complete mistake is something like this:

Error:
kernel includes at /lib/modules/`uname -r`/build/include do not match current kernel.
they are versioned as ""
instead of "`uname -r`".
you might need to adjust your symlinks:
- /usr/include
- /usr/src/linux

The error, also if explained, could be not clear. In practice It results from the fact that the symbolic link:
/lib/modules/`uname -r`/source
/lib/modules/`uname -r`/build
don't point to the directory where are inserted the current kernel sources (which is generally ''/usr/src/linux- 'uname-r'''). It happens to those who use a kernel contained in Slackware, so I will try to explain It in terms of Slackware "packages". This can happen:
* because the kernel source were not installed. In this case should be enough to install the source package which can be found in Slackware k/ directory. However, It is not granted that the problem will be solved, You'll need to see the second reason why there is an error.
* because sources (also if installed) do not reflect the settings of the current kernel. The new Slackware 12 has some precompiled kernels (which means different settings), while just a single package for the sources (unless seeing the branch extra/). In particular, the sources are for the SMP kernel and so if you use a non-SMP kernel can appear this error. To avoid this, after making sure that the package source has been installed, do simply the following:
#> cd /usr/src/linux
#> cp /boot/config .config
#> make
:running make, in addition to compiling the kernel modules (which we will not use), some header files are regenerated, and they will reflect the kernel configuration (as it's set in the .config file).

== Driver 8.39.4 logo ==
This "bug" in 8.39.4 drivers results from the fact that ATI developers don't update the packager maintainers before the official releases. It should be nice first if they did test us official releases in order to certify the proper functioning of the scripts for creating packages. To solve the problem it's necessary to use the '''external SlackBuild''' as described here.

== amdcccle don't start on Slackware 12 ==
Many users of the X.Org 7.2 (or 1.3) server version fail to start properly the Catalyst. The command to run the Catalyst is:
#> amdcccle
For this problem it seems there is no solution yet, but we are working on to solve it.

= Useful links =
The discussion thread from which it was derived this article:
http://www.slacky.eu/forum/viewtopic.php?t=18134&highlight=

An alternative to official ATI drivers:
http://www.schneider-digital.de/

A wiki in italian about installing and configuring ATI drivers (open source and proprietary):
http://www.slacky.eu/wikislack/index.php?title=Installazione_driver_ATI_su_Slackware_GNU/Linux

= Conclusion =
Proprietary ATI drivers for many modern desktop and notebook PC seems are almost the only alternative to the use of 3d acceleration with linux. Unfortunately ATI developers don't make back porting and then users using drivers' version older than 8.37.6 will never go to X.Org server version 7.2 (alias 1.3) or later. Let's hope that Mesa drivers can also be used for these cards.

Also, It could happen that the module compilation fails. If so, feel free to write me at '''tomasiATcliDOTdiDOTunipiDOTit''' posting me the output generated by Only_Module option.

Thank you at Ezio Ghibaudo and Federico Rota who have started this wiki and for help with the SlackBuild.

Slackware: SlackBuild esterno (ITA)

2011-02-27T22:01:13Z

Spina: Replaced content with '{{Warning|Attenzione|Il wiki è stato spostato qui}} ~~~'

{{Warning|Attenzione|Il wiki è stato spostato [[Slackware:_ATI_SlackBuild_(ITA) | qui]]}}

[[User:Spina|Spina]]

Slackware: SlackBuild interno (ITA)

2011-02-27T22:00:40Z

Spina: moved Slackware: SlackBuild interno (ITA) to Slackware: ATI SlackBuild (ITA)

#REDIRECT [[Slackware: ATI SlackBuild (ITA)]]

Slackware: ATI SlackBuild (ITA)

2011-02-27T22:00:40Z

Spina: moved Slackware: SlackBuild interno (ITA) to Slackware: ATI SlackBuild (ITA)

= Introduzione =
Questo wiki spiega come installare i driver propritari ATI con la distribuzione linux Slackware, creando, grazie ad uno SlackBuild, dei
pacchetti che possono essere installati tramite il comando '''installpkg'''.

Il wiki NON spiega come migliorare le prestazioni. In particolare fornisce solo una descrizione minimale di come impostare il server X.Org
con l'unico scopo di far funzionare i driver proprietari (una descrizione su come configurare il server X.Org per ottenere prestazioni
più elevate la potete trovare [http://www.slacky.eu/wikislack/index.php?title=Installazione_driver_ATI_su_Slackware_GNU/Linux qui]).

Tutti i comandi che iniziano con un '#>' devono essere eseguiti con i diritti dell'utente root, mentre quello che iniziano con '$>' possono
essere eseguiti anche da un utente senza tali diritti.

= ATI Proprietary Driver e ATI Catalyst =
A partire dal 21 Novembre 2007 i driver ATI hanno cambiato nome e numero di versione. I nuovi driver, che prima venivano
indicati solo come '''ATI Proprietary Driver''', ora si chiamano '''ATI Catalyst'''. Non solo, il numero di versione
è passato da '''8.XX.X''' a '''7.XX'''.

Quando in questo articolo si parlerà dei driver ''versione < 8.37.6'', ci si riferirà implicitamente ai
vecchi driver, ovvero agli ATI Proprietary Driver, i nuovi ATI Catalyst sono da considerarsi ''versione >= 8.37.6'',
anche se, ad esempio, hanno come numero di release 7.11.

= Come ottenere tutto il software necessario =
I driver proprietari ATI possono essere scaricati dal sito ufficiale: http://ati.amd.com/support/driver.html, dopo aver selezionato il
sistema operativo Linux x86 (o Linux x86_64) e selezionato la propria scheda video, premendo il tasto "go" si arriva direttamente alla
pagina del download da cui bisognerà scaricare l'installer (che d'ora in poi chiameremo ''installer.run'').
Dato che i driver contengono anche un modulo del kernel che verrà compilato direttamente sul vostro sistema, è necessario
avere anche i sorgenti del kernel attualmente installato sul sistema.

{{Helpful Hint|Nota|I driver per le architetture x86 e x86_64 sono equivalenti. L'installer infatti contiene i file per entrambe le architetture, sarà poi il processo di compilazione e creazione dei pacchetti che sceglierà i file adeguati.
Questo vuol dire che lo SlackBuild andrà bene sia per la Slackware sia la Slackware64, sia per le varie versioni porting a 64 bit
(Slamd64, Bluewhite64, etc...).}}

{{Warning|Attenzione|Se la versione dei driver che si è scaricata è minore della 8.37.6 allora dovete sapere fin d'ora che non funzioneranno con il server X.Org 7.2 (o 1.3) o successivi.}}

= Come creare i pacchetti per la Slackware =
La creazione dei pacchetti segue due strade differenti a seconda che si usino i driver ufficiali '''versione < 8.37.6''' oppure
'''versione >= 8.37.6 o nuovi ATI Catalyst'''.
La prima strada fa uso di quello che chiameremo '''SlackBuild esterno''' mentre la seconda di quello che chiameremo
'''SlackBuild interno'''.
In entrambi i casi verranno creati due pacchetti che potranno quindi essere installati tramite l'utility '''installpkg''' della Slackware.
Quindi passiamo a vedere i due casi ricordando che il programma che qui chiamiamo ''installer.run'' è l'installer che si è
scaricato dal sito della ATI.

== Versione dei driver < 8.37.6 (SlackBuild esterno) ==
Per questi tipi di driver ho creato uno '''SlackBuild esterno''' per la Slackware di cui ho fatto [http://www.slacky.eu/~spina/fglrx/ati-slack-packager-1.1.9-noarch-1.tgz questo pacchetto].

Per creare i pacchetti Slackware basta eseguire:
#> installpkg ati-slack-packager-current-noarch-1.tgz
#> sh installer.run --buildpkg custom-package/Slackware

{{Useful Information|Nota|L'uso dello '''SlackBuild esterno''' è limitato alla versione dei '''driver < 8.37.6''' visto che dai nuovi ''' Catalyst 8.11''' si possono passare delle patch a quello interno.}}

== Versione dei driver >= 8.37.6 o nuovi ATI Catalyst (SlackBuild interno) ==
Per questi driver lo SlackBuild l'ho inviato direttamente alla ATI che ha provveduto ad inserirlo all'interno dell'installer, quindi basta
eseguire:
#> sh installer.run --buildpkg Slackware/All
o, se i driver sono abbastanza recenti (non ricordo la versione esatta), basta un semplice:
#> sh installer.run --buildpkg
Oppure, per creare ed installare direttamente i pacchetti, si può usare (sempre con versioni recenti dei driver):
#> sh intaller.run --buildandinstallpkg

= Cosa contengono i pacchetti creati? =
I due pacchetti creati dallo SlackBuild, che chiameremo ''fglrx-module'' e ''fglrx-x'', contengono, rispettivamente, il modulo per il
kernel attualmente installato sul sistema, e i driver per la versione del server X.Org installata.
In questo modo, se si aggiorna il kernel oppure il server X.Org si può creare solo il relativo pacchetto.

== Creare solo il pacchetto fglrx-module ==
Per creare solo il pacchetto contenente il modulo per il kernel attualmente installato, basta lanciare l'installer con l'opzione
''Only_Module ''.

Quindi, con lo '''SlackBuild esterno''':
#> sh installer.run --buildpkg custom-package/Only_Module
Con lo '''SlackBuild interno''':
#> sh installer.run --buildpkg Slackware/Only_Module

== Creare solo il pacchetto fglrx-x ==
Per creare solo il pacchetto contenente i driver per il server X.Org attualmente installato sul sistema, basta lanciare l'installer con
l'opzione ''Only_X''.

Con lo '''SlackBuild esterno''':
#> sh installer.run --buildpkg custom-package/Only_X
Con lo '''SlackBuild interno''':
#> sh installer.run --buildpkg Slackware/Only_X

= Configurazione minimale del server X.Org =
Una volta installati i due pacchetti bisogna segnalare al server X.Org di usare i driver proprietari ATI, per fare questo bisogna
controllare che il file xorg.conf, che generalmente è situato nella directory /etc/X11/, contenga le seguenti voci:

Section "Module"
....
Load "dri"
Load "glx"
....
EndSection

Section "Device"
....
Driver "fglrx"
....
EndSection

Section "DRI"
Group 0
Mode 0666
EndSection

= Verifica =
Per verificare se i driver proprietari ATI sono stati correttamente installati si può eseguire il comando:
$> fglrxinfo
Sulla mia macchina l'output è:
display: :0.0 screen: 0
OpenGL vendor string: ATI Technologies Inc.
OpenGL renderer string: ATI Mobility Radeon X1400
OpenGL version string: 2.0.6650 (8.39.4)

= Rimuovere i pacchetti installati =
Per rimuovere i pacchetti installati si può tranquillamente usare l'utility '''removepkg'''. Ci sono però aspetti che vanno
considerati:
* La rimozione dei pacchetti non elimina i file di configurazione del driver fglrx, questi file sono situati nella directory ''/etc/ati''
{{Be Careful|Occhio|La directory ''/etc/ati/custom-package'' se esiste, contiene lo '''SlackBuild esterno''' e quindi non va cancellata.}}
*Il pacchetto ''fglrx-x'' contiene le librerie OpenGL della ATI, e queste librerie sono posizionate nella stessa directory di quelle Mesa, indi per cui quando si installa il pacchetto ''fglrx-x'' vengono sovrascritte le OpenGL Mesa. Per ripristinare la situazione si deve semplicemente reinstallare il pacchetto contenente queste librerie, ovvero il pacchetto:
::x11
:si usa la Slackware 11, oppure:
::mesa
:se si usa la Slackware 12.

= Patchare i driver =
I driver ATI sono noti per essere sempre in ritardo rispetto all'aggiornamento del kernel linux. Spesso occorre quindi patchare i driver in modo tale che la creazione del modulo per il kernel abbia successo. A partire dagli ATI Catalist > 8.11 ho inserito nello '''SlackBuild interno''' la possibilità di patchare i driver ATI prima che lo SlackBuild stesso esegua la compilazione del modulo per il kernel.

Per fare questo basta creare (o scaricare da internet) una patch e dargli questo path:

''/etc/ati/patch/patch-ATI_DRIVER_VERSION-KERNEL_VERSION''

dove:

ATI_DRIVER_VERSION deve essere uguale al risultato del comando:
$> sh installer.run -i | head -n1 | cut -d'-' -f2
KERNEL_VERSION deve essere uguale al risultato del comando:
$> uname -r

se la directory ''/et/ati/patch'' non esiste, va ovviamente creata.

Quindi, ad esempio, se si il primo dei due comandi da come risultato '''8.56''' e il secondo '''2.6.27.6''', la patch va chiamata: ''/etc/ati/patch/patch-8.56-2.6.27.6''

Lo '''SlackBuild interno''' automaticamente noterà la patch, e, se si è in possesso del programma '''patch''', eseguirà:
#> patch -p0 < /etc/ati/patch/patch-8.56-2.6.27.6

== Alcune patch ==
Di seguito alcune patch note e come usarle:

=== ATI Catalyst 10.3, 10.4 e kernel == 2.6.33.x ===
Scaricate la [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.3-4_with_2.6.33.x.diff patch] nella directory ''/tmp'', quindi:

* Per i '''Catalyst 10.3''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.3-4_with_2.6.33.x.diff /etc/ati/patch/patch-8.712-$(uname -r)
#> sh ati-driver-installer-10-3-x86.x86_64.run --buildpkg

* Per i '''Catalyst 10.4''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.3-4_with_2.6.33.x.diff /etc/ati/patch/patch-8.723-$(uname -r)
#> sh ati-driver-installer-10-4-x86.x86_64.run --buildpkg

=== ATI Catalyst 10.4, 10.5 e kernel == 2.6.34 ===
Scaricate la [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.4-5_with_2.6.34.diff patch] nella directory ''/tmp'', quindi:

* Per i '''Catalyst 10.4''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.4-5_with_2.6.34.diff /etc/ati/patch/patch-8.723-$(uname -r)
#> sh ati-driver-installer-10-4-x86.x86_64.run --buildpkg

* Per i '''Catalyst 10.5''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.4-5_with_2.6.34.diff /etc/ati/patch/patch-8.732-$(uname -r)
#> sh ati-driver-installer-10-4-x86.x86_64.run --buildpkg

=== ATI Catalyst 10.9 e Slackware64 13.1 o current ===
Scaricate la [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.9_with_Slackware64-13.1.diff patch] nella directory ''/tmp'', quindi fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.9_with_Slackware64-13.1.diff /etc/ati/patch/patch-8.771-$(uname -r)
#> sh ati-driver-installer-10-9-x86.x86_64.run --buildpkg
ad un certo punto l'installazione chiede:
<PRE>
can't find file to patch at input line 4
Perhaps you should have used the -p or --strip option?
The text leading up to this was:
--------------------------
|diff -ru ./2.6.x/Makefile ../../../../../../fglrx-install.uZLF8t/common/lib/modules/fglrx/build_mod//2.6.x/Makefile
|--- ./2.6.x/Makefile 2010-09-01 16:05:31.000000000 +0200
|+++ ../../../../../../fglrx-install.uZLF8t/common/lib/modules/fglrx/build_mod//2.6.x/Makefile 2010-09-23 08:47:24.000000000 +0200
--------------------------
File to patch:
</PRE>
quindi inserire:
./2.6.x/Makefile

=== ATI Catalyst 10.10, 10.11 e kernel == 2.6.36.x ===
Scaricate la [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.10-11_with_2.6.36.x.diff patch] nella directory ''/tmp'', quindi:
* Per i '''Catalyst 10.10''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-11_with_2.6.36.x.diff /etc/ati/patch/patch-8.783-$(uname -r)
#> sh ati-driver-installer-10-10-x86.x86_64.run --buildpkg

* Per i '''Catalyst 10.11''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-11_with_2.6.36.x.diff /etc/ati/patch/patch-8.791-$(uname -r)
#> sh ati-driver-installer-10-11-x86.x86_64.run --buildpkg

=== ATI Catalyst 10.10, 10.11 e 10.12 e kernel == 2.6.37.x ===
Scaricate la [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.10-12_with_2.6.37.x.diff patch] nella directory ''/tmp'', quindi:
* Per i '''Catalyst 10.10''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-12_with_2.6.37.x.diff /etc/ati/patch/patch-8.783-$(uname -r)
#> sh ati-driver-installer-10-10-x86.x86_64.run --buildpkg

* Per i '''Catalyst 10.11''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-12_with_2.6.37.x.diff /etc/ati/patch/patch-8.791-$(uname -r)
#> sh ati-driver-installer-10-11-x86.x86_64.run --buildpkg

* Per i '''Catalyst 10.12''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-12_with_2.6.37.x.diff /etc/ati/patch/patch-8.801-$(uname -r)
#> sh ati-driver-installer-10-12-x86.x86_64.run --buildpkg

= Problemi noti =
== error: implicit declaration of function 'lock_kernel' and error: implicit declaration of function 'unlock_kernel' ==
Dovete abilitare l'opzione '''Big Kernel Lock''' nella vostra configurazione del kernel. La voce si trova nel menù '''Kernel hacking'''. Per controllare se questa opzione è abilitata potete fare:
$> zcat /proc/config.gz | grep BKL
CONFIG_BKL=y

== FATAL: modpost: GPL-incompatible module fglrx.ko uses GPL-only symbol 'paravirt_ops' ==
L'errore accade in fase di compilazione del modulo ed è dovuto al fatto che il kernel è stato compilato con l'opzione di
paravirtualizzazione attiva. Questa opzione tra le altre cose, impedisce di caricare, e quindi di compilare, moduli che non hanno la
licenza GPL. Visto che i driver ATI non hanno questo tipo di licenza, non vengono compilati.

Per ovviare al problema si può:
=== Disabilitare la paravirtualizzazione nel kernel ===
L'opzione di paravirtualizzazione si chiama '''CONFIG_PARAVIRT''' e generalmente si trova nel sottomenù '''Processor type and features''' del kernel.
=== Patchare i driver ATI ===
Questa operazione è illegale poichè si deve modificare il tipo di licenza rilasciata dalla ATI in GPL. Ho scritto la patch:

[http://www.slacky.eu/~spina/fglrx/patch/ati_to_gpl.patch ati_to_gpl.patch] (md5sum: 4207f41a71035dc2eed3ea9346b881bb)

di cui non mi prendo nessuna responsabilità, io non la uso e ne sconsiglio l'uso preferendo l'alternativa di disabilitare la paravirtualizzazione del kernel.
Per usare questa patch bisogna:

'''SlackBuild esterno''':
* Copiare la patch nella directory ''/etc/ati/custom-package/patch''

'''SlackBuild interno''' (solo con ATI Catalist > 8.11):
* Copiare la patch nella directory ''/etc/ati/patch'' (se non esiste, va creata)

Lo SlackBuild noterà la presenza della patch e la applicherà. Per disinstallare la patch basterà quindi cancellarla.

== Using GLX_SGIX_pbuffer FGLTexMgr: open of shared memory object failed (Permission denied) __FGLTexMgrCreateObject: __FGLTexMgrSHMmalloc failed!!! ==
Questo problema è dovuto alla mancanza nel sistema del filesystem SHM (oggi chiamato tmpfs), ovvero il virtual memory filesystem.
Per ovviare al problema si deve:
* Aggiungere al file ''/etc/fstab'' la seguente riga:
shm /dev/shm tmpfs defaults 0 0
* Quindi montare il filesystem tramite:
#> mount /dev/shm
Ovviamente il kernel deve essero predisposto al "montaggio" di questo filesystem, in particolare l'opzione del kernel che deve essere
abilitata è '''CONFIG_TMPFS''' che generalmente è sistuata nel sottomenù del kernel '''File systems --> Pseudo filesystems'''. C'è da dire però che tutti i kernel precompilati hanno generalmente questa opzione abilitata.

== kernel includes at /lib/modules/`uname -r`/build/include do not match current kernel ==
L'errore completo è qualcosa del genere:

Error:
kernel includes at /lib/modules/`uname -r`/build/include do not match current kernel.
they are versioned as ""
instead of "`uname -r`".
you might need to adjust your symlinks:
- /usr/include
- /usr/src/linux

L'errore, se pur spiegato può non essere chiaro. In pratica deriva dal fatto che i link simbolici:
/lib/modules/`uname -r`/source
/lib/modules/`uname -r`/build
non puntano alla directory in cui sono inseriti i sorgenti del kernel attuale (che generalmente è /usr/src/linux-`uname -r`). Accade a coloro che usano uno dei kernel contenuto nella Slackware, per cui cercherò di spiegarlo in termini di "pacchetti" Slackware. Questo può succedere:
* O perchè i sorgenti del kernel effettivamente non sono stati installati. In questo caso dovrebbe bastare installare il pacchetto dei sorgenti che si trova nella directory k/ della Slackware. Non è detto però che il problema venga risolto, si veda il secondo motivo per cui sussiste l'errore.
* O perchè i sorgenti (se pur installati) non rispecchiano le impostazioni dell'attuale kernel. La nuova Slackware 12 ha al suo interno un pò di kernel precompilati (che vuol dire impostazioni differenti) mentre un solo pacchetto per i sorgenti (a meno di vedere nel ramo extra/). In particolare i sorgenti sono per un kernel SMP e quindi se si utilizza un kernel precompilato non SMP può accare che si verifichi l'errore suddetto. Per ovviare basta fare quanto segue, dopo essersi assicurati che il pacchetto dei sorgenti è stato installato:
#> cd /usr/src/linux
#> cp /boot/config .config
#> make
:eseguendo il make, oltre a compilare il kernel e relativi moduli (che poi non useremo), si rigenerano alcuni file headers che rispecchiano la configurazione del kernel (per come impostata nel file .config).

== Logo nei driver 8.39.4 ==
Questo "bug" nei driver 8.39.4 deriva dal fatto che gli sviluppatori ATI non aggiornano i packager mantainer prima della release ufficiale. Sarebbe carino se facessero testare prima a noi le release ufficiali, in modo da certificare il corretto funzionamento degli script per creare i pacchetti. Per risolvere il problema si deve usare lo '''SlackBuild esterno''' come descritto [[#Versione dei driver < 8.37.6 (SlackBuild esterno) | qui]].

== amdcccle non parte con la Slackware 12 ==
Molti utenti che utilizzano la versione del server X.Org 7.2 (o 1.3) non riescono a lanciare correttamente il Catalyst. Il comando per eseguire il Catalyst è:
#> amdcccle
Per questo problema sembra non esserci ancora soluzione, ma stiamo lavorando per risolverlo.

= Link utili =
Il thread di discussione da cui è stato tratto questo articolo:
http://www.slacky.eu/forum/viewtopic.php?t=18134&highlight=

Un alternativa ai driver ufficiali ATI:
http://www.schneider-digital.de/

Una guida su come installare e configurare i driver (open source e proprietary) ATI:
http://www.slacky.eu/wikislack/index.php?title=Installazione_driver_ATI_su_Slackware_GNU/Linux

= Conclusione =
I driver proprietari ATI per molti notebook e moderni PC fissi risultano essere quasi l'unica alternativa per l'uso dell'accelerazione 3d con linux. Purtroppo gli sviluppatori ATI non effettuano il back porting e quindi gli utenti che fanno uso dei driver precedenti alla versione 8.37.6 non potranno mai passare alla versione 7.2 (o anche detto 1.3) o successive del server X.Org. Si spera quindi che ben presto i driver Mesa possano essere usati anche per queste schede video.

Inoltre, può succedere che la compilazione del modulo non abbia successo. Se è il vostro caso, scrivetemi tranquillamente all'indirizzo '''tomasiATcliDOTdiDOTunipiDOTit''' postandomi l'output dell'installer lanciato con l'opzione ''Only_Module''.

Ringrazio Ezio Ghibaudo e Federico Rota per aver iniziato questo wiki e per l'aiuto che mi hanno dato con lo SlackBuild.

Slackware

2011-02-27T21:55:37Z

Spina: Removed link for external SlackBuild

*[[Slackware: internal SlackBuild (ENG)|ATI SlackBuild (ENG)]]
*[[Slackware: SlackBuild interno (ITA)|ATI SlackBuild (ITA)]]

{{VCT}}

Template:Useful Information

2011-02-27T19:35:39Z

Spina:

{| WIDTH="100%" cellpadding="0" cellspacing="5" style="background-color: #E0EFFF; border: solid 1px #9EB6D4; -moz-border-radius: 5px"
|'''{{{1}}}:'''
|-
|{{{2}}}
|}

Template:Helpful Hint

2011-02-27T19:34:42Z

Spina:

{| WIDTH="100%" cellpadding="0" cellspacing="5" style="background-color: #DDFADE; border: solid 1px #9EC49F; -moz-border-radius: 5px"
|'''{{{1}}}:'''
|-
|{{{2}}}
|}

Template:Be Careful

2011-02-27T19:33:44Z

Spina:

{| WIDTH="100%" cellpadding="0" cellspacing="5" style="background-color: #FFFFDD; border: solid 1px #F7DF92; -moz-border-radius: 5px"
|'''{{{1}}}:'''
|-
|{{{2}}}
|}

Template:Warning

2011-02-27T19:32:33Z

Spina:

{| WIDTH="100%" cellpadding="0" cellspacing="5" style="background-color: #FFE7E7; border: solid 1px #DF9898; -moz-border-radius: 5px"
|'''{{{1}}}:'''
|-
|{{{2}}}
|}

Slackware: external SlackBuild (ENG)

2011-02-27T19:29:50Z

Spina: Used templates Warning.

== What it does ==
Starting with version 8.37.6, ATI proprietary drivers are able to create Slackware packages through an internal SlackBuild. To use this SlackBuild just run the driver's installer, the .run file that is possible to download from [http://ati.amd.com/support/driver.html ATI's official website], with the option:
--buildpkg Slackware/All
The page you're visiting is about the “twin” version of SlackBuild, which in the [http://www.slacky.eu/wikislack/index.php?title=ATI_Proprietary_drivers._Ecco_uno_slackbuild. official wiki (ITA)] is called '''external SlackBuild'''.

This SlackBuild deals with building Slackware packages of the ATI proprietary drivers, both versions before 8.37.6, in which the internal SlackBuild does not exist, and next versions, working just like internal SlackBuild, with the advantage that it is usually more powerful than his “brother”. In fact, many patches to drivers are discovered only after the official release, this means that the internal SlackBuild may not apply them while the external, which is updated very often and whenever is needed, can do that.

{{Warning|Warning|Since Catalyst 8.11 the '''external SlackBuild''' is't deprecated in favor to patch for '''internal SlackBuild'''.}}

== How it works ==
The use of the external SlackBuild is very easy, once downloaded and installed using the '''installpkg''' utility, simply run the ATI's installer driver with the following option:
--buildpkg custom-package/All
What happens is exactly the same as the internal SlackBuild, and It's described in the
[http://www.slacky.eu/wikislack/index.php?title=ATI_Proprietary_drivers._Ecco_uno_slackbuild. official wiki (ITA)].

== News ==
Currently the external SlackBuild is able to create Slackware packages for driver version <8.37.6 applying the patch for the new kernel series 2.6.2x. The ATI drivers version <8.37.6 weren't designed to run on these kernel and therefore they require a small patch that is applied by external SlackBuild.

* 16/01/08: added new mantainers' names, Ezio and Federico (See [[ATI Slack-Packager (ENG)#Contacts|Contacts]])
* 12/01/08: file ''amdpcsdb.default'' inserted in ''/etc/ati'', file needed for next driver version.
* 21/11/07: Small update to reflect the next official driver version.
* 03/08/07: Small update to reflect the next official driver version. ''/etc/ati/fglrxprofiles.csv'' and ''/etc/ati/fglrxrc'' are no longer distributed.
* 28/07/07:
** Fixed permissions in the fglrx driver configuration file, in ''/etc/ati'' directory. In addition, some files in this directory are considered administrator's “personal” configuration, and for these files has been created a .new file, which is created only if the original (the one without .new extension) does not exist. If the source exists and is equal to .new, the .new file is removed to avoid redundancy.
** The README file is moved from ''/etc/ati'' to ''/etc/ati/custom-package''.
* 27/07/07: Fixed bug in driver version 8.39.4 showing a logo in the bottom right corner of the screen.
* 07/09/07:
** Added links to libraries like .so.
** Based on users' reports, I have applied a driver patch in order to cancel the “error”:
make.sh: line xxx: [: =: unary operator expected
: when It compiles the fglrx kernel module (which is part of the fglrx-module package). I would like to underline that “bugs” isn't in SlackBuild, but into ATI's drivers. I submitted the bug to ATI also sending the small patches to solve it, but... I'm waiting yet :).

== Download ==
The latest SlackBuild version released is [http://www.slacky.eu/~spina/fglrx/ati-slack-packager-1.1.9-noarch-1.tgz 1.1.9].

== Patch ==
Here are some patches that can be applied to the external SlackBuild, these patches are considered illegal and therefore are not issued in the official version. I do not take any responsibility about the use of these patches, I have written them only for culture and put online for the same reason, I do not use them and I discourage their use.
To apply the patch just copy them in ''/etc/ati/custom-package/patch'' directory, while in order to uninstall them just remove them.

* [http://www.slacky.eu/~spina/fglrx/patch/ati_to_gpl.patch ati_to_gpl.patch].This patch modifies the ATI drivers in order to have a GPL license so to be able to use drivers with a kernel that has the para virtualization active. The preferable alternative is to disable the kernel para virtualization as explained [http://www.slacky.eu/wikislack/index.php?title=ATI_Proprietary_drivers._Ecco_uno_slackbuild.#Disabilitare_la_paravirtualizzazione_nel_kernel here (ITA)].

== Acknowledgments ==
I would like to thank all the [http://www.slacky.eu/ Italian Slackware Community] users for their feedback and support, especially (in alphabetical order, not certainly for importance):
* Ezio (alias ekxius),author, of an interesting [http://www.slacky.eu/wikislack/index.php?title=Installazione_driver_ATI_su_Slackware_GNU/Linux wiki (ITA)] about installation and configuration of ATI drivers (open and proprietary).
* Federico (alias stan), always ready to give me advice and letting me believe more and more on the importance of the project.

== Contacts ==
Original author:

Emanuele Tomasi < tomasiATcliDOTdiDOTunipiDOTit >

Slackware: SlackBuild esterno (ITA)

2011-02-27T19:28:37Z

Spina: Usati il template Warning

== Cosa fa ==
A partire dalla versione 8.37.6, i driver proprietari ATI hanno la possibilità di creare dei pacchetti Slackware grazie ad uno SlackBuild interno. Per usare questo SlackBuild basta lanciare l'installer dei driver, il file .run che è possibile scaricarare dal [http://ati.amd.com/support/driver.html sito ufficiale ATI], tramite l'opzione:
--buildpkg Slackware/All
La pagina che state visitando parla della versione “gemella” dello SlackBuild interno, che nel [http://www.slacky.eu/wikislack/index.php?title=ATI_Proprietary_drivers._Ecco_uno_slackbuild. wiki] ufficiale viene chiamato '''SlackBuild esterno'''.

Questo SlackBuild si occupa di creare dei pacchetti Slackware dei driver proprietari ATI, sia per le versioni precedenti alla 8.37.6, nei quali lo SlackBuild interno non esiste, sia per le versioni successive, agendo esattamente come lo SlackBuild interno, con il vantaggio che generalmente è più potente del “fratello”. Infatti molte patch ai driver vengono scoperte solo dopo il rilascio della versione ufficiale, questo vuol dire che lo SlackBuild interno non può applicarle mentre quello esterno, che viene aggiornato con molta frequenza ed ogni volta che ce ne è bisogno, può.

{{Warning|Attenzione|A partire dai Catalyst 8.11 lo '''SlackBuild esterno''' è stato deprecato in favore delle patch per lo '''SlackBuild interno'''.}}

== Come si usa ==
L'uso dello SlackBuild esterno è molto semplice, una volta scaricato ed installato tramite l'utility '''installpkg''', basta lanciare l'installer dei driver ATI con la seguente opzione:
--buildpkg custom-package/All
Quello che accade è esattamente quello che accade con lo SlackBuild interno, e viene descritto nel
[http://www.slacky.eu/wikislack/index.php?title=ATI_Proprietary_drivers._Ecco_uno_slackbuild. wiki] ufficiale.

== Novità ==
Attualmente lo SlackBuild esterno è in grado di creare i pacchetti Slackware dei driver versione < 8.37.6 applicando la patch per il nuovo kernel della serie 2.6.2x. I driver ATI versione < 8.37.6 non erano stati concepiti per girare con questi kernel e quindi necessitano di una piccola patch che viene applicata dallo SlackBuild esterno.

* 16/01/08: Aggiunto il nome dei nuovi maintainer, Ezio e Federico (si veda [[ATI Slack-Packager (ITA)#Contatti|Contatti]])
* 12/01/08: Viene inserito nella directory ''/etc/ati'', il file ''amdpcsdb.default'', necessario per la prossima versione dei driver.
* 21/11/07: Piccolo aggiornamento per rispecchiare la prossima versione ufficiale dei driver.
* 03/08/07: Piccolo aggiornamento per rispecchiare la prossima versione ufficiale dei driver. I file ''/etc/ati/fglrxprofiles.csv'' e ''/etc/ati/fglrxrc'' non sono più distribuiti.
* 28/07/07:
** Aggiustato i permessi nei file di configurazione del driver fglrx nella directory ''/etc/ati''. Inoltre alcuni file nella stessa directory sono considerati di configurazione “personale” dell'amministratore, per questi file è stato creato un nuovo file .new che viene installato solo se l'originale (quello senza il .new) non esiste. Se l'originale esiste ed è uguale al .new, il .new viene rimosso per evitate la ridondanza.
** Il file README è stato spostato, dalla directory ''/etc/ati'' nella directory ''/etc/ati/custom-package''.
* 27/07/07: Corretto il “bug” della versione 8.39.4 dei driver che mostra un logo nella parte inferiore destra dello schermo.
* 07/09/07:
** Aggiunti i link alle librerie come .so.
** Su segnalazione di molti utenti ho applicato una patch ai driver in modo da eliminare l'“errore”:
make.sh: line xxx: [: =: unary operator expected
:quando viene compilato il modulo per il kernel fglrx (che fa parte del pacchetto fglrx-module). Tengo a precisare che il “bug” non è nello SlackBuild, ma nei driver ATI. Ho segnalato il “bug” alla ATI inviando anche la piccola patch per risolverlo ma...aspetto ancora :).

== Download ==
L'ultima versione dello SlackBuild esterno è la [http://www.slacky.eu/~spina/fglrx/ati-slack-packager-1.1.9-noarch-1.tgz 1.1.9]

== Patch ==
Di seguito ci sono alcune patch che si possono applicare allo SlackBuild esterno, queste patch sono ritenute illegali e pertanto non vengono rilasciate nella versione ufficiale. Non mi prendo nessuna responsabilità sull'uso di queste patch, le ho scritte solo per cultura e le metto online per lo stesso motivo, non le uso e ne sconsiglio l'uso.
Per applicare le patch basta copiarle nella directory ''/etc/ati/custom-package/patch'', mentre per disinstallarle basta rimuoverle.

* [http://www.slacky.eu/~spina/fglrx/patch/ati_to_gpl.patch ati_to_gpl.patch].Questa patch modifica i driver ATI in modo che presentino una licenza GPL cossicché da poter usare i driver con un kernel che ha la paravirtualizzazione attiva. L'alternativa preferibile è di disabilitare la paravirtualizzazione del kernel come spiegato [http://www.slacky.eu/wikislack/index.php?title=ATI_Proprietary_drivers._Ecco_uno_slackbuild.#Disabilitare_la_paravirtualizzazione_nel_kernel qui].

== Ringraziamenti ==
Ringrazio tutti gli utenti dell' [http://www.slacky.eu/ Italian Slackware Community] per il loro feedback e il loro appoggio morale, in particolare ringrazio (in ordine alfabetico, non certo per importanza):
* Ezio (alias ekxius), autore, tra l'altro di un interessante [http://www.slacky.eu/wikislack/index.php?title=Installazione_driver_ATI_su_Slackware_GNU/Linux wiki] sull'installazione e configurazione dei driver ATI (open e proprietari).
* Federico (alias stan), che è sempre pronto a darmi consigli facendomi credere sempre di più nell'importanza del progetto.

== Contatti ==
Autore originale:

Emanuele Tomasi < tomasiATcliDOTdiDOTunipiDOTit >

Slackware: ATI SlackBuild (ENG)

2011-02-27T19:25:51Z

Spina: Used templates Useful_Information, Helpful_Hint, Warning, Be Careful.

Slackware: ATI SlackBuild (ITA)

2011-02-27T19:20:34Z

Spina: Usati i template Useful_Information, Helpful_Hint, Warning, Be Careful.

Template:Be Careful

2011-02-27T19:06:59Z

Spina: Created page with '{| WIDTH="100%" cellpadding="0" cellspacing="5" style="background-color: #FFFFDD; border: solid 1px #F7DF92; -moz-border-radius: 5px" |'''{{{1}}}:'''</font…'

{| WIDTH="100%" cellpadding="0" cellspacing="5" style="background-color: #FFFFDD; border: solid 1px #F7DF92; -moz-border-radius: 5px"
|'''{{{1}}}:'''
|-
|{{{2}}}
|}

Template:Warning

2011-02-27T19:05:03Z

Spina: Created page with '{| WIDTH="100%" cellpadding="0" cellspacing="5" style="background-color: #FFE7E7; border: solid 1px #DF9898; -moz-border-radius: 5px" |'''{{{1}}}:'''</font…'

{| WIDTH="100%" cellpadding="0" cellspacing="5" style="background-color: #FFE7E7; border: solid 1px #DF9898; -moz-border-radius: 5px"
|'''{{{1}}}:'''
|-
|{{{2}}}
|}

Template:Useful Information

2011-02-27T19:03:31Z

Spina: Created page with '{| WIDTH="100%" cellpadding="0" cellspacing="5" style="background-color: #E0EFFF; border: solid 1px #9EB6D4; -moz-border-radius: 5px" |'''{{{1}}}:'''</font…'

{| WIDTH="100%" cellpadding="0" cellspacing="5" style="background-color: #E0EFFF; border: solid 1px #9EB6D4; -moz-border-radius: 5px"
|'''{{{1}}}:'''
|-
|{{{2}}}
|}

Template:Note

2011-02-27T19:00:26Z

Spina: moved Template:Note to Template:Helpful Hint

#REDIRECT [[Template:Helpful Hint]]

Template:Helpful Hint

2011-02-27T19:00:26Z

Spina: moved Template:Note to Template:Helpful Hint

{| WIDTH="100%" cellpadding="0" cellspacing="5" style="background-color: #DDFADE; border: solid 1px #9EC49F; -moz-border-radius: 5px"
|'''{{{1}}}:'''
|-
|{{{2}}}
|}

Template:Helpful Hint

2011-02-27T18:59:13Z

Spina:

{| WIDTH="100%" cellpadding="0" cellspacing="5" style="background-color: #DDFADE; border: solid 1px #9EC49F; -moz-border-radius: 5px"
|'''{{{1}}}:'''
|-
|{{{2}}}
|}

Template:Helpful Hint

2011-02-27T18:50:19Z

Spina:

{| WIDTH="100%" cellpadding="0" cellspacing="5" style="background-color: #DDFADE; border: solid 1px #9EC49F;"
|'''{{{1}}}:'''
|-
|{{{2}}}
|}

Template:Helpful Hint

2011-02-27T18:48:01Z

Spina:

{| WIDTH="100%" cellpadding="0" cellspacing="5" style="background-color: #DDFADE; border: solid 1px #9EC49F;"
|'''{{{1}}}'''
|-
|{{{2}}}
|}

Template:Helpful Hint

2011-02-27T18:44:42Z

Spina:

{| WIDTH="100%" cellpadding=0 cellspacing=0 style="background-color: #DDFADE; border: solid 1px #9EC49F;"
|'''{{{1}}}'''
|-
|
{{{2}}}
|}

Template:Helpful Hint

2011-02-27T18:42:06Z

Spina: Created page with '{| WIDTH="75%" cellpadding=0 cellspacing=0 style="background-color: #DDFADE; border: solid 1px #9EC49F;" |'''{{{1}}}''' |- | {{{2}}} |}'

{| WIDTH="75%" cellpadding=0 cellspacing=0 style="background-color: #DDFADE; border: solid 1px #9EC49F;"
|'''{{{1}}}'''
|-
|
{{{2}}}
|}

Slackware: ATI SlackBuild (ITA)

2011-01-11T16:56:03Z

Spina: /* error: implicit declaration of function 'lock_kernel' and error: implicit declaration of function 'unlock_kernel' */

= Introduzione =
Questo wiki spiega come installare i driver propritari ATI con la distribuzione linux Slackware, creando, grazie ad uno SlackBuild, dei
pacchetti che possono essere installati tramite il comando '''installpkg'''.

Il wiki NON spiega come migliorare le prestazioni. In particolare fornisce solo una descrizione minimale di come impostare il server X.Org
con l'unico scopo di far funzionare i driver proprietari (una descrizione su come configurare il server X.Org per ottenere prestazioni
più elevate la potete trovare [http://www.slacky.eu/wikislack/index.php?title=Installazione_driver_ATI_su_Slackware_GNU/Linux qui]).

Tutti i comandi che iniziano con un '#>' devono essere eseguiti con i diritti dell'utente root, mentre quello che iniziano con '$>' possono
essere eseguiti anche da un utente senza tali diritti.

= ATI Proprietary Driver e ATI Catalyst =
A partire dal 21 Novembre 2007 i driver ATI hanno cambiato nome e numero di versione. I nuovi driver, che prima venivano
indicati solo come '''ATI Proprietary Driver''', ora si chiamano '''ATI Catalyst'''. Non solo, il numero di versione
è passato da '''8.XX.X''' a '''7.XX'''.

Quando in questo articolo si parlerà dei driver ''versione < 8.37.6'', ci si riferirà implicitamente ai
vecchi driver, ovvero agli ATI Proprietary Driver, i nuovi ATI Catalyst sono da considerarsi ''versione >= 8.37.6'',
anche se, ad esempio, hanno come numero di release 7.11.

= Come ottenere tutto il software necessario =
I driver proprietari ATI possono essere scaricati dal sito ufficiale: http://ati.amd.com/support/driver.html, dopo aver selezionato il
sistema operativo Linux x86 (o Linux x86_64) e selezionato la propria scheda video, premendo il tasto "go" si arriva direttamente alla
pagina del download da cui bisognerà scaricare l'installer (che d'ora in poi chiameremo ''installer.run'').
Dato che i driver contengono anche un modulo del kernel che verrà compilato direttamente sul vostro sistema, è necessario
avere anche i sorgenti del kernel attualmente installato sul sistema.

'''NOTA:''' I driver per le architetture x86 e x86_64 sono equivalenti. L'installer infatti contiene i file per entrambe
le architetture, sarà poi il processo di compilazione e creazione dei pacchetti che sceglierà i file adeguati.
Questo vuol dire che lo SlackBuild andrà bene sia per la Slackware sia la Slackware64, sia per le varie versioni porting a 64 bit
(Slamd64, Bluewhite64, etc...).

= Nota IMPORTANTE =
Se la versione dei driver che si è scaricata è minore della 8.37.6 allora dovete sapere fin d'ora che non funzioneranno con
il server X.Org 7.2 (o 1.3) o successivi.

= Come creare i pacchetti per la Slackware =
La creazione dei pacchetti segue due strade differenti a seconda che si usino i driver ufficiali '''versione < 8.37.6''' oppure
'''versione >= 8.37.6 o nuovi ATI Catalyst'''.
La prima strada fa uso di quello che chiameremo '''SlackBuild esterno''' mentre la seconda di quello che chiameremo
'''SlackBuild interno'''.
In entrambi i casi verranno creati due pacchetti che potranno quindi essere installati tramite l'utiliti '''installpkg''' della Slackware.
Quindi passiamo a vedere i due casi ricordando che il programma che qui chiamiamo ''installer.run'' è l'installer che si è
scaricato dal sito della ATI.

== Versione dei driver < 8.37.6 (SlackBuild esterno) ==
Per questi tipi di driver ho creato uno '''SlackBuild esterno''' per la Slackware di cui ho fatto [http://www.slacky.eu/~spina/fglrx/ati-slack-packager-1.1.9-noarch-1.tgz questo pacchetto].

Per creare i pacchetti Slackware basta eseguire:
#> installpkg ati-slack-packager-current-noarch-1.tgz
#> sh installer.run --buildpkg custom-package/Slackware

'''NOTA:''' L'uso dello '''SlackBuild esterno''' è limitato alla versione dei '''driver < 8.37.6''' visto che dai nuovi ''' Catalyst 8.11''' si possono passare delle patch a quello interno.

== Versione dei driver >= 8.37.6 o nuovi ATI Catalyst (SlackBuild interno) ==
Per questi driver lo SlackBuild l'ho inviato direttamente alla ATI che ha provveduto ad inserirlo all'interno dell'installer, quindi basta
eseguire:
#> sh installer.run --buildpkg Slackware/All
o, se i driver sono abbastanza recenti (non ricordo la versione esatta), basta un semplice:
#> sh installer.run --buildpkg
Oppure, per creare ed installare direttamente i pacchetti, si può usare (sempre con versioni recenti dei driver):
#> sh intaller.run --buildandinstallpkg

= Cosa contengono i pacchetti creati? =
I due pacchetti creati dallo SlackBuild, che chiameremo ''fglrx-module'' e ''fglrx-x'', contengono, rispettivamente, il modulo per il
kernel attualmente installato sul sistema, e i driver per la versione del server X.Org installata.
In questo modo, se si aggiorna il kernel oppure il server X.Org si può creare solo il relativo pacchetto.

== Creare solo il pacchetto fglrx-module ==
Per creare solo il pacchetto contenente il modulo per il kernel attualmente installato, basta lanciare l'installer con l'opzione
''Only_Module ''.

Quindi, con lo '''SlackBuild esterno''':
#> sh installer.run --buildpkg custom-package/Only_Module
Con lo '''SlackBuild interno''':
#> sh installer.run --buildpkg Slackware/Only_Module

== Creare solo il pacchetto fglrx-x ==
Per creare solo il pacchetto contenente i driver per il server X.Org attualmente installato sul sistema, basta lanciare l'installer con
l'opzione ''Only_X''.

Con lo '''SlackBuild esterno''':
#> sh installer.run --buildpkg custom-package/Only_X
Con lo '''SlackBuild interno''':
#> sh installer.run --buildpkg Slackware/Only_X

= Configurazione minimale del server X.Org =
Una volta installati i due pacchetti bisogna segnalare al server X.Org di usare i driver proprietari ATI, per fare questo bisogna
controllare che il file xorg.conf, che generalmente è situato nella directory /etc/X11/, contenga le seguenti voci:

Section "Module"
....
Load "dri"
Load "glx"
....
EndSection

Section "Device"
....
Driver "fglrx"
....
EndSection

Section "DRI"
Group 0
Mode 0666
EndSection

= Verifica =
Per verificare se i driver proprietari ATI sono stati correttamente installati si può eseguire il comando:
$> fglrxinfo
Sulla mia macchina l'output è:
display: :0.0 screen: 0
OpenGL vendor string: ATI Technologies Inc.
OpenGL renderer string: ATI Mobility Radeon X1400
OpenGL version string: 2.0.6650 (8.39.4)

= Rimuovere i pacchetti installati =
Per rimuovere i pacchetti installati si può tranquillamente usare l'utiliti '''removepkg'''. Ci sono però aspetti che vanno
considerati:
* La rimozione dei pacchetti non elimina i file di configurazione del driver fglrx, questi file sono situati nella directory ''/etc/ati''
'''NOTA:''' La directory ''/etc/ati/custom-package'' se esiste, contiene lo '''SlackBuild esterno''' e quindi non va cancellata.
*Il pacchetto ''fglrx-x'' contiene le librerie OpenGL della ATI, e queste librerie sono posizionate nella stessa directory di quelle Mesa, indi per cui quando si installa il pacchetto ''fglrx-x'' vengono sovrascritte le OpenGL Mesa. Per ripristinare la situazione si deve semplicemente reinstallare il pacchetto contenente queste librerie, ovvero il pacchetto:
::x11
:si usa la Slackware 11, oppure:
::mesa
:se si usa la Slackware 12.

= Patchare i driver =
I driver ATI sono noti per essere sempre in ritardo rispetto all'aggiornamento del kernel linux. Spesso occorre quindi patchare i driver in modo tale che la creazione del modulo per il kernel abbia successo. A partire dagli ATI Catalist > 8.11 abbiamo inserito nello '''SlackBuild interno''' la possibilità di patchare i driver ATI prima che lo SlackBuild stesso esegua la compilazione del modulo per il kernel.

Per fare questo basta creare (o scaricare da internet) una patch e dargli questo path:

''/etc/ati/patch/patch-ATI_DRIVER_VERSION-KERNEL_VERSION''

dove:

ATI_DRIVER_VERSION deve essere uguale al risultato del comando:
$> sh installer.run -i | head -n1 | cut -d'-' -f2
KERNEL_VERSION deve essere uguale al risultato del comando:
$> uname -r

se la directory ''/et/ati/patch'' non esiste, va ovviamente creata.

Quindi, ad esempio, se si il primo dei due comandi da come risultato '''8.56''' e il secondo '''2.6.27.6''', la patch va chiamata: ''/etc/ati/patch/patch-8.56-2.6.27.6''

Lo '''SlackBuild interno''' automaticamente noterà la patch, e, se si è in possesso del programma '''patch''', eseguirà:
#> patch -p0 < /etc/ati/patch/patch-8.56-2.6.27.6

== Alcune patch ==
Di seguito alcune patch note e come usarle:

=== ATI Catalyst 10.3, 10.4 e kernel == 2.6.33.x ===
Scaricate la [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.3-4_with_2.6.33.x.diff patch] nella directory ''/tmp'', quindi:

* Per i '''Catalyst 10.3''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.3-4_with_2.6.33.x.diff /etc/ati/patch/patch-8.712-$(uname -r)
#> sh ati-driver-installer-10-3-x86.x86_64.run --buildpkg

* Per i '''Catalyst 10.4''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.3-4_with_2.6.33.x.diff /etc/ati/patch/patch-8.723-$(uname -r)
#> sh ati-driver-installer-10-4-x86.x86_64.run --buildpkg

=== ATI Catalyst 10.4, 10.5 e kernel == 2.6.34 ===
Scaricate la [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.4-5_with_2.6.34.diff patch] nella directory ''/tmp'', quindi:

* Per i '''Catalyst 10.4''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.4-5_with_2.6.34.diff /etc/ati/patch/patch-8.723-$(uname -r)
#> sh ati-driver-installer-10-4-x86.x86_64.run --buildpkg

* Per i '''Catalyst 10.5''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.4-5_with_2.6.34.diff /etc/ati/patch/patch-8.732-$(uname -r)
#> sh ati-driver-installer-10-4-x86.x86_64.run --buildpkg

=== ATI Catalyst 10.9 e Slackware64 13.1 o current ===
Scaricate la [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.9_with_Slackware64-13.1.diff patch] nella directory ''/tmp'', quindi fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.9_with_Slackware64-13.1.diff /etc/ati/patch/patch-8.771-$(uname -r)
#> sh ati-driver-installer-10-9-x86.x86_64.run --buildpkg
ad un certo punto l'installazione chiede:
<PRE>
can't find file to patch at input line 4
Perhaps you should have used the -p or --strip option?
The text leading up to this was:
--------------------------
|diff -ru ./2.6.x/Makefile ../../../../../../fglrx-install.uZLF8t/common/lib/modules/fglrx/build_mod//2.6.x/Makefile
|--- ./2.6.x/Makefile 2010-09-01 16:05:31.000000000 +0200
|+++ ../../../../../../fglrx-install.uZLF8t/common/lib/modules/fglrx/build_mod//2.6.x/Makefile 2010-09-23 08:47:24.000000000 +0200
--------------------------
File to patch:
</PRE>
quindi inserire:
./2.6.x/Makefile

=== ATI Catalyst 10.10, 10.11 e kernel == 2.6.36.x ===
Scaricate la [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.10-11_with_2.6.36.x.diff patch] nella directory ''/tmp'', quindi:
* Per i '''Catalyst 10.10''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-11_with_2.6.36.x.diff /etc/ati/patch/patch-8.783-$(uname -r)
#> sh ati-driver-installer-10-10-x86.x86_64.run --buildpkg

* Per i '''Catalyst 10.11''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-11_with_2.6.36.x.diff /etc/ati/patch/patch-8.791-$(uname -r)
#> sh ati-driver-installer-10-11-x86.x86_64.run --buildpkg

=== ATI Catalyst 10.10, 10.11 e 10.12 e kernel == 2.6.37.x ===
Scaricate la [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.10-12_with_2.6.37.x.diff patch] nella directory ''/tmp'', quindi:
* Per i '''Catalyst 10.10''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-12_with_2.6.37.x.diff /etc/ati/patch/patch-8.783-$(uname -r)
#> sh ati-driver-installer-10-10-x86.x86_64.run --buildpkg

* Per i '''Catalyst 10.11''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-12_with_2.6.37.x.diff /etc/ati/patch/patch-8.791-$(uname -r)
#> sh ati-driver-installer-10-11-x86.x86_64.run --buildpkg

* Per i '''Catalyst 10.12''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-12_with_2.6.37.x.diff /etc/ati/patch/patch-8.801-$(uname -r)
#> sh ati-driver-installer-10-12-x86.x86_64.run --buildpkg

= Problemi noti =
== error: implicit declaration of function 'lock_kernel' and error: implicit declaration of function 'unlock_kernel' ==
Dovete abilitare l'opzione '''Big Kernel Lock''' nella vostra configurazione del kernel. La voce si trova nel menù '''Kernel hacking'''. Per controllare se questa opzione è abilitata potete fare:
$> zcat /proc/config.gz | grep BKL
CONFIG_BKL=y

== FATAL: modpost: GPL-incompatible module fglrx.ko uses GPL-only symbol 'paravirt_ops' ==
L'errore accade in fase di compilazione del modulo ed è dovuto al fatto che il kernel è stato compilato con l'opzione di
paravirtualizzazione attiva. Questa opzione tra le altre cose, impedisce di caricare, e quindi di compilare, moduli che non hanno la
licenza GPL. Visto che i driver ATI non hanno questo tipo di licenza, non vengono compilati.

Per ovviare al problema si può:
=== Disabilitare la paravirtualizzazione nel kernel ===
L'opzione di paravirtualizzazione si chiama '''CONFIG_PARAVIRT''' e generalmente si trova nel sottomenù '''Processor type and features''' del kernel.
=== Patchare i driver ATI ===
Questa operazione è illegale poichè si deve modificare il tipo di licenza rilasciata dalla ATI in GPL. Ho scritto la patch:

[http://www.slacky.eu/~spina/fglrx/patch/ati_to_gpl.patch ati_to_gpl.patch] (md5sum: 4207f41a71035dc2eed3ea9346b881bb)

di cui non mi prendo nessuna responsabilità, io non la uso e ne sconsiglio l'uso preferendo l'alternativa di disabilitare la paravirtualizzazione del kernel.
Per usare questa patch bisogna:

'''SlackBuild esterno''':
* Copiare la patch nella directory ''/etc/ati/custom-package/patch''

'''SlackBuild interno''' (solo con ATI Catalist > 8.11):
* Copiare la patch nella directory ''/etc/ati/patch'' (se non esiste, va creata)

Lo SlackBuild noterà la presenza della patch e la applicherà. Per disinstallare la patch basterà quindi cancellarla.

== Using GLX_SGIX_pbuffer FGLTexMgr: open of shared memory object failed (Permission denied) __FGLTexMgrCreateObject: __FGLTexMgrSHMmalloc failed!!! ==
Questo problema è dovuto alla mancanza nel sistema del filesystem SHM (oggi chiamato tmpfs), ovvero il virtual memory filesystem.
Per ovviare al problema si deve:
* Aggiungere al file ''/etc/fstab'' la seguente riga:
shm /dev/shm tmpfs defaults 0 0
* Quindi montare il filesystem tramite:
#> mount /dev/shm
Ovviamente il kernel deve essero predisposto al "montaggio" di questo filesystem, in particolare l'opzione del kernel che deve essere
abilitata è '''CONFIG_TMPFS''' che generalmente è sistuata nel sottomenù del kernel '''File systems --> Pseudo filesystems'''. C'è da dire però che tutti i kernel precompilati hanno generalmente questa opzione abilitata.

== kernel includes at /lib/modules/`uname -r`/build/include do not match current kernel ==
L'errore completo è qualcosa del genere:

Error:
kernel includes at /lib/modules/`uname -r`/build/include do not match current kernel.
they are versioned as ""
instead of "`uname -r`".
you might need to adjust your symlinks:
- /usr/include
- /usr/src/linux

L'errore, se pur spiegato può non essere chiaro. In pratica deriva dal fatto che i link simbolici:
/lib/modules/`uname -r`/source
/lib/modules/`uname -r`/build
non puntano alla directory in cui sono inseriti i sorgenti del kernel attuale (che generalmente è /usr/src/linux-`uname -r`). Accade a coloro che usano uno dei kernel contenuto nella Slackware, per cui cercherò di spiegarlo in termini di "pacchetti" Slackware. Questo può succedere:
* O perchè i sorgenti del kernel effettivamente non sono stati installati. In questo caso dovrebbe bastare installare il pacchetto dei sorgenti che si trova nella directory k/ della Slackware. Non è detto però che il problema venga risolto, si veda il secondo motivo per cui sussiste l'errore.
* O perchè i sorgenti (se pur installati) non rispecchiano le impostazioni dell'attuale kernel. La nuova Slackware 12 ha al suo interno un pò di kernel precompilati (che vuol dire impostazioni differenti) mentre un solo pacchetto per i sorgenti (a meno di vedere nel ramo extra/). In particolare i sorgenti sono per un kernel SMP e quindi se si utilizza un kernel precompilato non SMP può accare che si verifichi l'errore suddetto. Per ovviare basta fare quanto segue, dopo essersi assicurati che il pacchetto dei sorgenti è stato installato:
#> cd /usr/src/linux
#> cp /boot/config .config
#> make
:eseguendo il make, oltre a compilare il kernel e relativi moduli (che poi non useremo), si rigenerano alcuni file headers che rispecchiano la configurazione del kernel (per come impostata nel file .config).

== Logo nei driver 8.39.4 ==
Questo "bug" nei driver 8.39.4 deriva dal fatto che gli sviluppatori ATI non aggiornano i packager mantainer prima della release ufficiale. Sarebbe carino se facessero testare prima a noi le release ufficiali, in modo da certificare il corretto funzionamento degli script per creare i pacchetti. Per risolvere il problema si deve usare lo '''SlackBuild esterno''' come descritto [[#Versione dei driver < 8.37.6 (SlackBuild esterno) | qui]].

== amdcccle non parte con la Slackware 12 ==
Molti utenti che utilizzano la versione del server X.Org 7.2 (o 1.3) non riescono a lanciare correttamente il Catalyst. Il comando per eseguire il Catalyst è:
#> amdcccle
Per questo problema sembra non esserci ancora soluzione, ma stiamo lavorando per risolverlo.

= Link utili =
Il thread di discussione da cui è stato tratto questo articolo:
http://www.slacky.eu/forum/viewtopic.php?t=18134&highlight=

Un alternativa ai driver ufficiali ATI:
http://www.schneider-digital.de/

Una guida su come installare e configurare i driver (open source e proprietary) ATI:
http://www.slacky.eu/wikislack/index.php?title=Installazione_driver_ATI_su_Slackware_GNU/Linux

= Conclusione =
I driver proprietari ATI per molti notebook e moderni PC fissi risultano essere quasi l'unica alternativa per l'uso dell'accelerazione 3d con linux. Purtroppo gli sviluppatori ATI non effettuano il back porting e quindi gli utenti che fanno uso dei driver precedenti alla versione 8.37.6 non potranno mai passare alla versione 7.2 (o anche detto 1.3) o successive del server X.Org. Si spera quindi che ben presto i driver Mesa possano essere usati anche per queste schede video.

Inoltre, può succedere che la compilazione del modulo non abbia successo. Se è il vostro caso, scrivetemi tranquillamente all'indirizzo '''tomasiATcliDOTdiDOTunipiDOTit''' postandomi l'output dell'installer lanciato con l'opzione ''Only_Module''.

Ringrazio Ezio Ghibaudo e Federico Rota per aver iniziato questo wiki e per l'aiuto che mi hanno dato con lo SlackBuild.

Slackware: ATI SlackBuild (ITA)

2011-01-11T16:54:51Z

Spina: Big Kernel Lock

= Introduzione =
Questo wiki spiega come installare i driver propritari ATI con la distribuzione linux Slackware, creando, grazie ad uno SlackBuild, dei
pacchetti che possono essere installati tramite il comando '''installpkg'''.

Il wiki NON spiega come migliorare le prestazioni. In particolare fornisce solo una descrizione minimale di come impostare il server X.Org
con l'unico scopo di far funzionare i driver proprietari (una descrizione su come configurare il server X.Org per ottenere prestazioni
più elevate la potete trovare [http://www.slacky.eu/wikislack/index.php?title=Installazione_driver_ATI_su_Slackware_GNU/Linux qui]).

Tutti i comandi che iniziano con un '#>' devono essere eseguiti con i diritti dell'utente root, mentre quello che iniziano con '$>' possono
essere eseguiti anche da un utente senza tali diritti.

= ATI Proprietary Driver e ATI Catalyst =
A partire dal 21 Novembre 2007 i driver ATI hanno cambiato nome e numero di versione. I nuovi driver, che prima venivano
indicati solo come '''ATI Proprietary Driver''', ora si chiamano '''ATI Catalyst'''. Non solo, il numero di versione
è passato da '''8.XX.X''' a '''7.XX'''.

Quando in questo articolo si parlerà dei driver ''versione < 8.37.6'', ci si riferirà implicitamente ai
vecchi driver, ovvero agli ATI Proprietary Driver, i nuovi ATI Catalyst sono da considerarsi ''versione >= 8.37.6'',
anche se, ad esempio, hanno come numero di release 7.11.

= Come ottenere tutto il software necessario =
I driver proprietari ATI possono essere scaricati dal sito ufficiale: http://ati.amd.com/support/driver.html, dopo aver selezionato il
sistema operativo Linux x86 (o Linux x86_64) e selezionato la propria scheda video, premendo il tasto "go" si arriva direttamente alla
pagina del download da cui bisognerà scaricare l'installer (che d'ora in poi chiameremo ''installer.run'').
Dato che i driver contengono anche un modulo del kernel che verrà compilato direttamente sul vostro sistema, è necessario
avere anche i sorgenti del kernel attualmente installato sul sistema.

'''NOTA:''' I driver per le architetture x86 e x86_64 sono equivalenti. L'installer infatti contiene i file per entrambe
le architetture, sarà poi il processo di compilazione e creazione dei pacchetti che sceglierà i file adeguati.
Questo vuol dire che lo SlackBuild andrà bene sia per la Slackware sia la Slackware64, sia per le varie versioni porting a 64 bit
(Slamd64, Bluewhite64, etc...).

= Nota IMPORTANTE =
Se la versione dei driver che si è scaricata è minore della 8.37.6 allora dovete sapere fin d'ora che non funzioneranno con
il server X.Org 7.2 (o 1.3) o successivi.

= Come creare i pacchetti per la Slackware =
La creazione dei pacchetti segue due strade differenti a seconda che si usino i driver ufficiali '''versione < 8.37.6''' oppure
'''versione >= 8.37.6 o nuovi ATI Catalyst'''.
La prima strada fa uso di quello che chiameremo '''SlackBuild esterno''' mentre la seconda di quello che chiameremo
'''SlackBuild interno'''.
In entrambi i casi verranno creati due pacchetti che potranno quindi essere installati tramite l'utiliti '''installpkg''' della Slackware.
Quindi passiamo a vedere i due casi ricordando che il programma che qui chiamiamo ''installer.run'' è l'installer che si è
scaricato dal sito della ATI.

== Versione dei driver < 8.37.6 (SlackBuild esterno) ==
Per questi tipi di driver ho creato uno '''SlackBuild esterno''' per la Slackware di cui ho fatto [http://www.slacky.eu/~spina/fglrx/ati-slack-packager-1.1.9-noarch-1.tgz questo pacchetto].

Per creare i pacchetti Slackware basta eseguire:
#> installpkg ati-slack-packager-current-noarch-1.tgz
#> sh installer.run --buildpkg custom-package/Slackware

'''NOTA:''' L'uso dello '''SlackBuild esterno''' è limitato alla versione dei '''driver < 8.37.6''' visto che dai nuovi ''' Catalyst 8.11''' si possono passare delle patch a quello interno.

== Versione dei driver >= 8.37.6 o nuovi ATI Catalyst (SlackBuild interno) ==
Per questi driver lo SlackBuild l'ho inviato direttamente alla ATI che ha provveduto ad inserirlo all'interno dell'installer, quindi basta
eseguire:
#> sh installer.run --buildpkg Slackware/All
o, se i driver sono abbastanza recenti (non ricordo la versione esatta), basta un semplice:
#> sh installer.run --buildpkg
Oppure, per creare ed installare direttamente i pacchetti, si può usare (sempre con versioni recenti dei driver):
#> sh intaller.run --buildandinstallpkg

= Cosa contengono i pacchetti creati? =
I due pacchetti creati dallo SlackBuild, che chiameremo ''fglrx-module'' e ''fglrx-x'', contengono, rispettivamente, il modulo per il
kernel attualmente installato sul sistema, e i driver per la versione del server X.Org installata.
In questo modo, se si aggiorna il kernel oppure il server X.Org si può creare solo il relativo pacchetto.

== Creare solo il pacchetto fglrx-module ==
Per creare solo il pacchetto contenente il modulo per il kernel attualmente installato, basta lanciare l'installer con l'opzione
''Only_Module ''.

Quindi, con lo '''SlackBuild esterno''':
#> sh installer.run --buildpkg custom-package/Only_Module
Con lo '''SlackBuild interno''':
#> sh installer.run --buildpkg Slackware/Only_Module

== Creare solo il pacchetto fglrx-x ==
Per creare solo il pacchetto contenente i driver per il server X.Org attualmente installato sul sistema, basta lanciare l'installer con
l'opzione ''Only_X''.

Con lo '''SlackBuild esterno''':
#> sh installer.run --buildpkg custom-package/Only_X
Con lo '''SlackBuild interno''':
#> sh installer.run --buildpkg Slackware/Only_X

= Configurazione minimale del server X.Org =
Una volta installati i due pacchetti bisogna segnalare al server X.Org di usare i driver proprietari ATI, per fare questo bisogna
controllare che il file xorg.conf, che generalmente è situato nella directory /etc/X11/, contenga le seguenti voci:

Section "Module"
....
Load "dri"
Load "glx"
....
EndSection

Section "Device"
....
Driver "fglrx"
....
EndSection

Section "DRI"
Group 0
Mode 0666
EndSection

= Verifica =
Per verificare se i driver proprietari ATI sono stati correttamente installati si può eseguire il comando:
$> fglrxinfo
Sulla mia macchina l'output è:
display: :0.0 screen: 0
OpenGL vendor string: ATI Technologies Inc.
OpenGL renderer string: ATI Mobility Radeon X1400
OpenGL version string: 2.0.6650 (8.39.4)

= Rimuovere i pacchetti installati =
Per rimuovere i pacchetti installati si può tranquillamente usare l'utiliti '''removepkg'''. Ci sono però aspetti che vanno
considerati:
* La rimozione dei pacchetti non elimina i file di configurazione del driver fglrx, questi file sono situati nella directory ''/etc/ati''
'''NOTA:''' La directory ''/etc/ati/custom-package'' se esiste, contiene lo '''SlackBuild esterno''' e quindi non va cancellata.
*Il pacchetto ''fglrx-x'' contiene le librerie OpenGL della ATI, e queste librerie sono posizionate nella stessa directory di quelle Mesa, indi per cui quando si installa il pacchetto ''fglrx-x'' vengono sovrascritte le OpenGL Mesa. Per ripristinare la situazione si deve semplicemente reinstallare il pacchetto contenente queste librerie, ovvero il pacchetto:
::x11
:si usa la Slackware 11, oppure:
::mesa
:se si usa la Slackware 12.

= Patchare i driver =
I driver ATI sono noti per essere sempre in ritardo rispetto all'aggiornamento del kernel linux. Spesso occorre quindi patchare i driver in modo tale che la creazione del modulo per il kernel abbia successo. A partire dagli ATI Catalist > 8.11 abbiamo inserito nello '''SlackBuild interno''' la possibilità di patchare i driver ATI prima che lo SlackBuild stesso esegua la compilazione del modulo per il kernel.

Per fare questo basta creare (o scaricare da internet) una patch e dargli questo path:

''/etc/ati/patch/patch-ATI_DRIVER_VERSION-KERNEL_VERSION''

dove:

ATI_DRIVER_VERSION deve essere uguale al risultato del comando:
$> sh installer.run -i | head -n1 | cut -d'-' -f2
KERNEL_VERSION deve essere uguale al risultato del comando:
$> uname -r

se la directory ''/et/ati/patch'' non esiste, va ovviamente creata.

Quindi, ad esempio, se si il primo dei due comandi da come risultato '''8.56''' e il secondo '''2.6.27.6''', la patch va chiamata: ''/etc/ati/patch/patch-8.56-2.6.27.6''

Lo '''SlackBuild interno''' automaticamente noterà la patch, e, se si è in possesso del programma '''patch''', eseguirà:
#> patch -p0 < /etc/ati/patch/patch-8.56-2.6.27.6

== Alcune patch ==
Di seguito alcune patch note e come usarle:

=== ATI Catalyst 10.3, 10.4 e kernel == 2.6.33.x ===
Scaricate la [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.3-4_with_2.6.33.x.diff patch] nella directory ''/tmp'', quindi:

* Per i '''Catalyst 10.3''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.3-4_with_2.6.33.x.diff /etc/ati/patch/patch-8.712-$(uname -r)
#> sh ati-driver-installer-10-3-x86.x86_64.run --buildpkg

* Per i '''Catalyst 10.4''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.3-4_with_2.6.33.x.diff /etc/ati/patch/patch-8.723-$(uname -r)
#> sh ati-driver-installer-10-4-x86.x86_64.run --buildpkg

=== ATI Catalyst 10.4, 10.5 e kernel == 2.6.34 ===
Scaricate la [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.4-5_with_2.6.34.diff patch] nella directory ''/tmp'', quindi:

* Per i '''Catalyst 10.4''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.4-5_with_2.6.34.diff /etc/ati/patch/patch-8.723-$(uname -r)
#> sh ati-driver-installer-10-4-x86.x86_64.run --buildpkg

* Per i '''Catalyst 10.5''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.4-5_with_2.6.34.diff /etc/ati/patch/patch-8.732-$(uname -r)
#> sh ati-driver-installer-10-4-x86.x86_64.run --buildpkg

=== ATI Catalyst 10.9 e Slackware64 13.1 o current ===
Scaricate la [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.9_with_Slackware64-13.1.diff patch] nella directory ''/tmp'', quindi fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.9_with_Slackware64-13.1.diff /etc/ati/patch/patch-8.771-$(uname -r)
#> sh ati-driver-installer-10-9-x86.x86_64.run --buildpkg
ad un certo punto l'installazione chiede:
<PRE>
can't find file to patch at input line 4
Perhaps you should have used the -p or --strip option?
The text leading up to this was:
--------------------------
|diff -ru ./2.6.x/Makefile ../../../../../../fglrx-install.uZLF8t/common/lib/modules/fglrx/build_mod//2.6.x/Makefile
|--- ./2.6.x/Makefile 2010-09-01 16:05:31.000000000 +0200
|+++ ../../../../../../fglrx-install.uZLF8t/common/lib/modules/fglrx/build_mod//2.6.x/Makefile 2010-09-23 08:47:24.000000000 +0200
--------------------------
File to patch:
</PRE>
quindi inserire:
./2.6.x/Makefile

=== ATI Catalyst 10.10, 10.11 e kernel == 2.6.36.x ===
Scaricate la [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.10-11_with_2.6.36.x.diff patch] nella directory ''/tmp'', quindi:
* Per i '''Catalyst 10.10''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-11_with_2.6.36.x.diff /etc/ati/patch/patch-8.783-$(uname -r)
#> sh ati-driver-installer-10-10-x86.x86_64.run --buildpkg

* Per i '''Catalyst 10.11''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-11_with_2.6.36.x.diff /etc/ati/patch/patch-8.791-$(uname -r)
#> sh ati-driver-installer-10-11-x86.x86_64.run --buildpkg

=== ATI Catalyst 10.10, 10.11 e 10.12 e kernel == 2.6.37.x ===
Scaricate la [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.10-12_with_2.6.37.x.diff patch] nella directory ''/tmp'', quindi:
* Per i '''Catalyst 10.10''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-12_with_2.6.37.x.diff /etc/ati/patch/patch-8.783-$(uname -r)
#> sh ati-driver-installer-10-10-x86.x86_64.run --buildpkg

* Per i '''Catalyst 10.11''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-12_with_2.6.37.x.diff /etc/ati/patch/patch-8.791-$(uname -r)
#> sh ati-driver-installer-10-11-x86.x86_64.run --buildpkg

* Per i '''Catalyst 10.12''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-12_with_2.6.37.x.diff /etc/ati/patch/patch-8.801-$(uname -r)
#> sh ati-driver-installer-10-12-x86.x86_64.run --buildpkg

= Problemi noti =
== error: implicit declaration of function 'lock_kernel' and error: implicit declaration of function 'unlock_kernel' ==
Dovete abilitare l'opzione '''Big Kernel Lock''' nela vostra configurazione del kernel. La voce si trova nel menù '''Kernel hacking'''. Per controllare se questa opzione è abilitata potete fare:
$> zcat /proc/config.gz | grep BKL
CONFIG_BKL=y

== FATAL: modpost: GPL-incompatible module fglrx.ko uses GPL-only symbol 'paravirt_ops' ==
L'errore accade in fase di compilazione del modulo ed è dovuto al fatto che il kernel è stato compilato con l'opzione di
paravirtualizzazione attiva. Questa opzione tra le altre cose, impedisce di caricare, e quindi di compilare, moduli che non hanno la
licenza GPL. Visto che i driver ATI non hanno questo tipo di licenza, non vengono compilati.

Per ovviare al problema si può:
=== Disabilitare la paravirtualizzazione nel kernel ===
L'opzione di paravirtualizzazione si chiama '''CONFIG_PARAVIRT''' e generalmente si trova nel sottomenù '''Processor type and features''' del kernel.
=== Patchare i driver ATI ===
Questa operazione è illegale poichè si deve modificare il tipo di licenza rilasciata dalla ATI in GPL. Ho scritto la patch:

[http://www.slacky.eu/~spina/fglrx/patch/ati_to_gpl.patch ati_to_gpl.patch] (md5sum: 4207f41a71035dc2eed3ea9346b881bb)

di cui non mi prendo nessuna responsabilità, io non la uso e ne sconsiglio l'uso preferendo l'alternativa di disabilitare la paravirtualizzazione del kernel.
Per usare questa patch bisogna:

'''SlackBuild esterno''':
* Copiare la patch nella directory ''/etc/ati/custom-package/patch''

'''SlackBuild interno''' (solo con ATI Catalist > 8.11):
* Copiare la patch nella directory ''/etc/ati/patch'' (se non esiste, va creata)

Lo SlackBuild noterà la presenza della patch e la applicherà. Per disinstallare la patch basterà quindi cancellarla.

== Using GLX_SGIX_pbuffer FGLTexMgr: open of shared memory object failed (Permission denied) __FGLTexMgrCreateObject: __FGLTexMgrSHMmalloc failed!!! ==
Questo problema è dovuto alla mancanza nel sistema del filesystem SHM (oggi chiamato tmpfs), ovvero il virtual memory filesystem.
Per ovviare al problema si deve:
* Aggiungere al file ''/etc/fstab'' la seguente riga:
shm /dev/shm tmpfs defaults 0 0
* Quindi montare il filesystem tramite:
#> mount /dev/shm
Ovviamente il kernel deve essero predisposto al "montaggio" di questo filesystem, in particolare l'opzione del kernel che deve essere
abilitata è '''CONFIG_TMPFS''' che generalmente è sistuata nel sottomenù del kernel '''File systems --> Pseudo filesystems'''. C'è da dire però che tutti i kernel precompilati hanno generalmente questa opzione abilitata.

== kernel includes at /lib/modules/`uname -r`/build/include do not match current kernel ==
L'errore completo è qualcosa del genere:

Error:
kernel includes at /lib/modules/`uname -r`/build/include do not match current kernel.
they are versioned as ""
instead of "`uname -r`".
you might need to adjust your symlinks:
- /usr/include
- /usr/src/linux

L'errore, se pur spiegato può non essere chiaro. In pratica deriva dal fatto che i link simbolici:
/lib/modules/`uname -r`/source
/lib/modules/`uname -r`/build
non puntano alla directory in cui sono inseriti i sorgenti del kernel attuale (che generalmente è /usr/src/linux-`uname -r`). Accade a coloro che usano uno dei kernel contenuto nella Slackware, per cui cercherò di spiegarlo in termini di "pacchetti" Slackware. Questo può succedere:
* O perchè i sorgenti del kernel effettivamente non sono stati installati. In questo caso dovrebbe bastare installare il pacchetto dei sorgenti che si trova nella directory k/ della Slackware. Non è detto però che il problema venga risolto, si veda il secondo motivo per cui sussiste l'errore.
* O perchè i sorgenti (se pur installati) non rispecchiano le impostazioni dell'attuale kernel. La nuova Slackware 12 ha al suo interno un pò di kernel precompilati (che vuol dire impostazioni differenti) mentre un solo pacchetto per i sorgenti (a meno di vedere nel ramo extra/). In particolare i sorgenti sono per un kernel SMP e quindi se si utilizza un kernel precompilato non SMP può accare che si verifichi l'errore suddetto. Per ovviare basta fare quanto segue, dopo essersi assicurati che il pacchetto dei sorgenti è stato installato:
#> cd /usr/src/linux
#> cp /boot/config .config
#> make
:eseguendo il make, oltre a compilare il kernel e relativi moduli (che poi non useremo), si rigenerano alcuni file headers che rispecchiano la configurazione del kernel (per come impostata nel file .config).

== Logo nei driver 8.39.4 ==
Questo "bug" nei driver 8.39.4 deriva dal fatto che gli sviluppatori ATI non aggiornano i packager mantainer prima della release ufficiale. Sarebbe carino se facessero testare prima a noi le release ufficiali, in modo da certificare il corretto funzionamento degli script per creare i pacchetti. Per risolvere il problema si deve usare lo '''SlackBuild esterno''' come descritto [[#Versione dei driver < 8.37.6 (SlackBuild esterno) | qui]].

== amdcccle non parte con la Slackware 12 ==
Molti utenti che utilizzano la versione del server X.Org 7.2 (o 1.3) non riescono a lanciare correttamente il Catalyst. Il comando per eseguire il Catalyst è:
#> amdcccle
Per questo problema sembra non esserci ancora soluzione, ma stiamo lavorando per risolverlo.

= Link utili =
Il thread di discussione da cui è stato tratto questo articolo:
http://www.slacky.eu/forum/viewtopic.php?t=18134&highlight=

Un alternativa ai driver ufficiali ATI:
http://www.schneider-digital.de/

Una guida su come installare e configurare i driver (open source e proprietary) ATI:
http://www.slacky.eu/wikislack/index.php?title=Installazione_driver_ATI_su_Slackware_GNU/Linux

= Conclusione =
I driver proprietari ATI per molti notebook e moderni PC fissi risultano essere quasi l'unica alternativa per l'uso dell'accelerazione 3d con linux. Purtroppo gli sviluppatori ATI non effettuano il back porting e quindi gli utenti che fanno uso dei driver precedenti alla versione 8.37.6 non potranno mai passare alla versione 7.2 (o anche detto 1.3) o successive del server X.Org. Si spera quindi che ben presto i driver Mesa possano essere usati anche per queste schede video.

Inoltre, può succedere che la compilazione del modulo non abbia successo. Se è il vostro caso, scrivetemi tranquillamente all'indirizzo '''tomasiATcliDOTdiDOTunipiDOTit''' postandomi l'output dell'installer lanciato con l'opzione ''Only_Module''.

Ringrazio Ezio Ghibaudo e Federico Rota per aver iniziato questo wiki e per l'aiuto che mi hanno dato con lo SlackBuild.

Slackware: ATI SlackBuild (ENG)

2011-01-11T16:53:42Z

Spina: Big Kernel Lock

== Introduction ==
This wiki explains how to install the proprietary ATI drivers in a Slackware Linux distribution, creating, thanks to a SlackBuild, packages that can be installed through the '''installpkg''' command.

This wiki DOES NOT explain how to improve performance. In particular, It provides only a minimal description of how to set up the X.Org server with the only purpose of loading the proprietary drivers (a description on how to configure the X.Org server to increase performance can be found here).

All commands starting with a '#>' must be executed with root rights, while commands beginning with '$>' can be performed by a user without such rights.

== Proprietary ATI Drivers and ATI Catalyst ==
Since 21 November 2007, ATI drivers have changed the name and the number version. The new drivers, which were first mentioned only as Proprietary ATI Driver, are now called ATI Catalyst. Moreover, the version number has passed from 8.XX.X to 7.XX.

When in this wiki we will talk about drivers version <8.37.6, we will refer implicitly to the old driver, such as Proprietary ATI Driver, while the new ATI Catalyst have a number version >= 8.37.6, even if, for instance, have a release number 7.11.

== Getting all the necessary ==
The proprietary ATI drivers can be downloaded from the [http://ati.amd.com/support/driver.html official web site], after selecting the Linux x86 operating system (or Linux x86_64) and selecting your video card, pressing the “go” button takes you directly into the download page from which you can download the installer (which henceforth we call installer.run).
Since drivers also contain a kernel module which will be compiled directly on your system, you'll need the kernel source currently installed in the system as well.

'''NOTE:''' Drivers for x86 and x86_64 architectures are equivalent. The installer contains files for both architectures, then It will be the compilation process and the package
creation process to choose the appropriate files.
This means that '''the SlackBuild will be good for Slackware, Slackware64 and for Slackware 64-bit portings (Slamd64, Bluewhite64, etc. ...)'''.

== Important notice ==
If the downloaded driver version is less than 8.37.6, then you need to know from now that it will not work onto X.Org 7.2 server (or 1.3) or later.

== How to create Slackware packages ==
The packages creation follows two different ways depending on whether you use the official driver version '''< 8.37.6''' or '''>= 8.37.6''' or new '''ATI Catalyst'''.
The first way uses what is called '''external SlackBuild''' while the second way what we will call '''internal SlackBuild'''.
In both cases the two packages will be created and they can be installed by Slackware '''installpkg''' utility.
So let's see the two cases saying that the program that here is called installer.run is the installer downloaded from ATI web site.

=== Drivers version < 8.37.6 (external SlackBuild) ===
For these types of drivers I've created an '''external SlackBuild''' for Slackware and I made [http://www.slacky.eu/~spina/fglrx/ati-slack-packager-1.1.9-noarch-1.tgz this package].

To create Slackware packages simply run:
#> installpkg ati-slack-packager-current-noarch-1.tgz
#> sh installer.run -- buildpkg custom-package/Slackware

'''NOTE:''' The '''external SlackBuild''' use is limited to the driver '''< 8.37.6''' since from new '''Catalyst 8.11''' you can pass the patches at the '''internal SlackBuild'''.

=== Drivers version >= 8.37.6 or new ATI Catalyst (internal SlackBuild) ===
For these drivers I've sent the SlackBuild directly to ATI which inserted it into the installer, then simply run:
#> sh installer.run --buildpkg Slackware/All
or, if drivers are quite recent, it suffices:
#> sh installer.run --buildpkg
Otherwise, in order to create and install directly the packages you can use (always with recent versions of the driver):
#> sh installer.run --buildandinstallpkg

此处的意思是：如果是新装的系统，直接运行本处的最后一个命令即可同时完成创建包和安装包的过程。

== What do created packages contain? ==
The two packages created by SlackBuild, that we'll call ''fglrx-module'' and ''fglrx-x'' contain, respectively, the kernel module and the X.Org server driver currently installed in the system.
In this way, if you upgrade the kernel or the X.Org server, you can create only one package.

=== Creating only fglrx-module package ===
To create just the package containing the kernel module for the currently installed kernel, simply run the installer with the ''Only_Module'' option.

So with '''external SlackBuild''':
#> sh installer.run --buildpkg custom-package/Only_Module
With '''internal SlackBuild''':
#> sh installer.run --buildpkg Slackware/Only_Module

=== Creating only fglrx-x package ===
To create just the package containing the X.Org driver currently installed in your system, simply run installer with ''Only_X'' option.

With '''external SlackBuild''':
#> sh installer.run --buildpkg custom-package/Only_X
With '''internal SlackBuild''':
#> sh installer.run --buildpkg Slackware/Only_X

（如果进行了上一小节的 --buildandinstallpkg则本小节的命令可不必再执行）

接下来，执行

#> sh installer.run

即可进入ATI配置的界面，完成显卡的简单配置。

== Minimal X.Org server configuration ==
Once installed the two indicated packages, you must tell to the X.Org server to use ATI proprietary drivers, to do this we must check if the xorg.conf file, which is usually located in the ''/etc/X11/'' directory, contains the following items:

Section "Module"
...
Load "dri"
Load "glx"
...
EndSection

Section "Device"
...
Driver "fglrx"
...
EndSection

Section "DRI"
Group 0
Mode 0666
EndSection

== Installation checking ==
To see if proprietary ATI drivers are properly installed run the command:
$> fglrxinfo
On my computer the output is:
display::0.0 screen: 0
OpenGL vendor string: ATI Technologies Inc.
OpenGL renderer string: ATI Mobility Radeon X1400
OpenGL version string: 2.0.6650 (8.39.4)

== Remove installed packages ==
To remove installed packages you can use the '''removepkg''' utility. However, there are aspects that should be considered:
* The packages' removing don't delete fglrx's driver configuration files, these files are located in ''/etc/ati'' directory
'''NOTE:''' The /etc/ati/custom-package directory, if exists, contains the '''external SlackBuild''' and therefore should not be deleted.
* The fglrx-x package contains ATI's OpenGL libraries, and these libraries are located in the same directory of the Mesa libraries, so when you install the fglrx-x package Mesa OpenGL libraries are overridden. To restore the situation you should simply reinstall the package containing these libraries, like:
::x11
:for Slackware 11, or:
::mesa
:for Slackware 12.

= Patching the drivers =
Ati drivers are usually not compatible with brand new version of kernel linux. You often need to patch the driver so that you can create the kernel module successfully. Since Ati Catalyst > 8.11 you can patch Ati drivers within the '''internal SlackBuild''' before that same SlackBuild compiles the kernel module.

In order to do that, you just have to create (or download from the Internet) a patch and rename it like this:

''/etc/ati/patch/patch-ATI_DRIVER_VERSION-KERNEL_VERSION''

where:

ATI_DRIVER_VERSION must be equal to the output of:
$> sh installer.run -i | head -n1 | cut -d'-' -f2
KERNEL_VERSION must be equal to the output of:
$> uname -r

If ''/etc/ati/patch'' doesn't exist, it must be made.

For example, if the former command outputs "8.55" and the latter "2.6.27.6", you need to name the patch ''/etc/ati/patch/patch-8.56-2.6.27.6''.

The '''internal SlackBuild''' will find the patch automatically and, if the command '''patch''' is installed, it will run:
#> patch -p0 < /etc/ati/patch/patch-8.56-2.6.27.6

== Patches ==
Here some patches and how to use there:

=== ATI Catalyst 10.3, 10.4 and kernel == 2.6.33.x ===
Download the [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.3-4_with_2.6.33.x.diff patch] into ''/tmp'', so:

* For '''Catalyst 10.3''' do:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.3-4_with_2.6.33.x.diff /etc/ati/patch/patch-8.712-$(uname -r)
#> sh ati-driver-installer-10-3-x86.x86_64.run --buildpkg

* For '''Catalyst 10.4''' do:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.3-4_with_2.6.33.x.diff /etc/ati/patch/patch-8.723-$(uname -r)
#> sh ati-driver-installer-10-4-x86.x86_64.run --buildpkg

=== ATI Catalyst 10.4, 10.5 and kernel == 2.6.34 ===
Download the [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.4-5_with_2.6.34.diff patch] into ''/tmp'', so:

* For '''Catalyst 10.4''' do:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.4-5_with_2.6.34.diff /etc/ati/patch/patch-8.723-$(uname -r)
#> sh ati-driver-installer-10-4-x86.x86_64.run --buildpkg

* For '''Catalyst 10.5''' do:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.4-5_with_2.6.34.diff /etc/ati/patch/patch-8.732-$(uname -r)
#> sh ati-driver-installer-10-4-x86.x86_64.run --buildpkg

=== ATI Catalyst 10.9 and Slackware64 13.1 or current ===
Download the [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.9_with_Slackware64-13.1.diff patch] into ''/tmp'', so to do:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.9_with_Slackware64-13.1.diff /etc/ati/patch/patch-8.771-$(uname -r)
#> sh ati-driver-installer-10-9-x86.x86_64.run --buildpkg
at one point the installer asks:
<PRE>
can't find file to patch at input line 4
Perhaps you should have used the -p or --strip option?
The text leading up to this was:
--------------------------
|diff -ru ./2.6.x/Makefile ../../../../../../fglrx-install.uZLF8t/common/lib/modules/fglrx/build_mod//2.6.x/Makefile
|--- ./2.6.x/Makefile 2010-09-01 16:05:31.000000000 +0200
|+++ ../../../../../../fglrx-install.uZLF8t/common/lib/modules/fglrx/build_mod//2.6.x/Makefile 2010-09-23 08:47:24.000000000 +0200
--------------------------
File to patch:
</PRE>
insert:
./2.6.x/Makefile

=== ATI Catalyst 10.10, 10.11 and kernel == 2.6.36.x ===
Download the [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.10-11_with_2.6.36.x.diff patch] into ''/tmp'', so:

* For '''Catalyst 10.10''' do:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-11_with_2.6.36.x.diff /etc/ati/patch/patch-8.783-$(uname -r)
#> sh ati-driver-installer-10-10-x86.x86_64.run --buildpkg

* For '''Catalyst 10.11''' do:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-11_with_2.6.36.x.diff /etc/ati/patch/patch-8.791-$(uname -r)
#> sh ati-driver-installer-10-11-x86.x86_64.run --buildpkg

=== ATI Catalyst 10.10, 10.11 e 10.12 e kernel == 2.6.37.x ===
Download the [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.10-12_with_2.6.37.x.diff patch] into ''/tmp'', so:
* For '''Catalyst 10.10''' do:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-12_with_2.6.37.x.diff /etc/ati/patch/patch-8.783-$(uname -r)
#> sh ati-driver-installer-10-10-x86.x86_64.run --buildpkg

* For '''Catalyst 10.11''' do:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-12_with_2.6.37.x.diff /etc/ati/patch/patch-8.791-$(uname -r)
#> sh ati-driver-installer-10-11-x86.x86_64.run --buildpkg

* For '''Catalyst 10.12''' do:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-12_with_2.6.37.x.diff /etc/ati/patch/patch-8.801-$(uname -r)
#> sh ati-driver-installer-10-12-x86.x86_64.run --buildpkg

= Known problems =
== error: implicit declaration of function 'lock_kernel' and error: implicit declaration of function 'unlock_kernel' ==
You need to enable the '''Big Kernel Lock''' in your kernel configuration. You find it under the '''Kernel hacking''' menu. You can check if this option is enable with:
$> zcat /proc/config.gz | grep BKL
CONFIG_BKL=y

== FATAL: modpost: GPL-incompatible module fglrx.ko uses GPL-only symbol 'paravirt_ops' ==
The error occurs during module compilation and It's due to the fact that the kernel was compiled with the option of paravirtualization active. This option among other things, prevents to load, and then to compile, modules that do not have the GPL license. Since that ATI drivers don't have this type of license, they aren't compiled.

To work around this problem you can:
==== Disable kernel paravirtualization option ====
The paravirtualization option is called '''CONFIG_PARAVIRT''' and generally is in the '''Processor type and features''' kernel submenu.
==== Patch ATI drivers ====
This operation is illegal because It changes the type of license issued by ATI in a GPL license. I wrote the patch:

[http://www.slacky.eu/~spina/fglrx/patch/ati_to_gpl.patch ati_to_gpl.patch] (md5sum: 4207f41a71035dc2eed3ea9346b881bb)

but I do not take any responsibility, I do not use It and I discourage the use in order to prefer the alternative to disable the paravirtualization kernel option. To use this patch You need to:

'''External SlackBuild'''
* Copy the patch in the ''/etc/ati/custom-package/patch'' directory

'''Internal SlackBuild''' (only with Ati Catalyst > 8.11):
* Copy the patch in the ''/etc/ati/patch'' directory (if it doesn't exist you must create it)

The SlackBuild will find and apply the patch automatically. In order to uninstall it you simply need to delete it. In order to uninstall the patch simply delete It from ''/etc/ati/custom-package/patch'' directory.

== Using GLX_SGIX_pbuffer FGLTexMgr: open of shared memory object failed (Permission denied) __FGLTexMgrCreateObject: __FGLTexMgrSHMmalloc failed!!! ==
This problem is due to the lack of SHM filesystem (now called tmpfs), that is virtual memory filesystem. To work around this problem you must:
* Add into ''/etc/fstab'' file the following line:
shm /dev/shm tmpfs defaults 0 0
* Then mount the filesystem through:
#> mount /dev/shm
Obviously the kernel must be predisposed for the "mounting" of this filesystem, in particular the
kernel option that must be enabled is '''CONFIG_TMPFS''' that is generally placed in '''File system --> Pseudo filesystems''' submenu. However all the compiled kernel generally have this option enabled.

== kernel includes at /lib/modules/`uname -r`/build/include do not match current kernel ==
The complete mistake is something like this:

Error:
kernel includes at /lib/modules/`uname -r`/build/include do not match current kernel.
they are versioned as ""
instead of "`uname -r`".
you might need to adjust your symlinks:
- /usr/include
- /usr/src/linux

The error, also if explained, could be not clear. In practice It results from the fact that the symbolic link:
/lib/modules/`uname -r`/source
/lib/modules/`uname -r`/build
don't point to the directory where are inserted the current kernel sources (which is generally ''/usr/src/linux- 'uname-r'''). It happens to those who use a kernel contained in Slackware, so I will try to explain It in terms of Slackware "packages". This can happen:
* because the kernel source were not installed. In this case should be enough to install the source package which can be found in Slackware k/ directory. However, It is not granted that the problem will be solved, You'll need to see the second reason why there is an error.
* because sources (also if installed) do not reflect the settings of the current kernel. The new Slackware 12 has some precompiled kernels (which means different settings), while just a single package for the sources (unless seeing the branch extra/). In particular, the sources are for the SMP kernel and so if you use a non-SMP kernel can appear this error. To avoid this, after making sure that the package source has been installed, do simply the following:
#> cd /usr/src/linux
#> cp /boot/config .config
#> make
:running make, in addition to compiling the kernel modules (which we will not use), some header files are regenerated, and they will reflect the kernel configuration (as it's set in the .config file).

== Driver 8.39.4 logo ==
This "bug" in 8.39.4 drivers results from the fact that ATI developers don't update the packager maintainers before the official releases. It should be nice first if they did test us official releases in order to certify the proper functioning of the scripts for creating packages. To solve the problem it's necessary to use the '''external SlackBuild''' as described here.

== amdcccle don't start on Slackware 12 ==
Many users of the X.Org 7.2 (or 1.3) server version fail to start properly the Catalyst. The command to run the Catalyst is:
#> amdcccle
For this problem it seems there is no solution yet, but we are working on to solve it.

= Useful links =
The discussion thread from which it was derived this article:
http://www.slacky.eu/forum/viewtopic.php?t=18134&highlight=

An alternative to official ATI drivers:
http://www.schneider-digital.de/

A wiki in italian about installing and configuring ATI drivers (open source and proprietary):
http://www.slacky.eu/wikislack/index.php?title=Installazione_driver_ATI_su_Slackware_GNU/Linux

= Conclusion =
Proprietary ATI drivers for many modern desktop and notebook PC seems are almost the only alternative to the use of 3d acceleration with linux. Unfortunately ATI developers don't make back porting and then users using drivers' version older than 8.37.6 will never go to X.Org server version 7.2 (alias 1.3) or later. Let's hope that Mesa drivers can also be used for these cards.

Also, It could happen that the module compilation fails. If so, feel free to write me at '''tomasiATcliDOTdiDOTunipiDOTit''' posting me the output generated by Only_Module option.

Thank you at Ezio Ghibaudo and Federico Rota who have started this wiki and for help with the SlackBuild.

Slackware: ATI SlackBuild (ENG)

2011-01-09T17:15:06Z

Spina: Added patch for Catalyst 10.10-12 and kernel 2.6.37.x

== Introduction ==
This wiki explains how to install the proprietary ATI drivers in a Slackware Linux distribution, creating, thanks to a SlackBuild, packages that can be installed through the '''installpkg''' command.

This wiki DOES NOT explain how to improve performance. In particular, It provides only a minimal description of how to set up the X.Org server with the only purpose of loading the proprietary drivers (a description on how to configure the X.Org server to increase performance can be found here).

All commands starting with a '#>' must be executed with root rights, while commands beginning with '$>' can be performed by a user without such rights.

== Proprietary ATI Drivers and ATI Catalyst ==
Since 21 November 2007, ATI drivers have changed the name and the number version. The new drivers, which were first mentioned only as Proprietary ATI Driver, are now called ATI Catalyst. Moreover, the version number has passed from 8.XX.X to 7.XX.

When in this wiki we will talk about drivers version <8.37.6, we will refer implicitly to the old driver, such as Proprietary ATI Driver, while the new ATI Catalyst have a number version >= 8.37.6, even if, for instance, have a release number 7.11.

== Getting all the necessary ==
The proprietary ATI drivers can be downloaded from the [http://ati.amd.com/support/driver.html official web site], after selecting the Linux x86 operating system (or Linux x86_64) and selecting your video card, pressing the “go” button takes you directly into the download page from which you can download the installer (which henceforth we call installer.run).
Since drivers also contain a kernel module which will be compiled directly on your system, you'll need the kernel source currently installed in the system as well.

'''NOTE:''' Drivers for x86 and x86_64 architectures are equivalent. The installer contains files for both architectures, then It will be the compilation process and the package
creation process to choose the appropriate files.
This means that '''the SlackBuild will be good for Slackware, Slackware64 and for Slackware 64-bit portings (Slamd64, Bluewhite64, etc. ...)'''.

== Important notice ==
If the downloaded driver version is less than 8.37.6, then you need to know from now that it will not work onto X.Org 7.2 server (or 1.3) or later.

== How to create Slackware packages ==
The packages creation follows two different ways depending on whether you use the official driver version '''< 8.37.6''' or '''>= 8.37.6''' or new '''ATI Catalyst'''.
The first way uses what is called '''external SlackBuild''' while the second way what we will call '''internal SlackBuild'''.
In both cases the two packages will be created and they can be installed by Slackware '''installpkg''' utility.
So let's see the two cases saying that the program that here is called installer.run is the installer downloaded from ATI web site.

=== Drivers version < 8.37.6 (external SlackBuild) ===
For these types of drivers I've created an '''external SlackBuild''' for Slackware and I made [http://www.slacky.eu/~spina/fglrx/ati-slack-packager-1.1.9-noarch-1.tgz this package].

To create Slackware packages simply run:
#> installpkg ati-slack-packager-current-noarch-1.tgz
#> sh installer.run -- buildpkg custom-package/Slackware

'''NOTE:''' The '''external SlackBuild''' use is limited to the driver '''< 8.37.6''' since from new '''Catalyst 8.11''' you can pass the patches at the '''internal SlackBuild'''.

=== Drivers version >= 8.37.6 or new ATI Catalyst (internal SlackBuild) ===
For these drivers I've sent the SlackBuild directly to ATI which inserted it into the installer, then simply run:
#> sh installer.run --buildpkg Slackware/All
or, if drivers are quite recent, it suffices:
#> sh installer.run --buildpkg
Otherwise, in order to create and install directly the packages you can use (always with recent versions of the driver):
#> sh installer.run --buildandinstallpkg

此处的意思是：如果是新装的系统，直接运行本处的最后一个命令即可同时完成创建包和安装包的过程。

== What do created packages contain? ==
The two packages created by SlackBuild, that we'll call ''fglrx-module'' and ''fglrx-x'' contain, respectively, the kernel module and the X.Org server driver currently installed in the system.
In this way, if you upgrade the kernel or the X.Org server, you can create only one package.

=== Creating only fglrx-module package ===
To create just the package containing the kernel module for the currently installed kernel, simply run the installer with the ''Only_Module'' option.

So with '''external SlackBuild''':
#> sh installer.run --buildpkg custom-package/Only_Module
With '''internal SlackBuild''':
#> sh installer.run --buildpkg Slackware/Only_Module

=== Creating only fglrx-x package ===
To create just the package containing the X.Org driver currently installed in your system, simply run installer with ''Only_X'' option.

With '''external SlackBuild''':
#> sh installer.run --buildpkg custom-package/Only_X
With '''internal SlackBuild''':
#> sh installer.run --buildpkg Slackware/Only_X

（如果进行了上一小节的 --buildandinstallpkg则本小节的命令可不必再执行）

接下来，执行

#> sh installer.run

即可进入ATI配置的界面，完成显卡的简单配置。

== Minimal X.Org server configuration ==
Once installed the two indicated packages, you must tell to the X.Org server to use ATI proprietary drivers, to do this we must check if the xorg.conf file, which is usually located in the ''/etc/X11/'' directory, contains the following items:

Section "Module"
...
Load "dri"
Load "glx"
...
EndSection

Section "Device"
...
Driver "fglrx"
...
EndSection

Section "DRI"
Group 0
Mode 0666
EndSection

== Installation checking ==
To see if proprietary ATI drivers are properly installed run the command:
$> fglrxinfo
On my computer the output is:
display::0.0 screen: 0
OpenGL vendor string: ATI Technologies Inc.
OpenGL renderer string: ATI Mobility Radeon X1400
OpenGL version string: 2.0.6650 (8.39.4)

== Remove installed packages ==
To remove installed packages you can use the '''removepkg''' utility. However, there are aspects that should be considered:
* The packages' removing don't delete fglrx's driver configuration files, these files are located in ''/etc/ati'' directory
'''NOTE:''' The /etc/ati/custom-package directory, if exists, contains the '''external SlackBuild''' and therefore should not be deleted.
* The fglrx-x package contains ATI's OpenGL libraries, and these libraries are located in the same directory of the Mesa libraries, so when you install the fglrx-x package Mesa OpenGL libraries are overridden. To restore the situation you should simply reinstall the package containing these libraries, like:
::x11
:for Slackware 11, or:
::mesa
:for Slackware 12.

= Patching the drivers =
Ati drivers are usually not compatible with brand new version of kernel linux. You often need to patch the driver so that you can create the kernel module successfully. Since Ati Catalyst > 8.11 you can patch Ati drivers within the '''internal SlackBuild''' before that same SlackBuild compiles the kernel module.

In order to do that, you just have to create (or download from the Internet) a patch and rename it like this:

''/etc/ati/patch/patch-ATI_DRIVER_VERSION-KERNEL_VERSION''

where:

ATI_DRIVER_VERSION must be equal to the output of:
$> sh installer.run -i | head -n1 | cut -d'-' -f2
KERNEL_VERSION must be equal to the output of:
$> uname -r

If ''/etc/ati/patch'' doesn't exist, it must be made.

For example, if the former command outputs "8.55" and the latter "2.6.27.6", you need to name the patch ''/etc/ati/patch/patch-8.56-2.6.27.6''.

The '''internal SlackBuild''' will find the patch automatically and, if the command '''patch''' is installed, it will run:
#> patch -p0 < /etc/ati/patch/patch-8.56-2.6.27.6

== Patches ==
Here some patches and how to use there:

=== ATI Catalyst 10.3, 10.4 and kernel == 2.6.33.x ===
Download the [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.3-4_with_2.6.33.x.diff patch] into ''/tmp'', so:

* For '''Catalyst 10.3''' do:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.3-4_with_2.6.33.x.diff /etc/ati/patch/patch-8.712-$(uname -r)
#> sh ati-driver-installer-10-3-x86.x86_64.run --buildpkg

* For '''Catalyst 10.4''' do:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.3-4_with_2.6.33.x.diff /etc/ati/patch/patch-8.723-$(uname -r)
#> sh ati-driver-installer-10-4-x86.x86_64.run --buildpkg

=== ATI Catalyst 10.4, 10.5 and kernel == 2.6.34 ===
Download the [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.4-5_with_2.6.34.diff patch] into ''/tmp'', so:

* For '''Catalyst 10.4''' do:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.4-5_with_2.6.34.diff /etc/ati/patch/patch-8.723-$(uname -r)
#> sh ati-driver-installer-10-4-x86.x86_64.run --buildpkg

* For '''Catalyst 10.5''' do:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.4-5_with_2.6.34.diff /etc/ati/patch/patch-8.732-$(uname -r)
#> sh ati-driver-installer-10-4-x86.x86_64.run --buildpkg

=== ATI Catalyst 10.9 and Slackware64 13.1 or current ===
Download the [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.9_with_Slackware64-13.1.diff patch] into ''/tmp'', so to do:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.9_with_Slackware64-13.1.diff /etc/ati/patch/patch-8.771-$(uname -r)
#> sh ati-driver-installer-10-9-x86.x86_64.run --buildpkg
at one point the installer asks:
<PRE>
can't find file to patch at input line 4
Perhaps you should have used the -p or --strip option?
The text leading up to this was:
--------------------------
|diff -ru ./2.6.x/Makefile ../../../../../../fglrx-install.uZLF8t/common/lib/modules/fglrx/build_mod//2.6.x/Makefile
|--- ./2.6.x/Makefile 2010-09-01 16:05:31.000000000 +0200
|+++ ../../../../../../fglrx-install.uZLF8t/common/lib/modules/fglrx/build_mod//2.6.x/Makefile 2010-09-23 08:47:24.000000000 +0200
--------------------------
File to patch:
</PRE>
insert:
./2.6.x/Makefile

=== ATI Catalyst 10.10, 10.11 and kernel == 2.6.36.x ===
Download the [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.10-11_with_2.6.36.x.diff patch] into ''/tmp'', so:

* For '''Catalyst 10.10''' do:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-11_with_2.6.36.x.diff /etc/ati/patch/patch-8.783-$(uname -r)
#> sh ati-driver-installer-10-10-x86.x86_64.run --buildpkg

* For '''Catalyst 10.11''' do:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-11_with_2.6.36.x.diff /etc/ati/patch/patch-8.791-$(uname -r)
#> sh ati-driver-installer-10-11-x86.x86_64.run --buildpkg

=== ATI Catalyst 10.10, 10.11 e 10.12 e kernel == 2.6.37.x ===
Download the [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.10-12_with_2.6.37.x.diff patch] into ''/tmp'', so:
* For '''Catalyst 10.10''' do:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-12_with_2.6.37.x.diff /etc/ati/patch/patch-8.783-$(uname -r)
#> sh ati-driver-installer-10-10-x86.x86_64.run --buildpkg

* For '''Catalyst 10.11''' do:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-12_with_2.6.37.x.diff /etc/ati/patch/patch-8.791-$(uname -r)
#> sh ati-driver-installer-10-11-x86.x86_64.run --buildpkg

* For '''Catalyst 10.12''' do:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-12_with_2.6.37.x.diff /etc/ati/patch/patch-8.801-$(uname -r)
#> sh ati-driver-installer-10-12-x86.x86_64.run --buildpkg

= Known problems =
== FATAL: modpost: GPL-incompatible module fglrx.ko uses GPL-only symbol 'paravirt_ops' ==
The error occurs during module compilation and It's due to the fact that the kernel was compiled with the option of paravirtualization active. This option among other things, prevents to load, and then to compile, modules that do not have the GPL license. Since that ATI drivers don't have this type of license, they aren't compiled.

To work around this problem you can:
==== Disable kernel paravirtualization option ====
The paravirtualization option is called '''CONFIG_PARAVIRT''' and generally is in the '''Processor type and features''' kernel submenu.
==== Patch ATI drivers ====
This operation is illegal because It changes the type of license issued by ATI in a GPL license. I wrote the patch:

[http://www.slacky.eu/~spina/fglrx/patch/ati_to_gpl.patch ati_to_gpl.patch] (md5sum: 4207f41a71035dc2eed3ea9346b881bb)

but I do not take any responsibility, I do not use It and I discourage the use in order to prefer the alternative to disable the paravirtualization kernel option. To use this patch You need to:

'''External SlackBuild'''
* Copy the patch in the ''/etc/ati/custom-package/patch'' directory

'''Internal SlackBuild''' (only with Ati Catalyst > 8.11):
* Copy the patch in the ''/etc/ati/patch'' directory (if it doesn't exist you must create it)

The SlackBuild will find and apply the patch automatically. In order to uninstall it you simply need to delete it. In order to uninstall the patch simply delete It from ''/etc/ati/custom-package/patch'' directory.

== Using GLX_SGIX_pbuffer FGLTexMgr: open of shared memory object failed (Permission denied) __FGLTexMgrCreateObject: __FGLTexMgrSHMmalloc failed!!! ==
This problem is due to the lack of SHM filesystem (now called tmpfs), that is virtual memory filesystem. To work around this problem you must:
* Add into ''/etc/fstab'' file the following line:
shm /dev/shm tmpfs defaults 0 0
* Then mount the filesystem through:
#> mount /dev/shm
Obviously the kernel must be predisposed for the "mounting" of this filesystem, in particular the
kernel option that must be enabled is '''CONFIG_TMPFS''' that is generally placed in '''File system --> Pseudo filesystems''' submenu. However all the compiled kernel generally have this option enabled.

== kernel includes at /lib/modules/`uname -r`/build/include do not match current kernel ==
The complete mistake is something like this:

Error:
kernel includes at /lib/modules/`uname -r`/build/include do not match current kernel.
they are versioned as ""
instead of "`uname -r`".
you might need to adjust your symlinks:
- /usr/include
- /usr/src/linux

The error, also if explained, could be not clear. In practice It results from the fact that the symbolic link:
/lib/modules/`uname -r`/source
/lib/modules/`uname -r`/build
don't point to the directory where are inserted the current kernel sources (which is generally ''/usr/src/linux- 'uname-r'''). It happens to those who use a kernel contained in Slackware, so I will try to explain It in terms of Slackware "packages". This can happen:
* because the kernel source were not installed. In this case should be enough to install the source package which can be found in Slackware k/ directory. However, It is not granted that the problem will be solved, You'll need to see the second reason why there is an error.
* because sources (also if installed) do not reflect the settings of the current kernel. The new Slackware 12 has some precompiled kernels (which means different settings), while just a single package for the sources (unless seeing the branch extra/). In particular, the sources are for the SMP kernel and so if you use a non-SMP kernel can appear this error. To avoid this, after making sure that the package source has been installed, do simply the following:
#> cd /usr/src/linux
#> cp /boot/config .config
#> make
:running make, in addition to compiling the kernel modules (which we will not use), some header files are regenerated, and they will reflect the kernel configuration (as it's set in the .config file).

== Driver 8.39.4 logo ==
This "bug" in 8.39.4 drivers results from the fact that ATI developers don't update the packager maintainers before the official releases. It should be nice first if they did test us official releases in order to certify the proper functioning of the scripts for creating packages. To solve the problem it's necessary to use the '''external SlackBuild''' as described here.

== amdcccle don't start on Slackware 12 ==
Many users of the X.Org 7.2 (or 1.3) server version fail to start properly the Catalyst. The command to run the Catalyst is:
#> amdcccle
For this problem it seems there is no solution yet, but we are working on to solve it.

= Useful links =
The discussion thread from which it was derived this article:
http://www.slacky.eu/forum/viewtopic.php?t=18134&highlight=

An alternative to official ATI drivers:
http://www.schneider-digital.de/

A wiki in italian about installing and configuring ATI drivers (open source and proprietary):
http://www.slacky.eu/wikislack/index.php?title=Installazione_driver_ATI_su_Slackware_GNU/Linux

= Conclusion =
Proprietary ATI drivers for many modern desktop and notebook PC seems are almost the only alternative to the use of 3d acceleration with linux. Unfortunately ATI developers don't make back porting and then users using drivers' version older than 8.37.6 will never go to X.Org server version 7.2 (alias 1.3) or later. Let's hope that Mesa drivers can also be used for these cards.

Also, It could happen that the module compilation fails. If so, feel free to write me at '''tomasiATcliDOTdiDOTunipiDOTit''' posting me the output generated by Only_Module option.

Thank you at Ezio Ghibaudo and Federico Rota who have started this wiki and for help with the SlackBuild.

Slackware: ATI SlackBuild (ITA)

2011-01-09T17:13:17Z

Spina: Typo: /* ATI Catalyst 10.10, 10.11 e 10.12 e kernel == 2.6.37.x */

= Introduzione =
Questo wiki spiega come installare i driver propritari ATI con la distribuzione linux Slackware, creando, grazie ad uno SlackBuild, dei
pacchetti che possono essere installati tramite il comando '''installpkg'''.

Il wiki NON spiega come migliorare le prestazioni. In particolare fornisce solo una descrizione minimale di come impostare il server X.Org
con l'unico scopo di far funzionare i driver proprietari (una descrizione su come configurare il server X.Org per ottenere prestazioni
più elevate la potete trovare [http://www.slacky.eu/wikislack/index.php?title=Installazione_driver_ATI_su_Slackware_GNU/Linux qui]).

Tutti i comandi che iniziano con un '#>' devono essere eseguiti con i diritti dell'utente root, mentre quello che iniziano con '$>' possono
essere eseguiti anche da un utente senza tali diritti.

= ATI Proprietary Driver e ATI Catalyst =
A partire dal 21 Novembre 2007 i driver ATI hanno cambiato nome e numero di versione. I nuovi driver, che prima venivano
indicati solo come '''ATI Proprietary Driver''', ora si chiamano '''ATI Catalyst'''. Non solo, il numero di versione
è passato da '''8.XX.X''' a '''7.XX'''.

Quando in questo articolo si parlerà dei driver ''versione < 8.37.6'', ci si riferirà implicitamente ai
vecchi driver, ovvero agli ATI Proprietary Driver, i nuovi ATI Catalyst sono da considerarsi ''versione >= 8.37.6'',
anche se, ad esempio, hanno come numero di release 7.11.

= Come ottenere tutto il software necessario =
I driver proprietari ATI possono essere scaricati dal sito ufficiale: http://ati.amd.com/support/driver.html, dopo aver selezionato il
sistema operativo Linux x86 (o Linux x86_64) e selezionato la propria scheda video, premendo il tasto "go" si arriva direttamente alla
pagina del download da cui bisognerà scaricare l'installer (che d'ora in poi chiameremo ''installer.run'').
Dato che i driver contengono anche un modulo del kernel che verrà compilato direttamente sul vostro sistema, è necessario
avere anche i sorgenti del kernel attualmente installato sul sistema.

'''NOTA:''' I driver per le architetture x86 e x86_64 sono equivalenti. L'installer infatti contiene i file per entrambe
le architetture, sarà poi il processo di compilazione e creazione dei pacchetti che sceglierà i file adeguati.
Questo vuol dire che lo SlackBuild andrà bene sia per la Slackware sia la Slackware64, sia per le varie versioni porting a 64 bit
(Slamd64, Bluewhite64, etc...).

= Nota IMPORTANTE =
Se la versione dei driver che si è scaricata è minore della 8.37.6 allora dovete sapere fin d'ora che non funzioneranno con
il server X.Org 7.2 (o 1.3) o successivi.

= Come creare i pacchetti per la Slackware =
La creazione dei pacchetti segue due strade differenti a seconda che si usino i driver ufficiali '''versione < 8.37.6''' oppure
'''versione >= 8.37.6 o nuovi ATI Catalyst'''.
La prima strada fa uso di quello che chiameremo '''SlackBuild esterno''' mentre la seconda di quello che chiameremo
'''SlackBuild interno'''.
In entrambi i casi verranno creati due pacchetti che potranno quindi essere installati tramite l'utiliti '''installpkg''' della Slackware.
Quindi passiamo a vedere i due casi ricordando che il programma che qui chiamiamo ''installer.run'' è l'installer che si è
scaricato dal sito della ATI.

== Versione dei driver < 8.37.6 (SlackBuild esterno) ==
Per questi tipi di driver ho creato uno '''SlackBuild esterno''' per la Slackware di cui ho fatto [http://www.slacky.eu/~spina/fglrx/ati-slack-packager-1.1.9-noarch-1.tgz questo pacchetto].

Per creare i pacchetti Slackware basta eseguire:
#> installpkg ati-slack-packager-current-noarch-1.tgz
#> sh installer.run --buildpkg custom-package/Slackware

'''NOTA:''' L'uso dello '''SlackBuild esterno''' è limitato alla versione dei '''driver < 8.37.6''' visto che dai nuovi ''' Catalyst 8.11''' si possono passare delle patch a quello interno.

== Versione dei driver >= 8.37.6 o nuovi ATI Catalyst (SlackBuild interno) ==
Per questi driver lo SlackBuild l'ho inviato direttamente alla ATI che ha provveduto ad inserirlo all'interno dell'installer, quindi basta
eseguire:
#> sh installer.run --buildpkg Slackware/All
o, se i driver sono abbastanza recenti (non ricordo la versione esatta), basta un semplice:
#> sh installer.run --buildpkg
Oppure, per creare ed installare direttamente i pacchetti, si può usare (sempre con versioni recenti dei driver):
#> sh intaller.run --buildandinstallpkg

= Cosa contengono i pacchetti creati? =
I due pacchetti creati dallo SlackBuild, che chiameremo ''fglrx-module'' e ''fglrx-x'', contengono, rispettivamente, il modulo per il
kernel attualmente installato sul sistema, e i driver per la versione del server X.Org installata.
In questo modo, se si aggiorna il kernel oppure il server X.Org si può creare solo il relativo pacchetto.

== Creare solo il pacchetto fglrx-module ==
Per creare solo il pacchetto contenente il modulo per il kernel attualmente installato, basta lanciare l'installer con l'opzione
''Only_Module ''.

Quindi, con lo '''SlackBuild esterno''':
#> sh installer.run --buildpkg custom-package/Only_Module
Con lo '''SlackBuild interno''':
#> sh installer.run --buildpkg Slackware/Only_Module

== Creare solo il pacchetto fglrx-x ==
Per creare solo il pacchetto contenente i driver per il server X.Org attualmente installato sul sistema, basta lanciare l'installer con
l'opzione ''Only_X''.

Con lo '''SlackBuild esterno''':
#> sh installer.run --buildpkg custom-package/Only_X
Con lo '''SlackBuild interno''':
#> sh installer.run --buildpkg Slackware/Only_X

= Configurazione minimale del server X.Org =
Una volta installati i due pacchetti bisogna segnalare al server X.Org di usare i driver proprietari ATI, per fare questo bisogna
controllare che il file xorg.conf, che generalmente è situato nella directory /etc/X11/, contenga le seguenti voci:

Section "Module"
....
Load "dri"
Load "glx"
....
EndSection

Section "Device"
....
Driver "fglrx"
....
EndSection

Section "DRI"
Group 0
Mode 0666
EndSection

= Verifica =
Per verificare se i driver proprietari ATI sono stati correttamente installati si può eseguire il comando:
$> fglrxinfo
Sulla mia macchina l'output è:
display: :0.0 screen: 0
OpenGL vendor string: ATI Technologies Inc.
OpenGL renderer string: ATI Mobility Radeon X1400
OpenGL version string: 2.0.6650 (8.39.4)

= Rimuovere i pacchetti installati =
Per rimuovere i pacchetti installati si può tranquillamente usare l'utiliti '''removepkg'''. Ci sono però aspetti che vanno
considerati:
* La rimozione dei pacchetti non elimina i file di configurazione del driver fglrx, questi file sono situati nella directory ''/etc/ati''
'''NOTA:''' La directory ''/etc/ati/custom-package'' se esiste, contiene lo '''SlackBuild esterno''' e quindi non va cancellata.
*Il pacchetto ''fglrx-x'' contiene le librerie OpenGL della ATI, e queste librerie sono posizionate nella stessa directory di quelle Mesa, indi per cui quando si installa il pacchetto ''fglrx-x'' vengono sovrascritte le OpenGL Mesa. Per ripristinare la situazione si deve semplicemente reinstallare il pacchetto contenente queste librerie, ovvero il pacchetto:
::x11
:si usa la Slackware 11, oppure:
::mesa
:se si usa la Slackware 12.

= Patchare i driver =
I driver ATI sono noti per essere sempre in ritardo rispetto all'aggiornamento del kernel linux. Spesso occorre quindi patchare i driver in modo tale che la creazione del modulo per il kernel abbia successo. A partire dagli ATI Catalist > 8.11 abbiamo inserito nello '''SlackBuild interno''' la possibilità di patchare i driver ATI prima che lo SlackBuild stesso esegua la compilazione del modulo per il kernel.

Per fare questo basta creare (o scaricare da internet) una patch e dargli questo path:

''/etc/ati/patch/patch-ATI_DRIVER_VERSION-KERNEL_VERSION''

dove:

ATI_DRIVER_VERSION deve essere uguale al risultato del comando:
$> sh installer.run -i | head -n1 | cut -d'-' -f2
KERNEL_VERSION deve essere uguale al risultato del comando:
$> uname -r

se la directory ''/et/ati/patch'' non esiste, va ovviamente creata.

Quindi, ad esempio, se si il primo dei due comandi da come risultato '''8.56''' e il secondo '''2.6.27.6''', la patch va chiamata: ''/etc/ati/patch/patch-8.56-2.6.27.6''

Lo '''SlackBuild interno''' automaticamente noterà la patch, e, se si è in possesso del programma '''patch''', eseguirà:
#> patch -p0 < /etc/ati/patch/patch-8.56-2.6.27.6

== Alcune patch ==
Di seguito alcune patch note e come usarle:

=== ATI Catalyst 10.3, 10.4 e kernel == 2.6.33.x ===
Scaricate la [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.3-4_with_2.6.33.x.diff patch] nella directory ''/tmp'', quindi:

* Per i '''Catalyst 10.3''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.3-4_with_2.6.33.x.diff /etc/ati/patch/patch-8.712-$(uname -r)
#> sh ati-driver-installer-10-3-x86.x86_64.run --buildpkg

* Per i '''Catalyst 10.4''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.3-4_with_2.6.33.x.diff /etc/ati/patch/patch-8.723-$(uname -r)
#> sh ati-driver-installer-10-4-x86.x86_64.run --buildpkg

=== ATI Catalyst 10.4, 10.5 e kernel == 2.6.34 ===
Scaricate la [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.4-5_with_2.6.34.diff patch] nella directory ''/tmp'', quindi:

* Per i '''Catalyst 10.4''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.4-5_with_2.6.34.diff /etc/ati/patch/patch-8.723-$(uname -r)
#> sh ati-driver-installer-10-4-x86.x86_64.run --buildpkg

* Per i '''Catalyst 10.5''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.4-5_with_2.6.34.diff /etc/ati/patch/patch-8.732-$(uname -r)
#> sh ati-driver-installer-10-4-x86.x86_64.run --buildpkg

=== ATI Catalyst 10.9 e Slackware64 13.1 o current ===
Scaricate la [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.9_with_Slackware64-13.1.diff patch] nella directory ''/tmp'', quindi fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.9_with_Slackware64-13.1.diff /etc/ati/patch/patch-8.771-$(uname -r)
#> sh ati-driver-installer-10-9-x86.x86_64.run --buildpkg
ad un certo punto l'installazione chiede:
<PRE>
can't find file to patch at input line 4
Perhaps you should have used the -p or --strip option?
The text leading up to this was:
--------------------------
|diff -ru ./2.6.x/Makefile ../../../../../../fglrx-install.uZLF8t/common/lib/modules/fglrx/build_mod//2.6.x/Makefile
|--- ./2.6.x/Makefile 2010-09-01 16:05:31.000000000 +0200
|+++ ../../../../../../fglrx-install.uZLF8t/common/lib/modules/fglrx/build_mod//2.6.x/Makefile 2010-09-23 08:47:24.000000000 +0200
--------------------------
File to patch:
</PRE>
quindi inserire:
./2.6.x/Makefile

=== ATI Catalyst 10.10, 10.11 e kernel == 2.6.36.x ===
Scaricate la [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.10-11_with_2.6.36.x.diff patch] nella directory ''/tmp'', quindi:
* Per i '''Catalyst 10.10''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-11_with_2.6.36.x.diff /etc/ati/patch/patch-8.783-$(uname -r)
#> sh ati-driver-installer-10-10-x86.x86_64.run --buildpkg

* Per i '''Catalyst 10.11''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-11_with_2.6.36.x.diff /etc/ati/patch/patch-8.791-$(uname -r)
#> sh ati-driver-installer-10-11-x86.x86_64.run --buildpkg

=== ATI Catalyst 10.10, 10.11 e 10.12 e kernel == 2.6.37.x ===
Scaricate la [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.10-12_with_2.6.37.x.diff patch] nella directory ''/tmp'', quindi:
* Per i '''Catalyst 10.10''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-12_with_2.6.37.x.diff /etc/ati/patch/patch-8.783-$(uname -r)
#> sh ati-driver-installer-10-10-x86.x86_64.run --buildpkg

* Per i '''Catalyst 10.11''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-12_with_2.6.37.x.diff /etc/ati/patch/patch-8.791-$(uname -r)
#> sh ati-driver-installer-10-11-x86.x86_64.run --buildpkg

* Per i '''Catalyst 10.12''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-12_with_2.6.37.x.diff /etc/ati/patch/patch-8.801-$(uname -r)
#> sh ati-driver-installer-10-12-x86.x86_64.run --buildpkg

= Problemi noti =
== FATAL: modpost: GPL-incompatible module fglrx.ko uses GPL-only symbol 'paravirt_ops' ==
L'errore accade in fase di compilazione del modulo ed è dovuto al fatto che il kernel è stato compilato con l'opzione di
paravirtualizzazione attiva. Questa opzione tra le altre cose, impedisce di caricare, e quindi di compilare, moduli che non hanno la
licenza GPL. Visto che i driver ATI non hanno questo tipo di licenza, non vengono compilati.

Per ovviare al problema si può:
=== Disabilitare la paravirtualizzazione nel kernel ===
L'opzione di paravirtualizzazione si chiama '''CONFIG_PARAVIRT''' e generalmente si trova nel sottomenù '''Processor type and features''' del kernel.
=== Patchare i driver ATI ===
Questa operazione è illegale poichè si deve modificare il tipo di licenza rilasciata dalla ATI in GPL. Ho scritto la patch:

[http://www.slacky.eu/~spina/fglrx/patch/ati_to_gpl.patch ati_to_gpl.patch] (md5sum: 4207f41a71035dc2eed3ea9346b881bb)

di cui non mi prendo nessuna responsabilità, io non la uso e ne sconsiglio l'uso preferendo l'alternativa di disabilitare la paravirtualizzazione del kernel.
Per usare questa patch bisogna:

'''SlackBuild esterno''':
* Copiare la patch nella directory ''/etc/ati/custom-package/patch''

'''SlackBuild interno''' (solo con ATI Catalist > 8.11):
* Copiare la patch nella directory ''/etc/ati/patch'' (se non esiste, va creata)

Lo SlackBuild noterà la presenza della patch e la applicherà. Per disinstallare la patch basterà quindi cancellarla.

== Using GLX_SGIX_pbuffer FGLTexMgr: open of shared memory object failed (Permission denied) __FGLTexMgrCreateObject: __FGLTexMgrSHMmalloc failed!!! ==
Questo problema è dovuto alla mancanza nel sistema del filesystem SHM (oggi chiamato tmpfs), ovvero il virtual memory filesystem.
Per ovviare al problema si deve:
* Aggiungere al file ''/etc/fstab'' la seguente riga:
shm /dev/shm tmpfs defaults 0 0
* Quindi montare il filesystem tramite:
#> mount /dev/shm
Ovviamente il kernel deve essero predisposto al "montaggio" di questo filesystem, in particolare l'opzione del kernel che deve essere
abilitata è '''CONFIG_TMPFS''' che generalmente è sistuata nel sottomenù del kernel '''File systems --> Pseudo filesystems'''. C'è da dire però che tutti i kernel precompilati hanno generalmente questa opzione abilitata.

== kernel includes at /lib/modules/`uname -r`/build/include do not match current kernel ==
L'errore completo è qualcosa del genere:

Error:
kernel includes at /lib/modules/`uname -r`/build/include do not match current kernel.
they are versioned as ""
instead of "`uname -r`".
you might need to adjust your symlinks:
- /usr/include
- /usr/src/linux

L'errore, se pur spiegato può non essere chiaro. In pratica deriva dal fatto che i link simbolici:
/lib/modules/`uname -r`/source
/lib/modules/`uname -r`/build
non puntano alla directory in cui sono inseriti i sorgenti del kernel attuale (che generalmente è /usr/src/linux-`uname -r`). Accade a coloro che usano uno dei kernel contenuto nella Slackware, per cui cercherò di spiegarlo in termini di "pacchetti" Slackware. Questo può succedere:
* O perchè i sorgenti del kernel effettivamente non sono stati installati. In questo caso dovrebbe bastare installare il pacchetto dei sorgenti che si trova nella directory k/ della Slackware. Non è detto però che il problema venga risolto, si veda il secondo motivo per cui sussiste l'errore.
* O perchè i sorgenti (se pur installati) non rispecchiano le impostazioni dell'attuale kernel. La nuova Slackware 12 ha al suo interno un pò di kernel precompilati (che vuol dire impostazioni differenti) mentre un solo pacchetto per i sorgenti (a meno di vedere nel ramo extra/). In particolare i sorgenti sono per un kernel SMP e quindi se si utilizza un kernel precompilato non SMP può accare che si verifichi l'errore suddetto. Per ovviare basta fare quanto segue, dopo essersi assicurati che il pacchetto dei sorgenti è stato installato:
#> cd /usr/src/linux
#> cp /boot/config .config
#> make
:eseguendo il make, oltre a compilare il kernel e relativi moduli (che poi non useremo), si rigenerano alcuni file headers che rispecchiano la configurazione del kernel (per come impostata nel file .config).

== Logo nei driver 8.39.4 ==
Questo "bug" nei driver 8.39.4 deriva dal fatto che gli sviluppatori ATI non aggiornano i packager mantainer prima della release ufficiale. Sarebbe carino se facessero testare prima a noi le release ufficiali, in modo da certificare il corretto funzionamento degli script per creare i pacchetti. Per risolvere il problema si deve usare lo '''SlackBuild esterno''' come descritto [[#Versione dei driver < 8.37.6 (SlackBuild esterno) | qui]].

== amdcccle non parte con la Slackware 12 ==
Molti utenti che utilizzano la versione del server X.Org 7.2 (o 1.3) non riescono a lanciare correttamente il Catalyst. Il comando per eseguire il Catalyst è:
#> amdcccle
Per questo problema sembra non esserci ancora soluzione, ma stiamo lavorando per risolverlo.

= Link utili =
Il thread di discussione da cui è stato tratto questo articolo:
http://www.slacky.eu/forum/viewtopic.php?t=18134&highlight=

Un alternativa ai driver ufficiali ATI:
http://www.schneider-digital.de/

Una guida su come installare e configurare i driver (open source e proprietary) ATI:
http://www.slacky.eu/wikislack/index.php?title=Installazione_driver_ATI_su_Slackware_GNU/Linux

= Conclusione =
I driver proprietari ATI per molti notebook e moderni PC fissi risultano essere quasi l'unica alternativa per l'uso dell'accelerazione 3d con linux. Purtroppo gli sviluppatori ATI non effettuano il back porting e quindi gli utenti che fanno uso dei driver precedenti alla versione 8.37.6 non potranno mai passare alla versione 7.2 (o anche detto 1.3) o successive del server X.Org. Si spera quindi che ben presto i driver Mesa possano essere usati anche per queste schede video.

Inoltre, può succedere che la compilazione del modulo non abbia successo. Se è il vostro caso, scrivetemi tranquillamente all'indirizzo '''tomasiATcliDOTdiDOTunipiDOTit''' postandomi l'output dell'installer lanciato con l'opzione ''Only_Module''.

Ringrazio Ezio Ghibaudo e Federico Rota per aver iniziato questo wiki e per l'aiuto che mi hanno dato con lo SlackBuild.

Slackware: ATI SlackBuild (ITA)

2011-01-09T17:06:56Z

Spina: Patch per 10.10-10.12 e kernel 2.6.37.x

= Introduzione =
Questo wiki spiega come installare i driver propritari ATI con la distribuzione linux Slackware, creando, grazie ad uno SlackBuild, dei
pacchetti che possono essere installati tramite il comando '''installpkg'''.

Il wiki NON spiega come migliorare le prestazioni. In particolare fornisce solo una descrizione minimale di come impostare il server X.Org
con l'unico scopo di far funzionare i driver proprietari (una descrizione su come configurare il server X.Org per ottenere prestazioni
più elevate la potete trovare [http://www.slacky.eu/wikislack/index.php?title=Installazione_driver_ATI_su_Slackware_GNU/Linux qui]).

Tutti i comandi che iniziano con un '#>' devono essere eseguiti con i diritti dell'utente root, mentre quello che iniziano con '$>' possono
essere eseguiti anche da un utente senza tali diritti.

= ATI Proprietary Driver e ATI Catalyst =
A partire dal 21 Novembre 2007 i driver ATI hanno cambiato nome e numero di versione. I nuovi driver, che prima venivano
indicati solo come '''ATI Proprietary Driver''', ora si chiamano '''ATI Catalyst'''. Non solo, il numero di versione
è passato da '''8.XX.X''' a '''7.XX'''.

Quando in questo articolo si parlerà dei driver ''versione < 8.37.6'', ci si riferirà implicitamente ai
vecchi driver, ovvero agli ATI Proprietary Driver, i nuovi ATI Catalyst sono da considerarsi ''versione >= 8.37.6'',
anche se, ad esempio, hanno come numero di release 7.11.

= Come ottenere tutto il software necessario =
I driver proprietari ATI possono essere scaricati dal sito ufficiale: http://ati.amd.com/support/driver.html, dopo aver selezionato il
sistema operativo Linux x86 (o Linux x86_64) e selezionato la propria scheda video, premendo il tasto "go" si arriva direttamente alla
pagina del download da cui bisognerà scaricare l'installer (che d'ora in poi chiameremo ''installer.run'').
Dato che i driver contengono anche un modulo del kernel che verrà compilato direttamente sul vostro sistema, è necessario
avere anche i sorgenti del kernel attualmente installato sul sistema.

'''NOTA:''' I driver per le architetture x86 e x86_64 sono equivalenti. L'installer infatti contiene i file per entrambe
le architetture, sarà poi il processo di compilazione e creazione dei pacchetti che sceglierà i file adeguati.
Questo vuol dire che lo SlackBuild andrà bene sia per la Slackware sia la Slackware64, sia per le varie versioni porting a 64 bit
(Slamd64, Bluewhite64, etc...).

= Nota IMPORTANTE =
Se la versione dei driver che si è scaricata è minore della 8.37.6 allora dovete sapere fin d'ora che non funzioneranno con
il server X.Org 7.2 (o 1.3) o successivi.

= Come creare i pacchetti per la Slackware =
La creazione dei pacchetti segue due strade differenti a seconda che si usino i driver ufficiali '''versione < 8.37.6''' oppure
'''versione >= 8.37.6 o nuovi ATI Catalyst'''.
La prima strada fa uso di quello che chiameremo '''SlackBuild esterno''' mentre la seconda di quello che chiameremo
'''SlackBuild interno'''.
In entrambi i casi verranno creati due pacchetti che potranno quindi essere installati tramite l'utiliti '''installpkg''' della Slackware.
Quindi passiamo a vedere i due casi ricordando che il programma che qui chiamiamo ''installer.run'' è l'installer che si è
scaricato dal sito della ATI.

== Versione dei driver < 8.37.6 (SlackBuild esterno) ==
Per questi tipi di driver ho creato uno '''SlackBuild esterno''' per la Slackware di cui ho fatto [http://www.slacky.eu/~spina/fglrx/ati-slack-packager-1.1.9-noarch-1.tgz questo pacchetto].

Per creare i pacchetti Slackware basta eseguire:
#> installpkg ati-slack-packager-current-noarch-1.tgz
#> sh installer.run --buildpkg custom-package/Slackware

'''NOTA:''' L'uso dello '''SlackBuild esterno''' è limitato alla versione dei '''driver < 8.37.6''' visto che dai nuovi ''' Catalyst 8.11''' si possono passare delle patch a quello interno.

== Versione dei driver >= 8.37.6 o nuovi ATI Catalyst (SlackBuild interno) ==
Per questi driver lo SlackBuild l'ho inviato direttamente alla ATI che ha provveduto ad inserirlo all'interno dell'installer, quindi basta
eseguire:
#> sh installer.run --buildpkg Slackware/All
o, se i driver sono abbastanza recenti (non ricordo la versione esatta), basta un semplice:
#> sh installer.run --buildpkg
Oppure, per creare ed installare direttamente i pacchetti, si può usare (sempre con versioni recenti dei driver):
#> sh intaller.run --buildandinstallpkg

= Cosa contengono i pacchetti creati? =
I due pacchetti creati dallo SlackBuild, che chiameremo ''fglrx-module'' e ''fglrx-x'', contengono, rispettivamente, il modulo per il
kernel attualmente installato sul sistema, e i driver per la versione del server X.Org installata.
In questo modo, se si aggiorna il kernel oppure il server X.Org si può creare solo il relativo pacchetto.

== Creare solo il pacchetto fglrx-module ==
Per creare solo il pacchetto contenente il modulo per il kernel attualmente installato, basta lanciare l'installer con l'opzione
''Only_Module ''.

Quindi, con lo '''SlackBuild esterno''':
#> sh installer.run --buildpkg custom-package/Only_Module
Con lo '''SlackBuild interno''':
#> sh installer.run --buildpkg Slackware/Only_Module

== Creare solo il pacchetto fglrx-x ==
Per creare solo il pacchetto contenente i driver per il server X.Org attualmente installato sul sistema, basta lanciare l'installer con
l'opzione ''Only_X''.

Con lo '''SlackBuild esterno''':
#> sh installer.run --buildpkg custom-package/Only_X
Con lo '''SlackBuild interno''':
#> sh installer.run --buildpkg Slackware/Only_X

= Configurazione minimale del server X.Org =
Una volta installati i due pacchetti bisogna segnalare al server X.Org di usare i driver proprietari ATI, per fare questo bisogna
controllare che il file xorg.conf, che generalmente è situato nella directory /etc/X11/, contenga le seguenti voci:

Section "Module"
....
Load "dri"
Load "glx"
....
EndSection

Section "Device"
....
Driver "fglrx"
....
EndSection

Section "DRI"
Group 0
Mode 0666
EndSection

= Verifica =
Per verificare se i driver proprietari ATI sono stati correttamente installati si può eseguire il comando:
$> fglrxinfo
Sulla mia macchina l'output è:
display: :0.0 screen: 0
OpenGL vendor string: ATI Technologies Inc.
OpenGL renderer string: ATI Mobility Radeon X1400
OpenGL version string: 2.0.6650 (8.39.4)

= Rimuovere i pacchetti installati =
Per rimuovere i pacchetti installati si può tranquillamente usare l'utiliti '''removepkg'''. Ci sono però aspetti che vanno
considerati:
* La rimozione dei pacchetti non elimina i file di configurazione del driver fglrx, questi file sono situati nella directory ''/etc/ati''
'''NOTA:''' La directory ''/etc/ati/custom-package'' se esiste, contiene lo '''SlackBuild esterno''' e quindi non va cancellata.
*Il pacchetto ''fglrx-x'' contiene le librerie OpenGL della ATI, e queste librerie sono posizionate nella stessa directory di quelle Mesa, indi per cui quando si installa il pacchetto ''fglrx-x'' vengono sovrascritte le OpenGL Mesa. Per ripristinare la situazione si deve semplicemente reinstallare il pacchetto contenente queste librerie, ovvero il pacchetto:
::x11
:si usa la Slackware 11, oppure:
::mesa
:se si usa la Slackware 12.

= Patchare i driver =
I driver ATI sono noti per essere sempre in ritardo rispetto all'aggiornamento del kernel linux. Spesso occorre quindi patchare i driver in modo tale che la creazione del modulo per il kernel abbia successo. A partire dagli ATI Catalist > 8.11 abbiamo inserito nello '''SlackBuild interno''' la possibilità di patchare i driver ATI prima che lo SlackBuild stesso esegua la compilazione del modulo per il kernel.

Per fare questo basta creare (o scaricare da internet) una patch e dargli questo path:

''/etc/ati/patch/patch-ATI_DRIVER_VERSION-KERNEL_VERSION''

dove:

ATI_DRIVER_VERSION deve essere uguale al risultato del comando:
$> sh installer.run -i | head -n1 | cut -d'-' -f2
KERNEL_VERSION deve essere uguale al risultato del comando:
$> uname -r

se la directory ''/et/ati/patch'' non esiste, va ovviamente creata.

Quindi, ad esempio, se si il primo dei due comandi da come risultato '''8.56''' e il secondo '''2.6.27.6''', la patch va chiamata: ''/etc/ati/patch/patch-8.56-2.6.27.6''

Lo '''SlackBuild interno''' automaticamente noterà la patch, e, se si è in possesso del programma '''patch''', eseguirà:
#> patch -p0 < /etc/ati/patch/patch-8.56-2.6.27.6

== Alcune patch ==
Di seguito alcune patch note e come usarle:

=== ATI Catalyst 10.3, 10.4 e kernel == 2.6.33.x ===
Scaricate la [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.3-4_with_2.6.33.x.diff patch] nella directory ''/tmp'', quindi:

* Per i '''Catalyst 10.3''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.3-4_with_2.6.33.x.diff /etc/ati/patch/patch-8.712-$(uname -r)
#> sh ati-driver-installer-10-3-x86.x86_64.run --buildpkg

* Per i '''Catalyst 10.4''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.3-4_with_2.6.33.x.diff /etc/ati/patch/patch-8.723-$(uname -r)
#> sh ati-driver-installer-10-4-x86.x86_64.run --buildpkg

=== ATI Catalyst 10.4, 10.5 e kernel == 2.6.34 ===
Scaricate la [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.4-5_with_2.6.34.diff patch] nella directory ''/tmp'', quindi:

* Per i '''Catalyst 10.4''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.4-5_with_2.6.34.diff /etc/ati/patch/patch-8.723-$(uname -r)
#> sh ati-driver-installer-10-4-x86.x86_64.run --buildpkg

* Per i '''Catalyst 10.5''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.4-5_with_2.6.34.diff /etc/ati/patch/patch-8.732-$(uname -r)
#> sh ati-driver-installer-10-4-x86.x86_64.run --buildpkg

=== ATI Catalyst 10.9 e Slackware64 13.1 o current ===
Scaricate la [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.9_with_Slackware64-13.1.diff patch] nella directory ''/tmp'', quindi fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.9_with_Slackware64-13.1.diff /etc/ati/patch/patch-8.771-$(uname -r)
#> sh ati-driver-installer-10-9-x86.x86_64.run --buildpkg
ad un certo punto l'installazione chiede:
<PRE>
can't find file to patch at input line 4
Perhaps you should have used the -p or --strip option?
The text leading up to this was:
--------------------------
|diff -ru ./2.6.x/Makefile ../../../../../../fglrx-install.uZLF8t/common/lib/modules/fglrx/build_mod//2.6.x/Makefile
|--- ./2.6.x/Makefile 2010-09-01 16:05:31.000000000 +0200
|+++ ../../../../../../fglrx-install.uZLF8t/common/lib/modules/fglrx/build_mod//2.6.x/Makefile 2010-09-23 08:47:24.000000000 +0200
--------------------------
File to patch:
</PRE>
quindi inserire:
./2.6.x/Makefile

=== ATI Catalyst 10.10, 10.11 e kernel == 2.6.36.x ===
Scaricate la [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.10-11_with_2.6.36.x.diff patch] nella directory ''/tmp'', quindi:
* Per i '''Catalyst 10.10''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-11_with_2.6.36.x.diff /etc/ati/patch/patch-8.783-$(uname -r)
#> sh ati-driver-installer-10-10-x86.x86_64.run --buildpkg

* Per i '''Catalyst 10.11''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-11_with_2.6.36.x.diff /etc/ati/patch/patch-8.791-$(uname -r)
#> sh ati-driver-installer-10-11-x86.x86_64.run --buildpkg

=== ATI Catalyst 10.10, 10.11 e 10.12 e kernel == 2.6.37.x ===
Scaricate la [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.10-12_with_2.6.37.x.diff patch] nella directory ''/tmp'', quindi:
* Per i '''Catalyst 10.10''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-12_with_2.6.37.x.diff /etc/ati/patch/patch-8.783-$(uname -r)
#> sh ati-driver-installer-10-10-x86.x86_64.run --buildpkg

* Per i '''Catalyst 10.11''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-12_with_2.6.37.x.diff /etc/ati/patch/patch-8.791-$(uname -r)
#> sh ati-driver-installer-10-11-x86.x86_64.run --buildpkg

* Per i '''Catalyst 10.12''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-12_with_2.6.37.x.diff /etc/ati/patch/patch-8.801-$(uname -r)
#> sh ati-driver-installer-10-11-x86.x86_64.run --buildpkg

= Problemi noti =
== FATAL: modpost: GPL-incompatible module fglrx.ko uses GPL-only symbol 'paravirt_ops' ==
L'errore accade in fase di compilazione del modulo ed è dovuto al fatto che il kernel è stato compilato con l'opzione di
paravirtualizzazione attiva. Questa opzione tra le altre cose, impedisce di caricare, e quindi di compilare, moduli che non hanno la
licenza GPL. Visto che i driver ATI non hanno questo tipo di licenza, non vengono compilati.

Per ovviare al problema si può:
=== Disabilitare la paravirtualizzazione nel kernel ===
L'opzione di paravirtualizzazione si chiama '''CONFIG_PARAVIRT''' e generalmente si trova nel sottomenù '''Processor type and features''' del kernel.
=== Patchare i driver ATI ===
Questa operazione è illegale poichè si deve modificare il tipo di licenza rilasciata dalla ATI in GPL. Ho scritto la patch:

[http://www.slacky.eu/~spina/fglrx/patch/ati_to_gpl.patch ati_to_gpl.patch] (md5sum: 4207f41a71035dc2eed3ea9346b881bb)

di cui non mi prendo nessuna responsabilità, io non la uso e ne sconsiglio l'uso preferendo l'alternativa di disabilitare la paravirtualizzazione del kernel.
Per usare questa patch bisogna:

'''SlackBuild esterno''':
* Copiare la patch nella directory ''/etc/ati/custom-package/patch''

'''SlackBuild interno''' (solo con ATI Catalist > 8.11):
* Copiare la patch nella directory ''/etc/ati/patch'' (se non esiste, va creata)

Lo SlackBuild noterà la presenza della patch e la applicherà. Per disinstallare la patch basterà quindi cancellarla.

== Using GLX_SGIX_pbuffer FGLTexMgr: open of shared memory object failed (Permission denied) __FGLTexMgrCreateObject: __FGLTexMgrSHMmalloc failed!!! ==
Questo problema è dovuto alla mancanza nel sistema del filesystem SHM (oggi chiamato tmpfs), ovvero il virtual memory filesystem.
Per ovviare al problema si deve:
* Aggiungere al file ''/etc/fstab'' la seguente riga:
shm /dev/shm tmpfs defaults 0 0
* Quindi montare il filesystem tramite:
#> mount /dev/shm
Ovviamente il kernel deve essero predisposto al "montaggio" di questo filesystem, in particolare l'opzione del kernel che deve essere
abilitata è '''CONFIG_TMPFS''' che generalmente è sistuata nel sottomenù del kernel '''File systems --> Pseudo filesystems'''. C'è da dire però che tutti i kernel precompilati hanno generalmente questa opzione abilitata.

== kernel includes at /lib/modules/`uname -r`/build/include do not match current kernel ==
L'errore completo è qualcosa del genere:

Error:
kernel includes at /lib/modules/`uname -r`/build/include do not match current kernel.
they are versioned as ""
instead of "`uname -r`".
you might need to adjust your symlinks:
- /usr/include
- /usr/src/linux

L'errore, se pur spiegato può non essere chiaro. In pratica deriva dal fatto che i link simbolici:
/lib/modules/`uname -r`/source
/lib/modules/`uname -r`/build
non puntano alla directory in cui sono inseriti i sorgenti del kernel attuale (che generalmente è /usr/src/linux-`uname -r`). Accade a coloro che usano uno dei kernel contenuto nella Slackware, per cui cercherò di spiegarlo in termini di "pacchetti" Slackware. Questo può succedere:
* O perchè i sorgenti del kernel effettivamente non sono stati installati. In questo caso dovrebbe bastare installare il pacchetto dei sorgenti che si trova nella directory k/ della Slackware. Non è detto però che il problema venga risolto, si veda il secondo motivo per cui sussiste l'errore.
* O perchè i sorgenti (se pur installati) non rispecchiano le impostazioni dell'attuale kernel. La nuova Slackware 12 ha al suo interno un pò di kernel precompilati (che vuol dire impostazioni differenti) mentre un solo pacchetto per i sorgenti (a meno di vedere nel ramo extra/). In particolare i sorgenti sono per un kernel SMP e quindi se si utilizza un kernel precompilato non SMP può accare che si verifichi l'errore suddetto. Per ovviare basta fare quanto segue, dopo essersi assicurati che il pacchetto dei sorgenti è stato installato:
#> cd /usr/src/linux
#> cp /boot/config .config
#> make
:eseguendo il make, oltre a compilare il kernel e relativi moduli (che poi non useremo), si rigenerano alcuni file headers che rispecchiano la configurazione del kernel (per come impostata nel file .config).

== Logo nei driver 8.39.4 ==
Questo "bug" nei driver 8.39.4 deriva dal fatto che gli sviluppatori ATI non aggiornano i packager mantainer prima della release ufficiale. Sarebbe carino se facessero testare prima a noi le release ufficiali, in modo da certificare il corretto funzionamento degli script per creare i pacchetti. Per risolvere il problema si deve usare lo '''SlackBuild esterno''' come descritto [[#Versione dei driver < 8.37.6 (SlackBuild esterno) | qui]].

== amdcccle non parte con la Slackware 12 ==
Molti utenti che utilizzano la versione del server X.Org 7.2 (o 1.3) non riescono a lanciare correttamente il Catalyst. Il comando per eseguire il Catalyst è:
#> amdcccle
Per questo problema sembra non esserci ancora soluzione, ma stiamo lavorando per risolverlo.

= Link utili =
Il thread di discussione da cui è stato tratto questo articolo:
http://www.slacky.eu/forum/viewtopic.php?t=18134&highlight=

Un alternativa ai driver ufficiali ATI:
http://www.schneider-digital.de/

Una guida su come installare e configurare i driver (open source e proprietary) ATI:
http://www.slacky.eu/wikislack/index.php?title=Installazione_driver_ATI_su_Slackware_GNU/Linux

= Conclusione =
I driver proprietari ATI per molti notebook e moderni PC fissi risultano essere quasi l'unica alternativa per l'uso dell'accelerazione 3d con linux. Purtroppo gli sviluppatori ATI non effettuano il back porting e quindi gli utenti che fanno uso dei driver precedenti alla versione 8.37.6 non potranno mai passare alla versione 7.2 (o anche detto 1.3) o successive del server X.Org. Si spera quindi che ben presto i driver Mesa possano essere usati anche per queste schede video.

Inoltre, può succedere che la compilazione del modulo non abbia successo. Se è il vostro caso, scrivetemi tranquillamente all'indirizzo '''tomasiATcliDOTdiDOTunipiDOTit''' postandomi l'output dell'installer lanciato con l'opzione ''Only_Module''.

Ringrazio Ezio Ghibaudo e Federico Rota per aver iniziato questo wiki e per l'aiuto che mi hanno dato con lo SlackBuild.

Slackware: ATI SlackBuild (ITA)

2010-11-29T12:47:17Z

Spina: /* ATI Catalyst 10.10, 10.11 e kernel == 2.6.36.x */

= Introduzione =
Questo wiki spiega come installare i driver propritari ATI con la distribuzione linux Slackware, creando, grazie ad uno SlackBuild, dei
pacchetti che possono essere installati tramite il comando '''installpkg'''.

Il wiki NON spiega come migliorare le prestazioni. In particolare fornisce solo una descrizione minimale di come impostare il server X.Org
con l'unico scopo di far funzionare i driver proprietari (una descrizione su come configurare il server X.Org per ottenere prestazioni
più elevate la potete trovare [http://www.slacky.eu/wikislack/index.php?title=Installazione_driver_ATI_su_Slackware_GNU/Linux qui]).

Tutti i comandi che iniziano con un '#>' devono essere eseguiti con i diritti dell'utente root, mentre quello che iniziano con '$>' possono
essere eseguiti anche da un utente senza tali diritti.

= ATI Proprietary Driver e ATI Catalyst =
A partire dal 21 Novembre 2007 i driver ATI hanno cambiato nome e numero di versione. I nuovi driver, che prima venivano
indicati solo come '''ATI Proprietary Driver''', ora si chiamano '''ATI Catalyst'''. Non solo, il numero di versione
è passato da '''8.XX.X''' a '''7.XX'''.

Quando in questo articolo si parlerà dei driver ''versione < 8.37.6'', ci si riferirà implicitamente ai
vecchi driver, ovvero agli ATI Proprietary Driver, i nuovi ATI Catalyst sono da considerarsi ''versione >= 8.37.6'',
anche se, ad esempio, hanno come numero di release 7.11.

= Come ottenere tutto il software necessario =
I driver proprietari ATI possono essere scaricati dal sito ufficiale: http://ati.amd.com/support/driver.html, dopo aver selezionato il
sistema operativo Linux x86 (o Linux x86_64) e selezionato la propria scheda video, premendo il tasto "go" si arriva direttamente alla
pagina del download da cui bisognerà scaricare l'installer (che d'ora in poi chiameremo ''installer.run'').
Dato che i driver contengono anche un modulo del kernel che verrà compilato direttamente sul vostro sistema, è necessario
avere anche i sorgenti del kernel attualmente installato sul sistema.

'''NOTA:''' I driver per le architetture x86 e x86_64 sono equivalenti. L'installer infatti contiene i file per entrambe
le architetture, sarà poi il processo di compilazione e creazione dei pacchetti che sceglierà i file adeguati.
Questo vuol dire che lo SlackBuild andrà bene sia per la Slackware sia la Slackware64, sia per le varie versioni porting a 64 bit
(Slamd64, Bluewhite64, etc...).

= Nota IMPORTANTE =
Se la versione dei driver che si è scaricata è minore della 8.37.6 allora dovete sapere fin d'ora che non funzioneranno con
il server X.Org 7.2 (o 1.3) o successivi.

= Come creare i pacchetti per la Slackware =
La creazione dei pacchetti segue due strade differenti a seconda che si usino i driver ufficiali '''versione < 8.37.6''' oppure
'''versione >= 8.37.6 o nuovi ATI Catalyst'''.
La prima strada fa uso di quello che chiameremo '''SlackBuild esterno''' mentre la seconda di quello che chiameremo
'''SlackBuild interno'''.
In entrambi i casi verranno creati due pacchetti che potranno quindi essere installati tramite l'utiliti '''installpkg''' della Slackware.
Quindi passiamo a vedere i due casi ricordando che il programma che qui chiamiamo ''installer.run'' è l'installer che si è
scaricato dal sito della ATI.

== Versione dei driver < 8.37.6 (SlackBuild esterno) ==
Per questi tipi di driver ho creato uno '''SlackBuild esterno''' per la Slackware di cui ho fatto [http://www.slacky.eu/~spina/fglrx/ati-slack-packager-1.1.9-noarch-1.tgz questo pacchetto].

Per creare i pacchetti Slackware basta eseguire:
#> installpkg ati-slack-packager-current-noarch-1.tgz
#> sh installer.run --buildpkg custom-package/Slackware

'''NOTA:''' L'uso dello '''SlackBuild esterno''' è limitato alla versione dei '''driver < 8.37.6''' visto che dai nuovi ''' Catalyst 8.11''' si possono passare delle patch a quello interno.

== Versione dei driver >= 8.37.6 o nuovi ATI Catalyst (SlackBuild interno) ==
Per questi driver lo SlackBuild l'ho inviato direttamente alla ATI che ha provveduto ad inserirlo all'interno dell'installer, quindi basta
eseguire:
#> sh installer.run --buildpkg Slackware/All
o, se i driver sono abbastanza recenti (non ricordo la versione esatta), basta un semplice:
#> sh installer.run --buildpkg
Oppure, per creare ed installare direttamente i pacchetti, si può usare (sempre con versioni recenti dei driver):
#> sh intaller.run --buildandinstallpkg

= Cosa contengono i pacchetti creati? =
I due pacchetti creati dallo SlackBuild, che chiameremo ''fglrx-module'' e ''fglrx-x'', contengono, rispettivamente, il modulo per il
kernel attualmente installato sul sistema, e i driver per la versione del server X.Org installata.
In questo modo, se si aggiorna il kernel oppure il server X.Org si può creare solo il relativo pacchetto.

== Creare solo il pacchetto fglrx-module ==
Per creare solo il pacchetto contenente il modulo per il kernel attualmente installato, basta lanciare l'installer con l'opzione
''Only_Module ''.

Quindi, con lo '''SlackBuild esterno''':
#> sh installer.run --buildpkg custom-package/Only_Module
Con lo '''SlackBuild interno''':
#> sh installer.run --buildpkg Slackware/Only_Module

== Creare solo il pacchetto fglrx-x ==
Per creare solo il pacchetto contenente i driver per il server X.Org attualmente installato sul sistema, basta lanciare l'installer con
l'opzione ''Only_X''.

Con lo '''SlackBuild esterno''':
#> sh installer.run --buildpkg custom-package/Only_X
Con lo '''SlackBuild interno''':
#> sh installer.run --buildpkg Slackware/Only_X

= Configurazione minimale del server X.Org =
Una volta installati i due pacchetti bisogna segnalare al server X.Org di usare i driver proprietari ATI, per fare questo bisogna
controllare che il file xorg.conf, che generalmente è situato nella directory /etc/X11/, contenga le seguenti voci:

Section "Module"
....
Load "dri"
Load "glx"
....
EndSection

Section "Device"
....
Driver "fglrx"
....
EndSection

Section "DRI"
Group 0
Mode 0666
EndSection

= Verifica =
Per verificare se i driver proprietari ATI sono stati correttamente installati si può eseguire il comando:
$> fglrxinfo
Sulla mia macchina l'output è:
display: :0.0 screen: 0
OpenGL vendor string: ATI Technologies Inc.
OpenGL renderer string: ATI Mobility Radeon X1400
OpenGL version string: 2.0.6650 (8.39.4)

= Rimuovere i pacchetti installati =
Per rimuovere i pacchetti installati si può tranquillamente usare l'utiliti '''removepkg'''. Ci sono però aspetti che vanno
considerati:
* La rimozione dei pacchetti non elimina i file di configurazione del driver fglrx, questi file sono situati nella directory ''/etc/ati''
'''NOTA:''' La directory ''/etc/ati/custom-package'' se esiste, contiene lo '''SlackBuild esterno''' e quindi non va cancellata.
*Il pacchetto ''fglrx-x'' contiene le librerie OpenGL della ATI, e queste librerie sono posizionate nella stessa directory di quelle Mesa, indi per cui quando si installa il pacchetto ''fglrx-x'' vengono sovrascritte le OpenGL Mesa. Per ripristinare la situazione si deve semplicemente reinstallare il pacchetto contenente queste librerie, ovvero il pacchetto:
::x11
:si usa la Slackware 11, oppure:
::mesa
:se si usa la Slackware 12.

= Patchare i driver =
I driver ATI sono noti per essere sempre in ritardo rispetto all'aggiornamento del kernel linux. Spesso occorre quindi patchare i driver in modo tale che la creazione del modulo per il kernel abbia successo. A partire dagli ATI Catalist > 8.11 abbiamo inserito nello '''SlackBuild interno''' la possibilità di patchare i driver ATI prima che lo SlackBuild stesso esegua la compilazione del modulo per il kernel.

Per fare questo basta creare (o scaricare da internet) una patch e dargli questo path:

''/etc/ati/patch/patch-ATI_DRIVER_VERSION-KERNEL_VERSION''

dove:

ATI_DRIVER_VERSION deve essere uguale al risultato del comando:
$> sh installer.run -i | head -n1 | cut -d'-' -f2
KERNEL_VERSION deve essere uguale al risultato del comando:
$> uname -r

se la directory ''/et/ati/patch'' non esiste, va ovviamente creata.

Quindi, ad esempio, se si il primo dei due comandi da come risultato '''8.56''' e il secondo '''2.6.27.6''', la patch va chiamata: ''/etc/ati/patch/patch-8.56-2.6.27.6''

Lo '''SlackBuild interno''' automaticamente noterà la patch, e, se si è in possesso del programma '''patch''', eseguirà:
#> patch -p0 < /etc/ati/patch/patch-8.56-2.6.27.6

== Alcune patch ==
Di seguito alcune patch note e come usarle:

=== ATI Catalyst 10.3, 10.4 e kernel == 2.6.33.x ===
Scaricate la [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.3-4_with_2.6.33.x.diff patch] nella directory ''/tmp'', quindi:

* Per i '''Catalyst 10.3''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.3-4_with_2.6.33.x.diff /etc/ati/patch/patch-8.712-$(uname -r)
#> sh ati-driver-installer-10-3-x86.x86_64.run --buildpkg

* Per i '''Catalyst 10.4''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.3-4_with_2.6.33.x.diff /etc/ati/patch/patch-8.723-$(uname -r)
#> sh ati-driver-installer-10-4-x86.x86_64.run --buildpkg

=== ATI Catalyst 10.4, 10.5 e kernel == 2.6.34 ===
Scaricate la [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.4-5_with_2.6.34.diff patch] nella directory ''/tmp'', quindi:

* Per i '''Catalyst 10.4''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.4-5_with_2.6.34.diff /etc/ati/patch/patch-8.723-$(uname -r)
#> sh ati-driver-installer-10-4-x86.x86_64.run --buildpkg

* Per i '''Catalyst 10.5''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.4-5_with_2.6.34.diff /etc/ati/patch/patch-8.732-$(uname -r)
#> sh ati-driver-installer-10-4-x86.x86_64.run --buildpkg

=== ATI Catalyst 10.9 e Slackware64 13.1 o current ===
Scaricate la [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.9_with_Slackware64-13.1.diff patch] nella directory ''/tmp'', quindi fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.9_with_Slackware64-13.1.diff /etc/ati/patch/patch-8.771-$(uname -r)
#> sh ati-driver-installer-10-9-x86.x86_64.run --buildpkg
ad un certo punto l'installazione chiede:
<PRE>
can't find file to patch at input line 4
Perhaps you should have used the -p or --strip option?
The text leading up to this was:
--------------------------
|diff -ru ./2.6.x/Makefile ../../../../../../fglrx-install.uZLF8t/common/lib/modules/fglrx/build_mod//2.6.x/Makefile
|--- ./2.6.x/Makefile 2010-09-01 16:05:31.000000000 +0200
|+++ ../../../../../../fglrx-install.uZLF8t/common/lib/modules/fglrx/build_mod//2.6.x/Makefile 2010-09-23 08:47:24.000000000 +0200
--------------------------
File to patch:
</PRE>
quindi inserire:
./2.6.x/Makefile

=== ATI Catalyst 10.10, 10.11 e kernel == 2.6.36.x ===
Scaricate la [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.10-11_with_2.6.36.x.diff patch] nella directory ''/tmp'', quindi:
* Per i '''Catalyst 10.10''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-11_with_2.6.36.x.diff /etc/ati/patch/patch-8.783-$(uname -r)
#> sh ati-driver-installer-10-10-x86.x86_64.run --buildpkg

* Per i '''Catalyst 10.11''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.10-11_with_2.6.36.x.diff /etc/ati/patch/patch-8.791-$(uname -r)
#> sh ati-driver-installer-10-11-x86.x86_64.run --buildpkg

= Problemi noti =
== FATAL: modpost: GPL-incompatible module fglrx.ko uses GPL-only symbol 'paravirt_ops' ==
L'errore accade in fase di compilazione del modulo ed è dovuto al fatto che il kernel è stato compilato con l'opzione di
paravirtualizzazione attiva. Questa opzione tra le altre cose, impedisce di caricare, e quindi di compilare, moduli che non hanno la
licenza GPL. Visto che i driver ATI non hanno questo tipo di licenza, non vengono compilati.

Per ovviare al problema si può:
=== Disabilitare la paravirtualizzazione nel kernel ===
L'opzione di paravirtualizzazione si chiama '''CONFIG_PARAVIRT''' e generalmente si trova nel sottomenù '''Processor type and features''' del kernel.
=== Patchare i driver ATI ===
Questa operazione è illegale poichè si deve modificare il tipo di licenza rilasciata dalla ATI in GPL. Ho scritto la patch:

[http://www.slacky.eu/~spina/fglrx/patch/ati_to_gpl.patch ati_to_gpl.patch] (md5sum: 4207f41a71035dc2eed3ea9346b881bb)

di cui non mi prendo nessuna responsabilità, io non la uso e ne sconsiglio l'uso preferendo l'alternativa di disabilitare la paravirtualizzazione del kernel.
Per usare questa patch bisogna:

'''SlackBuild esterno''':
* Copiare la patch nella directory ''/etc/ati/custom-package/patch''

'''SlackBuild interno''' (solo con ATI Catalist > 8.11):
* Copiare la patch nella directory ''/etc/ati/patch'' (se non esiste, va creata)

Lo SlackBuild noterà la presenza della patch e la applicherà. Per disinstallare la patch basterà quindi cancellarla.

== Using GLX_SGIX_pbuffer FGLTexMgr: open of shared memory object failed (Permission denied) __FGLTexMgrCreateObject: __FGLTexMgrSHMmalloc failed!!! ==
Questo problema è dovuto alla mancanza nel sistema del filesystem SHM (oggi chiamato tmpfs), ovvero il virtual memory filesystem.
Per ovviare al problema si deve:
* Aggiungere al file ''/etc/fstab'' la seguente riga:
shm /dev/shm tmpfs defaults 0 0
* Quindi montare il filesystem tramite:
#> mount /dev/shm
Ovviamente il kernel deve essero predisposto al "montaggio" di questo filesystem, in particolare l'opzione del kernel che deve essere
abilitata è '''CONFIG_TMPFS''' che generalmente è sistuata nel sottomenù del kernel '''File systems --> Pseudo filesystems'''. C'è da dire però che tutti i kernel precompilati hanno generalmente questa opzione abilitata.

== kernel includes at /lib/modules/`uname -r`/build/include do not match current kernel ==
L'errore completo è qualcosa del genere:

Error:
kernel includes at /lib/modules/`uname -r`/build/include do not match current kernel.
they are versioned as ""
instead of "`uname -r`".
you might need to adjust your symlinks:
- /usr/include
- /usr/src/linux

L'errore, se pur spiegato può non essere chiaro. In pratica deriva dal fatto che i link simbolici:
/lib/modules/`uname -r`/source
/lib/modules/`uname -r`/build
non puntano alla directory in cui sono inseriti i sorgenti del kernel attuale (che generalmente è /usr/src/linux-`uname -r`). Accade a coloro che usano uno dei kernel contenuto nella Slackware, per cui cercherò di spiegarlo in termini di "pacchetti" Slackware. Questo può succedere:
* O perchè i sorgenti del kernel effettivamente non sono stati installati. In questo caso dovrebbe bastare installare il pacchetto dei sorgenti che si trova nella directory k/ della Slackware. Non è detto però che il problema venga risolto, si veda il secondo motivo per cui sussiste l'errore.
* O perchè i sorgenti (se pur installati) non rispecchiano le impostazioni dell'attuale kernel. La nuova Slackware 12 ha al suo interno un pò di kernel precompilati (che vuol dire impostazioni differenti) mentre un solo pacchetto per i sorgenti (a meno di vedere nel ramo extra/). In particolare i sorgenti sono per un kernel SMP e quindi se si utilizza un kernel precompilato non SMP può accare che si verifichi l'errore suddetto. Per ovviare basta fare quanto segue, dopo essersi assicurati che il pacchetto dei sorgenti è stato installato:
#> cd /usr/src/linux
#> cp /boot/config .config
#> make
:eseguendo il make, oltre a compilare il kernel e relativi moduli (che poi non useremo), si rigenerano alcuni file headers che rispecchiano la configurazione del kernel (per come impostata nel file .config).

== Logo nei driver 8.39.4 ==
Questo "bug" nei driver 8.39.4 deriva dal fatto che gli sviluppatori ATI non aggiornano i packager mantainer prima della release ufficiale. Sarebbe carino se facessero testare prima a noi le release ufficiali, in modo da certificare il corretto funzionamento degli script per creare i pacchetti. Per risolvere il problema si deve usare lo '''SlackBuild esterno''' come descritto [[#Versione dei driver < 8.37.6 (SlackBuild esterno) | qui]].

== amdcccle non parte con la Slackware 12 ==
Molti utenti che utilizzano la versione del server X.Org 7.2 (o 1.3) non riescono a lanciare correttamente il Catalyst. Il comando per eseguire il Catalyst è:
#> amdcccle
Per questo problema sembra non esserci ancora soluzione, ma stiamo lavorando per risolverlo.

= Link utili =
Il thread di discussione da cui è stato tratto questo articolo:
http://www.slacky.eu/forum/viewtopic.php?t=18134&highlight=

Un alternativa ai driver ufficiali ATI:
http://www.schneider-digital.de/

Una guida su come installare e configurare i driver (open source e proprietary) ATI:
http://www.slacky.eu/wikislack/index.php?title=Installazione_driver_ATI_su_Slackware_GNU/Linux

= Conclusione =
I driver proprietari ATI per molti notebook e moderni PC fissi risultano essere quasi l'unica alternativa per l'uso dell'accelerazione 3d con linux. Purtroppo gli sviluppatori ATI non effettuano il back porting e quindi gli utenti che fanno uso dei driver precedenti alla versione 8.37.6 non potranno mai passare alla versione 7.2 (o anche detto 1.3) o successive del server X.Org. Si spera quindi che ben presto i driver Mesa possano essere usati anche per queste schede video.

Inoltre, può succedere che la compilazione del modulo non abbia successo. Se è il vostro caso, scrivetemi tranquillamente all'indirizzo '''tomasi@cliDOTdiDOTunipiDOTit''' postandomi l'output dell'installer lanciato con l'opzione ''Only_Module''.

Ringrazio Ezio Ghibaudo e Federico Rota per aver iniziato questo wiki e per l'aiuto che mi hanno dato con lo SlackBuild.

Slackware: external SlackBuild (ENG)

2010-10-28T08:11:28Z

Spina: Aggiornati link al slacky.eu

== What it does ==
Starting with version 8.37.6, ATI proprietary drivers are able to create Slackware packages through an internal SlackBuild. To use this SlackBuild just run the driver's installer, the .run file that is possible to download from [http://ati.amd.com/support/driver.html ATI's official website], with the option:
--buildpkg Slackware/All
The page you're visiting is about the “twin” version of SlackBuild, which in the [http://www.slacky.eu/wikislack/index.php?title=ATI_Proprietary_drivers._Ecco_uno_slackbuild. official wiki (ITA)] is called '''external SlackBuild'''.

This SlackBuild deals with building Slackware packages of the ATI proprietary drivers, both versions before 8.37.6, in which the internal SlackBuild does not exist, and next versions, working just like internal SlackBuild, with the advantage that it is usually more powerful than his “brother”. In fact, many patches to drivers are discovered only after the official release, this means that the internal SlackBuild may not apply them while the external, which is updated very often and whenever is needed, can do that.

'''NOTE:''' since Catalyst 8.11 the '''external SlackBuild''' is't deprecated in favor to patch for '''internal SlackBuild'''.

== How it works ==
The use of the external SlackBuild is very easy, once downloaded and installed using the '''installpkg''' utility, simply run the ATI's installer driver with the following option:
--buildpkg custom-package/All
What happens is exactly the same as the internal SlackBuild, and It's described in the
[http://www.slacky.eu/wikislack/index.php?title=ATI_Proprietary_drivers._Ecco_uno_slackbuild. official wiki (ITA)].

== News ==
Currently the external SlackBuild is able to create Slackware packages for driver version <8.37.6 applying the patch for the new kernel series 2.6.2x. The ATI drivers version <8.37.6 weren't designed to run on these kernel and therefore they require a small patch that is applied by external SlackBuild.

* 16/01/08: added new mantainers' names, Ezio and Federico (See [[ATI Slack-Packager (ENG)#Contacts|Contacts]])
* 12/01/08: file ''amdpcsdb.default'' inserted in ''/etc/ati'', file needed for next driver version.
* 21/11/07: Small update to reflect the next official driver version.
* 03/08/07: Small update to reflect the next official driver version. ''/etc/ati/fglrxprofiles.csv'' and ''/etc/ati/fglrxrc'' are no longer distributed.
* 28/07/07:
** Fixed permissions in the fglrx driver configuration file, in ''/etc/ati'' directory. In addition, some files in this directory are considered administrator's “personal” configuration, and for these files has been created a .new file, which is created only if the original (the one without .new extension) does not exist. If the source exists and is equal to .new, the .new file is removed to avoid redundancy.
** The README file is moved from ''/etc/ati'' to ''/etc/ati/custom-package''.
* 27/07/07: Fixed bug in driver version 8.39.4 showing a logo in the bottom right corner of the screen.
* 07/09/07:
** Added links to libraries like .so.
** Based on users' reports, I have applied a driver patch in order to cancel the “error”:
make.sh: line xxx: [: =: unary operator expected
: when It compiles the fglrx kernel module (which is part of the fglrx-module package). I would like to underline that “bugs” isn't in SlackBuild, but into ATI's drivers. I submitted the bug to ATI also sending the small patches to solve it, but... I'm waiting yet :).

== Download ==
The latest SlackBuild version released is [http://www.slacky.eu/~spina/fglrx/ati-slack-packager-1.1.9-noarch-1.tgz 1.1.9].

== Patch ==
Here are some patches that can be applied to the external SlackBuild, these patches are considered illegal and therefore are not issued in the official version. I do not take any responsibility about the use of these patches, I have written them only for culture and put online for the same reason, I do not use them and I discourage their use.
To apply the patch just copy them in ''/etc/ati/custom-package/patch'' directory, while in order to uninstall them just remove them.

* [http://www.slacky.eu/~spina/fglrx/patch/ati_to_gpl.patch ati_to_gpl.patch].This patch modifies the ATI drivers in order to have a GPL license so to be able to use drivers with a kernel that has the para virtualization active. The preferable alternative is to disable the kernel para virtualization as explained [http://www.slacky.eu/wikislack/index.php?title=ATI_Proprietary_drivers._Ecco_uno_slackbuild.#Disabilitare_la_paravirtualizzazione_nel_kernel here (ITA)].

== Acknowledgments ==
I would like to thank all the [http://www.slacky.eu/ Italian Slackware Community] users for their feedback and support, especially (in alphabetical order, not certainly for importance):
* Ezio (alias ekxius),author, of an interesting [http://www.slacky.eu/wikislack/index.php?title=Installazione_driver_ATI_su_Slackware_GNU/Linux wiki (ITA)] about installation and configuration of ATI drivers (open and proprietary).
* Federico (alias stan), always ready to give me advice and letting me believe more and more on the importance of the project.

== Contacts ==
Original author:

Emanuele Tomasi < tomasiATcliDOTdiDOTunipiDOTit >

Slackware: SlackBuild esterno (ITA)

2010-10-28T08:08:50Z

Spina: Aggiornati link al slacky.eu

== Cosa fa ==
A partire dalla versione 8.37.6, i driver proprietari ATI hanno la possibilità di creare dei pacchetti Slackware grazie ad uno SlackBuild interno. Per usare questo SlackBuild basta lanciare l'installer dei driver, il file .run che è possibile scaricarare dal [http://ati.amd.com/support/driver.html sito ufficiale ATI], tramite l'opzione:
--buildpkg Slackware/All
La pagina che state visitando parla della versione “gemella” dello SlackBuild interno, che nel [http://www.slacky.eu/wikislack/index.php?title=ATI_Proprietary_drivers._Ecco_uno_slackbuild. wiki] ufficiale viene chiamato '''SlackBuild esterno'''.

Questo SlackBuild si occupa di creare dei pacchetti Slackware dei driver proprietari ATI, sia per le versioni precedenti alla 8.37.6, nei quali lo SlackBuild interno non esiste, sia per le versioni successive, agendo esattamente come lo SlackBuild interno, con il vantaggio che generalmente è più potente del “fratello”. Infatti molte patch ai driver vengono scoperte solo dopo il rilascio della versione ufficiale, questo vuol dire che lo SlackBuild interno non può applicarle mentre quello esterno, che viene aggiornato con molta frequenza ed ogni volta che ce ne è bisogno, può.

'''NOTA:''' a partire dai Catalyst 8.11 lo '''SlackBuild esterno''' è stato deprecato in favore delle patch per lo '''SlackBuild interno'''.

== Come si usa ==
L'uso dello SlackBuild esterno è molto semplice, una volta scaricato ed installato tramite l'utility '''installpkg''', basta lanciare l'installer dei driver ATI con la seguente opzione:
--buildpkg custom-package/All
Quello che accade è esattamente quello che accade con lo SlackBuild interno, e viene descritto nel
[http://www.slacky.eu/wikislack/index.php?title=ATI_Proprietary_drivers._Ecco_uno_slackbuild. wiki] ufficiale.

== Novità ==
Attualmente lo SlackBuild esterno è in grado di creare i pacchetti Slackware dei driver versione < 8.37.6 applicando la patch per il nuovo kernel della serie 2.6.2x. I driver ATI versione < 8.37.6 non erano stati concepiti per girare con questi kernel e quindi necessitano di una piccola patch che viene applicata dallo SlackBuild esterno.

* 16/01/08: Aggiunto il nome dei nuovi maintainer, Ezio e Federico (si veda [[ATI Slack-Packager (ITA)#Contatti|Contatti]])
* 12/01/08: Viene inserito nella directory ''/etc/ati'', il file ''amdpcsdb.default'', necessario per la prossima versione dei driver.
* 21/11/07: Piccolo aggiornamento per rispecchiare la prossima versione ufficiale dei driver.
* 03/08/07: Piccolo aggiornamento per rispecchiare la prossima versione ufficiale dei driver. I file ''/etc/ati/fglrxprofiles.csv'' e ''/etc/ati/fglrxrc'' non sono più distribuiti.
* 28/07/07:
** Aggiustato i permessi nei file di configurazione del driver fglrx nella directory ''/etc/ati''. Inoltre alcuni file nella stessa directory sono considerati di configurazione “personale” dell'amministratore, per questi file è stato creato un nuovo file .new che viene installato solo se l'originale (quello senza il .new) non esiste. Se l'originale esiste ed è uguale al .new, il .new viene rimosso per evitate la ridondanza.
** Il file README è stato spostato, dalla directory ''/etc/ati'' nella directory ''/etc/ati/custom-package''.
* 27/07/07: Corretto il “bug” della versione 8.39.4 dei driver che mostra un logo nella parte inferiore destra dello schermo.
* 07/09/07:
** Aggiunti i link alle librerie come .so.
** Su segnalazione di molti utenti ho applicato una patch ai driver in modo da eliminare l'“errore”:
make.sh: line xxx: [: =: unary operator expected
:quando viene compilato il modulo per il kernel fglrx (che fa parte del pacchetto fglrx-module). Tengo a precisare che il “bug” non è nello SlackBuild, ma nei driver ATI. Ho segnalato il “bug” alla ATI inviando anche la piccola patch per risolverlo ma...aspetto ancora :).

== Download ==
L'ultima versione dello SlackBuild esterno è la [http://www.slacky.eu/~spina/fglrx/ati-slack-packager-1.1.9-noarch-1.tgz 1.1.9]

== Patch ==
Di seguito ci sono alcune patch che si possono applicare allo SlackBuild esterno, queste patch sono ritenute illegali e pertanto non vengono rilasciate nella versione ufficiale. Non mi prendo nessuna responsabilità sull'uso di queste patch, le ho scritte solo per cultura e le metto online per lo stesso motivo, non le uso e ne sconsiglio l'uso.
Per applicare le patch basta copiarle nella directory ''/etc/ati/custom-package/patch'', mentre per disinstallarle basta rimuoverle.

* [http://www.slacky.eu/~spina/fglrx/patch/ati_to_gpl.patch ati_to_gpl.patch].Questa patch modifica i driver ATI in modo che presentino una licenza GPL cossicché da poter usare i driver con un kernel che ha la paravirtualizzazione attiva. L'alternativa preferibile è di disabilitare la paravirtualizzazione del kernel come spiegato [http://www.slacky.eu/wikislack/index.php?title=ATI_Proprietary_drivers._Ecco_uno_slackbuild.#Disabilitare_la_paravirtualizzazione_nel_kernel qui].

== Ringraziamenti ==
Ringrazio tutti gli utenti dell' [http://www.slacky.eu/ Italian Slackware Community] per il loro feedback e il loro appoggio morale, in particolare ringrazio (in ordine alfabetico, non certo per importanza):
* Ezio (alias ekxius), autore, tra l'altro di un interessante [http://www.slacky.eu/wikislack/index.php?title=Installazione_driver_ATI_su_Slackware_GNU/Linux wiki] sull'installazione e configurazione dei driver ATI (open e proprietari).
* Federico (alias stan), che è sempre pronto a darmi consigli facendomi credere sempre di più nell'importanza del progetto.

== Contatti ==
Autore originale:

Emanuele Tomasi < tomasiATcliDOTdiDOTunipiDOTit >

Slackware: ATI SlackBuild (ITA)

2010-10-14T23:31:42Z

Spina: /* ATI Catalyst 10.9 e Slackware64 13.1 e current */

= Introduzione =
Questo wiki spiega come installare i driver propritari ATI con la distribuzione linux Slackware, creando, grazie ad uno SlackBuild, dei
pacchetti che possono essere installati tramite il comando '''installpkg'''.

Il wiki NON spiega come migliorare le prestazioni. In particolare fornisce solo una descrizione minimale di come impostare il server X.Org
con l'unico scopo di far funzionare i driver proprietari (una descrizione su come configurare il server X.Org per ottenere prestazioni
più elevate la potete trovare [http://www.slacky.eu/wikislack/index.php?title=Installazione_driver_ATI_su_Slackware_GNU/Linux qui]).

Tutti i comandi che iniziano con un '#>' devono essere eseguiti con i diritti dell'utente root, mentre quello che iniziano con '$>' possono
essere eseguiti anche da un utente senza tali diritti.

= ATI Proprietary Driver e ATI Catalyst =
A partire dal 21 Novembre 2007 i driver ATI hanno cambiato nome e numero di versione. I nuovi driver, che prima venivano
indicati solo come '''ATI Proprietary Driver''', ora si chiamano '''ATI Catalyst'''. Non solo, il numero di versione
è passato da '''8.XX.X''' a '''7.XX'''.

Quando in questo articolo si parlerà dei driver ''versione < 8.37.6'', ci si riferirà implicitamente ai
vecchi driver, ovvero agli ATI Proprietary Driver, i nuovi ATI Catalyst sono da considerarsi ''versione >= 8.37.6'',
anche se, ad esempio, hanno come numero di release 7.11.

= Come ottenere tutto il software necessario =
I driver proprietari ATI possono essere scaricati dal sito ufficiale: http://ati.amd.com/support/driver.html, dopo aver selezionato il
sistema operativo Linux x86 (o Linux x86_64) e selezionato la propria scheda video, premendo il tasto "go" si arriva direttamente alla
pagina del download da cui bisognerà scaricare l'installer (che d'ora in poi chiameremo ''installer.run'').
Dato che i driver contengono anche un modulo del kernel che verrà compilato direttamente sul vostro sistema, è necessario
avere anche i sorgenti del kernel attualmente installato sul sistema.

'''NOTA:''' I driver per le architetture x86 e x86_64 sono equivalenti. L'installer infatti contiene i file per entrambe
le architetture, sarà poi il processo di compilazione e creazione dei pacchetti che sceglierà i file adeguati.
Questo vuol dire che lo SlackBuild andrà bene sia per la Slackware sia la Slackware64, sia per le varie versioni porting a 64 bit
(Slamd64, Bluewhite64, etc...).

= Nota IMPORTANTE =
Se la versione dei driver che si è scaricata è minore della 8.37.6 allora dovete sapere fin d'ora che non funzioneranno con
il server X.Org 7.2 (o 1.3) o successivi.

= Come creare i pacchetti per la Slackware =
La creazione dei pacchetti segue due strade differenti a seconda che si usino i driver ufficiali '''versione < 8.37.6''' oppure
'''versione >= 8.37.6 o nuovi ATI Catalyst'''.
La prima strada fa uso di quello che chiameremo '''SlackBuild esterno''' mentre la seconda di quello che chiameremo
'''SlackBuild interno'''.
In entrambi i casi verranno creati due pacchetti che potranno quindi essere installati tramite l'utiliti '''installpkg''' della Slackware.
Quindi passiamo a vedere i due casi ricordando che il programma che qui chiamiamo ''installer.run'' è l'installer che si è
scaricato dal sito della ATI.

== Versione dei driver < 8.37.6 (SlackBuild esterno) ==
Per questi tipi di driver ho creato uno '''SlackBuild esterno''' per la Slackware di cui ho fatto [http://www.slacky.eu/~spina/fglrx/ati-slack-packager-1.1.9-noarch-1.tgz questo pacchetto].

Per creare i pacchetti Slackware basta eseguire:
#> installpkg ati-slack-packager-current-noarch-1.tgz
#> sh installer.run --buildpkg custom-package/Slackware

'''NOTA:''' L'uso dello '''SlackBuild esterno''' è limitato alla versione dei '''driver < 8.37.6''' visto che dai nuovi ''' Catalyst 8.11''' si possono passare delle patch a quello interno.

== Versione dei driver >= 8.37.6 o nuovi ATI Catalyst (SlackBuild interno) ==
Per questi driver lo SlackBuild l'ho inviato direttamente alla ATI che ha provveduto ad inserirlo all'interno dell'installer, quindi basta
eseguire:
#> sh installer.run --buildpkg Slackware/All
o, se i driver sono abbastanza recenti (non ricordo la versione esatta), basta un semplice:
#> sh installer.run --buildpkg
Oppure, per creare ed installare direttamente i pacchetti, si può usare (sempre con versioni recenti dei driver):
#> sh intaller.run --buildandinstallpkg

= Cosa contengono i pacchetti creati? =
I due pacchetti creati dallo SlackBuild, che chiameremo ''fglrx-module'' e ''fglrx-x'', contengono, rispettivamente, il modulo per il
kernel attualmente installato sul sistema, e i driver per la versione del server X.Org installata.
In questo modo, se si aggiorna il kernel oppure il server X.Org si può creare solo il relativo pacchetto.

== Creare solo il pacchetto fglrx-module ==
Per creare solo il pacchetto contenente il modulo per il kernel attualmente installato, basta lanciare l'installer con l'opzione
''Only_Module ''.

Quindi, con lo '''SlackBuild esterno''':
#> sh installer.run --buildpkg custom-package/Only_Module
Con lo '''SlackBuild interno''':
#> sh installer.run --buildpkg Slackware/Only_Module

== Creare solo il pacchetto fglrx-x ==
Per creare solo il pacchetto contenente i driver per il server X.Org attualmente installato sul sistema, basta lanciare l'installer con
l'opzione ''Only_X''.

Con lo '''SlackBuild esterno''':
#> sh installer.run --buildpkg custom-package/Only_X
Con lo '''SlackBuild interno''':
#> sh installer.run --buildpkg Slackware/Only_X

= Configurazione minimale del server X.Org =
Una volta installati i due pacchetti bisogna segnalare al server X.Org di usare i driver proprietari ATI, per fare questo bisogna
controllare che il file xorg.conf, che generalmente è situato nella directory /etc/X11/, contenga le seguenti voci:

Section "Module"
....
Load "dri"
Load "glx"
....
EndSection

Section "Device"
....
Driver "fglrx"
....
EndSection

Section "DRI"
Group 0
Mode 0666
EndSection

= Verifica =
Per verificare se i driver proprietari ATI sono stati correttamente installati si può eseguire il comando:
$> fglrxinfo
Sulla mia macchina l'output è:
display: :0.0 screen: 0
OpenGL vendor string: ATI Technologies Inc.
OpenGL renderer string: ATI Mobility Radeon X1400
OpenGL version string: 2.0.6650 (8.39.4)

= Rimuovere i pacchetti installati =
Per rimuovere i pacchetti installati si può tranquillamente usare l'utiliti '''removepkg'''. Ci sono però aspetti che vanno
considerati:
* La rimozione dei pacchetti non elimina i file di configurazione del driver fglrx, questi file sono situati nella directory ''/etc/ati''
'''NOTA:''' La directory ''/etc/ati/custom-package'' se esiste, contiene lo '''SlackBuild esterno''' e quindi non va cancellata.
*Il pacchetto ''fglrx-x'' contiene le librerie OpenGL della ATI, e queste librerie sono posizionate nella stessa directory di quelle Mesa, indi per cui quando si installa il pacchetto ''fglrx-x'' vengono sovrascritte le OpenGL Mesa. Per ripristinare la situazione si deve semplicemente reinstallare il pacchetto contenente queste librerie, ovvero il pacchetto:
::x11
:si usa la Slackware 11, oppure:
::mesa
:se si usa la Slackware 12.

= Patchare i driver =
I driver ATI sono noti per essere sempre in ritardo rispetto all'aggiornamento del kernel linux. Spesso occorre quindi patchare i driver in modo tale che la creazione del modulo per il kernel abbia successo. A partire dagli ATI Catalist > 8.11 abbiamo inserito nello '''SlackBuild interno''' la possibilità di patchare i driver ATI prima che lo SlackBuild stesso esegua la compilazione del modulo per il kernel.

Per fare questo basta creare (o scaricare da internet) una patch e dargli questo path:

''/etc/ati/patch/patch-ATI_DRIVER_VERSION-KERNEL_VERSION''

dove:

ATI_DRIVER_VERSION deve essere uguale al risultato del comando:
$> sh installer.run -i | head -n1 | cut -d'-' -f2
KERNEL_VERSION deve essere uguale al risultato del comando:
$> uname -r

se la directory ''/et/ati/patch'' non esiste, va ovviamente creata.

Quindi, ad esempio, se si il primo dei due comandi da come risultato '''8.56''' e il secondo '''2.6.27.6''', la patch va chiamata: ''/etc/ati/patch/patch-8.56-2.6.27.6''

Lo '''SlackBuild interno''' automaticamente noterà la patch, e, se si è in possesso del programma '''patch''', eseguirà:
#> patch -p0 < /etc/ati/patch/patch-8.56-2.6.27.6

== Alcune patch ==
Di seguito alcune patch note e come usarle:

=== ATI Catalyst 10.3, 10.4 e kernel == 2.6.33.x ===
Scaricate la [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.3-4_with_2.6.33.x.diff patch] nella directory ''/tmp'', quindi:

* Per i '''Catalyst 10.3''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.3-4_with_2.6.33.x.diff /etc/ati/patch/patch-8.712-$(uname -r)
#> sh ati-driver-installer-10-3-x86.x86_64.run --buildpkg

* Per i '''Catalyst 10.4''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.3-4_with_2.6.33.x.diff /etc/ati/patch/patch-8.723-$(uname -r)
#> sh ati-driver-installer-10-4-x86.x86_64.run --buildpkg

=== ATI Catalyst 10.4, 10.5 e kernel == 2.6.34 ===
Scaricate la [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.4-5_with_2.6.34.diff patch] nella directory ''/tmp'', quindi:

* Per i '''Catalyst 10.4''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.4-5_with_2.6.34.diff /etc/ati/patch/patch-8.723-$(uname -r)
#> sh ati-driver-installer-10-4-x86.x86_64.run --buildpkg

* Per i '''Catalyst 10.5''' fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.4-5_with_2.6.34.diff /etc/ati/patch/patch-8.732-$(uname -r)
#> sh ati-driver-installer-10-4-x86.x86_64.run --buildpkg

=== ATI Catalyst 10.9 e Slackware64 13.1 o current ===
Scaricate la [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.9_with_Slackware64-13.1.diff patch] nella directory ''/tmp'', quindi fate:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.9_with_Slackware64-13.1.diff /etc/ati/patch/patch-8.771-$(uname -r)
#> sh ati-driver-installer-10-9-x86.x86_64.run --buildpkg
ad un certo punto l'installazione chiede:
<PRE>
can't find file to patch at input line 4
Perhaps you should have used the -p or --strip option?
The text leading up to this was:
--------------------------
|diff -ru ./2.6.x/Makefile ../../../../../../fglrx-install.uZLF8t/common/lib/modules/fglrx/build_mod//2.6.x/Makefile
|--- ./2.6.x/Makefile 2010-09-01 16:05:31.000000000 +0200
|+++ ../../../../../../fglrx-install.uZLF8t/common/lib/modules/fglrx/build_mod//2.6.x/Makefile 2010-09-23 08:47:24.000000000 +0200
--------------------------
File to patch:
</PRE>
quindi inserire:
./2.6.x/Makefile

= Problemi noti =
== FATAL: modpost: GPL-incompatible module fglrx.ko uses GPL-only symbol 'paravirt_ops' ==
L'errore accade in fase di compilazione del modulo ed è dovuto al fatto che il kernel è stato compilato con l'opzione di
paravirtualizzazione attiva. Questa opzione tra le altre cose, impedisce di caricare, e quindi di compilare, moduli che non hanno la
licenza GPL. Visto che i driver ATI non hanno questo tipo di licenza, non vengono compilati.

Per ovviare al problema si può:
=== Disabilitare la paravirtualizzazione nel kernel ===
L'opzione di paravirtualizzazione si chiama '''CONFIG_PARAVIRT''' e generalmente si trova nel sottomenù '''Processor type and features''' del kernel.
=== Patchare i driver ATI ===
Questa operazione è illegale poichè si deve modificare il tipo di licenza rilasciata dalla ATI in GPL. Ho scritto la patch:

[http://www.slacky.eu/~spina/fglrx/patch/ati_to_gpl.patch ati_to_gpl.patch] (md5sum: 4207f41a71035dc2eed3ea9346b881bb)

di cui non mi prendo nessuna responsabilità, io non la uso e ne sconsiglio l'uso preferendo l'alternativa di disabilitare la paravirtualizzazione del kernel.
Per usare questa patch bisogna:

'''SlackBuild esterno''':
* Copiare la patch nella directory ''/etc/ati/custom-package/patch''

'''SlackBuild interno''' (solo con ATI Catalist > 8.11):
* Copiare la patch nella directory ''/etc/ati/patch'' (se non esiste, va creata)

Lo SlackBuild noterà la presenza della patch e la applicherà. Per disinstallare la patch basterà quindi cancellarla.

== Using GLX_SGIX_pbuffer FGLTexMgr: open of shared memory object failed (Permission denied) __FGLTexMgrCreateObject: __FGLTexMgrSHMmalloc failed!!! ==
Questo problema è dovuto alla mancanza nel sistema del filesystem SHM (oggi chiamato tmpfs), ovvero il virtual memory filesystem.
Per ovviare al problema si deve:
* Aggiungere al file ''/etc/fstab'' la seguente riga:
shm /dev/shm tmpfs defaults 0 0
* Quindi montare il filesystem tramite:
#> mount /dev/shm
Ovviamente il kernel deve essero predisposto al "montaggio" di questo filesystem, in particolare l'opzione del kernel che deve essere
abilitata è '''CONFIG_TMPFS''' che generalmente è sistuata nel sottomenù del kernel '''File systems --> Pseudo filesystems'''. C'è da dire però che tutti i kernel precompilati hanno generalmente questa opzione abilitata.

== kernel includes at /lib/modules/`uname -r`/build/include do not match current kernel ==
L'errore completo è qualcosa del genere:

Error:
kernel includes at /lib/modules/`uname -r`/build/include do not match current kernel.
they are versioned as ""
instead of "`uname -r`".
you might need to adjust your symlinks:
- /usr/include
- /usr/src/linux

L'errore, se pur spiegato può non essere chiaro. In pratica deriva dal fatto che i link simbolici:
/lib/modules/`uname -r`/source
/lib/modules/`uname -r`/build
non puntano alla directory in cui sono inseriti i sorgenti del kernel attuale (che generalmente è /usr/src/linux-`uname -r`). Accade a coloro che usano uno dei kernel contenuto nella Slackware, per cui cercherò di spiegarlo in termini di "pacchetti" Slackware. Questo può succedere:
* O perchè i sorgenti del kernel effettivamente non sono stati installati. In questo caso dovrebbe bastare installare il pacchetto dei sorgenti che si trova nella directory k/ della Slackware. Non è detto però che il problema venga risolto, si veda il secondo motivo per cui sussiste l'errore.
* O perchè i sorgenti (se pur installati) non rispecchiano le impostazioni dell'attuale kernel. La nuova Slackware 12 ha al suo interno un pò di kernel precompilati (che vuol dire impostazioni differenti) mentre un solo pacchetto per i sorgenti (a meno di vedere nel ramo extra/). In particolare i sorgenti sono per un kernel SMP e quindi se si utilizza un kernel precompilato non SMP può accare che si verifichi l'errore suddetto. Per ovviare basta fare quanto segue, dopo essersi assicurati che il pacchetto dei sorgenti è stato installato:
#> cd /usr/src/linux
#> cp /boot/config .config
#> make
:eseguendo il make, oltre a compilare il kernel e relativi moduli (che poi non useremo), si rigenerano alcuni file headers che rispecchiano la configurazione del kernel (per come impostata nel file .config).

== Logo nei driver 8.39.4 ==
Questo "bug" nei driver 8.39.4 deriva dal fatto che gli sviluppatori ATI non aggiornano i packager mantainer prima della release ufficiale. Sarebbe carino se facessero testare prima a noi le release ufficiali, in modo da certificare il corretto funzionamento degli script per creare i pacchetti. Per risolvere il problema si deve usare lo '''SlackBuild esterno''' come descritto [[#Versione dei driver < 8.37.6 (SlackBuild esterno) | qui]].

== amdcccle non parte con la Slackware 12 ==
Molti utenti che utilizzano la versione del server X.Org 7.2 (o 1.3) non riescono a lanciare correttamente il Catalyst. Il comando per eseguire il Catalyst è:
#> amdcccle
Per questo problema sembra non esserci ancora soluzione, ma stiamo lavorando per risolverlo.

= Link utili =
Il thread di discussione da cui è stato tratto questo articolo:
http://www.slacky.eu/forum/viewtopic.php?t=18134&highlight=

Un alternativa ai driver ufficiali ATI:
http://www.schneider-digital.de/

Una guida su come installare e configurare i driver (open source e proprietary) ATI:
http://www.slacky.eu/wikislack/index.php?title=Installazione_driver_ATI_su_Slackware_GNU/Linux

= Conclusione =
I driver proprietari ATI per molti notebook e moderni PC fissi risultano essere quasi l'unica alternativa per l'uso dell'accelerazione 3d con linux. Purtroppo gli sviluppatori ATI non effettuano il back porting e quindi gli utenti che fanno uso dei driver precedenti alla versione 8.37.6 non potranno mai passare alla versione 7.2 (o anche detto 1.3) o successive del server X.Org. Si spera quindi che ben presto i driver Mesa possano essere usati anche per queste schede video.

Inoltre, può succedere che la compilazione del modulo non abbia successo. Se è il vostro caso, scrivetemi tranquillamente all'indirizzo '''tomasi@cliDOTdiDOTunipiDOTit''' postandomi l'output dell'installer lanciato con l'opzione ''Only_Module''.

Ringrazio Ezio Ghibaudo e Federico Rota per aver iniziato questo wiki e per l'aiuto che mi hanno dato con lo SlackBuild.

Slackware: ATI SlackBuild (ENG)

2010-10-14T23:30:59Z

Spina: /* ATI Catalyst 10.9 and Slackware64 13.1 e current */

== Introduction ==
This wiki explains how to install the proprietary ATI drivers in a Slackware Linux distribution, creating, thanks to a SlackBuild, packages that can be installed through the '''installpkg''' command.

This wiki DOES NOT explain how to improve performance. In particular, It provides only a minimal description of how to set up the X.Org server with the only purpose of loading the proprietary drivers (a description on how to configure the X.Org server to increase performance can be found here).

All commands starting with a '#>' must be executed with root rights, while commands beginning with '$>' can be performed by a user without such rights.

== Proprietary ATI Drivers and ATI Catalyst ==
Since 21 November 2007, ATI drivers have changed the name and the number version. The new drivers, which were first mentioned only as Proprietary ATI Driver, are now called ATI Catalyst. Moreover, the version number has passed from 8.XX.X to 7.XX.

When in this wiki we will talk about drivers version <8.37.6, we will refer implicitly to the old driver, such as Proprietary ATI Driver, while the new ATI Catalyst have a number version >= 8.37.6, even if, for instance, have a release number 7.11.

== Getting all the necessary ==
The proprietary ATI drivers can be downloaded from the [http://ati.amd.com/support/driver.html official web site], after selecting the Linux x86 operating system (or Linux x86_64) and selecting your video card, pressing the “go” button takes you directly into the download page from which you can download the installer (which henceforth we call installer.run).
Since drivers also contain a kernel module which will be compiled directly on your system, you'll need the kernel source currently installed in the system as well.

'''NOTE:''' Drivers for x86 and x86_64 architectures are equivalent. The installer contains files for both architectures, then It will be the compilation process and the package
creation process to choose the appropriate files.
This means that '''the SlackBuild will be good for Slackware, Slackware64 and for Slackware 64-bit portings (Slamd64, Bluewhite64, etc. ...)'''.

== Important notice ==
If the downloaded driver version is less than 8.37.6, then you need to know from now that it will not work onto X.Org 7.2 server (or 1.3) or later.

== How to create Slackware packages ==
The packages creation follows two different ways depending on whether you use the official driver version '''< 8.37.6''' or '''>= 8.37.6''' or new '''ATI Catalyst'''.
The first way uses what is called '''external SlackBuild''' while the second way what we will call '''internal SlackBuild'''.
In both cases the two packages will be created and they can be installed by Slackware '''installpkg''' utility.
So let's see the two cases saying that the program that here is called installer.run is the installer downloaded from ATI web site.

=== Drivers version < 8.37.6 (external SlackBuild) ===
For these types of drivers I've created an '''external SlackBuild''' for Slackware and I made [http://www.slacky.eu/~spina/fglrx/ati-slack-packager-1.1.9-noarch-1.tgz this package].

To create Slackware packages simply run:
#> installpkg ati-slack-packager-current-noarch-1.tgz
#> sh installer.run -- buildpkg custom-package/Slackware

'''NOTE:''' The '''external SlackBuild''' use is limited to the driver '''< 8.37.6''' since from new '''Catalyst 8.11''' you can pass the patches at the '''internal SlackBuild'''.

=== Drivers version >= 8.37.6 or new ATI Catalyst (internal SlackBuild) ===
For these drivers I've sent the SlackBuild directly to ATI which inserted it into the installer, then simply run:
#> sh installer.run --buildpkg Slackware/All
or, if drivers are quite recent, it suffices:
#> sh installer.run --buildpkg
Otherwise, in order to create and install directly the packages you can use (always with recent versions of the driver):
#> sh installer.run --buildandinstallpkg

此处的意思是：如果是新装的系统，直接运行本处的最后一个命令即可同时完成创建包和安装包的过程。

== What do created packages contain? ==
The two packages created by SlackBuild, that we'll call ''fglrx-module'' and ''fglrx-x'' contain, respectively, the kernel module and the X.Org server driver currently installed in the system.
In this way, if you upgrade the kernel or the X.Org server, you can create only one package.

=== Creating only fglrx-module package ===
To create just the package containing the kernel module for the currently installed kernel, simply run the installer with the ''Only_Module'' option.

So with '''external SlackBuild''':
#> sh installer.run --buildpkg custom-package/Only_Module
With '''internal SlackBuild''':
#> sh installer.run --buildpkg Slackware/Only_Module

=== Creating only fglrx-x package ===
To create just the package containing the X.Org driver currently installed in your system, simply run installer with ''Only_X'' option.

With '''external SlackBuild''':
#> sh installer.run --buildpkg custom-package/Only_X
With '''internal SlackBuild''':
#> sh installer.run --buildpkg Slackware/Only_X

（如果进行了上一小节的 --buildandinstallpkg则本小节的命令可不必再执行）

接下来，执行

#> sh installer.run

即可进入ATI配置的界面，完成显卡的简单配置。

== Minimal X.Org server configuration ==
Once installed the two indicated packages, you must tell to the X.Org server to use ATI proprietary drivers, to do this we must check if the xorg.conf file, which is usually located in the ''/etc/X11/'' directory, contains the following items:

Section "Module"
...
Load "dri"
Load "glx"
...
EndSection

Section "Device"
...
Driver "fglrx"
...
EndSection

Section "DRI"
Group 0
Mode 0666
EndSection

== Installation checking ==
To see if proprietary ATI drivers are properly installed run the command:
$> fglrxinfo
On my computer the output is:
display::0.0 screen: 0
OpenGL vendor string: ATI Technologies Inc.
OpenGL renderer string: ATI Mobility Radeon X1400
OpenGL version string: 2.0.6650 (8.39.4)

== Remove installed packages ==
To remove installed packages you can use the '''removepkg''' utility. However, there are aspects that should be considered:
* The packages' removing don't delete fglrx's driver configuration files, these files are located in ''/etc/ati'' directory
'''NOTE:''' The /etc/ati/custom-package directory, if exists, contains the '''external SlackBuild''' and therefore should not be deleted.
* The fglrx-x package contains ATI's OpenGL libraries, and these libraries are located in the same directory of the Mesa libraries, so when you install the fglrx-x package Mesa OpenGL libraries are overridden. To restore the situation you should simply reinstall the package containing these libraries, like:
::x11
:for Slackware 11, or:
::mesa
:for Slackware 12.

= Patching the drivers =
Ati drivers are usually not compatible with brand new version of kernel linux. You often need to patch the driver so that you can create the kernel module successfully. Since Ati Catalyst > 8.11 you can patch Ati drivers within the '''internal SlackBuild''' before that same SlackBuild compiles the kernel module.

In order to do that, you just have to create (or download from the Internet) a patch and rename it like this:

''/etc/ati/patch/patch-ATI_DRIVER_VERSION-KERNEL_VERSION''

where:

ATI_DRIVER_VERSION must be equal to the output of:
$> sh installer.run -i | head -n1 | cut -d'-' -f2
KERNEL_VERSION must be equal to the output of:
$> uname -r

If ''/etc/ati/patch'' doesn't exist, it must be made.

For example, if the former command outputs "8.55" and the latter "2.6.27.6", you need to name the patch ''/etc/ati/patch/patch-8.56-2.6.27.6''.

The '''internal SlackBuild''' will find the patch automatically and, if the command '''patch''' is installed, it will run:
#> patch -p0 < /etc/ati/patch/patch-8.56-2.6.27.6

== Patches ==
Here some patches and how to use there:

=== ATI Catalyst 10.3, 10.4 and kernel == 2.6.33.x ===
Download the [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.3-4_with_2.6.33.x.diff patch] into ''/tmp'', so:

* For '''Catalyst 10.3''' do:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.3-4_with_2.6.33.x.diff /etc/ati/patch/patch-8.712-$(uname -r)
#> sh ati-driver-installer-10-3-x86.x86_64.run --buildpkg

* For '''Catalyst 10.4''' do:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.3-4_with_2.6.33.x.diff /etc/ati/patch/patch-8.723-$(uname -r)
#> sh ati-driver-installer-10-4-x86.x86_64.run --buildpkg

=== ATI Catalyst 10.4, 10.5 and kernel == 2.6.34 ===
Download the [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.4-5_with_2.6.34.diff patch] into ''/tmp'', so:

* For '''Catalyst 10.4''' do:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.4-5_with_2.6.34.diff /etc/ati/patch/patch-8.723-$(uname -r)
#> sh ati-driver-installer-10-4-x86.x86_64.run --buildpkg

* For '''Catalyst 10.5''' do:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.4-5_with_2.6.34.diff /etc/ati/patch/patch-8.732-$(uname -r)
#> sh ati-driver-installer-10-4-x86.x86_64.run --buildpkg

=== ATI Catalyst 10.9 and Slackware64 13.1 or current ===
Download the [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.9_with_Slackware64-13.1.diff patch] into ''/tmp'', so to do:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.9_with_Slackware64-13.1.diff /etc/ati/patch/patch-8.771-$(uname -r)
#> sh ati-driver-installer-10-9-x86.x86_64.run --buildpkg
at one point the installer asks:
<PRE>
can't find file to patch at input line 4
Perhaps you should have used the -p or --strip option?
The text leading up to this was:
--------------------------
|diff -ru ./2.6.x/Makefile ../../../../../../fglrx-install.uZLF8t/common/lib/modules/fglrx/build_mod//2.6.x/Makefile
|--- ./2.6.x/Makefile 2010-09-01 16:05:31.000000000 +0200
|+++ ../../../../../../fglrx-install.uZLF8t/common/lib/modules/fglrx/build_mod//2.6.x/Makefile 2010-09-23 08:47:24.000000000 +0200
--------------------------
File to patch:
</PRE>
insert:
./2.6.x/Makefile

= Known problems =
== FATAL: modpost: GPL-incompatible module fglrx.ko uses GPL-only symbol 'paravirt_ops' ==
The error occurs during module compilation and It's due to the fact that the kernel was compiled with the option of paravirtualization active. This option among other things, prevents to load, and then to compile, modules that do not have the GPL license. Since that ATI drivers don't have this type of license, they aren't compiled.

To work around this problem you can:
==== Disable kernel paravirtualization option ====
The paravirtualization option is called '''CONFIG_PARAVIRT''' and generally is in the '''Processor type and features''' kernel submenu.
==== Patch ATI drivers ====
This operation is illegal because It changes the type of license issued by ATI in a GPL license. I wrote the patch:

[http://www.slacky.eu/~spina/fglrx/patch/ati_to_gpl.patch ati_to_gpl.patch] (md5sum: 4207f41a71035dc2eed3ea9346b881bb)

but I do not take any responsibility, I do not use It and I discourage the use in order to prefer the alternative to disable the paravirtualization kernel option. To use this patch You need to:

'''External SlackBuild'''
* Copy the patch in the ''/etc/ati/custom-package/patch'' directory

'''Internal SlackBuild''' (only with Ati Catalyst > 8.11):
* Copy the patch in the ''/etc/ati/patch'' directory (if it doesn't exist you must create it)

The SlackBuild will find and apply the patch automatically. In order to uninstall it you simply need to delete it. In order to uninstall the patch simply delete It from ''/etc/ati/custom-package/patch'' directory.

== Using GLX_SGIX_pbuffer FGLTexMgr: open of shared memory object failed (Permission denied) __FGLTexMgrCreateObject: __FGLTexMgrSHMmalloc failed!!! ==
This problem is due to the lack of SHM filesystem (now called tmpfs), that is virtual memory filesystem. To work around this problem you must:
* Add into ''/etc/fstab'' file the following line:
shm /dev/shm tmpfs defaults 0 0
* Then mount the filesystem through:
#> mount /dev/shm
Obviously the kernel must be predisposed for the "mounting" of this filesystem, in particular the
kernel option that must be enabled is '''CONFIG_TMPFS''' that is generally placed in '''File system --> Pseudo filesystems''' submenu. However all the compiled kernel generally have this option enabled.

== kernel includes at /lib/modules/`uname -r`/build/include do not match current kernel ==
The complete mistake is something like this:

Error:
kernel includes at /lib/modules/`uname -r`/build/include do not match current kernel.
they are versioned as ""
instead of "`uname -r`".
you might need to adjust your symlinks:
- /usr/include
- /usr/src/linux

The error, also if explained, could be not clear. In practice It results from the fact that the symbolic link:
/lib/modules/`uname -r`/source
/lib/modules/`uname -r`/build
don't point to the directory where are inserted the current kernel sources (which is generally ''/usr/src/linux- 'uname-r'''). It happens to those who use a kernel contained in Slackware, so I will try to explain It in terms of Slackware "packages". This can happen:
* because the kernel source were not installed. In this case should be enough to install the source package which can be found in Slackware k/ directory. However, It is not granted that the problem will be solved, You'll need to see the second reason why there is an error.
* because sources (also if installed) do not reflect the settings of the current kernel. The new Slackware 12 has some precompiled kernels (which means different settings), while just a single package for the sources (unless seeing the branch extra/). In particular, the sources are for the SMP kernel and so if you use a non-SMP kernel can appear this error. To avoid this, after making sure that the package source has been installed, do simply the following:
#> cd /usr/src/linux
#> cp /boot/config .config
#> make
:running make, in addition to compiling the kernel modules (which we will not use), some header files are regenerated, and they will reflect the kernel configuration (as it's set in the .config file).

== Driver 8.39.4 logo ==
This "bug" in 8.39.4 drivers results from the fact that ATI developers don't update the packager maintainers before the official releases. It should be nice first if they did test us official releases in order to certify the proper functioning of the scripts for creating packages. To solve the problem it's necessary to use the '''external SlackBuild''' as described here.

== amdcccle don't start on Slackware 12 ==
Many users of the X.Org 7.2 (or 1.3) server version fail to start properly the Catalyst. The command to run the Catalyst is:
#> amdcccle
For this problem it seems there is no solution yet, but we are working on to solve it.

= Useful links =
The discussion thread from which it was derived this article:
http://www.slacky.eu/forum/viewtopic.php?t=18134&highlight=

An alternative to official ATI drivers:
http://www.schneider-digital.de/

A wiki in italian about installing and configuring ATI drivers (open source and proprietary):
http://www.slacky.eu/wikislack/index.php?title=Installazione_driver_ATI_su_Slackware_GNU/Linux

= Conclusion =
Proprietary ATI drivers for many modern desktop and notebook PC seems are almost the only alternative to the use of 3d acceleration with linux. Unfortunately ATI developers don't make back porting and then users using drivers' version older than 8.37.6 will never go to X.Org server version 7.2 (alias 1.3) or later. Let's hope that Mesa drivers can also be used for these cards.

Also, It could happen that the module compilation fails. If so, feel free to write me at '''tomasiATcliDOTdiDOTunipiDOTit''' posting me the output generated by Only_Module option.

Thank you at Ezio Ghibaudo and Federico Rota who have started this wiki and for help with the SlackBuild.

Slackware: ATI SlackBuild (ENG)

2010-10-14T23:29:57Z

Spina: e -> and

== Introduction ==
This wiki explains how to install the proprietary ATI drivers in a Slackware Linux distribution, creating, thanks to a SlackBuild, packages that can be installed through the '''installpkg''' command.

This wiki DOES NOT explain how to improve performance. In particular, It provides only a minimal description of how to set up the X.Org server with the only purpose of loading the proprietary drivers (a description on how to configure the X.Org server to increase performance can be found here).

All commands starting with a '#>' must be executed with root rights, while commands beginning with '$>' can be performed by a user without such rights.

== Proprietary ATI Drivers and ATI Catalyst ==
Since 21 November 2007, ATI drivers have changed the name and the number version. The new drivers, which were first mentioned only as Proprietary ATI Driver, are now called ATI Catalyst. Moreover, the version number has passed from 8.XX.X to 7.XX.

When in this wiki we will talk about drivers version <8.37.6, we will refer implicitly to the old driver, such as Proprietary ATI Driver, while the new ATI Catalyst have a number version >= 8.37.6, even if, for instance, have a release number 7.11.

== Getting all the necessary ==
The proprietary ATI drivers can be downloaded from the [http://ati.amd.com/support/driver.html official web site], after selecting the Linux x86 operating system (or Linux x86_64) and selecting your video card, pressing the “go” button takes you directly into the download page from which you can download the installer (which henceforth we call installer.run).
Since drivers also contain a kernel module which will be compiled directly on your system, you'll need the kernel source currently installed in the system as well.

'''NOTE:''' Drivers for x86 and x86_64 architectures are equivalent. The installer contains files for both architectures, then It will be the compilation process and the package
creation process to choose the appropriate files.
This means that '''the SlackBuild will be good for Slackware, Slackware64 and for Slackware 64-bit portings (Slamd64, Bluewhite64, etc. ...)'''.

== Important notice ==
If the downloaded driver version is less than 8.37.6, then you need to know from now that it will not work onto X.Org 7.2 server (or 1.3) or later.

== How to create Slackware packages ==
The packages creation follows two different ways depending on whether you use the official driver version '''< 8.37.6''' or '''>= 8.37.6''' or new '''ATI Catalyst'''.
The first way uses what is called '''external SlackBuild''' while the second way what we will call '''internal SlackBuild'''.
In both cases the two packages will be created and they can be installed by Slackware '''installpkg''' utility.
So let's see the two cases saying that the program that here is called installer.run is the installer downloaded from ATI web site.

=== Drivers version < 8.37.6 (external SlackBuild) ===
For these types of drivers I've created an '''external SlackBuild''' for Slackware and I made [http://www.slacky.eu/~spina/fglrx/ati-slack-packager-1.1.9-noarch-1.tgz this package].

To create Slackware packages simply run:
#> installpkg ati-slack-packager-current-noarch-1.tgz
#> sh installer.run -- buildpkg custom-package/Slackware

'''NOTE:''' The '''external SlackBuild''' use is limited to the driver '''< 8.37.6''' since from new '''Catalyst 8.11''' you can pass the patches at the '''internal SlackBuild'''.

=== Drivers version >= 8.37.6 or new ATI Catalyst (internal SlackBuild) ===
For these drivers I've sent the SlackBuild directly to ATI which inserted it into the installer, then simply run:
#> sh installer.run --buildpkg Slackware/All
or, if drivers are quite recent, it suffices:
#> sh installer.run --buildpkg
Otherwise, in order to create and install directly the packages you can use (always with recent versions of the driver):
#> sh installer.run --buildandinstallpkg

此处的意思是：如果是新装的系统，直接运行本处的最后一个命令即可同时完成创建包和安装包的过程。

== What do created packages contain? ==
The two packages created by SlackBuild, that we'll call ''fglrx-module'' and ''fglrx-x'' contain, respectively, the kernel module and the X.Org server driver currently installed in the system.
In this way, if you upgrade the kernel or the X.Org server, you can create only one package.

=== Creating only fglrx-module package ===
To create just the package containing the kernel module for the currently installed kernel, simply run the installer with the ''Only_Module'' option.

So with '''external SlackBuild''':
#> sh installer.run --buildpkg custom-package/Only_Module
With '''internal SlackBuild''':
#> sh installer.run --buildpkg Slackware/Only_Module

=== Creating only fglrx-x package ===
To create just the package containing the X.Org driver currently installed in your system, simply run installer with ''Only_X'' option.

With '''external SlackBuild''':
#> sh installer.run --buildpkg custom-package/Only_X
With '''internal SlackBuild''':
#> sh installer.run --buildpkg Slackware/Only_X

（如果进行了上一小节的 --buildandinstallpkg则本小节的命令可不必再执行）

接下来，执行

#> sh installer.run

即可进入ATI配置的界面，完成显卡的简单配置。

== Minimal X.Org server configuration ==
Once installed the two indicated packages, you must tell to the X.Org server to use ATI proprietary drivers, to do this we must check if the xorg.conf file, which is usually located in the ''/etc/X11/'' directory, contains the following items:

Section "Module"
...
Load "dri"
Load "glx"
...
EndSection

Section "Device"
...
Driver "fglrx"
...
EndSection

Section "DRI"
Group 0
Mode 0666
EndSection

== Installation checking ==
To see if proprietary ATI drivers are properly installed run the command:
$> fglrxinfo
On my computer the output is:
display::0.0 screen: 0
OpenGL vendor string: ATI Technologies Inc.
OpenGL renderer string: ATI Mobility Radeon X1400
OpenGL version string: 2.0.6650 (8.39.4)

== Remove installed packages ==
To remove installed packages you can use the '''removepkg''' utility. However, there are aspects that should be considered:
* The packages' removing don't delete fglrx's driver configuration files, these files are located in ''/etc/ati'' directory
'''NOTE:''' The /etc/ati/custom-package directory, if exists, contains the '''external SlackBuild''' and therefore should not be deleted.
* The fglrx-x package contains ATI's OpenGL libraries, and these libraries are located in the same directory of the Mesa libraries, so when you install the fglrx-x package Mesa OpenGL libraries are overridden. To restore the situation you should simply reinstall the package containing these libraries, like:
::x11
:for Slackware 11, or:
::mesa
:for Slackware 12.

= Patching the drivers =
Ati drivers are usually not compatible with brand new version of kernel linux. You often need to patch the driver so that you can create the kernel module successfully. Since Ati Catalyst > 8.11 you can patch Ati drivers within the '''internal SlackBuild''' before that same SlackBuild compiles the kernel module.

In order to do that, you just have to create (or download from the Internet) a patch and rename it like this:

''/etc/ati/patch/patch-ATI_DRIVER_VERSION-KERNEL_VERSION''

where:

ATI_DRIVER_VERSION must be equal to the output of:
$> sh installer.run -i | head -n1 | cut -d'-' -f2
KERNEL_VERSION must be equal to the output of:
$> uname -r

If ''/etc/ati/patch'' doesn't exist, it must be made.

For example, if the former command outputs "8.55" and the latter "2.6.27.6", you need to name the patch ''/etc/ati/patch/patch-8.56-2.6.27.6''.

The '''internal SlackBuild''' will find the patch automatically and, if the command '''patch''' is installed, it will run:
#> patch -p0 < /etc/ati/patch/patch-8.56-2.6.27.6

== Patches ==
Here some patches and how to use there:

=== ATI Catalyst 10.3, 10.4 and kernel == 2.6.33.x ===
Download the [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.3-4_with_2.6.33.x.diff patch] into ''/tmp'', so:

* For '''Catalyst 10.3''' do:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.3-4_with_2.6.33.x.diff /etc/ati/patch/patch-8.712-$(uname -r)
#> sh ati-driver-installer-10-3-x86.x86_64.run --buildpkg

* For '''Catalyst 10.4''' do:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.3-4_with_2.6.33.x.diff /etc/ati/patch/patch-8.723-$(uname -r)
#> sh ati-driver-installer-10-4-x86.x86_64.run --buildpkg

=== ATI Catalyst 10.4, 10.5 and kernel == 2.6.34 ===
Download the [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.4-5_with_2.6.34.diff patch] into ''/tmp'', so:

* For '''Catalyst 10.4''' do:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.4-5_with_2.6.34.diff /etc/ati/patch/patch-8.723-$(uname -r)
#> sh ati-driver-installer-10-4-x86.x86_64.run --buildpkg

* For '''Catalyst 10.5''' do:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.4-5_with_2.6.34.diff /etc/ati/patch/patch-8.732-$(uname -r)
#> sh ati-driver-installer-10-4-x86.x86_64.run --buildpkg

=== ATI Catalyst 10.9 and Slackware64 13.1 e current ===
Download the [http://www.slacky.eu/~spina/fglrx/patch/fglrx_10.9_with_Slackware64-13.1.diff patch] into ''/tmp'', so to do:
#> mkdir -p /etc/ati/patch/
#> mv /tmp/fglrx_10.9_with_Slackware64-13.1.diff /etc/ati/patch/patch-8.771-$(uname -r)
#> sh ati-driver-installer-10-9-x86.x86_64.run --buildpkg
at one point the installer asks:
<PRE>
can't find file to patch at input line 4
Perhaps you should have used the -p or --strip option?
The text leading up to this was:
--------------------------
|diff -ru ./2.6.x/Makefile ../../../../../../fglrx-install.uZLF8t/common/lib/modules/fglrx/build_mod//2.6.x/Makefile
|--- ./2.6.x/Makefile 2010-09-01 16:05:31.000000000 +0200
|+++ ../../../../../../fglrx-install.uZLF8t/common/lib/modules/fglrx/build_mod//2.6.x/Makefile 2010-09-23 08:47:24.000000000 +0200
--------------------------
File to patch:
</PRE>
insert:
./2.6.x/Makefile

= Known problems =
== FATAL: modpost: GPL-incompatible module fglrx.ko uses GPL-only symbol 'paravirt_ops' ==
The error occurs during module compilation and It's due to the fact that the kernel was compiled with the option of paravirtualization active. This option among other things, prevents to load, and then to compile, modules that do not have the GPL license. Since that ATI drivers don't have this type of license, they aren't compiled.

To work around this problem you can:
==== Disable kernel paravirtualization option ====
The paravirtualization option is called '''CONFIG_PARAVIRT''' and generally is in the '''Processor type and features''' kernel submenu.
==== Patch ATI drivers ====
This operation is illegal because It changes the type of license issued by ATI in a GPL license. I wrote the patch:

[http://www.slacky.eu/~spina/fglrx/patch/ati_to_gpl.patch ati_to_gpl.patch] (md5sum: 4207f41a71035dc2eed3ea9346b881bb)

but I do not take any responsibility, I do not use It and I discourage the use in order to prefer the alternative to disable the paravirtualization kernel option. To use this patch You need to:

'''External SlackBuild'''
* Copy the patch in the ''/etc/ati/custom-package/patch'' directory

'''Internal SlackBuild''' (only with Ati Catalyst > 8.11):
* Copy the patch in the ''/etc/ati/patch'' directory (if it doesn't exist you must create it)

The SlackBuild will find and apply the patch automatically. In order to uninstall it you simply need to delete it. In order to uninstall the patch simply delete It from ''/etc/ati/custom-package/patch'' directory.

== Using GLX_SGIX_pbuffer FGLTexMgr: open of shared memory object failed (Permission denied) __FGLTexMgrCreateObject: __FGLTexMgrSHMmalloc failed!!! ==
This problem is due to the lack of SHM filesystem (now called tmpfs), that is virtual memory filesystem. To work around this problem you must:
* Add into ''/etc/fstab'' file the following line:
shm /dev/shm tmpfs defaults 0 0
* Then mount the filesystem through:
#> mount /dev/shm
Obviously the kernel must be predisposed for the "mounting" of this filesystem, in particular the
kernel option that must be enabled is '''CONFIG_TMPFS''' that is generally placed in '''File system --> Pseudo filesystems''' submenu. However all the compiled kernel generally have this option enabled.

== kernel includes at /lib/modules/`uname -r`/build/include do not match current kernel ==
The complete mistake is something like this:

Error:
kernel includes at /lib/modules/`uname -r`/build/include do not match current kernel.
they are versioned as ""
instead of "`uname -r`".
you might need to adjust your symlinks:
- /usr/include
- /usr/src/linux

The error, also if explained, could be not clear. In practice It results from the fact that the symbolic link:
/lib/modules/`uname -r`/source
/lib/modules/`uname -r`/build
don't point to the directory where are inserted the current kernel sources (which is generally ''/usr/src/linux- 'uname-r'''). It happens to those who use a kernel contained in Slackware, so I will try to explain It in terms of Slackware "packages". This can happen:
* because the kernel source were not installed. In this case should be enough to install the source package which can be found in Slackware k/ directory. However, It is not granted that the problem will be solved, You'll need to see the second reason why there is an error.
* because sources (also if installed) do not reflect the settings of the current kernel. The new Slackware 12 has some precompiled kernels (which means different settings), while just a single package for the sources (unless seeing the branch extra/). In particular, the sources are for the SMP kernel and so if you use a non-SMP kernel can appear this error. To avoid this, after making sure that the package source has been installed, do simply the following:
#> cd /usr/src/linux
#> cp /boot/config .config
#> make
:running make, in addition to compiling the kernel modules (which we will not use), some header files are regenerated, and they will reflect the kernel configuration (as it's set in the .config file).

== Driver 8.39.4 logo ==
This "bug" in 8.39.4 drivers results from the fact that ATI developers don't update the packager maintainers before the official releases. It should be nice first if they did test us official releases in order to certify the proper functioning of the scripts for creating packages. To solve the problem it's necessary to use the '''external SlackBuild''' as described here.

== amdcccle don't start on Slackware 12 ==
Many users of the X.Org 7.2 (or 1.3) server version fail to start properly the Catalyst. The command to run the Catalyst is:
#> amdcccle
For this problem it seems there is no solution yet, but we are working on to solve it.

= Useful links =
The discussion thread from which it was derived this article:
http://www.slacky.eu/forum/viewtopic.php?t=18134&highlight=

An alternative to official ATI drivers:
http://www.schneider-digital.de/

A wiki in italian about installing and configuring ATI drivers (open source and proprietary):
http://www.slacky.eu/wikislack/index.php?title=Installazione_driver_ATI_su_Slackware_GNU/Linux

= Conclusion =
Proprietary ATI drivers for many modern desktop and notebook PC seems are almost the only alternative to the use of 3d acceleration with linux. Unfortunately ATI developers don't make back porting and then users using drivers' version older than 8.37.6 will never go to X.Org server version 7.2 (alias 1.3) or later. Let's hope that Mesa drivers can also be used for these cards.

Also, It could happen that the module compilation fails. If so, feel free to write me at '''tomasiATcliDOTdiDOTunipiDOTit''' posting me the output generated by Only_Module option.

Thank you at Ezio Ghibaudo and Federico Rota who have started this wiki and for help with the SlackBuild.

Slackware

2010-10-13T09:22:27Z

Spina:

[[Category:Distributions]]
Welcome. This bare-bone little FAQ details how to get fglrx working on Slackware, Slackware64 and 64 bit porting.

You can use the '''internal SlackBuild''' or the '''external SlackBuild''' in order to have fglrx packaged for Slackware.

The '''internal SlackBuild''' is distributed within the official ATI installer.

The '''external SlackBuild''' is for driver version < 8.37.6.

You can find more detailed information about both of them on the following links.

Enjoy!

==Installation==
'''Internal SlackBuild'''
*[[Slackware: internal SlackBuild (ENG)|Wiki for internal SlackBuild (ENG)]]
*[[Slackware: SlackBuild interno (ITA)|Wiki per lo SlackBuild interno (ITA)]]
 
'''External SlackBuild''' (for driver version < 8.37.6)
*[[Slackware: external SlackBuild (ENG)|Wiki for external SlackBuild (ENG)]]
*[[Slackware: SlackBuild esterno (ITA)|Wiki per lo SlackBuild esterno (ITA)]]

{{VCT}}