linux.git/Documentation/staging, branch v6.12.80

xz: remove XZ_EXTERN and extern from functions

2024-09-02T03:43:27+00:00

XZ_EXTERN was used to make internal functions static in the preboot code. 
However, in other decompressors this hasn't been done.  On x86-64, this
makes no difference to the kernel image size.

Omit XZ_EXTERN and let some of the internal functions be extern in the
preboot code.  Omitting XZ_EXTERN from include/linux/xz.h fixes warnings
in "make htmldocs" and makes the intradocument links to xz_dec functions
work in Documentation/staging/xz.rst.  The alternative would have been to
add "XZ_EXTERN" to c_id_attributes in Documentation/conf.py but omitting
XZ_EXTERN seemed cleaner.

Link: https://lore.kernel.org/lkml/20240723205437.3c0664b0@kaneli/
Link: https://lkml.kernel.org/r/20240724110544.16430-1-lasse.collin@tukaani.org
Signed-off-by: Lasse Collin 
Tested-by: Michael Ellerman  (powerpc)
Cc: Jonathan Corbet 
Cc: Sam James 
Cc: Albert Ou 
Cc: Catalin Marinas 
Cc: Emil Renner Berthing 
Cc: Greg Kroah-Hartman 
Cc: Herbert Xu 
Cc: Joel Stanley 
Cc: Jubin Zhong 
Cc: Jules Maselbas 
Cc: Krzysztof Kozlowski 
Cc: Palmer Dabbelt 
Cc: Paul Walmsley 
Cc: Randy Dunlap 
Cc: Rui Li 
Cc: Simon Glass 
Cc: Thomas Gleixner 
Cc: Will Deacon 
Signed-off-by: Andrew Morton

xz: Documentation/staging/xz.rst: Revise thoroughly

2024-09-02T03:43:25+00:00

Add SPDX license identifier.

Omit xz_dec_test info. That isn't relevant to developers of non-XZ code.

Revise the docs about xzkern and add xzkern_with_size.  The latter was
added to scripts/Makefile.lib in the commit 7ce7e984ab2b ("kbuild: rename
cmd_{bzip2,lzma,lzo,lz4,xzkern,zstd22}").

Omit contact info as MAINTAINERS has it.

Omit other info that is outdated or not relevant in the kernel context.

Include the xz_dec kernel-doc from include/linux/xz.h.

Link: https://lkml.kernel.org/r/20240721133633.47721-8-lasse.collin@tukaani.org
Signed-off-by: Lasse Collin 
Reviewed-by: Sam James 
Reviewed-by: Randy Dunlap 
Tested-by: Randy Dunlap 
Cc: Rui Li 
Cc: Albert Ou 
Cc: Catalin Marinas 
Cc: Emil Renner Berthing 
Cc: Greg Kroah-Hartman 
Cc: Herbert Xu 
Cc: Joel Stanley 
Cc: Jonathan Corbet 
Cc: Jubin Zhong 
Cc: Jules Maselbas 
Cc: Krzysztof Kozlowski 
Cc: Michael Ellerman 
Cc: Palmer Dabbelt 
Cc: Paul Walmsley 
Cc: Simon Glass 
Cc: Thomas Gleixner 
Cc: Will Deacon 
Signed-off-by: Andrew Morton

Docs: Move magic-number from process to staging

2024-06-26T22:36:00+00:00

'Other material' section on 'process/index' is for unsorted documents.
However we also have a dedicated place for the purpose, 'staging/'.
Move 'magic-number' from the section to 'staging/' directory.

Signed-off-by: SeongJae Park 
Acked-by: Federico Vaga 
Signed-off-by: Jonathan Corbet 
Link: https://lore.kernel.org/r/20240624185312.94537-4-sj@kernel.org

docs: staging: fix typo in docs

2024-02-08T22:38:21+00:00

Resolve a spelling error in the documentation found
with codespell.

Signed-off-by: Vincenzo Mezzela 
Signed-off-by: Jonathan Corbet 
Link: https://lore.kernel.org/r/20240208162748.111120-1-vincenzo.mezzela@gmail.com

Merge tag 'rpmsg-v6.8' of git://git.kernel.org/pub/scm/linux/kernel/git/remoteproc/linux

2024-01-17T23:05:27+00:00

Pull rpmsg updates from Bjorn Andersson:
 "This make virtio free driver_override upon removal. It also updates
  the rpmsg documentation after earlier API updates"

* tag 'rpmsg-v6.8' of git://git.kernel.org/pub/scm/linux/kernel/git/remoteproc/linux:
  rpmsg: virtio: Free driver_override when rpmsg_remove()
  doc: rmpsg: Update with rpmsg_endpoint

Documentation: Destage TEE subsystem documentation

2023-12-08T22:45:10+00:00

Add a separate documentation directory for TEE subsystem since it is a
standalone subsystem which already offers devices consumed by multiple
different subsystem drivers.

Split overall TEE subsystem documentation modularly where:
- The userspace API has been moved to Documentation/userspace-api/tee.rst.
- The driver API has been moved to Documentation/driver-api/tee.rst.
- The first module covers the overview of TEE subsystem.
- The further modules are dedicated to different TEE implementations like:
  - OP-TEE
  - AMD-TEE
  - and so on for future TEE implementation support.

Acked-by: Rijo Thomas 
Acked-by: Jens Wiklander 
Signed-off-by: Sumit Garg 
Signed-off-by: Jonathan Corbet 
Link: https://lore.kernel.org/r/20231128072352.866859-1-sumit.garg@linaro.org

doc: rmpsg: Update with rpmsg_endpoint

2023-12-08T20:28:57+00:00

It seems the documentation was not updated when `rpmsg_sendto`
and related switched from `rpmsg_channel` to `rpmsg_endpoint`.
This change updates the proper calls, text, and the sample.

Signed-off-by: Adrien Leravat 
Link: https://lore.kernel.org/r/20231203200606.255302-1-adrien.leravat@gmail.com
Signed-off-by: Mathieu Poirier

Documentation: use capitalization for chapters and acronyms

2023-05-16T18:49:31+00:00

Use capital letters in acronyms for CD-ROM, FPGA, and PCMCIA.

Use capital letter in the first word of chapter headings for
Locking, Timers, and "Brief tutorial on CRC computation".

Signed-off-by: Randy Dunlap 
Cc: Moritz Fischer 
Cc: Wu Hao 
Cc: Tom Rix 
Cc: Peter Zijlstra 
Cc: Ingo Molnar 
Cc: Will Deacon 
Cc: Waiman Long 
Cc: Boqun Feng 
Cc: Dominik Brodowski 
Cc: Thomas Gleixner 
Acked-by: Xu Yilun 
Reviewed-by: Phillip Potter 
Link: https://lore.kernel.org/r/20230516001518.14514-1-rdunlap@infradead.org
Signed-off-by: Jonathan Corbet

tee: optee: Add SMC for loading OP-TEE image

2023-04-03T06:57:49+00:00

Adds an SMC call that will pass an OP-TEE binary image to EL3 and
instruct it to load it as the BL32 payload. This works in conjunction
with a feature added to Trusted Firmware for ARMv8 and above
architectures that supports this.

The main purpose of this change is to facilitate updating the OP-TEE
component on devices via a rootfs change rather than having to do a
firmware update. Further details are linked to in the Kconfig file.

Signed-off-by: Jeffrey Kardatzke 
Reviewed-by: Sumit Garg 
Signed-off-by: Jeffrey Kardatzke 
Signed-off-by: Jens Wiklander

docs: put atomic*.txt and memory-barriers.txt into the core-api book

2022-09-29T18:55:06+00:00

These files describe part of the core API, but have never been converted to
RST due to ... let's say local oppposition.  So, create a set of
special-purpose wrappers to ..include these files into a separate page so
that they can be a part of the htmldocs build.  Then link them into the
core-api manual and remove them from the "staging" dumping ground.

Acked-by: Jani Nikula 
Signed-off-by: Jonathan Corbet 
Reviewed-by: David Vernet 
Acked-by: Randy Dunlap 
Link: https://lore.kernel.org/r/20220927160559.97154-7-corbet@lwn.net
Signed-off-by: Jonathan Corbet