mirror of
https://github.com/AsahiLinux/u-boot
synced 2024-12-01 17:10:11 +00:00
9744d1a547
This patch adds a new pstore command allowing to display or save ramoops logs (oops, panic, console, ftrace and user) generated by a previous kernel crash. PStore parameters can be set in U-Boot configuration file, or at run-time using "pstore set" command. Records size should be the same as the ones used by kernel, and should be a power of 2. This command allows: - to display uncompressed logs - to save compressed or uncompressed logs, compressed logs are saved as a compressed stream, it may need some work to be able to decompress it, e.g. adding a fake header: "printf "\x1f\x8b\x08\x00\x00\x00\x00\x00\x00\x00" | cat - dmesg-ramoops-0.enc.z | gzip -dc" - ECC part is not used to check memory corruption - only 1st FTrace log is displayed or saved Signed-off-by: Frédéric Danis <frederic.danis@collabora.com> [trini: Minor updates for current design, correct spacing in rST] Signed-off-by: Tom Rini <trini@konsulko.com> Cc: Heinrich Schuchardt <xypron.glpk@gmx.de> Cc: Wolfgang Denk <wd@denx.de> Cc: Heiko Schocher <hs@denx.de>
122 lines
2.6 KiB
ReStructuredText
122 lines
2.6 KiB
ReStructuredText
.. SPDX-License-Identifier: GPL-2.0+
|
|
|
|
.. _u-boot_doc:
|
|
|
|
The U-Boot Documentation
|
|
========================
|
|
|
|
This is the top level of the U-Boot's documentation tree. U-Boot
|
|
documentation, like the U-Boot itself, is very much a work in progress;
|
|
that is especially true as we work to integrate our many scattered
|
|
documents into a coherent whole. Please note that improvements to the
|
|
documentation are welcome; join the U-Boot list at http://lists.denx.de
|
|
if you want to help out.
|
|
|
|
.. toctree::
|
|
:maxdepth: 2
|
|
|
|
User-oriented documentation
|
|
---------------------------
|
|
|
|
The following manuals are written for *users* of the U-Boot - those who are
|
|
trying to get it to work optimally on a given system.
|
|
|
|
.. toctree::
|
|
:maxdepth: 2
|
|
|
|
build/index
|
|
|
|
Developer-oriented documentation
|
|
--------------------------------
|
|
|
|
The following manuals are written for *developers* of the U-Boot - those who
|
|
want to contribute to U-Boot.
|
|
|
|
.. toctree::
|
|
:maxdepth: 2
|
|
|
|
develop/index
|
|
|
|
Unified Extensible Firmware (UEFI)
|
|
----------------------------------
|
|
|
|
U-Boot provides an implementation of the UEFI API allowing to run UEFI
|
|
compliant software like Linux, GRUB, and iPXE. Furthermore U-Boot itself
|
|
can be run an UEFI payload.
|
|
|
|
.. toctree::
|
|
:maxdepth: 2
|
|
|
|
uefi/index
|
|
|
|
Driver-Model documentation
|
|
--------------------------
|
|
|
|
The following holds information on the U-Boot device driver framework:
|
|
driver-model, including the design details of itself and several driver
|
|
subsystems.
|
|
|
|
.. toctree::
|
|
:maxdepth: 2
|
|
|
|
driver-model/index
|
|
|
|
U-Boot API documentation
|
|
------------------------
|
|
|
|
These books get into the details of how specific U-Boot subsystems work
|
|
from the point of view of a U-Boot developer. Much of the information here
|
|
is taken directly from the U-Boot source, with supplemental material added
|
|
as needed (or at least as we managed to add it - probably *not* all that is
|
|
needed).
|
|
|
|
.. toctree::
|
|
:maxdepth: 2
|
|
|
|
api/index
|
|
|
|
Architecture-specific doc
|
|
-------------------------
|
|
|
|
These books provide programming details about architecture-specific
|
|
implementation.
|
|
|
|
.. toctree::
|
|
:maxdepth: 2
|
|
|
|
arch/index
|
|
|
|
Board-specific doc
|
|
------------------
|
|
|
|
These books provide details about board-specific information. They are
|
|
organized in a vendor subdirectory.
|
|
|
|
.. toctree::
|
|
:maxdepth: 2
|
|
|
|
board/index
|
|
|
|
Android-specific doc
|
|
--------------------
|
|
|
|
These books provide information about booting the Android OS from U-Boot,
|
|
manipulating Android images from U-Boot shell and discusses other
|
|
Android-specific features available in U-Boot.
|
|
|
|
.. toctree::
|
|
:maxdepth: 2
|
|
|
|
android/index
|
|
|
|
Command line
|
|
------------
|
|
.. toctree::
|
|
:maxdepth: 2
|
|
|
|
pstore.rst
|
|
|
|
Indices and tables
|
|
==================
|
|
|
|
* :ref:`genindex`
|