€•Œsphinx.addnodes”Œdocument”“”)”}”(Œ rawsource”Œ”Œchildren”]”(Œtranslations”Œ LanguagesNode”“”)”}”(hhh]”(hŒpending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒEnglish”…””}”Œparent”hsbaŒ attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ refdomain”Œstd”Œreftype”Œdoc”Œ reftarget”Œ/process/coding-style”Œmodname”NŒ classname”NŒrefexplicit”ˆuŒtagname”hhhubh)”}”(hhh]”hŒChinese (Simplified)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ(/translations/zh_CN/process/coding-style”Œmodname”NŒ classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ(/translations/zh_TW/process/coding-style”Œmodname”NŒ classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ(/translations/ja_JP/process/coding-style”Œmodname”NŒ classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ(/translations/ko_KR/process/coding-style”Œmodname”NŒ classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒSpanish”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ(/translations/sp_SP/process/coding-style”Œmodname”NŒ classname”NŒrefexplicit”ˆuh1hhhubeh}”(h]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒItalian”uh1h hhŒ _document”hŒsource”NŒline”NubhŒwarning”“”)”}”(hŒ×In 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”“”)”}”(hŒ×In 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Œ·In caso di dubbi sulla correttezza del contenuto di questa traduzione, lâ€™unico riferimento valido Ã¨ la documentazione ufficiale in inglese. Per maggiori informazioni consultate le ”…””}”(hh©hžhhŸNh Nubh)”}”(hŒ!:ref:`avvertenze `”h]”hŒinline”“”)”}”(hh³h]”hŒ avvertenze”…””}”(hh·hžhhŸNh Nubah}”(h]”h ]”(Œxref”Œstd”Œstd-ref”eh"]”h$]”h&]”uh1hµhh±ubah}”(h]”h ]”h"]”h$]”h&]”Œrefdoc”Œ'translations/it_IT/process/coding-style”Œ refdomain”hÂŒreftype”Œref”Œrefexplicit”ˆŒrefwarn”ˆŒ reftarget”Œ it_disclaimer”uh1hhŸŒ3Documentation/translations/it_IT/disclaimer-ita.rst”h Khh©ubhŒ.”…””}”(hh©hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhÖh Khh£ubah}”(h]”h ]”h"]”h$]”h&]”uh1h¡hhhžhhŸhÖh NubhŒ field_list”“”)”}”(hhh]”(hŒfield”“”)”}”(hhh]”(hŒ field_name”“”)”}”(hŒOriginal”h]”hŒOriginal”…””}”(hhóhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hñhhîhŸŒU/var/lib/git/docbuild/linux/Documentation/translations/it_IT/process/coding-style.rst”h KubhŒ field_body”“”)”}”(hŒ;:ref:`Documentation/process/coding-style.rst `”h]”h¨)”}”(hjh]”h)”}”(hjh]”h¶)”}”(hjh]”hŒ&Documentation/process/coding-style.rst”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”(hÁŒstd”Œstd-ref”eh"]”h$]”h&]”uh1hµhjubah}”(h]”h ]”h"]”h$]”h&]”Œrefdoc”hÎŒ refdomain”jŒreftype”Œref”Œrefexplicit”ˆŒrefwarn”ˆhÔŒcodingstyle”uh1hhŸjh Khjubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh Khjubah}”(h]”h ]”h"]”h$]”h&]”uh1jhhîubeh}”(h]”h ]”h"]”h$]”h&]”uh1hìhŸjh Khhéhžhubhí)”}”(hhh]”(hò)”}”(hŒ Translator”h]”hŒ Translator”…””}”(hj?hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hñhj<hŸjh Kubj)”}”(hŒ)Federico Vaga ”h]”h¨)”}”(hŒ(Federico Vaga ”h]”(hŒFederico Vaga <”…””}”(hjQhžhhŸNh NubhŒ reference”“”)”}”(hŒfederico.vaga@vaga.pv.it”h]”hŒfederico.vaga@vaga.pv.it”…””}”(hj[hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œmailto:federico.vaga@vaga.pv.it”uh1jYhjQubhŒ>”…””}”(hjQhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh KhjMubah}”(h]”h ]”h"]”h$]”h&]”uh1jhj<ubeh}”(h]”h ]”h"]”h$]”h&]”uh1hìhŸjh Khhéhžhubeh}”(h]”h ]”h"]”h$]”h&]”uh1hçhhhžhhŸjh KubhŒtarget”“”)”}”(hŒ.. _it_codingstyle:”h]”h}”(h]”h ]”h"]”h$]”h&]”Œrefid”Œit-codingstyle”uh1j‡h KhhhžhhŸjubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒ$Stile del codice per il kernel Linux”h]”hŒ$Stile del codice per il kernel Linux”…””}”(hjœhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jšhj—hžhhŸjh K ubh¨)”}”(hX–Questo Ã¨ un breve documento che descrive lo stile di codice preferito per il kernel Linux. Lo stile di codifica Ã¨ molto personale e non voglio **forzare** nessuno ad accettare il mio, ma questo stile Ã¨ quello che dev'essere usato per qualsiasi cosa che io sia in grado di mantenere, e l'ho preferito anche per molte altre cose. Per favore, almeno tenete in considerazione le osservazioni espresse qui.”h]”(hŒ’Questo Ã¨ un breve documento che descrive lo stile di codice preferito per il kernel Linux. Lo stile di codifica Ã¨ molto personale e non voglio ”…””}”(hjªhžhhŸNh NubhŒstrong”“”)”}”(hŒ**forzare**”h]”hŒforzare”…””}”(hj´hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j²hjªubhŒý nessuno ad accettare il mio, ma questo stile Ã¨ quello che devâ€™essere usato per qualsiasi cosa che io sia in grado di mantenere, e lâ€™ho preferito anche per molte altre cose. Per favore, almeno tenete in considerazione le osservazioni espresse qui.”…””}”(hjªhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh Khj—hžhubh¨)”}”(hŒšLa prima cosa che suggerisco Ã¨ quella di stamparsi una copia degli standard di codifica GNU e di NON leggerla. Bruciatela, Ã¨ un grande gesto simbolico.”h]”hŒšLa prima cosa che suggerisco Ã¨ quella di stamparsi una copia degli standard di codifica GNU e di NON leggerla. Bruciatela, Ã¨ un grande gesto simbolico.”…””}”(hjÌhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh Khj—hžhubh¨)”}”(hŒComunque, ecco i punti:”h]”hŒComunque, ecco i punti:”…””}”(hjÚhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh Khj—hžhubj–)”}”(hhh]”(j›)”}”(hŒ1) Indentazione”h]”hŒ1) Indentazione”…””}”(hjëhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jšhjèhžhhŸjh Kubh¨)”}”(hŒ÷La tabulazione (tab) Ã¨ di 8 caratteri e cosÃ¬ anche le indentazioni. Ci sono alcuni movimenti di eretici che vorrebbero l'indentazione a 4 (o perfino 2!) caratteri di profonditÃ , che Ã¨ simile al tentativo di definire il valore del pi-greco a 3.”h]”hŒùLa tabulazione (tab) Ã¨ di 8 caratteri e cosÃ¬ anche le indentazioni. Ci sono alcuni movimenti di eretici che vorrebbero lâ€™indentazione a 4 (o perfino 2!) caratteri di profonditÃ , che Ã¨ simile al tentativo di definire il valore del pi-greco a 3.”…””}”(hjùhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh Khjèhžhubh¨)”}”(hXMotivazione: l'idea dell'indentazione Ã¨ di definire chiaramente dove un blocco di controllo inizia e finisce. Specialmente quando siete rimasti a guardare lo schermo per 20 ore a file, troverete molto piÃ¹ facile capire i livelli di indentazione se questi sono larghi.”h]”hXMotivazione: lâ€™idea dellâ€™indentazione Ã¨ di definire chiaramente dove un blocco di controllo inizia e finisce. Specialmente quando siete rimasti a guardare lo schermo per 20 ore a file, troverete molto piÃ¹ facile capire i livelli di indentazione se questi sono larghi.”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh Khjèhžhubh¨)”}”(hX;Ora, alcuni rivendicano che un'indentazione da 8 caratteri sposta il codice troppo a destra e che quindi rende difficile la lettura su schermi a 80 caratteri. La risposta a questa affermazione Ã¨ che se vi servono piÃ¹ di 3 livelli di indentazione, siete comunque fregati e dovreste correggere il vostro programma.”h]”hX=Ora, alcuni rivendicano che unâ€™indentazione da 8 caratteri sposta il codice troppo a destra e che quindi rende difficile la lettura su schermi a 80 caratteri. La risposta a questa affermazione Ã¨ che se vi servono piÃ¹ di 3 livelli di indentazione, siete comunque fregati e dovreste correggere il vostro programma.”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh K$hjèhžhubh¨)”}”(hŒ±In breve, l'indentazione ad 8 caratteri rende piÃ¹ facile la lettura, e in aggiunta vi avvisa quando state annidando troppo le vostre funzioni. Tenete ben a mente questo avviso.”h]”hŒ³In breve, lâ€™indentazione ad 8 caratteri rende piÃ¹ facile la lettura, e in aggiunta vi avvisa quando state annidando troppo le vostre funzioni. Tenete ben a mente questo avviso.”…””}”(hj#hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh K*hjèhžhubh¨)”}”(hŒðAl fine di facilitare l'indentazione del costrutto switch, si preferisce allineare sulla stessa colonna la parola chiave ``switch`` e i suoi subordinati ``case``. In questo modo si evita una doppia indentazione per i ``case``. Un esempio.:”h]”(hŒ{Al fine di facilitare lâ€™indentazione del costrutto switch, si preferisce allineare sulla stessa colonna la parola chiave ”…””}”(hj1hžhhŸNh NubhŒliteral”“”)”}”(hŒ ``switch``”h]”hŒswitch”…””}”(hj;hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hj1ubhŒ e i suoi subordinati ”…””}”(hj1hžhhŸNh Nubj:)”}”(hŒ``case``”h]”hŒcase”…””}”(hjMhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hj1ubhŒ8. In questo modo si evita una doppia indentazione per i ”…””}”(hj1hžhhŸNh Nubj:)”}”(hŒ``case``”h]”hŒcase”…””}”(hj_hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hj1ubhŒ. Un esempio.:”…””}”(hj1hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh K.hjèhžhubhŒ literal_block”“”)”}”(hŒÖswitch (suffix) { case 'G': case 'g': mem <<= 30; break; case 'M': case 'm': mem <<= 20; break; case 'K': case 'k': mem <<= 10; fallthrough; default: break; }”h]”hŒÖswitch (suffix) { case 'G': case 'g': mem <<= 30; break; case 'M': case 'm': mem <<= 20; break; case 'K': case 'k': mem <<= 10; fallthrough; default: break; }”…””}”hjysbah}”(h]”h ]”h"]”h$]”h&]”Œ xml:space”Œpreserve”Œforce”‰Œlanguage”Œc”Œhighlight_args”}”uh1jwhŸjh K3hjèhžhubh¨)”}”(hŒ[A meno che non vogliate nascondere qualcosa, non mettete piÃ¹ istruzioni sulla stessa riga:”h]”hŒ[A meno che non vogliate nascondere qualcosa, non mettete piÃ¹ istruzioni sulla stessa riga:”…””}”(hjŽhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh KFhjèhžhubjx)”}”(hŒ1if (condition) do_this; do_something_everytime;”h]”hŒ1if (condition) do_this; do_something_everytime;”…””}”hjœsbah}”(h]”h ]”h"]”h$]”h&]”j‡jˆj‰‰jŠj‹jŒ}”uh1jwhŸjh KIhjèhžhubh¨)”}”(hŒ.Non usate le virgole per evitare le parentesi:”h]”hŒ.Non usate le virgole per evitare le parentesi:”…””}”(hj«hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh KNhjèhžhubjx)”}”(hŒ+if (condition) do_this(), do_that();”h]”hŒ+if (condition) do_this(), do_that();”…””}”hj¹sbah}”(h]”h ]”h"]”h$]”h&]”j‡jˆj‰‰jŠj‹jŒ}”uh1jwhŸjh KPhjèhžhubh¨)”}”(hŒBInvece, usate sempre le parentesi per racchiudere piÃ¹ istruzioni.”h]”hŒBInvece, usate sempre le parentesi per racchiudere piÃ¹ istruzioni.”…””}”(hjÈhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh KUhjèhžhubjx)”}”(hŒ9 if (condition) { do_this(); do_that(); }”h]”hŒ9 if (condition) { do_this(); do_that(); }”…””}”hjÖsbah}”(h]”h ]”h"]”h$]”h&]”j‡jˆj‰‰jŠj‹jŒ}”uh1jwhŸjh KWhjèhžhubh¨)”}”(hŒNon mettete nemmeno piÃ¹ assegnamenti sulla stessa riga. Lo stile del kernel Ã¨ ultrasemplice. Evitate espressioni intricate.”h]”hŒNon mettete nemmeno piÃ¹ assegnamenti sulla stessa riga. Lo stile del kernel Ã¨ ultrasemplice. Evitate espressioni intricate.”…””}”(hjåhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh K^hjèhžhubh¨)”}”(hŒ¨Al di fuori dei commenti, della documentazione ed escludendo i Kconfig, gli spazi non vengono mai usati per l'indentazione, e l'esempio qui sopra Ã¨ volutamente errato.”h]”hŒ¬Al di fuori dei commenti, della documentazione ed escludendo i Kconfig, gli spazi non vengono mai usati per lâ€™indentazione, e lâ€™esempio qui sopra Ã¨ volutamente errato.”…””}”(hjóhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh Kbhjèhžhubh¨)”}”(hŒWProcuratevi un buon editor di testo e non lasciate spazi bianchi alla fine delle righe.”h]”hŒWProcuratevi un buon editor di testo e non lasciate spazi bianchi alla fine delle righe.”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh Kfhjèhžhubeh}”(h]”Œindentazione”ah ]”h"]”Œ1) indentazione”ah$]”h&]”uh1j•hj—hžhhŸjh Kubj–)”}”(hhh]”(j›)”}”(hŒ#2) Spezzare righe lunghe e stringhe”h]”hŒ#2) Spezzare righe lunghe e stringhe”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jšhjhžhhŸjh Kkubh¨)”}”(hŒ_Lo stile del codice riguarda la leggibilitÃ e la manutenibilitÃ utilizzando strumenti comuni.”h]”hŒ_Lo stile del codice riguarda la leggibilitÃ e la manutenibilitÃ utilizzando strumenti comuni.”…””}”(hj(hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh Kmhjhžhubh¨)”}”(hŒ2Come limite di riga si preferiscono le 80 colonne.”h]”hŒ2Come limite di riga si preferiscono le 80 colonne.”…””}”(hj6hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh Kphjhžhubh¨)”}”(hŒÂEspressioni piÃ¹ lunghe di 80 colonne dovrebbero essere spezzettate in pezzi piÃ¹ piccoli, a meno che eccedere le 80 colonne non aiuti ad aumentare la leggibilitÃ senza nascondere informazioni.”h]”hŒÂEspressioni piÃ¹ lunghe di 80 colonne dovrebbero essere spezzettate in pezzi piÃ¹ piccoli, a meno che eccedere le 80 colonne non aiuti ad aumentare la leggibilitÃ senza nascondere informazioni.”…””}”(hjDhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh Krhjhžhubh¨)”}”(hŒÎI nuovi pezzi derivati sono sostanzialmente piÃ¹ corti degli originali e vengono posizionati piÃ¹ a destra. Uno stile molto comune Ã¨ quello di allineare i nuovi pezzi alla parentesi aperta di una funzione.”h]”hŒÎI nuovi pezzi derivati sono sostanzialmente piÃ¹ corti degli originali e vengono posizionati piÃ¹ a destra. Uno stile molto comune Ã¨ quello di allineare i nuovi pezzi alla parentesi aperta di una funzione.”…””}”(hjRhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh Kvhjhžhubh¨)”}”(hŒdLo stesso si applica, nei file d'intestazione, alle funzioni con una lista di argomenti molto lunga.”h]”hŒfLo stesso si applica, nei file dâ€™intestazione, alle funzioni con una lista di argomenti molto lunga.”…””}”(hj`hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh Kzhjhžhubh¨)”}”(hŒ£Tuttavia, non spezzettate mai le stringhe visibili agli utenti come i messaggi di printk, questo perchÃ© inibireste la possibilitÃ d'utilizzare grep per cercarle.”h]”hŒ¥Tuttavia, non spezzettate mai le stringhe visibili agli utenti come i messaggi di printk, questo perchÃ© inibireste la possibilitÃ dâ€™utilizzare grep per cercarle.”…””}”(hjnhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh K}hjhžhubeh}”(h]”Œ spezzare-righe-lunghe-e-stringhe”ah ]”h"]”Œ#2) spezzare righe lunghe e stringhe”ah$]”h&]”uh1j•hj—hžhhŸjh Kkubj–)”}”(hhh]”(j›)”}”(hŒ-3) Posizionamento di parentesi graffe e spazi”h]”hŒ-3) Posizionamento di parentesi graffe e spazi”…””}”(hj‡hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jšhj„hžhhŸjh K‚ubh¨)”}”(hXÞUn altro problema che s'affronta sempre quando si parla di stile in C Ã¨ il posizionamento delle parentesi graffe. Al contrario della dimensione dell'indentazione, non ci sono motivi tecnici sulla base dei quali scegliere una strategia di posizionamento o un'altra; ma il modo qui preferito, come mostratoci dai profeti Kernighan e Ritchie, Ã¨ quello di posizionare la parentesi graffa di apertura per ultima sulla riga, e quella di chiusura per prima su una nuova riga, cosÃ¬:”h]”hXäUn altro problema che sâ€™affronta sempre quando si parla di stile in C Ã¨ il posizionamento delle parentesi graffe. Al contrario della dimensione dellâ€™indentazione, non ci sono motivi tecnici sulla base dei quali scegliere una strategia di posizionamento o unâ€™altra; ma il modo qui preferito, come mostratoci dai profeti Kernighan e Ritchie, Ã¨ quello di posizionare la parentesi graffa di apertura per ultima sulla riga, e quella di chiusura per prima su una nuova riga, cosÃ¬:”…””}”(hj•hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh K„hj„hžhubjx)”}”(hŒ"if (x is true) { we do y }”h]”hŒ"if (x is true) { we do y }”…””}”hj£sbah}”(h]”h ]”h"]”h$]”h&]”j‡jˆj‰‰jŠj‹jŒ}”uh1jwhŸjh KŒhj„hžhubh¨)”}”(hŒlQuesto Ã¨ valido per tutte le espressioni che non siano funzioni (if, switch, for, while, do). Per esempio:”h]”hŒlQuesto Ã¨ valido per tutte le espressioni che non siano funzioni (if, switch, for, while, do). Per esempio:”…””}”(hj²hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh K’hj„hžhubjx)”}”(hŒ¬switch (action) { case KOBJ_ADD: return "add"; case KOBJ_REMOVE: return "remove"; case KOBJ_CHANGE: return "change"; default: return NULL; }”h]”hŒ¬switch (action) { case KOBJ_ADD: return "add"; case KOBJ_REMOVE: return "remove"; case KOBJ_CHANGE: return "change"; default: return NULL; }”…””}”hjÀsbah}”(h]”h ]”h"]”h$]”h&]”j‡jˆj‰‰jŠj‹jŒ}”uh1jwhŸjh K•hj„hžhubh¨)”}”(hŒ„Tuttavia, c'Ã¨ il caso speciale, le funzioni: queste hanno la parentesi graffa di apertura all'inizio della riga successiva, quindi:”h]”hŒˆTuttavia, câ€™Ã¨ il caso speciale, le funzioni: queste hanno la parentesi graffa di apertura allâ€™inizio della riga successiva, quindi:”…””}”(hjÏhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh K¢hj„hžhubjx)”}”(hŒ0int function(int x) { body of function }”h]”hŒ0int function(int x) { body of function }”…””}”hjÝsbah}”(h]”h ]”h"]”h$]”h&]”j‡jˆj‰‰jŠj‹jŒ}”uh1jwhŸjh K¥hj„hžhubh¨)”}”(hXEretici da tutto il mondo affermano che questa incoerenza Ã¨ ... insomma ... incoerente, ma tutte le persone ragionevoli sanno che (a) K&R hanno **ragione** e (b) K&R hanno ragione. A parte questo, le funzioni sono comunque speciali (non potete annidarle in C).”h]”(hŒ‘Eretici da tutto il mondo affermano che questa incoerenza Ã¨ ... insomma ... incoerente, ma tutte le persone ragionevoli sanno che (a) K&R hanno ”…””}”(hjìhžhhŸNh Nubj³)”}”(hŒ**ragione**”h]”hŒragione”…””}”(hjôhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j²hjìubhŒj e (b) K&R hanno ragione. A parte questo, le funzioni sono comunque speciali (non potete annidarle in C).”…””}”(hjìhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh K¬hj„hžhubh¨)”}”(hXNotate che la graffa di chiusura Ã¨ da sola su una riga propria, ad **eccezione** di quei casi dove Ã¨ seguita dalla continuazione della stessa espressione, in pratica ``while`` nell'espressione do-while, oppure ``else`` nell'espressione if-else, come questo:”h]”(hŒDNotate che la graffa di chiusura Ã¨ da sola su una riga propria, ad ”…””}”(hjhžhhŸNh Nubj³)”}”(hŒ **eccezione**”h]”hŒ eccezione”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j²hjubhŒW di quei casi dove Ã¨ seguita dalla continuazione della stessa espressione, in pratica ”…””}”(hjhžhhŸNh Nubj:)”}”(hŒ ``while``”h]”hŒwhile”…””}”(hj&hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hjubhŒ% nellâ€™espressione do-while, oppure ”…””}”(hjhžhhŸNh Nubj:)”}”(hŒ``else``”h]”hŒelse”…””}”(hj8hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hjubhŒ) nellâ€™espressione if-else, come questo:”…””}”(hjhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh K±hj„hžhubjx)”}”(hŒ1do { body of do-loop } while (condition);”h]”hŒ1do { body of do-loop } while (condition);”…””}”hjPsbah}”(h]”h ]”h"]”h$]”h&]”j‡jˆj‰‰jŠj‹jŒ}”uh1jwhŸjh K¶hj„hžhubh¨)”}”(hŒe”h]”hŒe”…””}”(hj_hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh K¼hj„hžhubjx)”}”(hŒPif (x == y) { .. } else if (x > y) { ... } else { .... }”h]”hŒPif (x == y) { .. } else if (x > y) { ... } else { .... }”…””}”hjmsbah}”(h]”h ]”h"]”h$]”h&]”j‡jˆj‰‰jŠj‹jŒ}”uh1jwhŸjh K¾hj„hžhubh¨)”}”(hŒMotivazione: K&R.”h]”hŒMotivazione: K&R.”…””}”(hj|hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh KÈhj„hžhubh¨)”}”(hX.Inoltre, notate che questo posizionamento delle graffe minimizza il numero di righe vuote senza perdere di leggibilitÃ . In questo modo, dato che le righe sul vostro schermo non sono una risorsa illimitata (pensate ad uno terminale con 25 righe), avrete delle righe vuote da riempire con dei commenti.”h]”hX.Inoltre, notate che questo posizionamento delle graffe minimizza il numero di righe vuote senza perdere di leggibilitÃ . In questo modo, dato che le righe sul vostro schermo non sono una risorsa illimitata (pensate ad uno terminale con 25 righe), avrete delle righe vuote da riempire con dei commenti.”…””}”(hjŠhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh KÊhj„hžhubh¨)”}”(hŒLNon usate inutilmente le graffe dove una singola espressione Ã¨ sufficiente.”h]”hŒLNon usate inutilmente le graffe dove una singola espressione Ã¨ sufficiente.”…””}”(hj˜hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh KÐhj„hžhubjx)”}”(hŒ if (condition) action();”h]”hŒ if (condition) action();”…””}”hj¦sbah}”(h]”h ]”h"]”h$]”h&]”j‡jˆj‰‰jŠj‹jŒ}”uh1jwhŸjh KÒhj„hžhubh¨)”}”(hjah]”hŒe”…””}”(hjµhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh K×hj„hžhubjx)”}”(hŒ9if (condition) do_this(); else do_that();”h]”hŒ9if (condition) do_this(); else do_that();”…””}”hjÂsbah}”(h]”h ]”h"]”h$]”h&]”j‡jˆj‰‰jŠj‹jŒ}”uh1jwhŸjh KÙhj„hžhubh¨)”}”(hŒžQuesto non vale nel caso in cui solo un ramo dell'espressione if-else contiene una sola espressione; in quest'ultimo caso usate le graffe per entrambe i rami:”h]”hŒ¢Questo non vale nel caso in cui solo un ramo dellâ€™espressione if-else contiene una sola espressione; in questâ€™ultimo caso usate le graffe per entrambe i rami:”…””}”(hjÑhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh Kàhj„hžhubjx)”}”(hŒVif (condition) { do_this(); do_that(); } else { otherwise(); }”h]”hŒVif (condition) { do_this(); do_that(); } else { otherwise(); }”…””}”hjßsbah}”(h]”h ]”h"]”h$]”h&]”j‡jˆj‰‰jŠj‹jŒ}”uh1jwhŸjh Kähj„hžhubh¨)”}”(hŒNInoltre, usate le graffe se un ciclo contiene piÃ¹ di una semplice istruzione:”h]”hŒNInoltre, usate le graffe se un ciclo contiene piÃ¹ di una semplice istruzione:”…””}”(hjîhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh Kíhj„hžhubjx)”}”(hŒGwhile (condition) { if (test) do_something(); }”h]”hŒGwhile (condition) { if (test) do_something(); }”…””}”hjüsbah}”(h]”h ]”h"]”h$]”h&]”j‡jˆj‰‰jŠj‹jŒ}”uh1jwhŸjh Kïhj„hžhubj–)”}”(hhh]”(j›)”}”(hŒ 3.1) Spazi”h]”hŒ 3.1) Spazi”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jšhjhžhhŸjh K÷ubh¨)”}”(hXÓLo stile del kernel Linux per quanto riguarda gli spazi, dipende (principalmente) dalle funzioni e dalle parole chiave. Usate una spazio dopo (quasi tutte) le parole chiave. L'eccezioni piÃ¹ evidenti sono sizeof, typeof, alignof, e __attribute__, il cui aspetto Ã¨ molto simile a quello delle funzioni (e in Linux, solitamente, sono usate con le parentesi, anche se il linguaggio non lo richiede; come ``sizeof info`` dopo aver dichiarato ``struct fileinfo info``).”h]”(hX–Lo stile del kernel Linux per quanto riguarda gli spazi, dipende (principalmente) dalle funzioni e dalle parole chiave. Usate una spazio dopo (quasi tutte) le parole chiave. Lâ€™eccezioni piÃ¹ evidenti sono sizeof, typeof, alignof, e __attribute__, il cui aspetto Ã¨ molto simile a quello delle funzioni (e in Linux, solitamente, sono usate con le parentesi, anche se il linguaggio non lo richiede; come ”…””}”(hjhžhhŸNh Nubj:)”}”(hŒ``sizeof info``”h]”hŒsizeof info”…””}”(hj$hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hjubhŒ dopo aver dichiarato ”…””}”(hjhžhhŸNh Nubj:)”}”(hŒ``struct fileinfo info``”h]”hŒstruct fileinfo info”…””}”(hj6hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hjubhŒ).”…””}”(hjhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh Kùhjhžhubh¨)”}”(hŒ=Quindi utilizzate uno spazio dopo le seguenti parole chiave::”h]”hŒ * / % | & ^ <= >= == != ? :”h]”hŒ5= + - < > * / % | & ^ <= >= == != ? :”…””}”hjósbah}”(h]”h ]”h"]”h$]”h&]”j‡jˆuh1jwhŸjh M"hjhžhubh¨)”}”(hŒ/ma non mettete spazi dopo gli operatori unari::”h]”hŒ.ma non mettete spazi dopo gli operatori unari:”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh M$hjhžhubjx)”}”(hŒA& * + - ~ ! sizeof typeof alignof __attribute__ defined”h]”hŒA& * + - ~ ! sizeof typeof alignof __attribute__ defined”…””}”hjsbah}”(h]”h ]”h"]”h$]”h&]”j‡jˆuh1jwhŸjh M&hjhžhubh¨)”}”(hŒLnessuno spazio dopo l'operatore unario suffisso di incremento o decremento::”h]”hŒMnessuno spazio dopo lâ€™operatore unario suffisso di incremento o decremento:”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh M(hjhžhubjx)”}”(hŒ++ --”h]”hŒ++ --”…””}”hj+sbah}”(h]”h ]”h"]”h$]”h&]”j‡jˆuh1jwhŸjh M*hjhžhubh¨)”}”(hŒLnessuno spazio dopo l'operatore unario prefisso di incremento o decremento::”h]”hŒMnessuno spazio dopo lâ€™operatore unario prefisso di incremento o decremento:”…””}”(hj9hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh M,hjhžhubjx)”}”(hŒ++ --”h]”hŒ++ --”…””}”hjGsbah}”(h]”h ]”h"]”h$]”h&]”j‡jˆuh1jwhŸjh M.hjhžhubh¨)”}”(hŒSe nessuno spazio attorno agli operatori dei membri di una struttura ``.`` e ``->``.”h]”(hŒDe nessuno spazio attorno agli operatori dei membri di una struttura ”…””}”(hjUhžhhŸNh Nubj:)”}”(hŒ``.``”h]”hŒ.”…””}”(hj]hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hjUubhŒ e ”…””}”(hjUhžhhŸNh Nubj:)”}”(hŒ``->``”h]”hŒ->”…””}”(hjohžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hjUubhŒ.”…””}”(hjUhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh M0hjhžhubh¨)”}”(hXøNon lasciate spazi bianchi alla fine delle righe. Alcuni editor con l'indentazione ``furba`` inseriranno gli spazi bianchi all'inizio di una nuova riga in modo appropriato, quindi potrete scrivere la riga di codice successiva immediatamente. Tuttavia, alcuni di questi stessi editor non rimuovono questi spazi bianchi quando non scrivete nulla sulla nuova riga, ad esempio perchÃ© volete lasciare una riga vuota. Il risultato Ã¨ che finirete per avere delle righe che contengono spazi bianchi in coda.”h]”(hŒVNon lasciate spazi bianchi alla fine delle righe. Alcuni editor con lâ€™indentazione ”…””}”(hj‡hžhhŸNh Nubj:)”}”(hŒ ``furba``”h]”hŒfurba”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hj‡ubhX inseriranno gli spazi bianchi allâ€™inizio di una nuova riga in modo appropriato, quindi potrete scrivere la riga di codice successiva immediatamente. Tuttavia, alcuni di questi stessi editor non rimuovono questi spazi bianchi quando non scrivete nulla sulla nuova riga, ad esempio perchÃ© volete lasciare una riga vuota. Il risultato Ã¨ che finirete per avere delle righe che contengono spazi bianchi in coda.”…””}”(hj‡hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh M3hjhžhubh¨)”}”(hX Git vi avviserÃ delle modifiche che aggiungono questi spazi vuoti di fine riga, e puÃ² opzionalmente rimuoverli per conto vostro; tuttavia, se state applicando una serie di modifiche, questo potrebbe far fallire delle modifiche successive perchÃ© il contesto delle righe verrÃ cambiato.”h]”hX Git vi avviserÃ delle modifiche che aggiungono questi spazi vuoti di fine riga, e puÃ² opzionalmente rimuoverli per conto vostro; tuttavia, se state applicando una serie di modifiche, questo potrebbe far fallire delle modifiche successive perchÃ© il contesto delle righe verrÃ cambiato.”…””}”(hj§hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh M;hjhžhubeh}”(h]”Œspazi”ah ]”h"]”Œ 3.1) spazi”ah$]”h&]”uh1j•hj„hžhhŸjh K÷ubeh}”(h]”Œ*posizionamento-di-parentesi-graffe-e-spazi”ah ]”h"]”Œ-3) posizionamento di parentesi graffe e spazi”ah$]”h&]”uh1j•hj—hžhhŸjh K‚ubj–)”}”(hhh]”(j›)”}”(hŒ4) Assegnare nomi”h]”hŒ4) Assegnare nomi”…””}”(hjÈhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jšhjÅhžhhŸjh MAubh¨)”}”(hXUC Ã¨ un linguaggio spartano, e cosÃ¬ dovrebbero esserlo i vostri nomi. Al contrario dei programmatori Modula-2 o Pascal, i programmatori C non usano nomi graziosi come ThisVariableIsATemporaryCounter. Un programmatore C chiamerebbe questa variabile ``tmp``, che Ã¨ molto piÃ¹ facile da scrivere e non Ã¨ una delle piÃ¹ difficili da capire.”h]”(hŒûC Ã¨ un linguaggio spartano, e cosÃ¬ dovrebbero esserlo i vostri nomi. Al contrario dei programmatori Modula-2 o Pascal, i programmatori C non usano nomi graziosi come ThisVariableIsATemporaryCounter. Un programmatore C chiamerebbe questa variabile ”…””}”(hjÖhžhhŸNh Nubj:)”}”(hŒ``tmp``”h]”hŒtmp”…””}”(hjÞhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hjÖubhŒS, che Ã¨ molto piÃ¹ facile da scrivere e non Ã¨ una delle piÃ¹ difficili da capire.”…””}”(hjÖhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh MChjÅhžhubh¨)”}”(hŒµTUTTAVIA, nonostante i nomi con notazione mista siano da condannare, i nomi descrittivi per variabili globali sono un dovere. Chiamare una funzione globale ``pippo`` Ã¨ un insulto.”h]”(hŒTUTTAVIA, nonostante i nomi con notazione mista siano da condannare, i nomi descrittivi per variabili globali sono un dovere. Chiamare una funzione globale ”…””}”(hjöhžhhŸNh Nubj:)”}”(hŒ ``pippo``”h]”hŒpippo”…””}”(hjþhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hjöubhŒ Ã¨ un insulto.”…””}”(hjöhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh MIhjÅhžhubh¨)”}”(hX Le variabili GLOBALI (da usare solo se vi servono **davvero**) devono avere dei nomi descrittivi, cosÃ¬ come le funzioni globali. Se avete una funzione che conta gli utenti attivi, dovreste chiamarla ``count_active_users()`` o qualcosa di simile, **non** dovreste chiamarla ``cntusr()``.”h]”(hŒ2Le variabili GLOBALI (da usare solo se vi servono ”…””}”(hjhžhhŸNh Nubj³)”}”(hŒ**davvero**”h]”hŒdavvero”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j²hjubhŒŒ) devono avere dei nomi descrittivi, cosÃ¬ come le funzioni globali. Se avete una funzione che conta gli utenti attivi, dovreste chiamarla ”…””}”(hjhžhhŸNh Nubj:)”}”(hŒ``count_active_users()``”h]”hŒcount_active_users()”…””}”(hj0hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hjubhŒ o qualcosa di simile, ”…””}”(hjhžhhŸNh Nubj³)”}”(hŒ**non**”h]”hŒnon”…””}”(hjBhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j²hjubhŒ dovreste chiamarla ”…””}”(hjhžhhŸNh Nubj:)”}”(hŒ``cntusr()``”h]”hŒcntusr()”…””}”(hjThžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hjubhŒ.”…””}”(hjhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh MMhjÅhžhubh¨)”}”(hŒÃCodificare il tipo di funzione nel suo nome (quella cosa chiamata notazione ungherese) Ã¨ stupido - il compilatore conosce comunque il tipo e puÃ² verificarli, e inoltre confonde i programmatori.”h]”hŒÃCodificare il tipo di funzione nel suo nome (quella cosa chiamata notazione ungherese) Ã¨ stupido - il compilatore conosce comunque il tipo e puÃ² verificarli, e inoltre confonde i programmatori.”…””}”(hjlhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh MRhjÅhžhubh¨)”}”(hXlLe variabili LOCALI dovrebbero avere nomi corti, e significativi. Se avete un qualsiasi contatore di ciclo, probabilmente sarÃ chiamato ``i``. Chiamarlo ``loop_counter`` non Ã¨ produttivo, non ci sono possibilitÃ che ``i`` possa non essere capito. Analogamente, ``tmp`` puÃ² essere una qualsiasi variabile che viene usata per salvare temporaneamente un valore.”h]”(hŒŠLe variabili LOCALI dovrebbero avere nomi corti, e significativi. Se avete un qualsiasi contatore di ciclo, probabilmente sarÃ chiamato ”…””}”(hjzhžhhŸNh Nubj:)”}”(hŒ``i``”h]”hŒi”…””}”(hj‚hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hjzubhŒ. Chiamarlo ”…””}”(hjzhžhhŸNh Nubj:)”}”(hŒ``loop_counter``”h]”hŒloop_counter”…””}”(hj”hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hjzubhŒ1 non Ã¨ produttivo, non ci sono possibilitÃ che ”…””}”(hjzhžhhŸNh Nubj:)”}”(hŒ``i``”h]”hŒi”…””}”(hj¦hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hjzubhŒ) possa non essere capito. Analogamente, ”…””}”(hjzhžhhŸNh Nubj:)”}”(hŒ``tmp``”h]”hŒtmp”…””}”(hj¸hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hjzubhŒ[ puÃ² essere una qualsiasi variabile che viene usata per salvare temporaneamente un valore.”…””}”(hjzhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh MVhjÅhžhubh¨)”}”(hŒÚSe avete paura di fare casino coi nomi delle vostre variabili locali, allora avete un altro problema che Ã¨ chiamato sindrome dello squilibrio dell'ormone della crescita delle funzioni. Vedere il capitolo 6 (funzioni).”h]”hŒÜSe avete paura di fare casino coi nomi delle vostre variabili locali, allora avete un altro problema che Ã¨ chiamato sindrome dello squilibrio dellâ€™ormone della crescita delle funzioni. Vedere il capitolo 6 (funzioni).”…””}”(hjÐhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh M\hjÅhžhubeh}”(h]”Œassegnare-nomi”ah ]”h"]”Œ4) assegnare nomi”ah$]”h&]”uh1j•hj—hžhhŸjh MAubj–)”}”(hhh]”(j›)”}”(hŒ 5) Definizione di tipi (typedef)”h]”hŒ 5) Definizione di tipi (typedef)”…””}”(hjéhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jšhjæhžhhŸjh Maubh¨)”}”(hŒwPer favore non usate cose come ``vps_t``. Usare il typedef per strutture e puntatori Ã¨ uno **sbaglio**. Quando vedete:”h]”(hŒPer favore non usate cose come ”…””}”(hj÷hžhhŸNh Nubj:)”}”(hŒ ``vps_t``”h]”hŒvps_t”…””}”(hjÿhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hj÷ubhŒ4. Usare il typedef per strutture e puntatori Ã¨ uno ”…””}”(hj÷hžhhŸNh Nubj³)”}”(hŒ**sbaglio**”h]”hŒsbaglio”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j²hj÷ubhŒ. Quando vedete:”…””}”(hj÷hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh Mchjæhžhubjx)”}”(hŒvps_t a;”h]”hŒvps_t a;”…””}”hj)sbah}”(h]”h ]”h"]”h$]”h&]”j‡jˆj‰‰jŠj‹jŒ}”uh1jwhŸjh Mfhjæhžhubh¨)”}”(hŒ2nei sorgenti, cosa significa? Se, invece, dicesse:”h]”hŒ2nei sorgenti, cosa significa? Se, invece, dicesse:”…””}”(hj8hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh Mjhjæhžhubjx)”}”(hŒstruct virtual_container *a;”h]”hŒstruct virtual_container *a;”…””}”hjFsbah}”(h]”h ]”h"]”h$]”h&]”j‡jˆj‰‰jŠj‹jŒ}”uh1jwhŸjh Mmhjæhžhubh¨)”}”(hŒ*potreste dire cos'Ã¨ effettivamente ``a``.”h]”(hŒ&potreste dire cosâ€™Ã¨ effettivamente ”…””}”(hjUhžhhŸNh Nubj:)”}”(hŒ``a``”h]”hŒa”…””}”(hj]hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hjUubhŒ.”…””}”(hjUhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh Mqhjæhžhubh¨)”}”(hŒjMolte persone pensano che la definizione dei tipi ``migliori la leggibilitÃ ``. Non molto. Sono utili per:”h]”(hŒ2Molte persone pensano che la definizione dei tipi ”…””}”(hjuhžhhŸNh Nubj:)”}”(hŒ``migliori la leggibilitÃ ``”h]”hŒmigliori la leggibilitÃ ”…””}”(hj}hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hjuubhŒ. Non molto. Sono utili per:”…””}”(hjuhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh MshjæhžhubhŒblock_quote”“”)”}”(hX”(a) gli oggetti completamente opachi (dove typedef viene proprio usato allo scopo di **nascondere** cosa sia davvero l'oggetto). Esempio: ``pte_t`` eccetera sono oggetti opachi che potete usare solamente con le loro funzioni accessorie. .. note:: Gli oggetti opachi e le ``funzioni accessorie`` non sono, di per se, una bella cosa. Il motivo per cui abbiamo cose come pte_t eccetera Ã¨ che davvero non c'Ã¨ alcuna informazione portabile. (b) i tipi chiaramente interi, dove l'astrazione **aiuta** ad evitare confusione sul fatto che siano ``int`` oppure ``long``. u8/u16/u32 sono typedef perfettamente accettabili, anche se ricadono nella categoria (d) piuttosto che in questa. .. note:: Ancora - dev'esserci una **ragione** per farlo. Se qualcosa Ã¨ ``unsigned long``, non c'Ã¨ alcun bisogno di avere: typedef unsigned long myfalgs_t; ma se ci sono chiare circostanze in cui potrebbe essere ``unsigned int`` e in altre configurazioni ``unsigned long``, allora certamente typedef Ã¨ una buona scelta. (c) quando di rado create letteralmente dei **nuovi** tipi su cui effettuare verifiche. (d) circostanze eccezionali, in cui si definiscono nuovi tipi identici a quelli definiti dallo standard C99. Nonostante ci voglia poco tempo per abituare occhi e cervello all'uso dei tipi standard come ``uint32_t``, alcune persone ne obiettano l'uso. PerciÃ², i tipi specifici di Linux ``u8/u16/u32/u64`` e i loro equivalenti con segno, identici ai tipi standard, sono permessi- tuttavia, non sono obbligatori per il nuovo codice. (e) i tipi sicuri nella spazio utente. In alcune strutture dati visibili dallo spazio utente non possiamo richiedere l'uso dei tipi C99 e nemmeno i vari ``u32`` descritti prima. PerciÃ², utilizziamo __u32 e tipi simili in tutte le strutture dati condivise con lo spazio utente. ”h]”hŒenumerated_list”“”)”}”(hhh]”(hŒ list_item”“”)”}”(hXºgli oggetti completamente opachi (dove typedef viene proprio usato allo scopo di **nascondere** cosa sia davvero l'oggetto). Esempio: ``pte_t`` eccetera sono oggetti opachi che potete usare solamente con le loro funzioni accessorie. .. note:: Gli oggetti opachi e le ``funzioni accessorie`` non sono, di per se, una bella cosa. Il motivo per cui abbiamo cose come pte_t eccetera Ã¨ che davvero non c'Ã¨ alcuna informazione portabile. ”h]”(h¨)”}”(hŒ|gli oggetti completamente opachi (dove typedef viene proprio usato allo scopo di **nascondere** cosa sia davvero l'oggetto).”h]”(hŒQgli oggetti completamente opachi (dove typedef viene proprio usato allo scopo di ”…””}”(hj¦hžhhŸNh Nubj³)”}”(hŒ**nascondere**”h]”hŒ nascondere”…””}”(hj®hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j²hj¦ubhŒ cosa sia davvero lâ€™oggetto).”…””}”(hj¦hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh Mvhj¢ubh¨)”}”(hŒkEsempio: ``pte_t`` eccetera sono oggetti opachi che potete usare solamente con le loro funzioni accessorie.”h]”(hŒ Esempio: ”…””}”(hjÆhžhhŸNh Nubj:)”}”(hŒ ``pte_t``”h]”hŒpte_t”…””}”(hjÎhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hjÆubhŒY eccetera sono oggetti opachi che potete usare solamente con le loro funzioni accessorie.”…””}”(hjÆhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh Myhj¢ubhŒnote”“”)”}”(hŒ¾Gli oggetti opachi e le ``funzioni accessorie`` non sono, di per se, una bella cosa. Il motivo per cui abbiamo cose come pte_t eccetera Ã¨ che davvero non c'Ã¨ alcuna informazione portabile.”h]”h¨)”}”(hŒ¾Gli oggetti opachi e le ``funzioni accessorie`` non sono, di per se, una bella cosa. Il motivo per cui abbiamo cose come pte_t eccetera Ã¨ che davvero non c'Ã¨ alcuna informazione portabile.”h]”(hŒGli oggetti opachi e le ”…””}”(hjìhžhhŸNh Nubj:)”}”(hŒ``funzioni accessorie``”h]”hŒfunzioni accessorie”…””}”(hjôhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hjìubhŒ‘ non sono, di per se, una bella cosa. Il motivo per cui abbiamo cose come pte_t eccetera Ã¨ che davvero non câ€™Ã¨ alcuna informazione portabile.”…””}”(hjìhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh M}hjèubah}”(h]”h ]”h"]”h$]”h&]”uh1jæhj¢ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j hjubj¡)”}”(hX>i tipi chiaramente interi, dove l'astrazione **aiuta** ad evitare confusione sul fatto che siano ``int`` oppure ``long``. u8/u16/u32 sono typedef perfettamente accettabili, anche se ricadono nella categoria (d) piuttosto che in questa. .. note:: Ancora - dev'esserci una **ragione** per farlo. Se qualcosa Ã¨ ``unsigned long``, non c'Ã¨ alcun bisogno di avere: typedef unsigned long myfalgs_t; ma se ci sono chiare circostanze in cui potrebbe essere ``unsigned int`` e in altre configurazioni ``unsigned long``, allora certamente typedef Ã¨ una buona scelta. ”h]”(h¨)”}”(hŒyi tipi chiaramente interi, dove l'astrazione **aiuta** ad evitare confusione sul fatto che siano ``int`` oppure ``long``.”h]”(hŒ/i tipi chiaramente interi, dove lâ€™astrazione ”…””}”(hj hžhhŸNh Nubj³)”}”(hŒ **aiuta**”h]”hŒaiuta”…””}”(hj$ hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j²hj ubhŒ+ ad evitare confusione sul fatto che siano ”…””}”(hj hžhhŸNh Nubj:)”}”(hŒ``int``”h]”hŒint”…””}”(hj6 hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hj ubhŒ oppure ”…””}”(hj hžhhŸNh Nubj:)”}”(hŒ``long``”h]”hŒlong”…””}”(hjH hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hj ubhŒ.”…””}”(hj hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh Mhj ubh¨)”}”(hŒqu8/u16/u32 sono typedef perfettamente accettabili, anche se ricadono nella categoria (d) piuttosto che in questa.”h]”hŒqu8/u16/u32 sono typedef perfettamente accettabili, anche se ricadono nella categoria (d) piuttosto che in questa.”…””}”(hj` hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh M„hj ubjç)”}”(hX> Ancora - dev'esserci una **ragione** per farlo. Se qualcosa Ã¨ ``unsigned long``, non c'Ã¨ alcun bisogno di avere: typedef unsigned long myfalgs_t; ma se ci sono chiare circostanze in cui potrebbe essere ``unsigned int`` e in altre configurazioni ``unsigned long``, allora certamente typedef Ã¨ una buona scelta.”h]”(j–)”}”(hŒ–Ancora - dev'esserci una **ragione** per farlo. Se qualcosa Ã¨ ``unsigned long``, non c'Ã¨ alcun bisogno di avere: typedef unsigned long myfalgs_t; ”h]”(h¨)”}”(hŒrAncora - dev'esserci una **ragione** per farlo. Se qualcosa Ã¨ ``unsigned long``, non c'Ã¨ alcun bisogno di avere:”h]”(hŒAncora - devâ€™esserci una ”…””}”(hjv hžhhŸNh Nubj³)”}”(hŒ**ragione**”h]”hŒragione”…””}”(hj~ hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j²hjv ubhŒ per farlo. Se qualcosa Ã¨ ”…””}”(hjv hžhhŸNh Nubj:)”}”(hŒ``unsigned long``”h]”hŒ unsigned long”…””}”(hj hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hjv ubhŒ$, non câ€™Ã¨ alcun bisogno di avere:”…””}”(hjv hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh M‰hjr ubj–)”}”(hŒ!typedef unsigned long myfalgs_t; ”h]”h¨)”}”(hŒ typedef unsigned long myfalgs_t;”h]”hŒ typedef unsigned long myfalgs_t;”…””}”(hj¬ hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh MŒhj¨ ubah}”(h]”h ]”h"]”h$]”h&]”uh1j•hŸjh MŒhjr ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j•hŸjh M‰hjn ubh¨)”}”(hŒ¤ma se ci sono chiare circostanze in cui potrebbe essere ``unsigned int`` e in altre configurazioni ``unsigned long``, allora certamente typedef Ã¨ una buona scelta.”h]”(hŒ8ma se ci sono chiare circostanze in cui potrebbe essere ”…””}”(hjÆ hžhhŸNh Nubj:)”}”(hŒ``unsigned int``”h]”hŒunsigned int”…””}”(hjÎ hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hjÆ ubhŒ e in altre configurazioni ”…””}”(hjÆ hžhhŸNh Nubj:)”}”(hŒ``unsigned long``”h]”hŒ unsigned long”…””}”(hjà hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hjÆ ubhŒ0, allora certamente typedef Ã¨ una buona scelta.”…””}”(hjÆ hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh MŽhjn ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jæhj ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j hjubj¡)”}”(hŒTquando di rado create letteralmente dei **nuovi** tipi su cui effettuare verifiche. ”h]”h¨)”}”(hŒSquando di rado create letteralmente dei **nuovi** tipi su cui effettuare verifiche.”h]”(hŒ(quando di rado create letteralmente dei ”…””}”(hj hžhhŸNh Nubj³)”}”(hŒ **nuovi**”h]”hŒnuovi”…””}”(hj hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j²hj ubhŒ" tipi su cui effettuare verifiche.”…””}”(hj hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh M’hj ubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjubj¡)”}”(hXcircostanze eccezionali, in cui si definiscono nuovi tipi identici a quelli definiti dallo standard C99. Nonostante ci voglia poco tempo per abituare occhi e cervello all'uso dei tipi standard come ``uint32_t``, alcune persone ne obiettano l'uso. PerciÃ², i tipi specifici di Linux ``u8/u16/u32/u64`` e i loro equivalenti con segno, identici ai tipi standard, sono permessi- tuttavia, non sono obbligatori per il nuovo codice. ”h]”(h¨)”}”(hŒhcircostanze eccezionali, in cui si definiscono nuovi tipi identici a quelli definiti dallo standard C99.”h]”hŒhcircostanze eccezionali, in cui si definiscono nuovi tipi identici a quelli definiti dallo standard C99.”…””}”(hj2 hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh M•hj. ubh¨)”}”(hŒNonostante ci voglia poco tempo per abituare occhi e cervello all'uso dei tipi standard come ``uint32_t``, alcune persone ne obiettano l'uso.”h]”(hŒ_Nonostante ci voglia poco tempo per abituare occhi e cervello allâ€™uso dei tipi standard come ”…””}”(hj@ hžhhŸNh Nubj:)”}”(hŒ``uint32_t``”h]”hŒuint32_t”…””}”(hjH hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hj@ ubhŒ&, alcune persone ne obiettano lâ€™uso.”…””}”(hj@ hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh M˜hj. ubh¨)”}”(hŒ³PerciÃ², i tipi specifici di Linux ``u8/u16/u32/u64`` e i loro equivalenti con segno, identici ai tipi standard, sono permessi- tuttavia, non sono obbligatori per il nuovo codice.”h]”(hŒ#PerciÃ², i tipi specifici di Linux ”…””}”(hj` hžhhŸNh Nubj:)”}”(hŒ``u8/u16/u32/u64``”h]”hŒu8/u16/u32/u64”…””}”(hjh hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hj` ubhŒ~ e i loro equivalenti con segno, identici ai tipi standard, sono permessi- tuttavia, non sono obbligatori per il nuovo codice.”…””}”(hj` hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh M›hj. ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j hjubj¡)”}”(hXi tipi sicuri nella spazio utente. In alcune strutture dati visibili dallo spazio utente non possiamo richiedere l'uso dei tipi C99 e nemmeno i vari ``u32`` descritti prima. PerciÃ², utilizziamo __u32 e tipi simili in tutte le strutture dati condivise con lo spazio utente. ”h]”(h¨)”}”(hŒ"i tipi sicuri nella spazio utente.”h]”hŒ"i tipi sicuri nella spazio utente.”…””}”(hjŠ hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh MŸhj† ubh¨)”}”(hŒîIn alcune strutture dati visibili dallo spazio utente non possiamo richiedere l'uso dei tipi C99 e nemmeno i vari ``u32`` descritti prima. PerciÃ², utilizziamo __u32 e tipi simili in tutte le strutture dati condivise con lo spazio utente.”h]”(hŒtIn alcune strutture dati visibili dallo spazio utente non possiamo richiedere lâ€™uso dei tipi C99 e nemmeno i vari ”…””}”(hj˜ hžhhŸNh Nubj:)”}”(hŒ``u32``”h]”hŒu32”…””}”(hj hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hj˜ ubhŒu descritti prima. PerciÃ², utilizziamo __u32 e tipi simili in tutte le strutture dati condivise con lo spazio utente.”…””}”(hj˜ hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh M¡hj† ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j hjubeh}”(h]”h ]”h"]”h$]”h&]”Œenumtype”Œ loweralpha”Œprefix”Œ(”Œsuffix”Œ)”uh1j›hj—ubah}”(h]”h ]”h"]”h$]”h&]”uh1j•hŸjh Mvhjæhžhubh¨)”}”(hŒ Magari ci sono altri casi validi, ma la regola di base dovrebbe essere di non usare MAI MAI un typedef a meno che non rientri in una delle regole descritte qui.”h]”hŒ Magari ci sono altri casi validi, ma la regola di base dovrebbe essere di non usare MAI MAI un typedef a meno che non rientri in una delle regole descritte qui.”…””}”(hjÐ hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh M¦hjæhžhubh¨)”}”(hŒ’In generale, un puntatore, o una struttura a cui si ha accesso diretto in modo ragionevole, non dovrebbero **mai** essere definite con un typedef.”h]”(hŒkIn generale, un puntatore, o una struttura a cui si ha accesso diretto in modo ragionevole, non dovrebbero ”…””}”(hjÞ hžhhŸNh Nubj³)”}”(hŒ**mai**”h]”hŒmai”…””}”(hjæ hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j²hjÞ ubhŒ essere definite con un typedef.”…””}”(hjÞ hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh Mªhjæhžhubeh}”(h]”Œdefinizione-di-tipi-typedef”ah ]”h"]”Œ 5) definizione di tipi (typedef)”ah$]”h&]”uh1j•hj—hžhhŸjh Maubj–)”}”(hhh]”(j›)”}”(hŒ6) Funzioni”h]”hŒ6) Funzioni”…””}”(hj hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jšhjhžhhŸjh M®ubh¨)”}”(hŒâLe funzioni dovrebbero essere brevi e carine, e fare una cosa sola. Dovrebbero occupare uno o due schermi di testo (come tutti sappiamo, la dimensione di uno schermo secondo ISO/ANSI Ã¨ di 80x24), e fare una cosa sola e bene.”h]”hŒâLe funzioni dovrebbero essere brevi e carine, e fare una cosa sola. Dovrebbero occupare uno o due schermi di testo (come tutti sappiamo, la dimensione di uno schermo secondo ISO/ANSI Ã¨ di 80x24), e fare una cosa sola e bene.”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh M°hjhžhubh¨)”}”(hX|La massima lunghezza di una funziona Ã¨ inversamente proporzionale alla sua complessitÃ e al livello di indentazione di quella funzione. Quindi, se avete una funzione che Ã¨ concettualmente semplice ma che Ã¨ implementata come un lunga (ma semplice) sequenza di caso-istruzione, dove avete molte piccole cose per molti casi differenti, allora va bene avere funzioni piÃ¹ lunghe.”h]”hX|La massima lunghezza di una funziona Ã¨ inversamente proporzionale alla sua complessitÃ e al livello di indentazione di quella funzione. Quindi, se avete una funzione che Ã¨ concettualmente semplice ma che Ã¨ implementata come un lunga (ma semplice) sequenza di caso-istruzione, dove avete molte piccole cose per molti casi differenti, allora va bene avere funzioni piÃ¹ lunghe.”…””}”(hj%hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh M´hjhžhubh¨)”}”(hXÊComunque, se avete una funzione complessa e sospettate che uno studente non particolarmente dotato del primo anno delle scuole superiori potrebbe non capire cosa faccia la funzione, allora dovreste attenervi strettamente ai limiti. Usate funzioni di supporto con nomi descrittivi (potete chiedere al compilatore di renderle inline se credete che sia necessario per le prestazioni, e probabilmente farÃ un lavoro migliore di quanto avreste potuto fare voi).”h]”hXÊComunque, se avete una funzione complessa e sospettate che uno studente non particolarmente dotato del primo anno delle scuole superiori potrebbe non capire cosa faccia la funzione, allora dovreste attenervi strettamente ai limiti. Usate funzioni di supporto con nomi descrittivi (potete chiedere al compilatore di renderle inline se credete che sia necessario per le prestazioni, e probabilmente farÃ un lavoro migliore di quanto avreste potuto fare voi).”…””}”(hj3hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh Mºhjhžhubh¨)”}”(hX‰Un'altra misura delle funzioni sono il numero di variabili locali. Non dovrebbero eccedere le 5-10, oppure state sbagliando qualcosa. Ripensate la funzione, e dividetela in pezzettini. Generalmente, un cervello umano puÃ² seguire facilmente circa 7 cose diverse, di piÃ¹ lo confonderebbe. Lo sai d'essere brillante, ma magari vorresti riuscire a capire cos'avevi fatto due settimane prima.”h]”hXUnâ€™altra misura delle funzioni sono il numero di variabili locali. Non dovrebbero eccedere le 5-10, oppure state sbagliando qualcosa. Ripensate la funzione, e dividetela in pezzettini. Generalmente, un cervello umano puÃ² seguire facilmente circa 7 cose diverse, di piÃ¹ lo confonderebbe. Lo sai dâ€™essere brillante, ma magari vorresti riuscire a capire cosâ€™avevi fatto due settimane prima.”…””}”(hjAhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh MÂhjhžhubh¨)”}”(hŒÕNei file sorgenti, separate le funzioni con una riga vuota. Se la funzione Ã¨ esportata, la macro **EXPORT** per questa funzione deve seguire immediatamente la riga della parentesi graffa di chiusura. Ad esempio:”h]”(hŒcNei file sorgenti, separate le funzioni con una riga vuota. Se la funzione Ã¨ esportata, la macro ”…””}”(hjOhžhhŸNh Nubj³)”}”(hŒ **EXPORT**”h]”hŒEXPORT”…””}”(hjWhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j²hjOubhŒh per questa funzione deve seguire immediatamente la riga della parentesi graffa di chiusura. Ad esempio:”…””}”(hjOhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh MÉhjhžhubjx)”}”(hŒfint system_is_up(void) { return system_state == SYSTEM_RUNNING; } EXPORT_SYMBOL(system_is_up);”h]”hŒfint system_is_up(void) { return system_state == SYSTEM_RUNNING; } EXPORT_SYMBOL(system_is_up);”…””}”hjosbah}”(h]”h ]”h"]”h$]”h&]”j‡jˆj‰‰jŠj‹jŒ}”uh1jwhŸjh MÍhjhžhubj–)”}”(hhh]”(j›)”}”(hŒ6.1) Prototipi di funzione”h]”hŒ6.1) Prototipi di funzione”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jšhj~hžhhŸjh MÖubh¨)”}”(hŒêNei prototipi di funzione, includete i nomi dei parametri e i loro tipi. Nonostante questo non sia richiesto dal linguaggio C, in Linux viene preferito perchÃ© Ã¨ un modo semplice per aggiungere informazioni importanti per il lettore.”h]”hŒêNei prototipi di funzione, includete i nomi dei parametri e i loro tipi. Nonostante questo non sia richiesto dal linguaggio C, in Linux viene preferito perchÃ© Ã¨ un modo semplice per aggiungere informazioni importanti per il lettore.”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh MØhj~hžhubh¨)”}”(hŒ‹Non usate la parola chiave ``extern`` con le dichiarazioni di funzione perchÃ© rende le righe piÃ¹ lunghe e non Ã¨ strettamente necessario.”h]”(hŒNon usate la parola chiave ”…””}”(hjhžhhŸNh Nubj:)”}”(hŒ ``extern``”h]”hŒextern”…””}”(hj¥hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hjubhŒf con le dichiarazioni di funzione perchÃ© rende le righe piÃ¹ lunghe e non Ã¨ strettamente necessario.”…””}”(hjhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh MÝhj~hžhubh¨)”}”(hŒ¶Quando scrivete i prototipi di funzione mantenete `l'ordine degli elementi `_.”h]”(hŒ2Quando scrivete i prototipi di funzione mantenete ”…””}”(hj½hžhhŸNh NubjZ)”}”(hŒƒ`l'ordine degli elementi `_”h]”hŒlâ€™ordine degli elementi”…””}”(hjÅhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œname”Œl'ordine degli elementi”Œrefuri”Œfhttps://lore.kernel.org/mm-commits/CAHk-=wiOCLRny5aifWNhr621kYrJwhfURsa0vFPeUEm8mF0ufg@mail.gmail.com/”uh1jYhj½ubjˆ)”}”(hŒi ”h]”h}”(h]”Œl-ordine-degli-elementi”ah ]”h"]”Œl'ordine degli elementi”ah$]”h&]”Œrefuri”jÖuh1j‡Œ referenced”Khj½ubhŒ.”…””}”(hj½hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh Màhj~hžhubh¨)”}”(hŒ9Prendiamo questa dichiarazione di funzione come esempio::”h]”hŒ8Prendiamo questa dichiarazione di funzione come esempio:”…””}”(hjïhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh Mâhj~hžhubjx)”}”(hŒ”__init void * __must_check action(enum magic value, size_t size, u8 count, char *fmt, ...) __printf(4, 5) __malloc;”h]”hŒ”__init void * __must_check action(enum magic value, size_t size, u8 count, char *fmt, ...) __printf(4, 5) __malloc;”…””}”hjýsbah}”(h]”h ]”h"]”h$]”h&]”j‡jˆuh1jwhŸjh Mähj~hžhubh¨)”}”(hŒOL'ordine suggerito per gli elementi di un prototipo di funzione Ã¨ il seguente:”h]”hŒQLâ€™ordine suggerito per gli elementi di un prototipo di funzione Ã¨ il seguente:”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh Mçhj~hžhubhŒbullet_list”“”)”}”(hhh]”(j¡)”}”(hŒ¨classe d'archiviazione (in questo caso ``static __always_inline``. Da notare che ``__always_inline`` Ã¨ tecnicamente un attributo ma che viene trattato come ``inline``)”h]”h¨)”}”(hŒ¨classe d'archiviazione (in questo caso ``static __always_inline``. Da notare che ``__always_inline`` Ã¨ tecnicamente un attributo ma che viene trattato come ``inline``)”h]”(hŒ)classe dâ€™archiviazione (in questo caso ”…””}”(hj"hžhhŸNh Nubj:)”}”(hŒ``static __always_inline``”h]”hŒstatic __always_inline”…””}”(hj*hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hj"ubhŒ. Da notare che ”…””}”(hj"hžhhŸNh Nubj:)”}”(hŒ``__always_inline``”h]”hŒ__always_inline”…””}”(hj<hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hj"ubhŒ9 Ã¨ tecnicamente un attributo ma che viene trattato come ”…””}”(hj"hžhhŸNh Nubj:)”}”(hŒ ``inline``”h]”hŒinline”…””}”(hjNhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hj"ubhŒ)”…””}”(hj"hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh Méhjubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjhžhhŸjh Nubj¡)”}”(hŒ~attributi della classe di archiviazione (in questo caso ``__init``, in altre parole la sezione, ma anche cose tipo ``__cold``)”h]”h¨)”}”(hŒ~attributi della classe di archiviazione (in questo caso ``__init``, in altre parole la sezione, ma anche cose tipo ``__cold``)”h]”(hŒ8attributi della classe di archiviazione (in questo caso ”…””}”(hjphžhhŸNh Nubj:)”}”(hŒ ``__init``”h]”hŒ__init”…””}”(hjxhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hjpubhŒ1, in altre parole la sezione, ma anche cose tipo ”…””}”(hjphžhhŸNh Nubj:)”}”(hŒ ``__cold``”h]”hŒ__cold”…””}”(hjŠhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hjpubhŒ)”…””}”(hjphžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh Mìhjlubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjhžhhŸjh Nubj¡)”}”(hŒ/il tipo di ritorno (in questo caso, ``void *``)”h]”h¨)”}”(hjªh]”(hŒ$il tipo di ritorno (in questo caso, ”…””}”(hj¬hžhhŸNh Nubj:)”}”(hŒ ``void *``”h]”hŒvoid *”…””}”(hj³hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hj¬ubhŒ)”…””}”(hj¬hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh Mîhj¨ubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjhžhhŸjh Nubj¡)”}”(hŒEattributi per il valore di ritorno (in questo caso, ``__must_check``)”h]”h¨)”}”(hjÓh]”(hŒ4attributi per il valore di ritorno (in questo caso, ”…””}”(hjÕhžhhŸNh Nubj:)”}”(hŒ``__must_check``”h]”hŒ__must_check”…””}”(hjÜhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hjÕubhŒ)”…””}”(hjÕhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh MïhjÑubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjhžhhŸjh Nubj¡)”}”(hŒ3il nome della funzione (in questo caso, ``action``)”h]”h¨)”}”(hjüh]”(hŒ(il nome della funzione (in questo caso, ”…””}”(hjþhžhhŸNh Nubj:)”}”(hŒ ``action``”h]”hŒaction”…””}”(hj hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hjþubhŒ)”…””}”(hjþhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh Mðhjúubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjhžhhŸjh Nubj¡)”}”(hŒi parametri della funzione(in questo caso, ``(enum magic value, size_t size, u8 count, char *fmt, ...)``, da notare che va messo anche il nome del parametro)”h]”h¨)”}”(hŒi parametri della funzione(in questo caso, ``(enum magic value, size_t size, u8 count, char *fmt, ...)``, da notare che va messo anche il nome del parametro)”h]”(hŒ+i parametri della funzione(in questo caso, ”…””}”(hj' hžhhŸNh Nubj:)”}”(hŒ=``(enum magic value, size_t size, u8 count, char *fmt, ...)``”h]”hŒ9(enum magic value, size_t size, u8 count, char *fmt, ...)”…””}”(hj/ hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hj' ubhŒ5, da notare che va messo anche il nome del parametro)”…””}”(hj' hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh Mñhj# ubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjhžhhŸjh Nubj¡)”}”(hŒbar); kfree(foo); return ret;”h]”hŒEerr: kfree(foo->bar); kfree(foo); return ret;”…””}”hj0sbah}”(h]”h ]”h"]”h$]”h&]”j‡jˆj‰‰jŠj‹jŒ}”uh1jwhŸjh M5hj hžhubh¨)”}”(hŒÑIl baco in questo codice Ã¨ che in alcuni punti d'uscita la variabile ``foo`` Ã¨ NULL. Normalmente si corregge questo baco dividendo la gestione dell'errore in due parti ``err_free_bar:`` e ``err_free_foo:``:”h]”(hŒHIl baco in questo codice Ã¨ che in alcuni punti dâ€™uscita la variabile ”…””}”(hj?hžhhŸNh Nubj:)”}”(hŒ``foo``”h]”hŒfoo”…””}”(hjGhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hj?ubhŒ` Ã¨ NULL. Normalmente si corregge questo baco dividendo la gestione dellâ€™errore in due parti ”…””}”(hj?hžhhŸNh Nubj:)”}”(hŒ``err_free_bar:``”h]”hŒ err_free_bar:”…””}”(hjYhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hj?ubhŒ e ”…””}”(hj?hžhhŸNh Nubj:)”}”(hŒ``err_free_foo:``”h]”hŒ err_free_foo:”…””}”(hjkhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hj?ubhŒ:”…””}”(hj?hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh Mbar); err_free_foo: kfree(foo); return ret;”h]”hŒ\err_free_bar: kfree(foo->bar); err_free_foo: kfree(foo); return ret;”…””}”hjƒsbah}”(h]”h ]”h"]”h$]”h&]”j‡jˆj‰‰jŠj‹jŒ}”uh1jwhŸjh M@hj hžhubh¨)”}”(hŒ\Idealmente, dovreste simulare condizioni d'errore per verificare i vostri percorsi d'uscita.”h]”hŒ`Idealmente, dovreste simulare condizioni dâ€™errore per verificare i vostri percorsi dâ€™uscita.”…””}”(hj’hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh MHhj hžhubeh}”(h]”Œ'centralizzare-il-ritorno-delle-funzioni”ah ]”h"]”Œ*7) centralizzare il ritorno delle funzioni”ah$]”h&]”uh1j•hj—hžhhŸjh Mubj–)”}”(hhh]”(j›)”}”(hŒ8) Commenti”h]”hŒ8) Commenti”…””}”(hj«hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jšhj¨hžhhŸjh MMubh¨)”}”(hXI commenti sono una buona cosa, ma c'Ã¨ anche il rischio di esagerare. MAI spiegare COME funziona il vostro codice in un commento: Ã¨ molto meglio scrivere il codice di modo che il suo funzionamento sia ovvio, inoltre spiegare codice scritto male Ã¨ una perdita di tempo.”h]”hXI commenti sono una buona cosa, ma câ€™Ã¨ anche il rischio di esagerare. MAI spiegare COME funziona il vostro codice in un commento: Ã¨ molto meglio scrivere il codice di modo che il suo funzionamento sia ovvio, inoltre spiegare codice scritto male Ã¨ una perdita di tempo.”…””}”(hj¹hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh MOhj¨hžhubh¨)”}”(hXSolitamente, i commenti devono dire COSA fa il codice, e non COME lo fa. Inoltre, cercate di evitare i commenti nel corpo della funzione: se la funzione Ã¨ cosÃ¬ complessa che dovete commentarla a pezzi, allora dovreste tornare al punto 6 per un momento. Potete mettere dei piccoli commenti per annotare o avvisare il lettore circa un qualcosa di particolarmente arguto (o brutto), ma cercate di non esagerare. Invece, mettete i commenti in testa alla funzione spiegando alle persone cosa fa, e possibilmente anche il PERCHÃ‰.”h]”hXSolitamente, i commenti devono dire COSA fa il codice, e non COME lo fa. Inoltre, cercate di evitare i commenti nel corpo della funzione: se la funzione Ã¨ cosÃ¬ complessa che dovete commentarla a pezzi, allora dovreste tornare al punto 6 per un momento. Potete mettere dei piccoli commenti per annotare o avvisare il lettore circa un qualcosa di particolarmente arguto (o brutto), ma cercate di non esagerare. Invece, mettete i commenti in testa alla funzione spiegando alle persone cosa fa, e possibilmente anche il PERCHÃ‰.”…””}”(hjÇhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh MThj¨hžhubh¨)”}”(hŒèPer favore, quando commentate una funzione dell'API del kernel usate il formato kernel-doc. Per maggiori dettagli, leggete i file in :ref::ref:`Documentation/translations/it_IT/doc-guide/ ` e in ``script/kernel-doc``.”h]”(hŒPer favore, quando commentate una funzione dellâ€™API del kernel usate il formato kernel-doc. Per maggiori dettagli, leggete i file in :ref:”…””}”(hjÕhžhhŸNh Nubh)”}”(hŒA:ref:`Documentation/translations/it_IT/doc-guide/ `”h]”h¶)”}”(hjßh]”hŒ+Documentation/translations/it_IT/doc-guide/”…””}”(hjáhžhhŸNh Nubah}”(h]”h ]”(hÁŒstd”Œstd-ref”eh"]”h$]”h&]”uh1hµhjÝubah}”(h]”h ]”h"]”h$]”h&]”Œrefdoc”hÎŒ refdomain”jëŒreftype”Œref”Œrefexplicit”ˆŒrefwarn”ˆhÔŒit_doc_guide”uh1hhŸjh M]hjÕubhŒ e in ”…””}”(hjÕhžhhŸNh Nubj:)”}”(hŒ``script/kernel-doc``”h]”hŒscript/kernel-doc”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hjÕubhŒ.”…””}”(hjÕhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh M]hj¨hžhubh¨)”}”(hŒ>Lo stile preferito per i commenti piÃ¹ lunghi (multi-riga) Ã¨:”h]”hŒ>Lo stile preferito per i commenti piÃ¹ lunghi (multi-riga) Ã¨:”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh Mbhj¨hžhubjx)”}”(hŒí/* * This is the preferred style for multi-line * comments in the Linux kernel source code. * Please use it consistently. * * Description: A column of asterisks on the left side, * with beginning and ending almost-blank lines. */”h]”hŒí/* * This is the preferred style for multi-line * comments in the Linux kernel source code. * Please use it consistently. * * Description: A column of asterisks on the left side, * with beginning and ending almost-blank lines. */”…””}”hj'sbah}”(h]”h ]”h"]”h$]”h&]”j‡jˆj‰‰jŠj‹jŒ}”uh1jwhŸjh Mdhj¨hžhubh¨)”}”(hŒ÷Ãˆ anche importante commentare i dati, sia per i tipi base che per tipi derivati. A questo scopo, dichiarate un dato per riga (niente virgole per una dichiarazione multipla). Questo vi lascerÃ spazio per un piccolo commento per spiegarne l'uso.”h]”hŒùÃˆ anche importante commentare i dati, sia per i tipi base che per tipi derivati. A questo scopo, dichiarate un dato per riga (niente virgole per una dichiarazione multipla). Questo vi lascerÃ spazio per un piccolo commento per spiegarne lâ€™uso.”…””}”(hj6hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh Mohj¨hžhubeh}”(h]”Œcommenti”ah ]”h"]”Œ8) commenti”ah$]”h&]”uh1j•hj—hžhhŸjh MMubj–)”}”(hhh]”(j›)”}”(hŒ9) Avete fatto un pasticcio”h]”hŒ9) Avete fatto un pasticcio”…””}”(hjOhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jšhjLhžhhŸjh Mvubh¨)”}”(hX–Va bene, li facciamo tutti. Probabilmente vi Ã¨ stato detto dal vostro aiutante Unix di fiducia che ``GNU emacs`` formatta automaticamente il codice C per conto vostro, e avete notato che sÃ¬, in effetti lo fa, ma che i modi predefiniti non sono proprio allettanti (infatti, sono peggio che premere tasti a caso - un numero infinito di scimmie che scrivono in GNU emacs non faranno mai un buon programma).”h]”(hŒeVa bene, li facciamo tutti. Probabilmente vi Ã¨ stato detto dal vostro aiutante Unix di fiducia che ”…””}”(hj]hžhhŸNh Nubj:)”}”(hŒ ``GNU emacs``”h]”hŒ GNU emacs”…””}”(hjehžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hj]ubhX$ formatta automaticamente il codice C per conto vostro, e avete notato che sÃ¬, in effetti lo fa, ma che i modi predefiniti non sono proprio allettanti (infatti, sono peggio che premere tasti a caso - un numero infinito di scimmie che scrivono in GNU emacs non faranno mai un buon programma).”…””}”(hj]hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh MxhjLhžhubh¨)”}”(hŒ®Quindi, potete sbarazzarvi di GNU emacs, o riconfigurarlo con valori piÃ¹ sensati. Per fare quest'ultima cosa, potete appiccicare il codice che segue nel vostro file .emacs:”h]”hŒ°Quindi, potete sbarazzarvi di GNU emacs, o riconfigurarlo con valori piÃ¹ sensati. Per fare questâ€™ultima cosa, potete appiccicare il codice che segue nel vostro file .emacs:”…””}”(hj}hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh MhjLhžhubjx)”}”(hX(defun c-lineup-arglist-tabs-only (ignored) "Line up argument lists by tabs, not spaces" (let* ((anchor (c-langelem-pos c-syntactic-element)) (column (c-langelem-2nd-pos c-syntactic-element)) (offset (- (1+ column) anchor)) (steps (floor offset c-basic-offset))) (* (max steps 1) c-basic-offset))) (dir-locals-set-class-variables 'linux-kernel '((c-mode . ( (c-basic-offset . 8) (c-label-minimum-indentation . 0) (c-offsets-alist . ( (arglist-close . c-lineup-arglist-tabs-only) (arglist-cont-nonempty . (c-lineup-gcc-asm-reg c-lineup-arglist-tabs-only)) (arglist-intro . +) (brace-list-intro . +) (c . c-lineup-C-comments) (case-label . 0) (comment-intro . c-lineup-comment) (cpp-define-intro . +) (cpp-macro . -1000) (cpp-macro-cont . +) (defun-block-intro . +) (else-clause . 0) (func-decl-cont . +) (inclass . +) (inher-cont . c-lineup-multi-inher) (knr-argdecl-intro . 0) (label . -1000) (statement . 0) (statement-block-intro . +) (statement-case-intro . +) (statement-cont . +) (substatement . +) )) (indent-tabs-mode . t) (show-trailing-whitespace . t) )))) (dir-locals-set-directory-class (expand-file-name "~/src/linux-trees") 'linux-kernel)”h]”hX(defun c-lineup-arglist-tabs-only (ignored) "Line up argument lists by tabs, not spaces" (let* ((anchor (c-langelem-pos c-syntactic-element)) (column (c-langelem-2nd-pos c-syntactic-element)) (offset (- (1+ column) anchor)) (steps (floor offset c-basic-offset))) (* (max steps 1) c-basic-offset))) (dir-locals-set-class-variables 'linux-kernel '((c-mode . ( (c-basic-offset . 8) (c-label-minimum-indentation . 0) (c-offsets-alist . ( (arglist-close . c-lineup-arglist-tabs-only) (arglist-cont-nonempty . (c-lineup-gcc-asm-reg c-lineup-arglist-tabs-only)) (arglist-intro . +) (brace-list-intro . +) (c . c-lineup-C-comments) (case-label . 0) (comment-intro . c-lineup-comment) (cpp-define-intro . +) (cpp-macro . -1000) (cpp-macro-cont . +) (defun-block-intro . +) (else-clause . 0) (func-decl-cont . +) (inclass . +) (inher-cont . c-lineup-multi-inher) (knr-argdecl-intro . 0) (label . -1000) (statement . 0) (statement-block-intro . +) (statement-case-intro . +) (statement-cont . +) (substatement . +) )) (indent-tabs-mode . t) (show-trailing-whitespace . t) )))) (dir-locals-set-directory-class (expand-file-name "~/src/linux-trees") 'linux-kernel)”…””}”hj‹sbah}”(h]”h ]”h"]”h$]”h&]”j‡jˆj‰‰jŠŒelisp”jŒ}”uh1jwhŸjh MƒhjLhžhubh¨)”}”(hŒ|Questo farÃ funzionare meglio emacs con lo stile del kernel per i file che si trovano nella cartella ``~/src/linux-trees``.”h]”(hŒfQuesto farÃ funzionare meglio emacs con lo stile del kernel per i file che si trovano nella cartella ”…””}”(hj›hžhhŸNh Nubj:)”}”(hŒ``~/src/linux-trees``”h]”hŒ~/src/linux-trees”…””}”(hj£hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hj›ubhŒ.”…””}”(hj›hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh M´hjLhžhubh¨)”}”(hŒtMa anche se doveste fallire nell'ottenere una formattazione sensata in emacs non tutto Ã¨ perduto: usate ``indent``.”h]”(hŒkMa anche se doveste fallire nellâ€™ottenere una formattazione sensata in emacs non tutto Ã¨ perduto: usate ”…””}”(hj»hžhhŸNh Nubj:)”}”(hŒ ``indent``”h]”hŒindent”…””}”(hjÃhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hj»ubhŒ.”…””}”(hj»hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh M·hjLhžhubh¨)”}”(hXOra, ancora, GNU indent ha la stessa configurazione decerebrata di GNU emacs, ed Ã¨ per questo che dovete passargli alcune opzioni da riga di comando. Tuttavia, non Ã¨ cosÃ¬ terribile, perchÃ© perfino i creatori di GNU indent riconoscono l'autoritÃ di K&R (le persone del progetto GNU non sono cattive, sono solo mal indirizzate sull'argomento), quindi date ad indent le opzioni ``-kr -i8`` (che significa ``K&R, 8 caratteri di indentazione``), o utilizzate ``scripts/Lindent`` che indenterÃ usando l'ultimo stile.”h]”(hX€Ora, ancora, GNU indent ha la stessa configurazione decerebrata di GNU emacs, ed Ã¨ per questo che dovete passargli alcune opzioni da riga di comando. Tuttavia, non Ã¨ cosÃ¬ terribile, perchÃ© perfino i creatori di GNU indent riconoscono lâ€™autoritÃ di K&R (le persone del progetto GNU non sono cattive, sono solo mal indirizzate sullâ€™argomento), quindi date ad indent le opzioni ”…””}”(hjÛhžhhŸNh Nubj:)”}”(hŒ``-kr -i8``”h]”hŒ-kr -i8”…””}”(hjãhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hjÛubhŒ (che significa ”…””}”(hjÛhžhhŸNh Nubj:)”}”(hŒ$``K&R, 8 caratteri di indentazione``”h]”hŒ K&R, 8 caratteri di indentazione”…””}”(hjõhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hjÛubhŒ), o utilizzate ”…””}”(hjÛhžhhŸNh Nubj:)”}”(hŒ``scripts/Lindent``”h]”hŒscripts/Lindent”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hjÛubhŒ( che indenterÃ usando lâ€™ultimo stile.”…””}”(hjÛhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh MºhjLhžhubh¨)”}”(hŒØ``indent`` ha un sacco di opzioni, e specialmente quando si tratta di riformattare i commenti dovreste dare un'occhiata alle pagine man. Ma ricordatevi: ``indent`` non Ã¨ un correttore per una cattiva programmazione.”h]”(j:)”}”(hŒ ``indent``”h]”hŒindent”…””}”(hj#hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hjubhŒ‘ ha un sacco di opzioni, e specialmente quando si tratta di riformattare i commenti dovreste dare unâ€™occhiata alle pagine man. Ma ricordatevi: ”…””}”(hjhžhhŸNh Nubj:)”}”(hŒ ``indent``”h]”hŒindent”…””}”(hj5hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hjubhŒ5 non Ã¨ un correttore per una cattiva programmazione.”…””}”(hjhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh MÂhjLhžhubh¨)”}”(hXDa notare che potete utilizzare anche ``clang-format`` per aiutarvi con queste regole, per riformattare rapidamente ad automaticamente alcune parti del vostro codice, e per revisionare interi file al fine di identificare errori di stile, refusi e possibilmente anche delle migliorie. Ãˆ anche utile per ordinare gli ``#include``, per allineare variabili/macro, per ridistribuire il testo e altre cose simili. Per maggiori dettagli, consultate il file :ref:`Documentation/translations/it_IT/dev-tools/clang-format.rst `.”h]”(hŒ&Da notare che potete utilizzare anche ”…””}”(hjMhžhhŸNh Nubj:)”}”(hŒ``clang-format``”h]”hŒclang-format”…””}”(hjUhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hjMubhX per aiutarvi con queste regole, per riformattare rapidamente ad automaticamente alcune parti del vostro codice, e per revisionare interi file al fine di identificare errori di stile, refusi e possibilmente anche delle migliorie. Ãˆ anche utile per ordinare gli ”…””}”(hjMhžhhŸNh Nubj:)”}”(hŒ``#include``”h]”hŒ#include”…””}”(hjghžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hjMubhŒ{, per allineare variabili/macro, per ridistribuire il testo e altre cose simili. Per maggiori dettagli, consultate il file ”…””}”(hjMhžhhŸNh Nubh)”}”(hŒS:ref:`Documentation/translations/it_IT/dev-tools/clang-format.rst `”h]”h¶)”}”(hj{h]”hŒ;Documentation/translations/it_IT/dev-tools/clang-format.rst”…””}”(hj}hžhhŸNh Nubah}”(h]”h ]”(hÁŒstd”Œstd-ref”eh"]”h$]”h&]”uh1hµhjyubah}”(h]”h ]”h"]”h$]”h&]”Œrefdoc”hÎŒ refdomain”j‡Œreftype”Œref”Œrefexplicit”ˆŒrefwarn”ˆhÔŒit_clangformat”uh1hhŸjh MÆhjMubhŒ.”…””}”(hjMhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh MÆhjLhžhubh¨)”}”(hŒöSe utilizzate un programma compatibile con EditorConfig, allora alcune configurazioni basilari come l'indentazione e la fine delle righe verranno applicate automaticamente. Per maggiori informazioni consultate la pagina: https://editorconfig.org/”h]”(hŒßSe utilizzate un programma compatibile con EditorConfig, allora alcune configurazioni basilari come lâ€™indentazione e la fine delle righe verranno applicate automaticamente. Per maggiori informazioni consultate la pagina: ”…””}”(hj£hžhhŸNh NubjZ)”}”(hŒhttps://editorconfig.org/”h]”hŒhttps://editorconfig.org/”…””}”(hj«hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”juh1jYhj£ubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh MÏhjLhžhubeh}”(h]”Œavete-fatto-un-pasticcio”ah ]”h"]”Œ9) avete fatto un pasticcio”ah$]”h&]”uh1j•hj—hžhhŸjh Mvubj–)”}”(hhh]”(j›)”}”(hŒ"10) File di configurazione Kconfig”h]”hŒ"10) File di configurazione Kconfig”…””}”(hjËhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jšhjÈhžhhŸjh MÕubh¨)”}”(hŒùPer tutti i file di configurazione Kconfig* che si possono trovare nei sorgenti, l'indentazione Ã¨ un po' differente. Le linee dopo un ``config`` sono indentate con un tab, mentre il testo descrittivo Ã¨ indentato di ulteriori due spazi. Esempio::”h]”(hŒŒPer tutti i file di configurazione Kconfig* che si possono trovare nei sorgenti, lâ€™indentazione Ã¨ un poâ€™ differente. Le linee dopo un ”…””}”(hjÙhžhhŸNh Nubj:)”}”(hŒ ``config``”h]”hŒconfig”…””}”(hjáhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hjÙubhŒf sono indentate con un tab, mentre il testo descrittivo Ã¨ indentato di ulteriori due spazi. Esempio:”…””}”(hjÙhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh M×hjÈhžhubjx)”}”(hXBconfig AUDIT bool "Auditing support" depends on NET help Enable auditing infrastructure that can be used with another kernel subsystem, such as SELinux (which requires this for logging of avc messages output). Does not do system-call auditing without CONFIG_AUDITSYSCALL.”h]”hXBconfig AUDIT bool "Auditing support" depends on NET help Enable auditing infrastructure that can be used with another kernel subsystem, such as SELinux (which requires this for logging of avc messages output). Does not do system-call auditing without CONFIG_AUDITSYSCALL.”…””}”hjùsbah}”(h]”h ]”h"]”h$]”h&]”j‡jˆuh1jwhŸjh MÜhjÈhžhubh¨)”}”(hŒ®Le funzionalitÃ davvero pericolose (per esempio il supporto alla scrittura per certi filesystem) dovrebbero essere dichiarate chiaramente come tali nella stringa di titolo::”h]”hŒLe funzionalitÃ davvero pericolose (per esempio il supporto alla scrittura per certi filesystem) dovrebbero essere dichiarate chiaramente come tali nella stringa di titolo:”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh MåhjÈhžhubjx)”}”(hŒ`config ADFS_FS_RW bool "ADFS write support (DANGEROUS)" depends on ADFS_FS ...”h]”hŒ`config ADFS_FS_RW bool "ADFS write support (DANGEROUS)" depends on ADFS_FS ...”…””}”hjsbah}”(h]”h ]”h"]”h$]”h&]”j‡jˆuh1jwhŸjh MéhjÈhžhubh¨)”}”(hŒ|Per la documentazione completa sui file di configurazione, consultate il documento Documentation/kbuild/kconfig-language.rst”h]”hŒ|Per la documentazione completa sui file di configurazione, consultate il documento Documentation/kbuild/kconfig-language.rst”…””}”(hj#hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh MîhjÈhžhubeh}”(h]”Œfile-di-configurazione-kconfig”ah ]”h"]”Œ"10) file di configurazione kconfig”ah$]”h&]”uh1j•hj—hžhhŸjh MÕubj–)”}”(hhh]”(j›)”}”(hŒ11) Strutture dati”h]”hŒ11) Strutture dati”…””}”(hj<hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jšhj9hžhhŸjh Móubh¨)”}”(hX‰Le strutture dati che hanno una visibilitÃ superiore al contesto del singolo thread in cui vengono create e distrutte, dovrebbero sempre avere un contatore di riferimenti. Nel kernel non esiste un *garbage collector* (e fuori dal kernel i *garbage collector* sono lenti e inefficienti), questo significa che **dovete** assolutamente avere un contatore di riferimenti per ogni cosa che usate.”h]”(hŒÇLe strutture dati che hanno una visibilitÃ superiore al contesto del singolo thread in cui vengono create e distrutte, dovrebbero sempre avere un contatore di riferimenti. Nel kernel non esiste un ”…””}”(hjJhžhhŸNh NubhŒemphasis”“”)”}”(hŒ*garbage collector*”h]”hŒgarbage collector”…””}”(hjThžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jRhjJubhŒ (e fuori dal kernel i ”…””}”(hjJhžhhŸNh NubjS)”}”(hŒ*garbage collector*”h]”hŒgarbage collector”…””}”(hjfhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jRhjJubhŒ2 sono lenti e inefficienti), questo significa che ”…””}”(hjJhžhhŸNh Nubj³)”}”(hŒ **dovete**”h]”hŒdovete”…””}”(hjxhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j²hjJubhŒI assolutamente avere un contatore di riferimenti per ogni cosa che usate.”…””}”(hjJhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh Mõhj9hžhubh¨)”}”(hX>Avere un contatore di riferimenti significa che potete evitare la sincronizzazione e permette a piÃ¹ utenti di accedere alla struttura dati in parallelo - e non doversi preoccupare di una struttura dati che improvvisamente sparisce dalla loro vista perchÃ© il loro processo dormiva o stava facendo altro per un attimo.”h]”hX>Avere un contatore di riferimenti significa che potete evitare la sincronizzazione e permette a piÃ¹ utenti di accedere alla struttura dati in parallelo - e non doversi preoccupare di una struttura dati che improvvisamente sparisce dalla loro vista perchÃ© il loro processo dormiva o stava facendo altro per un attimo.”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh Mühj9hžhubh¨)”}”(hX6Da notare che la sincronizzazione **non** si sostituisce al conteggio dei riferimenti. La sincronizzazione ha lo scopo di mantenere le strutture dati coerenti, mentre il conteggio dei riferimenti Ã¨ una tecnica di gestione della memoria. Solitamente servono entrambe le cose, e non vanno confuse fra di loro.”h]”(hŒ"Da notare che la sincronizzazione ”…””}”(hjžhžhhŸNh Nubj³)”}”(hŒ**non**”h]”hŒnon”…””}”(hj¦hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j²hjžubhX si sostituisce al conteggio dei riferimenti. La sincronizzazione ha lo scopo di mantenere le strutture dati coerenti, mentre il conteggio dei riferimenti Ã¨ una tecnica di gestione della memoria. Solitamente servono entrambe le cose, e non vanno confuse fra di loro.”…””}”(hjžhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh Mhj9hžhubh¨)”}”(hX Quando si hanno diverse classi di utenti, le strutture dati possono avere due livelli di contatori di riferimenti. Il contatore di classe conta il numero dei suoi utenti, e il contatore globale viene decrementato una sola volta quando il contatore di classe va a zero.”h]”hX Quando si hanno diverse classi di utenti, le strutture dati possono avere due livelli di contatori di riferimenti. Il contatore di classe conta il numero dei suoi utenti, e il contatore globale viene decrementato una sola volta quando il contatore di classe va a zero.”…””}”(hj¾hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh Mhj9hžhubh¨)”}”(hŒêUn esempio di questo tipo di conteggio dei riferimenti multi-livello puÃ² essere trovato nella gestore della memoria (``struct mm_sturct``: mm_user e mm_count), e nel codice dei filesystem (``struct super_block``: s_count e s_active).”h]”(hŒvUn esempio di questo tipo di conteggio dei riferimenti multi-livello puÃ² essere trovato nella gestore della memoria (”…””}”(hjÌhžhhŸNh Nubj:)”}”(hŒ``struct mm_sturct``”h]”hŒstruct mm_sturct”…””}”(hjÔhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hjÌubhŒ4: mm_user e mm_count), e nel codice dei filesystem (”…””}”(hjÌhžhhŸNh Nubj:)”}”(hŒ``struct super_block``”h]”hŒstruct super_block”…””}”(hjæhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hjÌubhŒ: s_count e s_active).”…””}”(hjÌhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh M hj9hžhubh¨)”}”(hŒ˜Ricordatevi: se un altro thread puÃ² trovare la vostra struttura dati, e non avete un contatore di riferimenti per essa, quasi certamente avete un baco.”h]”hŒ˜Ricordatevi: se un altro thread puÃ² trovare la vostra struttura dati, e non avete un contatore di riferimenti per essa, quasi certamente avete un baco.”…””}”(hjþhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh Mhj9hžhubeh}”(h]”Œstrutture-dati”ah ]”h"]”Œ11) strutture dati”ah$]”h&]”uh1j•hj—hžhhŸjh Móubj–)”}”(hhh]”(j›)”}”(hŒ12) Macro, enumerati e RTL”h]”hŒ12) Macro, enumerati e RTL”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jšhjhžhhŸjh Mubh¨)”}”(hŒkI nomi delle macro che definiscono delle costanti e le etichette degli enumerati sono scritte in maiuscolo.”h]”hŒkI nomi delle macro che definiscono delle costanti e le etichette degli enumerati sono scritte in maiuscolo.”…””}”(hj%hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh Mhjhžhubjx)”}”(hŒ#define CONSTANT 0x12345”h]”hŒ#define CONSTANT 0x12345”…””}”hj3sbah}”(h]”h ]”h"]”h$]”h&]”j‡jˆj‰‰jŠj‹jŒ}”uh1jwhŸjh Mhjhžhubh¨)”}”(hŒOGli enumerati sono da preferire quando si definiscono molte costanti correlate.”h]”hŒOGli enumerati sono da preferire quando si definiscono molte costanti correlate.”…””}”(hjBhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh Mhjhžhubh¨)”}”(hŒƒI nomi delle macro in MAIUSCOLO sono preferibili ma le macro che assomigliano a delle funzioni possono essere scritte in minuscolo.”h]”hŒƒI nomi delle macro in MAIUSCOLO sono preferibili ma le macro che assomigliano a delle funzioni possono essere scritte in minuscolo.”…””}”(hjPhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh M!hjhžhubh¨)”}”(hŒ\Generalmente, le funzioni inline sono preferibili rispetto alle macro che sembrano funzioni.”h]”hŒ\Generalmente, le funzioni inline sono preferibili rispetto alle macro che sembrano funzioni.”…””}”(hj^hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh M$hjhžhubh¨)”}”(hŒ`Le macro che contengono piÃ¹ istruzioni dovrebbero essere sempre chiuse in un blocco do - while:”h]”hŒ`Le macro che contengono piÃ¹ istruzioni dovrebbero essere sempre chiuse in un blocco do - while:”…””}”(hjlhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh M'hjhžhubjx)”}”(hŒÛ#define macrofun(a, b, c) \ do { \ if (a == 5) \ do_this(b, c); \ } while (0)”h]”hŒÛ#define macrofun(a, b, c) \ do { \ if (a == 5) \ do_this(b, c); \ } while (0)”…””}”hjzsbah}”(h]”h ]”h"]”h$]”h&]”j‡jˆj‰‰jŠj‹jŒ}”uh1jwhŸjh M*hjhžhubh¨)”}”(hŒLe macro che sembrano funzioni con parametri non usati dovrebbero essere sostituite da funzioni inline per evitare il problema.”h]”hŒLe macro che sembrano funzioni con parametri non usati dovrebbero essere sostituite da funzioni inline per evitare il problema.”…””}”(hj‰hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh M2hjhžhubjx)”}”(hŒ+static inline void fun(struct foo *foo) { }”h]”hŒ+static inline void fun(struct foo *foo) { }”…””}”hj—sbah}”(h]”h ]”h"]”h$]”h&]”j‡jˆj‰‰jŠj‹jŒ}”uh1jwhŸjh M5hjhžhubh¨)”}”(hX;Per motivi storici, molti file usano ancora l'approccio "cast a (void)" per valutare i parametri. Tuttavia, non Ã¨ raccomandato. Le funzioni inline risolvono i problemi di "espressioni con effetti avversi valutate piÃ¹ di una volta", variabili non utilizzate, e in genere per qualche motivo sono documentate meglio.”h]”hXEPer motivi storici, molti file usano ancora lâ€™approccio â€œcast a (void)â€ per valutare i parametri. Tuttavia, non Ã¨ raccomandato. Le funzioni inline risolvono i problemi di â€œespressioni con effetti avversi valutate piÃ¹ di una voltaâ€, variabili non utilizzate, e in genere per qualche motivo sono documentate meglio.”…””}”(hj¦hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh M;hjhžhubjx)”}”(hŒ/* * Avoid doing this whenever possible and instead opt for static * inline functions */ #define macrofun(foo) do { (void) (foo); } while (0)”h]”hŒ/* * Avoid doing this whenever possible and instead opt for static * inline functions */ #define macrofun(foo) do { (void) (foo); } while (0)”…””}”hj´sbah}”(h]”h ]”h"]”h$]”h&]”j‡jˆj‰‰jŠj‹jŒ}”uh1jwhŸjh MAhjhžhubh¨)”}”(hŒ)Cose da evitare quando si usano le macro:”h]”hŒ)Cose da evitare quando si usano le macro:”…””}”(hjÃhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh MIhjhžhubjœ)”}”(hhh]”j¡)”}”(hŒ2le macro che hanno effetti sul flusso del codice: ”h]”h¨)”}”(hŒ1le macro che hanno effetti sul flusso del codice:”h]”hŒ1le macro che hanno effetti sul flusso del codice:”…””}”(hjØhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh MKhjÔubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjÑhžhhŸjh Nubah}”(h]”h ]”h"]”h$]”h&]”jÄ Œarabic”jÆ hjÈ jÉ uh1j›hjhžhhŸjh MKubjx)”}”(hŒÛ#define FOO(x) \ do { \ if (blah(x) < 0) \ return -EBUGGERED; \ } while (0)”h]”hŒÛ#define FOO(x) \ do { \ if (blah(x) < 0) \ return -EBUGGERED; \ } while (0)”…””}”hjósbah}”(h]”h ]”h"]”h$]”h&]”j‡jˆj‰‰jŠj‹jŒ}”uh1jwhŸjh MMhjhžhubh¨)”}”(hŒsono **proprio** una pessima idea. Sembra una chiamata a funzione ma termina la funzione chiamante; non cercate di rompere il decodificatore interno di chi legge il codice.”h]”(hŒsono ”…””}”(hjhžhhŸNh Nubj³)”}”(hŒ**proprio**”h]”hŒproprio”…””}”(hj hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j²hjubhŒ una pessima idea. Sembra una chiamata a funzione ma termina la funzione chiamante; non cercate di rompere il decodificatore interno di chi legge il codice.”…””}”(hjhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh MUhjhžhubjœ)”}”(hhh]”j¡)”}”(hŒLle macro che dipendono dall'uso di una variabile locale con un nome magico: ”h]”h¨)”}”(hŒKle macro che dipendono dall'uso di una variabile locale con un nome magico:”h]”hŒMle macro che dipendono dallâ€™uso di una variabile locale con un nome magico:”…””}”(hj)hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh MYhj%ubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj"hžhhŸjh Nubah}”(h]”h ]”h"]”h$]”h&]”jÄ jòjÆ hjÈ jÉ Œstart”Kuh1j›hjhžhhŸjh MYubjx)”}”(hŒ #define FOO(val) bar(index, val)”h]”hŒ #define FOO(val) bar(index, val)”…””}”hjDsbah}”(h]”h ]”h"]”h$]”h&]”j‡jˆj‰‰jŠj‹jŒ}”uh1jwhŸjh M[hjhžhubh¨)”}”(hŒ›potrebbe sembrare una bella cosa, ma Ã¨ dannatamente confusionario quando uno legge il codice e potrebbe romperlo con una cambiamento che sembra innocente.”h]”hŒ›potrebbe sembrare una bella cosa, ma Ã¨ dannatamente confusionario quando uno legge il codice e potrebbe romperlo con una cambiamento che sembra innocente.”…””}”(hjShžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh M_hjhžhubh¨)”}”(hŒ 3) le macro con argomenti che sono utilizzati come l-values; questo potrebbe ritorcervisi contro se qualcuno, per esempio, trasforma FOO in una funzione inline.”h]”hŒ 3) le macro con argomenti che sono utilizzati come l-values; questo potrebbe ritorcervisi contro se qualcuno, per esempio, trasforma FOO in una funzione inline.”…””}”(hjahžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh Mbhjhžhubh¨)”}”(hŒ«4) dimenticatevi delle precedenze: le macro che definiscono espressioni devono essere racchiuse fra parentesi. State attenti a problemi simili con le macro parametrizzate.”h]”hŒ«4) dimenticatevi delle precedenze: le macro che definiscono espressioni devono essere racchiuse fra parentesi. State attenti a problemi simili con le macro parametrizzate.”…””}”(hjohžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh Mfhjhžhubjx)”}”(hŒ7#define CONSTANT 0x4000 #define CONSTEXP (CONSTANT | 3)”h]”hŒ7#define CONSTANT 0x4000 #define CONSTEXP (CONSTANT | 3)”…””}”hj}sbah}”(h]”h ]”h"]”h$]”h&]”j‡jˆj‰‰jŠj‹jŒ}”uh1jwhŸjh Mjhjhžhubh¨)”}”(hŒr5) collisione nello spazio dei nomi quando si definisce una variabile locale in una macro che sembra una funzione:”h]”hŒr5) collisione nello spazio dei nomi quando si definisce una variabile locale in una macro che sembra una funzione:”…””}”(hjŒhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh Mohjhžhubjx)”}”(hŒÔ#define FOO(x) \ ({ \ typeof(x) ret; \ ret = calc_ret(x); \ (ret); \ })”h]”hŒÔ#define FOO(x) \ ({ \ typeof(x) ret; \ ret = calc_ret(x); \ (ret); \ })”…””}”hjšsbah}”(h]”h ]”h"]”h$]”h&]”j‡jˆj‰‰jŠj‹jŒ}”uh1jwhŸjh Mrhjhžhubh¨)”}”(hŒ~ret Ã¨ un nome comune per una variabile locale - __foo_ret difficilmente andrÃ in conflitto con una variabile giÃ esistente.”h]”hŒ~ret Ã¨ un nome comune per una variabile locale - __foo_ret difficilmente andrÃ in conflitto con una variabile giÃ esistente.”…””}”(hj©hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh M{hjhžhubh¨)”}”(hŒ®Il manuale di cpp si occupa esaustivamente delle macro. Il manuale di sviluppo di gcc copre anche l'RTL che viene usato frequentemente nel kernel per il linguaggio assembler.”h]”hŒ°Il manuale di cpp si occupa esaustivamente delle macro. Il manuale di sviluppo di gcc copre anche lâ€™RTL che viene usato frequentemente nel kernel per il linguaggio assembler.”…””}”(hj·hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh M~hjhžhubeh}”(h]”Œmacro-enumerati-e-rtl”ah ]”h"]”Œ12) macro, enumerati e rtl”ah$]”h&]”uh1j•hj—hžhhŸjh Mubj–)”}”(hhh]”(j›)”}”(hŒ&13) Visualizzare i messaggi del kernel”h]”hŒ&13) Visualizzare i messaggi del kernel”…””}”(hjÐhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jšhjÍhžhhŸjh Mƒubh¨)”}”(hX"Agli sviluppatori del kernel piace essere visti come dotti. Tenete un occhio di riguardo per l'ortografia e farete una belle figura. In inglese, evitate l'uso incorretto di abbreviazioni come ``dont``: usate ``do not`` oppure ``don't``. Scrivete messaggi concisi, chiari, e inequivocabili.”h]”(hŒÄAgli sviluppatori del kernel piace essere visti come dotti. Tenete un occhio di riguardo per lâ€™ortografia e farete una belle figura. In inglese, evitate lâ€™uso incorretto di abbreviazioni come ”…””}”(hjÞhžhhŸNh Nubj:)”}”(hŒ``dont``”h]”hŒdont”…””}”(hjæhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hjÞubhŒ: usate ”…””}”(hjÞhžhhŸNh Nubj:)”}”(hŒ ``do not``”h]”hŒdo not”…””}”(hjøhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hjÞubhŒ oppure ”…””}”(hjÞhžhhŸNh Nubj:)”}”(hŒ ``don't``”h]”hŒdon't”…””}”(hj hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hjÞubhŒ7. Scrivete messaggi concisi, chiari, e inequivocabili.”…””}”(hjÞhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh M…hjÍhžhubh¨)”}”(hŒ>I messaggi del kernel non devono terminare con un punto fermo.”h]”hŒ>I messaggi del kernel non devono terminare con un punto fermo.”…””}”(hj"hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh MŠhjÍhžhubh¨)”}”(hŒcScrivere i numeri fra parentesi (%d) non migliora alcunchÃ© e per questo dovrebbero essere evitati.”h]”hŒcScrivere i numeri fra parentesi (%d) non migliora alcunchÃ© e per questo dovrebbero essere evitati.”…””}”(hj0hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh MŒhjÍhžhubh¨)”}”(hX#Ci sono alcune macro per la diagnostica in che dovreste usare per assicurarvi che i messaggi vengano associati correttamente ai dispositivi e ai driver, e che siano etichettati correttamente: dev_err(), dev_warn(), dev_info(), e cosÃ¬ via. Per messaggi che non sono associati ad alcun dispositivo, definisce pr_info(), pr_warn(), pr_err(), eccetera. Quando tutto funziona correttamente, non dovrebbero esserci stampe, per cui preferite dev_dbg/pr_debug a meno che non sia qualcosa di sbagliato da segnalare.”h]”hX#Ci sono alcune macro per la diagnostica in che dovreste usare per assicurarvi che i messaggi vengano associati correttamente ai dispositivi e ai driver, e che siano etichettati correttamente: dev_err(), dev_warn(), dev_info(), e cosÃ¬ via. Per messaggi che non sono associati ad alcun dispositivo, definisce pr_info(), pr_warn(), pr_err(), eccetera. Quando tutto funziona correttamente, non dovrebbero esserci stampe, per cui preferite dev_dbg/pr_debug a meno che non sia qualcosa di sbagliato da segnalare.”…””}”(hj>hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh MhjÍhžhubh¨)”}”(hXTirar fuori un buon messaggio di debug puÃ² essere una vera sfida; e quando l'avete puÃ² essere d'enorme aiuto per risolvere problemi da remoto. Tuttavia, i messaggi di debug sono gestiti differentemente rispetto agli altri. Le funzioni pr_XXX() stampano incondizionatamente ma pr_debug() no; essa non viene compilata nella configurazione predefinita, a meno che DEBUG o CONFIG_DYNAMIC_DEBUG non vengono impostati. Questo vale anche per dev_dbg() e in aggiunta VERBOSE_DEBUG per aggiungere i messaggi dev_vdbg().”h]”hXTirar fuori un buon messaggio di debug puÃ² essere una vera sfida; e quando lâ€™avete puÃ² essere dâ€™enorme aiuto per risolvere problemi da remoto. Tuttavia, i messaggi di debug sono gestiti differentemente rispetto agli altri. Le funzioni pr_XXX() stampano incondizionatamente ma pr_debug() no; essa non viene compilata nella configurazione predefinita, a meno che DEBUG o CONFIG_DYNAMIC_DEBUG non vengono impostati. Questo vale anche per dev_dbg() e in aggiunta VERBOSE_DEBUG per aggiungere i messaggi dev_vdbg().”…””}”(hjLhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh M˜hjÍhžhubh¨)”}”(hXiMolti sottosistemi hanno delle opzioni di debug in Kconfig che aggiungono -DDEBUG nei corrispettivi Makefile, e in altri casi aggiungono #define DEBUG in specifici file. Infine, quando un messaggio di debug dev'essere stampato incondizionatamente, per esempio perchÃ© siete giÃ in una sezione di debug racchiusa in #ifdef, potete usare printk(KERN_DEBUG ...).”h]”hXkMolti sottosistemi hanno delle opzioni di debug in Kconfig che aggiungono -DDEBUG nei corrispettivi Makefile, e in altri casi aggiungono #define DEBUG in specifici file. Infine, quando un messaggio di debug devâ€™essere stampato incondizionatamente, per esempio perchÃ© siete giÃ in una sezione di debug racchiusa in #ifdef, potete usare printk(KERN_DEBUG ...).”…””}”(hjZhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh M hjÍhžhubeh}”(h]”Œ"visualizzare-i-messaggi-del-kernel”ah ]”h"]”Œ&13) visualizzare i messaggi del kernel”ah$]”h&]”uh1j•hj—hžhhŸjh Mƒubj–)”}”(hhh]”(j›)”}”(hŒ14) Assegnare memoria”h]”hŒ14) Assegnare memoria”…””}”(hjshžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jšhjphžhhŸjh M§ubh¨)”}”(hX$Il kernel fornisce i seguenti assegnatori ad uso generico: kmalloc(), kzalloc(), kmalloc_array(), kcalloc(), vmalloc(), e vzalloc(). Per maggiori informazioni, consultate la documentazione dell'API: :ref:`Documentation/translations/it_IT/core-api/memory-allocation.rst `”h]”(hŒÉIl kernel fornisce i seguenti assegnatori ad uso generico: kmalloc(), kzalloc(), kmalloc_array(), kcalloc(), vmalloc(), e vzalloc(). Per maggiori informazioni, consultate la documentazione dellâ€™API: ”…””}”(hjhžhhŸNh Nubh)”}”(hŒ]:ref:`Documentation/translations/it_IT/core-api/memory-allocation.rst `”h]”h¶)”}”(hj‹h]”hŒ?Documentation/translations/it_IT/core-api/memory-allocation.rst”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”(hÁŒstd”Œstd-ref”eh"]”h$]”h&]”uh1hµhj‰ubah}”(h]”h ]”h"]”h$]”h&]”Œrefdoc”hÎŒ refdomain”j—Œreftype”Œref”Œrefexplicit”ˆŒrefwarn”ˆhÔŒit_memory_allocation”uh1hhŸjh M©hjubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh M©hjphžhubh¨)”}”(hŒLIl modo preferito per passare la dimensione di una struttura Ã¨ il seguente:”h]”hŒLIl modo preferito per passare la dimensione di una struttura Ã¨ il seguente:”…””}”(hj¯hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh M®hjphžhubjx)”}”(hŒp = kmalloc(sizeof(*p), ...);”h]”hŒp = kmalloc(sizeof(*p), ...);”…””}”hj½sbah}”(h]”h ]”h"]”h$]”h&]”j‡jˆj‰‰jŠj‹jŒ}”uh1jwhŸjh M°hjphžhubh¨)”}”(hŒÜLa forma alternativa, dove il nome della struttura viene scritto interamente, peggiora la leggibilitÃ e introduce possibili bachi quando il tipo di puntatore cambia tipo ma il corrispondente sizeof non viene aggiornato.”h]”hŒÜLa forma alternativa, dove il nome della struttura viene scritto interamente, peggiora la leggibilitÃ e introduce possibili bachi quando il tipo di puntatore cambia tipo ma il corrispondente sizeof non viene aggiornato.”…””}”(hjÌhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh M´hjphžhubh¨)”}”(hŒÔIl valore di ritorno Ã¨ un puntatore void, effettuare un cast su di esso Ã¨ ridondante. La conversione fra un puntatore void e un qualsiasi altro tipo di puntatore Ã¨ garantito dal linguaggio di programmazione C.”h]”hŒÔIl valore di ritorno Ã¨ un puntatore void, effettuare un cast su di esso Ã¨ ridondante. La conversione fra un puntatore void e un qualsiasi altro tipo di puntatore Ã¨ garantito dal linguaggio di programmazione C.”…””}”(hjÚhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh M¸hjphžhubh¨)”}”(hŒ:Il modo preferito per assegnare un vettore Ã¨ il seguente:”h]”hŒ:Il modo preferito per assegnare un vettore Ã¨ il seguente:”…””}”(hjèhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh M¼hjphžhubjx)”}”(hŒ'p = kmalloc_array(n, sizeof(...), ...);”h]”hŒ'p = kmalloc_array(n, sizeof(...), ...);”…””}”hjösbah}”(h]”h ]”h"]”h$]”h&]”j‡jˆj‰‰jŠj‹jŒ}”uh1jwhŸjh M¾hjphžhubh¨)”}”(hŒAIl modo preferito per assegnare un vettore a zero Ã¨ il seguente:”h]”hŒAIl modo preferito per assegnare un vettore a zero Ã¨ il seguente:”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh MÂhjphžhubjx)”}”(hŒ!p = kcalloc(n, sizeof(...), ...);”h]”hŒ!p = kcalloc(n, sizeof(...), ...);”…””}”hjsbah}”(h]”h ]”h"]”h$]”h&]”j‡jˆj‰‰jŠj‹jŒ}”uh1jwhŸjh MÄhjphžhubh¨)”}”(hŒ|Entrambe verificano la condizione di overflow per la dimensione d'assegnamento n * sizeof(...), se accade ritorneranno NULL.”h]”hŒ~Entrambe verificano la condizione di overflow per la dimensione dâ€™assegnamento n * sizeof(...), se accade ritorneranno NULL.”…””}”(hj"hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh MÈhjphžhubh¨)”}”(hXQuesti allocatori generici producono uno *stack dump* in caso di fallimento a meno che non venga esplicitamente specificato __GFP_NOWARN. Quindi, nella maggior parte dei casi, Ã¨ inutile stampare messaggi aggiuntivi quando uno di questi allocatori ritornano un puntatore NULL.”h]”(hŒ)Questi allocatori generici producono uno ”…””}”(hj0hžhhŸNh NubjS)”}”(hŒ*stack dump*”h]”hŒ stack dump”…””}”(hj8hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jRhj0ubhŒß in caso di fallimento a meno che non venga esplicitamente specificato __GFP_NOWARN. Quindi, nella maggior parte dei casi, Ã¨ inutile stampare messaggi aggiuntivi quando uno di questi allocatori ritornano un puntatore NULL.”…””}”(hj0hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh MËhjphžhubeh}”(h]”Œassegnare-memoria”ah ]”h"]”Œ14) assegnare memoria”ah$]”h&]”uh1j•hj—hžhhŸjh M§ubj–)”}”(hhh]”(j›)”}”(hŒ15) Il morbo inline”h]”hŒ15) Il morbo inline”…””}”(hj[hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jšhjXhžhhŸjh MÑubh¨)”}”(hXïSembra che ci sia la percezione errata che gcc abbia una qualche magica opzione "rendimi piÃ¹ veloce" chiamata ``inline``. In alcuni casi l'uso di inline Ã¨ appropriato (per esempio in sostituzione delle macro, vedi capitolo 12), ma molto spesso non lo Ã¨. L'uso abbondante della parola chiave inline porta ad avere un kernel piÃ¹ grande, che si traduce in un sistema nel suo complesso piÃ¹ lento per via di una cache per le istruzioni della CPU piÃ¹ grande e poi semplicemente perchÃ© ci sarÃ meno spazio disponibile per una pagina di cache. Pensateci un attimo; una fallimento nella cache causa una ricerca su disco che puÃ² tranquillamente richiedere 5 millisecondi. Ci sono TANTI cicli di CPU che potrebbero essere usati in questi 5 millisecondi.”h]”(hŒsSembra che ci sia la percezione errata che gcc abbia una qualche magica opzione â€œrendimi piÃ¹ veloceâ€ chiamata ”…””}”(hjihžhhŸNh Nubj:)”}”(hŒ ``inline``”h]”hŒinline”…””}”(hjqhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hjiubhXz. In alcuni casi lâ€™uso di inline Ã¨ appropriato (per esempio in sostituzione delle macro, vedi capitolo 12), ma molto spesso non lo Ã¨. Lâ€™uso abbondante della parola chiave inline porta ad avere un kernel piÃ¹ grande, che si traduce in un sistema nel suo complesso piÃ¹ lento per via di una cache per le istruzioni della CPU piÃ¹ grande e poi semplicemente perchÃ© ci sarÃ meno spazio disponibile per una pagina di cache. Pensateci un attimo; una fallimento nella cache causa una ricerca su disco che puÃ² tranquillamente richiedere 5 millisecondi. Ci sono TANTI cicli di CPU che potrebbero essere usati in questi 5 millisecondi.”…””}”(hjihžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh MÓhjXhžhubh¨)”}”(hXàSpesso le persone dicono che aggiungere inline a delle funzioni dichiarate static e utilizzare una sola volta Ã¨ sempre una scelta vincente perchÃ© non ci sono altri compromessi. Questo Ã¨ tecnicamente vero ma gcc Ã¨ in grado di trasformare automaticamente queste funzioni in inline; i problemi di manutenzione del codice per rimuovere gli inline quando compare un secondo utente surclassano il potenziale vantaggio nel suggerire a gcc di fare una cosa che avrebbe fatto comunque.”h]”hXàSpesso le persone dicono che aggiungere inline a delle funzioni dichiarate static e utilizzare una sola volta Ã¨ sempre una scelta vincente perchÃ© non ci sono altri compromessi. Questo Ã¨ tecnicamente vero ma gcc Ã¨ in grado di trasformare automaticamente queste funzioni in inline; i problemi di manutenzione del codice per rimuovere gli inline quando compare un secondo utente surclassano il potenziale vantaggio nel suggerire a gcc di fare una cosa che avrebbe fatto comunque.”…””}”(hj‰hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh MÞhjXhžhubeh}”(h]”Œil-morbo-inline”ah ]”h"]”Œ15) il morbo inline”ah$]”h&]”uh1j•hj—hžhhŸjh MÑubj–)”}”(hhh]”(j›)”}”(hŒ+16) Nomi e valori di ritorno delle funzioni”h]”hŒ+16) Nomi e valori di ritorno delle funzioni”…””}”(hj¢hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jšhjŸhžhhŸjh Mçubh¨)”}”(hXILe funzioni possono ritornare diversi tipi di valori, e uno dei piÃ¹ comuni Ã¨ quel valore che indica se una funzione ha completato con successo o meno. Questo valore puÃ² essere rappresentato come un codice di errore intero (-Exxx = fallimento, 0 = successo) oppure un booleano di successo (0 = fallimento, non-zero = successo).”h]”hXILe funzioni possono ritornare diversi tipi di valori, e uno dei piÃ¹ comuni Ã¨ quel valore che indica se una funzione ha completato con successo o meno. Questo valore puÃ² essere rappresentato come un codice di errore intero (-Exxx = fallimento, 0 = successo) oppure un booleano di successo (0 = fallimento, non-zero = successo).”…””}”(hj°hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh MéhjŸhžhubh¨)”}”(hXkMischiare questi due tipi di rappresentazioni Ã¨ un terreno fertile per i bachi piÃ¹ insidiosi. Se il linguaggio C includesse una forte distinzione fra gli interi e i booleani, allora il compilatore potrebbe trovare questi errori per conto nostro ... ma questo non c'Ã¨. Per evitare di imbattersi in questo tipo di baco, seguite sempre la seguente convenzione::”h]”hXlMischiare questi due tipi di rappresentazioni Ã¨ un terreno fertile per i bachi piÃ¹ insidiosi. Se il linguaggio C includesse una forte distinzione fra gli interi e i booleani, allora il compilatore potrebbe trovare questi errori per conto nostro ... ma questo non câ€™Ã¨. Per evitare di imbattersi in questo tipo di baco, seguite sempre la seguente convenzione:”…””}”(hj¾hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh MïhjŸhžhubjx)”}”(hŒÊSe il nome di una funzione Ã¨ un'azione o un comando imperativo, essa dovrebbe ritornare un codice di errore intero. Se il nome Ã¨ un predicato, la funzione dovrebbe ritornare un booleano di "successo"”h]”hŒÊSe il nome di una funzione Ã¨ un'azione o un comando imperativo, essa dovrebbe ritornare un codice di errore intero. Se il nome Ã¨ un predicato, la funzione dovrebbe ritornare un booleano di "successo"”…””}”hjÌsbah}”(h]”h ]”h"]”h$]”h&]”j‡jˆuh1jwhŸjh MõhjŸhžhubh¨)”}”(hX'Per esempio, ``add work`` Ã¨ un comando, e la funzione add_work() ritorna 0 in caso di successo o -EBUSY in caso di fallimento. Allo stesso modo, ``PCI device present`` Ã¨ un predicato, e la funzione pci_dev_present() ritorna 1 se trova il dispositivo corrispondente con successo, altrimenti 0.”h]”(hŒ Per esempio, ”…””}”(hjÚhžhhŸNh Nubj:)”}”(hŒ``add work``”h]”hŒadd work”…””}”(hjâhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hjÚubhŒz Ã¨ un comando, e la funzione add_work() ritorna 0 in caso di successo o -EBUSY in caso di fallimento. Allo stesso modo, ”…””}”(hjÚhžhhŸNh Nubj:)”}”(hŒ``PCI device present``”h]”hŒPCI device present”…””}”(hjôhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hjÚubhŒ~ Ã¨ un predicato, e la funzione pci_dev_present() ritorna 1 se trova il dispositivo corrispondente con successo, altrimenti 0.”…””}”(hjÚhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh MúhjŸhžhubh¨)”}”(hŒóTutte le funzioni esportate (EXPORT) devono rispettare questa convenzione, e cosÃ¬ dovrebbero anche tutte le funzioni pubbliche. Le funzioni private (static) possono non seguire questa convenzione, ma Ã¨ comunque raccomandato che lo facciano.”h]”hŒóTutte le funzioni esportate (EXPORT) devono rispettare questa convenzione, e cosÃ¬ dovrebbero anche tutte le funzioni pubbliche. Le funzioni private (static) possono non seguire questa convenzione, ma Ã¨ comunque raccomandato che lo facciano.”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh MÿhjŸhžhubh¨)”}”(hX‘Le funzioni il cui valore di ritorno Ã¨ il risultato di una computazione, piuttosto che l'indicazione sul successo di tale computazione, non sono soggette a questa regola. Solitamente si indicano gli errori ritornando un qualche valore fuori dai limiti. Un tipico esempio Ã¨ quello delle funzioni che ritornano un puntatore; queste utilizzano NULL o ERR_PTR come meccanismo di notifica degli errori.”h]”hX“Le funzioni il cui valore di ritorno Ã¨ il risultato di una computazione, piuttosto che lâ€™indicazione sul successo di tale computazione, non sono soggette a questa regola. Solitamente si indicano gli errori ritornando un qualche valore fuori dai limiti. Un tipico esempio Ã¨ quello delle funzioni che ritornano un puntatore; queste utilizzano NULL o ERR_PTR come meccanismo di notifica degli errori.”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh MhjŸhžhubeh}”(h]”Œ'nomi-e-valori-di-ritorno-delle-funzioni”ah ]”h"]”Œ+16) nomi e valori di ritorno delle funzioni”ah$]”h&]”uh1j•hj—hžhhŸjh Mçubj–)”}”(hhh]”(j›)”}”(hŒ17) L'uso di bool”h]”hŒ17) Lâ€™uso di bool”…””}”(hj3hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jšhj0hžhhŸjh Mubh¨)”}”(hXaNel kernel Linux il tipo bool deriva dal tipo _Bool dello standard C99. Un valore bool puÃ² assumere solo i valori 0 o 1, e implicitamente o esplicitamente la conversione a bool converte i valori in vero (*true*) o falso (*false*). Quando si usa un tipo bool il costrutto !! non sarÃ piÃ¹ necessario, e questo va ad eliminare una certa serie di bachi.”h]”(hŒÍNel kernel Linux il tipo bool deriva dal tipo _Bool dello standard C99. Un valore bool puÃ² assumere solo i valori 0 o 1, e implicitamente o esplicitamente la conversione a bool converte i valori in vero (”…””}”(hjAhžhhŸNh NubjS)”}”(hŒ*true*”h]”hŒtrue”…””}”(hjIhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jRhjAubhŒ) o falso (”…””}”(hjAhžhhŸNh NubjS)”}”(hŒ*false*”h]”hŒfalse”…””}”(hj[hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jRhjAubhŒ|). Quando si usa un tipo bool il costrutto !! non sarÃ piÃ¹ necessario, e questo va ad eliminare una certa serie di bachi.”…””}”(hjAhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh Mhj0hžhubh¨)”}”(hŒpQuando si usano i valori booleani, dovreste utilizzare le definizioni di true e false al posto dei valori 1 e 0.”h]”hŒpQuando si usano i valori booleani, dovreste utilizzare le definizioni di true e false al posto dei valori 1 e 0.”…””}”(hjshžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh Mhj0hžhubh¨)”}”(hŒøPer il valore di ritorno delle funzioni e per le variabili sullo stack, l'uso del tipo bool Ã¨ sempre appropriato. L'uso di bool viene incoraggiato per migliorare la leggibilitÃ e spesso Ã¨ molto meglio di 'int' nella gestione di valori booleani.”h]”hXPer il valore di ritorno delle funzioni e per le variabili sullo stack, lâ€™uso del tipo bool Ã¨ sempre appropriato. Lâ€™uso di bool viene incoraggiato per migliorare la leggibilitÃ e spesso Ã¨ molto meglio di â€˜intâ€™ nella gestione di valori booleani.”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh Mhj0hžhubh¨)”}”(hX'Non usate bool se per voi sono importanti l'ordine delle righe di cache o la loro dimensione; la dimensione e l'allineamento cambia a seconda dell'architettura per la quale Ã¨ stato compilato. Le strutture che sono state ottimizzate per l'allineamento o la dimensione non dovrebbero usare bool.”h]”hX/Non usate bool se per voi sono importanti lâ€™ordine delle righe di cache o la loro dimensione; la dimensione e lâ€™allineamento cambia a seconda dellâ€™architettura per la quale Ã¨ stato compilato. Le strutture che sono state ottimizzate per lâ€™allineamento o la dimensione non dovrebbero usare bool.”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh Mhj0hžhubh¨)”}”(hŒ¨Se una struttura ha molti valori true/false, considerate l'idea di raggrupparli in un intero usando campi da 1 bit, oppure usate un tipo dalla larghezza fissa, come u8.”h]”hŒªSe una struttura ha molti valori true/false, considerate lâ€™idea di raggrupparli in un intero usando campi da 1 bit, oppure usate un tipo dalla larghezza fissa, come u8.”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh M!hj0hžhubh¨)”}”(hŒíCome per gli argomenti delle funzioni, molti valori true/false possono essere raggruppati in un singolo argomento a bit denominato 'flags'; spesso 'flags' Ã¨ un'alternativa molto piÃ¹ leggibile se si hanno valori costanti per true/false.”h]”hŒ÷Come per gli argomenti delle funzioni, molti valori true/false possono essere raggruppati in un singolo argomento a bit denominato â€˜flagsâ€™; spesso â€˜flagsâ€™ Ã¨ unâ€™alternativa molto piÃ¹ leggibile se si hanno valori costanti per true/false.”…””}”(hj«hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh M%hj0hžhubh¨)”}”(hŒoDetto ciÃ², un uso parsimonioso di bool nelle strutture dati e negli argomenti puÃ² migliorare la leggibilitÃ .”h]”hŒoDetto ciÃ², un uso parsimonioso di bool nelle strutture dati e negli argomenti puÃ² migliorare la leggibilitÃ .”…””•ÔT}”(hj¹hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh M)hj0hžhubeh}”(h]”Œ l-uso-di-bool”ah ]”h"]”Œ17) l'uso di bool”ah$]”h&]”uh1j•hj—hžhhŸjh Mubj–)”}”(hhh]”(j›)”}”(hŒ'18) Non reinventate le macro del kernel”h]”hŒ'18) Non reinventate le macro del kernel”…””}”(hjÒhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jšhjÏhžhhŸjh M-ubh¨)”}”(hŒæIl file di intestazione include/linux/kernel.h contiene un certo numero di macro che dovreste usare piuttosto che implementarne una qualche variante. Per esempio, se dovete calcolare la lunghezza di un vettore, sfruttate la macro:”h]”hŒæIl file di intestazione include/linux/kernel.h contiene un certo numero di macro che dovreste usare piuttosto che implementarne una qualche variante. Per esempio, se dovete calcolare la lunghezza di un vettore, sfruttate la macro:”…””}”(hjàhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh M/hjÏhžhubjx)”}”(hŒ2#define ARRAY_SIZE(x) (sizeof(x) / sizeof((x)[0]))”h]”hŒ2#define ARRAY_SIZE(x) (sizeof(x) / sizeof((x)[0]))”…””}”hjîsbah}”(h]”h ]”h"]”h$]”h&]”j‡jˆj‰‰jŠj‹jŒ}”uh1jwhŸjh M4hjÏhžhubh¨)”}”(hŒ[Analogamente, se dovete calcolare la dimensione di un qualche campo di una struttura, usate”h]”hŒ[Analogamente, se dovete calcolare la dimensione di un qualche campo di una struttura, usate”…””}”(hjýhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh M8hjÏhžhubjx)”}”(hŒ/#define sizeof_field(t, f) (sizeof(((t*)0)->f))”h]”hŒ/#define sizeof_field(t, f) (sizeof(((t*)0)->f))”…””}”hjsbah}”(h]”h ]”h"]”h$]”h&]”j‡jˆj‰‰jŠj‹jŒ}”uh1jwhŸjh M;hjÏhžhubh¨)”}”(hŒýCi sono anche le macro min() e max() che, se vi serve, effettuano un controllo rigido sui tipi. Sentitevi liberi di leggere attentamente questo file d'intestazione per scoprire cos'altro Ã¨ stato definito che non dovreste reinventare nel vostro codice.”h]”hXCi sono anche le macro min() e max() che, se vi serve, effettuano un controllo rigido sui tipi. Sentitevi liberi di leggere attentamente questo file dâ€™intestazione per scoprire cosâ€™altro Ã¨ stato definito che non dovreste reinventare nel vostro codice.”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh M?hjÏhžhubeh}”(h]”Œ#non-reinventate-le-macro-del-kernel”ah ]”h"]”Œ'18) non reinventate le macro del kernel”ah$]”h&]”uh1j•hj—hžhhŸjh M-ubj–)”}”(hhh]”(j›)”}”(hŒ:19) Linee di configurazione degli editor e altre schifezze”h]”hŒ:19) Linee di configurazione degli editor e altre schifezze”…””}”(hj3hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jšhj0hžhhŸjh MEubh¨)”}”(hŒÈAlcuni editor possono interpretare dei parametri di configurazione integrati nei file sorgenti e indicati con dai marcatori speciali. Per esempio, emacs interpreta le linee marcate nel seguente modo:”h]”hŒÈAlcuni editor possono interpretare dei parametri di configurazione integrati nei file sorgenti e indicati con dai marcatori speciali. Per esempio, emacs interpreta le linee marcate nel seguente modo:”…””}”(hjAhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh MGhj0hžhubjx)”}”(hŒ-*- mode: c -*-”h]”hŒ-*- mode: c -*-”…””}”hjOsbah}”(h]”h ]”h"]”h$]”h&]”j‡jˆj‰‰jŠj‹jŒ}”uh1jwhŸjh MKhj0hžhubh¨)”}”(hŒO come queste:”h]”hŒO come queste:”…””}”(hj^hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh MOhj0hžhubjx)”}”(hŒK/* Local Variables: compile-command: "gcc -DMAGIC_DEBUG_FLAG foo.c" End: */”h]”hŒK/* Local Variables: compile-command: "gcc -DMAGIC_DEBUG_FLAG foo.c" End: */”…””}”hjlsbah}”(h]”h ]”h"]”h$]”h&]”j‡jˆj‰‰jŠj‹jŒ}”uh1jwhŸjh MQhj0hžhubh¨)”}”(hŒ'Vim interpreta i marcatori come questi:”h]”hŒ'Vim interpreta i marcatori come questi:”…””}”(hj{hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh MYhj0hžhubjx)”}”(hŒ/* vim:set sw=8 noet */”h]”hŒ/* vim:set sw=8 noet */”…””}”hj‰sbah}”(h]”h ]”h"]”h$]”h&]”j‡jˆj‰‰jŠj‹jŒ}”uh1jwhŸjh M[hj0hžhubh¨)”}”(hXNon includete nessuna di queste cose nei file sorgenti. Le persone hanno le proprie configurazioni personali per l'editor, e i vostri sorgenti non dovrebbero sovrascrivergliele. Questo vale anche per i marcatori d'indentazione e di modalitÃ d'uso. Le persone potrebbero aver configurato una modalitÃ su misura, oppure potrebbero avere qualche altra magia per far funzionare bene l'indentazione.”h]”hX—Non includete nessuna di queste cose nei file sorgenti. Le persone hanno le proprie configurazioni personali per lâ€™editor, e i vostri sorgenti non dovrebbero sovrascrivergliele. Questo vale anche per i marcatori dâ€™indentazione e di modalitÃ dâ€™uso. Le persone potrebbero aver configurato una modalitÃ su misura, oppure potrebbero avere qualche altra magia per far funzionare bene lâ€™indentazione.”…””}”(hj˜hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh M_hj0hžhubeh}”(h]”Œ6linee-di-configurazione-degli-editor-e-altre-schifezze”ah ]”h"]”Œ:19) linee di configurazione degli editor e altre schifezze”ah$]”h&]”uh1j•hj—hžhhŸjh MEubj–)”}”(hhh]”(j›)”}”(hŒ20) Inline assembly”h]”hŒ20) Inline assembly”…””}”(hj±hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jšhj®hžhhŸjh Mgubh¨)”}”(hXkNel codice specifico per un'architettura, potreste aver bisogno di codice *inline assembly* per interfacciarvi col processore o con una funzionalitÃ specifica della piattaforma. Non esitate a farlo quando Ã¨ necessario. Comunque, non usatele gratuitamente quando il C puÃ² fare la stessa cosa. Potete e dovreste punzecchiare l'hardware in C quando Ã¨ possibile.”h]”(hŒLNel codice specifico per unâ€™architettura, potreste aver bisogno di codice ”…””}”(hj¿hžhhŸNh NubjS)”}”(hŒ*inline assembly*”h]”hŒinline assembly”…””}”(hjÇhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jRhj¿ubhX per interfacciarvi col processore o con una funzionalitÃ specifica della piattaforma. Non esitate a farlo quando Ã¨ necessario. Comunque, non usatele gratuitamente quando il C puÃ² fare la stessa cosa. Potete e dovreste punzecchiare lâ€™hardware in C quando Ã¨ possibile.”…””}”(hj¿hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh Mihj®hžhubh¨)”}”(hŒãConsiderate la scrittura di una semplice funzione che racchiude pezzi comuni di codice assembler piuttosto che continuare a riscrivere delle piccole varianti. Ricordatevi che l' *inline assembly* puÃ² utilizzare i parametri C.”h]”(hŒµConsiderate la scrittura di una semplice funzione che racchiude pezzi comuni di codice assembler piuttosto che continuare a riscrivere delle piccole varianti. Ricordatevi che lâ€™ ”…””}”(hjßhžhhŸNh NubjS)”}”(hŒ*inline assembly*”h]”hŒinline assembly”…””}”(hjçhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jRhjßubhŒ puÃ² utilizzare i parametri C.”…””}”(hjßhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh Mohj®hžhubh¨)”}”(hŒÑIl codice assembler piÃ¹ corposo e non banale dovrebbe andare nei file .S, coi rispettivi prototipi C definiti nei file d'intestazione. I prototipi C per le funzioni assembler dovrebbero usare ``asmlinkage``.”h]”(hŒÄIl codice assembler piÃ¹ corposo e non banale dovrebbe andare nei file .S, coi rispettivi prototipi C definiti nei file dâ€™intestazione. I prototipi C per le funzioni assembler dovrebbero usare ”…””}”(hjÿhžhhŸNh Nubj:)”}”(hŒ``asmlinkage``”h]”hŒ asmlinkage”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hjÿubhŒ.”…””}”(hjÿhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh Mshj®hžhubh¨)”}”(hŒðPotreste aver bisogno di marcare il vostro codice asm come volatile al fine d'evitare che GCC lo rimuova quando pensa che non ci siano effetti collaterali. Non c'Ã¨ sempre bisogno di farlo, e farlo quando non serve limita le ottimizzazioni.”h]”hŒôPotreste aver bisogno di marcare il vostro codice asm come volatile al fine dâ€™evitare che GCC lo rimuova quando pensa che non ci siano effetti collaterali. Non câ€™Ã¨ sempre bisogno di farlo, e farlo quando non serve limita le ottimizzazioni.”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh Mwhj®hžhubh¨)”}”(hX,Quando scrivete una singola espressione *inline assembly* contenente piÃ¹ istruzioni, mettete ognuna di queste istruzioni in una stringa e riga diversa; ad eccezione dell'ultima stringa/istruzione, ognuna deve terminare con ``\n\t`` al fine di allineare correttamente l'assembler che verrÃ generato:”h]”(hŒ(Quando scrivete una singola espressione ”…””}”(hj-hžhhŸNh NubjS)”}”(hŒ*inline assembly*”h]”hŒinline assembly”…””}”(hj5hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jRhj-ubhŒ© contenente piÃ¹ istruzioni, mettete ognuna di queste istruzioni in una stringa e riga diversa; ad eccezione dellâ€™ultima stringa/istruzione, ognuna deve terminare con ”…””}”(hj-hžhhŸNh Nubj:)”}”(hŒ``\n\t``”h]”hŒ\n\t”…””}”(hjGhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hj-ubhŒF al fine di allineare correttamente lâ€™assembler che verrÃ generato:”…””}”(hj-hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh M|hj®hžhubjx)”}”(hŒqasm ("magic %reg1, #42\n\t" "more_magic %reg2, %reg3" : /* outputs */ : /* inputs */ : /* clobbers */);”h]”hŒqasm ("magic %reg1, #42\n\t" "more_magic %reg2, %reg3" : /* outputs */ : /* inputs */ : /* clobbers */);”…””}”hj_sbah}”(h]”h ]”h"]”h$]”h&]”j‡jˆj‰‰jŠj‹jŒ}”uh1jwhŸjh Mhj®hžhubeh}”(h]”Œinline-assembly”ah ]”h"]”Œ20) inline assembly”ah$]”h&]”uh1j•hj—hžhhŸjh Mgubj–)”}”(hhh]”(j›)”}”(hŒ!21) Compilazione sotto condizione”h]”hŒ!21) Compilazione sotto condizione”…””}”(hjyhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jšhjvhžhhŸjh Mˆubh¨)”}”(hXýOvunque sia possibile, non usate le direttive condizionali del preprocessore (#if, #ifdef) nei file .c; farlo rende il codice difficile da leggere e da seguire. Invece, usate queste direttive nei file d'intestazione per definire le funzioni usate nei file .c, fornendo i relativi stub nel caso #else, e quindi chiamate queste funzioni senza condizioni di preprocessore. Il compilatore non produrrÃ alcun codice per le funzioni stub, produrrÃ gli stessi risultati, e la logica rimarrÃ semplice da seguire.”h]”hXÿOvunque sia possibile, non usate le direttive condizionali del preprocessore (#if, #ifdef) nei file .c; farlo rende il codice difficile da leggere e da seguire. Invece, usate queste direttive nei file dâ€™intestazione per definire le funzioni usate nei file .c, fornendo i relativi stub nel caso #else, e quindi chiamate queste funzioni senza condizioni di preprocessore. Il compilatore non produrrÃ alcun codice per le funzioni stub, produrrÃ gli stessi risultati, e la logica rimarrÃ semplice da seguire.”…””}”(hj‡hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh MŠhjvhžhubh¨)”}”(hX Ãˆ preferibile non compilare intere funzioni piuttosto che porzioni d'esse o porzioni d'espressioni. Piuttosto che mettere una ifdef in un'espressione, fattorizzate parte dell'espressione, o interamente, in funzioni e applicate la direttiva condizionale su di esse.”h]”hXÃˆ preferibile non compilare intere funzioni piuttosto che porzioni dâ€™esse o porzioni dâ€™espressioni. Piuttosto che mettere una ifdef in unâ€™espressione, fattorizzate parte dellâ€™espressione, o interamente, in funzioni e applicate la direttiva condizionale su di esse.”…””}”(hj•hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh M’hjvhžhubh¨)”}”(hXrSe avete una variabile o funzione che potrebbe non essere usata in alcune configurazioni, e quindi il compilatore potrebbe avvisarvi circa la definizione inutilizzata, marcate questa definizione come __maybe_unused piuttosto che racchiuderla in una direttiva condizionale del preprocessore. (Comunque, se una variabile o funzione Ã¨ *sempre* inutilizzata, rimuovetela).”h]”(hXNSe avete una variabile o funzione che potrebbe non essere usata in alcune configurazioni, e quindi il compilatore potrebbe avvisarvi circa la definizione inutilizzata, marcate questa definizione come __maybe_unused piuttosto che racchiuderla in una direttiva condizionale del preprocessore. (Comunque, se una variabile o funzione Ã¨ ”…””}”(hj£hžhhŸNh NubjS)”}”(hŒ*sempre*”h]”hŒsempre”…””}”(hj«hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jRhj£ubhŒ inutilizzata, rimuovetela).”…””}”(hj£hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh M—hjvhžhubh¨)”}”(hŒ¢Nel codice, dov'Ã¨ possibile, usate la macro IS_ENABLED per convertire i simboli Kconfig in espressioni booleane C, e quindi usatela nelle classiche condizioni C:”h]”hŒ¤Nel codice, dovâ€™Ã¨ possibile, usate la macro IS_ENABLED per convertire i simboli Kconfig in espressioni booleane C, e quindi usatela nelle classiche condizioni C:”…””}”(hjÃhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh Mhjvhžhubjx)”}”(hŒ1if (IS_ENABLED(CONFIG_SOMETHING)) { ... }”h]”hŒ1if (IS_ENABLED(CONFIG_SOMETHING)) { ... }”…””}”hjÑsbah}”(h]”h ]”h"]”h$]”h&]”j‡jˆj‰‰jŠj‹jŒ}”uh1jwhŸjh M¡hjvhžhubh¨)”}”(hXðIl compilatore valuterÃ la condizione come costante (constant-fold), e quindi includerÃ o escluderÃ il blocco di codice come se fosse in un #ifdef, quindi non ne aumenterÃ il tempo di esecuzione. Tuttavia, questo permette al compilatore C di vedere il codice nel blocco condizionale e verificarne la correttezza (sintassi, tipi, riferimenti ai simboli, eccetera). Quindi dovete comunque utilizzare #ifdef se il codice nel blocco condizionale esiste solo quando la condizione Ã¨ soddisfatta.”h]”hXðIl compilatore valuterÃ la condizione come costante (constant-fold), e quindi includerÃ o escluderÃ il blocco di codice come se fosse in un #ifdef, quindi non ne aumenterÃ il tempo di esecuzione. Tuttavia, questo permette al compilatore C di vedere il codice nel blocco condizionale e verificarne la correttezza (sintassi, tipi, riferimenti ai simboli, eccetera). Quindi dovete comunque utilizzare #ifdef se il codice nel blocco condizionale esiste solo quando la condizione Ã¨ soddisfatta.”…””}”(hjàhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh M§hjvhžhubh¨)”}”(hŒªAlla fine di un blocco corposo di #if o #ifdef (piÃ¹ di alcune linee), mettete un commento sulla stessa riga di #endif, annotando la condizione che termina. Per esempio:”h]”hŒªAlla fine di un blocco corposo di #if o #ifdef (piÃ¹ di alcune linee), mettete un commento sulla stessa riga di #endif, annotando la condizione che termina. Per esempio:”…””}”(hjîhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh M¯hjvhžhubjx)”}”(hŒ9#ifdef CONFIG_SOMETHING ... #endif /* CONFIG_SOMETHING */”h]”hŒ9#ifdef CONFIG_SOMETHING ... #endif /* CONFIG_SOMETHING */”…””}”hjüsbah}”(h]”h ]”h"]”h$]”h&]”j‡jˆj‰‰jŠj‹jŒ}”uh1jwhŸjh M³hjvhžhubeh}”(h]”Œcompilazione-sotto-condizione”ah ]”h"]”Œ!21) compilazione sotto condizione”ah$]”h&]”uh1j•hj—hžhhŸjh Mˆubj–)”}”(hhh]”(j›)”}”(hŒAppendice I) riferimenti”h]”hŒAppendice I) riferimenti”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jšhjhžhhŸjh Mºubh¨)”}”(hŒ¬The C Programming Language, Second Edition by Brian W. Kernighan and Dennis M. Ritchie. Prentice Hall, Inc., 1988. ISBN 0-13-110362-8 (paperback), 0-13-110370-9 (hardback).”h]”hŒ¬The C Programming Language, Second Edition by Brian W. Kernighan and Dennis M. Ritchie. Prentice Hall, Inc., 1988. ISBN 0-13-110362-8 (paperback), 0-13-110370-9 (hardback).”…””}”(hj$hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh M¼hjhžhubh¨)”}”(hŒoThe Practice of Programming by Brian W. Kernighan and Rob Pike. Addison-Wesley, Inc., 1999. ISBN 0-201-61586-X.”h]”hŒoThe Practice of Programming by Brian W. Kernighan and Rob Pike. Addison-Wesley, Inc., 1999. ISBN 0-201-61586-X.”…””}”(hj2hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh MÁhjhžhubh¨)”}”(hŒManuali GNU - nei casi in cui sono compatibili con K&R e questo documento - per indent, cpp, gcc e i suoi dettagli interni, tutto disponibile qui https://www.gnu.org/manual/”h]”(hŒ’Manuali GNU - nei casi in cui sono compatibili con K&R e questo documento - per indent, cpp, gcc e i suoi dettagli interni, tutto disponibile qui ”…””}”(hj@hžhhŸNh NubjZ)”}”(hŒhttps://www.gnu.org/manual/”h]”hŒhttps://www.gnu.org/manual/”…””}”(hjHhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”jJuh1jYhj@ubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh MÆhjhžhubh¨)”}”(hŒxWG14 Ã¨ il gruppo internazionale di standardizzazione per il linguaggio C, URL: https://www.open-std.org/JTC1/SC22/WG14/”h]”(hŒPWG14 Ã¨ il gruppo internazionale di standardizzazione per il linguaggio C, URL: ”…””}”(hj]hžhhŸNh NubjZ)”}”(hŒ(https://www.open-std.org/JTC1/SC22/WG14/”h]”hŒ(https://www.open-std.org/JTC1/SC22/WG14/”…””}”(hjehžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”jguh1jYhj]ubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh MÊhjhžhubh¨)”}”(hŒzKernel CodingStyle, by greg@kroah.com at OLS 2002: http://www.kroah.com/linux/talks/ols_2002_kernel_codingstyle_talk/html/”h]”(hŒKernel CodingStyle, by ”…””}”(hjzhžhhŸNh NubjZ)”}”(hŒgreg@kroah.com”h]”hŒgreg@kroah.com”…””}”(hj‚hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œmailto:greg@kroah.com”uh1jYhjzubhŒ at OLS 2002: ”…””}”(hjzhžhhŸNh NubjZ)”}”(hŒGhttp://www.kroah.com/linux/talks/ols_2002_kernel_codingstyle_talk/html/”h]”hŒGhttp://www.kroah.com/linux/talks/ols_2002_kernel_codingstyle_talk/html/”…””}”(hj–hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”j˜uh1jYhjzubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸjh MÍhjhžhubeh}”(h]”Œappendice-i-riferimenti”ah ]”h"]”Œappendice i) riferimenti”ah$]”h&]”uh1j•hj—hžhhŸjh Mºubeh}”(h]”(Œ$stile-del-codice-per-il-kernel-linux”j”eh ]”h"]”(Œ$stile del codice per il kernel linux”Œit_codingstyle”eh$]”h&]”uh1j•hhhžhhŸjh K Œexpect_referenced_by_name”}”j¹j‰sŒexpect_referenced_by_id”}”j”j‰subeh}”(h]”h ]”h"]”h$]”h&]”Œsource”juh1hŒcurrent_source”NŒcurrent_line”NŒsettings”Œdocutils.frontend”ŒValues”“”)”}”(jšNŒ generator”NŒ datestamp”NŒsource_link”NŒ source_url”NŒ toc_backlinks”Œentry”Œfootnote_backlinks”KŒ sectnum_xform”KŒstrip_comments”NŒstrip_elements_with_classes”NŒ strip_classes”NŒreport_level”KŒ halt_level”KŒexit_status_level”KŒdebug”NŒwarning_stream”NŒ traceback”ˆŒinput_encoding”Œ utf-8-sig”Œinput_encoding_error_handler”Œstrict”Œoutput_encoding”Œutf-8”Œoutput_encoding_error_handler”jãŒerror_encoding”Œutf-8”Œerror_encoding_error_handler”Œbackslashreplace”Œ language_code”Œen”Œrecord_dependencies”NŒconfig”NŒ id_prefix”hŒauto_id_prefix”Œid”Œ dump_settings”NŒdump_internals”NŒdump_transforms”NŒdump_pseudo_xml”NŒexpose_internals”NŒstrict_visitor”NŒ_disable_config”NŒ_source”jŒ_destination”NŒ _config_files”]”Œ7/var/lib/git/docbuild/linux/Documentation/docutils.conf”aŒfile_insertion_enabled”ˆŒraw_enabled”KŒline_length_limit”M'Œpep_references”NŒpep_base_url”Œhttps://peps.python.org/”Œpep_file_url_template”Œpep-%04d”Œrfc_references”NŒrfc_base_url”Œ&https://datatracker.ietf.org/doc/html/”Œ tab_width”KŒtrim_footnote_reference_space”‰Œsyntax_highlight”Œlong”Œsmart_quotes”ˆŒsmartquotes_locales”]”Œcharacter_level_inline_markup”‰Œdoctitle_xform”‰Œ docinfo_xform”KŒsectsubtitle_xform”‰Œ image_loading”Œlink”Œembed_stylesheet”‰Œcloak_email_addresses”ˆŒsection_self_link”‰Œenv”NubŒreporter”NŒindirect_targets”]”Œsubstitution_defs”}”Œsubstitution_names”}”Œrefnames”}”Œrefids”}”j”]”j‰asŒnameids”}”(j¹j”j¸jµjjjj~jÂj¿jºj·jãjàjjjjjÿ jü jàjÝj¥j¢jIjFjÅjÂj6j3jjjÊjÇjmjjjUjRjœj™j-j*jÌjÉj-j*j«j¨jsjpjj j°juŒ nametypes”}”(j¹ˆj¸‰j‰j‰jÂ‰jº‰jã‰j‰j‰jÿ ‰jàˆj¥‰jI‰jÅ‰j6‰j‰jÊ‰jm‰jU‰jœ‰j-‰jÌ‰j-‰j«‰js‰j‰j°‰uh}”(j”j—jµj—jjèj~jj¿j„j·jjàjÅjjæjjjü j~jÝj×j¢j jFj¨jÂjLj3jÈjj9jÇjjjjÍjRjpj™jXj*jŸjÉj0j*jÏj¨j0jpj®j jvjjuŒ footnote_refs”}”Œ citation_refs”}”Œ autofootnotes”]”Œautofootnote_refs”]”Œsymbol_footnotes”]”Œsymbol_footnote_refs”]”Œ footnotes”]”Œ citations”]”Œautofootnote_start”KŒsymbol_footnote_start”KŒ id_counter”Œcollections”ŒCounter”“”}”…”R”Œparse_messages”]”hŒsystem_message”“”)”}”(hhh]”h¨)”}”(hŒ:Enumerated list start value not ordinal-1: "2" (ordinal 2)”h]”hŒ>Enumerated list start value not ordinal-1: â€œ2â€ (ordinal 2)”…””}”(hjKhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hjHubah}”(h]”h ]”h"]”h$]”h&]”Œlevel”KŒtype”ŒINFO”Œsource”jŒline”K uh1jFhjhžhhŸjh MYubaŒtransform_messages”]”jG)”}”(hhh]”h¨)”}”(hhh]”hŒ4Hyperlink target "it-codingstyle" is not referenced.”…””}”hjisbah}”(h]”h ]”h"]”h$]”h&]”uh1h§hjfubah}”(h]”h ]”h"]”h$]”h&]”Œlevel”KŒtype”jaŒsource”jŒline”Kuh1jFubaŒtransformer”NŒinclude_log”]”Œ9Documentation/translations/it_IT/process/coding-style.rst”(NNNNt”†”aŒ decoration”Nhžhub.