Description: Add man pages for cbootimage and dumpbct The man pages are generated from sgml files for now, which where generated out of the --help output of the commands. Forwarded: no Author: Marc Dietrich Index: cbootimage-1.4/src/bct_dump.1.sgml =================================================================== --- /dev/null 1970-01-01 00:00:00.000000000 +0000 +++ cbootimage-1.4/src/bct_dump.1.sgml 2014-08-25 14:11:12.739312961 +0200 @@ -0,0 +1,131 @@ +Marc"> + DIETRICH"> + May 20, 2014"> + 1"> + marvin24@gmx.de"> + + BCT_DUMP"> + + + Debian"> + GNU"> + GPL"> +]> + + + +
+ &dhemail; +
+ + &dhfirstname; + &dhsurname; + + + 2014 + &dhusername; + + &dhdate; + + + &dhucpackage; + + &dhsection; + + + &dhpackage; + + tegra boot config table (bct) dumping utility + + + + &dhpackage; + + + + + DESCRIPTION + + This manual page documents briefly the + &dhpackage; command. + + &dhpackage; is used to convert the contents + of a boot config table (BCT) used in NVIDIA Tegra devices, ready + to be further proceeded by cbootimage (1). + The BCT is usually placed in the first bytes of the storage device + and can be extracted using tegrarcm(1). + + + The BCT is a data structure that provides basic initialization + parameters, and defines the bootloader to execute. + + The BCT contains: + Header information, such as cryptographic validation + hashes and size information. + Boot memory configuration. This allows the boot memory controller + to be programmed optimally, in order to read the bootloader. + SDRAM controller configuration. This allows the SDRAM controller + to be programmed, and hence external SDRAM accessed. + A bad block table. + Information about the bootloader to execute. + A "customer data" area, which may be used to store arbitrary customer- or + device-software-specific data. This area includes the ODMDATA. + + + + + OPTIONS + + + + filename + + bcd filename to read and display. + + + + + + SEE ALSO + + cbootimage(1), tegrarcm(1). + + Internet resource for NVIDIA Tegra public application notes + + + + + AUTHOR + + This manual page was written by &dhusername; (&dhemail;) for + the &debian; system (and may be used by others). Permission is + granted to copy, distribute and/or modify this document under + the terms of the &gnu; General Public License, Version 2 any + later version published by the Free Software Foundation. + + + On Debian systems, the complete text of the GNU General Public + License can be found in /usr/share/common-licenses/GPL. + + + + + + Index: cbootimage-1.4/src/cbootimage.1.sgml =================================================================== --- /dev/null 1970-01-01 00:00:00.000000000 +0000 +++ cbootimage-1.4/src/cbootimage.1.sgml 2014-08-25 14:11:12.743312980 +0200 @@ -0,0 +1,188 @@ +Marc"> + DIETRICH"> + May 20, 2014"> + 1"> + marvin24@gmx.de"> + + CBOOTIMAGE"> + + + Debian"> + GNU"> + GPL"> +]> + + + +
+ &dhemail; +
+ + &dhfirstname; + &dhsurname; + + + 2014 + &dhusername; + + &dhdate; + + + &dhucpackage; + + &dhsection; + + + &dhpackage; + + Tegra BCT and bootable flash image generator/compiler + + + + &dhpackage; + + configfile + + outputimage + + + + DESCRIPTION + + This manual page documents briefly the + &dhpackage; command. + + &dhpackage; is used to generate flashable bootimages + for Tegra devices. It requires a config file and an output filename. The + config file contains information about the boot config table (BCT) and the + bootloader. The BCT can be created using bct_dump (1). + The bootloader is typicly uboot. You can find examples of the config file + in the section. + + + + + OPTIONS + + + , , + Display help message. + + + + + , + + Output debugging information. + + + + + + + Generate the new bct file. + + + + + <ODM_DATA> + + Specify the odm_data(in hex). + + + + + , + + Select target device. Must be one of: + 20, 30, 114, 124. + Default: 20. This option is deprecated + + + + + , + + Select target device. Must be one of: + tegra20, tegra30, tegra114, tegra124. + Default: tegra20. + + + + + , + + Copy input image data and update bct configs into new image file. + + + + + configfile + + File with configuration information. + + + + + inputimage + + Input image name. This is required + if -u|--update option is used. + + + + + outputimage + + Output image name. + + + + + + SEE ALSO + + bct_dump(1), tegrarcm(1). + + Internet resource for NVIDIA Tegra public application notes + + + Examples for config files + + + + + AUTHOR + + This manual page was written by &dhusername; (&dhemail;) for + the &debian; system (and may be used by others). Permission is + granted to copy, distribute and/or modify this document under + the terms of the &gnu; General Public License, Version 2 any + later version published by the Free Software Foundation. + + + On Debian systems, the complete text of the GNU General Public + License can be found in /usr/share/common-licenses/GPL. + + + + + + Index: cbootimage-1.4/src/Makefile.am =================================================================== --- cbootimage-1.4.orig/src/Makefile.am 2014-07-16 06:45:18.000000000 +0200 +++ cbootimage-1.4/src/Makefile.am 2014-08-25 14:09:05.000000000 +0200 @@ -76,3 +76,14 @@ t124/nvboot_sdram_param_t124.h \ t132/nvboot_bct_t132.h \ t132/nvboot_sdram_param_t132.h + +man_MANS = cbootimage.1 bct_dump.1 + +EXTRA_DIST = cbootimage.1.sgml bct_dump.1.sgml +DISTCLEANFILES = cbootimage.1 bct_dump.1 + +bct_dump.1: bct_dump.1.sgml + docbook-to-man $< >$@ + +cbootimage.1: cbootimage.1.sgml + docbook-to-man $< >$@