summaryrefslogtreecommitdiff
path: root/Documentation/translations/zh_TW/admin-guide/README.rst
blob: b752e50359e699e93850aa16cab485c00dd78e74 (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
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
.. SPDX-License-Identifier: GPL-2.0

.. include:: ../disclaimer-zh_TW.rst

:Original: Documentation/admin-guide/README.rst

:譯者:

 吳想成 Wu XiangCheng <bobwxc@email.cn>
 胡皓文 Hu Haowen <src.res@email.cn>

Linux內核5.x版本 <http://kernel.org/>
=========================================

以下是Linux版本5的發行註記。仔細閱讀它們,
它們會告訴你這些都是什麼,解釋如何安裝內核,以及遇到問題時該如何做。

什麼是Linux?
---------------

  Linux是Unix作業系統的克隆版本,由Linus Torvalds在一個鬆散的網絡黑客
  (Hacker,無貶義)團隊的幫助下從頭開始編寫。它旨在實現兼容POSIX和
  單一UNIX規範。

  它具有在現代成熟的Unix中應當具有的所有功能,包括真正的多任務處理、虛擬內存、
  共享庫、按需加載、共享的寫時拷貝(COW)可執行文件、恰當的內存管理以及包括
  IPv4和IPv6在內的複合網絡棧。

  Linux在GNU通用公共許可證,版本2(GNU GPLv2)下分發,詳見隨附的COPYING文件。

它能在什麼樣的硬體上運行?
-----------------------------

  雖然Linux最初是爲32位的x86 PC機(386或更高版本)開發的,但今天它也能運行在
  (至少)Compaq Alpha AXP、Sun SPARC與UltraSPARC、Motorola 68000、PowerPC、
  PowerPC64、ARM、Hitachi SuperH、Cell、IBM S/390、MIPS、HP PA-RISC、Intel 
  IA-64、DEC VAX、AMD x86-64 Xtensa和ARC架構上。

  Linux很容易移植到大多數通用的32位或64位體系架構,只要它們有一個分頁內存管理
  單元(PMMU)和一個移植的GNU C編譯器(gcc;GNU Compiler Collection,GCC的一
  部分)。Linux也被移植到許多沒有PMMU的體系架構中,儘管功能顯然受到了一定的
  限制。
  Linux也被移植到了其自己上。現在可以將內核作爲用戶空間應用程式運行——這被
  稱爲用戶模式Linux(UML)。

文檔
-----
網際網路上和書籍上都有大量的電子文檔,既有Linux專屬文檔,也有與一般UNIX問題相關
的文檔。我建議在任何Linux FTP站點上查找LDP(Linux文檔項目)書籍的文檔子目錄。
本自述文件並不是關於系統的文檔:有更好的可用資源。

 - 網際網路上和書籍上都有大量的(電子)文檔,既有Linux專屬文檔,也有與普通
   UNIX問題相關的文檔。我建議在任何有LDP(Linux文檔項目)書籍的Linux FTP
   站點上查找文檔子目錄。本自述文件並不是關於系統的文檔:有更好的可用資源。

 - 文檔/子目錄中有各種自述文件:例如,這些文件通常包含一些特定驅動程序的
   內核安裝說明。請閱讀
   :ref:`Documentation/process/changes.rst <changes>` 文件,它包含了升級內核
   可能會導致的問題的相關信息。

安裝內核原始碼
---------------

 - 如果您要安裝完整的原始碼,請把內核tar檔案包放在您有權限的目錄中(例如您
   的主目錄)並將其解包::

     xz -cd linux-5.x.tar.xz | tar xvf -

   將「X」替換成最新內核的版本號。

   【不要】使用 /usr/src/linux 目錄!這裡有一組庫頭文件使用的內核頭文件
   (通常是不完整的)。它們應該與庫匹配,而不是被內核的變化搞得一團糟。

 - 您還可以通過打補丁在5.x版本之間升級。補丁以xz格式分發。要通過打補丁進行
   安裝,請獲取所有較新的補丁文件,進入內核原始碼(linux-5.x)的目錄並
   執行::

     xz -cd ../patch-5.x.xz | patch -p1

   請【按順序】替換所有大於當前原始碼樹版本的「x」,這樣就可以了。您可能想要
   刪除備份文件(文件名類似xxx~ 或 xxx.orig),並確保沒有失敗的補丁(文件名
   類似xxx# 或 xxx.rej)。如果有,不是你就是我犯了錯誤。

   與5.x內核的補丁不同,5.x.y內核(也稱爲穩定版內核)的補丁不是增量的,而是
   直接應用於基本的5.x內核。例如,如果您的基本內核是5.0,並且希望應用5.0.3
   補丁,則不應先應用5.0.1和5.0.2的補丁。類似地,如果您運行的是5.0.2內核,
   並且希望跳轉到5.0.3,那麼在應用5.0.3補丁之前,必須首先撤銷5.0.2補丁
   (即patch -R)。更多關於這方面的內容,請閱讀
   :ref:`Documentation/process/applying-patches.rst <applying_patches>` 。

   或者,腳本 patch-kernel 可以用來自動化這個過程。它能確定當前內核版本並
   應用找到的所有補丁::

     linux/scripts/patch-kernel linux

   上面命令中的第一個參數是內核原始碼的位置。補丁是在當前目錄應用的,但是
   可以將另一個目錄指定爲第二個參數。

 - 確保沒有過時的 .o 文件和依賴項::

     cd linux
     make mrproper

   現在您應該已經正確安裝了原始碼。

軟體要求
---------

   編譯和運行5.x內核需要各種軟體包的最新版本。請參考
   :ref:`Documentation/process/changes.rst <changes>`
   來了解最低版本要求以及如何升級軟體包。請注意,使用過舊版本的這些包可能會
   導致很難追蹤的間接錯誤,因此不要以爲在生成或操作過程中出現明顯問題時可以
   只更新包。

爲內核建立目錄
---------------

   編譯內核時,默認情況下所有輸出文件都將與內核原始碼放在一起。使用
   ``make O=output/dir`` 選項可以爲輸出文件(包括 .config)指定備用位置。
   例如::

     kernel source code: /usr/src/linux-5.x
     build directory:    /home/name/build/kernel

   要配置和構建內核,請使用::

     cd /usr/src/linux-5.x
     make O=/home/name/build/kernel menuconfig
     make O=/home/name/build/kernel
     sudo make O=/home/name/build/kernel modules_install install

   請注意:如果使用了 ``O=output/dir`` 選項,那麼它必須用於make的所有調用。

配置內核
---------

   即使只升級一個小版本,也不要跳過此步驟。每個版本中都會添加新的配置選項,
   如果配置文件沒有按預定設置,就會出現奇怪的問題。如果您想以最少的工作量
   將現有配置升級到新版本,請使用 ``makeoldconfig`` ,它只會詢問您新配置
   選項的答案。

 - 其他配置命令包括::

     "make config"      純文本界面。

     "make menuconfig"  基於文本的彩色菜單、選項列表和對話框。

     "make nconfig"     增強的基於文本的彩色菜單。

     "make xconfig"     基於Qt的配置工具。

     "make gconfig"     基於GTK+的配置工具。

     "make oldconfig"   基於現有的 ./.config 文件選擇所有選項,並詢問
                        新配置選項。

     "make olddefconfig"
                        類似上一個,但不詢問直接將新選項設置爲默認值。

     "make defconfig"   根據體系架構,使用arch/$arch/defconfig或
                        arch/$arch/configs/${PLATFORM}_defconfig中的
                        默認選項值創建./.config文件。

     "make ${PLATFORM}_defconfig"
                        使用arch/$arch/configs/${PLATFORM}_defconfig中
                        的默認選項值創建一個./.config文件。
                        用「makehelp」來獲取您體系架構中所有可用平台的列表。

     "make allyesconfig"
                        通過儘可能將選項值設置爲「y」,創建一個
                        ./.config文件。

     "make allmodconfig"
                        通過儘可能將選項值設置爲「m」,創建一個
                        ./.config文件。

     "make allnoconfig" 通過儘可能將選項值設置爲「n」,創建一個
                        ./.config文件。

     "make randconfig"  通過隨機設置選項值來創建./.config文件。

     "make localmodconfig" 基於當前配置和加載的模塊(lsmod)創建配置。禁用
                           已加載的模塊不需要的任何模塊選項。

                           要爲另一台計算機創建localmodconfig,請將該計算機
                           的lsmod存儲到一個文件中,並將其作爲lsmod參數傳入。

                           此外,通過在參數LMC_KEEP中指定模塊的路徑,可以將
                           模塊保留在某些文件夾或kconfig文件中。

                   target$ lsmod > /tmp/mylsmod
                   target$ scp /tmp/mylsmod host:/tmp

                   host$ make LSMOD=/tmp/mylsmod \
                           LMC_KEEP="drivers/usb:drivers/gpu:fs" \
                           localmodconfig

                           上述方法在交叉編譯時也適用。

     "make localyesconfig" 與localmodconfig類似,只是它會將所有模塊選項轉換
                           爲內置(=y)。你可以同時通過LMC_KEEP保留模塊。

     "make kvmconfig"   爲kvm客體內核支持啓用其他選項。

     "make xenconfig"   爲xen dom0客體內核支持啓用其他選項。

     "make tinyconfig"  配置儘可能小的內核。

   更多關於使用Linux內核配置工具的信息,見文檔
   Documentation/kbuild/kconfig.rst。

 - ``make config`` 注意事項:

    - 包含不必要的驅動程序會使內核變大,並且在某些情況下會導致問題:
      探測不存在的控制器卡可能會混淆其他控制器。

    - 如果存在協處理器,則編譯了數學仿真的內核仍將使用協處理器:在
      這種情況下,數學仿真永遠不會被使用。內核會稍微大一點,但不管
      是否有數學協處理器,都可以在不同的機器上工作。

    - 「kernel hacking」配置細節通常會導致更大或更慢的內核(或兩者
      兼而有之),甚至可以通過配置一些例程來主動嘗試破壞壞代碼以發現
      內核問題,從而降低內核的穩定性(kmalloc())。因此,您可能應該
      用於研究「開發」、「實驗」或「調試」特性相關問題。

編譯內核
---------

 - 確保您至少有gcc 4.9可用。
   有關更多信息,請參閱 :ref:`Documentation/process/changes.rst <changes>` 。

   請注意,您仍然可以使用此內核運行a.out用戶程序。

 - 執行 ``make`` 來創建壓縮內核映像。如果您安裝了lilo以適配內核makefile,
   那麼也可以進行 ``makeinstall`` ,但是您可能需要先檢查特定的lilo設置。

   實際安裝必須以root身份執行,但任何正常構建都不需要。
   無須徒然使用root身份。

 - 如果您將內核的任何部分配置爲模塊,那麼還必須執行 ``make modules_install``- 詳細的內核編譯/生成輸出:

   通常,內核構建系統在相當安靜的模式下運行(但不是完全安靜)。但是有時您或
   其他內核開發人員需要看到編譯、連結或其他命令的執行過程。爲此,可使用
   「verbose(詳細)」構建模式。
   向 ``make`` 命令傳遞 ``V=1`` 來實現,例如::

     make V=1 all

   如需構建系統也給出內個目標重建的願意,請使用 ``V=2`` 。默認爲 ``V=0``- 準備一個備份內核以防出錯。對於開發版本尤其如此,因爲每個新版本都包含
   尚未調試的新代碼。也要確保保留與該內核對應的模塊的備份。如果要安裝
   與工作內核版本號相同的新內核,請在進行 ``make modules_install`` 安裝
   之前備份modules目錄。

   或者,在編譯之前,使用內核配置選項「LOCALVERSION」向常規內核版本附加
   一個唯一的後綴。LOCALVERSION可以在「General Setup」菜單中設置。

 - 爲了引導新內核,您需要將內核映像(例如編譯後的
   .../linux/arch/x86/boot/bzImage)複製到常規可引導內核的位置。

 - 不再支持在沒有LILO等啓動裝載程序幫助的情況下直接從軟盤引導內核。

   如果從硬碟引導Linux,很可能使用LILO,它使用/etc/lilo.conf文件中
   指定的內核映像文件。內核映像文件通常是/vmlinuz、/boot/vmlinuz、
   /bzImage或/boot/bzImage。使用新內核前,請保存舊映像的副本,並複製
   新映像覆蓋舊映像。然後您【必須重新運行LILO】來更新加載映射!否則,
   將無法啓動新的內核映像。

   重新安裝LILO通常需要運行/sbin/LILO。您可能希望編輯/etc/lilo.conf
   文件爲舊內核映像指定一個條目(例如/vmlinux.old)防止新的不能正常
   工作。有關更多信息,請參閱LILO文檔。

   重新安裝LILO之後,您應該就已經準備好了。關閉系統,重新啓動,盡情
   享受吧!

   如果需要更改內核映像中的默認根設備、視頻模式等,請在適當的地方使用
   啓動裝載程序的引導選項。無需重新編譯內核即可更改這些參數。

 - 使用新內核重新啓動並享受它吧。

若遇到問題
-----------

 - 如果您發現了一些可能由於內核缺陷所導致的問題,請檢查MAINTAINERS(維護者)
   文件看看是否有人與令您遇到麻煩的內核部分相關。如果無人在此列出,那麼第二
   個最好的方案就是把它們發給我(torvalds@linux-foundation.org),也可能發送
   到任何其他相關的郵件列表或新聞組。

 - 在所有的缺陷報告中,【請】告訴我們您在說什麼內核,如何復現問題,以及您的
   設置是什麼的(使用您的常識)。如果問題是新的,請告訴我;如果問題是舊的,
   請嘗試告訴我您什麼時候首次注意到它。

 - 如果缺陷導致如下消息::

     unable to handle kernel paging request at address C0000010
     Oops: 0002
     EIP:   0010:XXXXXXXX
     eax: xxxxxxxx   ebx: xxxxxxxx   ecx: xxxxxxxx   edx: xxxxxxxx
     esi: xxxxxxxx   edi: xxxxxxxx   ebp: xxxxxxxx
     ds: xxxx  es: xxxx  fs: xxxx  gs: xxxx
     Pid: xx, process nr: xx
     xx xx xx xx xx xx xx xx xx xx

   或者類似的內核調試信息顯示在屏幕上或在系統日誌里,請【如實】複製它。
   可能對你來說轉儲(dump)看起來不可理解,但它確實包含可能有助於調試問題的
   信息。轉儲上方的文本也很重要:它說明了內核轉儲代碼的原因(在上面的示例中,
   是由於內核指針錯誤)。更多關於如何理解轉儲的信息,請參見
   Documentation/admin-guide/bug-hunting.rst。

 - 如果使用 CONFIG_KALLSYMS 編譯內核,則可以按原樣發送轉儲,否則必須使用
   ``ksymoops`` 程序來理解轉儲(但通常首選使用CONFIG_KALLSYMS編譯)。
   此實用程序可從
   https://www.kernel.org/pub/linux/utils/kernel/ksymoops/ 下載。
   或者,您可以手動執行轉儲查找:

 - 在調試像上面這樣的轉儲時,如果您可以查找EIP值的含義,這將非常有幫助。
   十六進位值本身對我或其他任何人都沒有太大幫助:它會取決於特定的內核設置。
   您應該做的是從EIP行獲取十六進位值(忽略 ``0010:`` ),然後在內核名字列表
   中查找它,以查看哪個內核函數包含有問題的地址。

   要找到內核函數名,您需要找到與顯示症狀的內核相關聯的系統二進位文件。就是
   文件「linux/vmlinux」。要提取名字列表並將其與內核崩潰中的EIP進行匹配,
   請執行::

     nm vmlinux | sort | less

   這將爲您提供一個按升序排序的內核地址列表,從中很容易找到包含有問題的地址
   的函數。請注意,內核調試消息提供的地址不一定與函數地址完全匹配(事實上,
   這是不可能的),因此您不能只「grep」列表:不過列表將爲您提供每個內核函數
   的起點,因此通過查找起始地址低於你正在搜索的地址,但後一個函數的高於的
   函數,你會找到您想要的。實際上,在您的問題報告中加入一些「上下文」可能是
   一個好主意,給出相關的上下幾行。

   如果您由於某些原因無法完成上述操作(如您使用預編譯的內核映像或類似的映像),
   請儘可能多地告訴我您的相關設置信息,這會有所幫助。有關詳細信息請閱讀
   『Documentation/admin-guide/reporting-issues.rst』。

 - 或者,您可以在正在運行的內核上使用gdb(只讀的;即不能更改值或設置斷點)。
   爲此,請首先使用-g編譯內核;適當地編輯arch/x86/Makefile,然後執行 ``make
   clean`` 。您還需要啓用CONFIG_PROC_FS(通過 ``make config`` )。

   使用新內核重新啓動後,執行 ``gdb vmlinux /proc/kcore`` 。現在可以使用所有
   普通的gdb命令。查找系統崩潰點的命令是 ``l *0xXXXXXXXX`` (將xxx替換爲EIP
   值)。

   用gdb無法調試一個當前未運行的內核是由於gdb(錯誤地)忽略了編譯內核的起始
   偏移量。