1.. include:: ../disclaimer-ita.rst
2
3:Original: :ref:`Documentation/process/magic-number.rst <magicnumbers>`
4:Translator: Federico Vaga <federico.vaga@vaga.pv.it>
5
6.. _it_magicnumbers:
7
8I numeri magici di Linux
9========================
10
11Questo documento è un registro dei numeri magici in uso.  Quando
12aggiungete un numero magico ad una struttura, dovreste aggiungerlo anche
13a questo documento; la cosa migliore è che tutti i numeri magici usati
14dalle varie strutture siano unici.
15
16È **davvero** un'ottima idea proteggere le strutture dati del kernel con
17dei numeri magici.  Questo vi permette in fase d'esecuzione di (a) verificare
18se una struttura è stata malmenata, o (b) avete passato a una procedura la
19struttura errata.  Quest'ultimo è molto utile - particolarmente quando si passa
20una struttura dati tramite un puntatore void \*.  Il codice tty, per esempio,
21effettua questa operazione con regolarità passando avanti e indietro le
22strutture specifiche per driver e discipline.
23
24Per utilizzare un numero magico, dovete dichiararlo all'inizio della struttura
25dati, come di seguito::
26
27	struct tty_ldisc {
28		int	magic;
29		...
30	};
31
32Per favore, seguite questa direttiva quando aggiungerete migliorie al kernel!
33Mi ha risparmiato un numero illimitato di ore di debug, specialmente nei casi
34più ostici dove si è andati oltre la dimensione di un vettore e la struttura
35dati che lo seguiva in memoria è stata sovrascritta.  Seguendo questa
36direttiva, questi casi vengono identificati velocemente e in sicurezza.
37
38Registro dei cambiamenti::
39
40					Theodore Ts'o
41					31 Mar 94
42
43  La tabella magica è aggiornata a Linux 2.1.55.
44
45					Michael Chastain
46					<mailto:mec@shout.net>
47					22 Sep 1997
48
49  Ora dovrebbe essere aggiornata a Linux 2.1.112. Dato che
50  siamo in un momento di congelamento delle funzionalità
51  (*feature freeze*) è improbabile che qualcosa cambi prima
52  della versione 2.2.x.  Le righe sono ordinate secondo il
53  campo numero.
54
55					Krzysztof G. Baranowski
56					<mailto: kgb@knm.org.pl>
57					29 Jul 1998
58
59  Aggiornamento della tabella a Linux 2.5.45. Giusti nel congelamento
60  delle funzionalità ma è comunque possibile che qualche nuovo
61  numero magico s'intrufoli prima del kernel 2.6.x.
62
63					Petr Baudis
64					<pasky@ucw.cz>
65					03 Nov 2002
66
67  Aggiornamento della tabella magica a Linux 2.5.74.
68
69					Fabian Frederick
70					<ffrederick@users.sourceforge.net>
71					09 Jul 2003
72
73
74===================== ================ ======================== ==========================================
75Nome magico           Numero           Struttura                File
76===================== ================ ======================== ==========================================
77PG_MAGIC              'P'              pg_{read,write}_hdr      ``include/linux/pg.h``
78APM_BIOS_MAGIC        0x4101           apm_user                 ``arch/x86/kernel/apm_32.c``
79FASYNC_MAGIC          0x4601           fasync_struct            ``include/linux/fs.h``
80SLIP_MAGIC            0x5302           slip                     ``drivers/net/slip.h``
81MGSLPC_MAGIC          0x5402           mgslpc_info              ``drivers/char/pcmcia/synclink_cs.c``
82BAYCOM_MAGIC          0x19730510       baycom_state             ``drivers/net/baycom_epp.c``
83HDLCDRV_MAGIC         0x5ac6e778       hdlcdrv_state            ``include/linux/hdlcdrv.h``
84KV_MAGIC              0x5f4b565f       kernel_vars_s            ``arch/mips/include/asm/sn/klkernvars.h``
85CODA_MAGIC            0xC0DAC0DA       coda_file_info           ``fs/coda/coda_fs_i.h``
86YAM_MAGIC             0xF10A7654       yam_port                 ``drivers/net/hamradio/yam.c``
87CCB_MAGIC             0xf2691ad2       ccb                      ``drivers/scsi/ncr53c8xx.c``
88QUEUE_MAGIC_FREE      0xf7e1c9a3       queue_entry              ``drivers/scsi/arm/queue.c``
89QUEUE_MAGIC_USED      0xf7e1cc33       queue_entry              ``drivers/scsi/arm/queue.c``
90NMI_MAGIC             0x48414d4d455201 nmi_s                    ``arch/mips/include/asm/sn/nmi.h``
91===================== ================ ======================== ==========================================
92