1 760
contributi
Pagina di manuale di module-assistant: differenze tra le versioni
Vai alla navigazione
Vai alla ricerca
Pagina di manuale di module-assistant (visualizza wikitesto)
Versione delle 10:08, 24 lug 2005
, 24 lug 2005aggiunto Nome e Sintassi
m (→Comandi: typo) |
(aggiunto Nome e Sintassi) |
||
| Riga 1: | Riga 1: | ||
{{stub}} | {{stub}} | ||
== Nome == | |||
; <big><tt>module-assistant</tt></big> : gestisce i paccheti dei moduli del kernel | |||
== Sintassi == | |||
<tt><big> | |||
: '''module-assistant''' [ -fihnqstv ] [ -k source/headers directory ] [ -l kernel versions ] | |||
:: { update | search | prepare | auto-install | list | list-available | list-installed | |||
:: | auto-unpacked | get | build | install | clean | purge | fakesource } | |||
:: [ pkg ... ] | |||
</big></tt> | |||
==Descrizione== | ==Descrizione== | ||
<br> | <br> | ||
<u>module-assistant</u> | <u>module-assistant</u> è lo strumento da linea di comando per gestire i pacchetti-sorgente dei moduli che sono stati creati per la distribuzione Debian. <u>module-assistant</u> aiuta gli utenti a compilare e installare facilmente i pacchetti dei moduli per uno o più kernel personalizzati. | ||
<br> | <br> | ||
A meno che non sia usata l'opzione '''-h''', o '''--help''', dovrebbe essere presente uno dei comandi indicati | A meno che non sia usata l'opzione '''-h''', o '''--help''', dovrebbe essere presente uno dei comandi indicati più avanti per invocare esplicitamente una funzione. Se non viene specificato nessun comando (o il comando non è valido) ed il programma <tt>dialog</tt> è installato, verrà mostrata una semplice interfaccia grafica che vi guiderà tra le funzioni disponibili. | ||
<br> | <br> | ||
NOTA: non pensate neanche di usare il contenuto di un qualunque pacchetto kernel-source-x.y.z (o linux-x.y.z) scaricato da Internet per specificare i sorgenti del vostro kernel corrente. Non fatelo! Quei sorgenti non sono esattamente quelli usati per compilare il vostro kernel corrente e la loro configurazione molto probabilmente non corrisponde alla vostra. Avrete bisogno della directory dei sorgenti del kernel configurato o almeno del corrispondente pacchetto kernel-headers-... contentente la configurazione per la versione esatta del vostro kernel (tutta la stringa di versione). | NOTA: non pensate neanche di usare il contenuto di un qualunque pacchetto kernel-source-x.y.z (o linux-x.y.z) scaricato da Internet per specificare i sorgenti del vostro kernel corrente. Non fatelo! Quei sorgenti non sono esattamente quelli usati per compilare il vostro kernel corrente e la loro configurazione molto probabilmente non corrisponde alla vostra. Avrete bisogno della directory dei sorgenti del kernel configurato o almeno del corrispondente pacchetto kernel-headers-... contentente la configurazione per la versione esatta del vostro kernel (tutta la stringa di versione). | ||
| Riga 10: | Riga 24: | ||
Perfavore, si esegua il comando <u>module-assistant prepare</u> la prima volta, prima di fare qualsiasi altra operazione. | Perfavore, si esegua il comando <u>module-assistant prepare</u> la prima volta, prima di fare qualsiasi altra operazione. | ||
<br> | <br> | ||
Per alcuni pachetti, i kernel-headers (sorgenti ridotti) non sono sufficienti. | Per alcuni pachetti, i kernel-headers (sorgenti ridotti) non sono sufficienti. Potrà scegliere di eseguire un kernel completamente personalizzato, o di ricreare i sorgenti che sono stati usati per compilare il kernel corrente. La funzione <u>fakesource</u> potrebbe essere utile, leggere più avanti in proposito. | ||
<br> | <br> | ||
Per configurare i sorgenti del kernel opportunamente, | Per configurare i sorgenti del kernel opportunamente, è necessario assicurarsi che il file version.h venga generato. Per ottenerlo, configurare il kernel usualmente (<u>make menuconfig</u> ecc.) ed eseguire <u>make dep</u> (per il kernel 2.4.x) o <u>make prepare</u> (per i kernel 2.6 e superiori). | ||
<!-- </RefSect1> --> | <!-- </RefSect1> --> | ||
| Riga 18: | Riga 32: | ||
<br> | <br> | ||
Molti comandi richiedono che venga specificato il nome di un pacchetto sul quale dovranno essere applicati. | Molti comandi richiedono che venga specificato il nome di un pacchetto sul quale dovranno essere applicati. | ||
<u>pkg</u> | <u>pkg</u> può essere una singola parola (nome del pacchetto) o molti nomi. La parola <u>all</u> verra sostituita con la lista di tutti i pacchetti disponibili, la parola <u>alli</u> con la lista dei pacchetti (sorgente) correntemente installati e la parola <u>allu</u> verrà sostituita con la lista dei pacchetti che sembrano essere installati e spacchettati nella directory base dei sorgenti. | ||
Se un pacchetto sorgente con il nome dato non | Se un pacchetto sorgente con il nome dato non è disponibile, <u>module-assistant</u> (abbreviato: <u>m-a</u>) estenderà il nome del pacchetto con suffissi popolari come -kernel, -module, -source e loro combinazioni. | ||
<br> | <br> | ||
Possono essere specificati molti comandi contemporaneamente, ad es. "<u>m-a clean,get,build arla cdfs</u>" | Possono essere specificati molti comandi contemporaneamente, ad es. "<u>m-a clean,get,build arla cdfs</u>" è la maniera abbreviata di scrivere "module-assistant clean arla-modules-source ; module-assistant clean cdfs-src ; module-assistant get arla-modules-source cdfs-src ; module-assistan build arla-modules-source cdfs-src" (o simili). | ||
<br> | <br> | ||
Se non ti piace la GUI dialog/whiptail, usa pure l'opzione '''-t''' per disabilitarla. | Se non ti piace la GUI dialog/whiptail, usa pure l'opzione '''-t''' per disabilitarla. | ||
<br> | <br> | ||
<!-- <VariableList> --> | <!-- <VariableList> --> | ||
;update: <tt>update</tt> | ;update: <tt>update</tt> è usato per risincronizzare i file di indice delle versioni con i loro sorgenti. Questo avviene tramite gli script di supporto ("helper script") forniti dai pacchetti. <u>module-assistant</u> ha una lista preimpostata di pacchetti al quale fa riferimento, ma altri pacchetti possono essere registrati da <u>module-assistant</u> se il responsabile del pacchetto ("maintainer") aggiunge gli script di supporto. | ||
<!-- </VarListEntry> --> | <!-- </VarListEntry> --> | ||
;prepare: Cerca di determinare il nome del pacchetto kernel-headers richiesto (sia quello corrispondente al kernel correntemente in esecuzione che per le versioni specificate con -l), lo installa se necessario e crea il link simbolico <tt>/usr/src/linux</tt> se serve. | ;prepare: Cerca di determinare il nome del pacchetto kernel-headers richiesto (sia quello corrispondente al kernel correntemente in esecuzione che per le versioni specificate con -l), lo installa se necessario e crea il link simbolico <tt>/usr/src/linux</tt> se serve. | ||
| Riga 40: | Riga 54: | ||
;get: <tt>get</tt> seguito da una lista di pacchetti installa i pacchetti sorgente, scaricandoli se necessario. | ;get: <tt>get</tt> seguito da una lista di pacchetti installa i pacchetti sorgente, scaricandoli se necessario. | ||
<!-- </VarListEntry> --> | <!-- </VarListEntry> --> | ||
;build: <tt>build</tt> | ;build: <tt>build</tt> è seguito da uno o più pacchetti sorgente da compilare. Verranno scelti i sorgenti del kernel appropriati per il kernel corrente a meno che non vengano specificate directory diverse. Se la compilazione fallisce, guardare il file di log più recente in /var/cache/modass (o nel percorso personalizzato scelto dall'utente). | ||
<!-- </VarListEntry> --> | <!-- </VarListEntry> --> | ||
;install: <tt>install</tt> | ;install: <tt>install</tt> è seguito da uno o più pacchetti che si desidera installare. Verrà installato l'ultimo pacchetto compilato per il kernel corrente. | ||
<!-- </VarListEntry> --> | <!-- </VarListEntry> --> | ||
;auto-install | a-i: <tt>auto-install</tt> | ;auto-install | a-i: <tt>auto-install</tt> è seguito da uno o più pacchetti che si desidera installare. Usando questo comando il sistema sarà preparato per la compilazione dei pacchetti ('''prepare'''), saranno presi i sorgenti dei pacchetti specificati ('''get'''), ed infine module-assistant proverà a compilarli ('''build''') per il kernel corrente ed ad installarli ('''install'''). ''(NdT, traduzione libera)'' | ||
<!-- ORIGINALE: | <!-- ORIGINALE: | ||
;auto-install | a-i: <tt>auto-install</tt> is followed by one or more packages desired for installation. It will run prepare to configure your system to build packages, get the package source, try to build it for the current kernel and install it. | ;auto-install | a-i: <tt>auto-install</tt> is followed by one or more packages desired for installation. It will run prepare to configure your system to build packages, get the package source, try to build it for the current kernel and install it. | ||
| Riga 60: | Riga 74: | ||
FINE ORIGINALE --> | FINE ORIGINALE --> | ||
<!-- </VarListEntry> --> | <!-- </VarListEntry> --> | ||
;purge: <tt>purge</tt> cancella le informazioni della cache di un pacchetto sorgente e rimuove tutti i relativi pacchetti binari compilati localmente (dei quali module-assistant | ;purge: <tt>purge</tt> cancella le informazioni della cache di un pacchetto sorgente e rimuove tutti i relativi pacchetti binari compilati localmente (dei quali module-assistant è a conoscenza). USARE CON CAUTELA! (''NdT, un pacchetto o tutti i pacchetti ??'') | ||
<!-- ORIGINALE: | <!-- ORIGINALE: | ||
clears the information cache of a source package and removes all binary packages locally built from it (that module-assistant knows about). USE WITH CARE! | clears the information cache of a source package and removes all binary packages locally built from it (that module-assistant knows about). USE WITH CARE! | ||
| Riga 74: | Riga 88: | ||
<!-- </VarListEntry> --> | <!-- </VarListEntry> --> | ||
;-k: | ;-k: | ||
;--kernel-dir: La directory dei sorgenti del kernel da usare per la compilazione. Puoi specificare | ;--kernel-dir: La directory dei sorgenti del kernel da usare per la compilazione. Puoi specificare più directory ripetendo questo parametro o separando con virgole o separatori di linea le directory (es. usando <u>-k "`echo /usr/src/kernel-headers-*`"</u>). Le versioni dei kernel trovate in queste directory vengono aggiunte automaticamente alla lista delle versioni dei kernel su cui operare (guarda '''--kvers-list''' per maggiori dettagli). | ||
<!-- </VarListEntry> --> | <!-- </VarListEntry> --> | ||
;-l: | ;-l: | ||
;--kvers-list: Lista delle versioni dei kernel (come in KVERS) da processare. Se omesso, | ;--kvers-list: Lista delle versioni dei kernel (come in KVERS) da processare. Se omesso, verrà inserita la versione del kernel correntemente in uso sulla macchina. Se '''--kernel-dir''' specifica altre directory di sorgenti, verranno inserite anche le versioni dei kernel presenti in queste directory. | ||
:Il percorso dei sorgenti (o degli header) che dipendono da questa versione del kernel viene rilevato tramite un controllo nelle posizioni dove "normalmente" questi sono presenti, oppure possono essere specificati tramite l'opzione '''--kernel-dir'''. | :Il percorso dei sorgenti (o degli header) che dipendono da questa versione del kernel viene rilevato tramite un controllo nelle posizioni dove "normalmente" questi sono presenti, oppure possono essere specificati tramite l'opzione '''--kernel-dir'''. | ||
<!-- </VarListEntry> --> | <!-- </VarListEntry> --> | ||
| Riga 84: | Riga 98: | ||
<!-- </VarListEntry> --> | <!-- </VarListEntry> --> | ||
;-n: | ;-n: | ||
;--no-rebuild: Se un pacchetto che deve essere generato esiste | ;--no-rebuild: Se un pacchetto che deve essere generato esiste già nella directory di destinazione (forse in una vecchia versione), '''-n''' evita che che venga ricompilato. | ||
:Il comportamento predefinito | :Il comportamento predefinito è di evitare la ricompilazione quando deve essere generato un file esattamente uguale (con lo stesso nome) ad uno già esistente, il nuovo nome del file dovrebbe essere rilevato prima dell'inizio del processo di compilazione (questo comportamento dipende dal pacchetto del modulo). | ||
<!-- </VarListEntry> --> | <!-- </VarListEntry> --> | ||
;-f: | ;-f: | ||
;--force: Non controlla il file di destinazione (in un'altra versione) e forza la compilazione. | ;--force: Non controlla il file di destinazione (in un'altra versione) e forza la compilazione. | ||
:Per il comando get, scarica una nuova versione del pacchetto anche se | :Per il comando get, scarica una nuova versione del pacchetto anche se è già stata installata. | ||
<!-- </VarListEntry> --> | <!-- </VarListEntry> --> | ||
;-u: | ;-u: | ||
| Riga 95: | Riga 109: | ||
<!-- </VarListEntry> --> | <!-- </VarListEntry> --> | ||
;-i: | ;-i: | ||
;--non-inter: Quando la compilazione del pacchetto non si conclude con successo, continua con gli elementi restanti. Come comportamento predefinito, module-assistant | ;--non-inter: Quando la compilazione del pacchetto non si conclude con successo, continua con gli elementi restanti. Come comportamento predefinito, module-assistant suggerirà di esaminare i log della compilazione. Questa opzione potrebbe modificare il comportamento di dpkg e apt-get per ridurre la richiesta di interventi umani ed installare le dipendenze di compilazione necessarie. | ||
<!-- </VarListEntry> --> | <!-- </VarListEntry> --> | ||
;-s: | ;-s: | ||
| Riga 112: | Riga 126: | ||
;KPKG_DEST_DIR: <tt>KPKG_DEST_DIR</tt> specifica la directory in cui il pacchetto Debian risultante dovrebbe essere installato. Tuttavia, molti pacchetti ignorano questa variabile e installano i file all'interno della directory dei sorgenti del kernel od in sotto-directory del percorso corrente. | ;KPKG_DEST_DIR: <tt>KPKG_DEST_DIR</tt> specifica la directory in cui il pacchetto Debian risultante dovrebbe essere installato. Tuttavia, molti pacchetti ignorano questa variabile e installano i file all'interno della directory dei sorgenti del kernel od in sotto-directory del percorso corrente. | ||
<!-- </VarListEntry> --> | <!-- </VarListEntry> --> | ||
;SIGNCHANGES: Se <tt>SIGNCHANGES</tt> | ;SIGNCHANGES: Se <tt>SIGNCHANGES</tt> è impostato, saranno generati i file .change (chiamando la regola <tt>kdist_image</tt> invece di kdist) e debsign (oppure gpg o pgp) sarà eseguito per firmare le modifiche. | ||
<!-- </VarListEntry> --> | <!-- </VarListEntry> --> | ||
;KMAINT | DEBFULLNAME | DEBNAME: Specifica il nome reale della persona che che compila il pacchetto, interessa solo per i file .change. Inoltre se KMAINT | ;KMAINT | DEBFULLNAME | DEBNAME: Specifica il nome reale della persona che che compila il pacchetto, interessa solo per i file .change. Inoltre se KMAINT è impostata e <tt>KPKG_DEST_DIR</tt> no, <tt>DEB_DESTDIR</tt> diventerà <tt>$(KSRC)/..</tt> . | ||
<!-- </VarListEntry> --> | <!-- </VarListEntry> --> | ||
;KEMAIL | DEBEMAIL : Specifica l'email della persona che compila il pacchetto (interessa solo per i file .change). (''NdT: nell'originale era il nome e non l'email ???'') | ;KEMAIL | DEBEMAIL : Specifica l'email della persona che compila il pacchetto (interessa solo per i file .change). (''NdT: nell'originale era il nome e non l'email ???'') | ||
| Riga 121: | Riga 135: | ||
FINE ORIG --> | FINE ORIG --> | ||
<!-- </VarListEntry> --> | <!-- </VarListEntry> --> | ||
;MODULE_LOC: Un percorso differente per la directory del sorgente dei moduli ( | ;MODULE_LOC: Un percorso differente per la directory del sorgente dei moduli (già estratti). Il default è '''''/usr/src/modules'''''. | ||
<!-- </VarListEntry> --> | <!-- </VarListEntry> --> | ||
;MA_VARDIR: Un percorso differente per i dati di cache, usati dagli script di supporto (''helper script'') dei pacchetti installati da <u>module-assistant</u>. Il default | ;MA_VARDIR: Un percorso differente per i dati di cache, usati dagli script di supporto (''helper script'') dei pacchetti installati da <u>module-assistant</u>. Il default è '''''/var/cache/modass'''''. | ||
<!-- </VarListEntry> --> | <!-- </VarListEntry> --> | ||
;MOD_SRCDIR: Un percorso differente per gli archivi dei sorgenti dei moduli. Il default | ;MOD_SRCDIR: Un percorso differente per gli archivi dei sorgenti dei moduli. Il default è '''''/usr/src'''''. | ||
<!-- </VarListEntry> --> | <!-- </VarListEntry> --> | ||
;ROOT_CMD: Comando wrapper per eseguire comandi con privileggi di root. Se non si | ;ROOT_CMD: Comando wrapper per eseguire comandi con privileggi di root. Se non si è root, viene scelto automaticamente fakeroot. Questa variabile deve essere interpretata dai singoli pacchetti, quindi alcuni di essi potrebbero ignorarla. Tuttavia si può sempre eseguire module-assistant dentro il wrapper ROOT_CMD. | ||
<!-- </VarListEntry> --> | <!-- </VarListEntry> --> | ||
<!-- </VariableList> --> | <!-- </VariableList> --> | ||
| Riga 134: | Riga 148: | ||
==Uso Non-Root== | ==Uso Non-Root== | ||
<br> | <br> | ||
<u>module-assistant</u> | <u>module-assistant</u> può funzionare senza essere root. Tuttavia non sarai in grado di utilizzare apt-get o dpkg per installare i pacchetti, e non potrai scrivere in /var/cache/modass su un normale sistema Debian. Quindi i comandi <u>get</u>, <u>install</u>, <u>auto-install</u> e <u>prepare</u> sono taboo per i normali utenti. Tuttavia, se il programma sudo è installato, verrà invocato per l'utilizzo di apt-get e dpkg. | ||
Tutti gli altri comandi ad eccezione di <u>list</u> | Tutti gli altri comandi ad eccezione di <u>list</u> | ||
richiedono delle variabili di ambiente aggiuntive per spostare modificare i path di destinazione in posizioni accessibili in scrittura dagli utenti. Queste possono essere redirette verso un determinato percorso (una directory con i permessi di scrittura) tramite l'opzione -u. | richiedono delle variabili di ambiente aggiuntive per spostare modificare i path di destinazione in posizioni accessibili in scrittura dagli utenti. Queste possono essere redirette verso un determinato percorso (una directory con i permessi di scrittura) tramite l'opzione -u. | ||