summaryrefslogtreecommitdiff
path: root/Documentation/zh_CN/SubmitChecklist
blob: 951415bbab0c42db76faf98245c1c5fffb919360 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
Chinese translated version of Documentation/SubmitChecklist

If you have any comment or update to the content, please contact the
original document maintainer directly.  However, if you have a problem
communicating in English you can also ask the Chinese maintainer for
help.  Contact the Chinese maintainer if this translation is outdated
or if there is a problem with the translation.

Chinese maintainer: Harry Wei <harryxiyou@gmail.com>
---------------------------------------------------------------------
Documentation/SubmitChecklist �����ķ���

��������ۻ���±��ĵ����ݣ���ֱ����ϵԭ�ĵ���ά���ߡ������ʹ��Ӣ��
���������ѵĻ���Ҳ���������İ�ά���������������������²���ʱ���߷�
��������⣬����ϵ���İ�ά���ߡ�

���İ�ά���ߣ� ������ Harry Wei <harryxiyou@gmail.com>
���İ淭���ߣ� ������ Harry Wei <harryxiyou@gmail.com>
���İ�У���ߣ� ������ Harry Wei <harryxiyou@gmail.com>


��������
---------------------------------------------------------------------
Linux�ں��ύ�嵥
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

������һЩ�ں˿�����Ӧ�����Ļ������飬��������뿴���Լ����ں˲����ύ
�����ܵĸ��졣

��Щ���dz���Documentation/SubmittingPatches�ĵ������ṩ���Լ�����
�����ύLinux�ں˲�����˵����

1�������ʹ����һ��������ô��#include����/�����Ǹ����ܵ��Ǹ��ļ���
   ��Ҫ��������������붨��/�����Ǹ����ܵ�ͷ�ļ���

2������������û��߸���CONFIGѡ�� =y��=m������=n��
   ��Ҫ�б��뾯��/���� ��Ҫ�����Ӿ���/����

2b��ͨ�� allnoconfig, allmodconfig

2c����ʹ�� 0=builddir �ɹ��ع���

3��ͨ��ʹ�ñ��ؽ�����빤�߻�������һЩ�����������ڶ�CPU����Ϲ�����

4��ppc64 ��һ���ܺõļ�齻�����Ŀ�ܣ���Ϊ�������ѡ�unsigned long��
   ��64λֵ��ʹ�á�

5������Documentation/CodingStyle�ļ������ϸ����������㲹����������
   ʹ�ò�������������Υ��(scripts/checkpatch.pl)�����Ա�����ύ��
   ��Ӧ�õ����������㲹���е�����Υ�档

6���κθ��»��߸Ķ�CONFIGѡ����ܴ������ò˵���

7�����е�Kconfigѡ����¶�Ҫ��˵�����֡�

8���Ѿ�������ܽ�����ص�Kconfig��ϡ����Ǻ���ͨ���������õ�--�����������½���

9�������м���ԡ�

10��ʹ��'make checkstack'��'make namespacecheck'��飬Ȼ���޸����ҵ������⡣
    ע�⣺��ջ��鲻����ȷ�س������⣬�����κε�һ�������ڶ�ջ��ʹ�ö���512�ֽ�
    ��Ҫ׼���޸ġ�

11������kernel-doc��ȫ���ں�APIs�ļ�������Ҫ��̬�ĺ��������ǰ���Ҳ����ν����
    ʹ��'make htmldocs'����'make mandocs'�����kernel-doc��Ȼ���޸��κ�
    ���ֵ����⡣

12���Ѿ�ͨ��CONFIG_PREEMPT, CONFIG_DEBUG_PREEMPT,
    CONFIG_DEBUG_SLAB, CONFIG_DEBUG_PAGEALLOC, CONFIG_DEBUG_MUTEXES,
    CONFIG_DEBUG_SPINLOCK, CONFIG_DEBUG_SPINLOCK_SLEEP���ԣ�����ͬʱ��
    ʹ�ܡ�

13���Ѿ�����������ʹ�û��߲�ʹ�� CONFIG_SMP �� CONFIG_PREEMPT����ִ��ʱ�䡣

14���������Ӱ��IO/Disk���ȵȣ��Ѿ�ͨ��ʹ�û��߲�ʹ�� CONFIG_LBDAF ���ԡ�

15�����е�codepaths�Ѿ���ʹ����lockdep���ù��ܡ�

16�����е�/proc��¼���¶�Ҫ�����ļ�����Documentation/Ŀ¼�¡�

17�����е��ں������������¶�����¼��Documentation/kernel-parameters.txt�ļ��С�

18�����е�ģ��������¶���MODULE_PARM_DESC()��¼��

19�����е��û��ռ�ӿڸ��¶�����¼��Documentation/ABI/���鿴Documentation/ABI/README
    ���Ի�ø������Ϣ���ı��û��ռ�ӿڵIJ���Ӧ�ñ��ʼ����͸�linux-api@vger.kernel.org��

20��������Dz��Ƕ�ͨ��`make headers_check'��

21���Ѿ�ͨ����������slab��page-allocationʧ�ܼ�顣�鿴Documentation/fault-injection/��

22���¼����Դ���Ѿ�ͨ��`gcc -W'��ʹ��"make EXTRA_CFLAGS=-W"�����롣�����������ܶෳ�գ�
    ���Ƕ���Ѱ��©�������洦������:"warning: comparison between signed and unsigned"��

23���������ϲ���-mm���������ٲ��ԣ�����ȷ�����Ƿ񻹺Ͳ��������е���������һ�����Լ���VM��VFS
    ��������ϵͳ�и����仯��

24�����е��ڴ�����{e.g., barrier(), rmb(), wmb()}��Ҫ��Դ�����е�һ��ע�����������Ƕ��Ǹ�ʲô��
    �Լ�ԭ��

25��������κ�����������ƵIJ��������ӣ�ҲҪ����Documentation/ioctl/ioctl-number.txt��

26�������ĸ��Ĵ�����������ʹ���κε��ں�APIs�����������kconfig�����й�ϵ�Ĺ��ܣ����Ҫ
    ʹ����ص�kconfig���Źرգ� and/or =m�����ѡ���ṩ��[��ͬһʱ�䲻�����õĶ����ã�����������������
    �������]��

    CONFIG_SMP, CONFIG_SYSFS, CONFIG_PROC_FS, CONFIG_INPUT, CONFIG_PCI,
    CONFIG_BLOCK, CONFIG_PM, CONFIG_HOTPLUG, CONFIG_MAGIC_SYSRQ,
    CONFIG_NET, CONFIG_INET=n (��һ��ʹ�� CONFIG_NET=y)