brintos

brintos / linux-shallow public Read only

0
0
Text · 14.6 KiB · 5942558 Raw
373 lines · plain
1.. SPDX-License-Identifier: GPL-2.02 3.. include:: ../disclaimer-zh_TW.rst4 5:Original: :ref:`Documentation/process/license-rules.rst <kernel_licensing>`6:Translator: Alex Shi <alex.shi@linux.alibaba.com>7             Hu Haowen <2023002089@link.tyut.edu.cn>8 9.. _tw_kernel_licensing:10 11Linux內核許可規則12=================13 14Linux內核根據LICENSES/preferred/GPL-2.0中提供的GNU通用公共許可證版本215(GPL-2.0)的條款提供,並在LICENSES/exceptions/Linux-syscall-note中顯式16描述了例外的系統調用,如COPYING文件中所述。17 18此文檔文件提供瞭如何對每個源文件進行註釋以使其許可證清晰明確的說明。19它不會取代內核的許可證。20 21內核源代碼作爲一個整體適用於COPYING文件中描述的許可證,但是單個源文件可以22具有不同的與GPL-20兼容的許可證::23 24    GPL-1.0+ : GNU通用公共許可證v1.0或更高版本25    GPL-2.0+ : GNU通用公共許可證v2.0或更高版本26    LGPL-2.0 : 僅限GNU庫通用公共許可證v227    LGPL-2.0+: GNU 庫通用公共許可證v2或更高版本28    LGPL-2.1 : 僅限GNU寬通用公共許可證v2.129    LGPL-2.1+: GNU寬通用公共許可證v2.1或更高版本30 31除此之外,個人文件可以在雙重許可下提供,例如一個兼容的GPL變體,或者BSD,32MIT等許可。33 34用戶空間API(UAPI)頭文件描述了用戶空間程序與內核的接口,這是一種特殊情況。35根據內核COPYING文件中的註釋,syscall接口是一個明確的邊界,它不會將GPL要求36擴展到任何使用它與內核通信的軟件。由於UAPI頭文件必須包含在創建在Linux內核37上運行的可執行文件的任何源文件中,因此此例外必須記錄在特別的許可證表述中。38 39表達源文件許可證的常用方法是將匹配的樣板文本添加到文件的頂部註釋中。由於40格式,拼寫錯誤等,這些“樣板”很難通過那些在上下文中使用的驗證許可證合規性41的工具。42 43樣板文本的替代方法是在每個源文件中使用軟件包數據交換(SPDX)許可證標識符。44SPDX許可證標識符是機器可解析的,並且是用於提供文件內容的許可證的精確縮寫。45SPDX許可證標識符由Linux 基金會的SPDX 工作組管理,並得到了整個行業,工具46供應商和法律團隊的合作伙伴的一致同意。有關詳細信息,請參閱47https://spdx.org/48 49Linux內核需要所有源文件中的精確SPDX標識符。內核中使用的有效標識符在50`許可標識符`_ 一節中進行了解釋,並且已可以在51https://spdx.org/licenses/ 上的官方SPDX許可證列表中檢索,並附帶許可證52文本。53 54許可標識符語法55--------------56 571.安置:58 59   內核文件中的SPDX許可證標識符應添加到可包含註釋的文件中的第一行。對於大多60   數文件,這是第一行,除了那些在第一行中需要'#!PATH_TO_INTERPRETER'的腳本。61   對於這些腳本,SPDX標識符進入第二行。62 63|64 652. 風格:66 67   SPDX許可證標識符以註釋的形式添加。註釋樣式取決於文件類型::68 69      C source:	// SPDX-License-Identifier: <SPDX License Expression>70      C header:	/* SPDX-License-Identifier: <SPDX License Expression> */71      ASM:	/* SPDX-License-Identifier: <SPDX License Expression> */72      scripts:	# SPDX-License-Identifier: <SPDX License Expression>73      .rst:	.. SPDX-License-Identifier: <SPDX License Expression>74      .dts{i}:	// SPDX-License-Identifier: <SPDX License Expression>75 76   如果特定工具無法處理標準註釋樣式,則應使用工具接受的相應註釋機制。這是在77   C 頭文件中使用“/\*\*/”樣式註釋的原因。過去在使用生成的.lds文件中觀察到78   構建被破壞,其中'ld'無法解析C++註釋。現在已經解決了這個問題,但仍然有較79   舊的彙編程序工具無法處理C++樣式的註釋。80 81|82 833. 句法:84 85   <SPDX許可證表達式>是SPDX許可證列表中的SPDX短格式許可證標識符,或者在許可86   證例外適用時由“WITH”分隔的兩個SPDX短格式許可證標識符的組合。當應用多個許87   可證時,表達式由分隔子表達式的關鍵字“AND”,“OR”組成,並由“(”,“)”包圍。88 89   帶有“或更高”選項的[L]GPL等許可證的許可證標識符通過使用“+”來表示“或更高”90   選項來構建。::91 92      // SPDX-License-Identifier: GPL-2.0+93      // SPDX-License-Identifier: LGPL-2.1+94 95   當需要修正的許可證時,應使用WITH。 例如,linux內核UAPI文件使用表達式::96 97      // SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note98      // SPDX-License-Identifier: GPL-2.0+ WITH Linux-syscall-note99 100   其它在內核中使用WITH例外的事例如下::101 102      // SPDX-License-Identifier: GPL-2.0 WITH mif-exception103      // SPDX-License-Identifier: GPL-2.0+ WITH GCC-exception-2.0104 105   例外只能與特定的許可證標識符一起使用。有效的許可證標識符列在異常文本文件106   的標記中。有關詳細信息,請參閱 `許可標識符`_ 一章中的 `例外`_ 。107 108   如果文件是雙重許可且只選擇一個許可證,則應使用OR。例如,一些dtsi文件在雙109   許可下可用::110 111      // SPDX-License-Identifier: GPL-2.0 OR BSD-3-Clause112 113   內核中雙許可文件中許可表達式的示例::114 115      // SPDX-License-Identifier: GPL-2.0 OR MIT116      // SPDX-License-Identifier: GPL-2.0 OR BSD-2-Clause117      // SPDX-License-Identifier: GPL-2.0 OR Apache-2.0118      // SPDX-License-Identifier: GPL-2.0 OR MPL-1.1119      // SPDX-License-Identifier: (GPL-2.0 WITH Linux-syscall-note) OR MIT120      // SPDX-License-Identifier: GPL-1.0+ OR BSD-3-Clause OR OpenSSL121 122   如果文件具有多個許可證,其條款全部適用於使用該文件,則應使用AND。例如,123   如果代碼是從另一個項目繼承的,並且已經授予了將其放入內核的權限,但原始124   許可條款需要保持有效::125 126      // SPDX-License-Identifier: (GPL-2.0 WITH Linux-syscall-note) AND MIT127 128   另一個需要遵守兩套許可條款的例子是::129 130      // SPDX-License-Identifier: GPL-1.0+ AND LGPL-2.1+131 132許可標識符133----------134 135當前使用的許可證以及添加到內核的代碼許可證可以分解爲:136 1371. _`優先許可`:138 139   應儘可能使用這些許可證,因爲它們已知完全兼容並廣泛使用。這些許可證在內核140   目錄::141 142      LICENSES/preferred/143 144   此目錄中的文件包含完整的許可證文本和 `元標記`_ 。文件名與SPDX許可證標識145   符相同,後者應用於源文件中的許可證。146 147   例如::148 149      LICENSES/preferred/GPL-2.0150 151   包含GPLv2許可證文本和所需的元標籤::152 153      LICENSES/preferred/MIT154 155   包含MIT許可證文本和所需的元標記156 157   _`元標記`:158 159   許可證文件中必須包含以下元標記:160 161   - Valid-License-Identifier:162 163     一行或多行, 聲明那些許可標識符在項目內有效, 以引用此特定許可的文本。通164     常這是一個有效的標識符,但是例如對於帶有'或更高'選項的許可證,兩個標識165     符都有效。166 167   - SPDX-URL:168 169     SPDX頁面的URL,其中包含與許可證相關的其他信息.170 171   - Usage-Guidance:172 173     使用建議的自由格式文本。該文本必須包含SPDX許可證標識符的正確示例,因爲174     它們應根據 `許可標識符語法`_ 指南放入源文件中。175 176   - License-Text:177 178     此標記之後的所有文本都被視爲原始許可文本179 180   文件格式示例::181 182      Valid-License-Identifier: GPL-2.0183      Valid-License-Identifier: GPL-2.0+184      SPDX-URL: https://spdx.org/licenses/GPL-2.0.html185      Usage-Guide:186        To use this license in source code, put one of the following SPDX187	tag/value pairs into a comment according to the placement188	guidelines in the licensing rules documentation.189	For 'GNU General Public License (GPL) version 2 only' use:190	  SPDX-License-Identifier: GPL-2.0191	For 'GNU General Public License (GPL) version 2 or any later version' use:192	  SPDX-License-Identifier: GPL-2.0+193      License-Text:194        Full license text195 196   ::197 198      SPDX-License-Identifier: MIT199      SPDX-URL: https://spdx.org/licenses/MIT.html200      Usage-Guide:201	To use this license in source code, put the following SPDX202	tag/value pair into a comment according to the placement203	guidelines in the licensing rules documentation.204	  SPDX-License-Identifier: MIT205      License-Text:206        Full license text207 208|209 2102. 不推薦的許可證:211 212   這些許可證只應用於現有代碼或從其他項目導入代碼。這些許可證在內核目錄::213 214      LICENSES/other/215 216   此目錄中的文件包含完整的許可證文本和 `元標記`_ 。文件名與SPDX許可證標識217   符相同,後者應用於源文件中的許可證。218 219   例如::220 221      LICENSES/other/ISC222 223   包含國際系統聯合許可文本和所需的元標籤::224 225      LICENSES/other/ZLib226 227   包含ZLIB許可文本和所需的元標籤.228 229   元標籤:230 231   “其他”許可證的元標籤要求與 `優先許可`_ 的要求相同。232 233   文件格式示例::234 235      Valid-License-Identifier: ISC236      SPDX-URL: https://spdx.org/licenses/ISC.html237      Usage-Guide:238        Usage of this license in the kernel for new code is discouraged239	and it should solely be used for importing code from an already240	existing project.241        To use this license in source code, put the following SPDX242	tag/value pair into a comment according to the placement243	guidelines in the licensing rules documentation.244	  SPDX-License-Identifier: ISC245      License-Text:246        Full license text247 248|249 2503. _`例外`:251 252   某些許可證可以修改,並允許原始許可證不具有的某些例外權利。這些例外在253   內核目錄::254 255      LICENSES/exceptions/256 257   此目錄中的文件包含完整的例外文本和所需的 `例外元標記`_ 。258 259   例如::260 261      LICENSES/exceptions/Linux-syscall-note262 263   包含Linux內核的COPYING文件中記錄的Linux系統調用例外,該文件用於UAPI264   頭文件。例如::265 266      LICENSES/exceptions/GCC-exception-2.0267 268   包含GCC'鏈接例外',它允許獨立於其許可證的任何二進制文件與標記有此例外的269   文件的編譯版本鏈接。這是從GPL不兼容源代碼創建可運行的可執行文件所必需的。270 271   _`例外元標記`:272 273   以下元標記必須在例外文件中可用:274 275   - SPDX-Exception-Identifier:276 277     一個可與SPDX許可證標識符一起使用的例外標識符。278 279   - SPDX-URL:280 281     SPDX頁面的URL,其中包含與例外相關的其他信息。282 283   - SPDX-Licenses:284 285     以逗號分隔的例外可用的SPDX許可證標識符列表。286 287   - Usage-Guidance:288 289     使用建議的自由格式文本。必須在文本後面加上SPDX許可證標識符的正確示例,290     因爲它們應根據 `許可標識符語法`_ 指南放入源文件中。291 292   - Exception-Text:293 294     此標記之後的所有文本都被視爲原始異常文本295 296   文件格式示例::297 298      SPDX-Exception-Identifier: Linux-syscall-note299      SPDX-URL: https://spdx.org/licenses/Linux-syscall-note.html300      SPDX-Licenses: GPL-2.0, GPL-2.0+, GPL-1.0+, LGPL-2.0, LGPL-2.0+, LGPL-2.1, LGPL-2.1+301      Usage-Guidance:302        This exception is used together with one of the above SPDX-Licenses303	to mark user-space API (uapi) header files so they can be included304	into non GPL compliant user-space application code.305        To use this exception add it with the keyword WITH to one of the306	identifiers in the SPDX-Licenses tag:307	  SPDX-License-Identifier: <SPDX-License> WITH Linux-syscall-note308      Exception-Text:309        Full exception text310 311   ::312 313      SPDX-Exception-Identifier: GCC-exception-2.0314      SPDX-URL: https://spdx.org/licenses/GCC-exception-2.0.html315      SPDX-Licenses: GPL-2.0, GPL-2.0+316      Usage-Guidance:317        The "GCC Runtime Library exception 2.0" is used together with one318	of the above SPDX-Licenses for code imported from the GCC runtime319	library.320        To use this exception add it with the keyword WITH to one of the321	identifiers in the SPDX-Licenses tag:322	  SPDX-License-Identifier: <SPDX-License> WITH GCC-exception-2.0323      Exception-Text:324        Full exception text325 326 327所有SPDX許可證標識符和例外都必須在LICENSES子目錄中具有相應的文件。這是允許328工具驗證(例如checkpatch.pl)以及準備好從源讀取和提取許可證所必需的, 這是329各種FOSS組織推薦的,例如 `FSFE REUSE initiative <https://reuse.software/>`_.330 331_`模塊許可`332-----------------333 334   可加載內核模塊還需要MODULE_LICENSE()標記。此標記既不替代正確的源代碼335   許可證信息(SPDX-License-Identifier),也不以任何方式表示或確定提供模塊336   源代碼的確切許可證。337 338   此標記的唯一目的是提供足夠的信息,該模塊是否是自由軟件或者是內核模塊加339   載器和用戶空間工具的專有模塊。340 341   MODULE_LICENSE()的有效許可證字符串是:342 343    ============================= =============================================344    "GPL"			  模塊是根據GPL版本2許可的。這並不表示僅限於345                                  GPL-2.0或GPL-2.0或更高版本之間的任何區別。346                                  最正確許可證信息只能通過相應源文件中的許可證347                                  信息來確定348 349    "GPL v2"			  和"GPL"相同,它的存在是因爲歷史原因。350 351    "GPL and additional rights"   表示模塊源在GPL v2變體和MIT許可下雙重許可的352                                  歷史變體。請不要在新代碼中使用。353 354    "Dual MIT/GPL"		  表達該模塊在GPL v2變體或MIT許可證選擇下雙重355                                  許可的正確方式。356 357    "Dual BSD/GPL"		  該模塊根據GPL v2變體或BSD許可證選擇進行雙重358                                  許可。 BSD許可證的確切變體只能通過相應源文件359                                  中的許可證信息來確定。360 361    "Dual MPL/GPL"		  該模塊根據GPL v2變體或Mozilla Public License362                                  (MPL)選項進行雙重許可。 MPL許可證的確切變體363                                  只能通過相應的源文件中的許可證信息來確定。364 365    "Proprietary"		  該模塊屬於專有許可。此字符串僅用於專有的第三366                                  方模塊,不能用於在內核樹中具有源代碼的模塊。367                                  以這種方式標記的模塊在加載時會使用'P'標記污368                                  染內核,並且內核模塊加載器拒絕將這些模塊鏈接369                                  到使用EXPORT_SYMBOL_GPL()導出的符號。370    ============================= =============================================371 372 373