summaryrefslogtreecommitdiff
path: root/doc/develop
diff options
context:
space:
mode:
authorTom Rini <[email protected]>2023-05-08 14:31:04 -0400
committerTom Rini <[email protected]>2023-05-08 14:31:04 -0400
commit11910550b65e6072b9542d462c0aa93f4ca81836 (patch)
tree8308c98ffad76d9693654a28090b03f270a7d250 /doc/develop
parent9876c8c147144db2c120fcc9ffa6de27f6894441 (diff)
parentf1d33a44ca04fdca241c1d89fd79e2e56c930c7e (diff)
Merge branch 'master' into next
Diffstat (limited to 'doc/develop')
-rw-r--r--doc/develop/ci_testing.rst6
-rw-r--r--doc/develop/codingstyle.rst7
-rw-r--r--doc/develop/docstyle.rst29
-rw-r--r--doc/develop/driver-model/index.rst1
-rw-r--r--doc/develop/driver-model/nvmxip.rst91
-rw-r--r--doc/develop/event.rst2
-rw-r--r--doc/develop/index.rst1
-rw-r--r--doc/develop/release_cycle.rst22
-rw-r--r--doc/develop/statistics/u-boot-stats-v2023.04.rst767
-rw-r--r--doc/develop/trace.rst2
10 files changed, 916 insertions, 12 deletions
diff --git a/doc/develop/ci_testing.rst b/doc/develop/ci_testing.rst
index b9a9a516c1e..ffaacedc3d8 100644
--- a/doc/develop/ci_testing.rst
+++ b/doc/develop/ci_testing.rst
@@ -50,6 +50,12 @@ runners you are able to provide. While it is intended to be able to run this
pipeline on the free public instances provided at https://gitlab.com/ a problem
with our squashfs tests currently prevents this.
+To push to Gitlab without triggering a pipeline use:
+
+.. code-block:: bash
+
+ git push -o ci.skip
+
Docker container
----------------
diff --git a/doc/develop/codingstyle.rst b/doc/develop/codingstyle.rst
index 1d5d0192b3e..3d05a6b9887 100644
--- a/doc/develop/codingstyle.rst
+++ b/doc/develop/codingstyle.rst
@@ -19,6 +19,10 @@ The following rules apply:
applies only to Linux, not to U-Boot. Only large hunks which are copied
unchanged from Linux may retain that comment format.
+* Python code shall conform to `PEP8 (Style Guide for Python Code)
+ <https://peps.python.org/pep-0008/>`_. Use `pylint
+ <https://github.com/pylint-dev/pylint>`_ for checking the code.
+
* Use patman to send your patches (``tools/patman/patman -H`` for full
instructions). With a few tags in your commits this will check your patches
and take care of emailing them.
@@ -67,6 +71,9 @@ documentation is strongly advised. The Linux kernel `kernel-doc
<https://www.kernel.org/doc/html/latest/doc-guide/kernel-doc.html>`_
documentation applies with no changes.
+Our Python code documentation follows `PEP257 (Docstring Conventions)
+<https://peps.python.org/pep-0257/>`_.
+
Use structures for I/O access
-----------------------------
diff --git a/doc/develop/docstyle.rst b/doc/develop/docstyle.rst
new file mode 100644
index 00000000000..f9ba83a559c
--- /dev/null
+++ b/doc/develop/docstyle.rst
@@ -0,0 +1,29 @@
+.. SPDX-License-Identifier: GPL-2.0+:
+
+Documentation Style
+===================
+
+Documentation is crucial for the U-Boot project. It has to encompass the needs
+of different reader groups from first time users to developers and maintainers.
+This requires different types of documentation like tutorials, how-to-guides,
+explanatory texts, and reference.
+
+We want to be able to generate documentation in different target formats. We
+therefore use `Sphinx <https://www.sphinx-doc.org>`_ for the generation of
+documents from reStructured text.
+
+We apply the following rules:
+
+* Documentation files are located in *doc/* or its sub-directories.
+* Each documentation file is added to an index page to allow navigation
+ to the document.
+* For documentation we use reStructured text conforming to the requirements
+ of `Sphinx <https://www.sphinx-doc.org>`_.
+* For documentation within code we follow the Linux kernel guide
+ `Writing kernel-doc comments <https://docs.kernel.org/doc-guide/kernel-doc.html>`_.
+* We try to stick to 80 columns per line in documents.
+* For tables we prefer simple tables over grid tables. We avoid list tables
+ as they make the reStructured text documents hard to read.
+* Before submitting documentation patches we build the HTML documentation and
+ fix all warnings. The build process is described in
+ :doc:`/build/documentation`.
diff --git a/doc/develop/driver-model/index.rst b/doc/develop/driver-model/index.rst
index 7366ef818c5..8e12bbd9366 100644
--- a/doc/develop/driver-model/index.rst
+++ b/doc/develop/driver-model/index.rst
@@ -20,6 +20,7 @@ subsystems
livetree
migration
nvme
+ nvmxip
of-plat
pci-info
pmic-framework
diff --git a/doc/develop/driver-model/nvmxip.rst b/doc/develop/driver-model/nvmxip.rst
new file mode 100644
index 00000000000..e85dc220b9c
--- /dev/null
+++ b/doc/develop/driver-model/nvmxip.rst
@@ -0,0 +1,91 @@
+.. SPDX-License-Identifier: GPL-2.0+
+
+NVM XIP Block Storage Emulation Driver
+=======================================
+
+Summary
+-------
+
+Non-Volatile Memory devices with addressable memory (e.g: QSPI NOR flash) could
+be used for block storage needs (e.g: parsing a GPT layout in a raw QSPI NOR flash).
+
+The NVMXIP Uclass provides this functionality and can be used for any 64-bit platform.
+
+The NVMXIP Uclass provides the following drivers:
+
+ nvmxip-blk block driver:
+
+ A generic block driver allowing to read from the XIP flash.
+ The driver belongs to UCLASS_BLK.
+ The driver implemented by drivers/mtd/nvmxip/nvmxip.c
+
+ nvmxip Uclass driver:
+
+ When a device is described in the DT and associated with UCLASS_NVMXIP,
+ the Uclass creates a block device and binds it with the nvmxip-blk.
+ The Uclass driver implemented by drivers/mtd/nvmxip/nvmxip-uclass.c
+
+ nvmxip_qspi driver :
+
+ The driver probed with the DT and is the parent of the blk#<id> device.
+ nvmxip_qspi can be reused by other platforms. If the platform
+ has custom settings to apply before using the flash, then the platform
+ can provide its own parent driver belonging to UCLASS_NVMXIP and reuse
+ nvmxip-blk. The custom driver can be implemented like nvmxip_qspi in
+ addition to the platform custom settings.
+ The nvmxip_qspi driver belongs to UCLASS_NVMXIP.
+ The driver implemented by drivers/mtd/nvmxip/nvmxip_qspi.c
+
+ For example, if we have two NVMXIP devices described in the DT
+ The devices hierarchy is as follows:
+
+::
+
+ => dm tree
+
+ Class Index Probed Driver Name
+ -----------------------------------------------------------
+ ...
+ nvmxip 0 [ + ] nvmxip_qspi |-- nvmxip-qspi1@08000000
+ blk 3 [ + ] nvmxip-blk | `-- [email protected]#1
+ nvmxip 1 [ + ] nvmxip_qspi |-- nvmxip-qspi2@08200000
+ blk 4 [ + ] nvmxip-blk | `-- [email protected]#2
+
+The implementation is generic and can be used by different platforms.
+
+Supported hardware
+--------------------------------
+
+Any plaform supporting readq().
+
+Configuration
+----------------------
+
+config NVMXIP
+ This option allows the emulation of a block storage device
+ on top of a direct access non volatile memory XIP flash devices.
+ This support provides the read operation.
+ This option provides the block storage driver nvmxip-blk which
+ handles the read operation. This driver is HW agnostic and can support
+ multiple flash devices at the same time.
+
+config NVMXIP_QSPI
+ This option allows the emulation of a block storage device on top of a QSPI XIP flash.
+ Any platform that needs to emulate one or multiple QSPI XIP flash devices can turn this
+ option on to enable the functionality. NVMXIP config is selected automatically.
+ Platforms that need to add custom treatments before accessing to the flash, can
+ write their own driver (same as nvmxip_qspi in addition to the custom settings).
+
+Device Tree nodes
+--------------------
+
+Multiple QSPI XIP flash devices can be used at the same time by describing them through DT
+nodes.
+
+Please refer to the documentation of the DT binding at:
+
+doc/device-tree-bindings/nvmxip/nvmxip_qspi.txt
+
+Contributors
+------------
+ * Abdellatif El Khlifi <[email protected]>
diff --git a/doc/develop/event.rst b/doc/develop/event.rst
index 4ff59348371..e60cbf65691 100644
--- a/doc/develop/event.rst
+++ b/doc/develop/event.rst
@@ -12,7 +12,7 @@ Rather than using weak functions and direct calls across subsystemss, it is
often easier to use an event.
An event consists of a type (e.g. EVT_DM_POST_INIT) and some optional data,
-in `union event_data`. An event spy can be creasted to watch for events of a
+in `union event_data`. An event spy can be created to watch for events of a
particular type. When the event is created, it is sent to each spy in turn.
diff --git a/doc/develop/index.rst b/doc/develop/index.rst
index a52ad630d0d..ddbf8dad4a1 100644
--- a/doc/develop/index.rst
+++ b/doc/develop/index.rst
@@ -11,6 +11,7 @@ General
codingstyle
designprinciples
+ docstyle
patman
process
release_cycle
diff --git a/doc/develop/release_cycle.rst b/doc/develop/release_cycle.rst
index ea584cef21a..41d8edecb88 100644
--- a/doc/develop/release_cycle.rst
+++ b/doc/develop/release_cycle.rst
@@ -48,13 +48,13 @@ Examples::
Current Status
--------------
-* U-Boot v2023.01 was released on Mon 09 January 2023.
+* U-Boot v2023.04 was released on Mon 03 April 2023.
-* The Merge Window for the next release (v2023.04) is **closed**.
+* The Merge Window for the next release (v2023.07) is **closed**.
* The next branch is now **open**.
-* Release "v2023.04" is scheduled for 03 April 2023.
+* Release "v2023.07" is scheduled for 03 July 2023.
Future Releases
---------------
@@ -64,27 +64,27 @@ Future Releases
For the next scheduled release, release candidates were made on::
-* U-Boot v2023.04-rc1 was released on Mon 30 January 2023.
+* U-Boot v2023.07-rc1 was released on Mon 01 May 2023.
-* U-Boot v2023.04-rc2 was released on Mon 13 February 2023.
+* U-Boot v2023.07-rc2 was released on Mon 08 May 2023.
-* U-Boot v2023.04-rc3 was released on Mon 27 February 2023.
+.. * U-Boot v2023.07-rc3 was released on Mon 22 May 2023.
-* U-Boot v2023.04-rc4 was released on Mon 13 March 2023.
+.. * U-Boot v2023.07-rc4 was released on Mon 05 June 2023.
-* U-Boot v2023.04-rc5 was released on Mon 27 March 2023.
+.. * U-Boot v2023.07-rc5 was released on Mon 19 June 2023.
Please note that the following dates are planned only and may be deviated from
as needed.
-* "v2023.04": end of MW = Mon, Jan 30, 2022; release = Mon, Apr 03, 2023
-
* "v2023.07": end of MW = Mon, Apr 24, 2023; release = Mon, Jul 03, 2023
* "v2023.10": end of MW = Mon, Jul 24, 2023; release = Mon, Oct 02, 2023
* "v2024.01": end of MW = Mon, Oct 23, 2023; release = Mon, Jan 08, 2024
+* "v2024.04": end of MW = Mon, Jan 29, 2024; release = Tue, Apr 02, 2024
+
Previous Releases
-----------------
@@ -92,6 +92,8 @@ Note: these statistics are generated by our fork of `gitdm
<https://source.denx.de/u-boot/gitdm>`_, which was originally created by
Jonathan Corbet.
+* :doc:`statistics/u-boot-stats-v2023.04` which was released on 03 April 2023.
+
* :doc:`statistics/u-boot-stats-v2023.01` which was released on 09 January 2023.
* :doc:`statistics/u-boot-stats-v2022.10` which was released on 03 October 2022.
diff --git a/doc/develop/statistics/u-boot-stats-v2023.04.rst b/doc/develop/statistics/u-boot-stats-v2023.04.rst
new file mode 100644
index 00000000000..57f2efc30e3
--- /dev/null
+++ b/doc/develop/statistics/u-boot-stats-v2023.04.rst
@@ -0,0 +1,767 @@
+:orphan:
+
+Release Statistics for U-Boot v2023.04
+======================================
+
+* Processed 1691 changesets from 157 developers
+
+* 29 employers found
+
+* A total of 174471 lines added, 78380 removed (delta 96091)
+
+.. table:: Developers with the most changesets
+ :widths: auto
+
+ ==================================== =====
+ Name Count
+ ==================================== =====
+ Simon Glass 381 (22.5%)
+ Tom Rini 333 (19.7%)
+ Marek Vasut 101 (6.0%)
+ Heinrich Schuchardt 70 (4.1%)
+ Jagan Teki 53 (3.1%)
+ Jonas Karlman 36 (2.1%)
+ Patrick Delaunay 35 (2.1%)
+ Hai Pham 21 (1.2%)
+ Michal Simek 20 (1.2%)
+ Maxim Cournoyer 20 (1.2%)
+ Svyatoslav Ryhel 17 (1.0%)
+ Sean Anderson 15 (0.9%)
+ Fabio Estevam 14 (0.8%)
+ Pali Rohár 14 (0.8%)
+ Sumit Garg 14 (0.8%)
+ Bryan Brattlof 14 (0.8%)
+ Sinthu Raja 13 (0.8%)
+ Andre Przywara 13 (0.8%)
+ Heiko Schocher 13 (0.8%)
+ Yu Chien Peter Lin 12 (0.7%)
+ Tim Harvey 12 (0.7%)
+ Peng Fan 12 (0.7%)
+ Tony Dinh 11 (0.7%)
+ Angelo Dureghello 11 (0.7%)
+ Masahisa Kojima 11 (0.7%)
+ Quentin Schulz 11 (0.7%)
+ Roger Quadros 11 (0.7%)
+ Marcel Ziswiler 11 (0.7%)
+ Holger Brunck 10 (0.6%)
+ Mark Kettenis 10 (0.6%)
+ Sergiu Moga 10 (0.6%)
+ Nikhil M Jain 9 (0.5%)
+ Jim Liu 9 (0.5%)
+ Christophe Leroy 9 (0.5%)
+ Balamanikandan Gunasundar 9 (0.5%)
+ Dario Binacchi 8 (0.5%)
+ Samuel Holland 8 (0.5%)
+ Frieder Schrempf 8 (0.5%)
+ Mikhail Ilin 8 (0.5%)
+ Sjoerd Simons 7 (0.4%)
+ Neil Armstrong 7 (0.4%)
+ Eugen Hristev 7 (0.4%)
+ Chris Morgan 7 (0.4%)
+ Dzmitry Sankouski 7 (0.4%)
+ Ioana Ciornei 7 (0.4%)
+ Ilias Apalodimas 6 (0.4%)
+ Peter Robinson 6 (0.4%)
+ Paweł Anikiel 6 (0.4%)
+ Andrejs Cainikovs 6 (0.4%)
+ Rob Herring 6 (0.4%)
+ John Keeping 5 (0.3%)
+ Mihai Sain 5 (0.3%)
+ Rick Chen 5 (0.3%)
+ Sergei Antonov 5 (0.3%)
+ Ashok Reddy Soma 5 (0.3%)
+ Algapally Santosh Sagar 5 (0.3%)
+ Dhruva Gole 5 (0.3%)
+ Brandon Maier 5 (0.3%)
+ Alexey Romanov 5 (0.3%)
+ Vasily Khoruzhick 4 (0.2%)
+ Manoj Sai 4 (0.2%)
+ Jan Kiszka 4 (0.2%)
+ Ovidiu Panait 4 (0.2%)
+ Takahiro Kuwano 4 (0.2%)
+ Enric Balletbo i Serra 4 (0.2%)
+ Fabrice Gasnier 4 (0.2%)
+ Victor Lim 4 (0.2%)
+ Stefan Bosch 4 (0.2%)
+ Vincent Stehlé 3 (0.2%)
+ Tam Nguyen 3 (0.2%)
+ Leo Yu-Chi Liang 3 (0.2%)
+ Mattijs Korpershoek 3 (0.2%)
+ Ye Li 3 (0.2%)
+ Oleksandr Suvorov 3 (0.2%)
+ Max Krummenacher 3 (0.2%)
+ Andrew Davis 3 (0.2%)
+ Michael Walle 3 (0.2%)
+ Andreas Kemnade 3 (0.2%)
+ Kshitiz Varshney 3 (0.2%)
+ Dai Okamura 3 (0.2%)
+ Stefan Roese 2 (0.1%)
+ Vincent Fazio 2 (0.1%)
+ Kamlesh Gurudasani 2 (0.1%)
+ Johan Jonker 2 (0.1%)
+ Antoine Mazeas 2 (0.1%)
+ Christopher Obbard 2 (0.1%)
+ Akash Gajjar 2 (0.1%)
+ Ilko Iliev 2 (0.1%)
+ Qu Wenruo 2 (0.1%)
+ Etienne Carriere 2 (0.1%)
+ Thomas Fitzsimmons 2 (0.1%)
+ Pei Yue Ho 2 (0.1%)
+ Ryan Chen 2 (0.1%)
+ Adam Ford 2 (0.1%)
+ Philippe Schenker 2 (0.1%)
+ Linus Walleij 2 (0.1%)
+ Sean Edmond 2 (0.1%)
+ Nikita Shubin 2 (0.1%)
+ Ying-Chun Liu (PaulLiu) 2 (0.1%)
+ Loic Poulain 2 (0.1%)
+ Pengfei Fan 2 (0.1%)
+ Jernej Skrabec 2 (0.1%)
+ Neha Malcom Francis 2 (0.1%)
+ Harald Seiler 2 (0.1%)
+ Shenlin Liang 2 (0.1%)
+ Martyn Welch 2 (0.1%)
+ Harini Katakam 2 (0.1%)
+ Marc Kleine-Budde 2 (0.1%)
+ David Sebek 1 (0.1%)
+ Jonathan Liu 1 (0.1%)
+ Vignesh Raghavendra 1 (0.1%)
+ Sebastian Andrzej Siewior 1 (0.1%)
+ annsai01 1 (0.1%)
+ Peter Geis 1 (0.1%)
+ Ralph Siemsen 1 (0.1%)
+ Robert Marko 1 (0.1%)
+ Michal Suchanek 1 (0.1%)
+ Jaehoon Chung 1 (0.1%)
+ Christian Kohlschütter 1 (0.1%)
+ Ramin Khonsari 1 (0.1%)
+ Maxim Schwalm 1 (0.1%)
+ Venkatesh Yadav Abbarapu 1 (0.1%)
+ Ivan Khoronzhuk 1 (0.1%)
+ Ulf Samuelsson 1 (0.1%)
+ Jade Lovelace 1 (0.1%)
+ Michael Trimarchi 1 (0.1%)
+ Matwey V. Kornilov 1 (0.1%)
+ KaDiWa 1 (0.1%)
+ Christian Marangi 1 (0.1%)
+ Ehsan Mohandesi 1 (0.1%)
+ Aurelien Jarno 1 (0.1%)
+ Mario Kicherer 1 (0.1%)
+ Arnaud Ferraris 1 (0.1%)
+ Detlev Casanova 1 (0.1%)
+ Igor Opaniuk 1 (0.1%)
+ Massimo Pegorer 1 (0.1%)
+ Kunihiko Hayashi 1 (0.1%)
+ Joost van Zwieten 1 (0.1%)
+ Jorge Ramirez-Ortiz 1 (0.1%)
+ Jay Buddhabhatti 1 (0.1%)
+ Andrey Dolnikov 1 (0.1%)
+ chenzhipeng 1 (0.1%)
+ Olivier Moysan 1 (0.1%)
+ Ville Skyttä 1 (0.1%)
+ David Oberhollenzer 1 (0.1%)
+ Haijun Qin 1 (0.1%)
+ Neal Frager 1 (0.1%)
+ Luca Ceresoli 1 (0.1%)
+ Viacheslav Bocharov 1 (0.1%)
+ Yuepeng Xing 1 (0.1%)
+ Cristian Birsan 1 (0.1%)
+ Lokanathan, Raaj 1 (0.1%)
+ Christian Gmeiner 1 (0.1%)
+ Daniel Golle 1 (0.1%)
+ Manuel Traut 1 (0.1%)
+ Ben Dooks 1 (0.1%)
+ Kasper Revsbech 1 (0.1%)
+ ==================================== =====
+
+
+.. table:: Developers with the most changed lines
+ :widths: auto
+
+ ==================================== =====
+ Name Count
+ ==================================== =====
+ Bryan Brattlof 38811 (18.1%)
+ Tom Rini 36464 (17.0%)
+ Simon Glass 30090 (14.0%)
+ Jagan Teki 23918 (11.1%)
+ Marek Vasut 14720 (6.9%)
+ Brandon Maier 13759 (6.4%)
+ Tony Dinh 7399 (3.4%)
+ Balamanikandan Gunasundar 4239 (2.0%)
+ Jim Liu 4106 (1.9%)
+ Fabio Estevam 3264 (1.5%)
+ Christophe Leroy 2145 (1.0%)
+ Neil Armstrong 2020 (0.9%)
+ Nikhil M Jain 1681 (0.8%)
+ Sumit Garg 1671 (0.8%)
+ Tim Harvey 1524 (0.7%)
+ Jonas Karlman 1439 (0.7%)
+ Roger Quadros 1431 (0.7%)
+ Quentin Schulz 1296 (0.6%)
+ Heinrich Schuchardt 1277 (0.6%)
+ Michal Simek 1274 (0.6%)
+ Svyatoslav Ryhel 1259 (0.6%)
+ Akash Gajjar 1057 (0.5%)
+ Mark Kettenis 1042 (0.5%)
+ Sinthu Raja 967 (0.5%)
+ Holger Brunck 966 (0.5%)
+ Chris Morgan 965 (0.4%)
+ Peter Robinson 919 (0.4%)
+ Luca Ceresoli 860 (0.4%)
+ Hai Pham 712 (0.3%)
+ Andre Przywara 702 (0.3%)
+ Kunihiko Hayashi 695 (0.3%)
+ Dario Binacchi 690 (0.3%)
+ Patrick Delaunay 668 (0.3%)
+ Samuel Holland 568 (0.3%)
+ Dhruva Gole 527 (0.2%)
+ Ryan Chen 504 (0.2%)
+ Sergei Antonov 464 (0.2%)
+ Sean Anderson 439 (0.2%)
+ Ashok Reddy Soma 399 (0.2%)
+ Masahisa Kojima 391 (0.2%)
+ Sergiu Moga 382 (0.2%)
+ Maxim Cournoyer 380 (0.2%)
+ Massimo Pegorer 353 (0.2%)
+ Linus Walleij 317 (0.1%)
+ Eugen Hristev 295 (0.1%)
+ Alexey Romanov 285 (0.1%)
+ Yu Chien Peter Lin 267 (0.1%)
+ Stefan Bosch 260 (0.1%)
+ Dzmitry Sankouski 257 (0.1%)
+ Heiko Schocher 221 (0.1%)
+ Enric Balletbo i Serra 214 (0.1%)
+ Kshitiz Varshney 211 (0.1%)
+ Thomas Fitzsimmons 205 (0.1%)
+ Mihai Sain 191 (0.1%)
+ Angelo Dureghello 167 (0.1%)
+ Adam Ford 162 (0.1%)
+ Marcel Ziswiler 160 (0.1%)
+ Mattijs Korpershoek 154 (0.1%)
+ Etienne Carriere 154 (0.1%)
+ Leo Yu-Chi Liang 135 (0.1%)
+ Ramin Khonsari 131 (0.1%)
+ Pali Rohár 127 (0.1%)
+ Olivier Moysan 116 (0.1%)
+ Vincent Fazio 106 (0.0%)
+ Fabrice Gasnier 98 (0.0%)
+ Max Krummenacher 80 (0.0%)
+ Takahiro Kuwano 76 (0.0%)
+ Victor Lim 73 (0.0%)
+ Frieder Schrempf 72 (0.0%)
+ Manoj Sai 70 (0.0%)
+ Andrew Davis 70 (0.0%)
+ Mikhail Ilin 69 (0.0%)
+ Dai Okamura 65 (0.0%)
+ Tam Nguyen 63 (0.0%)
+ Peng Fan 61 (0.0%)
+ Sjoerd Simons 61 (0.0%)
+ Cristian Birsan 59 (0.0%)
+ Antoine Mazeas 51 (0.0%)
+ Rick Chen 49 (0.0%)
+ Paweł Anikiel 47 (0.0%)
+ Andreas Kemnade 45 (0.0%)
+ Jan Kiszka 43 (0.0%)
+ Andrejs Cainikovs 41 (0.0%)
+ Michael Trimarchi 41 (0.0%)
+ Rob Herring 40 (0.0%)
+ Martyn Welch 36 (0.0%)
+ Stefan Roese 35 (0.0%)
+ Neha Malcom Francis 35 (0.0%)
+ Algapally Santosh Sagar 34 (0.0%)
+ Jernej Skrabec 34 (0.0%)
+ Maxim Schwalm 30 (0.0%)
+ Qu Wenruo 29 (0.0%)
+ Loic Poulain 29 (0.0%)
+ Ioana Ciornei 28 (0.0%)
+ Christian Kohlschütter 28 (0.0%)
+ Michael Walle 23 (0.0%)
+ Vasily Khoruzhick 22 (0.0%)
+ Pei Yue Ho 22 (0.0%)
+ Vincent Stehlé 19 (0.0%)
+ Venkatesh Yadav Abbarapu 19 (0.0%)
+ Pengfei Fan 16 (0.0%)
+ Harald Seiler 16 (0.0%)
+ Ville Skyttä 16 (0.0%)
+ Sean Edmond 14 (0.0%)
+ Harini Katakam 14 (0.0%)
+ Robert Marko 14 (0.0%)
+ John Keeping 13 (0.0%)
+ Ovidiu Panait 13 (0.0%)
+ Kamlesh Gurudasani 13 (0.0%)
+ Nikita Shubin 13 (0.0%)
+ Marc Kleine-Budde 13 (0.0%)
+ Detlev Casanova 13 (0.0%)
+ David Oberhollenzer 11 (0.0%)
+ Ilias Apalodimas 10 (0.0%)
+ Mario Kicherer 10 (0.0%)
+ Yuepeng Xing 10 (0.0%)
+ Jaehoon Chung 9 (0.0%)
+ KaDiWa 9 (0.0%)
+ Oleksandr Suvorov 8 (0.0%)
+ Christian Gmeiner 8 (0.0%)
+ Ye Li 7 (0.0%)
+ Christopher Obbard 7 (0.0%)
+ Ying-Chun Liu (PaulLiu) 7 (0.0%)
+ Johan Jonker 6 (0.0%)
+ Jonathan Liu 6 (0.0%)
+ Andrey Dolnikov 6 (0.0%)
+ Daniel Golle 6 (0.0%)
+ Philippe Schenker 5 (0.0%)
+ Michal Suchanek 5 (0.0%)
+ Ivan Khoronzhuk 5 (0.0%)
+ Ilko Iliev 4 (0.0%)
+ Manuel Traut 4 (0.0%)
+ Shenlin Liang 3 (0.0%)
+ annsai01 3 (0.0%)
+ Ulf Samuelsson 3 (0.0%)
+ Matwey V. Kornilov 3 (0.0%)
+ Jay Buddhabhatti 3 (0.0%)
+ chenzhipeng 3 (0.0%)
+ Ben Dooks 3 (0.0%)
+ Peter Geis 2 (0.0%)
+ Ralph Siemsen 2 (0.0%)
+ Christian Marangi 2 (0.0%)
+ Jorge Ramirez-Ortiz 2 (0.0%)
+ David Sebek 1 (0.0%)
+ Vignesh Raghavendra 1 (0.0%)
+ Sebastian Andrzej Siewior 1 (0.0%)
+ Jade Lovelace 1 (0.0%)
+ Ehsan Mohandesi 1 (0.0%)
+ Aurelien Jarno 1 (0.0%)
+ Arnaud Ferraris 1 (0.0%)
+ Igor Opaniuk 1 (0.0%)
+ Joost van Zwieten 1 (0.0%)
+ Haijun Qin 1 (0.0%)
+ Neal Frager 1 (0.0%)
+ Viacheslav Bocharov 1 (0.0%)
+ Lokanathan, Raaj 1 (0.0%)
+ Kasper Revsbech 1 (0.0%)
+ ==================================== =====
+
+
+.. table:: Developers with the most lines removed
+ :widths: auto
+
+ ==================================== =====
+ Name Count
+ ==================================== =====
+ Tom Rini 18089 (23.1%)
+ Simon Glass 5998 (7.7%)
+ Luca Ceresoli 860 (1.1%)
+ Holger Brunck 532 (0.7%)
+ Leo Yu-Chi Liang 90 (0.1%)
+ Mattijs Korpershoek 83 (0.1%)
+ Andrew Davis 43 (0.1%)
+ Pali Rohár 28 (0.0%)
+ Maxim Schwalm 27 (0.0%)
+ Dai Okamura 12 (0.0%)
+ Michael Walle 12 (0.0%)
+ Ovidiu Panait 10 (0.0%)
+ Peng Fan 7 (0.0%)
+ Ioana Ciornei 6 (0.0%)
+ Michal Suchanek 4 (0.0%)
+ Rob Herring 3 (0.0%)
+ Johan Jonker 3 (0.0%)
+ Ying-Chun Liu (PaulLiu) 2 (0.0%)
+ Ilko Iliev 1 (0.0%)
+ ==================================== =====
+
+
+.. table:: Developers with the most signoffs (total 215)
+ :widths: auto
+
+ ==================================== =====
+ Name Count
+ ==================================== =====
+ Francesco Dolcini 21 (9.8%)
+ Marek Vasut 21 (9.8%)
+ Tom 19 (8.8%)
+ Michal Simek 19 (8.8%)
+ Michael Trimarchi 8 (3.7%)
+ Dario Binacchi 8 (3.7%)
+ Neil Armstrong 8 (3.7%)
+ Hai Pham 7 (3.3%)
+ Kever Yang 6 (2.8%)
+ Tom Rini 5 (2.3%)
+ YouMin Chen 5 (2.3%)
+ Jianqun Xu 4 (1.9%)
+ Elaine Zhang 4 (1.9%)
+ Mike Worsfold 4 (1.9%)
+ Manoj Sai 4 (1.9%)
+ Marcel Ziswiler 4 (1.9%)
+ Ashok Reddy Soma 4 (1.9%)
+ Peter Robinson 4 (1.9%)
+ Peng Fan 3 (1.4%)
+ Andre Przywara 3 (1.4%)
+ Heinrich Schuchardt 3 (1.4%)
+ Vignesh Raghavendra 2 (0.9%)
+ Joseph Chen 2 (0.9%)
+ Finley Xiao 2 (0.9%)
+ Suniel Mahesh 2 (0.9%)
+ FUKAUMI Naoki 2 (0.9%)
+ Judith Mendez 2 (0.9%)
+ Robert Hancock 2 (0.9%)
+ Peter Geis 2 (0.9%)
+ Andrejs Cainikovs 2 (0.9%)
+ Samuel Holland 2 (0.9%)
+ Jonas Karlman 2 (0.9%)
+ Jagan Teki 2 (0.9%)
+ Simon Glass 1 (0.5%)
+ Mattijs Korpershoek 1 (0.5%)
+ Pali Rohár 1 (0.5%)
+ Michal Suchanek 1 (0.5%)
+ Anand Gadiyar 1 (0.5%)
+ Angelo Durgehello 1 (0.5%)
+ Nam Nguyen 1 (0.5%)
+ Steven Liu 1 (0.5%)
+ Sebastian Reichel 1 (0.5%)
+ Yifeng Zhao 1 (0.5%)
+ Ren Jianing 1 (0.5%)
+ Vladimir Oltean 1 (0.5%)
+ Jonas Schwöbel 1 (0.5%)
+ Shawn Guo 1 (0.5%)
+ Jason Zhu 1 (0.5%)
+ Jon Lin 1 (0.5%)
+ Sugar Zhang 1 (0.5%)
+ Valentine Barshak 1 (0.5%)
+ Jit Loon Lim 1 (0.5%)
+ Philippe Schenker 1 (0.5%)
+ Ilias Apalodimas 1 (0.5%)
+ Sjoerd Simons 1 (0.5%)
+ Tam Nguyen 1 (0.5%)
+ Ramin Khonsari 1 (0.5%)
+ Sergiu Moga 1 (0.5%)
+ Svyatoslav Ryhel 1 (0.5%)
+ Quentin Schulz 1 (0.5%)
+ ==================================== =====
+
+
+.. table:: Developers with the most reviews (total 767)
+ :widths: auto
+
+ ==================================== =====
+ Name Count
+ ==================================== =====
+ Simon Glass 225 (29.3%)
+ Kever Yang 112 (14.6%)
+ Fabio Estevam 49 (6.4%)
+ Tom Rini 33 (4.3%)
+ Patrice Chotard 33 (4.3%)
+ Marek Vasut 27 (3.5%)
+ Ramon Fried 22 (2.9%)
+ Stefan Roese 17 (2.2%)
+ Ilias Apalodimas 16 (2.1%)
+ Leo Yu-Chi Liang 15 (2.0%)
+ Rick Chen 15 (2.0%)
+ Heinrich Schuchardt 14 (1.8%)
+ Jagan Teki 14 (1.8%)
+ Patrick Delaunay 14 (1.8%)
+ Mattijs Korpershoek 13 (1.7%)
+ Jaehoon Chung 13 (1.7%)
+ Samuel Holland 12 (1.6%)
+ Heiko Schocher 9 (1.2%)
+ Neil Armstrong 8 (1.0%)
+ Vladimir Oltean 7 (0.9%)
+ Sean Anderson 7 (0.9%)
+ Bin Meng 6 (0.8%)
+ FRANJOU Stephane 6 (0.8%)
+ Claudiu Beznea 6 (0.8%)
+ Michael Trimarchi 5 (0.7%)
+ Peng Fan 5 (0.7%)
+ Jens Wiklander 5 (0.7%)
+ Yu Chien Peter Lin 4 (0.5%)
+ Andre Przywara 3 (0.4%)
+ Pali Rohár 3 (0.4%)
+ Viacheslav Mitrofanov 3 (0.4%)
+ Ye Li 3 (0.4%)
+ Dhruva Gole 3 (0.4%)
+ Marcel Ziswiler 2 (0.3%)
+ Oleksandr Suvorov 2 (0.3%)
+ Wei Liang Lim 2 (0.3%)
+ Eng Lee Teh 2 (0.3%)
+ Minkyu Kang 2 (0.3%)
+ Tudor Ambarus 2 (0.3%)
+ Philipp Tomsich 2 (0.3%)
+ Etienne Carriere 2 (0.3%)
+ Masahisa Kojima 2 (0.3%)
+ Eugen Hristev 2 (0.3%)
+ Francesco Dolcini 1 (0.1%)
+ Michal Simek 1 (0.1%)
+ Jonas Karlman 1 (0.1%)
+ Nishanth Menon 1 (0.1%)
+ Siddharth Vadapalli 1 (0.1%)
+ Matthias Brugger 1 (0.1%)
+ Chia-Wei Wang 1 (0.1%)
+ Huang Jianan 1 (0.1%)
+ Oliver Graute 1 (0.1%)
+ Pratyush Yadav 1 (0.1%)
+ Soeren Moch 1 (0.1%)
+ Sunil V L 1 (0.1%)
+ Miquel Raynal 1 (0.1%)
+ Hector Palacios 1 (0.1%)
+ Derald Woods 1 (0.1%)
+ Nick Desaulniers 1 (0.1%)
+ Frieder Schrempf 1 (0.1%)
+ Adam Ford 1 (0.1%)
+ Sumit Garg 1 (0.1%)
+ Christophe Leroy 1 (0.1%)
+ ==================================== =====
+
+
+.. table:: Developers with the most test credits (total 78)
+ :widths: auto
+
+ ==================================== =====
+ Name Count
+ ==================================== =====
+ Svyatoslav Ryhel 12 (15.4%)
+ Andreas Westman Dorcsak 11 (14.1%)
+ Thierry Reding 9 (11.5%)
+ Robert Eckelmann 8 (10.3%)
+ Samuel Holland 6 (7.7%)
+ Vagrant Cascadian 3 (3.8%)
+ Jagan Teki 2 (2.6%)
+ Eugen Hristev 2 (2.6%)
+ Jonas Schwöbel 2 (2.6%)
+ Quentin Schulz 2 (2.6%)
+ Agneli 2 (2.6%)
+ Lothar Waßmann 2 (2.6%)
+ Simon Glass 1 (1.3%)
+ Fabio Estevam 1 (1.3%)
+ Ilias Apalodimas 1 (1.3%)
+ Rick Chen 1 (1.3%)
+ Patrick Delaunay 1 (1.3%)
+ Mattijs Korpershoek 1 (1.3%)
+ Andre Przywara 1 (1.3%)
+ Dhruva Gole 1 (1.3%)
+ Jonas Karlman 1 (1.3%)
+ Suniel Mahesh 1 (1.3%)
+ Sjoerd Simons 1 (1.3%)
+ Matwey V. Kornilov 1 (1.3%)
+ Anand Moon 1 (1.3%)
+ Vaishnav Achath 1 (1.3%)
+ Karsten Merker 1 (1.3%)
+ Sean Nyekjaer 1 (1.3%)
+ Mihai Sain 1 (1.3%)
+ ==================================== =====
+
+
+.. table:: Developers who gave the most tested-by credits (total 78)
+ :widths: auto
+
+ ==================================== =====
+ Name Count
+ ==================================== =====
+ Svyatoslav Ryhel 41 (52.6%)
+ Andre Przywara 6 (7.7%)
+ Tom Rini 5 (6.4%)
+ Simon Glass 4 (5.1%)
+ Jonas Karlman 3 (3.8%)
+ Loic Poulain 3 (3.8%)
+ Ramin Khonsari 2 (2.6%)
+ Jagan Teki 1 (1.3%)
+ Patrick Delaunay 1 (1.3%)
+ Dhruva Gole 1 (1.3%)
+ Sjoerd Simons 1 (1.3%)
+ Michael Trimarchi 1 (1.3%)
+ Etienne Carriere 1 (1.3%)
+ Peter Geis 1 (1.3%)
+ Sergiu Moga 1 (1.3%)
+ Maxim Schwalm 1 (1.3%)
+ Kasper Revsbech 1 (1.3%)
+ Neha Malcom Francis 1 (1.3%)
+ Fabrice Gasnier 1 (1.3%)
+ Maxim Cournoyer 1 (1.3%)
+ Sergei Antonov 1 (1.3%)
+ ==================================== =====
+
+
+.. table:: Developers with the most report credits (total 22)
+ :widths: auto
+
+ ==================================== =====
+ Name Count
+ ==================================== =====
+ Heinrich Schuchardt 3 (13.6%)
+ Ilias Apalodimas 2 (9.1%)
+ Patrick Delaunay 1 (4.5%)
+ Sjoerd Simons 1 (4.5%)
+ Samuel Holland 1 (4.5%)
+ Quentin Schulz 1 (4.5%)
+ Karsten Merker 1 (4.5%)
+ Marek Vasut 1 (4.5%)
+ Francesco Dolcini 1 (4.5%)
+ Nishanth Menon 1 (4.5%)
+ Oliver Graute 1 (4.5%)
+ Anand Gadiyar 1 (4.5%)
+ Philippe Schenker 1 (4.5%)
+ Andreas Schwab 1 (4.5%)
+ Stefan Herbrechtsmeier 1 (4.5%)
+ Carlos Rafael Giani 1 (4.5%)
+ Dave Jones 1 (4.5%)
+ Serge Bazanski 1 (4.5%)
+ Sam Winchenbach 1 (4.5%)
+ ==================================== =====
+
+
+.. table:: Developers who gave the most report credits (total 22)
+ :widths: auto
+
+ ==================================== =====
+ Name Count
+ ==================================== =====
+ Simon Glass 6 (27.3%)
+ Tom Rini 5 (22.7%)
+ Heinrich Schuchardt 3 (13.6%)
+ Qu Wenruo 2 (9.1%)
+ Ilias Apalodimas 1 (4.5%)
+ Maxim Cournoyer 1 (4.5%)
+ Fabio Estevam 1 (4.5%)
+ Vignesh Raghavendra 1 (4.5%)
+ Harald Seiler 1 (4.5%)
+ Sinthu Raja 1 (4.5%)
+ ==================================== =====
+
+
+.. table:: Top changeset contributors by employer
+ :widths: auto
+
+ ==================================== =====
+ Name Count
+ ==================================== =====
+ (Unknown) 524 (31.0%)
+ Google, Inc. 381 (22.5%)
+ Konsulko Group 333 (19.7%)
+ DENX Software Engineering 72 (4.3%)
+ Texas Instruments 49 (2.9%)
+ Linaro 47 (2.8%)
+ Edgeble AI Technologies Pvt. Ltd. 46 (2.7%)
+ ST Microelectronics 40 (2.4%)
+ AMD 34 (2.0%)
+ NXP 25 (1.5%)
+ Renesas Electronics 24 (1.4%)
+ Toradex 24 (1.4%)
+ Amarula Solutions 20 (1.2%)
+ Collabora Ltd. 20 (1.2%)
+ ARM 17 (1.0%)
+ Semihalf Embedded Systems 6 (0.4%)
+ Red Hat 4 (0.2%)
+ Siemens 4 (0.2%)
+ Socionext Inc. 4 (0.2%)
+ BayLibre SAS 3 (0.2%)
+ SUSE 3 (0.2%)
+ Pengutronix 2 (0.1%)
+ Ronetix 2 (0.1%)
+ Extreme Engineering Solutions 2 (0.1%)
+ Bootlin 1 (0.1%)
+ Intel 1 (0.1%)
+ linutronix 1 (0.1%)
+ Samsung 1 (0.1%)
+ Xilinx 1 (0.1%)
+ ==================================== =====
+
+
+.. table:: Top lines changed by employer
+ :widths: auto
+
+ ==================================== =====
+ Name Count
+ ==================================== =====
+ (Unknown) 64681 (30.1%)
+ Texas Instruments 42105 (19.6%)
+ Konsulko Group 36464 (17.0%)
+ Google, Inc. 30090 (14.0%)
+ Edgeble AI Technologies Pvt. Ltd. 23070 (10.7%)
+ Linaro 4601 (2.1%)
+ DENX Software Engineering 4582 (2.1%)
+ AMD 1741 (0.8%)
+ Amarula Solutions 1649 (0.8%)
+ ST Microelectronics 882 (0.4%)
+ Bootlin 860 (0.4%)
+ Renesas Electronics 775 (0.4%)
+ Socionext Inc. 760 (0.4%)
+ ARM 724 (0.3%)
+ Collabora Ltd. 413 (0.2%)
+ NXP 307 (0.1%)
+ Toradex 290 (0.1%)
+ Red Hat 214 (0.1%)
+ BayLibre SAS 154 (0.1%)
+ Extreme Engineering Solutions 106 (0.0%)
+ Semihalf Embedded Systems 47 (0.0%)
+ Siemens 43 (0.0%)
+ SUSE 34 (0.0%)
+ Pengutronix 13 (0.0%)
+ Samsung 9 (0.0%)
+ Ronetix 4 (0.0%)
+ Xilinx 3 (0.0%)
+ Intel 1 (0.0%)
+ linutronix 1 (0.0%)
+ ==================================== =====
+
+
+.. table:: Employers with the most signoffs (total 215)
+ :widths: auto
+
+ ==================================== =====
+ Name Count
+ ==================================== =====
+ (Unknown) 48 (22.3%)
+ Rockchip 29 (13.5%)
+ Toradex 28 (13.0%)
+ Amarula Solutions 24 (11.2%)
+ AMD 23 (10.7%)
+ NVidia 19 (8.8%)
+ Linaro 9 (4.2%)
+ Renesas Electronics 9 (4.2%)
+ Texas Instruments 5 (2.3%)
+ Konsulko Group 5 (2.3%)
+ NXP 4 (1.9%)
+ ARM 3 (1.4%)
+ Canonical 3 (1.4%)
+ Collabora Ltd. 2 (0.9%)
+ Google, Inc. 1 (0.5%)
+ BayLibre SAS 1 (0.5%)
+ SUSE 1 (0.5%)
+ Intel 1 (0.5%)
+ ==================================== =====
+
+
+.. table:: Employers with the most hackers (total 160)
+ :widths: auto
+
+ ==================================== =====
+ Name Count
+ ==================================== =====
+ (Unknown) 86 (53.8%)
+ Linaro 9 (5.6%)
+ Texas Instruments 8 (5.0%)
+ AMD 6 (3.8%)
+ Collabora Ltd. 6 (3.8%)
+ Toradex 5 (3.1%)
+ DENX Software Engineering 5 (3.1%)
+ Amarula Solutions 4 (2.5%)
+ NXP 4 (2.5%)
+ ARM 3 (1.9%)
+ ST Microelectronics 3 (1.9%)
+ Renesas Electronics 2 (1.2%)
+ SUSE 2 (1.2%)
+ Socionext Inc. 2 (1.2%)
+ Konsulko Group 1 (0.6%)
+ Google, Inc. 1 (0.6%)
+ BayLibre SAS 1 (0.6%)
+ Intel 1 (0.6%)
+ Edgeble AI Technologies Pvt. Ltd. 1 (0.6%)
+ Bootlin 1 (0.6%)
+ Red Hat 1 (0.6%)
+ Extreme Engineering Solutions 1 (0.6%)
+ Semihalf Embedded Systems 1 (0.6%)
+ Siemens 1 (0.6%)
+ Pengutronix 1 (0.6%)
+ Samsung 1 (0.6%)
+ Ronetix 1 (0.6%)
+ Xilinx 1 (0.6%)
+ linutronix 1 (0.6%)
+ ==================================== =====
+
diff --git a/doc/develop/trace.rst b/doc/develop/trace.rst
index 8425d843e9c..9bbe1345d2d 100644
--- a/doc/develop/trace.rst
+++ b/doc/develop/trace.rst
@@ -100,7 +100,7 @@ Then run proftool to convert the trace information to ftrace format
.. code-block:: console
- $ ./sandbox/tools/proftool -m sandbox/System.map -t trace dump-ftrace >trace.dat
+ $ ./sandbox/tools/proftool -m sandbox/System.map -t trace dump-ftrace -o trace.dat
Finally run kernelshark to display it (note it only works with `.dat` files!):