| 1 |
.. SPDX-License-Identifier: GPL-2.0 |
| 2 |
|
| 3 |
.. _tw_magicnumbers: |
| 4 |
|
| 5 |
.. include:: ../disclaimer-zh_TW.rst |
| 6 |
|
| 7 |
:Original: :ref:`Documentation/staging/magic-number.rst <magicnumbers>` |
| 8 |
|
| 9 |
如果想評論或更新本文的內容,請直接發信到LKML。如果你使用英文交流有困難的話,也可 |
| 10 |
以向中文版維護者求助。如果本翻譯更新不及時或者翻譯存在問題,請聯繫中文版維護者:: |
| 11 |
|
| 12 |
中文版維護者: 賈威威 Jia Wei Wei <[email protected]> |
| 13 |
中文版翻譯者: 賈威威 Jia Wei Wei <[email protected]> |
| 14 |
中文版校譯者: 賈威威 Jia Wei Wei <[email protected]> |
| 15 |
胡皓文 Hu Haowen <[email protected]> |
| 16 |
|
| 17 |
Linux 魔術數 |
| 18 |
============ |
| 19 |
|
| 20 |
這個文件是有關當前使用的魔術值註冊表。當你給一個結構添加了一個魔術值,你也應該把這個魔術值添加到這個文件,因爲我們最好把用於各種結構的魔術值統一起來。 |
| 21 |
|
| 22 |
使用魔術值來保護內核數據結構是一個非常好的主意。這就允許你在運行期檢查(a)一個結構是否已經被攻擊,或者(b)你已經給一個例行程序通過了一個錯誤的結構。後一種情況特別地有用---特別是當你通過一個空指針指向結構體的時候。tty源碼,例如,經常通過特定驅動使用這種方法並且反覆地排列特定方面的結構。 |
| 23 |
|
| 24 |
使用魔術值的方法是在結構的開始處聲明的,如下:: |
| 25 |
|
| 26 |
struct tty_ldisc { |
| 27 |
int magic; |
| 28 |
... |
| 29 |
}; |
| 30 |
|
| 31 |
當你以後給內核添加增強功能的時候,請遵守這條規則!這樣就會節省數不清的調試時間,特別是一些古怪的情況,例如,數組超出範圍並且重新寫了超出部分。遵守這個規則,這些情況可以被快速地,安全地避免。 |
| 32 |
|
| 33 |
Theodore Ts'o |
| 34 |
31 Mar 94 |
| 35 |
|
| 36 |
給當前的Linux 2.1.55添加魔術表。 |
| 37 |
|
| 38 |
Michael Chastain |
| 39 |
<mailto:[email protected]> |
| 40 |
22 Sep 1997 |
| 41 |
|
| 42 |
現在應該最新的Linux 2.1.112.因爲在特性凍結期間,不能在2.2.x前改變任何東西。這些條目被數域所排序。 |
| 43 |
|
| 44 |
Krzysztof G.Baranowski |
| 45 |
<mailto: [email protected]> |
| 46 |
29 Jul 1998 |
| 47 |
|
| 48 |
更新魔術表到Linux 2.5.45。剛好越過特性凍結,但是有可能還會有一些新的魔術值在2.6.x之前融入到內核中。 |
| 49 |
|
| 50 |
Petr Baudis |
| 51 |
<[email protected]> |
| 52 |
03 Nov 2002 |
| 53 |
|
| 54 |
更新魔術表到Linux 2.5.74。 |
| 55 |
|
| 56 |
Fabian Frederick |
| 57 |
<[email protected]> |
| 58 |
09 Jul 2003 |
| 59 |
|
| 60 |
===================== ================ ======================== ========================================== |
| 61 |
魔術數名 數字 結構 文件 |
| 62 |
===================== ================ ======================== ========================================== |
| 63 |
PG_MAGIC 'P' pg_{read,write}_hdr ``include/linux/pg.h`` |
| 64 |
APM_BIOS_MAGIC 0x4101 apm_user ``arch/x86/kernel/apm_32.c`` |
| 65 |
FASYNC_MAGIC 0x4601 fasync_struct ``include/linux/fs.h`` |
| 66 |
SLIP_MAGIC 0x5302 slip ``drivers/net/slip.h`` |
| 67 |
KV_MAGIC 0x5f4b565f kernel_vars_s ``arch/mips/include/asm/sn/klkernvars.h`` |
| 68 |
CODA_MAGIC 0xC0DAC0DA coda_file_info ``fs/coda/coda_fs_i.h`` |
| 69 |
CCB_MAGIC 0xf2691ad2 ccb ``drivers/scsi/ncr53c8xx.c`` |
| 70 |
QUEUE_MAGIC_FREE 0xf7e1c9a3 queue_entry ``drivers/scsi/arm/queue.c`` |
| 71 |
QUEUE_MAGIC_USED 0xf7e1cc33 queue_entry ``drivers/scsi/arm/queue.c`` |
| 72 |
NMI_MAGIC 0x48414d4d455201 nmi_s ``arch/mips/include/asm/sn/nmi.h`` |
| 73 |
===================== ================ ======================== ========================================== |