€•Bè      Œsphinx.addnodes”Œdocument”“”)”}”(Œ	rawsource”Œ ”Œchildren”]”(Œtranslations”ŒLanguagesNode”“”)”}”(hhh]”(h Œpending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒEnglish”…””}”Œparent”hsbaŒ
attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ	refdomain”Œstd”Œreftype”Œdoc”Œ	reftarget”Œ/process/botching-up-ioctls”Œmodname”NŒ	classname”NŒrefexplicit”ˆuŒtagname”hhhubh)”}”(hhh]”hŒChinese (Simplified)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ./translations/zh_CN/process/botching-up-ioctls”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ./translations/zh_TW/process/botching-up-ioctls”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ./translations/ja_JP/process/botching-up-ioctls”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ./translations/ko_KR/process/botching-up-ioctls”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒSpanish”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ./translations/sp_SP/process/botching-up-ioctls”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubeh}”(h]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒItalian”uh1h
hhŒ	_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 <it_disclaimer>`.”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 <it_disclaimer>`.”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 ”…””}”(hh©hžhhŸNh Nubh)”}”(hŒ!:ref:`avvertenze <it_disclaimer>`”h]”hŒinline”“”)”}”(hh³h]”hŒ
avvertenze”…””}”(hh·hžhhŸNh Nubah}”(h]”h ]”(Œxref”Œstd”Œstd-ref”eh"]”h$]”h&]”uh1hµhh±ubah}”(h]”h ]”h"]”h$]”h&]”Œrefdoc”Œ-translations/it_IT/process/botching-up-ioctls”Œ	refdomain”hÂŒreftype”Œref”Œrefexplicit”ˆŒrefwarn”ˆŒ	reftarget”Œit_disclaimer”uh1hhŸŒ3Documentation/translations/it_IT/disclaimer-ita.rst”h Khh©ubhŒ.”…””}”(hh©hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸhÖh Khh£ubah}”(h]”h ]”h"]”h$]”h&]”uh1h¡hhhžhhŸhÖh NubhŒ
field_list”“”)”}”(hhh]”hŒfield”“”)”}”(hhh]”(hŒ
field_name”“”)”}”(hŒOriginal”h]”hŒOriginal”…””}”(hhóhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hñhhîhŸŒ[/var/lib/git/docbuild/linux/Documentation/translations/it_IT/process/botching-up-ioctls.rst”h K ubhŒ
field_body”“”)”}”(hŒ-Documentation/process/botching-up-ioctls.rst
”h]”h¨)”}”(hŒ,Documentation/process/botching-up-ioctls.rst”h]”hŒ,Documentation/process/botching-up-ioctls.rst”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸj  h Khj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hhîubeh}”(h]”h ]”h"]”h$]”h&]”uh1hìhŸj  h Khhéhžhubah}”(h]”h ]”h"]”h$]”h&]”uh1hçhhhžhhŸj  h KubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒ*(Come evitare di) Raffazzonare delle ioctl”h]”hŒ*(Come evitare di) Raffazzonare delle ioctl”…””}”(hj/  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j-  hj*  hžhhŸj  h Kubh¨)”}”(hŒ?Preso da: https://blog.ffwll.ch/2013/11/botching-up-ioctls.html”h]”(hŒ
Preso da: ”…””}”(hj=  hžhhŸNh NubhŒ	reference”“”)”}”(hŒ5https://blog.ffwll.ch/2013/11/botching-up-ioctls.html”h]”hŒ5https://blog.ffwll.ch/2013/11/botching-up-ioctls.html”…””}”(hjG  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”jI  uh1jE  hj=  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸj  h K	hj*  hžhubh¨)”}”(hŒ?Scritto da : Daniel Vetter, Copyright Â© 2013 Intel Corporation”h]”hŒ?Scritto da : Daniel Vetter, Copyright Â© 2013 Intel Corporation”…””}”(hj\  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸj  h Khj*  hžhubh¨)”}”(hX  Una cosa che gli sviluppatori del sottosistema grafico del kernel Linux hanno
imparato negli ultimi anni Ã¨ l'inutilitÃ  di cercare di creare un'interfaccia
unificata per gestire la memoria e le unitÃ  esecutive di diverse GPU. Dunque,
oggigiorno ogni driver ha il suo insieme di ioctl per allocare memoria ed
inviare dei programmi alla GPU. Il che Ã¨ va bene dato che non c'Ã¨ piÃ¹ un insano
sistema che finge di essere generico, ma al suo posto ci sono interfacce
dedicate. Ma al tempo stesso Ã¨ piÃ¹ facile incasinare le cose.”h]”hX  Una cosa che gli sviluppatori del sottosistema grafico del kernel Linux hanno
imparato negli ultimi anni Ã¨ lâ€™inutilitÃ  di cercare di creare unâ€™interfaccia
unificata per gestire la memoria e le unitÃ  esecutive di diverse GPU. Dunque,
oggigiorno ogni driver ha il suo insieme di ioctl per allocare memoria ed
inviare dei programmi alla GPU. Il che Ã¨ va bene dato che non câ€™Ã¨ piÃ¹ un insano
sistema che finge di essere generico, ma al suo posto ci sono interfacce
dedicate. Ma al tempo stesso Ã¨ piÃ¹ facile incasinare le cose.”…””}”(hjj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸj  h Khj*  hžhubh¨)”}”(hXŸ  Per evitare di ripetere gli stessi errori ho preso nota delle lezioni imparate
mentre raffazzonavo il driver drm/i915. La maggior parte di queste lezioni si
focalizzano sui tecnicismi e non sulla visione d'insieme, come le discussioni
riguardo al modo migliore per implementare una ioctl per inviare compiti alla
GPU. Probabilmente, ogni sviluppatore di driver per GPU dovrebbe imparare queste
lezioni in autonomia.”h]”hX¡  Per evitare di ripetere gli stessi errori ho preso nota delle lezioni imparate
mentre raffazzonavo il driver drm/i915. La maggior parte di queste lezioni si
focalizzano sui tecnicismi e non sulla visione dâ€™insieme, come le discussioni
riguardo al modo migliore per implementare una ioctl per inviare compiti alla
GPU. Probabilmente, ogni sviluppatore di driver per GPU dovrebbe imparare queste
lezioni in autonomia.”…””}”(hjx  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸj  h Khj*  hžhubj)  )”}”(hhh]”(j.  )”}”(hŒPrerequisiti”h]”hŒPrerequisiti”…””}”(hj‰  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j-  hj†  hžhhŸj  h Kubh¨)”}”(hŒ™Prima i prerequisiti. Seguite i seguenti suggerimenti se non volete fallire in
partenza e ritrovarvi ad aggiungere un livello di compatibilitÃ  a 32-bit.”h]”hŒ™Prima i prerequisiti. Seguite i seguenti suggerimenti se non volete fallire in
partenza e ritrovarvi ad aggiungere un livello di compatibilitÃ  a 32-bit.”…””}”(hj—  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸj  h K hj†  hžhubhŒbullet_list”“”)”}”(hhh]”(hŒ	list_item”“”)”}”(hŒ¸Usate solamente interi a lunghezza fissa. Per evitare i conflitti coi tipi
definiti nello spazio utente, il kernel definisce alcuni tipi speciali, come:
``__u32``, ``__s64``. Usateli.
”h]”h¨)”}”(hŒ·Usate solamente interi a lunghezza fissa. Per evitare i conflitti coi tipi
definiti nello spazio utente, il kernel definisce alcuni tipi speciali, come:
``__u32``, ``__s64``. Usateli.”h]”(hŒ™Usate solamente interi a lunghezza fissa. Per evitare i conflitti coi tipi
definiti nello spazio utente, il kernel definisce alcuni tipi speciali, come:
”…””}”(hj°  hžhhŸNh NubhŒliteral”“”)”}”(hŒ	``__u32``”h]”hŒ__u32”…””}”(hjº  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j¸  hj°  ubhŒ, ”…””}”(hj°  hžhhŸNh Nubj¹  )”}”(hŒ	``__s64``”h]”hŒ__s64”…””}”(hjÌ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j¸  hj°  ubhŒ
. Usateli.”…””}”(hj°  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸj  h K#hj¬  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jª  hj§  hžhhŸj  h Nubj«  )”}”(hXD  Allineate tutto alla lunghezza naturale delle piattaforma in uso e riempite
esplicitamente i vuoti. Non necessariamente le piattaforme a 32-bit allineano
i valori a 64-bit rispettandone l'allineamento, ma le piattaforme a 64-bit lo
fanno. Dunque, per farlo correttamente in entrambe i casi dobbiamo sempre
riempire i vuoti.
”h]”h¨)”}”(hXC  Allineate tutto alla lunghezza naturale delle piattaforma in uso e riempite
esplicitamente i vuoti. Non necessariamente le piattaforme a 32-bit allineano
i valori a 64-bit rispettandone l'allineamento, ma le piattaforme a 64-bit lo
fanno. Dunque, per farlo correttamente in entrambe i casi dobbiamo sempre
riempire i vuoti.”h]”hXE  Allineate tutto alla lunghezza naturale delle piattaforma in uso e riempite
esplicitamente i vuoti. Non necessariamente le piattaforme a 32-bit allineano
i valori a 64-bit rispettandone lâ€™allineamento, ma le piattaforme a 64-bit lo
fanno. Dunque, per farlo correttamente in entrambe i casi dobbiamo sempre
riempire i vuoti.”…””}”(hjî  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸj  h K'hjê  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jª  hj§  hžhhŸj  h Nubj«  )”}”(hXr  Se una struttura dati contiene valori a 64-bit, allora fate si che la sua
dimensione sia allineata a 64-bit, altrimenti la sua dimensione varierÃ  su
sistemi a 32-bit e 64-bit. Avere una dimensione differente causa problemi
quando si passano vettori di strutture dati al kernel, o quando il kernel
effettua verifiche sulla dimensione (per esempio il sistema drm lo fa).
”h]”h¨)”}”(hXq  Se una struttura dati contiene valori a 64-bit, allora fate si che la sua
dimensione sia allineata a 64-bit, altrimenti la sua dimensione varierÃ  su
sistemi a 32-bit e 64-bit. Avere una dimensione differente causa problemi
quando si passano vettori di strutture dati al kernel, o quando il kernel
effettua verifiche sulla dimensione (per esempio il sistema drm lo fa).”h]”hXq  Se una struttura dati contiene valori a 64-bit, allora fate si che la sua
dimensione sia allineata a 64-bit, altrimenti la sua dimensione varierÃ  su
sistemi a 32-bit e 64-bit. Avere una dimensione differente causa problemi
quando si passano vettori di strutture dati al kernel, o quando il kernel
effettua verifiche sulla dimensione (per esempio il sistema drm lo fa).”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸj  h K-hj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jª  hj§  hžhhŸj  h Nubj«  )”}”(hXË  I puntatori sono di tipo ``__u64``, con un *cast* da/a ``uintptr_t`` da lato
spazio utente e da/a ``void __user *`` nello spazio kernel. Sforzatevi il piÃ¹
possibile per non ritardare la conversione, o peggio maneggiare ``__u64`` nel
vostro codice perchÃ© questo riduce le verifiche che strumenti come sparse
possono effettuare. La macro u64_to_user_ptr() puÃ² essere usata nel kernel
per evitare avvisi riguardo interi e puntatori di dimensioni differenti.

”h]”h¨)”}”(hXÉ  I puntatori sono di tipo ``__u64``, con un *cast* da/a ``uintptr_t`` da lato
spazio utente e da/a ``void __user *`` nello spazio kernel. Sforzatevi il piÃ¹
possibile per non ritardare la conversione, o peggio maneggiare ``__u64`` nel
vostro codice perchÃ© questo riduce le verifiche che strumenti come sparse
possono effettuare. La macro u64_to_user_ptr() puÃ² essere usata nel kernel
per evitare avvisi riguardo interi e puntatori di dimensioni differenti.”h]”(hŒI puntatori sono di tipo ”…””}”(hj  hžhhŸNh Nubj¹  )”}”(hŒ	``__u64``”h]”hŒ__u64”…””}”(hj&  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j¸  hj  ubhŒ	, con un ”…””}”(hj  hžhhŸNh NubhŒemphasis”“”)”}”(hŒ*cast*”h]”hŒcast”…””}”(hj:  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j8  hj  ubhŒ da/a ”…””}”(hj  hžhhŸNh Nubj¹  )”}”(hŒ``uintptr_t``”h]”hŒ	uintptr_t”…””}”(hjL  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j¸  hj  ubhŒ da lato
spazio utente e da/a ”…””}”(hj  hžhhŸNh Nubj¹  )”}”(hŒ``void __user *``”h]”hŒvoid __user *”…””}”(hj^  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j¸  hj  ubhŒi nello spazio kernel. Sforzatevi il piÃ¹
possibile per non ritardare la conversione, o peggio maneggiare ”…””}”(hj  hžhhŸNh Nubj¹  )”}”(hŒ	``__u64``”h]”hŒ__u64”…””}”(hjp  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j¸  hj  ubhŒä nel
vostro codice perchÃ© questo riduce le verifiche che strumenti come sparse
possono effettuare. La macro u64_to_user_ptr() puÃ² essere usata nel kernel
per evitare avvisi riguardo interi e puntatori di dimensioni differenti.”…””}”(hj  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸj  h K3hj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jª  hj§  hžhhŸj  h Nubeh}”(h]”h ]”h"]”h$]”h&]”Œbullet”Œ*”uh1j¥  hŸj  h K#hj†  hžhubeh}”(h]”Œprerequisiti”ah ]”h"]”Œprerequisiti”ah$]”h&]”uh1j(  hj*  hžhhŸj  h Kubj)  )”}”(hhh]”(j.  )”}”(hŒLe Basi”h]”hŒLe Basi”…””}”(hj¡  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j-  hjž  hžhhŸj  h K<ubh¨)”}”(hX;  Con la gioia d'aver evitato un livello di compatibilitÃ , possiamo ora dare uno
sguardo alle basi. Trascurare questi punti renderÃ  difficile la gestione della
compatibilitÃ  all'indietro ed in avanti. E dato che sbagliare al primo colpo Ã¨
garantito, dovrete rivisitare il codice o estenderlo per ogni interfaccia.”h]”hX?  Con la gioia dâ€™aver evitato un livello di compatibilitÃ , possiamo ora dare uno
sguardo alle basi. Trascurare questi punti renderÃ  difficile la gestione della
compatibilitÃ  allâ€™indietro ed in avanti. E dato che sbagliare al primo colpo Ã¨
garantito, dovrete rivisitare il codice o estenderlo per ogni interfaccia.”…””}”(hj¯  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸj  h K>hjž  hžhubj¦  )”}”(hhh]”(j«  )”}”(hXà  Abbiate un modo chiaro per capire dallo spazio utente se una nuova ioctl, o
l'estensione di una esistente, sia supportata dal kernel in esecuzione. Se non
potete fidarvi del fatto che un vecchio kernel possa rifiutare correttamente
un nuovo *flag*, modalitÃ , o ioctl, (probabilmente perchÃ© avevate raffazzonato
qualcosa nel passato) allora dovrete implementare nel driver un meccanismo per
notificare quali funzionalitÃ  sono supportate, o in alternativa un numero di
versione.
”h]”h¨)”}”(hXß  Abbiate un modo chiaro per capire dallo spazio utente se una nuova ioctl, o
l'estensione di una esistente, sia supportata dal kernel in esecuzione. Se non
potete fidarvi del fatto che un vecchio kernel possa rifiutare correttamente
un nuovo *flag*, modalitÃ , o ioctl, (probabilmente perchÃ© avevate raffazzonato
qualcosa nel passato) allora dovrete implementare nel driver un meccanismo per
notificare quali funzionalitÃ  sono supportate, o in alternativa un numero di
versione.”h]”(hŒóAbbiate un modo chiaro per capire dallo spazio utente se una nuova ioctl, o
lâ€™estensione di una esistente, sia supportata dal kernel in esecuzione. Se non
potete fidarvi del fatto che un vecchio kernel possa rifiutare correttamente
un nuovo ”…””}”(hjÄ  hžhhŸNh Nubj9  )”}”(hŒ*flag*”h]”hŒflag”…””}”(hjÌ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j8  hjÄ  ubhŒè, modalitÃ , o ioctl, (probabilmente perchÃ© avevate raffazzonato
qualcosa nel passato) allora dovrete implementare nel driver un meccanismo per
notificare quali funzionalitÃ  sono supportate, o in alternativa un numero di
versione.”…””}”(hjÄ  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸj  h KChjÀ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jª  hj½  hžhhŸj  h Nubj«  )”}”(hXë  Abbiate un piano per estendere le ioctl con nuovi *flag* o campi alla fine di
una struttura dati. Il sistema drm verifica la dimensione di ogni ioctl in
arrivo, ed estende con zeri ogni incongruenza fra kernel e spazio utente.
Questo aiuta, ma non Ã¨ una soluzione completa dato che uno spazio utente nuovo
su un kernel vecchio non noterebbe che i campi nuovi alla fine della struttura
vengono ignorati. Dunque, anche questo avrÃ  bisogno di essere notificato dal
driver allo spazio utente.
”h]”h¨)”}”(hXê  Abbiate un piano per estendere le ioctl con nuovi *flag* o campi alla fine di
una struttura dati. Il sistema drm verifica la dimensione di ogni ioctl in
arrivo, ed estende con zeri ogni incongruenza fra kernel e spazio utente.
Questo aiuta, ma non Ã¨ una soluzione completa dato che uno spazio utente nuovo
su un kernel vecchio non noterebbe che i campi nuovi alla fine della struttura
vengono ignorati. Dunque, anche questo avrÃ  bisogno di essere notificato dal
driver allo spazio utente.”h]”(hŒ2Abbiate un piano per estendere le ioctl con nuovi ”…””}”(hjî  hžhhŸNh Nubj9  )”}”(hŒ*flag*”h]”hŒflag”…””}”(hjö  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j8  hjî  ubhX²   o campi alla fine di
una struttura dati. Il sistema drm verifica la dimensione di ogni ioctl in
arrivo, ed estende con zeri ogni incongruenza fra kernel e spazio utente.
Questo aiuta, ma non Ã¨ una soluzione completa dato che uno spazio utente nuovo
su un kernel vecchio non noterebbe che i campi nuovi alla fine della struttura
vengono ignorati. Dunque, anche questo avrÃ  bisogno di essere notificato dal
driver allo spazio utente.”…””}”(hjî  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸj  h KKhjê  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jª  hj½  hžhhŸj  h Nubj«  )”}”(hXZ  Verificate tutti i campi e *flag* inutilizzati ed i riempimenti siano a 0,
altrimenti rifiutare la ioctl. Se non lo fate il vostro bel piano per
estendere le ioctl andrÃ  a rotoli dato che qualcuno userÃ  delle ioctl con
strutture dati con valori casuali dallo stack nei campi inutilizzati. Il che
si traduce nell'avere questi campi nell'ABI, e la cui unica utilitÃ  sarÃ 
quella di contenere spazzatura. Per questo dovrete esplicitamente riempire i
vuoti di tutte le vostre strutture dati, anche se non le userete in un
vettore. Il riempimento fatto dal compilatore potrebbe contenere valori
casuali.
”h]”h¨)”}”(hXY  Verificate tutti i campi e *flag* inutilizzati ed i riempimenti siano a 0,
altrimenti rifiutare la ioctl. Se non lo fate il vostro bel piano per
estendere le ioctl andrÃ  a rotoli dato che qualcuno userÃ  delle ioctl con
strutture dati con valori casuali dallo stack nei campi inutilizzati. Il che
si traduce nell'avere questi campi nell'ABI, e la cui unica utilitÃ  sarÃ 
quella di contenere spazzatura. Per questo dovrete esplicitamente riempire i
vuoti di tutte le vostre strutture dati, anche se non le userete in un
vettore. Il riempimento fatto dal compilatore potrebbe contenere valori
casuali.”h]”(hŒVerificate tutti i campi e ”…””}”(hj  hžhhŸNh Nubj9  )”}”(hŒ*flag*”h]”hŒflag”…””}”(hj   hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j8  hj  ubhX<   inutilizzati ed i riempimenti siano a 0,
altrimenti rifiutare la ioctl. Se non lo fate il vostro bel piano per
estendere le ioctl andrÃ  a rotoli dato che qualcuno userÃ  delle ioctl con
strutture dati con valori casuali dallo stack nei campi inutilizzati. Il che
si traduce nellâ€™avere questi campi nellâ€™ABI, e la cui unica utilitÃ  sarÃ 
quella di contenere spazzatura. Per questo dovrete esplicitamente riempire i
vuoti di tutte le vostre strutture dati, anche se non le userete in un
vettore. Il riempimento fatto dal compilatore potrebbe contenere valori
casuali.”…””}”(hj  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸj  h KShj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jª  hj½  hžhhŸj  h Nubj«  )”}”(hŒEAbbiate un semplice codice di test per ognuno dei casi sopracitati.

”h]”h¨)”}”(hŒCAbbiate un semplice codice di test per ognuno dei casi sopracitati.”h]”hŒCAbbiate un semplice codice di test per ognuno dei casi sopracitati.”…””}”(hjB  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸj  h K]hj>  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jª  hj½  hžhhŸj  h Nubeh}”(h]”h ]”h"]”h$]”h&]”j”  j•  uh1j¥  hŸj  h KChjž  hžhubeh}”(h]”Œle-basi”ah ]”h"]”Œle basi”ah$]”h&]”uh1j(  hj*  hžhhŸj  h K<ubj)  )”}”(hhh]”(j.  )”}”(hŒ Divertirsi coi percorsi d'errore”h]”hŒ"Divertirsi coi percorsi dâ€™errore”…””}”(hjg  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j-  hjd  hžhhŸj  h Kaubh¨)”}”(hX$  Oggigiorno non ci sono piÃ¹ scuse rimaste per permettere ai driver drm di essere
sfruttati per diventare root. Questo significa che dobbiamo avere una completa
validazione degli input e gestire in modo robusto i percorsi - tanto le GPU
moriranno comunque nel piÃ¹ strano dei casi particolari:”h]”hX$  Oggigiorno non ci sono piÃ¹ scuse rimaste per permettere ai driver drm di essere
sfruttati per diventare root. Questo significa che dobbiamo avere una completa
validazione degli input e gestire in modo robusto i percorsi - tanto le GPU
moriranno comunque nel piÃ¹ strano dei casi particolari:”…””}”(hju  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸj  h Kchjd  hžhubhŒblock_quote”“”)”}”(hX	  * Le ioctl devono verificare l'overflow dei vettori. Inoltre, per i valori
  interi si devono verificare *overflow*, *underflow*, e *clamping*. Il
  classico esempio Ã¨ l'inserimento direttamente nell'hardware di valori di
  posizionamento di un'immagine *sprite* quando l'hardware supporta giusto 12
  bit, o qualcosa del genere. Tutto funzionerÃ  finchÃ© qualche strano *display
  server* non decide di preoccuparsi lui stesso del *clamping* e il cursore
  farÃ  il giro dello schermo.

* Avere un test semplice per ogni possibile fallimento della vostra ioctl.
  Verificate che il codice di errore rispetti le aspettative. Ed infine,
  assicuratevi che verifichiate un solo percorso sbagliato per ogni sotto-test
  inviando comunque dati corretti. Senza questo, verifiche precedenti
  potrebbero rigettare la ioctl troppo presto, impedendo l'esecuzione del
  codice che si voleva effettivamente verificare, rischiando quindi di
  mascherare bachi e regressioni.

* Fate si che tutte le vostre ioctl siano rieseguibili. Prima di tutto X adora
  i segnali; secondo questo vi permetterÃ  di verificare il 90% dei percorsi
  d'errore interrompendo i vostri test con dei segnali. Grazie all'amore di X
  per i segnali, otterrete gratuitamente un eccellente copertura di base per
  tutti i vostri percorsi d'errore. Inoltre, siate consistenti sul modo di
  gestire la riesecuzione delle ioctl - per esempio, drm ha una piccola
  funzione di supporto `drmIoctl` nella sua librerie in spazio utente. Il
  driver i915 l'abbozza con l'ioctl `set_tiling`, ed ora siamo inchiodati per
  sempre con una semantica arcana sia nel kernel che nello spazio utente.


* Se non potete rendere un pezzo di codice rieseguibile, almeno rendete
  possibile la sua interruzione. Le GPU moriranno e i vostri utenti non vi
  apprezzeranno affatto se tenete in ostaggio il loro scatolotto (mediante un
  processo X insopprimibile). Se anche recuperare lo stato Ã¨ troppo complicato,
  allora implementate una scadenza oppure come ultima spiaggia una rete di
  sicurezza per rilevare situazioni di stallo quando l'hardware da di matto.

* Preparate dei test riguardo ai casi particolarmente estremi nel codice di
  recupero del sistema - Ã¨ troppo facile create uno stallo fra il vostro codice
  anti-stallo e un processo scrittore.

”h]”j¦  )”}”(hhh]”(j«  )”}”(hXÚ  Le ioctl devono verificare l'overflow dei vettori. Inoltre, per i valori
interi si devono verificare *overflow*, *underflow*, e *clamping*. Il
classico esempio Ã¨ l'inserimento direttamente nell'hardware di valori di
posizionamento di un'immagine *sprite* quando l'hardware supporta giusto 12
bit, o qualcosa del genere. Tutto funzionerÃ  finchÃ© qualche strano *display
server* non decide di preoccuparsi lui stesso del *clamping* e il cursore
farÃ  il giro dello schermo.
”h]”h¨)”}”(hXÙ  Le ioctl devono verificare l'overflow dei vettori. Inoltre, per i valori
interi si devono verificare *overflow*, *underflow*, e *clamping*. Il
classico esempio Ã¨ l'inserimento direttamente nell'hardware di valori di
posizionamento di un'immagine *sprite* quando l'hardware supporta giusto 12
bit, o qualcosa del genere. Tutto funzionerÃ  finchÃ© qualche strano *display
server* non decide di preoccuparsi lui stesso del *clamping* e il cursore
farÃ  il giro dello schermo.”h]”(hŒgLe ioctl devono verificare lâ€™overflow dei vettori. Inoltre, per i valori
interi si devono verificare ”…””}”(hj  hžhhŸNh Nubj9  )”}”(hŒ
*overflow*”h]”hŒoverflow”…””}”(hj˜  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j8  hj  ubhŒ, ”…””}”(hj  hžhhŸNh Nubj9  )”}”(hŒ*underflow*”h]”hŒ	underflow”…””}”(hjª  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j8  hj  ubhŒ, e ”…””}”(hj  hžhhŸNh Nubj9  )”}”(hŒ
*clamping*”h]”hŒclamping”…””}”(hj¼  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j8  hj  ubhŒs. Il
classico esempio Ã¨ lâ€™inserimento direttamente nellâ€™hardware di valori di
posizionamento di unâ€™immagine ”…””}”(hj  hžhhŸNh Nubj9  )”}”(hŒ*sprite*”h]”hŒsprite”…””}”(hjÎ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j8  hj  ubhŒm quando lâ€™hardware supporta giusto 12
bit, o qualcosa del genere. Tutto funzionerÃ  finchÃ© qualche strano ”…””}”(hj  hžhhŸNh Nubj9  )”}”(hŒ*display
server*”h]”hŒdisplay
server”…””}”(hjà  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j8  hj  ubhŒ+ non decide di preoccuparsi lui stesso del ”…””}”(hj  hžhhŸNh Nubj9  )”}”(hŒ
*clamping*”h]”hŒclamping”…””}”(hjò  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j8  hj  ubhŒ* e il cursore
farÃ  il giro dello schermo.”…””}”(hj  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸj  h KhhjŒ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jª  hj‰  ubj«  )”}”(hXÎ  Avere un test semplice per ogni possibile fallimento della vostra ioctl.
Verificate che il codice di errore rispetti le aspettative. Ed infine,
assicuratevi che verifichiate un solo percorso sbagliato per ogni sotto-test
inviando comunque dati corretti. Senza questo, verifiche precedenti
potrebbero rigettare la ioctl troppo presto, impedendo l'esecuzione del
codice che si voleva effettivamente verificare, rischiando quindi di
mascherare bachi e regressioni.
”h]”h¨)”}”(hXÍ  Avere un test semplice per ogni possibile fallimento della vostra ioctl.
Verificate che il codice di errore rispetti le aspettative. Ed infine,
assicuratevi che verifichiate un solo percorso sbagliato per ogni sotto-test
inviando comunque dati corretti. Senza questo, verifiche precedenti
potrebbero rigettare la ioctl troppo presto, impedendo l'esecuzione del
codice che si voleva effettivamente verificare, rischiando quindi di
mascherare bachi e regressioni.”h]”hXÏ  Avere un test semplice per ogni possibile fallimento della vostra ioctl.
Verificate che il codice di errore rispetti le aspettative. Ed infine,
assicuratevi che verifichiate un solo percorso sbagliato per ogni sotto-test
inviando comunque dati corretti. Senza questo, verifiche precedenti
potrebbero rigettare la ioctl troppo presto, impedendo lâ€™esecuzione del
codice che si voleva effettivamente verificare, rischiando quindi di
mascherare bachi e regressioni.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸj  h Kphj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jª  hj‰  ubj«  )”}”(hX›  Fate si che tutte le vostre ioctl siano rieseguibili. Prima di tutto X adora
i segnali; secondo questo vi permetterÃ  di verificare il 90% dei percorsi
d'errore interrompendo i vostri test con dei segnali. Grazie all'amore di X
per i segnali, otterrete gratuitamente un eccellente copertura di base per
tutti i vostri percorsi d'errore. Inoltre, siate consistenti sul modo di
gestire la riesecuzione delle ioctl - per esempio, drm ha una piccola
funzione di supporto `drmIoctl` nella sua librerie in spazio utente. Il
driver i915 l'abbozza con l'ioctl `set_tiling`, ed ora siamo inchiodati per
sempre con una semantica arcana sia nel kernel che nello spazio utente.

”h]”h¨)”}”(hX™  Fate si che tutte le vostre ioctl siano rieseguibili. Prima di tutto X adora
i segnali; secondo questo vi permetterÃ  di verificare il 90% dei percorsi
d'errore interrompendo i vostri test con dei segnali. Grazie all'amore di X
per i segnali, otterrete gratuitamente un eccellente copertura di base per
tutti i vostri percorsi d'errore. Inoltre, siate consistenti sul modo di
gestire la riesecuzione delle ioctl - per esempio, drm ha una piccola
funzione di supporto `drmIoctl` nella sua librerie in spazio utente. Il
driver i915 l'abbozza con l'ioctl `set_tiling`, ed ora siamo inchiodati per
sempre con una semantica arcana sia nel kernel che nello spazio utente.”h]”(hXÙ  Fate si che tutte le vostre ioctl siano rieseguibili. Prima di tutto X adora
i segnali; secondo questo vi permetterÃ  di verificare il 90% dei percorsi
dâ€™errore interrompendo i vostri test con dei segnali. Grazie allâ€™amore di X
per i segnali, otterrete gratuitamente un eccellente copertura di base per
tutti i vostri percorsi dâ€™errore. Inoltre, siate consistenti sul modo di
gestire la riesecuzione delle ioctl - per esempio, drm ha una piccola
funzione di supporto ”…””}”(hj,  hžhhŸNh NubhŒtitle_reference”“”)”}”(hŒ
`drmIoctl`”h]”hŒdrmIoctl”…””}”(hj6  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j4  hj,  ubhŒO nella sua librerie in spazio utente. Il
driver i915 lâ€™abbozza con lâ€™ioctl ”…””}”(hj,  hžhhŸNh Nubj5  )”}”(hŒ`set_tiling`”h]”hŒ
set_tiling”…””}”(hjH  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j4  hj,  ubhŒe, ed ora siamo inchiodati per
sempre con una semantica arcana sia nel kernel che nello spazio utente.”…””}”(hj,  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸj  h Kxhj(  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jª  hj‰  ubj«  )”}”(hX¾  Se non potete rendere un pezzo di codice rieseguibile, almeno rendete
possibile la sua interruzione. Le GPU moriranno e i vostri utenti non vi
apprezzeranno affatto se tenete in ostaggio il loro scatolotto (mediante un
processo X insopprimibile). Se anche recuperare lo stato Ã¨ troppo complicato,
allora implementate una scadenza oppure come ultima spiaggia una rete di
sicurezza per rilevare situazioni di stallo quando l'hardware da di matto.
”h]”h¨)”}”(hX½  Se non potete rendere un pezzo di codice rieseguibile, almeno rendete
possibile la sua interruzione. Le GPU moriranno e i vostri utenti non vi
apprezzeranno affatto se tenete in ostaggio il loro scatolotto (mediante un
processo X insopprimibile). Se anche recuperare lo stato Ã¨ troppo complicato,
allora implementate una scadenza oppure come ultima spiaggia una rete di
sicurezza per rilevare situazioni di stallo quando l'hardware da di matto.”h]”hX¿  Se non potete rendere un pezzo di codice rieseguibile, almeno rendete
possibile la sua interruzione. Le GPU moriranno e i vostri utenti non vi
apprezzeranno affatto se tenete in ostaggio il loro scatolotto (mediante un
processo X insopprimibile). Se anche recuperare lo stato Ã¨ troppo complicato,
allora implementate una scadenza oppure come ultima spiaggia una rete di
sicurezza per rilevare situazioni di stallo quando lâ€™hardware da di matto.”…””}”(hjj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸj  h Kƒhjf  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jª  hj‰  ubj«  )”}”(hŒ¿Preparate dei test riguardo ai casi particolarmente estremi nel codice di
recupero del sistema - Ã¨ troppo facile create uno stallo fra il vostro codice
anti-stallo e un processo scrittore.

”h]”h¨)”}”(hŒ½Preparate dei test riguardo ai casi particolarmente estremi nel codice di
recupero del sistema - Ã¨ troppo facile create uno stallo fra il vostro codice
anti-stallo e un processo scrittore.”h]”hŒ½Preparate dei test riguardo ai casi particolarmente estremi nel codice di
recupero del sistema - Ã¨ troppo facile create uno stallo fra il vostro codice
anti-stallo e un processo scrittore.”…””}”(hj‚  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸj  h KŠhj~  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jª  hj‰  ubeh}”(h]”h ]”h"]”h$]”h&]”j”  j•  uh1j¥  hŸj  h Khhj…  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jƒ  hŸj  h Khhjd  hžhubeh}”(h]”Œ divertirsi-coi-percorsi-d-errore”ah ]”h"]”Œ divertirsi coi percorsi d'errore”ah$]”h&]”uh1j(  hj*  hžhhŸj  h Kaubj)  )”}”(hhh]”(j.  )”}”(hŒ Tempi, attese e mancate scadenze”h]”hŒ Tempi, attese e mancate scadenze”…””}”(hj­  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j-  hjª  hžhhŸj  h Kubh¨)”}”(hX:  Le GPU fanno quasi tutto in modo asincrono, dunque dobbiamo regolare le
operazioni ed attendere quelle in sospeso. Questo Ã¨ davvero difficile; al
momento nessuna delle ioctl supportante dal driver drm/i915 riesce a farlo
perfettamente, il che significa che qui ci sono ancora una valanga di lezioni da
apprendere.”h]”hX:  Le GPU fanno quasi tutto in modo asincrono, dunque dobbiamo regolare le
operazioni ed attendere quelle in sospeso. Questo Ã¨ davvero difficile; al
momento nessuna delle ioctl supportante dal driver drm/i915 riesce a farlo
perfettamente, il che significa che qui ci sono ancora una valanga di lezioni da
apprendere.”…””}”(hj»  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸj  h K’hjª  hžhubj„  )”}”(hX  * Per fare riferimento al tempo usate sempre ``CLOCK_MONOTONIC``. Oggigiorno
  questo Ã¨ quello che viene usato di base da alsa, drm, e v4l. Tuttavia,
  lasciate allo spazio utente la possibilitÃ  di capire quali *timestamp*
  derivano da domini temporali diversi come il vostro orologio di sistema
  (fornito dal kernel) oppure un contatore hardware indipendente da qualche
  parte. Gli orologi divergeranno, ma con questa informazione gli strumenti di
  analisi delle prestazioni possono compensare il problema. Se il vostro spazio
  utente puÃ² ottenere i valori grezzi degli orologi, allora considerate di
  esporre anch'essi.

* Per descrivere il tempo, usate ``__s64`` per i secondi e ``__u64`` per i
  nanosecondi. Non Ã¨ il modo migliore per specificare il tempo, ma Ã¨
  praticamente uno standard.

* Verificate che gli input di valori temporali siano normalizzati, e se non lo
  sono scartateli. Fate attenzione perchÃ© la struttura dati ``struct ktime``
  del kernel usa interi con segni sia per i secondi che per i nanosecondi.

* Per le scadenze (*timeout*) usate valori temporali assoluti. Se siete dei
  bravi ragazzi e avete reso la vostra ioctl rieseguibile, allora i tempi
  relativi tendono ad essere troppo grossolani e a causa degli arrotondamenti
  potrebbero estendere in modo indefinito i tempi di attesa ad ogni
  riesecuzione. Particolarmente vero se il vostro orologio di riferimento Ã¨
  qualcosa di molto lento come il contatore di *frame*. Con la giacca da
  avvocato delle specifiche diremmo che questo non Ã¨ un baco perchÃ© tutte le
  scadenze potrebbero essere estese - ma sicuramente gli utenti vi odieranno
  quando le animazioni singhiozzano.

* Considerate l'idea di eliminare tutte le ioctl sincrone con scadenze, e di
  sostituirle con una versione asincrona il cui stato puÃ² essere consultato
  attraverso il descrittore di file mediante ``poll``. Questo approccio si
  sposa meglio in un applicazione guidata dagli eventi.

* Sviluppate dei test per i casi estremi, specialmente verificate che i valori
  di ritorno per gli eventi giÃ  completati, le attese terminate con successo, e
  le attese scadute abbiano senso e servano ai vostri scopi.

”h]”j¦  )”}”(hhh]”(j«  )”}”(hXe  Per fare riferimento al tempo usate sempre ``CLOCK_MONOTONIC``. Oggigiorno
questo Ã¨ quello che viene usato di base da alsa, drm, e v4l. Tuttavia,
lasciate allo spazio utente la possibilitÃ  di capire quali *timestamp*
derivano da domini temporali diversi come il vostro orologio di sistema
(fornito dal kernel) oppure un contatore hardware indipendente da qualche
parte. Gli orologi divergeranno, ma con questa informazione gli strumenti di
analisi delle prestazioni possono compensare il problema. Se il vostro spazio
utente puÃ² ottenere i valori grezzi degli orologi, allora considerate di
esporre anch'essi.
”h]”h¨)”}”(hXd  Per fare riferimento al tempo usate sempre ``CLOCK_MONOTONIC``. Oggigiorno
questo Ã¨ quello che viene usato di base da alsa, drm, e v4l. Tuttavia,
lasciate allo spazio utente la possibilitÃ  di capire quali *timestamp*
derivano da domini temporali diversi come il vostro orologio di sistema
(fornito dal kernel) oppure un contatore hardware indipendente da qualche
parte. Gli orologi divergeranno, ma con questa informazione gli strumenti di
analisi delle prestazioni possono compensare il problema. Se il vostro spazio
utente puÃ² ottenere i valori grezzi degli orologi, allora considerate di
esporre anch'essi.”h]”(hŒ+Per fare riferimento al tempo usate sempre ”…””}”(hjÔ  hžhhŸNh Nubj¹  )”}”(hŒ``CLOCK_MONOTONIC``”h]”hŒCLOCK_MONOTONIC”…””}”(hjÜ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j¸  hjÔ  ubhŒ‘. Oggigiorno
questo Ã¨ quello che viene usato di base da alsa, drm, e v4l. Tuttavia,
lasciate allo spazio utente la possibilitÃ  di capire quali ”…””}”(hjÔ  hžhhŸNh Nubj9  )”}”(hŒ*timestamp*”h]”hŒ	timestamp”…””}”(hjî  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j8  hjÔ  ubhXŒ  
derivano da domini temporali diversi come il vostro orologio di sistema
(fornito dal kernel) oppure un contatore hardware indipendente da qualche
parte. Gli orologi divergeranno, ma con questa informazione gli strumenti di
analisi delle prestazioni possono compensare il problema. Se il vostro spazio
utente puÃ² ottenere i valori grezzi degli orologi, allora considerate di
esporre anchâ€™essi.”…””}”(hjÔ  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸj  h K˜hjÐ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jª  hjÍ  ubj«  )”}”(hŒ©Per descrivere il tempo, usate ``__s64`` per i secondi e ``__u64`` per i
nanosecondi. Non Ã¨ il modo migliore per specificare il tempo, ma Ã¨
praticamente uno standard.
”h]”h¨)”}”(hŒ¨Per descrivere il tempo, usate ``__s64`` per i secondi e ``__u64`` per i
nanosecondi. Non Ã¨ il modo migliore per specificare il tempo, ma Ã¨
praticamente uno standard.”h]”(hŒPer descrivere il tempo, usate ”…””}”(hj  hžhhŸNh Nubj¹  )”}”(hŒ	``__s64``”h]”hŒ__s64”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j¸  hj  ubhŒ per i secondi e ”…””}”(hj  hžhhŸNh Nubj¹  )”}”(hŒ	``__u64``”h]”hŒ__u64”…””}”(hj*  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j¸  hj  ubhŒf per i
nanosecondi. Non Ã¨ il modo migliore per specificare il tempo, ma Ã¨
praticamente uno standard.”…””}”(hj  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸj  h K¢hj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jª  hjÍ  ubj«  )”}”(hŒâVerificate che gli input di valori temporali siano normalizzati, e se non lo
sono scartateli. Fate attenzione perchÃ© la struttura dati ``struct ktime``
del kernel usa interi con segni sia per i secondi che per i nanosecondi.
”h]”h¨)”}”(hŒáVerificate che gli input di valori temporali siano normalizzati, e se non lo
sono scartateli. Fate attenzione perchÃ© la struttura dati ``struct ktime``
del kernel usa interi con segni sia per i secondi che per i nanosecondi.”h]”(hŒˆVerificate che gli input di valori temporali siano normalizzati, e se non lo
sono scartateli. Fate attenzione perchÃ© la struttura dati ”…””}”(hjL  hžhhŸNh Nubj¹  )”}”(hŒ``struct ktime``”h]”hŒstruct ktime”…””}”(hjT  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j¸  hjL  ubhŒI
del kernel usa interi con segni sia per i secondi che per i nanosecondi.”…””}”(hjL  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸj  h K¦hjH  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jª  hjÍ  ubj«  )”}”(hXm  Per le scadenze (*timeout*) usate valori temporali assoluti. Se siete dei
bravi ragazzi e avete reso la vostra ioctl rieseguibile, allora i tempi
relativi tendono ad essere troppo grossolani e a causa degli arrotondamenti
potrebbero estendere in modo indefinito i tempi di attesa ad ogni
riesecuzione. Particolarmente vero se il vostro orologio di riferimento Ã¨
qualcosa di molto lento come il contatore di *frame*. Con la giacca da
avvocato delle specifiche diremmo che questo non Ã¨ un baco perchÃ© tutte le
scadenze potrebbero essere estese - ma sicuramente gli utenti vi odieranno
quando le animazioni singhiozzano.
”h]”h¨)”}”(hXl  Per le scadenze (*timeout*) usate valori temporali assoluti. Se siete dei
bravi ragazzi e avete reso la vostra ioctl rieseguibile, allora i tempi
relativi tendono ad essere troppo grossolani e a causa degli arrotondamenti
potrebbero estendere in modo indefinito i tempi di attesa ad ogni
riesecuzione. Particolarmente vero se il vostro orologio di riferimento Ã¨
qualcosa di molto lento come il contatore di *frame*. Con la giacca da
avvocato delle specifiche diremmo che questo non Ã¨ un baco perchÃ© tutte le
scadenze potrebbero essere estese - ma sicuramente gli utenti vi odieranno
quando le animazioni singhiozzano.”h]”(hŒPer le scadenze (”…””}”(hjv  hžhhŸNh Nubj9  )”}”(hŒ	*timeout*”h]”hŒtimeout”…””}”(hj~  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j8  hjv  ubhX~  ) usate valori temporali assoluti. Se siete dei
bravi ragazzi e avete reso la vostra ioctl rieseguibile, allora i tempi
relativi tendono ad essere troppo grossolani e a causa degli arrotondamenti
potrebbero estendere in modo indefinito i tempi di attesa ad ogni
riesecuzione. Particolarmente vero se il vostro orologio di riferimento Ã¨
qualcosa di molto lento come il contatore di ”…””}”(hjv  hžhhŸNh Nubj9  )”}”(hŒ*frame*”h]”hŒframe”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j8  hjv  ubhŒÍ. Con la giacca da
avvocato delle specifiche diremmo che questo non Ã¨ un baco perchÃ© tutte le
scadenze potrebbero essere estese - ma sicuramente gli utenti vi odieranno
quando le animazioni singhiozzano.”…””}”(hjv  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸj  h Kªhjr  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jª  hjÍ  ubj«  )”}”(hX  Considerate l'idea di eliminare tutte le ioctl sincrone con scadenze, e di
sostituirle con una versione asincrona il cui stato puÃ² essere consultato
attraverso il descrittore di file mediante ``poll``. Questo approccio si
sposa meglio in un applicazione guidata dagli eventi.
”h]”h¨)”}”(hX  Considerate l'idea di eliminare tutte le ioctl sincrone con scadenze, e di
sostituirle con una versione asincrona il cui stato puÃ² essere consultato
attraverso il descrittore di file mediante ``poll``. Questo approccio si
sposa meglio in un applicazione guidata dagli eventi.”h]”(hŒÃConsiderate lâ€™idea di eliminare tutte le ioctl sincrone con scadenze, e di
sostituirle con una versione asincrona il cui stato puÃ² essere consultato
attraverso il descrittore di file mediante ”…””}”(hj²  hžhhŸNh Nubj¹  )”}”(hŒ``poll``”h]”hŒpoll”…””}”(hjº  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j¸  hj²  ubhŒK. Questo approccio si
sposa meglio in un applicazione guidata dagli eventi.”…””}”(hj²  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸj  h K´hj®  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jª  hjÍ  ubj«  )”}”(hŒØSviluppate dei test per i casi estremi, specialmente verificate che i valori
di ritorno per gli eventi giÃ  completati, le attese terminate con successo, e
le attese scadute abbiano senso e servano ai vostri scopi.

”h]”h¨)”}”(hŒÖSviluppate dei test per i casi estremi, specialmente verificate che i valori
di ritorno per gli eventi giÃ  completati, le attese terminate con successo, e
le attese scadute abbiano senso e servano ai vostri scopi.”h]”hŒÖSviluppate dei test per i casi estremi, specialmente verificate che i valori
di ritorno per gli eventi giÃ  completati, le attese terminate con successo, e
le attese scadute abbiano senso e servano ai vostri scopi.”…””}”(hjÜ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸj  h K¹hjØ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jª  hjÍ  ubeh}”(h]”h ]”h"]”h$]”h&]”j”  j•  uh1j¥  hŸj  h K˜hjÉ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jƒ  hŸj  h K˜hjª  hžhubeh}”(h]”Œtempi-attese-e-mancate-scadenze”ah ]”h"]”Œ tempi, attese e mancate scadenze”ah$]”h&]”uh1j(  hj*  hžhhŸj  h Kubj)  )”}”(hhh]”(j.  )”}”(hŒNon perdere risorse”h]”hŒNon perdere risorse”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j-  hj  hžhhŸj  h K¿ubh¨)”}”(hX  Nel suo piccolo il driver drm implementa un sistema operativo specializzato per
certe GPU. Questo significa che il driver deve esporre verso lo spazio
utente tonnellate di agganci per accedere ad oggetti e altre risorse. Farlo
correttamente porterÃ  con se alcune insidie:”h]”hX  Nel suo piccolo il driver drm implementa un sistema operativo specializzato per
certe GPU. Questo significa che il driver deve esporre verso lo spazio
utente tonnellate di agganci per accedere ad oggetti e altre risorse. Farlo
correttamente porterÃ  con se alcune insidie:”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸj  h KÀhj  hžhubj„  )”}”(hXW  * Collegate sempre la vita di una risorsa creata dinamicamente, a quella del
  descrittore di file. Considerate una mappatura 1:1 se la vostra risorsa
  dev'essere condivisa fra processi - passarsi descrittori di file sul socket
  unix semplifica la gestione anche per lo spazio utente.

* Dev'esserci sempre Il supporto ``O_CLOEXEC``.

* Assicuratevi di avere abbastanza isolamento fra utenti diversi. Di base
  impostate uno spazio dei nomi riservato per ogni descrittore di file, il che
  forzerÃ  ogni condivisione ad essere esplicita. Usate uno spazio piÃ¹ globale
  per dispositivo solo se gli oggetti sono effettivamente unici per quel
  dispositivo. Un controesempio viene dall'interfaccia drm modeset, dove
  oggetti specifici di dispositivo, come i connettori, condividono uno spazio
  dei nomi con oggetti per il *framebuffer*, ma questi non sono per niente
  condivisi. Uno spazio separato, privato di base, per i *framebuffer* sarebbe
  stato meglio.

* Pensate all'identificazione univoca degli agganci verso lo spazio utente. Per
  esempio, per la maggior parte dei driver drm, si considera fallace la doppia
  sottomissione di un oggetto allo stesso comando ioctl. Ma per evitarlo, se
  gli oggetti sono condivisibili, lo spazio utente ha bisogno di sapere se il
  driver ha importato un oggetto da un altro processo. Non l'ho ancora provato,
  ma considerate l'idea di usare il numero di inode come identificatore per i
  descrittori di file condivisi - che poi Ã¨ come si distinguono i veri file.
  Sfortunatamente, questo richiederebbe lo sviluppo di un vero e proprio
  filesystem virtuale nel kernel.

”h]”j¦  )”}”(hhh]”(j«  )”}”(hX  Collegate sempre la vita di una risorsa creata dinamicamente, a quella del
descrittore di file. Considerate una mappatura 1:1 se la vostra risorsa
dev'essere condivisa fra processi - passarsi descrittori di file sul socket
unix semplifica la gestione anche per lo spazio utente.
”h]”h¨)”}”(hX  Collegate sempre la vita di una risorsa creata dinamicamente, a quella del
descrittore di file. Considerate una mappatura 1:1 se la vostra risorsa
dev'essere condivisa fra processi - passarsi descrittori di file sul socket
unix semplifica la gestione anche per lo spazio utente.”h]”hX  Collegate sempre la vita di una risorsa creata dinamicamente, a quella del
descrittore di file. Considerate una mappatura 1:1 se la vostra risorsa
devâ€™essere condivisa fra processi - passarsi descrittori di file sul socket
unix semplifica la gestione anche per lo spazio utente.”…””}”(hj.  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸj  h KÅhj*  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jª  hj'  ubj«  )”}”(hŒ.Dev'esserci sempre Il supporto ``O_CLOEXEC``.
”h]”h¨)”}”(hŒ-Dev'esserci sempre Il supporto ``O_CLOEXEC``.”h]”(hŒ!Devâ€™esserci sempre Il supporto ”…””}”(hjF  hžhhŸNh Nubj¹  )”}”(hŒ``O_CLOEXEC``”h]”hŒ	O_CLOEXEC”…””}”(hjN  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j¸  hjF  ubhŒ.”…””}”(hjF  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸj  h KÊhjB  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jª  hj'  ubj«  )”}”(hXa  Assicuratevi di avere abbastanza isolamento fra utenti diversi. Di base
impostate uno spazio dei nomi riservato per ogni descrittore di file, il che
forzerÃ  ogni condivisione ad essere esplicita. Usate uno spazio piÃ¹ globale
per dispositivo solo se gli oggetti sono effettivamente unici per quel
dispositivo. Un controesempio viene dall'interfaccia drm modeset, dove
oggetti specifici di dispositivo, come i connettori, condividono uno spazio
dei nomi con oggetti per il *framebuffer*, ma questi non sono per niente
condivisi. Uno spazio separato, privato di base, per i *framebuffer* sarebbe
stato meglio.
”h]”h¨)”}”(hX`  Assicuratevi di avere abbastanza isolamento fra utenti diversi. Di base
impostate uno spazio dei nomi riservato per ogni descrittore di file, il che
forzerÃ  ogni condivisione ad essere esplicita. Usate uno spazio piÃ¹ globale
per dispositivo solo se gli oggetti sono effettivamente unici per quel
dispositivo. Un controesempio viene dall'interfaccia drm modeset, dove
oggetti specifici di dispositivo, come i connettori, condividono uno spazio
dei nomi con oggetti per il *framebuffer*, ma questi non sono per niente
condivisi. Uno spazio separato, privato di base, per i *framebuffer* sarebbe
stato meglio.”h]”(hXÛ  Assicuratevi di avere abbastanza isolamento fra utenti diversi. Di base
impostate uno spazio dei nomi riservato per ogni descrittore di file, il che
forzerÃ  ogni condivisione ad essere esplicita. Usate uno spazio piÃ¹ globale
per dispositivo solo se gli oggetti sono effettivamente unici per quel
dispositivo. Un controesempio viene dallâ€™interfaccia drm modeset, dove
oggetti specifici di dispositivo, come i connettori, condividono uno spazio
dei nomi con oggetti per il ”…””}”(hjp  hžhhŸNh Nubj9  )”}”(hŒ*framebuffer*”h]”hŒframebuffer”…””}”(hjx  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j8  hjp  ubhŒW, ma questi non sono per niente
condivisi. Uno spazio separato, privato di base, per i ”…””}”(hjp  hžhhŸNh Nubj9  )”}”(hŒ*framebuffer*”h]”hŒframebuffer”…””}”(hjŠ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j8  hjp  ubhŒ sarebbe
stato meglio.”…””}”(hjp  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸj  h KÌhjl  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jª  hj'  ubj«  )”}”(hX€  Pensate all'identificazione univoca degli agganci verso lo spazio utente. Per
esempio, per la maggior parte dei driver drm, si considera fallace la doppia
sottomissione di un oggetto allo stesso comando ioctl. Ma per evitarlo, se
gli oggetti sono condivisibili, lo spazio utente ha bisogno di sapere se il
driver ha importato un oggetto da un altro processo. Non l'ho ancora provato,
ma considerate l'idea di usare il numero di inode come identificatore per i
descrittori di file condivisi - che poi Ã¨ come si distinguono i veri file.
Sfortunatamente, questo richiederebbe lo sviluppo di un vero e proprio
filesystem virtuale nel kernel.

”h]”h¨)”}”(hX~  Pensate all'identificazione univoca degli agganci verso lo spazio utente. Per
esempio, per la maggior parte dei driver drm, si considera fallace la doppia
sottomissione di un oggetto allo stesso comando ioctl. Ma per evitarlo, se
gli oggetti sono condivisibili, lo spazio utente ha bisogno di sapere se il
driver ha importato un oggetto da un altro processo. Non l'ho ancora provato,
ma considerate l'idea di usare il numero di inode come identificatore per i
descrittori di file condivisi - che poi Ã¨ come si distinguono i veri file.
Sfortunatamente, questo richiederebbe lo sviluppo di un vero e proprio
filesystem virtuale nel kernel.”h]”hX„  Pensate allâ€™identificazione univoca degli agganci verso lo spazio utente. Per
esempio, per la maggior parte dei driver drm, si considera fallace la doppia
sottomissione di un oggetto allo stesso comando ioctl. Ma per evitarlo, se
gli oggetti sono condivisibili, lo spazio utente ha bisogno di sapere se il
driver ha importato un oggetto da un altro processo. Non lâ€™ho ancora provato,
ma considerate lâ€™idea di usare il numero di inode come identificatore per i
descrittori di file condivisi - che poi Ã¨ come si distinguono i veri file.
Sfortunatamente, questo richiederebbe lo sviluppo di un vero e proprio
filesystem virtuale nel kernel.”…””}”(hj¬  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸj  h KÖhj¨  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jª  hj'  ubeh}”(h]”h ]”h"]”h$]”h&]”j”  j•  uh1j¥  hŸj  h KÅhj#  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jƒ  hŸj  h KÅhj  hžhubeh}”(h]”Œnon-perdere-risorse”ah ]”h"]”Œnon perdere risorse”ah$]”h&]”uh1j(  hj*  hžhhŸj  h K¿ubj)  )”}”(hhh]”(j.  )”}”(hŒUltimo, ma non meno importante”h]”hŒUltimo, ma non meno importante”…””}”(hj×  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j-  hjÔ  hžhhŸj  h Kâubh¨)”}”(hŒ6Non tutti i problemi si risolvono con una nuova ioctl:”h]”hŒ6Non tutti i problemi si risolvono con una nuova ioctl:”…””}”(hjå  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸj  h KähjÔ  hžhubj¦  )”}”(hhh]”(j«  )”}”(hX¹  Pensateci su due o tre volte prima di implementare un'interfaccia privata per
un driver. Ovviamente Ã¨ molto piÃ¹ veloce seguire questa via piuttosto che
buttarsi in lunghe discussioni alla ricerca di una soluzione piÃ¹ generica. Ed
a volte un'interfaccia privata Ã¨ quello che serve per sviluppare un nuovo
concetto. Ma alla fine, una volta che c'Ã¨ un'interfaccia generica a
disposizione finirete per mantenere due interfacce. Per sempre.
”h]”h¨)”}”(hX¸  Pensateci su due o tre volte prima di implementare un'interfaccia privata per
un driver. Ovviamente Ã¨ molto piÃ¹ veloce seguire questa via piuttosto che
buttarsi in lunghe discussioni alla ricerca di una soluzione piÃ¹ generica. Ed
a volte un'interfaccia privata Ã¨ quello che serve per sviluppare un nuovo
concetto. Ma alla fine, una volta che c'Ã¨ un'interfaccia generica a
disposizione finirete per mantenere due interfacce. Per sempre.”h]”hXÀ  Pensateci su due o tre volte prima di implementare unâ€™interfaccia privata per
un driver. Ovviamente Ã¨ molto piÃ¹ veloce seguire questa via piuttosto che
buttarsi in lunghe discussioni alla ricerca di una soluzione piÃ¹ generica. Ed
a volte unâ€™interfaccia privata Ã¨ quello che serve per sviluppare un nuovo
concetto. Ma alla fine, una volta che câ€™Ã¨ unâ€™interfaccia generica a
disposizione finirete per mantenere due interfacce. Per sempre.”…””}”(hjú  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸj  h Kæhjö  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jª  hjó  hžhhŸj  h Nubj«  )”}”(hXÇ  Considerate interfacce alternative alle ioctl. Gli attributi sysfs sono molto
meglio per impostazioni che sono specifiche di un dispositivo, o per
sotto-oggetti con una vita piuttosto statica (come le uscite dei connettori in
drm con tutti gli attributi per la sovrascrittura delle rilevazioni). O magari
solo il vostro sistema di test ha bisogno di una certa interfaccia, e allora
debugfs (che non ha un'interfaccia stabile) sarÃ  la soluzione migliore.
”h]”h¨)”}”(hXÆ  Considerate interfacce alternative alle ioctl. Gli attributi sysfs sono molto
meglio per impostazioni che sono specifiche di un dispositivo, o per
sotto-oggetti con una vita piuttosto statica (come le uscite dei connettori in
drm con tutti gli attributi per la sovrascrittura delle rilevazioni). O magari
solo il vostro sistema di test ha bisogno di una certa interfaccia, e allora
debugfs (che non ha un'interfaccia stabile) sarÃ  la soluzione migliore.”h]”hXÈ  Considerate interfacce alternative alle ioctl. Gli attributi sysfs sono molto
meglio per impostazioni che sono specifiche di un dispositivo, o per
sotto-oggetti con una vita piuttosto statica (come le uscite dei connettori in
drm con tutti gli attributi per la sovrascrittura delle rilevazioni). O magari
solo il vostro sistema di test ha bisogno di una certa interfaccia, e allora
debugfs (che non ha unâ€™interfaccia stabile) sarÃ  la soluzione migliore.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸj  h Kíhj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jª  hjó  hžhhŸj  h Nubeh}”(h]”h ]”h"]”h$]”h&]”j”  j•  uh1j¥  hŸj  h KæhjÔ  hžhubh¨)”}”(hX—  Per concludere. Questo gioco consiste nel fare le cose giuste fin da subito,
dato che se il vostro driver diventa popolare e la piattaforma hardware longeva
finirete per mantenere le vostre ioctl per sempre. Potrete tentare di deprecare
alcune orribili ioctl, ma ci vorranno anni per riuscirci effettivamente. E
ancora, altri anni prima che sparisca l'ultimo utente capace di lamentarsi per
una regressione.”h]”hX™  Per concludere. Questo gioco consiste nel fare le cose giuste fin da subito,
dato che se il vostro driver diventa popolare e la piattaforma hardware longeva
finirete per mantenere le vostre ioctl per sempre. Potrete tentare di deprecare
alcune orribili ioctl, ma ci vorranno anni per riuscirci effettivamente. E
ancora, altri anni prima che sparisca lâ€™ultimo utente capace di lamentarsi per
una regressione.”…””}”(hj,  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h§hŸj  h KôhjÔ  hžhubeh}”(h]”Œultimo-ma-non-meno-importante”ah ]”h"]”Œultimo, ma non meno importante”ah$]”h&]”uh1j(  hj*  hžhhŸj  h Kâubeh}”(h]”Œ(come-evitare-di-raffazzonare-delle-ioctl”ah ]”h"]”Œ*(come evitare di) raffazzonare delle ioctl”ah$]”h&]”uh1j(  hhhžhhŸj  h Kubeh}”(h]”h ]”h"]”h$]”h&]”Œsource”j  uh1hŒ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”jm  Œ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”}”Œnameids”}”(jG  jD  j›  j˜  ja  j^  j§  j¤  j  jþ  jÑ  jÎ  j?  j<  uŒ	nametypes”}”(jG  ‰j›  ‰ja  ‰j§  ‰j  ‰jÑ  ‰j?  ‰uh}”(jD  j*  j˜  j†  j^  jž  j¤  jd  jþ  jª  jÎ  j  j<  jÔ  uŒ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”]”Œtransform_messages”]”Œtransformer”NŒinclude_log”]”Œ?Documentation/translations/it_IT/process/botching-up-ioctls.rst”(NNNNt”†”aŒ
decoration”Nhžhub.