Commit 1fb3b526 authored by Linus Torvalds's avatar Linus Torvalds
Browse files

Merge tag 'docs-5.2a' of git://git.lwn.net/linux 

Pull more documentation updates from Jonathan Corbet:
 "Some late arriving documentation changes. In particular, this contains
  the conversion of the x86 docs to RST, which has been in the works for
  some time but needed a couple of final tweaks"

* tag 'docs-5.2a' of git://git.lwn.net/linux: (29 commits)
  Documentation: x86: convert x86_64/machinecheck to reST
  Documentation: x86: convert x86_64/cpu-hotplug-spec to reST
  Documentation: x86: convert x86_64/fake-numa-for-cpusets to reST
  Documentation: x86: convert x86_64/5level-paging.txt to reST
  Documentation: x86: convert x86_64/mm.txt to reST
  Documentation: x86: convert x86_64/uefi.txt to reST
  Documentation: x86: convert x86_64/boot-options.txt to reST
  Documentation: x86: convert i386/IO-APIC.txt to reST
  Documentation: x86: convert usb-legacy-support.txt to reST
  Documentation: x86: convert orc-unwinder.txt to reST
  Documentation: x86: convert resctrl_ui.txt to reST
  Documentation: x86: convert microcode.txt to reST
  Documentation: x86: convert pti.txt to reST
  Documentation: x86: convert amd-memory-encryption.txt to reST
  Documentation: x86: convert intel_mpx.txt to reST
  Documentation: x86: convert protection-keys.txt to reST
  Documentation: x86: convert pat.txt to reST
  Documentation: x86: convert mtrr.txt to reST
  Documentation: x86: convert tlb.txt to reST
  Documentation: x86: convert zero-page.txt to reST
  ...
parents e290e6af afbd4d42

Documentation/index.rst

+1 −0
Original line number Diff line number Diff line
@@ -112,6 +112,7 @@ implementation. 
.. toctree::

   :maxdepth: 2



   x86/index

   sh/index



Filesystem Documentation

Documentation/trace/histogram.rst

+7 −4
Original line number Diff line number Diff line
@@ -1915,7 +1915,10 @@ The following commonly-used handler.action pairs are available: 


    The 'matching.event' specification is simply the fully qualified

    event name of the event that matches the target event for the

    onmatch() functionality, in the form 'system.event_name'.

    onmatch() functionality, in the form 'system.event_name'. Histogram

    keys of both events are compared to find if events match. In case

    multiple histogram keys are used, they all must match in the specified

    order.



    Finally, the number and type of variables/fields in the 'param

    list' must match the number and types of the fields in the
@@ -1978,9 +1981,9 @@ The following commonly-used handler.action pairs are available: 
	      /sys/kernel/debug/tracing/events/sched/sched_waking/trigger



    Then, when the corresponding thread is actually scheduled onto the

    CPU by a sched_switch event, calculate the latency and use that

    along with another variable and an event field to generate a

    wakeup_latency synthetic event::

    CPU by a sched_switch event (saved_pid matches next_pid), calculate

    the latency and use that along with another variable and an event field

    to generate a wakeup_latency synthetic event::



      # echo 'hist:keys=next_pid:wakeup_lat=common_timestamp.usecs-$ts0:\

              onmatch(sched.sched_waking).wakeup_latency($wakeup_lat,\

Documentation/translations/it_IT/process/license-rules.rst

+54 −6
Original line number Diff line number Diff line
@@ -249,13 +249,13 @@ essere categorizzate in: 


|



2. Licenze non raccomandate:

2. Licenze deprecate:



   Questo tipo di licenze dovrebbero essere usate solo per codice già esistente

   o quando si prende codice da altri progetti.  Le licenze sono disponibili

   nei sorgenti del kernel nella cartella::



     LICENSES/other/

     LICENSES/deprecated/



   I file in questa cartella contengono il testo completo della licenza e i

   `Metatag`_.  Il nome di questi file è lo stesso usato come identificatore
@@ -263,14 +263,14 @@ essere categorizzate in: 


   Esempi::



     LICENSES/other/ISC

     LICENSES/deprecated/ISC



   Contiene il testo della licenza Internet System Consortium e i suoi

   metatag::



     LICENSES/other/ZLib

     LICENSES/deprecated/GPL-1.0



   Contiene il testo della licenza ZLIB e i suoi metatag.

   Contiene il testo della versione 1 della licenza GPL e i suoi metatag.



   Metatag:
@@ -294,7 +294,55 @@ essere categorizzate in: 


|



3. _`Eccezioni`:

3. Solo per doppie licenze



   Queste licenze dovrebbero essere usate solamente per codice licenziato in

   combinazione con un'altra licenza che solitamente è quella preferita.

   Queste licenze sono disponibili nei sorgenti del kernel nella cartella::



     LICENSES/dual



   I file in questa cartella contengono il testo completo della rispettiva

   licenza e i suoi `Metatags`_.  I nomi dei file sono identici agli

   identificatori di licenza SPDX che dovrebbero essere usati nei file

   sorgenti.



   Esempi::



     LICENSES/dual/MPL-1.1



   Questo file contiene il testo della versione 1.1 della licenza *Mozilla

   Pulic License* e i metatag necessari::



     LICENSES/dual/Apache-2.0



   Questo file contiene il testo della versione 2.0 della licenza Apache e i

   metatag necessari.



   Metatag:



   I requisiti per le 'altre' ('*other*') licenze sono identici a quelli per le

   `Licenze raccomandate`_.



   Esempio del formato del file::



   Valid-License-Identifier: MPL-1.1

   SPDX-URL: https://spdx.org/licenses/MPL-1.1.html

   Usage-Guide:

     Do NOT use. The MPL-1.1 is not GPL2 compatible. It may only be used for

     dual-licensed files where the other license is GPL2 compatible.

     If you end up using this it MUST be used together with a GPL2 compatible

     license using "OR".

     To use the Mozilla Public License version 1.1 put the following SPDX

     tag/value pair into a comment according to the placement guidelines in

     the licensing rules documentation:

   SPDX-License-Identifier: MPL-1.1

   License-Text:

     Full license text



|



4. _`Eccezioni`:



   Alcune licenze possono essere corrette con delle eccezioni che forniscono

   diritti aggiuntivi.  Queste eccezioni sono disponibili nei sorgenti del

Documentation/x86/amd-memory-encryption.txt→Documentation/x86/amd-memory-encryption.rst

+10 −3
Original line number Diff line number Diff line 
.. SPDX-License-Identifier: GPL-2.0



=====================

AMD Memory Encryption

=====================



Secure Memory Encryption (SME) and Secure Encrypted Virtualization (SEV) are

features found on AMD processors.
@@ -34,7 +40,7 @@ is operating in 64-bit or 32-bit PAE mode, in all other modes the SEV hardware 
forces the memory encryption bit to 1.



Support for SME and SEV can be determined through the CPUID instruction. The

CPUID function 0x8000001f reports information related to SME:

CPUID function 0x8000001f reports information related to SME::



	0x8000001f[eax]:

		Bit[0] indicates support for SME
@@ -48,14 +54,14 @@ CPUID function 0x8000001f reports information related to SME: 
			   addresses)



If support for SME is present, MSR 0xc00100010 (MSR_K8_SYSCFG) can be used to

determine if SME is enabled and/or to enable memory encryption:

determine if SME is enabled and/or to enable memory encryption::



	0xc0010010:

		Bit[23]   0 = memory encryption features are disabled

			  1 = memory encryption features are enabled



If SEV is supported, MSR 0xc0010131 (MSR_AMD64_SEV) can be used to determine if

SEV is active:

SEV is active::



	0xc0010131:

		Bit[0]	  0 = memory encryption is not active
@@ -68,6 +74,7 @@ requirements for the system. If this bit is not set upon Linux startup then 
Linux itself will not set it and memory encryption will not be possible.



The state of SME in the Linux kernel can be documented as follows:



	- Supported:

	  The CPU supports SME (determined through CPUID instruction).

Documentation/x86/boot.txt→Documentation/x86/boot.rst

+325 −203

File changed and moved.

Preview size limit exceeded, changes collapsed.