docs/zh_TW: update zh_TW's documentation from an ascensive aspect
Subsystems (2)
v2 cover docs/zh_TW: update zh_TW's documentation from an ascensive aspect
Update zh_TW's documentation concentrating on the following aspects:
* The file tree structure changes of the main documentation;
* Some changes and ideas from zh_CN translation;
* Removal for several obsoleted contents within the zh_TW translation or those which are not exising anymore in the main documentation.
* Replacements for some incorrect words and phrases in traditional Chinese or those which are odd within their context being hard for readers to comprehend.
v2:
* Remove the fancy character U+feff (ZERO WIDTH NO-BREAK SPACE) reported by Corbet in https://lore.kernel.org/lkml/[email protected]/
v1:
https://lore.kernel.org/lkml/[email protected]/
Hu Haowen (6):
docs/zh_TW: update admin-guide
docs/zh_TW: update arch
docs/zh_TW: update cpu-freq
docs/zh_TW: update filesystems
docs/zh_TW: update process
docs/zh_TW: turn zh_CN's folder references and headers into zh_TW's
ones
.../translations/zh_TW/admin-guide/README.rst | 166 ++-- .../zh_TW/admin-guide/bootconfig.rst | 294 +++++++ .../zh_TW/admin-guide/bug-bisect.rst | 12 +- .../zh_TW/admin-guide/bug-hunting.rst | 40 +- .../zh_TW/admin-guide/clearing-warn-once.rst | 6 +- .../zh_TW/admin-guide/cpu-load.rst | 10 +- .../zh_TW/admin-guide/cputopology.rst | 98 +++ .../translations/zh_TW/admin-guide/index.rst | 136 ++-- .../translations/zh_TW/admin-guide/init.rst | 38 +- .../zh_TW/admin-guide/lockup-watchdogs.rst | 69 ++ .../zh_TW/admin-guide/mm/damon/index.rst | 31 + .../zh_TW/admin-guide/mm/damon/lru_sort.rst | 265 ++++++ .../zh_TW/admin-guide/mm/damon/reclaim.rst | 230 ++++++ .../zh_TW/admin-guide/mm/damon/start.rst | 126 +++ .../zh_TW/admin-guide/mm/damon/usage.rst | 593 ++++++++++++++ .../zh_TW/admin-guide/mm/index.rst | 52 ++ .../translations/zh_TW/admin-guide/mm/ksm.rst | 201 +++++ .../zh_TW/admin-guide/reporting-issues.rst | 729 +++++++++-------- .../admin-guide/reporting-regressions.rst | 371 +++++++++ .../zh_TW/admin-guide/security-bugs.rst | 28 +- .../translations/zh_TW/admin-guide/sysrq.rst | 283 +++++++ .../zh_TW/admin-guide/tainted-kernels.rst | 86 +- .../zh_TW/admin-guide/unicode.rst | 12 +- .../translations/zh_TW/arch/arm/Booting | 176 ++++ .../zh_TW/arch/arm/kernel_user_helpers.txt | 285 +++++++ .../translations/zh_TW/arch/arm64/amu.rst | 6 +- .../translations/zh_TW/arch/arm64/booting.txt | 28 +- .../zh_TW/arch/arm64/elf_hwcaps.rst | 10 +- .../zh_TW/arch/arm64/legacy_instructions.txt | 14 +- .../translations/zh_TW/arch/arm64/memory.txt | 16 +- .../translations/zh_TW/arch/arm64/perf.rst | 2 +- .../zh_TW/arch/arm64/silicon-errata.txt | 30 +- .../zh_TW/arch/arm64/tagged-pointers.txt | 10 +- .../translations/zh_TW/arch/index.rst | 30 + .../zh_TW/arch/openrisc/index.rst | 33 + .../zh_TW/arch/openrisc/openrisc_port.rst | 129 +++ .../translations/zh_TW/arch/openrisc/todo.rst | 25 + .../zh_TW/arch/parisc/debugging.rst | 47 ++ .../translations/zh_TW/arch/parisc/index.rst | 32 + .../zh_TW/arch/parisc/registers.rst | 157 ++++ .../translations/zh_TW/cpu-freq/core.rst | 26 +- .../zh_TW/cpu-freq/cpu-drivers.rst | 147 ++-- .../zh_TW/cpu-freq/cpufreq-stats.rst | 41 +- .../translations/zh_TW/cpu-freq/index.rst | 4 +- .../zh_TW/filesystems/debugfs.rst | 38 +- .../translations/zh_TW/filesystems/index.rst | 2 +- .../translations/zh_TW/filesystems/sysfs.txt | 16 +- .../translations/zh_TW/filesystems/tmpfs.rst | 32 +- .../zh_TW/filesystems/virtiofs.rst | 8 +- Documentation/translations/zh_TW/index.rst | 5 +- .../translations/zh_TW/process/1.Intro.rst | 78 +- .../translations/zh_TW/process/2.Process.rst | 130 +-- .../zh_TW/process/3.Early-stage.rst | 44 +- .../translations/zh_TW/process/4.Coding.rst | 102 +-- .../translations/zh_TW/process/5.Posting.rst | 66 +- .../zh_TW/process/6.Followthrough.rst | 46 +- .../zh_TW/process/7.AdvancedTopics.rst | 56 +- .../zh_TW/process/8.Conclusion.rst | 10 +- .../code-of-conduct-interpretation.rst | 52 +- .../zh_TW/process/code-of-conduct.rst | 18 +- .../zh_TW/process/coding-style.rst | 400 ++++++---- .../zh_TW/process/development-process.rst | 2 +- .../zh_TW/process/email-clients.rst | 273 ++++--- .../process/embargoed-hardware-issues.rst | 78 +- .../translations/zh_TW/process/howto.rst | 144 ++-- .../translations/zh_TW/process/index.rst | 5 +- .../zh_TW/process/kernel-driver-statement.rst | 2 +- .../process/kernel-enforcement-statement.rst | 14 +- .../zh_TW/process/license-rules.rst | 54 +- .../zh_TW/process/management-style.rst | 60 +- .../zh_TW/process/stable-api-nonsense.rst | 86 +- .../zh_TW/process/stable-kernel-rules.rst | 36 +- .../zh_TW/process/submit-checklist.rst | 92 ++- .../zh_TW/process/submitting-patches.rst | 755 +++++++++--------- .../process/volatile-considered-harmful.rst | 32 +- 75 files changed, 5781 insertions(+), 2079 deletions(-) create mode 100644 Documentation/translations/zh_TW/admin-guide/bootconfig.rst create mode 100644 Documentation/translations/zh_TW/admin-guide/cputopology.rst create mode 100644 Documentation/translations/zh_TW/admin-guide/lockup-watchdogs.rst create mode 100644 Documentation/translations/zh_TW/admin-guide/mm/damon/index.rst create mode 100644 Documentation/translations/zh_TW/admin-guide/mm/damon/lru_sort.rst create mode 100644 Documentation/translations/zh_TW/admin-guide/mm/damon/reclaim.rst create mode 100644 Documentation/translations/zh_TW/admin-guide/mm/damon/start.rst create mode 100644 Documentation/translations/zh_TW/admin-guide/mm/damon/usage.rst create mode 100644 Documentation/translations/zh_TW/admin-guide/mm/index.rst create mode 100644 Documentation/translations/zh_TW/admin-guide/mm/ksm.rst create mode 100644 Documentation/translations/zh_TW/admin-guide/reporting-regressions.rst create mode 100644 Documentation/translations/zh_TW/admin-guide/sysrq.rst create mode 100644 Documentation/translations/zh_TW/arch/arm/Booting create mode 100644 Documentation/translations/zh_TW/arch/arm/kernel_user_helpers.txt create mode 100644 Documentation/translations/zh_TW/arch/index.rst create mode 100644 Documentation/translations/zh_TW/arch/openrisc/index.rst create mode 100644 Documentation/translations/zh_TW/arch/openrisc/openrisc_port.rst create mode 100644 Documentation/translations/zh_TW/arch/openrisc/todo.rst create mode 100644 Documentation/translations/zh_TW/arch/parisc/debugging.rst create mode 100644 Documentation/translations/zh_TW/arch/parisc/index.rst create mode 100644 Documentation/translations/zh_TW/arch/parisc/registers.rst
Signature · 1 line
2.34.1
PATCH v2 1/6 docs/zh_TW: update admin-guide
Update zh_TW's admin-guide documentation concentrating on the following aspects:
* The file tree structure changes of the main documentation;
* Some changes and ideas from zh_CN translation;
* Removal for several obsoleted contents within the zh_TW translation or those which are not exising anymore in the main documentation.
* Replacements for some incorrect words and phrases in traditional Chinese or those which are odd within their context being hard for readers to comprehend.
--- .../translations/zh_TW/admin-guide/README.rst | 166 ++-- .../zh_TW/admin-guide/bootconfig.rst | 294 +++++++ .../zh_TW/admin-guide/bug-bisect.rst | 12 +- .../zh_TW/admin-guide/bug-hunting.rst | 40 +- .../zh_TW/admin-guide/clearing-warn-once.rst | 6 +- .../zh_TW/admin-guide/cpu-load.rst | 10 +- .../zh_TW/admin-guide/cputopology.rst | 98 +++ .../translations/zh_TW/admin-guide/index.rst | 136 ++-- .../translations/zh_TW/admin-guide/init.rst | 38 +- .../zh_TW/admin-guide/lockup-watchdogs.rst | 69 ++ .../zh_TW/admin-guide/mm/damon/index.rst | 31 + .../zh_TW/admin-guide/mm/damon/lru_sort.rst | 265 +++++++ .../zh_TW/admin-guide/mm/damon/reclaim.rst | 230 ++++++ .../zh_TW/admin-guide/mm/damon/start.rst | 126 +++ .../zh_TW/admin-guide/mm/damon/usage.rst | 593 ++++++++++++++ .../zh_TW/admin-guide/mm/index.rst | 52 ++ .../translations/zh_TW/admin-guide/mm/ksm.rst | 201 +++++ .../zh_TW/admin-guide/reporting-issues.rst | 729 +++++++++--------- .../admin-guide/reporting-regressions.rst | 371 +++++++++ .../zh_TW/admin-guide/security-bugs.rst | 28 +- .../translations/zh_TW/admin-guide/sysrq.rst | 283 +++++++ .../zh_TW/admin-guide/tainted-kernels.rst | 86 +-- .../zh_TW/admin-guide/unicode.rst | 12 +- 23 files changed, 3233 insertions(+), 643 deletions(-) create mode 100644 Documentation/translations/zh_TW/admin-guide/bootconfig.rst create mode 100644 Documentation/translations/zh_TW/admin-guide/cputopology.rst create mode 100644 Documentation/translations/zh_TW/admin-guide/lockup-watchdogs.rst create mode 100644 Documentation/translations/zh_TW/admin-guide/mm/damon/index.rst create mode 100644 Documentation/translations/zh_TW/admin-guide/mm/damon/lru_sort.rst create mode 100644 Documentation/translations/zh_TW/admin-guide/mm/damon/reclaim.rst create mode 100644 Documentation/translations/zh_TW/admin-guide/mm/damon/start.rst create mode 100644 Documentation/translations/zh_TW/admin-guide/mm/damon/usage.rst create mode 100644 Documentation/translations/zh_TW/admin-guide/mm/index.rst create mode 100644 Documentation/translations/zh_TW/admin-guide/mm/ksm.rst create mode 100644 Documentation/translations/zh_TW/admin-guide/reporting-regressions.rst create mode 100644 Documentation/translations/zh_TW/admin-guide/sysrq.rst
Documentation/translations/zh_TW/admin-guide/README.rst +55 -111
@@ -7,18 +7,18 @@ :譯者: 吳想成 Wu XiangCheng <[email protected]> - 胡皓文 Hu Haowen <[email protected]> + 胡皓文 Hu Haowen <[email protected]> -Linux內核5.x版本 <http://kernel.org/> +Linux內核6.x版本 <http://kernel.org/> ========================================= -以下是Linux版本5的發行註記。仔細閱讀它們, +以下是Linux版本6的發行註記。仔細閱讀它們, 它們會告訴你這些都是什麼,解釋如何安裝內核,以及遇到問題時該如何做。 什麼是Linux? --------------- - Linux是Unix作業系統的克隆版本,由Linus Torvalds在一個鬆散的網絡黑客 + Linux是Unix操作系統的克隆版本,由Linus Torvalds在一個鬆散的網絡黑客 (Hacker,無貶義)團隊的幫助下從頭開始編寫。它旨在實現兼容POSIX和 單一UNIX規範。
@@ -28,7 +28,7 @@ Linux內核5.x版本 <http://kernel.org/> Linux在GNU通用公共許可證,版本2(GNU GPLv2)下分發,詳見隨附的COPYING文件。 -它能在什麼樣的硬體上運行? +它能在什麼樣的硬件上運行? ----------------------------- 雖然Linux最初是爲32位的x86 PC機(386或更高版本)開發的,但今天它也能運行在
@@ -40,16 +40,16 @@ Linux內核5.x版本 <http://kernel.org/> 單元(PMMU)和一個移植的GNU C編譯器(gcc;GNU Compiler Collection,GCC的一 部分)。Linux也被移植到許多沒有PMMU的體系架構中,儘管功能顯然受到了一定的 限制。 - Linux也被移植到了其自己上。現在可以將內核作爲用戶空間應用程式運行——這被 + Linux也被移植到了其自己上。現在可以將內核作爲用戶空間應用程序運行——這被 稱爲用戶模式Linux(UML)。 文檔 ----- -網際網路上和書籍上都有大量的電子文檔,既有Linux專屬文檔,也有與一般UNIX問題相關 +因特網上和書籍上都有大量的電子文檔,既有Linux專屬文檔,也有與一般UNIX問題相關 的文檔。我建議在任何Linux FTP站點上查找LDP(Linux文檔項目)書籍的文檔子目錄。 本自述文件並不是關於系統的文檔:有更好的可用資源。 - - 網際網路上和書籍上都有大量的(電子)文檔,既有Linux專屬文檔,也有與普通 + - 因特網上和書籍上都有大量的(電子)文檔,既有Linux專屬文檔,也有與普通 UNIX問題相關的文檔。我建議在任何有LDP(Linux文檔項目)書籍的Linux FTP 站點上查找文檔子目錄。本自述文件並不是關於系統的文檔:有更好的可用資源。
@@ -58,33 +58,33 @@ Linux內核5.x版本 <http://kernel.org/> :ref:`Documentation/process/changes.rst <changes>` 文件,它包含了升級內核 可能會導致的問題的相關信息。 -安裝內核原始碼 +安裝內核源代碼 --------------- - - 如果您要安裝完整的原始碼,請把內核tar檔案包放在您有權限的目錄中(例如您 + - 如果您要安裝完整的源代碼,請把內核tar檔案包放在您有權限的目錄中(例如您 的主目錄)並將其解包:: - xz -cd linux-5.x.tar.xz | tar xvf - + xz -cd linux-6.x.tar.xz | tar xvf - - 將「X」替換成最新內核的版本號。 + 將“X”替換成最新內核的版本號。 - 【不要】使用 /usr/src/linux 目錄!這裡有一組庫頭文件使用的內核頭文件 + 【不要】使用 /usr/src/linux 目錄!這裏有一組庫頭文件使用的內核頭文件 (通常是不完整的)。它們應該與庫匹配,而不是被內核的變化搞得一團糟。 - - 您還可以通過打補丁在5.x版本之間升級。補丁以xz格式分發。要通過打補丁進行 - 安裝,請獲取所有較新的補丁文件,進入內核原始碼(linux-5.x)的目錄並 + - 您還可以通過打補丁在6.x版本之間升級。補丁以xz格式分發。要通過打補丁進行 + 安裝,請獲取所有較新的補丁文件,進入內核源代碼(linux-6.x)的目錄並 執行:: - xz -cd ../patch-5.x.xz | patch -p1 + xz -cd ../patch-6.x.xz | patch -p1 - 請【按順序】替換所有大於當前原始碼樹版本的「x」,這樣就可以了。您可能想要 + 請【按順序】替換所有大於當前源代碼樹版本的“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補丁 + 與6.x內核的補丁不同,6.x.y內核(也稱爲穩定版內核)的補丁不是增量的,而是 + 直接應用於基本的6.x內核。例如,如果您的基本內核是6.0,並且希望應用6.0.3 + 補丁,則不應先應用6.0.1和6.0.2的補丁。類似地,如果您運行的是6.0.2內核, + 並且希望跳轉到6.0.3,那麼在應用6.0.3補丁之前,必須首先撤銷6.0.2補丁 (即patch -R)。更多關於這方面的內容,請閱讀 :ref:`Documentation/process/applying-patches.rst <applying_patches>` 。
@@ -93,7 +93,7 @@ Linux內核5.x版本 <http://kernel.org/> linux/scripts/patch-kernel linux - 上面命令中的第一個參數是內核原始碼的位置。補丁是在當前目錄應用的,但是 + 上面命令中的第一個參數是內核源代碼的位置。補丁是在當前目錄應用的,但是 可以將另一個目錄指定爲第二個參數。 - 確保沒有過時的 .o 文件和依賴項::
@@ -101,30 +101,30 @@ Linux內核5.x版本 <http://kernel.org/> cd linux make mrproper - 現在您應該已經正確安裝了原始碼。 + 現在您應該已經正確安裝了源代碼。 -軟體要求 +軟件要求 --------- - 編譯和運行5.x內核需要各種軟體包的最新版本。請參考 + 編譯和運行6.x內核需要各種軟件包的最新版本。請參考 :ref:`Documentation/process/changes.rst <changes>` - 來了解最低版本要求以及如何升級軟體包。請注意,使用過舊版本的這些包可能會 + 來了解最低版本要求以及如何升級軟件包。請注意,使用過舊版本的這些包可能會 導致很難追蹤的間接錯誤,因此不要以爲在生成或操作過程中出現明顯問題時可以 只更新包。 爲內核建立目錄 --------------- - 編譯內核時,默認情況下所有輸出文件都將與內核原始碼放在一起。使用 + 編譯內核時,默認情況下所有輸出文件都將與內核源代碼放在一起。使用 ``make O=output/dir`` 選項可以爲輸出文件(包括 .config)指定備用位置。 例如:: - kernel source code: /usr/src/linux-5.x + kernel source code: /usr/src/linux-6.x build directory: /home/name/build/kernel 要配置和構建內核,請使用:: - cd /usr/src/linux-5.x + cd /usr/src/linux-6.x make O=/home/name/build/kernel menuconfig make O=/home/name/build/kernel sudo make O=/home/name/build/kernel modules_install install
@@ -136,7 +136,7 @@ Linux內核5.x版本 <http://kernel.org/> 即使只升級一個小版本,也不要跳過此步驟。每個版本中都會添加新的配置選項, 如果配置文件沒有按預定設置,就會出現奇怪的問題。如果您想以最少的工作量 - 將現有配置升級到新版本,請使用 ``makeoldconfig`` ,它只會詢問您新配置 + 將現有配置升級到新版本,請使用 ``make oldconfig`` ,它只會詢問您新配置 選項的答案。 - 其他配置命令包括::
@@ -164,17 +164,17 @@ Linux內核5.x版本 <http://kernel.org/> "make ${PLATFORM}_defconfig" 使用arch/$arch/configs/${PLATFORM}_defconfig中 的默認選項值創建一個./.config文件。 - 用「makehelp」來獲取您體系架構中所有可用平台的列表。 + 用“make help”來獲取您體系架構中所有可用平臺的列表。 "make allyesconfig" - 通過儘可能將選項值設置爲「y」,創建一個 + 通過儘可能將選項值設置爲“y”,創建一個 ./.config文件。 "make allmodconfig" - 通過儘可能將選項值設置爲「m」,創建一個 + 通過儘可能將選項值設置爲“m”,創建一個 ./.config文件。 - "make allnoconfig" 通過儘可能將選項值設置爲「n」,創建一個 + "make allnoconfig" 通過儘可能將選項值設置爲“n”,創建一個 ./.config文件。 "make randconfig" 通過隨機設置選項值來創建./.config文件。
@@ -182,7 +182,7 @@ Linux內核5.x版本 <http://kernel.org/> "make localmodconfig" 基於當前配置和加載的模塊(lsmod)創建配置。禁用 已加載的模塊不需要的任何模塊選項。 - 要爲另一台計算機創建localmodconfig,請將該計算機 + 要爲另一臺計算機創建localmodconfig,請將該計算機 的lsmod存儲到一個文件中,並將其作爲lsmod參數傳入。 此外,通過在參數LMC_KEEP中指定模塊的路徑,可以將
@@ -200,9 +200,10 @@ Linux內核5.x版本 <http://kernel.org/> "make localyesconfig" 與localmodconfig類似,只是它會將所有模塊選項轉換 爲內置(=y)。你可以同時通過LMC_KEEP保留模塊。 - "make kvmconfig" 爲kvm客體內核支持啓用其他選項。 + "make kvm_guest.config" + 爲kvm客戶機內核支持啓用其他選項。 - "make xenconfig" 爲xen dom0客體內核支持啓用其他選項。 + "make xen.config" 爲xen dom0客戶機內核支持啓用其他選項。 "make tinyconfig" 配置儘可能小的內核。
@@ -218,10 +219,10 @@ Linux內核5.x版本 <http://kernel.org/> 這種情況下,數學仿真永遠不會被使用。內核會稍微大一點,但不管 是否有數學協處理器,都可以在不同的機器上工作。 - - 「kernel hacking」配置細節通常會導致更大或更慢的內核(或兩者 + - “kernel hacking”配置細節通常會導致更大或更慢的內核(或兩者 兼而有之),甚至可以通過配置一些例程來主動嘗試破壞壞代碼以發現 內核問題,從而降低內核的穩定性(kmalloc())。因此,您可能應該 - 用於研究「開發」、「實驗」或「調試」特性相關問題。 + 用於研究“開發”、“實驗”或“調試”特性相關問題。 編譯內核 ---------
@@ -229,10 +230,8 @@ Linux內核5.x版本 <http://kernel.org/> - 確保您至少有gcc 5.1可用。 有關更多信息,請參閱 :ref:`Documentation/process/changes.rst <changes>` 。 - 請注意,您仍然可以使用此內核運行a.out用戶程序。 - - 執行 ``make`` 來創建壓縮內核映像。如果您安裝了lilo以適配內核makefile, - 那麼也可以進行 ``makeinstall`` ,但是您可能需要先檢查特定的lilo設置。 + 那麼也可以進行 ``make install`` ,但是您可能需要先檢查特定的lilo設置。 實際安裝必須以root身份執行,但任何正常構建都不需要。 無須徒然使用root身份。
@@ -242,8 +241,8 @@ Linux內核5.x版本 <http://kernel.org/> - 詳細的內核編譯/生成輸出: 通常,內核構建系統在相當安靜的模式下運行(但不是完全安靜)。但是有時您或 - 其他內核開發人員需要看到編譯、連結或其他命令的執行過程。爲此,可使用 - 「verbose(詳細)」構建模式。 + 其他內核開發人員需要看到編譯、鏈接或其他命令的執行過程。爲此,可使用 + “verbose(詳細)”構建模式。 向 ``make`` 命令傳遞 ``V=1`` 來實現,例如:: make V=1 all
@@ -255,15 +254,15 @@ Linux內核5.x版本 <http://kernel.org/> 與工作內核版本號相同的新內核,請在進行 ``make modules_install`` 安裝 之前備份modules目錄。 - 或者,在編譯之前,使用內核配置選項「LOCALVERSION」向常規內核版本附加 - 一個唯一的後綴。LOCALVERSION可以在「General Setup」菜單中設置。 + 或者,在編譯之前,使用內核配置選項“LOCALVERSION”向常規內核版本附加 + 一個唯一的後綴。LOCALVERSION可以在“General Setup”菜單中設置。 - 爲了引導新內核,您需要將內核映像(例如編譯後的 .../linux/arch/x86/boot/bzImage)複製到常規可引導內核的位置。 - 不再支持在沒有LILO等啓動裝載程序幫助的情況下直接從軟盤引導內核。 - 如果從硬碟引導Linux,很可能使用LILO,它使用/etc/lilo.conf文件中 + 如果從硬盤引導Linux,很可能使用LILO,它使用/etc/lilo.conf文件中 指定的內核映像文件。內核映像文件通常是/vmlinuz、/boot/vmlinuz、 /bzImage或/boot/bzImage。使用新內核前,請保存舊映像的副本,並複製 新映像覆蓋舊映像。然後您【必須重新運行LILO】來更新加載映射!否則,
@@ -284,68 +283,13 @@ Linux內核5.x版本 <http://kernel.org/> 若遇到問題 ----------- - - 如果您發現了一些可能由於內核缺陷所導致的問題,請檢查MAINTAINERS(維護者) - 文件看看是否有人與令您遇到麻煩的內核部分相關。如果無人在此列出,那麼第二 - 個最好的方案就是把它們發給我([email protected]),也可能發送 - 到任何其他相關的郵件列表或新聞組。 - - - 在所有的缺陷報告中,【請】告訴我們您在說什麼內核,如何復現問題,以及您的 - 設置是什麼的(使用您的常識)。如果問題是新的,請告訴我;如果問題是舊的, - 請嘗試告訴我您什麼時候首次注意到它。 - - - 如果缺陷導致如下消息:: - - 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(錯誤地)忽略了編譯內核的起始 - 偏移量。 +如果您發現了一些可能由於內核缺陷所導致的問題,請參閱: +Documentation/translations/zh_CN/admin-guide/reporting-issues.rst 。 + +想要理解內核錯誤報告,請參閱: +Documentation/translations/zh_CN/admin-guide/bug-hunting.rst 。 + +更多用GDB調試內核的信息,請參閱: +Documentation/translations/zh_CN/dev-tools/gdb-kernel-debugging.rst +和 Documentation/dev-tools/kgdb.rst 。
Documentation/translations/zh_TW/admin-guide/bootconfig.rst new file +294 -0
294 lines not on this page · raw message
Documentation/translations/zh_TW/admin-guide/bug-bisect.rst +6 -6
@@ -7,7 +7,7 @@ :譯者: 吳想成 Wu XiangCheng <[email protected]> - 胡皓文 Hu Haowen <[email protected]> + 胡皓文 Hu Haowen <[email protected]> 二分(bisect)缺陷 +++++++++++++++++++
@@ -17,14 +17,14 @@ 引言 ===== -始終嘗試由來自kernel.org的原始碼構建的最新內核。如果您沒有信心這樣做,請將 +始終嘗試由來自kernel.org的源代碼構建的最新內核。如果您沒有信心這樣做,請將 錯誤報告給您的發行版供應商,而不是內核開發人員。 找到缺陷(bug)並不總是那麼容易,不過仍然得去找。如果你找不到它,不要放棄。 -儘可能多的向相關維護人員報告您發現的信息。請參閱MAINTAINERS文件以了解您所 +儘可能多的向相關維護人員報告您發現的信息。請參閱MAINTAINERS文件以瞭解您所 關注的子系統的維護人員。 -在提交錯誤報告之前,請閱讀「Documentation/admin-guide/reporting-issues.rst」。 +在提交錯誤報告之前,請閱讀“Documentation/admin-guide/reporting-issues.rst”。 設備未出現(Devices not appearing) ====================================
@@ -38,7 +38,7 @@ 操作步驟: -- 從git原始碼構建內核 +- 從git源代碼構建內核 - 以此開始二分 [#f1]_:: $ git bisect start
@@ -76,7 +76,7 @@ 如需進一步參考,請閱讀: - ``git-bisect`` 的手冊頁 -- `Fighting regressions with git bisect(用git bisect解決回歸) +- `Fighting regressions with git bisect(用git bisect解決迴歸) <https://www.kernel.org/pub/software/scm/git/docs/git-bisect-lk2009.html>`_ - `Fully automated bisecting with "git bisect run"(使用git bisect run 來全自動二分) <https://lwn.net/Articles/317154>`_
Documentation/translations/zh_TW/admin-guide/bug-hunting.rst +20 -20
@@ -7,7 +7,7 @@ :譯者: 吳想成 Wu XiangCheng <[email protected]> - 胡皓文 Hu Haowen <[email protected]> + 胡皓文 Hu Haowen <[email protected]> 追蹤缺陷 =========
@@ -48,8 +48,8 @@ [<c1549f43>] ? sysenter_past_esp+0x40/0x6a ---[ end trace 6ebc60ef3981792f ]--- -這樣的堆棧跟蹤提供了足夠的信息來識別內核原始碼中發生錯誤的那一行。根據問題的 -嚴重性,它還可能包含 **「Oops」** 一詞,比如:: +這樣的堆棧跟蹤提供了足夠的信息來識別內核源代碼中發生錯誤的那一行。根據問題的 +嚴重性,它還可能包含 **“Oops”** 一詞,比如:: BUG: unable to handle kernel NULL pointer dereference at (null) IP: [<c06969d4>] iret_exc+0x7d0/0xa59
@@ -58,17 +58,17 @@ ... 儘管有 **Oops** 或其他類型的堆棧跟蹤,但通常需要找到出問題的行來識別和處理缺 -陷。在本章中,我們將參考「Oops」來了解需要分析的各種堆棧跟蹤。 +陷。在本章中,我們將參考“Oops”來了解需要分析的各種堆棧跟蹤。 如果內核是用 ``CONFIG_DEBUG_INFO`` 編譯的,那麼可以使用文件: `scripts/decode_stacktrace.sh` 。 -連結的模塊 +鏈接的模塊 ----------- -受到汙染或正在加載/卸載的模塊用「(…)」標記,汙染標誌在 -`Documentation/admin-guide/tainted-kernels.rst` 文件中進行了描述,「正在被加 -載」用「+」標註,「正在被卸載」用「-」標註。 +受到污染或正在加載/卸載的模塊用“(…)”標記,污染標誌在 +`Documentation/admin-guide/tainted-kernels.rst` 文件中進行了描述,“正在被加 +載”用“+”標註,“正在被卸載”用“-”標註。 Oops消息在哪?
@@ -81,19 +81,19 @@ syslog文件,通常是 ``/var/log/messages`` (取決於 ``/etc/syslog.conf`` 有時 ``klogd`` 會掛掉,這種情況下您可以運行 ``dmesg > file`` 從內核緩衝區 讀取數據並保存它。或者您可以 ``cat /proc/kmsg > file`` ,但是您必須適時 -中斷以停止傳輸,因爲 ``kmsg`` 是一個「永無止境的文件」。 +中斷以停止傳輸,因爲 ``kmsg`` 是一個“永無止境的文件”。 -如果機器嚴重崩潰,無法輸入命令或磁碟不可用,那還有三個選項: +如果機器嚴重崩潰,無法輸入命令或磁盤不可用,那還有三個選項: (1) 手動複製屏幕上的文本,並在機器重新啓動後輸入。很難受,但這是突然崩潰下 - 唯一的選擇。或者你可以用數位相機拍下屏幕——雖然不那麼好,但總比什麼都沒 - 有好。如果消息滾動超出控制台頂部,使用更高解析度(例如 ``vga=791`` ) - 引導啓動將允許您閱讀更多文本。(警告:這需要 ``vesafb`` ,因此對「早期」 + 唯一的選擇。或者你可以用數碼相機拍下屏幕——雖然不那麼好,但總比什麼都沒 + 有好。如果消息滾動超出控制檯頂部,使用更高分辨率(例如 ``vga=791`` ) + 引導啓動將允許您閱讀更多文本。(警告:這需要 ``vesafb`` ,因此對“早期” 的Oppses沒有幫助) (2) 從串口終端啓動(參見 :ref:`Documentation/admin-guide/serial-console.rst <serial_console>` ), - 在另一台機器上運行數據機然後用你喜歡的通信程序捕獲輸出。 + 在另一臺機器上運行調制解調器然後用你喜歡的通信程序捕獲輸出。 Minicom運行良好。 (3) 使用Kdump(參閱 Documentation/admin-guide/kdump/kdump.rst ),使用
@@ -103,7 +103,7 @@ syslog文件,通常是 ``/var/log/messages`` (取決於 ``/etc/syslog.conf`` 找到缺陷位置 ------------- -如果你能指出缺陷在內核原始碼中的位置,則報告缺陷的效果會非常好。這有兩種方法。 +如果你能指出缺陷在內核源代碼中的位置,則報告缺陷的效果會非常好。這有兩種方法。 通常來說使用 ``gdb`` 會比較容易,不過內核需要用調試信息來預編譯。 gdb
@@ -187,7 +187,7 @@ GNU 調試器(GNU debugger, ``gdb`` )是從 ``vmlinux`` 文件中找出OOP objdump ^^^^^^^^ -要調試內核,請使用objdump並從崩潰輸出中查找十六進位偏移,以找到有效的代碼/匯 +要調試內核,請使用objdump並從崩潰輸出中查找十六進制偏移,以找到有效的代碼/匯 編行。如果沒有調試符號,您將看到所示例程的彙編程序代碼,但是如果內核有調試 符號,C代碼也將可見(調試符號可以在內核配置菜單的hacking項中啓用)。例如::
@@ -197,7 +197,7 @@ objdump 您需要處於內核樹的頂層以便此獲得您的C文件。 -如果您無法訪問原始碼,仍然可以使用以下方法調試一些崩潰轉儲(如Dave Miller的 +如果您無法訪問源代碼,仍然可以使用以下方法調試一些崩潰轉儲(如Dave Miller的 示例崩潰轉儲輸出所示):: EIP is at +0x14/0x4c0
@@ -234,9 +234,9 @@ objdump 報告缺陷 --------- -一旦你通過定位缺陷找到了其發生的地方,你可以嘗試自己修復它或者向上游報告它。 +一旦你通過定位缺陷找到了其發生的地方,你可以嘗試自己修復它或者向上遊報告它。 -爲了向上游報告,您應該找出用於開發受影響代碼的郵件列表。這可以使用 ``get_maintainer.pl`` 。 +爲了向上遊報告,您應該找出用於開發受影響代碼的郵件列表。這可以使用 ``get_maintainer.pl`` 。 例如,您在gspca的sonixj.c文件中發現一個缺陷,則可以通過以下方法找到它的維護者::
@@ -251,7 +251,7 @@ objdump 請注意它將指出: -- 最後接觸原始碼的開發人員(如果這是在git樹中完成的)。在上面的例子中是Tejun +- 最後接觸源代碼的開發人員(如果這是在git樹中完成的)。在上面的例子中是Tejun 和Bhaktipriya(在這個特定的案例中,沒有人真正參與這個文件的開發); - 驅動維護人員(Hans Verkuil); - 子系統維護人員(Mauro Carvalho Chehab);
Documentation/translations/zh_TW/admin-guide/clearing-warn-once.rst +3 -3
@@ -2,15 +2,15 @@ .. include:: ../disclaimer-zh_TW.rst -:Translator: 胡皓文 Hu Haowen <[email protected]> +:Translator: 胡皓文 Hu Haowen <[email protected]> 清除 WARN_ONCE -------------- -WARN_ONCE / WARN_ON_ONCE / printk_once 僅僅列印一次消息. +WARN_ONCE / WARN_ON_ONCE / printk_once 僅僅打印一次消息. echo 1 > /sys/kernel/debug/clear_warn_once -可以清除這種狀態並且再次允許列印一次告警信息,這對於運行測試集後重現問題 +可以清除這種狀態並且再次允許打印一次告警信息,這對於運行測試集後重現問題 很有用。
Documentation/translations/zh_TW/admin-guide/cpu-load.rst +5 -5
@@ -2,7 +2,7 @@ .. include:: ../disclaimer-zh_TW.rst -:Translator: 胡皓文 Hu Haowen <[email protected]> +:Translator: 胡皓文 Hu Haowen <[email protected]> ======== CPU 負載
@@ -20,13 +20,13 @@ Linux通過``/proc/stat``和``/proc/uptime``導出各種信息,用戶空間工 ... -這裡系統認爲在默認採樣周期內有10.01%的時間工作在用戶空間,2.92%的時 +這裏系統認爲在默認採樣週期內有10.01%的時間工作在用戶空間,2.92%的時 間用在系統空間,總體上有81.63%的時間是空閒的。 大多數情況下``/proc/stat``的信息幾乎真實反映了系統信息,然而,由於內 核採集這些數據的方式/時間的特點,有時這些信息根本不可靠。 -那麼這些信息是如何被搜集的呢?每當時間中斷觸發時,內核查看此刻運行的 +那麼這些信息是如何被蒐集的呢?每當時間中斷觸發時,內核查看此刻運行的 進程類型,並增加與此類型/狀態進程對應的計數器的值。這種方法的問題是 在兩次時間中斷之間系統(進程)能夠在多種狀態之間切換多次,而計數器只 增加最後一種狀態下的計數。
@@ -34,7 +34,7 @@ Linux通過``/proc/stat``和``/proc/uptime``導出各種信息,用戶空間工 舉例 --- -假設系統有一個進程以如下方式周期性地占用cpu:: +假設系統有一個進程以如下方式週期性地佔用cpu:: 兩個時鐘中斷之間的時間線 |-----------------------|
@@ -46,7 +46,7 @@ Linux通過``/proc/stat``和``/proc/uptime``導出各種信息,用戶空間工 在上面的情況下,根據``/proc/stat``的信息(由於當系統處於空閒狀態時, 時間中斷經常會發生)系統的負載將會是0 -大家能夠想像內核的這種行爲會發生在許多情況下,這將導致``/proc/stat`` +大家能夠想象內核的這種行爲會發生在許多情況下,這將導致``/proc/stat`` 中存在相當古怪的信息:: /* gcc -o hog smallhog.c */
Documentation/translations/zh_TW/admin-guide/cputopology.rst new file +98 -0
98 lines not on this page · raw message
Documentation/translations/zh_TW/admin-guide/index.rst +68 -68
187 lines not on this page · raw message
Documentation/translations/zh_TW/admin-guide/init.rst +19 -19
@@ -7,10 +7,10 @@ :譯者: 吳想成 Wu XiangCheng <[email protected]> - 胡皓文 Hu Haowen <[email protected]> + 胡皓文 Hu Haowen <[email protected]> -解釋「No working init found.」啓動掛起消息 -========================================== +解釋“No working init found.”啓動掛起消息 +========================================= :作者:
@@ -18,41 +18,41 @@ Cristian Souza <cristianmsbr at gmail period com> -本文檔提供了加載初始化二進位(init binary)失敗的一些高層級原因(大致按執行 +本文檔提供了加載初始化二進制(init binary)失敗的一些高層級原因(大致按執行 順序列出)。 -1) **無法掛載根文件系統Unable to mount root FS** :請設置「debug」內核參數(在 +1) **無法掛載根文件系統Unable to mount root FS** :請設置“debug”內核參數(在 引導加載程序bootloader配置文件或CONFIG_CMDLINE)以獲取更詳細的內核消息。 -2) **初始化二進位不存在於根文件系統上init binary doesn't exist on rootfs** : +2) **初始化二進制不存在於根文件系統上init binary doesn't exist on rootfs** : 確保您的根文件系統類型正確(並且 ``root=`` 內核參數指向正確的分區);擁有 - 所需的驅動程序,例如SCSI或USB等存儲硬體;文件系統(ext3、jffs2等)是內建的 + 所需的驅動程序,例如SCSI或USB等存儲硬件;文件系統(ext3、jffs2等)是內建的 (或者作爲模塊由initrd預加載)。 -3) **控制台設備損壞Broken console device** : ``console= setup`` 中可能存在 - 衝突 --> 初始控制台不可用(initial console unavailable)。例如,由於串行 - IRQ問題(如缺少基於中斷的配置)導致的某些串行控制台不可靠。嘗試使用不同的 +3) **控制檯設備損壞Broken console device** : ``console= setup`` 中可能存在 + 衝突 --> 初始控制檯不可用(initial console unavailable)。例如,由於串行 + IRQ問題(如缺少基於中斷的配置)導致的某些串行控制檯不可靠。嘗試使用不同的 ``console= device`` 或像 ``netconsole=`` 。 -4) **二進位存在但依賴項不可用Binary exists but dependencies not available** : - 例如初始化二進位的必需庫依賴項,像 ``/lib/ld-linux.so.2`` 丟失或損壞。使用 +4) **二進制存在但依賴項不可用Binary exists but dependencies not available** : + 例如初始化二進制的必需庫依賴項,像 ``/lib/ld-linux.so.2`` 丟失或損壞。使用 ``readelf -d <INIT>|grep NEEDED`` 找出需要哪些庫。 -5) **無法加載二進位Binary cannot be loaded** :請確保二進位的體系結構與您的 - 硬體匹配。例如i386不匹配x86_64,或者嘗試在ARM硬體上加載x86。如果您嘗試在 - 此處加載非二進位文件(shell腳本?),您應該確保腳本在其工作頭(shebang +5) **無法加載二進制Binary cannot be loaded** :請確保二進制的體系結構與您的 + 硬件匹配。例如i386不匹配x86_64,或者嘗試在ARM硬件上加載x86。如果您嘗試在 + 此處加載非二進制文件(shell腳本?),您應該確保腳本在其工作頭(shebang header)行 ``#!/...`` 中指定能正常工作的解釋器(包括其庫依賴項)。在處理 - 腳本之前,最好先測試一個簡單的非腳本二進位文件,比如 ``/bin/sh`` ,並確認 + 腳本之前,最好先測試一個簡單的非腳本二進制文件,比如 ``/bin/sh`` ,並確認 它能成功執行。要了解更多信息,請將代碼添加到 ``init/main.c`` 以顯示 kernel_execve()的返回值。 -當您發現新的失敗原因時,請擴展本解釋(畢竟加載初始化二進位是一個 **關鍵** 且 +當您發現新的失敗原因時,請擴展本解釋(畢竟加載初始化二進制是一個 **關鍵** 且 艱難的過渡步驟,需要儘可能無痛地進行),然後向LKML提交一個補丁。 待辦事項: - 通過一個可以存儲 ``kernel_execve()`` 結果值的結構體數組實現各種 - ``run_init_process()`` 調用,並在失敗時通過疊代 **所有** 結果來記錄一切 + ``run_init_process()`` 調用,並在失敗時通過迭代 **所有** 結果來記錄一切 (非常重要的可用性修復)。 -- 試著使實現本身在一般情況下更有幫助,例如在受影響的地方提供額外的錯誤消息。 +- 試着使實現本身在一般情況下更有幫助,例如在受影響的地方提供額外的錯誤消息。
Documentation/translations/zh_TW/admin-guide/lockup-watchdogs.rst new file +69 -0
69 lines not on this page · raw message
Documentation/translations/zh_TW/admin-guide/mm/damon/index.rst new file +31 -0
@@ -0,0 +1,31 @@ +.. SPDX-License-Identifier: GPL-2.0 + +.. include:: ../../../disclaimer-zh_TW.rst + +:Original: Documentation/admin-guide/mm/damon/index.rst + +:翻譯: + + 司延騰 Yanteng Si <[email protected]> + +:校譯: + +============ +監測數據訪問 +============ + +:doc:`DAMON </mm/damon/index>` 允許輕量級的數據訪問監測。使用DAMON, +用戶可以分析他們系統的內存訪問模式,並優化它們。 + +.. toctree:: + :maxdepth: 2 + + start + usage + reclaim + lru_sort + + + + +
Documentation/translations/zh_TW/admin-guide/mm/damon/lru_sort.rst new file +265 -0
265 lines not on this page · raw message
Documentation/translations/zh_TW/admin-guide/mm/damon/reclaim.rst new file +230 -0
230 lines not on this page · raw message
Documentation/translations/zh_TW/admin-guide/mm/damon/start.rst new file +126 -0
126 lines not on this page · raw message
Documentation/translations/zh_TW/admin-guide/mm/damon/usage.rst new file +593 -0
593 lines not on this page · raw message
Documentation/translations/zh_TW/admin-guide/mm/index.rst new file +52 -0
52 lines not on this page · raw message
Documentation/translations/zh_TW/admin-guide/mm/ksm.rst new file +201 -0
201 lines not on this page · raw message
Documentation/translations/zh_TW/admin-guide/reporting-issues.rst +381 -348
261 lines not on this page · raw message
Documentation/translations/zh_TW/admin-guide/reporting-regressions.rst new file +371 -0
371 lines not on this page · raw message
Documentation/translations/zh_TW/admin-guide/security-bugs.rst +14 -14
Lines of this file are not shown. View the raw message.
Documentation/translations/zh_TW/admin-guide/sysrq.rst new file +283 -0
283 lines not on this page · raw message
Documentation/translations/zh_TW/admin-guide/tainted-kernels.rst +43 -43
86 lines not on this page · raw message
Documentation/translations/zh_TW/admin-guide/unicode.rst +6 -6
Lines of this file are not shown. View the raw message.
The rest of this diff is not shown. View the raw message.
Signature · 1 line
2.34.1
Part of the diff is not shown here. View the raw message.
PATCH v2 2/6 docs/zh_TW: update arch
In reply to Hu HaowenUpdate zh_TW's arch documentation concentrating on the following aspects:
* The file tree structure changes of the main documentation;
* Some changes and ideas from zh_CN translation;
* Removal for several obsoleted contents within the zh_TW translation or those which are not exising anymore in the main documentation.
* Replacements for some incorrect words and phrases in traditional Chinese or those which are odd within their context being hard for readers to comprehend.
--- .../translations/zh_TW/arch/arm/Booting | 176 +++++++++++ .../zh_TW/arch/arm/kernel_user_helpers.txt | 285 ++++++++++++++++++ .../translations/zh_TW/arch/arm64/amu.rst | 6 +- .../translations/zh_TW/arch/arm64/booting.txt | 26 +- .../zh_TW/arch/arm64/elf_hwcaps.rst | 10 +- .../zh_TW/arch/arm64/legacy_instructions.txt | 14 +- .../translations/zh_TW/arch/arm64/memory.txt | 16 +- .../translations/zh_TW/arch/arm64/perf.rst | 2 +- .../zh_TW/arch/arm64/silicon-errata.txt | 28 +- .../zh_TW/arch/arm64/tagged-pointers.txt | 10 +- .../translations/zh_TW/arch/index.rst | 30 ++ .../zh_TW/arch/openrisc/index.rst | 33 ++ .../zh_TW/arch/openrisc/openrisc_port.rst | 129 ++++++++ .../translations/zh_TW/arch/openrisc/todo.rst | 25 ++ .../zh_TW/arch/parisc/debugging.rst | 47 +++ .../translations/zh_TW/arch/parisc/index.rst | 32 ++ .../zh_TW/arch/parisc/registers.rst | 157 ++++++++++ Documentation/translations/zh_TW/index.rst | 5 +- 18 files changed, 973 insertions(+), 58 deletions(-) create mode 100644 Documentation/translations/zh_TW/arch/arm/Booting create mode 100644 Documentation/translations/zh_TW/arch/arm/kernel_user_helpers.txt create mode 100644 Documentation/translations/zh_TW/arch/index.rst create mode 100644 Documentation/translations/zh_TW/arch/openrisc/index.rst create mode 100644 Documentation/translations/zh_TW/arch/openrisc/openrisc_port.rst create mode 100644 Documentation/translations/zh_TW/arch/openrisc/todo.rst create mode 100644 Documentation/translations/zh_TW/arch/parisc/debugging.rst create mode 100644 Documentation/translations/zh_TW/arch/parisc/index.rst create mode 100644 Documentation/translations/zh_TW/arch/parisc/registers.rst
Documentation/translations/zh_TW/arch/arm/Booting new file +176 -0
@@ -0,0 +1,176 @@ +Chinese translated version of Documentation/arch/arm/booting.rst + +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. + +Maintainer: Russell King <[email protected]> +Chinese maintainer: Fu Wei <[email protected]> +--------------------------------------------------------------------- +Documentation/arch/arm/booting.rst 的中文翻譯 + +如果想評論或更新本文的內容,請直接聯繫原文檔的維護者。如果你使用英文 +交流有困難的話,也可以向中文版維護者求助。如果本翻譯更新不及時或者翻 +譯存在問題,請聯繫中文版維護者。 + +英文版維護者: Russell King <[email protected]> +中文版維護者: 傅煒 Fu Wei <[email protected]> +中文版翻譯者: 傅煒 Fu Wei <[email protected]> +中文版校譯者: 傅煒 Fu Wei <[email protected]> + +以下爲正文 +--------------------------------------------------------------------- + + 啓動 ARM Linux + ============== + +作者:Russell King +日期:2002年5月18日 + +以下文檔適用於 2.4.18-rmk6 及以上版本。 + +爲了啓動 ARM Linux,你需要一個引導裝載程序(boot loader), +它是一個在主內核啓動前運行的一個小程序。引導裝載程序需要初始化各種 +設備,並最終調用 Linux 內核,將信息傳遞給內核。 + +從本質上講,引導裝載程序應提供(至少)以下功能: + +1、設置和初始化 RAM。 +2、初始化一個串口。 +3、檢測機器的類型(machine type)。 +4、設置內核標籤列表(tagged list)。 +5、調用內核映像。 + + +1、設置和初始化 RAM +------------------- + +現有的引導加載程序: 強制 +新開發的引導加載程序: 強制 + +引導裝載程序應該找到並初始化系統中所有內核用於保持系統變量數據的 RAM。 +這個操作的執行是設備依賴的。(它可能使用內部算法來自動定位和計算所有 +RAM,或可能使用對這個設備已知的 RAM 信息,還可能使用任何引導裝載程序 +設計者想到的匹配方法。) + + +2、初始化一個串口 +----------------------------- + +現有的引導加載程序: 可選、建議 +新開發的引導加載程序: 可選、建議 + +引導加載程序應該初始化並使能一個目標板上的串口。這允許內核串口驅動 +自動檢測哪個串口用於內核控制檯。(一般用於調試或與目標板通信。) + +作爲替代方案,引導加載程序也可以通過標籤列表傳遞相關的'console=' +選項給內核以指定某個串口,而串口數據格式的選項在以下文檔中描述: + + Documentation/admin-guide/kernel-parameters.rst。 + + +3、檢測機器類型 +-------------------------- + +現有的引導加載程序: 可選 +新開發的引導加載程序: 強制 + +引導加載程序應該通過某些方式檢測自身所處的機器類型。這是一個硬件 +代碼或通過查看所連接的硬件用某些算法得到,這些超出了本文檔的範圍。 +引導加載程序最終必須能提供一個 MACH_TYPE_xxx 值給內核。 +(詳見 linux/arch/arm/tools/mach-types )。 + +4、設置啓動數據 +------------------ + +現有的引導加載程序: 可選、強烈建議 +新開發的引導加載程序: 強制 + +引導加載程序必須提供標籤列表或者 dtb 映像以傳遞配置數據給內核。啓動 +數據的物理地址通過寄存器 r2 傳遞給內核。 + +4a、設置內核標籤列表 +-------------------------------- + +bootloader 必須創建和初始化內核標籤列表。一個有效的標籤列表以 +ATAG_CORE 標籤開始,並以 ATAG_NONE 標籤結束。ATAG_CORE 標籤可以是 +空的,也可以是非空。一個空 ATAG_CORE 標籤其 size 域設置爲 +‘2’(0x00000002)。ATAG_NONE 標籤的 size 域必須設置爲零。 + +在列表中可以保存任意數量的標籤。對於一個重複的標籤是追加到之前標籤 +所攜帶的信息之後,還是會覆蓋原來的信息,是未定義的。某些標籤的行爲 +是前者,其他是後者。 + +bootloader 必須傳遞一個系統內存的位置和最小值,以及根文件系統位置。 +因此,最小的標籤列表如下所示: + + +-----------+ +基地址 -> | ATAG_CORE | | + +-----------+ | + | ATAG_MEM | | 地址增長方向 + +-----------+ | + | ATAG_NONE | | + +-----------+ v + +標籤列表應該保存在系統的 RAM 中。 + +標籤列表必須置於內核自解壓和 initrd'bootp' 程序都不會覆蓋的內存區。 +建議放在 RAM 的頭 16KiB 中。 + +4b、設置設備樹 +------------------------- + +bootloader 必須以 64bit 地址對齊的形式加載一個設備樹映像(dtb)到系統 +RAM 中,並用啓動數據初始化它。dtb 格式在文檔 +https://www.devicetree.org/specifications/ 中。內核將會在 +dtb 物理地址處查找 dtb 魔數值(0xd00dfeed),以確定 dtb 是否已經代替 +標籤列表被傳遞進來。 + +bootloader 必須傳遞一個系統內存的位置和最小值,以及根文件系統位置。 +dtb 必須置於內核自解壓不會覆蓋的內存區。建議將其放置於 RAM 的頭 16KiB +中。但是不可將其放置於“0”物理地址處,因爲內核認爲:r2 中爲 0,意味着 +沒有標籤列表和 dtb 傳遞過來。 + +5、調用內核映像 +--------------------------- + +現有的引導加載程序: 強制 +新開發的引導加載程序: 強制 + +調用內核映像 zImage 有兩個選擇。如果 zImge 保存在 flash 中,且是爲了 +在 flash 中直接運行而被正確鏈接的。這樣引導加載程序就可以在 flash 中 +直接調用 zImage。 + +zImage 也可以被放在系統 RAM(任意位置)中被調用。注意:內核使用映像 +基地址的前 16KB RAM 空間來保存頁表。建議將映像置於 RAM 的 32KB 處。 + +對於以上任意一種情況,都必須符合以下啓動狀態: + +- 停止所有 DMA 設備,這樣內存數據就不會因爲虛假網絡包或磁盤數據而被破壞。 + 這可能可以節省你許多的調試時間。 + +- CPU 寄存器配置 + r0 = 0, + r1 = (在上面 3 中獲取的)機器類型碼。 + r2 = 標籤列表在系統 RAM 中的物理地址,或 + 設備樹塊(dtb)在系統 RAM 中的物理地址 + +- CPU 模式 + 所有形式的中斷必須被禁止 (IRQs 和 FIQs) + CPU 必須處於 SVC 模式。(對於 Angel 調試有特例存在) + +- 緩存,MMUs + MMU 必須關閉。 + 指令緩存開啓或關閉都可以。 + 數據緩存必須關閉。 + +- 引導加載程序應該通過直接跳轉到內核映像的第一條指令來調用內核映像。 + + 對於支持 ARM 指令集的 CPU,跳入內核入口時必須處在 ARM 狀態,即使 + 對於 Thumb-2 內核也是如此。 + + 對於僅支持 Thumb 指令集的 CPU,比如 Cortex-M 系列的 CPU,跳入 + 內核入口時必須處於 Thumb 狀態。 +
Documentation/translations/zh_TW/arch/arm/kernel_user_helpers.txt new file +285 -0
285 lines not on this page · raw message
Documentation/translations/zh_TW/arch/arm64/amu.rst +3 -3
@@ -28,11 +28,11 @@ AArch64 Linux 中擴展的活動監控單元 AMUv1 架構實現了一個由4個固定的64位事件計數器組成的計數器組。 - - CPU 周期計數器:同 CPU 的頻率增長 + - CPU 週期計數器:同 CPU 的頻率增長 - 常量計數器:同固定的系統時鐘頻率增長 - 淘汰指令計數器: 同每次架構指令執行增長 - - 內存停頓周期計數器:計算由在時鐘域內的最後一級緩存中未命中而引起 - 的指令調度停頓周期數 + - 內存停頓週期計數器:計算由在時鐘域內的最後一級緩存中未命中而引起 + 的指令調度停頓週期數 當處於 WFI 或者 WFE 狀態時,計數器不會增長。
Documentation/translations/zh_TW/arch/arm64/booting.txt +13 -13
@@ -41,7 +41,7 @@ AArch64 異常模型由多個異常級(EL0 - EL3)組成,對於 EL0 和 EL1 有對應的安全和非安全模式。EL2 是系統管理級,且僅存在於非安全模式下。 EL3 是最高特權級,且僅存在於安全模式下。 -基於本文檔的目的,我們將簡單地使用『引導裝載程序』(『boot loader』) +基於本文檔的目的,我們將簡單地使用“引導裝載程序”(“boot loader”) 這個術語來定義在將控制權交給 Linux 內核前 CPU 上執行的所有軟體。 這可能包含安全監控和系統管理代碼,或者它可能只是一些用於準備最小啓動 環境的指令。
@@ -74,7 +74,7 @@ RAM,或可能使用對這個設備已知的 RAM 信息,還可能是引導裝 數據塊將在使能緩存的情況下以 2MB 粒度被映射,故其不能被置於必須以特定 屬性映射的2M區域內。 -註: v4.2 之前的版本同時要求設備樹數據塊被置於從內核映像以下 +注: v4.2 之前的版本同時要求設備樹數據塊被置於從內核映像以下 text_offset 字節處算起第一個 512MB 內。 3、解壓內核映像
@@ -106,7 +106,7 @@ AArch64 內核當前沒有提供自解壓代碼,因此如果使用了壓縮內 u32 res5; /* 保留 (用於 PE COFF 偏移) */ -映像頭注釋: +映像頭註釋: - 自 v3.17 起,除非另有說明,所有域都是小端模式。
@@ -143,7 +143,7 @@ AArch64 內核當前沒有提供自解壓代碼,因此如果使用了壓縮內 字節處,並從該處被調用。2MB 對齊基址和內核映像起始地址之間的區域對於 內核來說沒有特殊意義,且可能被用於其他目的。 從映像起始地址算起,最少必須準備 image_size 字節的空閒內存供內核使用。 -註: v4.6 之前的版本無法使用內核映像物理偏移以下的內存,所以當時建議 +注: v4.6 之前的版本無法使用內核映像物理偏移以下的內存,所以當時建議 將映像儘量放置在靠近系統內存起始的地方。 任何提供給內核的內存(甚至在映像起始地址之前),若未從內核中標記爲保留
@@ -151,7 +151,7 @@ AArch64 內核當前沒有提供自解壓代碼,因此如果使用了壓縮內 在跳轉入內核前,必須符合以下狀態: -- 停止所有 DMA 設備,這樣內存數據就不會因爲虛假網絡包或磁碟數據而 +- 停止所有 DMA 設備,這樣內存數據就不會因爲虛假網絡包或磁盤數據而 被破壞。這可能可以節省你許多的調試時間。 - 主 CPU 通用寄存器設置
@@ -175,7 +175,7 @@ AArch64 內核當前沒有提供自解壓代碼,因此如果使用了壓縮內 而不通過虛擬地址操作維護構架緩存的系統緩存(不推薦),必須被配置且 禁用。 - *譯者註:對於 PoC 以及緩存相關內容,請參考 ARMv8 構架參考手冊 + *譯者注:對於 PoC 以及緩存相關內容,請參考 ARMv8 構架參考手冊 ARM DDI 0487A - 架構計時器
@@ -189,7 +189,7 @@ AArch64 內核當前沒有提供自解壓代碼,因此如果使用了壓縮內 接收。 - 系統寄存器 - 在進入內核映像的異常級中,所有構架中可寫的系統寄存器必須通過軟體 + 在進入內核映像的異常級中,所有構架中可寫的系統寄存器必須通過軟件 在一個更高的異常級別下初始化,以防止在 未知 狀態下運行。 對於擁有 GICv3 中斷控制器並以 v3 模式運行的系統:
@@ -214,14 +214,14 @@ AArch64 內核當前沒有提供自解壓代碼,因此如果使用了壓縮內 引導裝載程序必須在每個 CPU 處於以下狀態時跳入內核入口: - 主 CPU 必須直接跳入內核映像的第一條指令。通過此 CPU 傳遞的設備樹 - 數據塊必須在每個 CPU 節點中包含一個 『enable-method』 屬性,所 + 數據塊必須在每個 CPU 節點中包含一個 ‘enable-method’ 屬性,所 支持的 enable-method 請見下文。 引導裝載程序必須生成這些設備樹屬性,並在跳入內核入口之前將其插入 數據塊。 -- enable-method 爲 「spin-table」 的 CPU 必須在它們的 CPU - 節點中包含一個 『cpu-release-addr』 屬性。這個屬性標識了一個 +- enable-method 爲 “spin-table” 的 CPU 必須在它們的 CPU + 節點中包含一個 ‘cpu-release-addr’ 屬性。這個屬性標識了一個 64 位自然對齊且初始化爲零的內存位置。 這些 CPU 必須在內存保留區(通過設備樹中的 /memreserve/ 域傳遞
@@ -231,15 +231,15 @@ AArch64 內核當前沒有提供自解壓代碼,因此如果使用了壓縮內 時,CPU 必須跳入此值所指向的地址。此值爲一個單獨的 64 位小端值, 因此 CPU 須在跳轉前將所讀取的值轉換爲其本身的端模式。 -- enable-method 爲 「psci」 的 CPU 保持在內核外(比如,在 +- enable-method 爲 “psci” 的 CPU 保持在內核外(比如,在 memory 節點中描述爲內核空間的內存區外,或在通過設備樹 /memreserve/ 域中描述爲內核保留區的空間中)。內核將會發起在 ARM 文檔(編號 - ARM DEN 0022A:用於 ARM 上的電源狀態協調接口系統軟體)中描述的 + ARM DEN 0022A:用於 ARM 上的電源狀態協調接口系統軟件)中描述的 CPU_ON 調用來將 CPU 帶入內核。 *譯者注: ARM DEN 0022A 已更新到 ARM DEN 0022C。 - 設備樹必須包含一個 『psci』 節點,請參考以下文檔: + 設備樹必須包含一個 ‘psci’ 節點,請參考以下文檔: Documentation/devicetree/bindings/arm/psci.yaml
Documentation/translations/zh_TW/arch/arm64/elf_hwcaps.rst +5 -5
@@ -17,11 +17,11 @@ ARM64 ELF hwcaps 1. 簡介 ------- -有些硬體或軟體功能僅在某些 CPU 實現上和/或在具體某個內核配置上可用,但 +有些硬件或軟件功能僅在某些 CPU 實現上和/或在具體某個內核配置上可用,但 對於處於 EL0 的用戶空間代碼沒有可用的架構發現機制。內核通過在輔助向量表 公開一組稱爲 hwcaps 的標誌而把這些功能暴露給用戶空間。 -用戶空間軟體可以通過獲取輔助向量的 AT_HWCAP 或 AT_HWCAP2 條目來測試功能, +用戶空間軟件可以通過獲取輔助向量的 AT_HWCAP 或 AT_HWCAP2 條目來測試功能, 並測試是否設置了相關標誌,例如:: bool floating_point_is_present(void)
@@ -33,7 +33,7 @@ ARM64 ELF hwcaps return false; } -如果軟體依賴於 hwcap 描述的功能,在嘗試使用該功能前則應檢查相關的 hwcap +如果軟件依賴於 hwcap 描述的功能,在嘗試使用該功能前則應檢查相關的 hwcap 標誌以驗證該功能是否存在。 不能通過其他方式探查這些功能。當一個功能不可用時,嘗試使用它可能導致不可
@@ -44,8 +44,8 @@ ARM64 ELF hwcaps ---------------- 大多數 hwcaps 旨在說明通過架構 ID 寄存器(處於 EL0 的用戶空間代碼無法訪問) -描述的功能的存在。這些 hwcap 通過 ID 寄存器欄位定義,並且應根據 ARM 體系 -結構參考手冊(ARM ARM)中定義的欄位來解釋說明。 +描述的功能的存在。這些 hwcap 通過 ID 寄存器字段定義,並且應根據 ARM 體系 +結構參考手冊(ARM ARM)中定義的字段來解釋說明。 這些 hwcaps 以下面的形式描述::
Documentation/translations/zh_TW/arch/arm64/legacy_instructions.txt +7 -7
@@ -31,7 +31,7 @@ Documentation/arch/arm64/legacy_instructions.rst 的中文翻譯 以下爲正文 --------------------------------------------------------------------- Linux 內核在 arm64 上的移植提供了一個基礎框架,以支持構架中正在被淘汰或已廢棄指令的模擬執行。 -這個基礎框架的代碼使用未定義指令鉤子(hooks)來支持模擬。如果指令存在,它也允許在硬體中啓用該指令。 +這個基礎框架的代碼使用未定義指令鉤子(hooks)來支持模擬。如果指令存在,它也允許在硬件中啓用該指令。 模擬模式可通過寫 sysctl 節點(/proc/sys/abi)來控制。 不同的執行方式及 sysctl 節點的相應值,解釋如下:
@@ -42,18 +42,18 @@ Linux 內核在 arm64 上的移植提供了一個基礎框架,以支持構架 * Emulate(模擬) 值: 1 - 使用軟體模擬方式。爲解決軟體遷移問題,這種模擬指令模式的使用是被跟蹤的,並會發出速率限制警告。 + 使用軟件模擬方式。爲解決軟件遷移問題,這種模擬指令模式的使用是被跟蹤的,並會發出速率限制警告。 它是那些構架中正在被淘汰的指令,如 CP15 barriers(隔離指令),的默認處理方式。 -* Hardware Execution(硬體執行) +* Hardware Execution(硬件執行) 值: 2 - 雖然標記爲正在被淘汰,但一些實現可能提供硬體執行這些指令的使能/禁用操作。 - 使用硬體執行一般會有更好的性能,但將無法收集運行時對正被淘汰指令的使用統計數據。 + 雖然標記爲正在被淘汰,但一些實現可能提供硬件執行這些指令的使能/禁用操作。 + 使用硬件執行一般會有更好的性能,但將無法收集運行時對正被淘汰指令的使用統計數據。 默認執行模式依賴於指令在構架中狀態。正在被淘汰的指令應該以模擬(Emulate)作爲默認模式, 而已廢棄的指令必須默認使用未定義(Undef)模式 -注意:指令模擬可能無法應對所有情況。更多詳情請參考單獨的指令注釋。 +注意:指令模擬可能無法應對所有情況。更多詳情請參考單獨的指令註釋。 受支持的遺留指令 -------------
@@ -71,7 +71,7 @@ Linux 內核在 arm64 上的移植提供了一個基礎框架,以支持構架 節點: /proc/sys/abi/setend 狀態: 正被淘汰,不推薦使用 默認執行方式: Emulate (1)* -註:爲了使能這個特性,系統中的所有 CPU 必須在 EL0 支持混合字節序。 +注:爲了使能這個特性,系統中的所有 CPU 必須在 EL0 支持混合字節序。 如果一個新的 CPU (不支持混合字節序) 在使能這個特性後被熱插入系統, 在應用中可能會出現不可預期的結果。
Documentation/translations/zh_TW/arch/arm64/memory.txt +8 -8
@@ -28,17 +28,17 @@ Documentation/arch/arm64/memory.rst 的中文翻譯 以下爲正文 --------------------------------------------------------------------- - Linux 在 AArch64 中的內存布局 + Linux 在 AArch64 中的內存佈局 =========================== 作者: Catalin Marinas <[email protected]> -本文檔描述 AArch64 Linux 內核所使用的虛擬內存布局。此構架可以實現 +本文檔描述 AArch64 Linux 內核所使用的虛擬內存佈局。此構架可以實現 頁大小爲 4KB 的 4 級轉換表和頁大小爲 64KB 的 3 級轉換表。 AArch64 Linux 使用 3 級或 4 級轉換表,其頁大小配置爲 4KB,對於用戶和內核 分別都有 39-bit (512GB) 或 48-bit (256TB) 的虛擬地址空間。 -對於頁大小爲 64KB的配置,僅使用 2 級轉換表,有 42-bit (4TB) 的虛擬地址空間,但內存布局相同。 +對於頁大小爲 64KB的配置,僅使用 2 級轉換表,有 42-bit (4TB) 的虛擬地址空間,但內存佈局相同。 用戶地址空間的 63:48 位爲 0,而內核地址空間的相應位爲 1。TTBRx 的 選擇由虛擬地址的 63 位給出。swapper_pg_dir 僅包含內核(全局)映射,
@@ -46,7 +46,7 @@ AArch64 Linux 使用 3 級或 4 級轉換表,其頁大小配置爲 4KB,對 TTBR1 中,且從不寫入 TTBR0。 -AArch64 Linux 在頁大小爲 4KB,並使用 3 級轉換表時的內存布局: +AArch64 Linux 在頁大小爲 4KB,並使用 3 級轉換表時的內存佈局: 起始地址 結束地址 大小 用途 -----------------------------------------------------------------------
@@ -54,7 +54,7 @@ AArch64 Linux 在頁大小爲 4KB,並使用 3 級轉換表時的內存布局 ffffff8000000000 ffffffffffffffff 512GB 內核空間 -AArch64 Linux 在頁大小爲 4KB,並使用 4 級轉換表時的內存布局: +AArch64 Linux 在頁大小爲 4KB,並使用 4 級轉換表時的內存佈局: 起始地址 結束地址 大小 用途 -----------------------------------------------------------------------
@@ -62,7 +62,7 @@ AArch64 Linux 在頁大小爲 4KB,並使用 4 級轉換表時的內存布局 ffff000000000000 ffffffffffffffff 256TB 內核空間 -AArch64 Linux 在頁大小爲 64KB,並使用 2 級轉換表時的內存布局: +AArch64 Linux 在頁大小爲 64KB,並使用 2 級轉換表時的內存佈局: 起始地址 結束地址 大小 用途 -----------------------------------------------------------------------
@@ -70,7 +70,7 @@ AArch64 Linux 在頁大小爲 64KB,並使用 2 級轉換表時的內存布局 fffffc0000000000 ffffffffffffffff 4TB 內核空間 -AArch64 Linux 在頁大小爲 64KB,並使用 3 級轉換表時的內存布局: +AArch64 Linux 在頁大小爲 64KB,並使用 3 級轉換表時的內存佈局: 起始地址 結束地址 大小 用途 -----------------------------------------------------------------------
@@ -78,7 +78,7 @@ AArch64 Linux 在頁大小爲 64KB,並使用 3 級轉換表時的內存布局 ffff000000000000 ffffffffffffffff 256TB 內核空間 -更詳細的內核虛擬內存布局,請參閱內核啓動信息。 +更詳細的內核虛擬內存佈局,請參閱內核啓動信息。 4KB 頁大小的轉換表查找:
Documentation/translations/zh_TW/arch/arm64/perf.rst +1 -1
@@ -59,7 +59,7 @@ EL2(VHE 內核 或 non-VHE 虛擬機監控器)。 KVM 客戶機可能運行在 EL0(用戶空間)和 EL1(內核)。 -由於宿主機和客戶機之間重疊的異常級別,我們不能僅僅依靠 PMU 的硬體異 +由於宿主機和客戶機之間重疊的異常級別,我們不能僅僅依靠 PMU 的硬件異 常過濾機制-因此我們必須啓用/禁用對於客戶機進入和退出的計數。而這在 VHE 和 non-VHE 系統上表現不同。
Documentation/translations/zh_TW/arch/arm64/silicon-errata.txt +14 -14
@@ -28,39 +28,39 @@ Documentation/arch/arm64/silicon-errata.rst 的中文翻譯 以下爲正文 --------------------------------------------------------------------- - 晶片勘誤和軟體補救措施 + 芯片勘誤和軟件補救措施 ================== 作者: Will Deacon <[email protected]> 日期: 2015年11月27日 -一個不幸的現實:硬體經常帶有一些所謂的「瑕疵(errata)」,導致其在 -某些特定情況下會違背構架定義的行爲。就基於 ARM 的硬體而言,這些瑕疵 +一個不幸的現實:硬件經常帶有一些所謂的“瑕疵(errata)”,導致其在 +某些特定情況下會違背構架定義的行爲。就基於 ARM 的硬件而言,這些瑕疵 大體可分爲以下幾類: A 類:無可行補救措施的嚴重缺陷。 B 類:有可接受的補救措施的重大或嚴重缺陷。 C 類:在正常操作中不會顯現的小瑕疵。 -更多資訊,請在 infocenter.arm.com (需註冊)中查閱「軟體開發者勘誤 -筆記」(「Software Developers Errata Notice」)文檔。 +更多資訊,請在 infocenter.arm.com (需註冊)中查閱“軟件開發者勘誤 +筆記”(“Software Developers Errata Notice”)文檔。 -對於 Linux 而言,B 類缺陷可能需要作業系統的某些特別處理。例如,避免 +對於 Linux 而言,B 類缺陷可能需要操作系統的某些特別處理。例如,避免 一個特殊的代碼序列,或是以一種特定的方式配置處理器。在某種不太常見的 情況下,爲將 A 類缺陷當作 C 類處理,可能需要用類似的手段。這些手段被 -統稱爲「軟體補救措施」,且僅在少數情況需要(例如,那些需要一個運行在 +統稱爲“軟件補救措施”,且僅在少數情況需要(例如,那些需要一個運行在 非安全異常級的補救措施 *並且* 能被 Linux 觸發的情況)。 -對於尚在討論中的可能對未受瑕疵影響的系統產生干擾的軟體補救措施,有一個 -相應的內核配置(Kconfig)選項被加在 「內核特性(Kernel Features)」-> -「基於可選方法框架的 ARM 瑕疵補救措施(ARM errata workarounds via +對於尚在討論中的可能對未受瑕疵影響的系統產生干擾的軟件補救措施,有一個 +相應的內核配置(Kconfig)選項被加在 “內核特性(Kernel Features)”-> +“基於可選方法框架的 ARM 瑕疵補救措施(ARM errata workarounds via the alternatives framework)"。這些選項被默認開啓,若探測到受影響的CPU, 補丁將在運行時被使用。至於對系統運行影響較小的補救措施,內核配置選項 -並不存在,且代碼以某種規避瑕疵的方式被構造(帶注釋爲宜)。 +並不存在,且代碼以某種規避瑕疵的方式被構造(帶註釋爲宜)。 -這種做法對於在任意內核原始碼樹中準確地判斷出哪個瑕疵已被軟體方法所補救 -稍微有點麻煩,所以在 Linux 內核中此文件作爲軟體補救措施的註冊表, -並將在新的軟體補救措施被提交和向後移植(backported)到穩定內核時被更新。 +這種做法對於在任意內核源代碼樹中準確地判斷出哪個瑕疵已被軟件方法所補救 +稍微有點麻煩,所以在 Linux 內核中此文件作爲軟件補救措施的註冊表, +並將在新的軟件補救措施被提交和向後移植(backported)到穩定內核時被更新。 | 實現者 | 受影響的組件 | 勘誤編號 | 內核配置 | +----------------+-----------------+-----------------+-------------------------+
Documentation/translations/zh_TW/arch/arm64/tagged-pointers.txt +5 -5
@@ -36,14 +36,14 @@ Documentation/arch/arm64/tagged-pointers.rst 的中文翻譯 AArch64 Linux 中的潛在用途。 內核提供的地址轉換表配置使通過 TTBR0 完成的虛擬地址轉換(即用戶空間 -映射),其虛擬地址的最高 8 位(63:56)會被轉換硬體所忽略。這種機制 -讓這些位可供應用程式自由使用,其注意事項如下: +映射),其虛擬地址的最高 8 位(63:56)會被轉換硬件所忽略。這種機制 +讓這些位可供應用程序自由使用,其注意事項如下: (1) 內核要求所有傳遞到 EL1 的用戶空間地址帶有 0x00 標記。 - 這意味著任何攜帶用戶空間虛擬地址的系統調用(syscall) + 這意味着任何攜帶用戶空間虛擬地址的系統調用(syscall) 參數 *必須* 在陷入內核前使它們的最高字節被清零。 - (2) 非零標記在傳遞信號時不被保存。這意味著在應用程式中利用了 + (2) 非零標記在傳遞信號時不被保存。這意味着在應用程序中利用了 標記的信號處理函數無法依賴 siginfo_t 的用戶空間虛擬 地址所攜帶的包含其內部域信息的標記。此規則的一個例外是 當信號是在調試觀察點的異常處理程序中產生的,此時標記的
@@ -53,5 +53,5 @@ AArch64 Linux 中的潛在用途。 的高字節,C 編譯器很可能無法判斷它們是不同的。 此構架會阻止對帶標記的 PC 指針的利用,因此在異常返回時,其高字節 -將被設置成一個爲 「55」 的擴展符。 +將被設置成一個爲 “55” 的擴展符。
Documentation/translations/zh_TW/arch/index.rst new file +30 -0
@@ -0,0 +1,30 @@ +.. SPDX-License-Identifier: GPL-2.0 + +處理器體系結構 +============== + +以下文檔提供了具體架構實現的編程細節。 + +.. toctree:: + :maxdepth: 2 + + ../mips/index + arm64/index + ../riscv/index + openrisc/index + parisc/index + ../loongarch/index + +TODOList: + +* arm/index +* ia64/index +* m68k/index +* nios2/index +* powerpc/index +* s390/index +* sh/index +* sparc/index +* x86/index +* xtensa/index +
Documentation/translations/zh_TW/arch/openrisc/index.rst new file +33 -0
@@ -0,0 +1,33 @@ +.. SPDX-License-Identifier: GPL-2.0 + +.. include:: ../../disclaimer-zh_TW.rst + +:Original: Documentation/arch/openrisc/index.rst + +:翻譯: + + 司延騰 Yanteng Si <[email protected]> + +.. _tw_openrisc_index: + +================= +OpenRISC 體系架構 +================= + +.. toctree:: + :maxdepth: 2 + + openrisc_port + todo + +Todolist: + features + + +.. only:: subproject and html + + Indices + ======= + + * :ref:`genindex` +
Documentation/translations/zh_TW/arch/openrisc/openrisc_port.rst new file +129 -0
129 lines not on this page · raw message
Documentation/translations/zh_TW/arch/openrisc/todo.rst new file +25 -0
@@ -0,0 +1,25 @@ +.. SPDX-License-Identifier: GPL-2.0 +.. include:: ../../disclaimer-zh_TW.rst + +:Original: Documentation/arch/openrisc/todo.rst + +:翻譯: + + 司延騰 Yanteng Si <[email protected]> + +.. _tw_openrisc_todo.rst: + +======== +待辦事項 +======== + +OpenRISC Linux的移植已經完全投入使用,並且從 2.6.35 開始就一直在上游同步。 +然而,還有一些剩餘的項目需要在未來幾個月內完成。 下面是一個即將進行調查的已知 +不盡完美的項目列表,即我們的待辦事項列表。 + +- 實現其餘的DMA API……dma_map_sg等。 + +- 完成重命名清理工作……代碼中提到了or32,這是架構的一個老名字。 我們 + 已經確定的名字是or1k,這個改變正在以緩慢積累的方式進行。 目前,or32相當 + 於or1k。 +
Documentation/translations/zh_TW/arch/parisc/debugging.rst new file +47 -0
47 lines not on this page · raw message
Documentation/translations/zh_TW/arch/parisc/index.rst new file +32 -0
@@ -0,0 +1,32 @@ +.. SPDX-License-Identifier: GPL-2.0 +.. include:: ../../disclaimer-zh_TW.rst + +:Original: Documentation/arch/parisc/index.rst + +:翻譯: + + 司延騰 Yanteng Si <[email protected]> + +.. _tw_parisc_index: + +==================== +PA-RISC體系架構 +==================== + +.. toctree:: + :maxdepth: 2 + + debugging + registers + +Todolist: + + features + +.. only:: subproject and html + + Indices + ======= + + * :ref:`genindex` +
Documentation/translations/zh_TW/arch/parisc/registers.rst new file +157 -0
157 lines not on this page · raw message
Documentation/translations/zh_TW/index.rst +3 -2
@@ -101,9 +101,10 @@ TODOList: 體系結構文檔 ------------ -TODOList: +.. toctree:: + :maxdepth: 1 -* arch/index + arch/index 其他文檔 --------
Signature · 1 line
2.34.1
PATCH v2 3/6 docs/zh_TW: update cpu-freq
Update zh_TW's cpu-freq documentation concentrating on the following aspects:
* The file tree structure changes of the main documentation;
* Some changes and ideas from zh_CN translation;
* Removal for several obsoleted contents within the zh_TW translation or those which are not exising anymore in the main documentation.
* Replacements for some incorrect words and phrases in traditional Chinese or those which are odd within their context being hard for readers to comprehend.
--- .../translations/zh_TW/cpu-freq/core.rst | 26 ++-- .../zh_TW/cpu-freq/cpu-drivers.rst | 147 +++++++++--------- .../zh_TW/cpu-freq/cpufreq-stats.rst | 41 +++-- .../translations/zh_TW/cpu-freq/index.rst | 4 +- 4 files changed, 108 insertions(+), 110 deletions(-)
Documentation/translations/zh_TW/cpu-freq/core.rst +13 -13
@@ -29,10 +29,10 @@ CPUFreq核心和CPUFreq通知器的通用說明 ====================== cpufreq核心代碼位於drivers/cpufreq/cpufreq.c中。這些cpufreq代碼爲CPUFreq架構的驅 -動程序(那些操作硬體切換頻率的代碼)以及 "通知器 "提供了一個標準化的接口。 -這些是設備驅動程序或需要了解策略變化的其它內核部分(如 ACPI 熱量管理)或所有頻率更改(除 -計時代碼外),甚至需要強制確定速度限制的通知器(如 ARM 架構上的 LCD 驅動程序)。 -此外, 內核 "常數" loops_per_jiffy會根據頻率變化而更新。 +動程序(那些執行硬件頻率切換的代碼)以及 "通知器" 提供了一個標準化的接口。 +包括設備驅動程序;需要了解策略變化(如 ACPI 熱量管理),或所有頻率變化(如計時代碼), +甚至需要強制限制爲指定頻率(如 ARM 架構上的 LCD 驅動程序)的其它內核組件。 +此外,內核 "常數" loops_per_jiffy 會根據頻率變化而更新。 cpufreq策略的引用計數由 cpufreq_cpu_get 和 cpufreq_cpu_put 來完成,以確保 cpufreq 驅 動程序被正確地註冊到核心中,並且驅動程序在 cpufreq_put_cpu 被調用之前不會被卸載。這也保證
@@ -41,10 +41,10 @@ cpufreq策略的引用計數由 cpufreq_cpu_get 和 cpufreq_cpu_put 來完成, 2. CPUFreq 通知器 ==================== -CPUFreq通知器符合標準的內核通知器接口。 +CPUFreq通知器遵循標準的內核通知器接口。 關於通知器的細節請參閱 linux/include/linux/notifier.h。 -這裡有兩個不同的CPUfreq通知器 - 策略通知器和轉換通知器。 +這裏有兩個不同的CPUfreq通知器 - 策略通知器和轉換通知器。 2.1 CPUFreq策略通知器
@@ -62,27 +62,27 @@ CPUFreq通知器符合標準的內核通知器接口。 2.2 CPUFreq轉換通知器 -------------------------------- -當CPUfreq驅動切換CPU核心頻率時,策略中的每個在線CPU都會收到兩次通知,這些變化沒有任何外部干 +當CPUfreq驅動切換CPU核心頻率時,策略中的每個在線CPU都會收到兩次通知,這些變化沒有任何外部幹 預。 第二個參數指定階段 - CPUFREQ_PRECHANGE or CPUFREQ_POSTCHANGE. 第三個參數是一個包含如下值的結構體cpufreq_freqs: -===== ==================== -cpu 受影響cpu的編號 +====== =============================== +policy 指向struct cpufreq_policy的指針 old 舊頻率 new 新頻率 flags cpufreq驅動的標誌 -===== ==================== +====== =============================== 3. 含有Operating Performance Point (OPP)的CPUFreq表的生成 ================================================================== 關於OPP的細節請參閱 Documentation/power/opp.rst dev_pm_opp_init_cpufreq_table - - 這個功能提供了一個隨時可用的轉換程序,用來將OPP層關於可用頻率的內部信息翻譯成一種容易提供給 - cpufreq的格式。 + 這個函數提供了一個隨時可用的轉換例程,用來將OPP層關於可用頻率的內部信息翻譯成一種 + cpufreq易於處理的格式。 .. Warning::
@@ -101,7 +101,7 @@ dev_pm_opp_init_cpufreq_table - .. note:: - 該函數只有在CONFIG_PM_OPP之外還啓用了CONFIG_CPU_FREQ時才可用。 + 該函數只有在CONFIG_PM_OPP之外還啓用了CONFIG_CPU_FREQ時纔可用。 dev_pm_opp_free_cpufreq_table 釋放dev_pm_opp_init_cpufreq_table分配的表。
Documentation/translations/zh_TW/cpu-freq/cpu-drivers.rst +73 -74
269 lines not on this page · raw message
Documentation/translations/zh_TW/cpu-freq/cpufreq-stats.rst +20 -21
97 lines not on this page · raw message
Documentation/translations/zh_TW/cpu-freq/index.rst +2 -2
@@ -28,10 +28,10 @@ Author: Dominik Brodowski <[email protected]> 郵件列表 ------------ -這裡有一個 CPU 頻率變化的 CVS 提交和通用列表,您可以在這裡報告bug、問題或提交補丁。要發 +這裏有一個 CPU 頻率變化的 CVS 提交和通用列表,您可以在這裏報告bug、問題或提交補丁。要發 布消息,請發送電子郵件到 [email protected]。 -連結 +鏈接 ----- FTP檔案: * ftp://ftp.linux.org.uk/pub/linux/cpufreq/
Signature · 1 line
2.34.1
PATCH v2 4/6 docs/zh_TW: update filesystems
In reply to Hu HaowenUpdate zh_TW's filesystems documentation concentrating on the following aspects:
* The file tree structure changes of the main documentation;
* Some changes and ideas from zh_CN translation;
* Removal for several obsoleted contents within the zh_TW translation or those which are not exising anymore in the main documentation.
* Replacements for some incorrect words and phrases in traditional Chinese or those which are odd within their context being hard for readers to comprehend.
--- .../zh_TW/filesystems/debugfs.rst | 38 +++++++++---------- .../translations/zh_TW/filesystems/index.rst | 2 +- .../translations/zh_TW/filesystems/sysfs.txt | 16 ++++---- .../translations/zh_TW/filesystems/tmpfs.rst | 32 ++++++++-------- .../zh_TW/filesystems/virtiofs.rst | 8 ++-- 5 files changed, 47 insertions(+), 49 deletions(-)
Documentation/translations/zh_TW/filesystems/debugfs.rst +19 -19
@@ -23,8 +23,8 @@ Debugfs Debugfs是內核開發人員在用戶空間獲取信息的簡單方法。與/proc不同,proc只提供進程 -信息。也不像sysfs,具有嚴格的「每個文件一個值「的規則。debugfs根本沒有規則,開發 -人員可以在這裡放置他們想要的任何信息。debugfs文件系統也不能用作穩定的ABI接口。 +信息。也不像sysfs,具有嚴格的“每個文件一個值“的規則。debugfs根本沒有規則,開發 +人員可以在這裏放置他們想要的任何信息。debugfs文件系統也不能用作穩定的ABI接口。 從理論上講,debugfs導出文件的時候沒有任何約束。但是[1]實際情況並不總是那麼 簡單。即使是debugfs接口,也最好根據需要進行設計,並儘量保持接口不變。
@@ -34,8 +34,8 @@ Debugfs通常使用以下命令安裝:: mount -t debugfs none /sys/kernel/debug (或等效的/etc/fstab行)。 -debugfs根目錄默認僅可由root用戶訪問。要更改對文件樹的訪問,請使用「 uid」,「 gid」 -和「 mode」掛載選項。請注意,debugfs API僅按照GPL協議導出到模塊。 +debugfs根目錄默認僅可由root用戶訪問。要更改對文件樹的訪問,請使用“ uid”,“ gid” +和“ mode”掛載選項。請注意,debugfs API僅按照GPL協議導出到模塊。 使用debugfs的代碼應包含<linux/debugfs.h>。然後,首先是創建至少一個目錄來保存 一組debugfs文件::
@@ -54,8 +54,8 @@ debugfs根目錄默認僅可由root用戶訪問。要更改對文件樹的訪問 struct dentry *parent, void *data, const struct file_operations *fops); -在這裡,name是要創建的文件的名稱,mode描述了訪問文件應具有的權限,parent指向 -應該保存文件的目錄,data將存儲在產生的inode結構體的i_private欄位中,而fops是 +在這裏,name是要創建的文件的名稱,mode描述了訪問文件應具有的權限,parent指向 +應該保存文件的目錄,data將存儲在產生的inode結構體的i_private字段中,而fops是 一組文件操作函數,這些函數中實現文件操作的具體行爲。至少,read()和/或 write()操作應提供;其他可以根據需要包括在內。同樣的,返回值將是指向創建文件 的dentry指針,錯誤時返回ERR_PTR(-ERROR),系統不支持debugfs時返回值爲ERR_PTR
@@ -81,7 +81,7 @@ file_size是初始文件大小。其他參數跟函數debugfs_create_file的相 struct dentry *parent, u64 *value); 這些文件支持讀取和寫入給定值。如果某個文件不支持寫入,只需根據需要設置mode -參數位。這些文件中的值以十進位表示;如果需要使用十六進位,可以使用以下函數 +參數位。這些文件中的值以十進制表示;如果需要使用十六進制,可以使用以下函數 替代:: void debugfs_create_x8(const char *name, umode_t mode,
@@ -93,7 +93,7 @@ file_size是初始文件大小。其他參數跟函數debugfs_create_file的相 void debugfs_create_x64(const char *name, umode_t mode, struct dentry *parent, u64 *value); -這些功能只有在開發人員知道導出值的大小的時候才有用。某些數據類型在不同的架構上 +這些功能只有在開發人員知道導出值的大小的時候纔有用。某些數據類型在不同的架構上 有不同的寬度,這樣會使情況變得有些複雜。在這種特殊情況下可以使用以下函數:: void debugfs_create_size_t(const char *name, umode_t mode,
@@ -101,7 +101,7 @@ file_size是初始文件大小。其他參數跟函數debugfs_create_file的相 不出所料,此函數將創建一個debugfs文件來表示類型爲size_t的變量。 -同樣地,也有導出無符號長整型變量的函數,分別以十進位和十六進位表示如下:: +同樣地,也有導出無符號長整型變量的函數,分別以十進制和十六進制表示如下:: struct dentry *debugfs_create_ulong(const char *name, umode_t mode, struct dentry *parent,
@@ -125,7 +125,7 @@ file_size是初始文件大小。其他參數跟函數debugfs_create_file的相 讀取此文件將獲得atomic_t值,寫入此文件將設置atomic_t值。 -另一個選擇是通過以下結構體和函數導出一個任意二進位數據塊:: +另一個選擇是通過以下結構體和函數導出一個任意二進制數據塊:: struct debugfs_blob_wrapper { void *data;
@@ -136,10 +136,10 @@ file_size是初始文件大小。其他參數跟函數debugfs_create_file的相 struct dentry *parent, struct debugfs_blob_wrapper *blob); -讀取此文件將返回由指針指向debugfs_blob_wrapper結構體的數據。一些驅動使用「blobs」 -作爲一種返回幾行(靜態)格式化文本的簡單方法。這個函數可用於導出二進位信息,但 +讀取此文件將返回由指針指向debugfs_blob_wrapper結構體的數據。一些驅動使用“blobs” +作爲一種返回幾行(靜態)格式化文本的簡單方法。這個函數可用於導出二進制信息,但 似乎在主線中沒有任何代碼這樣做。請注意,使用debugfs_create_blob()命令創建的 -所有文件是只讀的。 +所有文件是隻讀的。 如果您要轉儲一個寄存器塊(在開發過程中經常會這麼做,但是這樣的調試代碼很少上傳 到主線中。Debugfs提供兩個函數:一個用於創建僅寄存器文件,另一個把一個寄存器塊
@@ -163,7 +163,7 @@ file_size是初始文件大小。其他參數跟函數debugfs_create_file的相 void debugfs_print_regs32(struct seq_file *s, struct debugfs_reg32 *regs, int nregs, void __iomem *base, char *prefix); -「base」參數可能爲0,但您可能需要使用__stringify構建reg32數組,實際上有許多寄存器 +“base”參數可能爲0,但您可能需要使用__stringify構建reg32數組,實際上有許多寄存器 名稱(宏)是寄存器塊在基址上的字節偏移量。 如果要在debugfs中轉儲u32數組,可以使用以下函數創建文件::
@@ -172,7 +172,7 @@ file_size是初始文件大小。其他參數跟函數debugfs_create_file的相 struct dentry *parent, u32 *array, u32 elements); -「array」參數提供數據,而「elements」參數爲數組中元素的數量。注意:數組創建後,數組 +“array”參數提供數據,而“elements”參數爲數組中元素的數量。注意:數組創建後,數組 大小無法更改。 有一個函數來創建與設備相關的seq_file::
@@ -183,8 +183,8 @@ file_size是初始文件大小。其他參數跟函數debugfs_create_file的相 int (*read_fn)(struct seq_file *s, void *data)); -「dev」參數是與此debugfs文件相關的設備,並且「read_fn」是一個函數指針,這個函數在 -列印seq_file內容的時候被回調。 +“dev”參數是與此debugfs文件相關的設備,並且“read_fn”是一個函數指針,這個函數在 +打印seq_file內容的時候被回調。 還有一些其他的面向目錄的函數::
@@ -199,7 +199,7 @@ file_size是初始文件大小。其他參數跟函數debugfs_create_file的相 調用debugfs_rename()將爲現有的debugfs文件重命名,可能同時切換目錄。 new_name 函數調用之前不能存在;返回值爲old_dentry,其中包含更新的信息。可以使用 -debugfs_create_symlink()創建符號連結。 +debugfs_create_symlink()創建符號鏈接。 所有debugfs用戶必須考慮的一件事是:
@@ -219,6 +219,6 @@ dentry值可以爲NULL或錯誤值,在這種情況下,不會有任何文件 如果將對應頂層目錄的dentry傳遞給以上函數,則該目錄下的整個層次結構將會被刪除。 -注釋: +註釋: [1] http://lwn.net/Articles/309298/
Documentation/translations/zh_TW/filesystems/index.rst +1 -1
@@ -12,7 +12,7 @@ Linux Kernel中的文件系統 ======================== -這份正在開發的手冊或許在未來某個輝煌的日子裡以易懂的形式將Linux虛擬\ +這份正在開發的手冊或許在未來某個輝煌的日子裏以易懂的形式將Linux虛擬\ 文件系統(VFS)層以及基於其上的各種文件系統如何工作呈現給大家。當前\ 可以看到下面的內容。
Documentation/translations/zh_TW/filesystems/sysfs.txt +7 -9
@@ -1,5 +1,3 @@ -SPDX-License-Identifier: GPL-2.0 - Chinese translated version of Documentation/filesystems/sysfs.rst If you have any comment or update to the content, please contact the
@@ -61,7 +59,7 @@ Documentation/core-api/kobject.rst 文檔以獲得更多關於 kobject 接口的 任何 kobject 在系統中註冊,就會有一個目錄在 sysfs 中被創建。這個 目錄是作爲該 kobject 的父對象所在目錄的子目錄創建的,以準確地傳遞 -內核的對象層次到用戶空間。sysfs 中的頂層目錄代表著內核對象層次的 +內核的對象層次到用戶空間。sysfs 中的頂層目錄代表着內核對象層次的 共同祖先;例如:某些對象屬於某個子系統。 Sysfs 在與其目錄關聯的 kernfs_node 對象中內部保存一個指向實現
@@ -198,7 +196,7 @@ Sysfs 將會爲每次讀寫操作調用一次這個方法。這使得這些方 不會不太高。 這使得用戶空間可以局部地讀和任意的向前搜索整個文件。如果用戶空間 - 向後搜索到零或使用『0』偏移執行一個pread(2)操作,show()方法將 + 向後搜索到零或使用‘0’偏移執行一個pread(2)操作,show()方法將 再次被調用,以重新填充緩存。 - 在寫方面(write(2)),sysfs 希望在第一次寫操作時得到整個緩衝區。
@@ -253,7 +251,7 @@ static DEVICE_ATTR(name, S_IRUGO, show_name, store_name); (注意:真正的實現不允許用戶空間設置設備名。) -頂層目錄布局 +頂層目錄佈局 ~~~~~~~~~~~~ sysfs 目錄的安排顯示了內核數據結構之間的關係。
@@ -272,23 +270,23 @@ fs/ devices/ 包含了一個設備樹的文件系統表示。他直接映射了內部的內核 設備樹,反映了設備的層次結構。 -bus/ 包含了內核中各種總線類型的平面目錄布局。每個總線目錄包含兩個 +bus/ 包含了內核中各種總線類型的平面目錄佈局。每個總線目錄包含兩個 子目錄: devices/ drivers/ -devices/ 包含了系統中出現的每個設備的符號連結,他們指向 root/ 下的 +devices/ 包含了系統中出現的每個設備的符號鏈接,他們指向 root/ 下的 設備目錄。 -drivers/ 包含了每個已爲特定總線上的設備而掛載的驅動程序的目錄(這裡 +drivers/ 包含了每個已爲特定總線上的設備而掛載的驅動程序的目錄(這裏 假定驅動沒有跨越多個總線類型)。 fs/ 包含了一個爲文件系統設立的目錄。現在每個想要導出屬性的文件系統必須 在 fs/ 下創建自己的層次結構(參見Documentation/filesystems/fuse.rst)。 dev/ 包含兩個子目錄: char/ 和 block/。在這兩個子目錄中,有以 -<major>:<minor> 格式命名的符號連結。這些符號連結指向 sysfs 目錄 +<major>:<minor> 格式命名的符號鏈接。這些符號鏈接指向 sysfs 目錄 中相應的設備。/sys/dev 提供一個通過一個 stat(2) 操作結果,查找 設備 sysfs 接口快捷的方法。
Documentation/translations/zh_TW/filesystems/tmpfs.rst +16 -16
@@ -13,18 +13,18 @@ Tmpfs Tmpfs是一個將所有文件都保存在虛擬內存中的文件系統。 -tmpfs中的所有內容都是臨時的,也就是說沒有任何文件會在硬碟上創建。 +tmpfs中的所有內容都是臨時的,也就是說沒有任何文件會在硬盤上創建。 如果卸載tmpfs實例,所有保存在其中的文件都會丟失。 -tmpfs將所有文件保存在內核緩存中,隨著文件內容增長或縮小可以將不需要的 -頁面swap出去。它具有最大限制,可以通過「mount -o remount ...」調整。 +tmpfs將所有文件保存在內核緩存中,隨着文件內容增長或縮小可以將不需要的 +頁面swap出去。它具有最大限制,可以通過“mount -o remount ...”調整。 和ramfs(創建tmpfs的模板)相比,tmpfs包含交換和限制檢查。和tmpfs相似的另 -一個東西是RAM磁碟(/dev/ram*),可以在物理RAM中模擬固定大小的硬碟,並在 +一個東西是RAM磁盤(/dev/ram*),可以在物理RAM中模擬固定大小的硬盤,並在 此之上創建一個普通的文件系統。Ramdisks無法swap,因此無法調整它們的大小。 由於tmpfs完全保存於頁面緩存和swap中,因此所有tmpfs頁面將在/proc/meminfo -中顯示爲「Shmem」,而在free(1)中顯示爲「Shared」。請注意,這些計數還包括 +中顯示爲“Shmem”,而在free(1)中顯示爲“Shared”。請注意,這些計數還包括 共享內存(shmem,請參閱ipcs(1))。獲得計數的最可靠方法是使用df(1)和du(1)。 tmpfs具有以下用途:
@@ -45,7 +45,7 @@ tmpfs具有以下用途: tmpfs的前身(shm fs)才能使用SYSV共享內存) 3) 很多人(包括我)都覺的在/tmp和/var/tmp上掛載非常方便,並具有較大的 - swap分區。目前循環掛載tmpfs可以正常工作,所以大多數發布都應當可以 + swap分區。目前循環掛載tmpfs可以正常工作,所以大多數發佈都應當可以 使用mkinitrd通過/tmp訪問/tmp。 4) 也許還有更多我不知道的地方:-)
@@ -58,11 +58,11 @@ size tmpfs實例分配的字節數限制。默認值是不swap時物理RAM 如果tmpfs實例過大,機器將死鎖,因爲OOM處理將無法釋放該內存。 nr_blocks 與size相同,但以PAGE_SIZE爲單位。 nr_inodes tmpfs實例的最大inode個數。默認值是物理內存頁數的一半,或者 - (有高端內存的機器)低端內存RAM的頁數,二者以較低者為準。 + (有高端內存的機器)低端內存RAM的頁數,二者以較低者爲準。 ========= =========================================================== 這些參數接受後綴k,m或g表示千,兆和千兆字節,可以在remount時更改。 -size參數也接受後綴%用來限制tmpfs實例占用物理RAM的百分比: +size參數也接受後綴%用來限制tmpfs實例佔用物理RAM的百分比: 未指定size或nr_blocks時,默認值爲size=50% 如果nr_blocks=0(或size=0),block個數將不受限制;如果nr_inodes=0,
@@ -71,26 +71,26 @@ inode個數將不受限制。這樣掛載通常是不明智的,因爲它允許 場景下的訪問。 tmpfs具有爲所有文件設置NUMA內存分配策略掛載選項(如果啓用了CONFIG_NUMA), -可以通過「mount -o remount ...」調整 +可以通過“mount -o remount ...”調整 ======================== ========================= mpol=default 採用進程分配策略 (請參閱 set_mempolicy(2)) mpol=prefer:Node 傾向從給定的節點分配 -mpol=bind:NodeList 只允許從指定的鍊表分配 +mpol=bind:NodeList 只允許從指定的鏈表分配 mpol=interleave 傾向於依次從每個節點分配 mpol=interleave:NodeList 依次從每個節點分配 mpol=local 優先本地節點分配內存 ======================== ========================= -NodeList格式是以逗號分隔的十進位數字表示大小和範圍,最大和最小範圍是用- -分隔符的十進位數來表示。例如,mpol=bind0-3,5,7,9-15 +NodeList格式是以逗號分隔的十進制數字表示大小和範圍,最大和最小範圍是用- +分隔符的十進制數來表示。例如,mpol=bind0-3,5,7,9-15 帶有有效NodeList的內存策略將按指定格式保存,在創建文件時使用。當任務在該 文件系統上創建文件時,會使用到掛載時的內存策略NodeList選項,如果設置的話, 由調用任務的cpuset[請參見Documentation/admin-guide/cgroup-v1/cpusets.rst] 以及下面列出的可選標誌約束。如果NodeLists爲設置爲空集,則文件的內存策略將 -恢復爲「默認」策略。 +恢復爲“默認”策略。 NUMA內存分配策略有可選標誌,可以用於模式結合。在掛載tmpfs時指定這些可選 標誌可以在NodeList之前生效。
@@ -107,12 +107,12 @@ Documentation/admin-guide/mm/numa_memory_policy.rst列出所有可用的內存 請注意,如果內核不支持NUMA,那麼使用mpol選項掛載tmpfs將會失敗;nodelist指定不 在線的節點也會失敗。如果您的系統依賴於此,但內核會運行不帶NUMA功能(也許是安全 revocery內核),或者具有較少的節點在線,建議從自動模式中省略mpol選項掛載選項。 -可以在以後通過「mount -o remount,mpol=Policy:NodeList MountPoint」添加到掛載點。 +可以在以後通過“mount -o remount,mpol=Policy:NodeList MountPoint”添加到掛載點。 要指定初始根目錄,可以使用如下掛載選項: ==== ==================== -模式 權限用八進位數字表示 +模式 權限用八進制數字表示 uid 用戶ID gid 組ID ==== ====================
@@ -129,7 +129,7 @@ inode32 使用32位inode 在32位內核上,默認是inode32,掛載時指定inode64會被拒絕。 在64位內核上,默認配置是CONFIG_TMPFS_INODE64。inode64避免了單個設備上可能有多個 -具有相同inode編號的文件;比如32位應用程式使用glibc如果長期訪問tmpfs,一旦達到33 +具有相同inode編號的文件;比如32位應用程序使用glibc如果長期訪問tmpfs,一旦達到33 位inode編號,就有EOVERFLOW失敗的危險,無法打開大於2GiB的文件,並返回EINVAL。 所以'mount -t tmpfs -o size=10G,nr_inodes=10k,mode=700 tmpfs /mytmpfs'將在
Documentation/translations/zh_TW/filesystems/virtiofs.rst +4 -4
@@ -21,7 +21,7 @@ virtiofs: virtio-fs 主機<->客機共享文件系統 介紹 ==== -Linux的virtiofs文件系統實現了一個半虛擬化VIRTIO類型「virtio-fs」設備的驅動,通過該\ +Linux的virtiofs文件系統實現了一個半虛擬化VIRTIO類型“virtio-fs”設備的驅動,通過該\ 類型設備實現客機<->主機文件系統共享。它允許客機掛載一個已經導出到主機的目錄。 客機通常需要訪問主機或者遠程系統上的文件。使用場景包括:在新客機安裝時讓文件對其\
@@ -42,12 +42,12 @@ Linux的virtiofs文件系統實現了一個半虛擬化VIRTIO類型「virtio-fs guest# mount -t virtiofs myfs /mnt -請查閱 https://virtio-fs.gitlab.io/ 了解配置QEMU和virtiofsd守護程序的詳細信息。 +請查閱 https://virtio-fs.gitlab.io/ 瞭解配置QEMU和virtiofsd守護程序的詳細信息。 內幕 ==== 由於virtio-fs設備將FUSE協議用於文件系統請求,因此Linux的virtiofs文件系統與FUSE文\ -件系統客戶端緊密集成在一起。客機充當FUSE客戶端而主機充當FUSE伺服器,內核與用戶空\ +件系統客戶端緊密集成在一起。客機充當FUSE客戶端而主機充當FUSE服務器,內核與用戶空\ 間之間的/dev/fuse接口由virtio-fs設備接口代替。 FUSE請求被置於虛擬隊列中由主機處理。主機填充緩衝區中的響應部分,而客機處理請求的完成部分。
@@ -55,7 +55,7 @@ FUSE請求被置於虛擬隊列中由主機處理。主機填充緩衝區中的 將/dev/fuse映射到虛擬隊列需要解決/dev/fuse和虛擬隊列之間語義上的差異。每次讀取\ /dev/fuse設備時,FUSE客戶端都可以選擇要傳輸的請求,從而可以使某些請求優先於其他\ 請求。虛擬隊列有其隊列語義,無法更改已入隊請求的順序。在虛擬隊列已滿的情況下尤 -其關鍵,因爲此時不可能加入高優先級的請求。爲了解決此差異,virtio-fs設備採用「hiprio」\ +其關鍵,因爲此時不可能加入高優先級的請求。爲了解決此差異,virtio-fs設備採用“hiprio”\ (高優先級)虛擬隊列,專門用於有別於普通請求的高優先級請求。
Signature · 1 line
2.34.1
PATCH v2 5/6 docs/zh_TW: update process
In reply to Hu HaowenUpdate zh_TW's process documentation concentrating on the following aspects:
* The file tree structure changes of the main documentation;
* Some changes and ideas from zh_CN translation;
* Removal for several obsoleted contents within the zh_TW translation or those which are not exising anymore in the main documentation.
* Replacements for some incorrect words and phrases in traditional Chinese or those which are odd within their context being hard for readers to comprehend.
--- .../translations/zh_TW/process/1.Intro.rst | 84 +- .../translations/zh_TW/process/2.Process.rst | 130 +-- .../zh_TW/process/3.Early-stage.rst | 44 +- .../translations/zh_TW/process/4.Coding.rst | 104 +-- .../translations/zh_TW/process/5.Posting.rst | 80 +- .../zh_TW/process/6.Followthrough.rst | 46 +- .../zh_TW/process/7.AdvancedTopics.rst | 56 +- .../zh_TW/process/8.Conclusion.rst | 14 +- .../code-of-conduct-interpretation.rst | 54 +- .../zh_TW/process/code-of-conduct.rst | 20 +- .../zh_TW/process/coding-style.rst | 400 ++++++---- .../zh_TW/process/development-process.rst | 2 +- .../zh_TW/process/email-clients.rst | 273 ++++--- .../process/embargoed-hardware-issues.rst | 78 +- .../translations/zh_TW/process/howto.rst | 156 ++-- .../translations/zh_TW/process/index.rst | 5 +- .../zh_TW/process/kernel-driver-statement.rst | 2 +- .../process/kernel-enforcement-statement.rst | 14 +- .../zh_TW/process/license-rules.rst | 54 +- .../zh_TW/process/management-style.rst | 64 +- .../zh_TW/process/stable-api-nonsense.rst | 86 +- .../zh_TW/process/stable-kernel-rules.rst | 36 +- .../zh_TW/process/submit-checklist.rst | 92 ++- .../zh_TW/process/submitting-patches.rst | 755 +++++++++--------- .../process/volatile-considered-harmful.rst | 32 +- 25 files changed, 1441 insertions(+), 1240 deletions(-)
Documentation/translations/zh_TW/process/1.Intro.rst +42 -42
@@ -22,55 +22,55 @@ -------- 本節的其餘部分涵蓋了內核開發的過程,以及開發人員及其僱主在這方面可能遇到的 -各種問題。有很多原因使內核代碼應被合併到正式的(「主線」)內核中,包括對用戶 +各種問題。有很多原因使內核代碼應被合併到正式的(“主線”)內核中,包括對用戶 的自動可用性、多種形式的社區支持以及影響內核開發方向的能力。提供給Linux內核 的代碼必須在與GPL兼容的許可證下可用。 -:ref:`tw_development_process` 介紹了開發過程、內核發布周期和合併窗口的機制。 -涵蓋了補丁開發、審查和合併周期中的各個階段。還有一些關於工具和郵件列表的討論? +:ref:`cn_development_process` 介紹了開發過程、內核發佈週期和合並窗口的機制。 +涵蓋了補丁開發、審查和合並週期中的各個階段。還有一些關於工具和郵件列表的討論? 鼓勵希望開始內核開發的開發人員跟蹤並修復缺陷以作爲初步練習。 -:ref:`tw_development_early_stage` 包括項目的早期規劃,重點是儘快讓開發社區 +:ref:`cn_development_early_stage` 包括項目的早期規劃,重點是儘快讓開發社區 參與進來。 -:ref:`tw_development_coding` 是關於編程過程的;介紹了其他開發人員遇到的幾個 +:ref:`cn_development_coding` 是關於編程過程的;介紹了其他開發人員遇到的幾個 陷阱。也涵蓋了對補丁的一些要求,並且介紹了一些工具,這些工具有助於確保內核 補丁是正確的。 -:ref:`tw_development_posting` 描述發布補丁以供評審的過程。爲了讓開發社區能 +:ref:`cn_development_posting` 描述發佈補丁以供評審的過程。爲了讓開發社區能 認真對待,補丁必須被正確格式化和描述,並且必須發送到正確的地方。遵循本節中的 建議有助於確保您的工作能被較好地接納。 -:ref:`tw_development_followthrough` 介紹了發布補丁之後發生的事情;工作在這時 +:ref:`cn_development_followthrough` 介紹了發佈補丁之後發生的事情;工作在這時 還遠遠沒有完成。與審閱者一起工作是開發過程中的一個重要部分;本節提供了一些 關於如何在這個重要階段避免問題的提示。當補丁被合併到主線中時,開發人員要注意 不要假定任務已經完成。 -:ref:`tw_development_advancedtopics` 介紹了兩個「高級」主題:使用Git管理補丁 -和查看其他人發布的補丁。 +:ref:`cn_development_advancedtopics` 介紹了兩個“高級”主題:使用Git管理補丁 +和查看其他人發佈的補丁。 -:ref:`tw_development_conclusion` 總結了有關內核開發的更多信息,附帶有相關資源 -連結。 +:ref:`cn_development_conclusion` 總結了有關內核開發的更多信息,附帶有相關資源 +鏈接。 這個文檔是關於什麼的 -------------------- Linux內核有超過800萬行代碼,每個版本的貢獻者超過1000人,是現存最大、最活躍的 -免費軟體項目之一。從1991年開始,這個內核已經發展成爲一個最好的作業系統組件, -運行在袖珍數位音樂播放器、桌上型電腦、現存最大的超級計算機以及所有類型的系統上。 +免費軟件項目之一。從1991年開始,這個內核已經發展成爲一個最好的操作系統組件, +運行在袖珍數字音樂播放器、臺式電腦、現存最大的超級計算機以及所有類型的系統上。 它是一種適用於幾乎任何情況的健壯、高效和可擴展的解決方案。 -隨著Linux的發展,希望參與其開發的開發人員(和公司)的數量也在增加。硬體供應商 +隨着Linux的發展,希望參與其開發的開發人員(和公司)的數量也在增加。硬件供應商 希望確保Linux能夠很好地支持他們的產品,使這些產品對Linux用戶具有吸引力。嵌入 式系統供應商使用Linux作爲集成產品的組件,希望Linux能夠儘可能地勝任手頭的任務。 -分銷商和其他基於Linux的軟體供應商切實關心Linux內核的功能、性能和可靠性。最終 +分銷商和其他基於Linux的軟件供應商切實關心Linux內核的功能、性能和可靠性。最終 用戶也常常希望修改Linux,使之能更好地滿足他們的需求。 Linux最引人注目的特性之一是這些開發人員可以訪問它;任何具備必要技能的人都可以 -改進Linux並影響其開發方向。專有產品不能提供這種開放性,這是自由軟體的一個特點。 -如果有什麼不同的話,那就是內核比大多數其他自由軟體項目更開放。一個典型的三個 -月內核開發周期可以涉及1000多個開發人員,他們爲100多個不同的公司(或者根本不 +改進Linux並影響其開發方向。專有產品不能提供這種開放性,這是自由軟件的一個特點。 +如果有什麼不同的話,那就是內核比大多數其他自由軟件項目更開放。一個典型的三個 +月內核開發週期可以涉及1000多個開發人員,他們爲100多個不同的公司(或者根本不 隸屬公司)工作。 與內核開發社區合作並不是特別困難。但儘管如此,仍有許多潛在的貢獻者在嘗試做
@@ -79,7 +79,7 @@ Linux最引人注目的特性之一是這些開發人員可以訪問它;任何 過程與專有的開發模式有很大的不同也就不足爲奇了。 對於新開發人員來說,內核的開發過程可能會讓人感到奇怪和恐懼,但這背後有充分的 -理由和堅實的經驗。一個不了解內核社區工作方式的開發人員(或者更糟的是,他們 +理由和堅實的經驗。一個不瞭解內核社區工作方式的開發人員(或者更糟的是,他們 試圖拋棄或規避之)會得到令人沮喪的體驗。開發社區在幫助那些試圖學習的人的同時, 沒有時間幫助那些不願意傾聽或不關心開發過程的人。
@@ -102,20 +102,20 @@ Andrew Morton, Andrew Price, Tsugikazu Shibata 和 Jochen Voß 。 -------------------- 有些公司和開發人員偶爾會想,爲什麼他們要費心學習如何與內核社區合作,並將代碼 -放入主線內核(「主線」是由Linus Torvalds維護的內核,Linux發行商將其用作基礎)。 +放入主線內核(“主線”是由Linus Torvalds維護的內核,Linux發行商將其用作基礎)。 在短期內,貢獻代碼看起來像是一種可以避免的開銷;維護獨立代碼並直接支持用戶 -似乎更容易。事實上,保持代碼獨立(「樹外」)是在經濟上是錯誤的。 +似乎更容易。事實上,保持代碼獨立(“樹外”)是在經濟上是錯誤的。 爲了說明樹外代碼成本,下面給出內核開發過程的一些相關方面;本文稍後將更詳細地 討論其中的大部分內容。請考慮: - 所有Linux用戶都可以使用合併到主線內核中的代碼。它將自動出現在所有啓用它的 - 發行版上。無需驅動程序磁碟、額外下載,也不需要爲多個發行版的多個版本提供 + 發行版上。無需驅動程序磁盤、額外下載,也不需要爲多個發行版的多個版本提供 支持;這一切將方便所有開發人員和用戶。併入主線解決了大量的分發和支持問題。 - 當內核開發人員努力維護一個穩定的用戶空間接口時,內核內部API處於不斷變化之中。 不維持穩定的內部接口是一個慎重的設計決策;它允許在任何時候進行基本的改進, - 並產出更高質量的代碼。但該策略導致結果是,若要使用新的內核,任何樹外代碼都 + 併產出更高質量的代碼。但該策略導致結果是,若要使用新的內核,任何樹外代碼都 需要持續的維護。維護樹外代碼會需要大量的工作才能使代碼保持正常運行。 相反,位於主線中的代碼不需要這樣做,因爲基本規則要求進行API更改的任何開發
@@ -140,60 +140,60 @@ Andrew Morton, Andrew Price, Tsugikazu Shibata 和 Jochen Voß 。 - 代碼的貢獻是使整個流程工作的根本。通過貢獻代碼,您可以向內核添加新功能,並 提供其他內核開發人員使用的功能和示例。如果您已經爲Linux開發了代碼(或者正在 - 考慮這樣做),那麼您顯然對這個平台的持續成功感興趣;貢獻代碼是確保成功的 + 考慮這樣做),那麼您顯然對這個平臺的持續成功感興趣;貢獻代碼是確保成功的 最好方法之一。 -上述所有理由都適用於任何樹外內核代碼,包括以專有的、僅二進位形式分發的代碼。 -然而,在考慮任何類型的純二進位內核代碼分布之前,還需要考慮其他因素。包括: +上述所有理由都適用於任何樹外內核代碼,包括以專有的、僅二進制形式分發的代碼。 +然而,在考慮任何類型的純二進制內核代碼分佈之前,還需要考慮其他因素。包括: - 圍繞專有內核模塊分發的法律問題其實較爲模糊;相當多的內核版權所有者認爲, - 大多數僅二進位的模塊是內核的派生產品,因此,它們的分發違反了GNU通用公共 + 大多數僅二進制的模塊是內核的派生產品,因此,它們的分發違反了GNU通用公共 許可證(下面將詳細介紹)。本文作者不是律師,本文檔中的任何內容都不可能被 - 視爲法律建議。封閉原始碼模塊的真實法律地位只能由法院決定。但不管怎樣,困擾 + 視爲法律建議。封閉源代碼模塊的真實法律地位只能由法院決定。但不管怎樣,困擾 這些模塊的不確定性仍然存在。 -- 二進位模塊大大增加了調試內核問題的難度,以至於大多數內核開發人員甚至都不會 - 嘗試。因此,只分發二進位模塊將使您的用戶更難從社區獲得支持。 +- 二進制模塊大大增加了調試內核問題的難度,以至於大多數內核開發人員甚至都不會 + 嘗試。因此,只分發二進制模塊將使您的用戶更難從社區獲得支持。 -- 對於僅二進位的模塊的發行者來說,支持也更加困難,他們必須爲他們希望支持的 +- 對於僅二進制的模塊的發行者來說,支持也更加困難,他們必須爲他們希望支持的 每個發行版和每個內核版本提供不同版本的模塊。爲了提供較爲全面的覆蓋範圍, 可能需要一個模塊的幾十個構建,並且每次升級內核時,您的用戶都必須單獨升級 這些模塊。 -- 上面提到的關於代碼評審的所有問題都更加存在於封閉原始碼中。由於該代碼根本 +- 上面提到的關於代碼評審的所有問題都更加存在於封閉源代碼中。由於該代碼根本 不可得,因此社區無法對其進行審查,毫無疑問,它將存在嚴重問題。 尤其是嵌入式系統的製造商,可能會傾向於忽視本節中所說的大部分內容;因爲他們 -相信自己正在商用一種使用凍結內核版本的獨立產品,在發布後不需要再進行開發。 +相信自己正在商用一種使用凍結內核版本的獨立產品,在發佈後不需要再進行開發。 這個論點忽略了廣泛的代碼審查的價值以及允許用戶向產品添加功能的價值。但這些 -產品的商業壽命有限,之後必須發布新版本的產品。在這一點上,代碼在主線上並得到 -良好維護的供應商將能夠更好地占位,以使新產品快速上市。 +產品的商業壽命有限,之後必須發佈新版本的產品。在這一點上,代碼在主線上並得到 +良好維護的供應商將能夠更好地佔位,以使新產品快速上市。 許可 ---- 代碼是根據一些許可證提供給Linux內核的,但是所有代碼都必須與GNU通用公共許可 證(GPLV2)的版本2兼容,該版本是覆蓋整個內核分發的許可證。在實踐中,這意味 -著所有代碼貢獻都由GPLv2(可選地,語言允許在更高版本的GPL下分發)或3子句BSD +着所有代碼貢獻都由GPLv2(可選地,語言允許在更高版本的GPL下分發)或3子句BSD 許可(New BSD License,譯者注)覆蓋。任何不包含在兼容許可證中的貢獻都不會 被接受到內核中。 貢獻給內核的代碼不需要(或請求)版權分配。合併到主線內核中的所有代碼都保留 其原始所有權;因此,內核現在擁有數千個所有者。 -這種所有權結構也暗示著,任何改變內核許可的嘗試都註定會失敗。很少有實際情況 +這種所有權結構也暗示着,任何改變內核許可的嘗試都註定會失敗。很少有實際情況 可以獲得所有版權所有者的同意(或者從內核中刪除他們的代碼)。因此,尤其是在 可預見的將來,許可證不大可能遷移到GPL的版本3。 -所有貢獻給內核的代碼都必須是合法的免費軟體。因此,不接受匿名(或化名)貢獻 -者的代碼。所有貢獻者都需要在他們的代碼上「sign off(簽發)」,聲明代碼可以 -在GPL下與內核一起分發。無法提供未被其所有者許可爲免費軟體的代碼,或可能爲 +所有貢獻給內核的代碼都必須是合法的免費軟件。因此,不接受匿名(或化名)貢獻 +者的代碼。所有貢獻者都需要在他們的代碼上“sign off(簽發)”,聲明代碼可以 +在GPL下與內核一起分發。無法提供未被其所有者許可爲免費軟件的代碼,或可能爲 內核造成版權相關問題的代碼(例如,由缺乏適當保護的反向工程工作派生的代碼) 不能被接受。 有關版權問題的提問在Linux開發郵件列表中很常見。這樣的問題通常會得到不少答案, -但請記住,回答這些問題的人不是律師,不能提供法律諮詢。如果您有關於Linux原始碼 -的法律問題,沒有什麼可以代替諮詢了解這一領域的律師。依賴從技術郵件列表中獲得 +但請記住,回答這些問題的人不是律師,不能提供法律諮詢。如果您有關於Linux源代碼 +的法律問題,沒有什麼可以代替諮詢瞭解這一領域的律師。依賴從技術郵件列表中獲得 的答案是一件冒險的事情。
Documentation/translations/zh_TW/process/2.Process.rst +65 -65
324 lines not on this page · raw message
Documentation/translations/zh_TW/process/3.Early-stage.rst +22 -22
116 lines not on this page · raw message
Documentation/translations/zh_TW/process/4.Coding.rst +52 -52
243 lines not on this page · raw message
Documentation/translations/zh_TW/process/5.Posting.rst +40 -40
213 lines not on this page · raw message
Documentation/translations/zh_TW/process/6.Followthrough.rst +23 -23
114 lines not on this page · raw message
Documentation/translations/zh_TW/process/7.AdvancedTopics.rst +28 -28
119 lines not on this page · raw message
Documentation/translations/zh_TW/process/8.Conclusion.rst +7 -7
@@ -17,13 +17,13 @@ 更多信息 ======== -關於Linux內核開發和相關主題的信息來源很多。首先是在內核原始碼分發中找到的 +關於Linux內核開發和相關主題的信息來源很多。首先是在內核源代碼分發中找到的 文檔目錄。頂級 -:ref:`Documentation/translations/zh_TW/process/howto.rst <tw_process_howto>` +:ref:`Documentation/translations/zh_CN/process/howto.rst <cn_process_howto>` 文件是一個重要的起點; -:ref:`Documentation/translations/zh_TW/process/submitting-patches.rst <tw_submittingpatches>` +:ref:`Documentation/translations/zh_CN/process/submitting-patches.rst <cn_submittingpatches>` 也是所有內核開發人員都應該閱讀的內容。許多內部內核API都是使用kerneldoc機制 -記錄的;「make htmldocs」或「make pdfdocs」可用於以HTML或PDF格式生成這些文檔 +記錄的;“make htmldocs”或“make pdfdocs”可用於以HTML或PDF格式生成這些文檔 (儘管某些發行版提供的tex版本會遇到內部限制,無法正確處理文檔)。 不同的網站在各個細節層次上討論內核開發。本文作者想謙虛地建議用 https://lwn.net/
@@ -35,7 +35,7 @@ https://kernelnewbies.org/ -當然,也不應該忘記 https://kernel.org/ ,這是內核發布信息的最終位置。 +當然,也不應該忘記 https://kernel.org/ ,這是內核發佈信息的最終位置。 關於內核開發有很多書:
@@ -47,7 +47,7 @@ 《深入理解Linux內核》(Daniel Bovet和Marco Cesati) 然而,所有這些書都有一個共同的缺點:它們上架時就往往有些過時,而且已經上架 -一段時間了。不過,在那裡還是可以找到相當多的好信息。 +一段時間了。不過,在那裏還是可以找到相當多的好信息。 有關git的文檔,請訪問:
@@ -61,7 +61,7 @@ 祝賀所有通過這篇冗長的文檔的人。希望它能夠幫助您理解Linux內核是如何開發的, 以及您如何參與這個過程。 -最後,重要的是參與。任何開源軟體項目都不會超過其貢獻者投入其中的總和。Linux +最後,重要的是參與。任何開源軟件項目都不會超過其貢獻者投入其中的總和。Linux 內核的發展速度和以前一樣快,因爲它得到了大量開發人員的幫助,他們都在努力使它 變得更好。內核是一個最成功的例子,說明了當成千上萬的人爲了一個共同的目標一起 工作時,可以做出什麼。
Documentation/translations/zh_TW/process/code-of-conduct-interpretation.rst +27 -27
129 lines not on this page · raw message
Documentation/translations/zh_TW/process/code-of-conduct.rst +10 -10
@@ -8,7 +8,7 @@ .. _tw_code_of_conduct: -貢獻者契約行為準則 +貢獻者契約行爲準則 ++++++++++++++++++ 我們的誓言
@@ -35,7 +35,7 @@ * 使用性意味的語言或意象以及不受歡迎的性注意或者更過分的行爲 * 煽動、侮辱/貶損評論以及個人或政治攻擊 * 公開或私下騷擾 -* 未經明確許可,發布他人的私人信息,如物理或電子地址。 +* 未經明確許可,發佈他人的私人信息,如物理或電子地址。 * 在專業場合被合理認爲不適當的其他行爲 我們的責任
@@ -44,33 +44,33 @@ 維護人員負責澄清可接受行爲的標準,並應針對任何不可接受行爲採取適當和公平的 糾正措施。 -維護人員有權和責任刪除、編輯或拒絕與本行為準則不一致的評論、承諾、代碼、 +維護人員有權和責任刪除、編輯或拒絕與本行爲準則不一致的評論、承諾、代碼、 wiki編輯、問題和其他貢獻,或暫時或永久禁止任何貢獻者從事他們認爲不適當、 威脅、冒犯或有害的其他行爲。 範圍 ==== -當個人代表項目或其社區時,本行為準則既適用於項目空間,也適用於公共空間。 +當個人代表項目或其社區時,本行爲準則既適用於項目空間,也適用於公共空間。 代表一個項目或社區的例子包括使用一個正式的項目電子郵件地址,通過一個正式 -的社交媒體帳戶發布,或者在在線或離線事件中擔任指定的代表。項目維護人員可以 +的社交媒體帳戶發佈,或者在在線或離線事件中擔任指定的代表。項目維護人員可以 進一步定義和澄清項目的表示。 執行 ==== -如有濫用、騷擾或其他不可接受的行爲,可聯繫行為準則委員會<[email protected]>。 -所有投訴都將接受審查和調查,並將得到必要和適當的答覆。行為準則委員會有義務 -對事件報告人保密。具體執行政策的進一步細節可單獨公布。 +如有濫用、騷擾或其他不可接受的行爲,可聯繫行爲準則委員會<[email protected]>。 +所有投訴都將接受審查和調查,並將得到必要和適當的答覆。行爲準則委員會有義務 +對事件報告人保密。具體執行政策的進一步細節可單獨公佈。 歸屬 ==== -本行為準則改編自《貢獻者契約》,版本1.4,可從 +本行爲準則改編自《貢獻者契約》,版本1.4,可從 https://www.contributor-covenant.org/version/1/4/code-of-conduct.html 獲取。 解釋 ==== -有關Linux內核社區如何解釋此文檔,請參閱 :ref:`tw_code_of_conduct_interpretation` +有關Linux內核社區如何解釋此文檔,請參閱 :ref:`cn_code_of_conduct_interpretation`
Documentation/translations/zh_TW/process/coding-style.rst +262 -138
807 lines not on this page · raw message
Documentation/translations/zh_TW/process/development-process.rst +1 -1
@@ -26,5 +26,5 @@ 7.AdvancedTopics 8.Conclusion -本文檔的目的是幫助開發人員(及其經理)以最小的挫折感與開發社區合作。它試圖記錄這個社區如何以一種不熟悉Linux內核開發(或者實際上是自由軟體開發)的人可以訪問的方式工作。雖然這裡有一些技術資料,但這是一個面向過程的討論,不需要深入了解內核編程就可以理解。 +本文檔的目的是幫助開發人員(及其經理)以最小的挫折感與開發社區合作。它試圖記錄這個社區如何以一種不熟悉Linux內核開發(或者實際上是自由軟件開發)的人可以訪問的方式工作。雖然這裏有一些技術資料,但這是一個面向過程的討論,不需要深入瞭解內核編程就可以理解。
Documentation/translations/zh_TW/process/email-clients.rst +175 -98
394 lines not on this page · raw message
Documentation/translations/zh_TW/process/embargoed-hardware-issues.rst +39 -39
192 lines not on this page · raw message
Documentation/translations/zh_TW/process/howto.rst +77 -79
61 lines not on this page · raw message
Documentation/translations/zh_TW/process/index.rst +3 -2
Lines of this file are not shown. View the raw message.
Documentation/translations/zh_TW/process/kernel-driver-statement.rst +1 -1
Lines of this file are not shown. View the raw message.
Documentation/translations/zh_TW/process/kernel-enforcement-statement.rst +6 -8
Lines of this file are not shown. View the raw message.
Documentation/translations/zh_TW/process/license-rules.rst +26 -28
54 lines not on this page · raw message
Documentation/translations/zh_TW/process/management-style.rst +32 -32
64 lines not on this page · raw message
Documentation/translations/zh_TW/process/stable-api-nonsense.rst +43 -43
86 lines not on this page · raw message
Documentation/translations/zh_TW/process/stable-kernel-rules.rst +18 -18
Lines of this file are not shown. View the raw message.
Documentation/translations/zh_TW/process/submit-checklist.rst +49 -43
92 lines not on this page · raw message
Documentation/translations/zh_TW/process/submitting-patches.rst +377 -378
755 lines not on this page · raw message
Documentation/translations/zh_TW/process/volatile-considered-harmful.rst +16 -16
Lines of this file are not shown. View the raw message.
The rest of this diff is not shown. View the raw message.
Signature · 1 line
2.34.1
Part of the diff is not shown here. View the raw message.
PATCH v2 6/6 docs/zh_TW: turn zh_CN's folder references and headers into zh_TW's ones
In reply to Hu HaowenSome contents under zh_TW's translation folder contain folder references and headers that refer to zh_CN's locations. Hence replace them.
--- .../translations/zh_TW/admin-guide/README.rst | 6 +++--- .../zh_TW/admin-guide/reporting-issues.rst | 12 ++++++------ .../zh_TW/admin-guide/reporting-regressions.rst | 10 +++++----- .../zh_TW/admin-guide/security-bugs.rst | 2 +- .../translations/zh_TW/arch/arm64/booting.txt | 2 +- .../zh_TW/arch/arm64/silicon-errata.txt | 2 +- .../translations/zh_TW/process/1.Intro.rst | 14 +++++++------- .../translations/zh_TW/process/4.Coding.rst | 2 +- .../translations/zh_TW/process/5.Posting.rst | 14 +++++++------- .../translations/zh_TW/process/8.Conclusion.rst | 4 ++-- .../process/code-of-conduct-interpretation.rst | 2 +- .../zh_TW/process/code-of-conduct.rst | 2 +- .../translations/zh_TW/process/coding-style.rst | 4 ++-- .../translations/zh_TW/process/howto.rst | 12 ++++++------ .../zh_TW/process/management-style.rst | 4 ++-- .../zh_TW/process/stable-kernel-rules.rst | 2 +- .../zh_TW/process/submit-checklist.rst | 6 +++--- .../zh_TW/process/submitting-patches.rst | 16 ++++++++-------- 18 files changed, 58 insertions(+), 58 deletions(-)
Documentation/translations/zh_TW/admin-guide/README.rst +3 -3
@@ -284,12 +284,12 @@ Linux內核6.x版本 <http://kernel.org/> ----------- 如果您發現了一些可能由於內核缺陷所導致的問題,請參閱: -Documentation/translations/zh_CN/admin-guide/reporting-issues.rst 。 +Documentation/translations/zh_TW/admin-guide/reporting-issues.rst 。 想要理解內核錯誤報告,請參閱: -Documentation/translations/zh_CN/admin-guide/bug-hunting.rst 。 +Documentation/translations/zh_TW/admin-guide/bug-hunting.rst 。 更多用GDB調試內核的信息,請參閱: -Documentation/translations/zh_CN/dev-tools/gdb-kernel-debugging.rst +Documentation/translations/zh_TW/dev-tools/gdb-kernel-debugging.rst 和 Documentation/dev-tools/kgdb.rst 。
Documentation/translations/zh_TW/admin-guide/reporting-issues.rst +6 -6
@@ -301,7 +301,7 @@ Documentation/admin-guide/reporting-regressions.rst 對此進行了更詳細的 添加到迴歸跟蹤列表中,以確保它不會被忽略。 什麼是安全問題留給您自己判斷。在繼續之前,請考慮閱讀 -Documentation/translations/zh_CN/admin-guide/security-bugs.rst , +Documentation/translations/zh_TW/admin-guide/security-bugs.rst , 因爲它提供瞭如何最恰當地處理安全問題的額外細節。 當發生了完全無法接受的糟糕事情時,此問題就是一個“非常嚴重的問題”。例如,
@@ -385,7 +385,7 @@ Linux內核破壞了它處理的數據或損壞了它運行的硬件。當內核 核未被污染,那麼它應該以“Not infected”結束;如果你看到“Tainted:”且後跟一些 空格和字母,那就被污染了。 -如果你的內核被污染了,請閱讀 Documentation/translations/zh_CN/admin-guide/tainted-kernels.rst +如果你的內核被污染了,請閱讀 Documentation/translations/zh_TW/admin-guide/tainted-kernels.rst 以找出原因。設法消除污染因素。通常是由以下三種因素之一引起的: 1. 發生了一個可恢復的錯誤(“kernel Oops”),內核污染了自己,因爲內核知道在
@@ -798,7 +798,7 @@ Linux 首席開發者 Linus Torvalds 認爲 Linux 內核永遠不應惡化,這 重現它。 有一個叫做“二分”的過程可以來尋找變化,這在 -Documentation/translations/zh_CN/admin-guide/bug-bisect.rst 文檔中進行了詳細 +Documentation/translations/zh_TW/admin-guide/bug-bisect.rst 文檔中進行了詳細 的描述,這個過程通常需要你構建十到二十個內核鏡像,每次都嘗試在構建下一個鏡像 之前重現問題。是的,這需要花費一些時間,但不用擔心,它比大多數人想象的要快得多。 多虧了“binary search二分搜索”,這將引導你在源代碼管理系統中找到導致迴歸的提交。
@@ -984,7 +984,7 @@ Documentation/admin-guide/reporting-regressions.rst ;它還提供了大量其 報告,請將報告的文本轉發到這些地址;但請在報告的頂部加上註釋,表明您提交了 報告,並附上工單鏈接。 -更多信息請參見 Documentation/translations/zh_CN/admin-guide/security-bugs.rst 。 +更多信息請參見 Documentation/translations/zh_TW/admin-guide/security-bugs.rst 。 發佈報告後的責任
@@ -1198,7 +1198,7 @@ FLOSS 問題報告的人看,詢問他們的意見。同時徵求他們關於 前一段基本粗略地概述了“二分”方法。一旦報告出來,您可能會被要求做一個正確的 報告,因爲它允許精確地定位導致問題的確切更改(然後很容易被恢復以快速修復問題)。 因此如果時間允許,考慮立即進行適當的二分。有關如何詳細信息,請參閱“對迴歸的 -特別關照”部分和文檔 Documentation/translations/zh_CN/admin-guide/bug-bisect.rst 。 +特別關照”部分和文檔 Documentation/translations/zh_TW/admin-guide/bug-bisect.rst 。 如果成功二分的話,請將“罪魁禍首”的作者添加到收件人中;同時抄送所有在 signed-off-by鏈中的人,您可以在提交消息的末尾找到。
@@ -1217,7 +1217,7 @@ signed-off-by鏈中的人,您可以在提交消息的末尾找到。 即使是微小的、看似明顯的代碼變化,有時也會帶來新的、完全意想不到的問題。穩 定版和長期支持內核的維護者非常清楚這一點,因此他們只對這些內核進行符合 -Documentation/translations/zh_CN/process/stable-kernel-rules.rst 中所列出的 +Documentation/translations/zh_TW/process/stable-kernel-rules.rst 中所列出的 規則的修改。 複雜或有風險的修改不符合條件,因此只能應用於主線。其他的修復很容易被回溯到
Documentation/translations/zh_TW/admin-guide/reporting-regressions.rst +5 -5
@@ -28,7 +28,7 @@ Torvalds立下了此規則並確保它被落實。 能用,那麼你就碰見迴歸問題了。注意,新內核需要使用類似配置編譯;更多相關細 節參見下方。 -#. 按照 Documentation/translations/zh_CN/admin-guide/reporting-issues.rst 中 +#. 按照 Documentation/translations/zh_TW/admin-guide/reporting-issues.rst 中 所說的報告你的問題,該文檔已經包含了所有關於迴歸的重要方面,爲了方便起見也 複製到了下面。兩個重點:在報告主題中使用“[REGRESSION]”開頭並抄送或轉發到 `迴歸郵件列表 <https://lore.kernel.org/regressions/>`_
@@ -71,7 +71,7 @@ Torvalds立下了此規則並確保它被落實。 如何報告迴歸? ~~~~~~~~~~~~~~ -只需按照 Documentation/translations/zh_CN/admin-guide/reporting-issues.rst 中 +只需按照 Documentation/translations/zh_TW/admin-guide/reporting-issues.rst 中 所說的報告你的問題,該文檔已經包含了要點。下面幾點概述了一下只在迴歸中重要的 方面:
@@ -133,8 +133,8 @@ regzbot發送的每週迴歸報告,可能會出現延遲。 這樣的延誤會 如何找到罪魁禍首? ~~~~~~~~~~~~~~~~~~ -如 Documentation/translations/zh_CN/admin-guide/reporting-issues.rst (簡要) -和 Documentation/translations/zh_CN/admin-guide/bug-bisect.rst (詳細)中所 +如 Documentation/translations/zh_TW/admin-guide/reporting-issues.rst (簡要) +和 Documentation/translations/zh_TW/admin-guide/bug-bisect.rst (詳細)中所 述,執行二分。聽起來工作量很大,但大部分情況下很快就能找到罪魁禍首。如果這很 困難或可靠地重現問題很耗時,請考慮與其他受影響的用戶合作,一起縮小搜索範圍。
@@ -364,7 +364,7 @@ Regzbot還支持其他一些主要由開發人員或迴歸追蹤人員使用的 .. 如本文件開頭所述,本文以GPL-2.0+或CC-BY-4.0許可發行。如您想僅在CC-BY-4.0許 可下重分發本文,請用“Linux內核開發者”作爲作者,並用如下鏈接作爲來源: - https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/plain/Documentation/translations/zh_CN/admin-guide/reporting-regressions.rst + https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/plain/Documentation/translations/zh_TW/admin-guide/reporting-regressions.rst .. 注意:本RST文件內容只有在來自Linux內核源代碼時是使用CC-BY-4.0許可的,因爲經 過處理的版本(如經內核的構建系統)可能包含來自使用更嚴格許可證的文件的內容。
Documentation/translations/zh_TW/admin-guide/security-bugs.rst +1 -1
@@ -24,7 +24,7 @@ Linux內核開發人員非常重視安全性。因此我們想知道何時發現 人員那裏獲得額外的幫助,以理解和修復安全漏洞。 與任何缺陷一樣,提供的信息越多,診斷和修復就越容易。如果您不清楚哪些信息有用, -請查看“Documentation/translations/zh_CN/admin-guide/reporting-issues.rst”中 +請查看“Documentation/translations/zh_TW/admin-guide/reporting-issues.rst”中 概述的步驟。任何利用漏洞的攻擊代碼都非常有用,未經報告者同意不會對外發布,除 非已經公開。
Documentation/translations/zh_TW/arch/arm64/booting.txt +1 -1
@@ -9,7 +9,7 @@ help. Contact the Chinese maintainer if this translation is outdated or if there is a problem with the translation. M: Will Deacon <[email protected]> -zh_CN: Fu Wei <[email protected]> +zh_TW: Fu Wei <[email protected]> zh_TW: Hu Haowen <[email protected]> C: 55f058e7574c3615dea4615573a19bdb258696c6 ---------------------------------------------------------------------
Documentation/translations/zh_TW/arch/arm64/silicon-errata.txt +1 -1
@@ -9,7 +9,7 @@ help. Contact the Chinese maintainer if this translation is outdated or if there is a problem with the translation. M: Will Deacon <[email protected]> -zh_CN: Fu Wei <[email protected]> +zh_TW: Fu Wei <[email protected]> zh_TW: Hu Haowen <[email protected]> C: 1926e54f115725a9248d0c4c65c22acaf94de4c4 ---------------------------------------------------------------------
Documentation/translations/zh_TW/process/1.Intro.rst +7 -7
@@ -26,31 +26,31 @@ 的自動可用性、多種形式的社區支持以及影響內核開發方向的能力。提供給Linux內核 的代碼必須在與GPL兼容的許可證下可用。 -:ref:`cn_development_process` 介紹了開發過程、內核發佈週期和合並窗口的機制。 +:ref:`tw_development_process` 介紹了開發過程、內核發佈週期和合並窗口的機制。 涵蓋了補丁開發、審查和合並週期中的各個階段。還有一些關於工具和郵件列表的討論? 鼓勵希望開始內核開發的開發人員跟蹤並修復缺陷以作爲初步練習。 -:ref:`cn_development_early_stage` 包括項目的早期規劃,重點是儘快讓開發社區 +:ref:`tw_development_early_stage` 包括項目的早期規劃,重點是儘快讓開發社區 參與進來。 -:ref:`cn_development_coding` 是關於編程過程的;介紹了其他開發人員遇到的幾個 +:ref:`tw_development_coding` 是關於編程過程的;介紹了其他開發人員遇到的幾個 陷阱。也涵蓋了對補丁的一些要求,並且介紹了一些工具,這些工具有助於確保內核 補丁是正確的。 -:ref:`cn_development_posting` 描述發佈補丁以供評審的過程。爲了讓開發社區能 +:ref:`tw_development_posting` 描述發佈補丁以供評審的過程。爲了讓開發社區能 認真對待,補丁必須被正確格式化和描述,並且必須發送到正確的地方。遵循本節中的 建議有助於確保您的工作能被較好地接納。 -:ref:`cn_development_followthrough` 介紹了發佈補丁之後發生的事情;工作在這時 +:ref:`tw_development_followthrough` 介紹了發佈補丁之後發生的事情;工作在這時 還遠遠沒有完成。與審閱者一起工作是開發過程中的一個重要部分;本節提供了一些 關於如何在這個重要階段避免問題的提示。當補丁被合併到主線中時,開發人員要注意 不要假定任務已經完成。 -:ref:`cn_development_advancedtopics` 介紹了兩個“高級”主題:使用Git管理補丁 +:ref:`tw_development_advancedtopics` 介紹了兩個“高級”主題:使用Git管理補丁 和查看其他人發佈的補丁。 -:ref:`cn_development_conclusion` 總結了有關內核開發的更多信息,附帶有相關資源 +:ref:`tw_development_conclusion` 總結了有關內核開發的更多信息,附帶有相關資源 鏈接。 這個文檔是關於什麼的
Documentation/translations/zh_TW/process/4.Coding.rst +1 -1
@@ -32,7 +32,7 @@ ******** 內核長期以來都有其標準的代碼風格,如 -:ref:`Documentation/translations/zh_CN/process/coding-style.rst <cn_codingstyle>` +:ref:`Documentation/translations/zh_TW/process/coding-style.rst <tw_codingstyle>` 中所述。在多數時候,該文檔中描述的準則至多被認爲是建議性的。因此,內核中存在 大量不符合代碼風格準則的代碼。這種代碼的存在會給內核開發人員帶來兩方面的危害。
Documentation/translations/zh_TW/process/5.Posting.rst +7 -7
@@ -22,8 +22,8 @@ 內核開發社區已經發展出一套用於發佈補丁的約定和過程;遵循這些約定和過程將使 參與其中的每個人的生活更加輕鬆。本文檔試圖描述這些約定的部分細節;更多信息 也可在以下文檔中找到 -:ref:`Documentation/translations/zh_CN/process/submitting-patches.rst <cn_submittingpatches>` -和 :ref:`Documentation/translations/zh_CN/process/submit-checklist.rst <cn_submitchecklist>`。 +:ref:`Documentation/translations/zh_TW/process/submitting-patches.rst <tw_submittingpatches>` +和 :ref:`Documentation/translations/zh_TW/process/submit-checklist.rst <tw_submitchecklist>`。 何時寄送 --------
@@ -154,7 +154,7 @@ 其傳遞給diff。 上面提到的標籤(tag)用於描述各種開發人員如何與這個補丁的開發相關聯。 -:ref:`Documentation/translations/zh_CN/process/submitting-patches.rst <cn_submittingpatches>` +:ref:`Documentation/translations/zh_TW/process/submitting-patches.rst <tw_submittingpatches>` 文檔中對它們進行了詳細描述;下面是一個簡短的總結。每一行的格式如下: ::
@@ -165,14 +165,14 @@ - Signed-off-by: 這是一個開發人員的證明,證明他或她有權提交補丁以包含到內核 中。這表明同意開發者來源認證協議,其全文見 - :ref:`Documentation/translations/zh_CN/process/submitting-patches.rst <cn_submittingpatches>` + :ref:`Documentation/translations/zh_TW/process/submitting-patches.rst <tw_submittingpatches>` 如果沒有合適的簽字,則不能合併到主線中。 - Co-developed-by: 聲明補丁是由多個開發人員共同創建的;當幾個人在一個補丁上 工作時,它用於給出共同作者(除了 From: 所給出的作者之外)。由於 Co-developed-by: 表示作者身份,所以每個共同開發人,必須緊跟在相關合作作者 的Signed-off-by之後。具體內容和示例見以下文件 - :ref:`Documentation/translations/zh_CN/process/submitting-patches.rst <cn_submittingpatches>` + :ref:`Documentation/translations/zh_TW/process/submitting-patches.rst <tw_submittingpatches>` - Acked-by: 表示另一個開發人員(通常是相關代碼的維護人員)同意補丁適合包含 在內核中。
@@ -180,7 +180,7 @@ - Tested-by: 聲明某人已經測試了補丁並確認它可以工作。 - Reviewed-by: 表示某開發人員已經審查了補丁的正確性;有關詳細信息,請參閱 - :ref:`Documentation/translations/zh_CN/process/submitting-patches.rst <cn_submittingpatches>` + :ref:`Documentation/translations/zh_TW/process/submitting-patches.rst <tw_submittingpatches>` - Reported-by: 指定報告此補丁修復的問題的用戶;此標記用於表示感謝。
@@ -197,7 +197,7 @@ 無法被另一端接受,並且通常不會進行任何詳細檢查。如果有任何疑問,先把補丁寄 給你自己,讓你自己確定它是完好無損的。 - :ref:`Documentation/translations/zh_CN/process/email-clients.rst <cn_email_clients>` + :ref:`Documentation/translations/zh_TW/process/email-clients.rst <tw_email_clients>` 提供了一些有用的提示,可以讓特定的郵件客戶端正常發送補丁。 - 你確定你的補丁沒有荒唐的錯誤嗎?您應該始終通過scripts/checkpatch.pl檢查
Documentation/translations/zh_TW/process/8.Conclusion.rst +2 -2
@@ -19,9 +19,9 @@ 關於Linux內核開發和相關主題的信息來源很多。首先是在內核源代碼分發中找到的 文檔目錄。頂級 -:ref:`Documentation/translations/zh_CN/process/howto.rst <cn_process_howto>` +:ref:`Documentation/translations/zh_TW/process/howto.rst <tw_process_howto>` 文件是一個重要的起點; -:ref:`Documentation/translations/zh_CN/process/submitting-patches.rst <cn_submittingpatches>` +:ref:`Documentation/translations/zh_TW/process/submitting-patches.rst <tw_submittingpatches>` 也是所有內核開發人員都應該閱讀的內容。許多內部內核API都是使用kerneldoc機制 記錄的;“make htmldocs”或“make pdfdocs”可用於以HTML或PDF格式生成這些文檔 (儘管某些發行版提供的tex版本會遇到內部限制,無法正確處理文檔)。
Documentation/translations/zh_TW/process/code-of-conduct-interpretation.rst +1 -1
@@ -11,7 +11,7 @@ Linux內核貢獻者契約行爲準則解釋 =============================== -:ref:`cn_code_of_conduct` 準則是一個通用文檔,旨在爲幾乎所有開源社區提供一套規則。 +:ref:`tw_code_of_conduct` 準則是一個通用文檔,旨在爲幾乎所有開源社區提供一套規則。 每個開源社區都是獨一無二的,Linux內核也不例外。因此,本文描述了Linux內核社區中 如何解釋它。我們也不希望這種解釋隨着時間的推移是靜態的,並將根據需要進行調整。
Documentation/translations/zh_TW/process/code-of-conduct.rst +1 -1
@@ -72,5 +72,5 @@ https://www.contributor-covenant.org/version/1/4/code-of-conduct.html 獲取。 解釋 ==== -有關Linux內核社區如何解釋此文檔,請參閱 :ref:`cn_code_of_conduct_interpretation` +有關Linux內核社區如何解釋此文檔,請參閱 :ref:`tw_code_of_conduct_interpretation`
Documentation/translations/zh_TW/process/coding-style.rst +2 -2
@@ -543,7 +543,7 @@ Linux 裏這是提倡的做法,因爲這樣可以很簡單的給讀者提供 也可以加上它做這些事情的原因。 當註釋內核 API 函數時,請使用 kernel-doc 格式。詳見 -Documentation/translations/zh_CN/doc-guide/index.rst 和 scripts/kernel-doc 。 +Documentation/translations/zh_TW/doc-guide/index.rst 和 scripts/kernel-doc 。 長 (多行) 註釋的首選風格是:
@@ -816,7 +816,7 @@ dev_info() 等等。對於那些不和某個特定設備相關連的信息,<li 內核提供了下面的一般用途的內存分配函數: kmalloc(), kzalloc(), kmalloc_array(), kcalloc(), vmalloc() 和 vzalloc()。 請參考 API 文檔以獲取有關它們的詳細信息: -Documentation/translations/zh_CN/core-api/memory-allocation.rst 。 +Documentation/translations/zh_TW/core-api/memory-allocation.rst 。 傳遞結構體大小的首選形式是這樣的:
Documentation/translations/zh_TW/process/howto.rst +6 -6
@@ -65,7 +65,7 @@ Linux內核使用GNU C和GNU工具鏈開發。雖然它遵循ISO C11標準,但 Linux內核源代碼都是在GPL(通用公共許可證)的保護下發布的。要了解這種許可 的細節請查看源代碼主目錄下的COPYING文件。Linux內核許可準則和如何使用 `SPDX <https://spdx.org/>` 標誌符說明在這個文件中 -:ref:`Documentation/translations/zh_CN/process/license-rules.rst <cn_kernel_licensing>` +:ref:`Documentation/translations/zh_TW/process/license-rules.rst <tw_kernel_licensing>` 如果你對它還有更深入問題請聯繫律師,而不要在Linux內核郵件組上提問。因爲 郵件組裏的人並不是律師,不要期望他們的話有法律效力。
@@ -91,12 +91,12 @@ Linux內核代碼中包含有大量的文檔。這些文檔對於學習如何與 :ref:`Documentation/process/changes.rst <changes>` 文件給出了用來編譯和使用內核所需要的最小軟件包列表。 - :ref:`Documentation/translations/zh_CN/process/coding-style.rst <cn_codingstyle>` + :ref:`Documentation/translations/zh_TW/process/coding-style.rst <tw_codingstyle>` 描述Linux內核的代碼風格和理由。所有新代碼需要遵守這篇文檔中定義的規 範。大多數維護者只會接收符合規定的補丁,很多人也只會幫忙檢查符合風格 的代碼。 - :ref:`Documentation/translations/zh_CN/process/submitting-patches.rst <cn_submittingpatches>` + :ref:`Documentation/translations/zh_TW/process/submitting-patches.rst <tw_submittingpatches>` 這兩份文檔明確描述如何創建和發送補丁,其中包括(但不僅限於): - 郵件內容
@@ -115,7 +115,7 @@ Linux內核代碼中包含有大量的文檔。這些文檔對於學習如何與 https://web.archive.org/web/20180829112450/http://linux.yyz.us/patch-format.html - :ref:`Documentation/translations/zh_CN/process/stable-api-nonsense.rst <cn_stable_api_nonsense>` + :ref:`Documentation/translations/zh_TW/process/stable-api-nonsense.rst <tw_stable_api_nonsense>` 論證內核爲什麼特意不包括穩定的內核內部API,也就是說不包括像這樣的特 性:
@@ -130,7 +130,7 @@ Linux內核代碼中包含有大量的文檔。這些文檔對於學習如何與 如果你認爲自己發現了Linux內核的安全性問題,請根據這篇文檔中的步驟來 提醒其他內核開發者並幫助解決這個問題。 - :ref:`Documentation/translations/zh_CN/process/management-style.rst <cn_managementstyle>` + :ref:`Documentation/translations/zh_TW/process/management-style.rst <tw_managementstyle>` 描述內核維護者的工作方法及其共有特點。這對於剛剛接觸內核開發(或者對 它感到好奇)的人來說很重要,因爲它解釋了很多對於內核維護者獨特行爲的
@@ -333,7 +333,7 @@ MAINTAINERS文件中可以找到不同話題對應的郵件列表。 這幾行。將你的評論加在被引用的段落之間而不要放在郵件的頂部。 如果你在郵件中附帶補丁,請確認它們是可以直接閱讀的純文本(如 -:ref:`Documentation/translations/zh_CN/process/submitting-patches.rst <cn_submittingpatches>` +:ref:`Documentation/translations/zh_TW/process/submitting-patches.rst <tw_submittingpatches>` 文檔中所述)。內核開發者們不希望遇到附件或者被壓縮了的補丁。只有這樣才能 保證他們可以直接評論你的每行代碼。請確保你使用的郵件發送程序不會修改空格 和製表符。一個防範性的測試方法是先將郵件發送給自己,然後自己嘗試是否可以
Documentation/translations/zh_TW/process/management-style.rst +2 -2
@@ -31,7 +31,7 @@ Linux內核管理風格 不管怎樣,這裏是: -.. _cn_decisions: +.. _tw_decisions: 1)決策 -------
@@ -111,7 +111,7 @@ Linux內核管理風格 但是,爲了做好作爲內核管理者的準備,最好記住不要燒掉任何橋樑,不要轟炸任何 無辜的村民,也不要疏遠太多的內核開發人員。事實證明,疏遠人是相當容易的,而 親近一個疏遠的人是很難的。因此,“疏遠”立即屬於“不可逆”的範疇,並根據 -:ref:`cn_decisions` 成爲絕不可以做的事情。 +:ref:`tw_decisions` 成爲絕不可以做的事情。 這裏只有幾個簡單的規則:
Documentation/translations/zh_TW/process/stable-kernel-rules.rst +1 -1
@@ -36,7 +36,7 @@ - 沒有“理論上的競爭條件”,除非能給出競爭條件如何被利用的解釋。 - 不能存在任何的“瑣碎的”修正(拼寫修正,去掉多餘空格之類的)。 - 必須被相關子系統的維護者接受。 - - 必須遵循Documentation/translations/zh_CN/process/submitting-patches.rst裏的規則。 + - 必須遵循Documentation/translations/zh_TW/process/submitting-patches.rst裏的規則。 向穩定版代碼樹提交補丁的過程: ------------------------------
Documentation/translations/zh_TW/process/submit-checklist.rst +3 -3
@@ -16,7 +16,7 @@ Linux內核補丁提交檢查單 如果開發人員希望看到他們的內核補丁提交更快地被接受,那麼他們應該做一些基本 的事情。 -這些都是在 Documentation/translations/zh_CN/process/submitting-patches.rst +這些都是在 Documentation/translations/zh_TW/process/submitting-patches.rst 和其他有關提交Linux內核補丁的文檔中提供的。 1) 如果使用工具,則包括定義/聲明該工具的文件。不要依賴其他頭文件來引入您使用
@@ -39,7 +39,7 @@ Linux內核補丁提交檢查單 4) PPC64是一種很好的交叉編譯檢查體系結構,因爲它傾向於對64位的數使用無符號 長整型。 -5) 按 Documentation/translations/zh_CN/process/coding-style.rst 所述檢查您的 +5) 按 Documentation/translations/zh_TW/process/coding-style.rst 所述檢查您的 補丁是否爲常規樣式。在提交之前使用補丁樣式檢查器 ``scripts/checkpatch.pl`` 檢查是否有輕微的衝突。您應該能夠處理您的補丁中存在的所有 違規行爲。
@@ -54,7 +54,7 @@ Linux內核補丁提交檢查單 回報的。 9) 通過 sparse 清查。 - (參見 Documentation/translations/zh_CN/dev-tools/sparse.rst ) + (參見 Documentation/translations/zh_TW/dev-tools/sparse.rst ) 10) 使用 ``make checkstack`` 和 ``make namespacecheck`` 並修復他們發現的任何 問題。
Documentation/translations/zh_TW/process/submitting-patches.rst +8 -8
@@ -25,8 +25,8 @@ 的改動被接受的機會. 本文檔以較爲簡潔的行文給出了大量建議。關於內核開發流程如何進行的詳細信息, -參見: Documentation/translations/zh_CN/process/development-process.rst 。 -Documentation/translations/zh_CN/process/submit-checklist.rst 給出了一系列 +參見: Documentation/translations/zh_TW/process/development-process.rst 。 +Documentation/translations/zh_TW/process/submit-checklist.rst 給出了一系列 提交補丁之前要檢查的事項。設備樹相關的補丁,請參閱 Documentation/devicetree/bindings/submitting-patches.rst 。
@@ -162,7 +162,7 @@ xyzzy do frotz”或“[I]changed xyzzy to do frotz”,就好像你在命令 ---------------- 檢查您的補丁是否違反了基本樣式規定,詳細信息參見 -Documentation/translations/zh_CN/process/coding-style.rst +Documentation/translations/zh_TW/process/coding-style.rst 中找到。如果不這樣做,只會浪費審閱者的時間,並且會導致你的補丁被拒絕,甚至 可能沒有被閱讀。
@@ -209,7 +209,7 @@ [email protected] 。他收到的郵件很多,所以一般來說 如果您有修復可利用安全漏洞的補丁,請將該補丁發送到 [email protected] 。對於 嚴重的bug,可以考慮短期禁令以允許分銷商(有時間)向用戶發佈補丁;在這種情況下, 顯然不應將補丁發送到任何公共列表。 -參見 Documentation/translations/zh_CN/admin-guide/security-bugs.rst 。 +參見 Documentation/translations/zh_TW/admin-guide/security-bugs.rst 。 修復已發佈內核中嚴重錯誤的補丁程序應該抄送給穩定版維護人員,方法是把以下列行 放進補丁的籤準區(注意,不是電子郵件收件人)::
@@ -217,7 +217,7 @@ [email protected] 。他收到的郵件很多,所以一般來說 Cc: [email protected] 除了本文件之外,您還應該閱讀 -Documentation/translations/zh_CN/process/stable-kernel-rules.rst 。 +Documentation/translations/zh_TW/process/stable-kernel-rules.rst 。 如果更改影響到用戶側內核接口,請向手冊頁維護人員(如維護人員文件中所列)發送 手冊頁補丁,或至少發送更改通知,以便一些信息進入手冊頁。還應將用戶空間API
@@ -248,7 +248,7 @@ Linus 和其他的內核開發者需要閱讀和評論你提交的改動。對 例外:如果你的郵路損壞了補丁,那麼有人可能會要求你使用MIME重新發送補丁。 -請參閱 Documentation/translations/zh_CN/process/email-clients.rst +請參閱 Documentation/translations/zh_TW/process/email-clients.rst 以獲取有關配置電子郵件客戶端以使其不受影響地發送補丁的提示。 回覆審閱意見
@@ -443,7 +443,7 @@ Fixes: 指示補丁修復了之前提交的一個問題。它可以便於確定 附加Fixes:標籤不會改變穩定內核規則流程,也不改變所有穩定版補丁抄送 [email protected]的要求。有關更多信息,請閱讀 - Documentation/translations/zh_CN/process/stable-kernel-rules.rst 。 + Documentation/translations/zh_TW/process/stable-kernel-rules.rst 。 .. _zh_the_canonical_patch_format:
@@ -647,7 +647,7 @@ Greg Kroah-Hartman,“如何惹惱內核子系統維護人員” 不!!!別再發巨型補丁炸彈給[email protected]的人們了! <https://lore.kernel.org/r/[email protected]> -內核 Documentation/translations/zh_CN/process/coding-style.rst +內核 Documentation/translations/zh_TW/process/coding-style.rst Linus Torvalds關於標準補丁格式的郵件 <https://lore.kernel.org/r/[email protected]>
Signature · 1 line
2.34.1
Quoted 10 lines · Hu Haowen
Update zh_TW's documentation concentrating on the following aspects:
* The file tree structure changes of the main documentation;
* Some changes and ideas fromzh_CNtranslation;
* Removal for several obsoleted contents within thezh_TWtranslation or those which are not exising anymore in the main documentation.
* Replacements for some incorrect words and phrases in traditional Chinese or those which are odd within their context being hard for readers to comprehend.
Quoted 6 lines
v2:
* Remove the fancy character U+feff (ZERO WIDTH NO-BREAK SPACE) reported by Corbet in https://lore.kernel.org/lkml/[email protected]/v1:
https://lore.kernel.org/lkml/[email protected]/
Dear Corbet,
Did you receive my patches? Please get down to them soon because I have another series of patches pending on until the current patches are resolved.
Thanks,
Hu Haowen
Jonathan Corbet
maintainerQuoted 3 lines · Hu Haowen
Did you receive my patches? Please get down to them soon because I have another series of patches pending on until the current patches are resolved.
Yes, I receive your patches.
I'll ask you again: please be a little more patient. I will get to them.
jon
Jonathan Corbet
maintainerQuoted 10 lines · Jonathan Corbet
Quoted 3 lines · Hu Haowen
Did you receive my patches? Please get down to them soon because I have another series of patches pending on until the current patches are resolved.
Yes, I receive your patches.
I'll ask you again: please be a little more patient. I will get to them.
I still cannot apply your patches:
Quoted 8 lines
WARNING: Message contains suspicious unicode control characters!
Subject: [PATCH v2 5/6] docs/zh_TW: update process
Line: .._tw_process_statement_kernel:
-------^
Char: ZERO WIDTH NO-BREAK SPACE (0xfeff)
If you are sure about this, rerun with the right flag to allow.
AM FAILED
I'll ask again: please send me a version lacking weird Unicode control characters.
Thanks,
jon