sphinx.addnodesdocument)}( rawsourcechildren]( translations LanguagesNode)}(hhh](h pending_xref)}(hhh]docutils.nodesTextEnglish}parenthsba attributes}(ids]classes]names]dupnames]backrefs] refdomainstdreftypedoc reftarget/process/deprecatedmodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Simplified)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget&/translations/zh_CN/process/deprecatedmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hChinese (Traditional)}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget&/translations/zh_TW/process/deprecatedmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget&/translations/ja_JP/process/deprecatedmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget&/translations/ko_KR/process/deprecatedmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget&/translations/sp_SP/process/deprecatedmodnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageItalianuh1h hh _documenthsourceNlineNubhcomment)}(h SPDX-License-Identifier: GPL-2.0h]h SPDX-License-Identifier: GPL-2.0}hhsbah}(h]h ]h"]h$]h&] xml:spacepreserveuh1hhhhhhS/var/lib/git/docbuild/linux/Documentation/translations/it_IT/process/deprecated.rsthKubhwarning)}(hIn caso di dubbi sulla correttezza del contenuto di questa traduzione, l'unico riferimento valido è la documentazione ufficiale in inglese. Per maggiori informazioni consultate le :ref:`avvertenze `.h]h paragraph)}(hIn caso di dubbi sulla correttezza del contenuto di questa traduzione, l'unico riferimento valido è la documentazione ufficiale in inglese. Per maggiori informazioni consultate le :ref:`avvertenze `.h](hIn caso di dubbi sulla correttezza del contenuto di questa traduzione, l’unico riferimento valido è la documentazione ufficiale in inglese. Per maggiori informazioni consultate le }(hhhhhNhNubh)}(h!:ref:`avvertenze `h]hinline)}(hhh]h avvertenze}(hhhhhNhNubah}(h]h ](xrefstdstd-refeh"]h$]h&]uh1hhhubah}(h]h ]h"]h$]h&]refdoc%translations/it_IT/process/deprecated refdomainhՌreftyperef refexplicitrefwarn reftarget it_disclaimeruh1hh3Documentation/translations/it_IT/disclaimer-ita.rsthKhhubh.}(hhhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhhubah}(h]h ]h"]h$]h&]uh1hhhhhhhhNubh field_list)}(hhh](hfield)}(hhh](h field_name)}(hOriginalh]hOriginal}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhhhKubh field_body)}(h8:ref:`Documentation/process/deprecated.rst `h]h)}(hjh]h)}(hjh]h)}(hjh]h$Documentation/process/deprecated.rst}(hj hhhNhNubah}(h]h ](hԌstdstd-refeh"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]refdoch refdomainj*reftyperef refexplicitrefwarnh deprecateduh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1hhhhKhhhhubj)}(hhh](j)}(h Translatorh]h Translator}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjNhhhKubj)}(h)Federico Vaga h]h)}(h(Federico Vaga h](hFederico Vaga <}(hjchhhNhNubh reference)}(hfederico.vaga@vaga.pv.ith]hfederico.vaga@vaga.pv.it}(hjmhhhNhNubah}(h]h ]h"]h$]h&]refurimailto:federico.vaga@vaga.pv.ituh1jkhjcubh>}(hjchhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhj_ubah}(h]h ]h"]h$]h&]uh1jhjNubeh}(h]h ]h"]h$]h&]uh1hhhhKhhhhubeh}(h]h ]h"]h$]h&]uh1hhhhhhhhKubhtarget)}(h.. _it_deprecated:h]h}(h]h ]h"]h$]h&]refid it-deprecateduh1jhKhhhhhhubhsection)}(hhh](htitle)}(hNInterfacce deprecate, caratteristiche del linguaggio, attributi, e convenzionih]hNInterfacce deprecate, caratteristiche del linguaggio, attributi, e convenzioni}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhhhhhK ubh)}(hXIn un mondo perfetto, sarebbe possibile prendere tutti gli usi di un'interfaccia deprecata e convertirli in quella nuova, e così sarebbe possibile rimuovere la vecchia interfaccia in un singolo ciclo di sviluppo. Tuttavia, per via delle dimensioni del kernel, la gerarchia dei manutentori e le tempistiche, non è sempre possibile fare questo tipo di conversione tutta in una volta. Questo significa che nuove istanze di una vecchia interfaccia potrebbero aggiungersi al kernel proprio quando si sta cercando di rimuoverle, aumentando così il carico di lavoro. Al fine di istruire gli sviluppatori su cosa è considerato deprecato (e perché), è stata create la seguente lista a cui fare riferimento quando qualcuno propone modifiche che usano cose deprecate.h]hXIn un mondo perfetto, sarebbe possibile prendere tutti gli usi di un’interfaccia deprecata e convertirli in quella nuova, e così sarebbe possibile rimuovere la vecchia interfaccia in un singolo ciclo di sviluppo. Tuttavia, per via delle dimensioni del kernel, la gerarchia dei manutentori e le tempistiche, non è sempre possibile fare questo tipo di conversione tutta in una volta. Questo significa che nuove istanze di una vecchia interfaccia potrebbero aggiungersi al kernel proprio quando si sta cercando di rimuoverle, aumentando così il carico di lavoro. Al fine di istruire gli sviluppatori su cosa è considerato deprecato (e perché), è stata create la seguente lista a cui fare riferimento quando qualcuno propone modifiche che usano cose deprecate.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubj)}(hhh](j)}(h __deprecatedh]h __deprecated}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhhhhhKubh)}(hX[Nonostante questo attributo marchi visibilmente un interfaccia come deprecata, `non produce più alcun avviso durante la compilazione `_ perché uno degli obiettivi del kernel è quello di compilare senza avvisi; inoltre, nessuno stava agendo per rimuovere queste interfacce. Nonostante l'uso di `__deprecated` in un file d'intestazione sia opportuno per segnare una interfaccia come 'vecchia', questa non è una soluzione completa. L'interfaccia deve essere rimossa dal kernel, o aggiunta a questo documento per scoraggiarne l'uso.h](hONonostante questo attributo marchi visibilmente un interfaccia come deprecata, }(hjhhhNhNubjl)}(h`non produce più alcun avviso durante la compilazione `_h]h5non produce più alcun avviso durante la compilazione}(hjhhhNhNubah}(h]h ]h"]h$]h&]name5non produce più alcun avviso durante la compilazionerefuriEhttps://git.kernel.org/linus/771c035372a036f83353eef46dbb829780330234uh1jkhjubj)}(hH h]h}(h]4non-produce-piu-alcun-avviso-durante-la-compilazioneah ]h"]5non produce più alcun avviso durante la compilazioneah$]h&]refurijuh1j referencedKhjubh perché uno degli obiettivi del kernel è quello di compilare senza avvisi; inoltre, nessuno stava agendo per rimuovere queste interfacce. Nonostante l’uso di }(hjhhhNhNubhtitle_reference)}(h`__deprecated`h]h __deprecated}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh in un file d’intestazione sia opportuno per segnare una interfaccia come ‘vecchia’, questa non è una soluzione completa. L’interfaccia deve essere rimossa dal kernel, o aggiunta a questo documento per scoraggiarne l’uso.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubeh}(h] deprecatedah ]h"] __deprecatedah$]h&]uh1jhjhhhhhKubj)}(hhh](j)}(hBUG() e BUG_ON()h]hBUG() e BUG_ON()}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj)hhhhhK&ubh)}(hX_Al loro posto usate WARN() e WARN_ON() per gestire le condizioni "impossibili" e gestitele come se fosse possibile farlo. Nonostante le funzioni della famiglia BUG() siano state progettate per asserire "situazioni impossibili" e interrompere in sicurezza un thread del kernel, queste si sono rivelate essere troppo rischiose (per esempio, in quale ordine rilasciare i *lock*? Ci sono stati che sono stati ripristinati?). Molto spesso l'uso di BUG() destabilizza il sistema o lo corrompe del tutto, il che rende impossibile un'attività di debug o anche solo leggere un rapporto circa l'errore. Linus ha un'opinione molto critica al riguardo: `email 1 `_, `email 2 `_h](hXxAl loro posto usate WARN() e WARN_ON() per gestire le condizioni “impossibili” e gestitele come se fosse possibile farlo. Nonostante le funzioni della famiglia BUG() siano state progettate per asserire “situazioni impossibili” e interrompere in sicurezza un thread del kernel, queste si sono rivelate essere troppo rischiose (per esempio, in quale ordine rilasciare i }(hj:hhhNhNubhemphasis)}(h*lock*h]hlock}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jBhj:ubhX? Ci sono stati che sono stati ripristinati?). Molto spesso l’uso di BUG() destabilizza il sistema o lo corrompe del tutto, il che rende impossibile un’attività di debug o anche solo leggere un rapporto circa l’errore. Linus ha un’opinione molto critica al riguardo: }(hj:hhhNhNubjl)}(hm`email 1 `_h]hemail 1}(hjVhhhNhNubah}(h]h ]h"]h$]h&]nameemail 1j`https://lore.kernel.org/lkml/CA+55aFy6jNLsywVYdGp83AMrXBo_P-pkjkphPGrO=82SPKCpLQ@mail.gmail.com/uh1jkhj:ubj)}(hc h]h}(h]email-1ah ]h"]email 1ah$]h&]refurijfuh1jjKhj:ubh, }(hj:hhhNhNubjl)}(hm`email 2 `_h]hemail 2}(hjxhhhNhNubah}(h]h ]h"]h$]h&]nameemail 2j`https://lore.kernel.org/lkml/CAHk-=whDHsbK3HTOpTF=ue_o04onRwTEaK_ZoJp_fjbqq4+=Jw@mail.gmail.com/uh1jkhj:ubj)}(hc h]h}(h]email-2ah ]h"]email 2ah$]h&]refurijuh1jjKhj:ubeh}(h]h ]h"]h$]h&]uh1hhhhK'hj)hhubh)}(hX?Tenete presente che la famiglia di funzioni WARN() dovrebbe essere usato solo per situazioni che si suppone siano "impossibili". Se volete avvisare gli utenti riguardo a qualcosa di possibile anche se indesiderato, usare le funzioni della famiglia pr_warn(). Chi amministra il sistema potrebbe aver attivato l'opzione sysctl *panic_on_warn* per essere sicuri che il sistema smetta di funzionare in caso si verifichino delle condizioni "inaspettate". (per esempio, date un'occhiata al questo `commit `_)h](hXMTenete presente che la famiglia di funzioni WARN() dovrebbe essere usato solo per situazioni che si suppone siano “impossibili”. Se volete avvisare gli utenti riguardo a qualcosa di possibile anche se indesiderato, usare le funzioni della famiglia pr_warn(). Chi amministra il sistema potrebbe aver attivato l’opzione sysctl }(hjhhhNhNubjC)}(h*panic_on_warn*h]h panic_on_warn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jBhjubh per essere sicuri che il sistema smetta di funzionare in caso si verifichino delle condizioni “inaspettate”. (per esempio, date un’occhiata al questo }(hjhhhNhNubjl)}(hQ`commit `_h]hcommit}(hjhhhNhNubah}(h]h ]h"]h$]h&]namecommitjEhttps://git.kernel.org/linus/d4689846881d160a4d12a514e991a740bcb5d65auh1jkhjubj)}(hH h]h}(h]commitah ]h"]commitah$]h&]refurijuh1jjKhjubh)}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhK6hj)hhubeh}(h] bug-e-bug-onah ]h"]bug() e bug_on()ah$]h&]uh1jhjhhhhhK&ubj)}(hhh](j)}(h3Calcoli codificati negli argomenti di un allocatoreh]h3Calcoli codificati negli argomenti di un allocatore}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhhhhhKAubh)}(hXVIl calcolo dinamico delle dimensioni (specialmente le moltiplicazioni) non dovrebbero essere fatto negli argomenti di funzioni di allocazione di memoria (o simili) per via del rischio di overflow. Questo può portare a valori più piccoli di quelli che il chiamante si aspettava. L'uso di questo modo di allocare può portare ad un overflow della memoria di heap e altri malfunzionamenti. (Si fa eccezione per valori numerici per i quali il compilatore può generare avvisi circa un potenziale overflow. Tuttavia, anche in questi casi è preferibile riscrivere il codice come suggerito di seguito).h]hXXIl calcolo dinamico delle dimensioni (specialmente le moltiplicazioni) non dovrebbero essere fatto negli argomenti di funzioni di allocazione di memoria (o simili) per via del rischio di overflow. Questo può portare a valori più piccoli di quelli che il chiamante si aspettava. L’uso di questo modo di allocare può portare ad un overflow della memoria di heap e altri malfunzionamenti. (Si fa eccezione per valori numerici per i quali il compilatore può generare avvisi circa un potenziale overflow. Tuttavia, anche in questi casi è preferibile riscrivere il codice come suggerito di seguito).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKBhjhhubh)}(h8Per esempio, non usate ``count * size`` come argomento::h](hPer esempio, non usate }(hjhhhNhNubhliteral)}(h``count * size``h]h count * size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j hjubh come argomento:}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKKhjhhubh literal_block)}(h(foo = kmalloc(count * size, GFP_KERNEL);h]h(foo = kmalloc(count * size, GFP_KERNEL);}hj)sbah}(h]h ]h"]h$]h&]hhuh1j'hhhKMhjhhubh)}(h>Al suo posto, si dovrebbe usare l'allocatore a due argomenti::h]h?Al suo posto, si dovrebbe usare l’allocatore a due argomenti:}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKOhjhhubj()}(h-foo = kmalloc_array(count, size, GFP_KERNEL);h]h-foo = kmalloc_array(count, size, GFP_KERNEL);}hjEsbah}(h]h ]h"]h$]h&]hhuh1j'hhhKQhjhhubh)}(h^Nello specifico, kmalloc() può essere sostituta da kmalloc_array(), e kzalloc() da kcalloc().h]h^Nello specifico, kmalloc() può essere sostituta da kmalloc_array(), e kzalloc() da kcalloc().}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKShjhhubh)}(h}Se questo tipo di allocatore non è disponibile, allora dovrebbero essere usate le funzioni del tipo *saturate-on-overflow*::h](heSe questo tipo di allocatore non è disponibile, allora dovrebbero essere usate le funzioni del tipo }(hjahhhNhNubjC)}(h*saturate-on-overflow*h]hsaturate-on-overflow}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jBhjaubh:}(hjahhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKVhjhhubj()}(hIbar = dma_alloc_coherent(dev, array_size(count, size), &dma, GFP_KERNEL);h]hIbar = dma_alloc_coherent(dev, array_size(count, size), &dma, GFP_KERNEL);}hjsbah}(h]h ]h"]h$]h&]hhuh1j'hhhKYhjhhubh)}(hUn altro tipico caso da evitare è quello di calcolare la dimensione di una struttura seguita da un vettore di altre strutture, come nel seguente caso::h]hUn altro tipico caso da evitare è quello di calcolare la dimensione di una struttura seguita da un vettore di altre strutture, come nel seguente caso:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK[hjhhubj()}(h_header = kzalloc(sizeof(*header) + count * sizeof(*header->item), GFP_KERNEL);h]h_header = kzalloc(sizeof(*header) + count * sizeof(*header->item), GFP_KERNEL);}hjsbah}(h]h ]h"]h$]h&]hhuh1j'hhhK^hjhhubh)}(h$Invece, usate la seguente funzione::h]h#Invece, usate la seguente funzione:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKahjhhubj()}(h?header = kzalloc(struct_size(header, item, count), GFP_KERNEL);h]h?header = kzalloc(struct_size(header, item, count), GFP_KERNEL);}hjsbah}(h]h ]h"]h$]h&]hhuh1j'hhhKchjhhubhnote)}(hSe per caso state usando struct_size() su una struttura dati che in coda contiene un array di lunghezza zero o uno, allora siete invitati a riorganizzare il vostro codice usando il `flexible array member <#zero-length-and-one-element-arrays>`_.h]h)}(hSe per caso state usando struct_size() su una struttura dati che in coda contiene un array di lunghezza zero o uno, allora siete invitati a riorganizzare il vostro codice usando il `flexible array member <#zero-length-and-one-element-arrays>`_.h](hSe per caso state usando struct_size() su una struttura dati che in coda contiene un array di lunghezza zero o uno, allora siete invitati a riorganizzare il vostro codice usando il }(hjhhhNhNubjl)}(h>`flexible array member <#zero-length-and-one-element-arrays>`_h]hflexible array member}(hjhhhNhNubah}(h]h ]h"]h$]h&]nameflexible array memberj##zero-length-and-one-element-arraysuh1jkhjubj)}(h& <#zero-length-and-one-element-arrays>h]h}(h]flexible-array-memberah ]h"]flexible array memberah$]h&]refurijuh1jjKhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKehjubah}(h]h ]h"]h$]h&]uh1jhjhhhhhNubh)}(hePer altri calcoli, usate le funzioni size_mul(), size_add(), e size_sub(). Per esempio, al posto di::h]hdPer altri calcoli, usate le funzioni size_mul(), size_add(), e size_sub(). Per esempio, al posto di:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKjhjhhubj()}(hDfoo = krealloc(current_size + chunk_size * (count - 3), GFP_KERNEL);h]hDfoo = krealloc(current_size + chunk_size * (count - 3), GFP_KERNEL);}hjsbah}(h]h ]h"]h$]h&]hhuh1j'hhhKmhjhhubh)}(hdovreste scrivere:h]hdovreste scrivere:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKohjhhubh block_quote)}(hfoo = krealloc(size_add(current_size, size_mul(chunk_size, size_sub(count, 3))), GFP_KERNEL); h]hdefinition_list)}(hhh]hdefinition_list_item)}(hgfoo = krealloc(size_add(current_size, size_mul(chunk_size, size_sub(count, 3))), GFP_KERNEL); h](hterm)}(h%foo = krealloc(size_add(current_size,h]h%foo = krealloc(size_add(current_size,}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1j>hhhKshj:ubh definition)}(hhh]j4)}(hhh]j9)}(h8size_mul(chunk_size, size_sub(count, 3))), GFP_KERNEL); h](j?)}(hsize_mul(chunk_size,h]hsize_mul(chunk_size,}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1j>hhhKshjVubjO)}(hhh]h)}(h"size_sub(count, 3))), GFP_KERNEL);h]h"size_sub(count, 3))), GFP_KERNEL);}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKshjhubah}(h]h ]h"]h$]h&]uh1jNhjVubeh}(h]h ]h"]h$]h&]uh1j8hhhKshjSubah}(h]h ]h"]h$]h&]uh1j3hjPubah}(h]h ]h"]h$]h&]uh1jNhj:ubeh}(h]h ]h"]h$]h&]uh1j8hhhKshj5ubah}(h]h ]h"]h$]h&]uh1j3hj/ubah}(h]h ]h"]h$]h&]uh1j-hhhKqhjhhubh)}(hPer maggiori dettagli fate riferimento a array3_size() e flex_array_size(), ma anche le funzioni della famiglia check_mul_overflow(), check_add_overflow(), check_sub_overflow(), e check_shl_overflow().h]hPer maggiori dettagli fate riferimento a array3_size() e flex_array_size(), ma anche le funzioni della famiglia check_mul_overflow(), check_add_overflow(), check_sub_overflow(), e check_shl_overflow().}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKuhjhhubeh}(h]3calcoli-codificati-negli-argomenti-di-un-allocatoreah ]h"]3calcoli codificati negli argomenti di un allocatoreah$]h&]uh1jhjhhhhhKAubj)}(hhh](j)}(hFsimple_strtol(), simple_strtoll(), simple_strtoul(), simple_strtoull()h]hFsimple_strtol(), simple_strtoll(), simple_strtoul(), simple_strtoull()}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhhhhhKzubh)}(hXLe funzioni simple_strtol(), simple_strtoll(), simple_strtoul(), e simple_strtoull() ignorano volutamente i possibili overflow, e questo può portare il chiamante a generare risultati inaspettati. Le rispettive funzioni kstrtol(), kstrtoll(), kstrtoul(), e kstrtoull() sono da considerarsi le corrette sostitute; tuttavia va notato che queste richiedono che la stringa sia terminata con il carattere NUL o quello di nuova riga.h]hXLe funzioni simple_strtol(), simple_strtoll(), simple_strtoul(), e simple_strtoull() ignorano volutamente i possibili overflow, e questo può portare il chiamante a generare risultati inaspettati. Le rispettive funzioni kstrtol(), kstrtoll(), kstrtoul(), e kstrtoull() sono da considerarsi le corrette sostitute; tuttavia va notato che queste richiedono che la stringa sia terminata con il carattere NUL o quello di nuova riga.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK{hjhhubeh}(h];simple-strtol-simple-strtoll-simple-strtoul-simple-strtoullah ]h"]Fsimple_strtol(), simple_strtoll(), simple_strtoul(), simple_strtoull()ah$]h&]uh1jhjhhhhhKzubj)}(hhh](j)}(hstrcpy()h]hstrcpy()}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhhhhhKubh)}(hXLa funzione strcpy() non fa controlli agli estremi del buffer di destinazione. Questo può portare ad un overflow oltre i limiti del buffer e generare svariati tipi di malfunzionamenti. Nonostante l'opzione `CONFIG_FORTIFY_SOURCE=y` e svariate opzioni del compilatore aiutano a ridurne il rischio, non c'è alcuna buona ragione per continuare ad usare questa funzione. La versione sicura da usare è strscpy(), tuttavia va prestata attenzione a tutti quei casi dove viene usato il valore di ritorno di strcpy(). La funzione strscpy() non ritorna un puntatore alla destinazione, ma un contatore dei byte non NUL copiati (oppure un errno negativo se la stringa è stata troncata).h](hLa funzione strcpy() non fa controlli agli estremi del buffer di destinazione. Questo può portare ad un overflow oltre i limiti del buffer e generare svariati tipi di malfunzionamenti. Nonostante l’opzione }(hjhhhNhNubj)}(h`CONFIG_FORTIFY_SOURCE=y`h]hCONFIG_FORTIFY_SOURCE=y}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhX e svariate opzioni del compilatore aiutano a ridurne il rischio, non c’è alcuna buona ragione per continuare ad usare questa funzione. La versione sicura da usare è strscpy(), tuttavia va prestata attenzione a tutti quei casi dove viene usato il valore di ritorno di strcpy(). La funzione strscpy() non ritorna un puntatore alla destinazione, ma un contatore dei byte non NUL copiati (oppure un errno negativo se la stringa è stata troncata).}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubeh}(h]strcpyah ]h"]strcpy()ah$]h&]uh1jhjhhhhhKubj)}(hhh](j)}(h&strncpy() su stringe terminate con NULh]h&strncpy() su stringe terminate con NUL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhhhhhKubh)}(hXgL'utilizzo di strncpy() non fornisce alcuna garanzia sul fatto che il buffer di destinazione verrà terminato con il carattere NUL. Questo potrebbe portare a diversi overflow di lettura o altri malfunzionamenti causati, appunto, dalla mancanza del terminatore. Questa estende la terminazione nel buffer di destinazione quando la stringa d'origine è più corta; questo potrebbe portare ad una penalizzazione delle prestazioni per chi usa solo stringe terminate. La versione sicura da usare è strscpy(), tuttavia va prestata attenzione a tutti quei casi dove viene usato il valore di ritorno di strncpy(). La funzione strscpy() non ritorna un puntatore alla destinazione, ma un contatore dei byte non NUL copiati (oppure un errno negativo se la stringa è stata troncata). Tutti i casi che necessitano di estendere la terminazione con NUL dovrebbero usare strscpy_pad().h]hXkL’utilizzo di strncpy() non fornisce alcuna garanzia sul fatto che il buffer di destinazione verrà terminato con il carattere NUL. Questo potrebbe portare a diversi overflow di lettura o altri malfunzionamenti causati, appunto, dalla mancanza del terminatore. Questa estende la terminazione nel buffer di destinazione quando la stringa d’origine è più corta; questo potrebbe portare ad una penalizzazione delle prestazioni per chi usa solo stringe terminate. La versione sicura da usare è strscpy(), tuttavia va prestata attenzione a tutti quei casi dove viene usato il valore di ritorno di strncpy(). La funzione strscpy() non ritorna un puntatore alla destinazione, ma un contatore dei byte non NUL copiati (oppure un errno negativo se la stringa è stata troncata). Tutti i casi che necessitano di estendere la terminazione con NUL dovrebbero usare strscpy_pad().}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hX'Se il chiamate no usa stringhe terminate con NUL, allore strncpy() può continuare ad essere usata, ma i buffer di destinazione devono essere marchiati con l'attributo `__nonstring `_ per evitare avvisi durante la compilazione.h](hSe il chiamate no usa stringhe terminate con NUL, allore strncpy() può continuare ad essere usata, ma i buffer di destinazione devono essere marchiati con l’attributo }(hj8hhhNhNubjl)}(hS`__nonstring `_h]h __nonstring}(hj@hhhNhNubah}(h]h ]h"]h$]h&]name __nonstringjBhttps://gcc.gnu.org/onlinedocs/gcc/Common-Variable-Attributes.htmluh1jkhj8ubj)}(hE h]h}(h] nonstringah ]h"] __nonstringah$]h&]refurijPuh1jjKhj8ubh, per evitare avvisi durante la compilazione.}(hj8hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubeh}(h]$strncpy-su-stringe-terminate-con-nulah ]h"]&strncpy() su stringe terminate con nulah$]h&]uh1jhjhhhhhKubj)}(hhh](j)}(h strlcpy()h]h strlcpy()}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1jhjphhhhhKubh)}(hXLa funzione strlcpy(), per prima cosa, legge interamente il buffer di origine, magari leggendo più di quanto verrà effettivamente copiato. Questo è inefficiente e può portare a overflow di lettura quando la stringa non è terminata con NUL. La versione sicura da usare è strscpy(), tuttavia va prestata attenzione a tutti quei casi dove viene usato il valore di ritorno di strlcpy(), dato che strscpy() ritorna un valore di errno negativo quanto la stringa viene troncata.h]hXLa funzione strlcpy(), per prima cosa, legge interamente il buffer di origine, magari leggendo più di quanto verrà effettivamente copiato. Questo è inefficiente e può portare a overflow di lettura quando la stringa non è terminata con NUL. La versione sicura da usare è strscpy(), tuttavia va prestata attenzione a tutti quei casi dove viene usato il valore di ritorno di strlcpy(), dato che strscpy() ritorna un valore di errno negativo quanto la stringa viene troncata.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjphhubeh}(h]strlcpyah ]h"] strlcpy()ah$]h&]uh1jhjhhhhhKubj)}(hhh](j)}(h&Segnaposto %p nella stringa di formatoh]h&Segnaposto %p nella stringa di formato}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhhhhhKubh)}(hX#Tradizionalmente, l'uso del segnaposto "%p" nella stringa di formato esponne un indirizzo di memoria in dmesg, proc, sysfs, eccetera. Per evitare che questi indirizzi vengano sfruttati da malintenzionati, tutto gli usi di "%p" nel kernel rappresentano l'hash dell'indirizzo, rendendolo di fatto inutilizzabile. Nuovi usi di "%p" non dovrebbero essere aggiunti al kernel. Per una rappresentazione testuale di un indirizzo usate "%pS", l'output è migliore perché mostrerà il nome del simbolo. Per tutto il resto, semplicemente non usate "%p".h]hX?Tradizionalmente, l’uso del segnaposto “%p” nella stringa di formato esponne un indirizzo di memoria in dmesg, proc, sysfs, eccetera. Per evitare che questi indirizzi vengano sfruttati da malintenzionati, tutto gli usi di “%p” nel kernel rappresentano l’hash dell’indirizzo, rendendolo di fatto inutilizzabile. Nuovi usi di “%p” non dovrebbero essere aggiunti al kernel. Per una rappresentazione testuale di un indirizzo usate “%pS”, l’output è migliore perché mostrerà il nome del simbolo. Per tutto il resto, semplicemente non usate “%p”.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hParafrasando la `guida `_ di Linus:h](hParafrasando la }(hjhhhNhNubjl)}(hk`guida `_h]hguida}(hjhhhNhNubah}(h]h ]h"]h$]h&]nameguidaj`https://lore.kernel.org/lkml/CA+55aFwQEd_d40g4mUCSsVRZzrFPUJt74vc6PPpb675hYNXcKw@mail.gmail.com/uh1jkhjubj)}(hc h]h}(h]guidaah ]h"]guidaah$]h&]refurijuh1jjKhjubh di Linus:}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh bullet_list)}(hhh](h list_item)}(h}Se il valore hash di "%p" è inutile, chiediti se il puntatore stesso è importante. Forse dovrebbe essere rimosso del tutto?h]h)}(h}Se il valore hash di "%p" è inutile, chiediti se il puntatore stesso è importante. Forse dovrebbe essere rimosso del tutto?h]hSe il valore hash di “%p” è inutile, chiediti se il puntatore stesso è importante. Forse dovrebbe essere rimosso del tutto?}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjhhhhhNubj)}(hXrSe credi davvero che il vero valore del puntatore sia importante, perché alcuni stati del sistema o i livelli di privilegi di un utente sono considerati "special"? Se pensi di poterlo giustificare (in un commento e nel messaggio del commit) abbastanza bene da affrontare il giudizio di Linus, allora forse potrai usare "%px", assicurandosi anche di averne il permesso. h]h)}(hXqSe credi davvero che il vero valore del puntatore sia importante, perché alcuni stati del sistema o i livelli di privilegi di un utente sono considerati "special"? Se pensi di poterlo giustificare (in un commento e nel messaggio del commit) abbastanza bene da affrontare il giudizio di Linus, allora forse potrai usare "%px", assicurandosi anche di averne il permesso.h]hXySe credi davvero che il vero valore del puntatore sia importante, perché alcuni stati del sistema o i livelli di privilegi di un utente sono considerati “special”? Se pensi di poterlo giustificare (in un commento e nel messaggio del commit) abbastanza bene da affrontare il giudizio di Linus, allora forse potrai usare “%px”, assicurandosi anche di averne il permesso.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjhhhhhNubeh}(h]h ]h"]h$]h&]bullet-uh1jhhhKhjhhubh)}(hX2Potete disabilitare temporaneamente l'hashing di "%p" nel caso in cui questa funzionalità vi sia d'ostacolo durante una sessione di debug. Per farlo aggiungete l'opzione di debug "`no_hash_pointers `_" alla riga di comando del kernel.h](hPotete disabilitare temporaneamente l’hashing di “%p” nel caso in cui questa funzionalità vi sia d’ostacolo durante una sessione di debug. Per farlo aggiungete l’opzione di debug “}(hj%hhhNhNubjl)}(h[`no_hash_pointers `_h]hno_hash_pointers}(hj-hhhNhNubah}(h]h ]h"]h$]h&]nameno_hash_pointersjEhttps://git.kernel.org/linus/5ead723a20e0447bc7db33dc3070b420e5f80aa6uh1jkhj%ubj)}(hH h]h}(h]no-hash-pointersah ]h"]no_hash_pointersah$]h&]refurij=uh1jjKhj%ubh$” alla riga di comando del kernel.}(hj%hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubeh}(h]%segnaposto-p-nella-stringa-di-formatoah ]h"]&segnaposto %p nella stringa di formatoah$]h&]uh1jhjhhhhhKubj)}(hhh](j)}(h$Vettori a dimensione variabile (VLA)h]h$Vettori a dimensione variabile (VLA)}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj]hhhhhKubh)}(hXUsare VLA sullo stack produce codice molto peggiore rispetto a quando si usano vettori a dimensione fissa. Questi `problemi di prestazioni `_, tutt'altro che banali, sono già un motivo valido per eliminare i VLA; in aggiunta sono anche un problema per la sicurezza. La crescita dinamica di un vettore nello stack potrebbe eccedere la memoria rimanente in tale segmento. Questo può portare a dei malfunzionamenti, potrebbe sovrascrivere dati importanti alla fine dello stack (quando il kernel è compilato senza `CONFIG_THREAD_INFO_IN_TASK=y`), o sovrascrivere un pezzo di memoria adiacente allo stack (quando il kernel è compilato senza `CONFIG_VMAP_STACK=y`).h](hrUsare VLA sullo stack produce codice molto peggiore rispetto a quando si usano vettori a dimensione fissa. Questi }(hjnhhhNhNubjl)}(hF`problemi di prestazioni `_h]hproblemi di prestazioni}(hjvhhhNhNubah}(h]h ]h"]h$]h&]nameproblemi di prestazionij)https://git.kernel.org/linus/02361bc77888uh1jkhjnubj)}(h, h]h}(h]problemi-di-prestazioniah ]h"]problemi di prestazioniah$]h&]refurijuh1jjKhjnubhXv, tutt’altro che banali, sono già un motivo valido per eliminare i VLA; in aggiunta sono anche un problema per la sicurezza. La crescita dinamica di un vettore nello stack potrebbe eccedere la memoria rimanente in tale segmento. Questo può portare a dei malfunzionamenti, potrebbe sovrascrivere dati importanti alla fine dello stack (quando il kernel è compilato senza }(hjnhhhNhNubj)}(h`CONFIG_THREAD_INFO_IN_TASK=y`h]hCONFIG_THREAD_INFO_IN_TASK=y}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjnubha), o sovrascrivere un pezzo di memoria adiacente allo stack (quando il kernel è compilato senza }(hjnhhhNhNubj)}(h`CONFIG_VMAP_STACK=y`h]hCONFIG_VMAP_STACK=y}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjnubh).}(hjnhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhj]hhubeh}(h]"vettori-a-dimensione-variabile-vlaah ]h"]$vettori a dimensione variabile (vla)ah$]h&]uh1jhjhhhhhKubj)}(hhh](j)}(h+Salto implicito nell'istruzione switch-caseh]h-Salto implicito nell’istruzione switch-case}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhhhhhKubh)}(hXIl linguaggio C permette ai casi di un'istruzione `switch` di saltare al prossimo caso quando l'istruzione "break" viene omessa alla fine del caso corrente. Tuttavia questo rende il codice ambiguo perché non è sempre ovvio se l'istruzione "break" viene omessa intenzionalmente o è un baco. Per esempio, osservando il seguente pezzo di codice non è chiaro se lo stato `STATE_ONE` è stato progettato apposta per eseguire anche `STATE_TWO`::h](h4Il linguaggio C permette ai casi di un’istruzione }(hjhhhNhNubj)}(h`switch`h]hswitch}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhXE di saltare al prossimo caso quando l’istruzione “break” viene omessa alla fine del caso corrente. Tuttavia questo rende il codice ambiguo perché non è sempre ovvio se l’istruzione “break” viene omessa intenzionalmente o è un baco. Per esempio, osservando il seguente pezzo di codice non è chiaro se lo stato }(hjhhhNhNubj)}(h `STATE_ONE`h]h STATE_ONE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh0 è stato progettato apposta per eseguire anche }(hjhhhNhNubj)}(h `STATE_TWO`h]h STATE_TWO}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh:}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubj()}(hswitch (value) { case STATE_ONE: do_something(); case STATE_TWO: do_other(); break; default: WARN("unknown state"); }h]hswitch (value) { case STATE_ONE: do_something(); case STATE_TWO: do_other(); break; default: WARN("unknown state"); }}hjsbah}(h]h ]h"]h$]h&]hhuh1j'hhhKhjhhubh)}(hXDato che c'è stata una lunga lista di problemi `dovuti alla mancanza dell'istruzione "break" `_, oggigiorno non permettiamo più che vi sia un "salto implicito" (*fall-through*). Per identificare un salto implicito intenzionale abbiamo adottato la pseudo parola chiave 'fallthrough' che viene espansa nell'estensione di gcc `__attribute__((fallthrough))` `Statement Attributes `_. (Quando la sintassi C17/C18 `[[fallthrough]]` sarà più comunemente supportata dai compilatori C, analizzatori statici, e dagli IDE, allora potremo usare quella sintassi per la pseudo parola chiave)h](h2Dato che c’è stata una lunga lista di problemi }(hj-hhhNhNubjl)}(ha`dovuti alla mancanza dell'istruzione "break" `_h]h2dovuti alla mancanza dell’istruzione “break”}(hj5hhhNhNubah}(h]h ]h"]h$]h&]name,dovuti alla mancanza dell'istruzione "break"j/https://cwe.mitre.org/data/definitions/484.htmluh1jkhj-ubj)}(h2 h]h}(h]*dovuti-alla-mancanza-dell-istruzione-breakah ]h"],dovuti alla mancanza dell'istruzione "break"ah$]h&]refurijEuh1jjKhj-ubhG, oggigiorno non permettiamo più che vi sia un “salto implicito” (}(hj-hhhNhNubjC)}(h*fall-through*h]h fall-through}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1jBhj-ubh). Per identificare un salto implicito intenzionale abbiamo adottato la pseudo parola chiave ‘fallthrough’ che viene espansa nell’estensione di gcc }(hj-hhhNhNubj)}(h`__attribute__((fallthrough))`h]h__attribute__((fallthrough))}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jhj-ubh }(hj-hhhNhNubjl)}(hV`Statement Attributes `_h]hStatement Attributes}(hj{hhhNhNubah}(h]h ]h"]h$]h&]nameStatement Attributesjh]h}(h]statement-attributesah ]h"]statement attributesah$]h&]refurijuh1jjKhj-ubh. (Quando la sintassi C17/C18 }(hj-hhhNhNubj)}(h`[[fallthrough]]`h]h[[fallthrough]]}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj-ubh sarà più comunemente supportata dai compilatori C, analizzatori statici, e dagli IDE, allora potremo usare quella sintassi per la pseudo parola chiave)}(hj-hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hQuando la sintassi [[fallthrough]] sarà più comunemente supportata dai compilatori, analizzatori statici, e ambienti di sviluppo IDE, allora potremo usarla anche noi.h]hQuando la sintassi [[fallthrough]] sarà più comunemente supportata dai compilatori, analizzatori statici, e ambienti di sviluppo IDE, allora potremo usarla anche noi.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hSNe consegue che tutti i blocchi switch/case devono finire in uno dei seguenti modi:h]hSNe consegue che tutti i blocchi switch/case devono finire in uno dei seguenti modi:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubj)}(hhh](j)}(h ``break;``h]h)}(hjh]j)}(hjh]hbreak;}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j hjubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1jhjhhhhhNubj)}(h`fallthrough;``h]h)}(hjh]j)}(hjh]h fallthrough;`}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1jhjhhhhhNubj)}(h ``continue;``h]h)}(hjh]j)}(hjh]h continue;}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j hjubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1jhjhhhhhNubj)}(h``goto