1edba5eecSFederico Vaga.. include:: ../disclaimer-ita.rst 2edba5eecSFederico Vaga 3edba5eecSFederico Vaga:Original: :ref:`Documentation/process/stable-kernel-rules.rst <stable_kernel_rules>` 498348577SFederico Vaga:Translator: Federico Vaga <federico.vaga@vaga.pv.it> 5edba5eecSFederico Vaga 6edba5eecSFederico Vaga.. _it_stable_kernel_rules: 7edba5eecSFederico Vaga 8edba5eecSFederico VagaTutto quello che volevate sapere sui rilasci -stable di Linux 9edba5eecSFederico Vaga============================================================== 10edba5eecSFederico Vaga 1198348577SFederico VagaRegole sul tipo di patch che vengono o non vengono accettate nei sorgenti 1298348577SFederico Vaga"-stable": 13edba5eecSFederico Vaga 14*1a0e2cd9SFederico Vaga- Questa patch o una equivalente deve esistere già nei sorgenti principali di 15*1a0e2cd9SFederico Vaga Linux (upstream) 1698348577SFederico Vaga- Ovviamente dev'essere corretta e verificata. 1798348577SFederico Vaga- Non dev'essere più grande di 100 righe, incluso il contesto. 18*1a0e2cd9SFederico Vaga- Deve rispettare le regole scritte in 19*1a0e2cd9SFederico Vaga :ref:`Documentation/translations/it_IT/process/submitting-patches.rst <it_submittingpatches>` 20*1a0e2cd9SFederico Vaga- Deve correggere un vero baco che causi problemi agli utenti oppure aggiunge 21*1a0e2cd9SFederico Vaga un nuovo identificatore di dispositivo. Maggiori dettagli per il primo caso: 22*1a0e2cd9SFederico Vaga 23*1a0e2cd9SFederico Vaga - Corregge un problema come un oops, un blocco, una corruzione di dati, un 24*1a0e2cd9SFederico Vaga vero problema di sicurezza, una stranezza hardware, un problema di 25*1a0e2cd9SFederico Vaga compilazione (ma non per cose già segnate con CONFIG_BROKEN), o problemi 26*1a0e2cd9SFederico Vaga del tipo "oh, questo non va bene". 2798348577SFederico Vaga - Problemi importanti riportati dagli utenti di una distribuzione potrebbero 2898348577SFederico Vaga essere considerati se correggono importanti problemi di prestazioni o di 2998348577SFederico Vaga interattività. Dato che questi problemi non sono così ovvi e la loro 30*1a0e2cd9SFederico Vaga correzione ha un'alta probabilità d'introdurre una regressione, 31*1a0e2cd9SFederico Vaga dovrebbero essere sottomessi solo dal manutentore della distribuzione 32*1a0e2cd9SFederico Vaga includendo un link, se esiste, ad un rapporto su bugzilla, e informazioni 33*1a0e2cd9SFederico Vaga aggiuntive sull'impatto che ha sugli utenti. 34*1a0e2cd9SFederico Vaga - Non si accettano cose del tipo "Questo potrebbe essere un problema ..." 35*1a0e2cd9SFederico Vaga come una teorica sezione critica, senza aver fornito anche una spiegazione 36*1a0e2cd9SFederico Vaga su come il baco possa essere sfruttato. 3798348577SFederico Vaga - Non deve includere alcuna correzione "banale" (correzioni grammaticali, 3898348577SFederico Vaga pulizia dagli spazi bianchi, eccetera). 3998348577SFederico Vaga 4098348577SFederico VagaProcedura per sottomettere patch per i sorgenti -stable 4198348577SFederico Vaga------------------------------------------------------- 4298348577SFederico Vaga 43da1d9cafSFederico Vaga.. note:: 44da1d9cafSFederico Vaga Una patch di sicurezza non dovrebbe essere gestita (solamente) dal processo 4598348577SFederico Vaga di revisione -stable, ma dovrebbe seguire le procedure descritte in 46dfce05c8SFederico Vaga :ref:`Documentation/translations/it_IT/process/security-bugs.rst <it_securitybugs>`. 4798348577SFederico Vaga 48*1a0e2cd9SFederico VagaCi sono tre opzioni per inviare una modifica per i sorgenti -stable: 49*1a0e2cd9SFederico Vaga 50*1a0e2cd9SFederico Vaga1. Aggiungi un'etichetta 'stable' alla descrizione della patch al momento della 51*1a0e2cd9SFederico Vaga sottomissione per l'inclusione nei sorgenti principali. 52*1a0e2cd9SFederico Vaga2. Chiedere alla squadra "stable" di prendere una patch già applicata sui 53*1a0e2cd9SFederico Vaga sorgenti principali 54*1a0e2cd9SFederico Vaga3. Sottomettere una patch alla squadra "stable" equivalente ad una modifica già 55*1a0e2cd9SFederico Vaga fatta sui sorgenti principali. 56*1a0e2cd9SFederico Vaga 57*1a0e2cd9SFederico VagaLe seguenti sezioni descrivono con maggiori dettagli ognuna di queste opzioni 58*1a0e2cd9SFederico Vaga 59*1a0e2cd9SFederico VagaL':ref:`it_option_1` è **fortemente** raccomandata; è il modo più facile e 60*1a0e2cd9SFederico Vagausato. L':ref:`it_option_2` si usa quando al momento della sottomissione non si 61*1a0e2cd9SFederico Vagaera pensato di riportare la modifica su versioni precedenti. 62*1a0e2cd9SFederico VagaL':ref:`it_option_3` è un'alternativa ai due metodi precedenti quando la patch 63*1a0e2cd9SFederico Vaganei sorgenti principali ha bisogno di aggiustamenti per essere applicata su 64*1a0e2cd9SFederico Vagaversioni precedenti (per esempio a causa di cambiamenti dell'API). 65*1a0e2cd9SFederico Vaga 66*1a0e2cd9SFederico VagaQuando si utilizza l'opzione 2 o 3 è possibile chiedere che la modifica sia 67*1a0e2cd9SFederico Vagainclusa in specifiche versioni stabili. In tal caso, assicurarsi che la correzione 68*1a0e2cd9SFederico Vagao una equivalente sia applicabile, o già presente in tutti i sorgenti 69*1a0e2cd9SFederico Vagastabili più recenti ancora supportati. Questo ha lo scopo di prevenire 70*1a0e2cd9SFederico Vagaregressioni che gli utenti potrebbero incontrare in seguito durante 71*1a0e2cd9SFederico Vagal'aggiornamento, se ad esempio una correzione per 5.19-rc1 venisse 72*1a0e2cd9SFederico Vagariportata a 5.10.y, ma non a 5.15.y. 7398348577SFederico Vaga 7498348577SFederico Vaga.. _it_option_1: 7598348577SFederico Vaga 7698348577SFederico VagaOpzione 1 7798348577SFederico Vaga********* 7898348577SFederico Vaga 79*1a0e2cd9SFederico VagaAggiungete la seguente etichetta nell'area delle firme per far sì che una patch 80*1a0e2cd9SFederico Vagache state inviando per l'inclusione nei sorgenti principali venga presa 81*1a0e2cd9SFederico Vagaautomaticamente anche per quelli stabili:: 8298348577SFederico Vaga 8398348577SFederico Vaga Cc: stable@vger.kernel.org 8498348577SFederico Vaga 85*1a0e2cd9SFederico VagaInvece, usate ``Cc: stable@vger.kernel.org`` quando state inviando correzioni 86*1a0e2cd9SFederico Vagaper vulnerabilità non ancora di pubblico dominio: questo riduce il rischio di 87*1a0e2cd9SFederico Vagaesporre accidentalmente al pubblico la correzione quando si usa 'git 88*1a0e2cd9SFederico Vagasend-email', perché i messaggi inviati a quell'indirizzo non vengono inviati da 89*1a0e2cd9SFederico Vaganessuna parte. 9098348577SFederico Vaga 91*1a0e2cd9SFederico VagaUna volta che la patch è stata inclusa, verrà applicata anche sui sorgenti 92*1a0e2cd9SFederico Vagastabili senza che l'autore o il manutentore del sottosistema debba fare 93*1a0e2cd9SFederico Vagaqualcosa. 9498348577SFederico Vaga 95*1a0e2cd9SFederico VagaPer lasciare una nota per la squadra "stable", usate commenti in linea in stile 96*1a0e2cd9SFederico Vagashell (leggere oltre per maggiori dettagli). 9798348577SFederico Vaga 98*1a0e2cd9SFederico Vaga* Specificate i prerequisiti per le patch aggiuntive:: 9998348577SFederico Vaga 10098348577SFederico Vaga Cc: <stable@vger.kernel.org> # 3.3.x: a1f84a3: sched: Check for idle 10198348577SFederico Vaga Cc: <stable@vger.kernel.org> # 3.3.x: 1b9508f: sched: Rate-limit newidle 10298348577SFederico Vaga Cc: <stable@vger.kernel.org> # 3.3.x: fd21073: sched: Fix affinity logic 10398348577SFederico Vaga Cc: <stable@vger.kernel.org> # 3.3.x 10498348577SFederico Vaga Signed-off-by: Ingo Molnar <mingo@elte.hu> 10598348577SFederico Vaga 106*1a0e2cd9SFederico Vaga La sequenza di etichette ha il seguente significato:: 10798348577SFederico Vaga 10898348577SFederico Vaga git cherry-pick a1f84a3 10998348577SFederico Vaga git cherry-pick 1b9508f 11098348577SFederico Vaga git cherry-pick fd21073 11198348577SFederico Vaga git cherry-pick <this commit> 11298348577SFederico Vaga 113*1a0e2cd9SFederico Vaga Notate che per una serie di patch non dovere elencare come necessarie tutte 114*1a0e2cd9SFederico Vaga le patch della serie stessa. Per esempio se avete la seguente serie:: 11598348577SFederico Vaga 116*1a0e2cd9SFederico Vaga patch1 117*1a0e2cd9SFederico Vaga patch2 118*1a0e2cd9SFederico Vaga 119*1a0e2cd9SFederico Vaga dove patch2 dipende da patch1, non dovete elencare patch1 come requisito per 120*1a0e2cd9SFederico Vaga patch2 se avete già menzionato patch1 per l'inclusione in "stable" 121*1a0e2cd9SFederico Vaga 122*1a0e2cd9SFederico Vaga* Evidenziate le patch che hanno dei requisiti circa la versione del kernel:: 12398348577SFederico Vaga 12498348577SFederico Vaga Cc: <stable@vger.kernel.org> # 3.3.x 12598348577SFederico Vaga 126*1a0e2cd9SFederico Vaga L'etichetta ha il seguente significato:: 12798348577SFederico Vaga 12898348577SFederico Vaga git cherry-pick <this commit> 12998348577SFederico Vaga 13098348577SFederico Vaga per ogni sorgente "-stable" che inizia con la versione indicata. 13198348577SFederico Vaga 132*1a0e2cd9SFederico Vaga Notate che queste etichette non sono necessarie se la squadre "stable" può 133*1a0e2cd9SFederico Vaga dedurre la versione dalle etichette Fixes: 13498348577SFederico Vaga 135*1a0e2cd9SFederico Vaga* Ritardare l'inclusione di patch:: 136*1a0e2cd9SFederico Vaga Cc: <stable@vger.kernel.org> # after -rc3 13798348577SFederico Vaga 138*1a0e2cd9SFederico Vaga* Evidenziare problemi noti:: 139*1a0e2cd9SFederico Vaga 140*1a0e2cd9SFederico Vaga Cc: <stable@vger.kernel.org> # see patch description, needs adjustments for <= 6.3 141*1a0e2cd9SFederico Vaga 142*1a0e2cd9SFederico VagaEsiste un'ulteriore variante per l'etichetta "stable" che permette di comunicare 143*1a0e2cd9SFederico Vagaallo strumento di *backporting* di ignorare un cambiamento:: 144*1a0e2cd9SFederico Vaga 145*1a0e2cd9SFederico Vaga Cc: <stable+noautosel@kernel.org> # reason goes here, and must be present 146*1a0e2cd9SFederico Vaga 147*1a0e2cd9SFederico Vaga 148*1a0e2cd9SFederico Vaga.. _it_option_2: 149*1a0e2cd9SFederico Vaga 150*1a0e2cd9SFederico VagaOpzione 2 151*1a0e2cd9SFederico Vaga********* 152*1a0e2cd9SFederico Vaga 153*1a0e2cd9SFederico VagaSe la patch è già stata inclusa nei sorgenti Linux, inviate una mail a 154*1a0e2cd9SFederico Vagastable@vger.kernel.org includendo: il titolo della patch, l'identificativo 155*1a0e2cd9SFederico Vagadel commit, il perché pensate che debba essere applicata, e in quali versioni 156*1a0e2cd9SFederico Vagadel kernel la vorreste vedere. 157*1a0e2cd9SFederico Vaga 158*1a0e2cd9SFederico Vaga.. _it_option_3: 159*1a0e2cd9SFederico Vaga 160*1a0e2cd9SFederico VagaOpzione 3 161*1a0e2cd9SFederico Vaga********* 162*1a0e2cd9SFederico Vaga 163*1a0e2cd9SFederico VagaDopo aver verificato che rispetta le regole descritte in precedenza, inviata la 164*1a0e2cd9SFederico Vagapatch a stable@vger.kernel.org facendo anche menzione delle versioni nella quale 165*1a0e2cd9SFederico Vagasi vorrebbe applicarla. Nel farlo, dovete annotare nel changelog 166*1a0e2cd9SFederico Vagal'identificativo del commit nei sorgenti principali, così come la versione del 167*1a0e2cd9SFederico Vagakernel nel quale vorreste vedere la patch.:: 168*1a0e2cd9SFederico Vaga 169*1a0e2cd9SFederico Vaga commit <sha1> upstream. 170*1a0e2cd9SFederico Vaga 171*1a0e2cd9SFederico Vagao in alternativa:: 172*1a0e2cd9SFederico Vaga 173*1a0e2cd9SFederico Vaga [ Upstream commit <sha1> ] 174*1a0e2cd9SFederico Vaga 175*1a0e2cd9SFederico VagaSe la patch inviata devia rispetto all'originale presente nei sorgenti 176*1a0e2cd9SFederico Vagaprincipali (per esempio per adattarsi ad un cambiamento di API), allora questo 177*1a0e2cd9SFederico Vagadev'essere giustificato e dettagliato in modo chiaro nella descrizione. 178*1a0e2cd9SFederico Vaga 179*1a0e2cd9SFederico VagaDopo la sottomissione 180*1a0e2cd9SFederico Vaga--------------------- 181*1a0e2cd9SFederico Vaga 182*1a0e2cd9SFederico VagaIl mittente riceverà un ACK quando la patch è stata accettata e messa in coda, 183*1a0e2cd9SFederico Vagaoppure un NAK se la patch è stata rigettata. La risposta potrebbe richiedere 184*1a0e2cd9SFederico Vagaalcuni giorni in funzione dei piani dei membri della squadra "stable", 185*1a0e2cd9SFederico Vaga 186*1a0e2cd9SFederico VagaSe accettata, la patch verrà aggiunta alla coda -stable per essere revisionata 187*1a0e2cd9SFederico Vagadal altri sviluppatori e dal principale manutentore del sottosistema. 18898348577SFederico Vaga 18998348577SFederico VagaCiclo di una revisione 19098348577SFederico Vaga---------------------- 19198348577SFederico Vaga 19298348577SFederico Vaga- Quando i manutentori -stable decidono di fare un ciclo di revisione, le 19398348577SFederico Vaga patch vengono mandate al comitato per la revisione, ai manutentori soggetti 19498348577SFederico Vaga alle modifiche delle patch (a meno che il mittente non sia anche il 19598348577SFederico Vaga manutentore di quell'area del kernel) e in CC: alla lista di discussione 19698348577SFederico Vaga linux-kernel. 19798348577SFederico Vaga- La commissione per la revisione ha 48 ore per dare il proprio ACK o NACK 19898348577SFederico Vaga alle patch. 19998348577SFederico Vaga- Se una patch viene rigettata da un membro della commissione, o un membro 20098348577SFederico Vaga della lista linux-kernel obietta la bontà della patch, sollevando problemi 20198348577SFederico Vaga che i manutentori ed i membri non avevano compreso, allora la patch verrà 20298348577SFederico Vaga rimossa dalla coda. 203da1d9cafSFederico Vaga- Le patch che hanno ricevuto un ACK verranno inviate nuovamente come parte di 204da1d9cafSFederico Vaga un rilascio candidato (-rc) al fine di essere verificate dagli sviluppatori e 205da1d9cafSFederico Vaga dai testatori. 206da1d9cafSFederico Vaga- Solitamente si pubblica solo una -rc, tuttavia se si riscontrano problemi 207da1d9cafSFederico Vaga importanti, alcune patch potrebbero essere modificate o essere scartate, 208da1d9cafSFederico Vaga oppure nuove patch potrebbero essere messe in coda. Dunque, verranno pubblicate 209da1d9cafSFederico Vaga nuove -rc e così via finché non si ritiene che non vi siano più problemi. 210da1d9cafSFederico Vaga- Si può rispondere ad una -rc scrivendo sulla lista di discussione un'email 211da1d9cafSFederico Vaga con l'etichetta "Tested-by:". Questa etichetta verrà raccolta ed aggiunta al 212da1d9cafSFederico Vaga commit rilascio. 213da1d9cafSFederico Vaga- Alla fine del ciclo di revisione il nuovo rilascio -stable conterrà tutte le 214da1d9cafSFederico Vaga patch che erano in coda e sono state verificate. 21598348577SFederico Vaga- Le patch di sicurezza verranno accettate nei sorgenti -stable direttamente 21698348577SFederico Vaga dalla squadra per la sicurezza del kernel, e non passerà per il normale 21798348577SFederico Vaga ciclo di revisione. Contattate la suddetta squadra per maggiori dettagli 21898348577SFederico Vaga su questa procedura. 21998348577SFederico Vaga 22098348577SFederico VagaSorgenti 22198348577SFederico Vaga-------- 22298348577SFederico Vaga 22398348577SFederico Vaga- La coda delle patch, sia quelle già applicate che in fase di revisione, 22498348577SFederico Vaga possono essere trovate al seguente indirizzo: 22598348577SFederico Vaga 22698348577SFederico Vaga https://git.kernel.org/pub/scm/linux/kernel/git/stable/stable-queue.git 22798348577SFederico Vaga 22898348577SFederico Vaga- Il rilascio definitivo, e marchiato, di tutti i kernel stabili può essere 22998348577SFederico Vaga trovato in rami distinti per versione al seguente indirizzo: 23098348577SFederico Vaga 231da1d9cafSFederico Vaga https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git 23298348577SFederico Vaga 233da1d9cafSFederico Vaga- I rilasci candidati di tutti i kernel stabili possono essere trovati al 234da1d9cafSFederico Vaga seguente indirizzo: 235da1d9cafSFederico Vaga 236da1d9cafSFederico Vaga https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux-stable-rc.git/ 237da1d9cafSFederico Vaga 238da1d9cafSFederico Vaga .. warning:: 239da1d9cafSFederico Vaga I sorgenti -stable-rc sono un'istantanea dei sorgenti stable-queue e 240da1d9cafSFederico Vaga subirà frequenti modifiche, dunque verrà anche trapiantato spesso. 241da1d9cafSFederico Vaga Dovrebbe essere usato solo allo scopo di verifica (per esempio in un 242da1d9cafSFederico Vaga sistema di CI) 24398348577SFederico Vaga 24498348577SFederico VagaComitato per la revisione 24598348577SFederico Vaga------------------------- 24698348577SFederico Vaga 24798348577SFederico Vaga- Questo comitato è fatto di sviluppatori del kernel che si sono offerti 24898348577SFederico Vaga volontari per questo lavoro, e pochi altri che non sono proprio volontari. 249