Debian Kernel Howto: differenze tra le versioni

aggiunta FAQ (thanks lodnisse) e link (ker conf arch)
(aggiunta FAQ (thanks lodnisse) e link (ker conf arch))
Riga 1: Riga 1:
{{Debianized}}
==Introduzione==
Questa guida � dedicata all'installazione dei modem USB contenenti il chipset Conexant su Debian Sarge, ma pu� essere utile anche per l'installazione in release diverse (o, con opportune modifiche di configurazione, in distribuzioni diverse).
I driver utilizzati provengono dal progetto [http://accessrunner.sourceforge.net/ Accessrunner], sono stati rilasciati con licenza GPL e recentemente inclusi nell'albero principale del kernel Linux (dalla versione 2.6.13).


==Introduzione==
I modem con questo chipset necessitano per funzionare di un modulo del kernel (prima chiamato driver) di nome cxacru che � stato scritto per versioni del kernel Linux dalla 2.6.10 in poi.
Su debian il kernel pu� essere ricompilato con il metodo standard (valido con tutte le distribuzioni) oppure nella cos� detta ''debian-way''.
Esistono versioni precedenti dello stesso progetto funzionanti per kernel della serie 2.4 e anche qualche adattamento per kernel della serie 2.6 precedenti al 2.6.10, ma non sono pi� mantenuti e pertanto se ne consiglia l'utilizzo solo ad utenti esperti o molto coraggiosi.


Questa guida illustrer� il metodo debian di compilare il kernel. Questo metodo consite nel creare un pacchetto debian del kernel compilato per una facile installazione/disinstallazione.
Oltre al driver, questi modem necessitano per funzionare anche di un firmware, che in questo caso non � altro che un sistema operativo real-time (si, potrebbe funzionare anche linux, esiste un progetto a riguardo, ma al momento nessuno ha avuto successo con esso. Trovate qualche riferimento alla homepage gi� citata).
A complicare il tutto c'� il fatto che sono state rilasciate, sotto forma di binari gi� compilati, due versioni differenti di questo firmware: una usa "celle ATM impacchettate in frame USB" mentre l'altra usa "frame ethernet su USB". Il progetto Accessrunner supporta solo il primo di questi protocolli.  
Se vi capitasse di avere un modem che viene equipaggiato solo con il firmware del secondo tipo (di solito nei CD di installazione ci sono tutti e due), allora per usare il driver accessrunner dovete procurarvi un firmware del primo tipo da qualche parte in rete (eventualmente provate a postare nel forum).


==Installazione Pacchetti==
==Verificare se il modem � supportato==
Prima di iniziare l'installazione � necessario verificare che il modem in possesso sia supportato dal progetto. Per fare questo � necessario collegare il modem ad una porta usb. In un terminale digitiamo


Avremo innanzitutto bisogno di alcuni pacchetti di base per compilare e pacchettizzare un kernel:
<pre>$ less /proc/bus/usb/devices </pre>


si otterr una serie di informazioni su tutte le periferiche usb che avete nel pc.
La parte che ci interessa questa:
<pre>
<pre>
# apt-get install debhelper modutils kernel-package libncurses5-dev fakeroot
T: Bus=01 Lev=01 Prnt=01 Port=00 Cnt=01 Dev#= 2 Spd=12 MxCh= 0
D: Ver= 1.10 Cls=00(>ifc ) Sub=00 Prot=00 MxPS=64 #Cfgs= 1
P: Vendor=0572 ProdID=cb00 Rev= 0.01 
S: Manufacturer=-  
S: Product=ADSL USB MODEM
S: SerialNumber=55473201
C:* #Ifs= 1 Cfg#= 1 Atr=80 MxPwr=500mA
I: If#= 0 Alt= 0 #EPs= 7 Cls=00(>ifc ) Sub=00 Prot=00 Driver=none
E: Ad=81(I) Atr=02(Bulk) MxPS= 64 Ivl=0ms
E: Ad=01(O) Atr=02(Bulk) MxPS= 64 Ivl=0ms
E: Ad=82(I) Atr=02(Bulk) MxPS= 64 Ivl=0ms
E: Ad=02(O) Atr=02(Bulk) MxPS= 64 Ivl=0ms
E: Ad=83(I) Atr=02(Bulk) MxPS= 64 Ivl=0ms
E: Ad=03(O) Atr=02(Bulk) MxPS= 64 Ivl=0ms
E: Ad=84(I) Atr=03(Int.) MxPS= 8 Ivl=200ms
</pre>
</pre>


Adesso installiamo i sorgenti veri e propri del kernel. Useremo i sorgenti debian che hanno tutte le patch specifiche di debian. Nel seguito prenderemo come esempio la versione 2.6.8 del kernel, sostituitela con qualsiasi altra versione vogliate usare.
Prendiamo nota dalla riga <tt>P:</tt> dei campi <tt>Vendor</tt> e <tt>ProdID</tt> che identificano il chipset del modem e notiamo che alla voce <tt>Driver</tt> c'� scritto <tt>none</tt>, segno che in effetti state seguendo questa guida per qualcosa ;-).
Controllate se Vendor e Product ID del vostro modem corrispondono ad uno dei [http://accessrunner.sourceforge.net/modems.shtml modem supportati].
Se corrispondono ad un modem non supportato, provate a fare una ricerca nella [http://sourceforge.net/mailarchive/forum.php?forum_id=43894 mailing list del progetto] per vedere se (ed eventualmente come) qualcun altro � riuscito a risolvere il vostro problema.  


==L'occorrente per l'installazione==
Se il modem supportato possiamo procedere, ma saranno necessarie ancora alcune cose:
*Il compilatore gcc funzionante. Se non l'avete installatelo ( presente nel primo cd di installazione, non vi serve internet):
<pre>
<pre>
# apt-get install kernel-source-2.6.8
aptitude install gcc
</pre>
</pre>
 
*Il driver per Wi.. (mi spiace non riesco a scriverlo ;-)) che dovreste avere in dotazione al modem. Se non l'avete cercate in rete un firmware compatibile per esempio alla Hamlet e saltate il prossimo punto.  
{{Box|Nota|Dalla versione 2.6.12 in poi del kernel di linux, i pacchetti sorgenti e binari si chiamano rispettivamente <tt>linux-source-x.x.x</tt> e <tt>linux-image-x.x.x</tt> (invece di <tt>kernel-source-x.x.x</tt> e
*L'utility per estrarre il firmware dal driver Wi... (� pi� forte di me :-D). Se avete una connessione ad internet funzionante potete mettervi in una directory in cui avete diritto di scrittura e digitate
<tt>kernel-image.x.x.x</tt>). Questo perch� in Debian sono presenti anche altri kernel diversi da linux, come hurd o freebsd. }}
 
Per ricompilare il kernel non � necessario essere root, anzi � sconsigliato. Baster� aggiungere l'utente dal quale si desidera ricompilare il kernel al gruppo '''src''', con il seguente comando:
 
<pre>
<pre>
# adduser nomeutente src
$ cvs -z3 -d:server:anonymous@cvs.sourceforge.net:/cvsroot/accessrunner co -P utils
</pre>
</pre>
 
altrimenti dovrete usare un'altro computer connesso ad internet, aprire [http://cvs.sourceforge.net/viewcvs.py/accessrunner/ questa pagina] (che � la simulazione web del cvs) e scaricare i quattro file contenuti nella cartella <tt>utils</tt>.
{{Box|Nota|Ricordate di non usare mai l'utente root per ricompilare il kernel altrimenti tutti i file che verranno creati apparterranno a root:root. Se a questo punto si cercher� di compilare dall'utente normale si avranno problemi di permessi e per risolverli dovrete dare un:
Ad ogni modo dopo esserci procurati le utils dobbiamo compilarle:
# chown -R root:src /usr/src/  
}}
 
== Configurazione del kernel ==
 
=== Passi preliminari ===
Entriamo ora nella directory dei sorgenti del kernel:
 
<pre>
<pre>
$ cd /usr/src
$ cd utils  # o dovunque avete messo i file
$ make
</pre>
</pre>
 
*Nel caso in cui il modem si identifichi con il'ID <tt>0xcafe</tt> (<tt>0x</tt> sta per esadecimale), vi serve anche la ROM di boot che scaricate ad esempio cos�
Troveremo in questa directory (avendoli installati precedentemente) i sorgenti del kernel in un archivio tar.bz2:
 
<pre>
<pre>
$ ls
$ wget http://www.olitec.com/pub/USBADSLV151-1008fr.tar.gz
...
kernel-source-2.8.6.tar.bz2
...
</pre>
</pre>
 
ora estraete il file WBoot.hex
Decomprimiamo il kernel:
 
<pre>
<pre>
$ tar xvjf kernel-source-2.6.8.tar.bz2
$ tar xvfz USBADSLV151-1008fr.tar.gz && cp USBADSL/WBoot.hex .
</pre>
</pre>
 
e poi create un programmino C per convertire il file esadecimale in binario cos�:
A fine decompressione avremo una directory kernel-source-2.6.8, creiamo un link simbolico linux che punta ai sorgenti del kernel:
 
<pre>
<pre>
$ ln -s /usr/src/kernel-source-2.6.8 linux
$ echo "int main(int argc, char ** argv)
{
unsigned int bp[] = {
#include \"WBoot.hex\"
};
write(1, bp, sizeof(bp));
}
" > programmino.c
</pre>
</pre>
 
compilatelo e rendetelo eseguibile:
Non � necessario creare questo link, ma � una usuale convenzione farlo anche perch� risulta comodo per entrare nella directory dei sorgenti del kernel.
 
Ora spostiamoci della directory e puliamo i sorgenti del kernel:
 
<pre>
<pre>
$ cd linux
$ gcc programmino.c -o programmino
$ make-kpkg clean
$ chmod +x programmino
</pre>
</pre>
 
ed eseguitelo in questo modo:
Questo passaggio � inutile se � la prima volta che compilate il kernel, ma dalla seconda volta in poi diviene necessario per eliminare i file generati dalle precedenti compilazioni che potrebbero creare conflitti.
 
Ora, se avete installato un kernel precompilato che abbia la stessa versione del kernel che volete ricompilare potreste usare il suo file di configurazione come base di partenza per configurare il vostro kernel. A tal scopo basta copiare il file di configurazione che st� in <tt>/boot</tt> (i file di configurazione dei kernel installati hanno come nome <code>config</code> seguito dalla versione del kernel) nella directory dei sorgenti:
 
<pre>
<pre>
$ cp /boot/config-2.6.8 .config
./programmino > cxacru-bp.bin
</pre>
</pre>
*Purtroppo nella attuale stable (sarge) trovate il kernel 2.6.8 quindi, a meno che non abbiate gi installato un kernel 2.6.13 o superiore dovrete usare un PC connesso ad internet per scaricare uno dei seguenti pacchetti:
**il sorgente di un kernel >=2.6.10 nella forma di un pacchetto kernel-source (o linux-source, nella nomenclatura pi recente)
**un pacchetto kernel-image >=2.6.10 (o linux-image) gi compilato, e il pacchetto linux-headers corrispondente, per compilare il modulo fuori dal kernel
**un pacchetto linux-image >=2.6.13 da installare direttamente
*Nel caso si decida per la compilazione di un kernel <2.6.13 (ma, ribadisco, sempre >=2.6.10) o anche del solo modulo cxacru necessario scaricare la patch usbatm che trovate [http://sourceforge.net/project/showfiles.php?group_id=47406 qui]. Conviene sempre prendere l'ultima versione disponibile, che al momento il file usbatm-20050216.tar.bz2.


C'chi arriva anche a installare un kernel precompilato per usare semplicemente il suo file di configurazione. Se avete banda da sprecare � possibile farlo. Tuttavia si pu� benissimo partire da zero senza copiare nessun file di configurazione.
Se siete poco pratici di debian, e installare il modem una delle prime cose che fate sulla vostra nuova sarge, devo avvisarvi che il fatto di aggiornare il kernel da 2.6.8 a 2.6.12 o superiori comporta qualche difficolt� tecnica. A breve vedr� di scrivere una piccola guida per questa migrazione, ma nel frattempo, prima di avventurarvi per questa strada: cercate informazioni nel forum ;-)
 
=== Configurazione: <code>make menuconfig</code> ===


A questo punto, per configurare il nostro kernel, non ci resta che lanciare il comando:
Da questo punto in avanti supporremo di aver messo tutti i file necessari all'installazione in una directory di lavoro all'interno della vostra home: ~/work/


==Installazione di linux-image==
Nel caso abbiate optato per l'installazione di un pacchetto linux-image non vi resta altro da fare che installarlo (da root):
<pre>
<pre>
$ make menuconfig
# dpkg -i ~/work/linux-image-2.6.x-xx-xxx.deb
</pre>
</pre>


Vi apparir� un'interfaccia testuale dalla quale sar� possibile configurare le opzioni del kernel. ''Questo � il passaggio pi� delicato, nonch� il pi� lungo e difficile''.  
Nota: qui si supposto che il modem in questione rappresenti il vostro unico collegamento ad internet. Se invece avete accesso direttamente ad internet potete fare affidamento per l'installazione ad [[Indice_Guide#Gestione_dei_Pacchetti | apt]], che gestir� automaticamente le eventuali dipendenze.  


Se dovete configurare un kernel per la prima volta prendetevi almeno un'ora di tempo ed iniziate con calma, leggendo tutte le pagine dell'help in linea. Uno dei vantaggi di un kernel ricompilato � la possibilit� di ottenere un kernel estremamente piccolo e leggero proprio perch� viene compilato il supporto per le sole periferiche e i soli filesytem effettivamente usati. In questo modo si ha un kernel piccolo e pochi moduli. Un kernel di questo tipo impiega anche molto meno tempo ad essere compilato. Per fare un esempio potrebbe impiegare sui 10 min. su in athlon 1000, quando un kernel debian ufficiale impiegherebbe sicuramente pi� di un'ora sulla stessa macchina. In definitiva, compilando un kernel snello, sar� possibile anche fare pi� prove ed ottimizzarlo quindi al meglio.  
Verificate che il bootloader, lilo o grub, punti alle giuste immagine del kernel e dell'initrd (vedi  [[Debian_Kernel_Howto#Installazione_nuovo_kernel | installazione nuovo kernel]]) e fate un reboot con il nuovo kernel.  
Se non ci sono errori, a seconda della versione del kernel che avete installato, potete continuare con la compilazione del modulo cxacru, o passare all'installazione del firmware.


Per trovare quali moduli sono richiesti dal vostro hardware potete usare il comando '''lspci''' o meglio '''lspci -v'''. Inoltre risulta utilissimo consultare il database dei driver di Linux a [http://kmuto.jp/debian/hcl/ questo indirizzo]: inserendo semplicemente l'output di <code>lspci -n</code>, otterrete l'elenco dei moduli da compilare
==Compilazione e installazione del solo modulo cxacru==
Se il kernel che avete installato non comprende ancora il modulo cxacru, potete compilarlo e installarlo a parte. Per questo sono sufficienti gli headers del kernel, ma vanno bene anche i sorgenti completi.


Per approfondire la configurazione del kernel:
Nota: alcuni kernel tendono ad essere particolarmente esigienti riguardo la versione del compilatore con cui compilate il modulo, e rifiuteranno di caricarlo se usate una versione di gcc diversa da quella con cui � stato compilato il kernel: controllate la versione del compilatore che vi serve con <tt>cat /proc/version</tt> (vale solo per il kernel corrente).


* [[Esempio configurazione kernel]] nel nostro wiki, per un semplice esempio.
Se avete scaricato i pacchetti deb con gli headers (di solito sono due pacchetti: uno generico e uno relativo alla vostra architettura) dovete installarli:
* [http://a2.pluto.it/a249.htm#almltitle512  Elementi della configurazione] per una descrizione pi� dettagliata delle varie voci. Questo � un capitolo della monumentale opera [http://a2.pluto.it/appunti_di_informatica_libera.htm Appunti di Informatica Libera], per la quale tutti noi siamo grati all'autore '''Daniele Giacomini'''.
<pre>
# dpkg -i ~/work/linux-headers*.deb
</pre>


In bocca al lupo con la configurazione ;-).
ora si pu� procedere con la compilazione e installazione del modulo, dopo averlo scompattato:
<pre>
# cd ~/work/
# tar xvfj ~/work/usbatm-20050216.tar.bz2
# cd ~/work/drivers/usb/atm
# make -C /usr/src/linux-headers-2.6.1x M=$PWD CONFIG_USB_CXACRU=m modules
# install -g root -o root -m 644 cxacru.ko usbatm.ko \
/lib/modules/2.6.1x/kernel/drivers/usb/atm/
# depmod -a
</pre>


Una volta finita la configurazione, uscite e salvate i cambiamenti. A questo punto il file <tt>/usr/src/linux/.config</tt> conterr� la nostra configurazione del kernel.
Se tutto � andato bene potete saltare il paragrafo sulla compilazione e passare all'installazione del firmware.


{{Box|Nota|Se avete gi� ricompilato il vostro kernel e volete passare ad una versione pi� aggiornata, ma non troppo diversa (ad esempio: 2.6.8 --> 2.6.10), non conviene rifare tutta la configurazione da capo. D'altro canto non � neanche possibile usare il vecchio file di configurazione dato che nel nuovo kernel ci saranno voci in pi� e o in meno e sarebbe improponibile cercarle ad una ad una.
==Compilazione e installazione del kernel==
Nel caso abbiate deciso di compilare un nuovo kernel installate il pacchetto <tt>kernel-source</tt> (<tt>linux-source</tt>).
Qui supporremo che un utente non privilegiato non abbia diritto di scrittura nella directory <tt>/usr/src</tt> (come imho dovrebbe essere), quindi tutti i comandi successivi devono essere dati da root oppure usando un programma che vi dia pari diritti per queste azioni (per es. <tt>sudo</tt>).
<pre>
# dpkg -i ~/work/linux-source-2.6.x-xx-xxx.deb
</pre>
questo installer� un archivio compresso contenente il kernel nella directory <tt>/usr/src/</tt>. Andiamo a scompattarlo e applichiamo la patch:
<pre>
# cd /usr/src
# tar xvfj linux-source-2.6.x-xx-xxx.tar.bz2
# cd linux-source-2.6.x-xx-xxx
# tar xvfj ~/work/usbatm-20050216.tar.bz2
</pre>


Basta allora copiare il vecchio file di configurazione nella directory dei sorgenti del nuovo kernel e lanciare il comando:
C'� chi sostiene che scompattare il file usbatm direttamente nel kernel sia assolutamente sbagliato, per il rischio di sovrascrivere qualcosa. Ma considerando che l'operazione ha senso solo per 3 versioni del kernel, e successivamente i file contenuti nel pacchetto sono stati inclusi nell'albero dei sorgenti esattamente nella stessa posizione in cui li abbiamo messi noi, penso che siano timori infondati, a patto di non sbagliare la versione del kernel ;-).


$ make oldconfig
'''nota bene''': mentre sperimentate con la compilazione del kernel <u>non usate mai</u> la directory <tt>/usr/src/linux</tt> che dovrebbe essere un link simbolico (<tt>man ln</tt>) ai sorgenti del kernel attualmente in uso. Se tutto il nostro procedimento funzioner�, alla fine cambierete il link in modo che punti ai sorgenti giusti. Per approfondimenti sull'argomento vedere il [[Debian_Kernel_Howto | debian kernel howto]]


in questo modo verranno fatte delle domande su come configurare ''le sole nuove voci'' presenti nel kernel. Se i due kernel sono troppo diversi questo metodo non conviene pi� dato che bisogna rispondere ad uno ad uno a tutte le domande sulle voci diverse. Sicuramente non conviene usarlo per il passaggio 2.4 --> 2.6.<br>
Invece di compilare un kernel da zero (impresa a dir poco titanica) conviene recuperare il config relativo al kernel che state usando, che dovrebbe essere presente nella directory <tt>/boot</tt>, e dovrebbe chiamarsi <tt>config-<versione del kernel></tt> o simili: sempre dalla directory principale dei sorgenti del kernel digitate
Un file config del vostro attuale kernel pu� essere trovato in <tt>/boot</tt> sotto il nome di <tt>config-2.x.x</tt>.}}
<pre>
# cp /boot/config<qualcosa> .config
</pre>
in questo modo avrete un albero dei sorgenti configurato esattamente come il vostro attuale kernel, e da qui potete fare solo le modifiche che vi servono.  


=== Alternative a <code>make menuconfig</code> ===
A questo punto prima di compilare dobbiamo abilitare alcune opzioni del kernel. Digitate
<pre>
# make menuconfig
</pre>


Per completezza segnalo le altre interfacce grafiche che � possibile usare per configurare il kernel al posto di <code>make menuconfig</code>.
Andate alla voce <tt>Device Drivers -> USB support -> USB DSL modem support</tt> ed attivate <tt>USB DSL modem support</tt> e <tt>Conexant AccessRunner USB support</tt>.


;<code>make xconfig</code>: per usare una interfaccia grafica '''qt''' per la configurazione.
'''Nota''': il driver cxacru deve essere compilato come modulo perch�, probabilmente a causa di un bug, se compilato nel kernel in molti casi viene inizializzato prima che il firmware sia disponibile, e restituisce l'errore "<tt>firmware not found</tt>" anche se in realt� l'avete messo nel posto giusto. Il fatto � che non potendo fare "<tt>rmmod cxacru && modprobe cxacru</tt>", per farlo reinizializzare non vi resterebbe che staccare fisicamente il modem dalla porta usb e riattaccarlo, dopo ogni reboot, e questo pu� essere parecchio seccante!
;<code>make gconfig</code>: per usare una interfaccia grafica '''gtk''' per la configurazione.


Questi fronted non aggiungono niente di nuovo e sono pertanto funzionalmente equivalenti tra di loro. Per usarli sono per� necessarie le librerie di sviluppo, rispettivamente, di ''qt'' e ''gtk''.
Il resto della configurazione dovrebbe essere gi� a posto, ma controllate per sicurezza.
Alla voce <tt>Device Drivers -> Networking support </tt>
<pre>
<M> PPP support
<M>  PPP support for async serial ports
<M>  PPP support for sync tty ports
<M>  PPP deflate compression
<M>  PPP BSD-Compress compression
<M>  PPP over ATM
</pre>


== Compilazione del kernel ==
Ala voce <tt>Networking options</tt>
Ora � venuto il momento di cominciare la compilazione, a tal scopo useremo make-kpkg. Vediamo come utilizzare velocemente questo tool per compilare il nostro kernel personalizzato:
<pre>
<M> Asyncronous Transfer Mode
<M>  Classical IP over ATM
[*]    Do NOT send ICMP if no neighbour
</pre>


A questo punto uscite salvando la configurazione attuale e costruite il pacchetto <tt>kernel-source-2.6.x-xx-xxx-Custom.deb</tt> (per approfondimenti vedere [[Debian_Kernel_Howto#Compilazione_del_kernel | Compilazione del kernel]] nel Debian kernel howto):
<pre>
<pre>
$ fakeroot make-kpkg --append-to-version -nomepersonalizzato --revision=1 kernel_image
# make-kpkg clean
# make-kpkg --initrd kernel-image
</pre>
e installate il pacchetto ottenuto:
<pre>
# dpkg -i ../kernel-image-2.6.x.xx.xxx-Custom.deb
</pre>
</pre>


Questo comando compiler� il nostro kernel e lo inserir� in un pacchetto debian in /usr/src. Il comando '''fakeroot''' viene usato semplicemente per simulare un ambiente di root per l'utente normale.
Ora verificate che il bootloader (lilo o grub) punti alle immagini giuste di kernel e initrd e poi riavviate.


Diamo uno sguardo alle opzioni usate:


; --append-to-version : serve ad aggiungere un nome personalizzato al pacchetto che verr� aggiunto dopo il numero di versione, che in questo caso diventer� ''2.6.8-nomepersonalizzato''.
'''Aggiornamento''': solo recentemente (23/11/2005) sono riuscito nell'intento di far funzionare correttamente il driver cxacru anche se � compilato all'interno del kernel :-D. Questo permette di costruire un kernel monolitico e di disabilitare il supporto per i moduli, cosa senz'altro desiderabile nelle situazioni in cui � necessario un certo grado di sicurezza (per es. per un PC che fa da firewall-router).
Poich� la cosa non � per niente banale, e comporta la compilazione di un kernel recente (minimo 2.6.12, ma io ho testato il 2.6.14) e la creazione di un initramfs personalizzato (oltre a qualche configurazione minore in udev), consiglio la cosa solo ad utenti particolarmente avventurosi. Chi vuole cimentarsi mi pu� contattare sul forum.


; --revision : permette di impostare il numero di revisione del pacchetto, normalmente viene indicato con un numero intero.  
==Installazione del firmware==
Qualunque metodo abbiate seguito, dopo il reboot dovreste trovare disponibile il modulo <tt>cxacru</tt>, verificate con
<pre>
# modprobe -l |grep cxacru
</pre>
il comando dovrebbe restituire un output simile a:
<pre>
/lib/modules/2.6.x/kernel/drivers/usb/atm/cxacru.ko
</pre>
se non restituisce nulla significa che c'� stato un errore nei precedenti passaggi.


; kernel_image : dice a make-kpkg di compilare l'immagine del kernel creare il pacchetto debian.
Se tutto � andato per il meglio proseguiamo andando a recuperare il CD dei driver per w... ehm, quell'altro S.O.
Cercate nel CD il file <tt>CnxEtU.sys</tt> e copiatelo nella Cartella di lavoro. Ora estraete il firmware e copiatelo nella directory dove hotplug (o udev se usate un sistema pi� recente) si aspetta di trovarlo.


Se ad esempio compileremo per la seconda volta lo stesso kernel, per fare solo delle modifiche minori, pu� essere utile usare lo stesso nome per --append-to-version ed usare un numero di revisione maggiore. In questo modo quando installarete il pacchetto del kernel ricompilato questo sostituir� il pacchetto precedente. Al contrario se ricompilate un secondo kernel cambiando la stringa da appendere alla versione, il pacchetto del nuovo kernel conviver� tranqullamente col precedente.
nota: per sarge, che utilizza ancora hotplug, la directory standard per il firmware � <tt>/usr/lib/hotplug/firmware</tt>, mentre da etch in poi hotplug � stato sostituito da udev, e la directory per il firmware � <tt>/lib/firmware</tt>.
Noi supporremo di essere su sarge:
<pre>
# cd ~/work
# ./utils/cxacru-fw CnxEtU.sys cxacru-fw.bin
# cp ~/work/cxacru-fw.bin /usr/lib/hotplug/firmware
</pre>
Se il vostro modem ha il chipset <tt>0xcafe</tt> copiate nella stessa directory anche la ROM di boot, cio� il file <tt>cxacru-bp.bin</tt>.


In realt� il comando '''make-kpkg''' accetta molti ulteriori paramentri (elencher� solo i pi� importanti per gli altri leggete l'amichevole pagina di manuale aka read the friendly manual):
A questo punto togliete il modulo <tt>cxacru</tt>, nel caso sia caricato:
<pre>
# rmmod cxacru
</pre>
staccate il modem dalla porta USB nel caso sia attaccato, e poi riattaccate il modem alla porta USB e ricaricate il driver. Tutto questo perche � sempre meglio togliere il modulo dal kernel prima di staccare il modem, altrimenti a me � capitato che si bloccasse completamente il sistema.
Ora controllate che sia stato trovato il firmware:
<pre>
$ dmesg | tail
</pre>
il comando dovrebbe restituire qualcosa di simile a
<pre>
usbcore: registered new driver cxacru
cxacru 1-1:1.0: found firmware cxacru-fw.bin
</pre>
Nel caso, una volta caricato il firmware, riceviate, sempre in <tt>dmesg</tt>, il messaggio:
<pre>
cxacru 1-1:1.0: poll status: error -5
</pre>
significa che occorre una versione pi� recente del vostro firmware. In effetti non � assolutamente detto che i driver forniti dal produttore del modem siano aggiornati, ma potete senz'altro trovare un firmware aggiornato in rete, per esempio [http://ftp.linux.it/pub/People/md/warez/ qui] (notare che il pacchetto .deb � per sarge, e mette il firmware in <tt>/usr/lib/hotplug/firmware</tt>, quindi per etch � molto meglio non usarlo e scaricare direttamente il firmware) o eventualmente postando nel forum.


; --added-modules foo : compila dei sorgenti esterni (presenti in /usr/src/modules) insieme al kernel, potete mettere                          pi� nomi separati da virgole
Ora il driver del modem dovrebbe gi� essere in funzione e il led relativo alla linea ADSL dovrebbe lampeggiare, segno che sta cercando la sincronizzazione con la linea. Mentre il led lampeggia avrete che:
; --added-patches foo : aggiunge delle patch al kernel, le path possono essere molteplici separate da virgole
<pre>
; --config : sceglie quale frontend usare per configurare il kernel (config, menuconfig, xconfig, gconfig)
$ cat /proc/net/atm/cxacru\:0
; --initrd : da usare se state compilando un kernel che utilizza le immagini initrd.img
ADSL USB MODEM (usb-0000:00:07.2-1)
; --zimage : crea una zImage per il kernel
MAC: xx:yy:zz:bla bla bla
; --bzImage : crea una bzImage per il kernel
AAL5: tx 9363 ( 0 err ), rx 14299 ( 0 err, 0 drop )
; --mkimage : qui potete passare dei parametri a mkinitrd, ad esempio se volete creare una immagine rom "genromfs -d %s -f %s"
Line down
; --rootcmd foo : per passare un comando a make-kpkg ad esempio fakeroot o sudo
</pre>
; CONCURRENCY_LEVEL : questa variabile e' l'omonimo di -j per make, per usarla vi basta mettere il numero intero che desiderate usare (''$ CONCURRENCY_LEVEL=4 make-kpkg --blabla ecc.ecc...'' )
e anche:
<pre>
$ tail /var/log/messages
Oct 5 08:06:00 muretto kernel: ATM dev 0: ADSL line: attempting to activate
Oct 5 08:06:10 muretto kernel: ATM dev 0: ADSL line: down
Oct 5 08:06:15 muretto kernel: ATM dev 0: ADSL line: attempting to activate
Oct 5 08:06:35 muretto kernel: ATM dev 0: ADSL line: down
Oct 5 08:06:40 muretto kernel: ATM dev 0: ADSL line: attempting to activate
Oct 5 08:08:00 muretto kernel: ATM dev 0: ADSL line: channel analysis
Oct 5 08:08:05 muretto kernel: ATM dev 0: ADSL line: up (4832 kb/s down | 320 kb/s up)
</pre>
qui alle 8.08.00 il modem si � sincronizzato con il segnale ADSL .


Come ultimo parametro dovremo mettere un'azione da compiere, vediamo le principali:
Una volta agganciato il segnale ADSL si avr�:
 
<pre>
; clean : pulisce i sorgenti
$ cat /proc/net/atm/cxacru\:0
; buildpackage : pulisce i sorgenti e avvia "binary" (vedere sotto)
appariranno di seguito queste informazioni
; binary : questo genera un nuovo pacchetto deb con i sorgenti, uno con gli header, uno con la documentazione e uno con l' immagine del kernel
ADSL USB MODEM (usb-0000:00:07.2-1)
; kernel_headers : questo genera un pacchetto con gli headers del kernel
MAC: xx:yy:zz:bla bla bla
; build : compila solo l'immagine del kernel
AAL5: tx 9363 ( 0 err ), rx 14299 ( 0 err, 0 drop )
; modules :compila tutti moduli esterni sotto /usr/src/modules e genera un file .diff e un pacchetto sorgente
Line up
; modules_config : permette di configurare i moduli esterni residenti in /usr/src/modules prima di compilarli
</pre>
; modules_image : crea i pacchetti deb dei moduli esterni residenti in /usr/src/modules senza il file .diff e senza creare un'altro pacchetto sorgente
Ci siamo: il driver del modem � perfettamente funzionante.
; modules_clean : pulisce i sorgenti dei moduli esterni presenti in /usr/src/modules
; debian : questo crea la directory ./debian utile per compilare i kernel vanilla e patcharli alla maniera debian


==Installazione nuovo kernel==
==Impostazione della connessione==  
Una volta finito torneremo alla riga di comando e ci sposteremo nella directory precedente (/usr/src/) dove troveremo il pacchetto .deb del kernel appena compilato:
Prima di iniziare dovete sapere:
*userid e password forniti dal provider (di solito per Telecom Alice l'userid e la password sono entrambi uguali a <tt>aliceadsl</tt>)
*VPI e VCI del provider (nel caso di Telecom Alice sono 8 e 35).
*IP e DNS del nostro provider nel caso di una connessione con IP statico.


Iniziamo con la configurazione.
Create il file <tt>/etc/ppp/peers/adsl</tt> in questo modo:
<pre>
<pre>
$ cd ..
# echo "noauth
$ ls
noipdefault
...
usepeerdns
kernel-image-2.6.8-nomepersonalizzato-386_1.Custom_i386.deb
defaultroute
...
persist
plugin pppoatm.so 8.35
user \"userid\"
" > /etc/ppp/peers/adsl
</pre>
</pre>
 
oppure copiate nella directory <tt>/etc/ppp/peers/</tt> il file <tt>/usr/share/doc/ppp/examples/peers-pppoa</tt>
Adesso possiamo installare il pacchetto con il nostro nuovo kernel ricompilato. Diventiamo quindi root con '''su''', e digitiamo:
<pre>
<pre>
# dpkg -i kernel-image-2.6.8-nomepersonalizzato-386_1.Custom_i386.deb
# cp /usr/share/doc/ppp/examples/peers-pppoa /etc/ppp/peers/
</pre>
</pre>
In entrambi i casi modificate la riga <tt>user "userid"</tt> mettendo il vostro userid ;-), con o senza le virgolette: non ha importanza.


Se abbiamo lilo dovremo configurare lilo.conf aggiungendo le righe relative al kernel. Ricordatevi che, con lilo, per rendere effettive le modifiche bisogna aggiornare il [[MBR]] (Master Boot Record) con il comando:  
Inserite userid e password nei file <tt>/etc/ppp/pap-secrets</tt> e <tt>/etc/ppp/chap-secrets</tt>:
 
<pre>
<pre>
# lilo -v
# echo "userid  *  password" >> /etc/ppp/pap-secrets
# echo "userid  *  password" >> /etc/ppp/chap-secrets
</pre>
</pre>


Se abbiamo grub, invece, non ci resta altro che riavviare :D. Tuttavia per approfondire le personalizzazioni che � possibile fare su grub, potete leggere l'apposita sezione della [[Guida a Grub]]:
A questo punto fate partire la connessione con il comando
 
* [[Guida_a_Grub#Usare_update-grub|Guida a Grub: Usare update-grub]]
 
==Installare e gestire i moduli==
 
Per compilare e creare automaticamente pacchetti .deb per moduli non presenti nei sorgenti del kernel, Debian fornisce un comodo strumento: [[Pagina di manuale di module-assistant|module-assistant]]. Per un uso interattivo baster� lanciarlo da root per installare i pacchetti, scaricare i sorgenti del modulo che interessa, compilarlo e creare un pacchetto debian.
 
Per scegliere invece quali moduli fare partire all'avvio ci sono diverse strade.
 
# Se si usa l'hotplug, questi dovrebbe caricare automaticamente al boot tutti i moduli necessari. Per evitare il caricamento di certi moduli che possono creare conflitti basta inserili in '''/etc/hotplug/blacklist'''.
# Se non si usa l'hotplug bisogna specificare manualmente quali moduli caricare all'avvio. Per far ci� baster� inserire i nomi dei moduli da caricare in '''/etc/modules''', uno per riga. Se non vi va di editare un file di testo (o non ricordate esattamente i nomi dei moduli) potrete usare '''modconf''' che permette di scegliere interattivamente quali moduli caricare all'avvio.
 
==FAQ==
===Per aggiungere un modulo devo ricompilare tutto il kernel?===
Dipende.
 
Se il modulo fa parte del kernel debian (cio� il suo sorgente � contenuto nel pacchetto <tt>kernel-source</tt> del kernel) allora bisogna ricompilare il kernel. Tenete presente, tuttavia, che i kernel binari debian includono gi� la maggior parte dei moduli presenti nei sorgenti del kernel. Per caricarli basta usare:
 
  # modprobe ''nomemodulo''
 
Se il sorgente del modulo � invece pacchettizzato singolarmente (il nome di questi pacchetti comincia per <tt>module-source</tt>) '''non � necessario''' ricompilare il kernel.
Debian ci fornisce la comoda utility '''module-assistant''' che permette di scaricare, compilare e pacchettizzare un modulo del kernel. Basta lanciare il comando
 
  # m-a
 
e una interfaccia ''dialog'' ci guider� passo passo.
 
Si pu� usare il comando <tt>module-assistant list-avaible</tt> (o il diminutivo <tt>m-a la</tt>) per ottenere la lista completa dei moduli installabili con module-assistant. Per le altre innumerevoli opzioni potete leggere la pagina di manuale tradotta in italiano:
 
* [[Pagina di manuale di module-assistant]]
 
===Bisogna usare l'initrd oppure no?===
La risposta breve �: no non usatelo.
 
Di seguito la risposta lunga:
 
L'immagine initrd (ramdisk iniziale) serve per caricare dei moduli nel kernel prima che questo abbia l'accesso alla partizione di root. Quindi basta compilare questi moduli staticamente e non avremo mai bisogno di un ramdisk. Ma quali sono questi moduli che servono nelle prime fasi di avvio? Semplicemente i moduli che permettono di leggere la partizione di root, ovvero:
 
* il modulo del controller del proprio harddisk
* il modulo del filesystem della partizione di root
 
Per un kernel casalingo ricompilato, l'uso dell'initrd non solo � inutile (e leggermente pi� lento) ma � anche facile da sbagliare (se vi scordate ad esempio il supporto cramfs nel kernel o non aggiungete i giusti moduli all'immagine del ram disk il sistema andr� in kernel panic e dovrete ricompilare nuovamente). L'initrd serve soprattutto per i kernel ufficiali delle distribuzioni che devono supportare tutti i controller esistenti e una gran variet� di filesystem. Sarebbe assurdo compilare tutti questi supporti staticamente e quindi vengono inseriti come moduli nel ram disk. L'initrd � necessario anche se si vuole usare un bootsplash, ma questa � un'altra storia:
 
* [[Compilazione Kernel 2.6.11 con Bootsplash]]
* [[Kernel2.6.10 - Framebuffer - Gensplash Patch]]
 
La risposta lunga � quindi no, non usate il'initrd quando questo non sia strettamente necessario.
 
===Ma se io devo usare l'initrd assolutamente?===
Per usare l'intrd si deve quanto meno compilare staticamente il supporto per l'initrd impostando le seguenti voci:
 
<pre>
<pre>
Device Drivers  --->
# pon adsl
  Block devices  --->
    <*> RAM disk support
    (16)  Default number of RAM disks
    (8192) Default RAM disk size (kbytes)
    [*]  Initial RAM disk (initrd) support
</pre>
</pre>
ed il gioco fatto.


Inoltre bisogna anche aggiungere il supporto per il filesystem usato nell'immagine del ram disk. In debian si usa di default il '''cramfs''', attivabile alla voce:
Controllate in <tt>/var/log/messagges</tt> se tutto funziona regolarmente:
 
<pre>
<pre>
File systems  --->
# tail /var/log/messagges
    Miscellaneous filesystems  --->
Jun 3 00:07:40 localhost pppd[5101]: Plugin /usr/lib/pppd/2.4.2/pppoatm.so loaded.
        <*> Compressed ROM file system support
Jun 3 00:07:40 localhost kernel: PPP generic driver version 2.4.2
Jun 3 00:07:40 localhost pppd[5101]: PPPoATM plugin_init
Jun 3 00:07:40 localhost pppd[5101]: PPPoATM setdevname_pppoatm - SUCCESS:8.35
Jun 3 00:07:40 localhost pppd[5126]: pppd 2.4.2 started by root, uid 0
Jun 3 00:07:40 localhost pppd[5126]: Using interface ppp0
Jun 3 00:07:40 localhost pppd[5126]: Connect: ppp0 <--> 8.35
Jun 3 00:07:43 localhost pppd[5126]: PAP authentication succeeded
Jun 3 00:07:43 localhost pppd[5126]: local IP address 82.59.0.222
Jun 3 00:07:43 localhost pppd[5126]: remote IP address 192.168.100.1
Jun 3 00:07:43 localhost pppd[5126]: primary DNS address 80.17.212.208
Jun 3 00:07:43 localhost pppd[5126]: secondary DNS address 151.99.125.1
</pre>
</pre>


Se si vuole usare un'altro filesystem basta impostarlo in '''/etc/mkinitrd/mkinitrd.conf'''.
Controllate in <tt>/etc/resolv.conf</tt> se i DNS sono corretti altrimenti li dovrete inserire a mano. Per esempio un <tt>/etc/resolv.conf</tt> con i DNS di libero sarebbe:
 
Si dovranno inoltre aggiungere al file '''/etc/mkinitrd/modules''' il nome dei moduli da inserire nell'immagine di initrd.
 
===Posso usare make-kpkg con un kernel vanilla===
Si, <tt>make-kpkg</tt> pu� essere usato indifferentemente sia con i sorgenti Debian del kernel di linux che con i sorgenti del [[kernel vanilla]]. In proposito vedere l'opzione <tt>debian</tt> nella sezione [[Debian_Kernel_Howto#Compilazione_del_kernel|Compilazione del kernel]].
 
I sorgenti Debian sono contenuti nei pacchetti <tt>kernel-source-*</tt> (o <tt>linux-source-*</tt> per i kernel dal 2.6.12 in poi) e sono installabili come usuali pacchetti con [[APT]].
 
I sorgenti vanilla devono essere scaricati manualmente da [http://www.kernel.org www.kernel.org].
 
===Errore con l'opzione ''--revision'' ===
Puo' capitare che, variando il valore dell'opzione ''--revision'' venga rilevato un errore simile al seguente:
<pre>
<pre>
I note that you are using the --revision flag with the value
$ cat /etc/resolv.conf
  2.
search libero.it
However, the ./debian/changelog file exists, and has a different value
nameserver 193.70.192.25
  1.
nameserver 193.70.152.25
I am confused by this discrepancy, and am halting.</pre>
</pre>
 
Per ovviare a questo problema e' sufficiente effettuare un clean:
<pre>$ fakeroot make-kpkg clean</pre> e rilanciare la compilazione.
 
==Riferimenti==
 
* [http://www.debian.org/doc/manuals/reference/ch-kernel.it.html Manuale di Riferimento Debian: Capitolo 7 - Il kernel Linux su Debian]
* [http://a2.pluto.it/a249.htm#almltitle507 Appunti di informatica Libera: Kernel Linux]: Il capitolo dedicato al kernel della monumentale opera di Daniele Giacomini contiene sia istruzioni generiche che istruzioni per Debian. Inoltre c'� una descrizione dettagliata della configurazione delle varie voci del kernel!
 
 
Buon divertimento con Debian GNU/Linux


Buona navigazione!
----
----
 
: [[Utente:Tindal|Tindal]]
Autore iniziale: Abortigeno
[[Categoria:Hardware]][[Categoria:Modem ADSL]]
 
Rivisto ed esteso: [[Utente:TheNoise|~ The Noise]]
1 760

contributi