summaryrefslogtreecommitdiffstats
path: root/doc/usage
Commit message (Collapse)AuthorAgeFilesLines
* doc: usage: man-page for ums commandPatrick Delaunay2021-06-092-0/+58
| | | | | | | Provide a man-page for the ums command - USB Mass Storage. Signed-off-by: Patrick Delaunay <patrick.delaunay@foss.st.com> Reviewed-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
* doc: usage: man-page for pinmux commandPatrick Delaunay2021-06-092-0/+96
| | | | | | | Provide a man-page for the pinmux command. Signed-off-by: Patrick Delaunay <patrick.delaunay@foss.st.com> Reviewed-by: Patrice Chotard <patrice.chotard@foss.st.com>
* doc: usage: reorder commands in index.rstPatrick Delaunay2021-06-091-3/+3
| | | | | | | | Reorder alphabetically the command in the index of usage in U-Boot documentation. Signed-off-by: Patrick Delaunay <patrick.delaunay@foss.st.com> Reviewed-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
* doc: usage: modify mmc man-pageJaehoon Chung2021-05-251-1/+2
| | | | | | | | | Modify mmc man-page. - Change a description about mmc erase command. - Add whitespace to distinguish. Signed-off-by: Jaehoon Chung <jh80.chung@samsung.com> Reviewed-by: Bin Meng <bmeng.cn@gmail.com>
* doc: extension.rst missing in doc/usage/index.rstHeinrich Schuchardt2021-05-181-0/+1
| | | | | | | | | | | | 'make htmldocs' results in a build warning checking consistency... doc/usage/extension.rst: WARNING: document isn't included in any toctree Add the document to the index. Fixes: 2f84e9cf06d3 ("cmd: add support for a new "extension" command") Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
* doc: man-page for size commandHeinrich Schuchardt2021-05-182-0/+41
| | | | | | Provide a man-page for the size command. Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
* cmd: add support for a new "extension" commandKory Maincent2021-05-131-0/+111
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This patch adds a new "extension" command, which aims at detecting extension boards connected to the hardware platform, and apply the Device Tree overlays that describe the hardware present on those extension boards. In order to enable this mechanism, board-specific code must implement the extension_board_scan() function that fills in a linked list of "struct extension", each describing one extension board. In addition, the board-specific code must select the SUPPORT_EXTENSION_SCAN Kconfig boolean. Based on this: - "extension scan" makes the generic code call the board-specific extension_board_scan() function to retrieve the list of detected extension boards. - "extension list" allows to list the detected extension boards. - "extension apply <number>|all" allows to apply the Device Tree overlay(s) corresponding to one, or all, extension boards The latter requires two environment variables to exist and set one variable to run: - extension_overlay_addr: the RAM address where to load the Device Tree overlays - extension_overlay_cmd: the U-Boot command to load one overlay. Indeed, the location and mechanism to load DT overlays is very setup specific. - extension_overlay_name: set by the command: the name of the DT which will be load during the execution. When calling the command described in the extension_overlay_cmd variable, the variable extension_overlay_name will be defined. So a typical extension_overlay_cmd will look like this: extension_overlay_cmd=load mmc 0:1 $extension_overlay_addr /boot/$extension_overlay_name Here is an example on how to use it: => run loadfdt => fdt addr $fdtaddr => setenv extension_overlay_addr 0x1000 => setenv extension_overlay_cmd 'load mmc 0:1 ${extension_overlay_addr} /boot/${extension_overlay_name}' => extension scan Found 1 extension board(s). => extension apply 0 519 bytes read in 3 ms (168.9 KiB/s) Signed-off-by: Kory Maincent <kory.maincent@bootlin.com> Reviewed-by: Maxime Ripard <maxime@cerno.tech>
* cmd/exception: support ebreak exception on RISC-VHeinrich Schuchardt2021-05-051-0/+3
| | | | | | | | The ebreak instruction should generate a breakpoint exception. Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de> Reviewed-by: Bin Meng <bmeng.cn@gmail.com> Reviewed-by: Rick Chen <rick@andestech.com>
* doc: fatinfo man-pageHeinrich Schuchardt2021-04-241-0/+51
| | | | | | | | | Provide a man-page for the fatinfo command. The .rst file was lost in patch 15d9694600fe ("doc: fatinfo man-page"). Fixes: 15d9694600fe ("doc: fatinfo man-page") Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
* doc: usage: add usage details for reset cmdIgor Opaniuk2021-04-202-0/+27
| | | | | | Add usage details for reset command. Signed-off-by: Igor Opaniuk <igor.opaniuk@foundries.io>
* doc: fatinfo man-pageHeinrich Schuchardt2021-04-171-0/+1
| | | | | | Provide a man-page for the fatinfo command. Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
* doc: mmc man-pageJaehoon Chung2021-04-102-0/+213
| | | | | | Provide a man-pages for the mmc command. Signed-off-by: Jaehoon Chung <jh80.chung@samsung.com>
* Merge tag 'v2021.04-rc5' into nextTom Rini2021-03-292-0/+405
|\ | | | | | | Prepare v2021.04-rc5
| * doc: move README.dfu to HTML documentationHeinrich Schuchardt2021-03-162-0/+405
| | | | | | | | | | | | | | | | | | | | Move README.dfu to doc/usage/dfu.rst and convert to reStructured text. In the long run this page should be split into two. One for the overview and one for the dfu command. UEFI capsule updates and dfutftp should be integrated into the overview page. Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
* | x86: Add a command to display coreboot sysinfoSimon Glass2021-03-272-0/+26
| | | | | | | | | | | | | | | | This information is interesting to look at and can be important for debugging and inspection. Add a command to display it in a helpful format. Signed-off-by: Simon Glass <sjg@chromium.org>
* | binman: doc: Add documentation to htmldocsSimon Glass2021-03-262-0/+9
| | | | | | | | | | | | | | | | Add a link to binman's documentation and adjust the files so that it is accessible. Use the name README.rst so it is easy to discover when binman is installed without U-Boot. Signed-off-by: Simon Glass <sjg@chromium.org>
* | Merge tag 'v2021.04-rc4' into nextTom Rini2021-03-152-0/+42
|\| | | | | | | Prepare v2021.04-rc4
| * cmd: Add a command to display the address mapBin Meng2021-03-052-0/+42
| | | | | | | | | | | | | | | | | | This adds a new command 'addrmap' to display the address map for non-identity virtual-physical memory mappings. Signed-off-by: Bin Meng <bmeng.cn@gmail.com> Reviewed-by: Simon Glass <sjg@chromium.org> Reviewed-by: Priyanka Jain <priyanka.jain@nxp.com>
* | doc: describe the scp03 commandJorge Ramirez-Ortiz2021-03-142-0/+34
| | | | | | | | | | | | | | | | | | The Secure Channel Protocol 03 command sends control requests (enable/provision) to the TEE implementing the protocol between the processor and the secure element. Signed-off-by: Jorge Ramirez-Ortiz <jorge@foundries.io> Reviewed-by: Simon Glass <sjg@chromium.org>
* | doc: Add a note about producing 'md.b' output using hexdumpSimon Glass2021-03-021-0/+10
| | | | | | | | | | | | | | | | | | | | | | | | Comparing a hex dump on the U-Boot command line with the contents of a file on the host system is fairly easy and convenient to do manually if it is small. But the format used hexdump by default differs from that shown by U-Boot. Add a note about how to make them the same. (For large dumps, writing the data to the network with tftpput, or to a USB stick with ext4save is easiest.) Signed-off-by: Simon Glass <sjg@chromium.org>
* | doc: describe the md commandSimon Glass2021-03-022-0/+97
|/ | | | | | Provide a man-page for the md command. Signed-off-by: Simon Glass <sjg@chromium.org>
* doc: Document partition specificationsSean Anderson2021-02-262-0/+81
| | | | | | | | | This documents the way U-Boot understands partitions specifications. This also updates the fastboot documentation for the changes in the previous commit. Signed-off-by: Sean Anderson <sean.anderson@seco.com> Reviewed-by: Simon Glass <sjg@chromium.org>
* doc: qfw man-pageHeinrich Schuchardt2021-02-212-0/+90
| | | | | | Provide a man-page for the qfw command. Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
* doc: booti man-pageHeinrich Schuchardt2021-02-212-0/+115
| | | | | | | Provide a man-page for the booti command. Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de> Reviewed-by: Simon Glass <sjg@chromium.org>
* doc: return value exception commandHeinrich Schuchardt2021-02-041-5/+0
| | | | | | | | | If the exception cannot be raised, the command returns. Currently the return values are not all the same. Remove the sub-chapter 'Return value' Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
* doc: describe load commandHeinrich Schuchardt2021-02-042-0/+75
| | | | | | | Man-page for load command. Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de> Reviewed-by: Simon Glass <sjg@chromium.org>
* doc: exception commandHeinrich Schuchardt2021-01-272-0/+69
| | | | | | Create man-page for exception command. Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
* doc: describe command conitraceHeinrich Schuchardt2021-01-252-0/+55
| | | | | | Provide a man-page for the conitrace command. Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
* doc: describe the false commandHeinrich Schuchardt2021-01-252-0/+29
| | | | | | Provide a man-page for the false command. Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
* doc: document true commandHeinrich Schuchardt2021-01-252-0/+29
| | | | | | Create a man-page for the true command. Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
* doc: describe loady commandHeinrich Schuchardt2021-01-252-0/+68
| | | | | | Create a man-page for the loady command. Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
* doc: document echo commandHeinrich Schuchardt2021-01-252-0/+66
| | | | | | | Provide a man-page for the echo command. Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de> Reviewed-by: Simon Glass <sjg@chromium.org>
* doc: document for statementHeinrich Schuchardt2021-01-252-0/+66
| | | | | | Create a man-page for the for statement. Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
* doc: describe exit commandHeinrich Schuchardt2021-01-252-0/+41
| | | | | | Man-page for exit shell command. Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
* doc: document sbi commandHeinrich Schuchardt2021-01-252-0/+50
| | | | | | Add a man-page for the sbi command. Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
* Merge tag 'doc-2021-04-rc1' of ↵Tom Rini2021-01-184-1/+170
|\ | | | | | | | | | | | | | | | | | | https://gitlab.denx.de/u-boot/custodians/u-boot-efi Pull request for documentation tag doc-2021-04-rc1 * document man-page base command * move README.fdt-overlays to HTML documentation * add synopsis for pstore command
| * doc: move README.fdt-overlays to HTML documentationHeinrich Schuchardt2021-01-162-0/+136
| | | | | | | | | | | | | | | | Convert doc/README.fdt-overlays to doc/usage/fdt_overlays.rst. Edit the text for readability. Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
| * doc: add synopsis for pstore commandHeinrich Schuchardt2021-01-161-1/+10
| | | | | | | | | | | | | | | | Add a synopsis section. Use lower case for command name. Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
| * doc: man-page base commandHeinrich Schuchardt2021-01-162-0/+24
| | | | | | | | | | | | Provide a description of the base command. Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
* | cmd: Add MBR partition layout control utilityMarek Szyprowski2021-01-152-0/+95
|/ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Add a 'mbr' command to let users create or verify MBR partition layout based on the provided text description. The partition layout is alternatively read from the 'mbr_parts' environment variable. This can be used in scripts to help system image flashing tools to ensure proper partition layout. The syntax of the text description of the partition list is similar to the one used by the 'gpt' command. Supported parameters are: name (currently ignored), start (partition start offset in bytes), size (in bytes or '-' to expand it to the whole free area), bootable (boolean flag) and id (MBR partition type). If one wants to create more than 4 partitions, an 'Extended' primary partition (with 0x05 ID) has to be explicitely provided as a one of the first 4 entries. Here is an example how to create a 6 partitions (3 on the 'extended volume'), some of the predefined sizes: > setenv mbr_parts 'name=boot,start=4M,size=128M,bootable,id=0x0e; name=rootfs,size=3072M,id=0x83; name=system-data,size=512M,id=0x83; name=[ext],size=-,id=0x05; name=user,size=-,id=0x83; name=modules,size=100M,id=0x83; name=ramdisk,size=8M,id=0x83' > mbr write mmc 0 Signed-off-by: Marek Szyprowski <m.szyprowski@samsung.com>
* doc: man-page for bootefi commandHeinrich Schuchardt2020-12-202-0/+136
| | | | | | Provide a description of the bootefi command. Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
* doc: button commandHeinrich Schuchardt2020-12-202-0/+65
| | | | | | Provide a description of the 'button' command. Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
* doc: move README.bootmenu to HTML docHeinrich Schuchardt2020-12-152-0/+96
| | | | | | | | | | | Convert README.bootmenu to reStructured text and move it to usage/bootmenu.rst. Adjust the text concerning configuration settings as these now are managed via Kconfig. Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de> Reviewed-by: Pali Rohár <pali@kernel.org>
* doc: move README.NetConsole to HTML documentationHeinrich Schuchardt2020-12-152-0/+111
| | | | | | | | Convert README.NetConsole to reStructured text and move it to doc/usage/netconsole.rst. Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de> Reviewed-by: Simon Glass <sjg@chromium.org>
* doc: use code-block in pstore.rstHeinrich Schuchardt2020-12-151-1/+3
| | | | | | Use syntax highlighting for a Linux console session. Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
* doc: move pstore.rst to usage/pstore.rstHeinrich Schuchardt2020-12-152-0/+94
Let's have a separate chapter dedicated to using U-Boot. Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>