util: Add description.md to each util

Descriptions are taken from the files themselves or READMEs. Description
followed by a space with the language in marked up as code.

Change-Id: I5f91e85d1034736289aedf27de00df00db3ff19c
Signed-off-by: Tom Hiller <thrilleratplay@gmail.com>
Reviewed-on: https://review.coreboot.org/27563
Tested-by: build bot (Jenkins) <no-reply@coreboot.org>
Reviewed-by: Philipp Deppenwiese <zaolin.daisuki@gmail.com>
Reviewed-by: Paul Menzel <paulepanter@users.sourceforge.net>

util/abuild/description.md

@@ -0,0 +1,2 @@
+coreboot autobuild script builds coreboot images for all available
+targets. `bash`

util/acpi/description.md

@@ -0,0 +1 @@
+Walk through all ACPI tables with their addresses. `bash`

util/amdfwtool/description.md

@@ -0,0 +1 @@
+Create AMD Firmware combination `C`

util/amdtools/description.md

@@ -0,0 +1 @@
+A set of tools to compare extended) K8 memory settings. `Perl`

util/archive/description.md

@@ -0,0 +1 @@
+Concatenate files and create an archive `C`

util/arm_boot_tools/mksunxiboot/description.md

@@ -0,0 +1 @@
+A simple tool to generate bootable image for sunxi platform. `C`

util/autoport/description.md

@@ -0,0 +1 @@
+Automated porting coreboot to Sandy Bridge/Ivy Bridge platforms `Go`

util/bimgtool/description.md

@@ -0,0 +1,3 @@
+A simple tool which generates and verifies boot images in the BIMG
+format, used in systems designed by Imagination Technologies, for
+example the Pistachio SoC. `C`

util/bincfg/description.md

@@ -0,0 +1 @@
+Compiler/Decompiler for data blobs with specs `Lex` `Yacc`

util/board_status/description.md

@@ -0,0 +1,2 @@
+Tools to collect logs and upload them to the board status repository
+`Bash` `Go`

util/broadcom/description.md

@@ -0,0 +1 @@
+Generate Broadcom secure boot image. `C`

util/cavium/description.md

@@ -0,0 +1 @@
+Devicetree_convert Tool to convert a DTB to a static C file `Python`

util/cbfstool/description.md

@@ -0,0 +1,5 @@
+__cbfstool__
+  * _cbfstool_ - For manipulating CBFS file `C`
+  * _fmaptool_ - Converts plaintext fmd files into fmap blobs `C`
+  * _rmodtool_ - Creates rmodules `C`
+  * _ifwitool_ - For manipulating IFWI `C`

util/cbmem/description.md

@@ -0,0 +1 @@
+Cbmem console log reader `C`

util/checklist/description.md

@@ -0,0 +1 @@
+Board implementation checklist generator `Make`

util/chromeos/description.md

@@ -0,0 +1,3 @@
+These scripts can be used to extract System Agent reference code and
+other blobs (e.g. mrc.bin, refcode, VGA option roms) from a Chrome OS
+recovery image. `C`

util/crossgcc/description.md

@@ -0,0 +1 @@
+A cross toolchain builder for -elf toolchains (ie. no libc support)

util/docker/description.md

@@ -0,0 +1,2 @@
+Dockerfiles for _coreboot-sdk_, _coreboot-jenkins-node_,
+_coreboot.org-status_ and _docs.coreboot.org_

util/dtd_parser/description.md

@@ -0,0 +1 @@
+DTD structure parser `Python2`

util/ectool/description.md

@@ -0,0 +1 @@
+Dumps the RAM of a laptop's Embedded/Environmental Controller (EC). `C`

util/exynos/description.md

@@ -0,0 +1 @@
+Computes and fills Exynos ROM checksum (for BL1 or BL2). `Python2`

util/futility/description.md

@@ -0,0 +1 @@
+Firmware utility for signing ChromeOS images `Make`

util/fuzz-tests/description.md

@@ -0,0 +1 @@
+Create test cases that crash the jpeg code. `C`

util/genbuild_h/description.md

@@ -0,0 +1 @@
+Generate build system definitions `Shell`

util/genprof/description.md

@@ -0,0 +1 @@
+Format function tracing logs `Bash` `C`

util/gitconfig/description.md

@@ -0,0 +1 @@
+Initialize git repository submodules install git hooks `Bash`

util/ifdfake/description.md

@@ -0,0 +1 @@
+Create an Intel Firmware Descriptor with just a section layout `C`

util/ifdtool/description.md

@@ -0,0 +1 @@
+Extract and dump Intel Firmware Descriptor information `C`

util/intelmetool/description.md

@@ -0,0 +1 @@
+Dump interesting things about Management Engine even if hidden `C`

util/inteltool/description.md

@@ -0,0 +1,2 @@
+Provides information about the Intel CPU/chipset hardware configuration
+(register contents, MSRs, etc). `C`

util/intelvbttool/description.md

@@ -0,0 +1 @@
+Parse VBT from VGA BIOS `C`

util/ipqheader/description.md

@@ -0,0 +1,8 @@
+__ipqheader__
+  * _createxbl.py_ - Concatentates XBL segments into one ELF image
+                    `Python`
+  * _ipqheader.py_ - Returns a packed MBN header image with the
+                     specified base and size `Python`
+  * _mbncat.py_ - Generate ipq8064 uber SBL `Python`
+  * *mbn_tools.py* - Contains all MBN Utilities for image generation
+                     `Python`

util/k8resdump/description.md

@@ -0,0 +1,2 @@
+This program will dump the IO/memory/PCI resources from the K8 memory
+controller `C`

util/kbc1126/description.md

@@ -0,0 +1,3 @@
+Tools used to dump the two blobs from the factory firmware of many HP
+laptops with 8051-based SMSC KBC1098/KBC1126 embedded controller and
+insert them to the firmware image. `C`

util/kconfig/description.md

@@ -0,0 +1 @@
+Build system `Make`

util/lint/description.md

@@ -0,0 +1 @@
+Source linter and linting rules `Shell`

util/marvell/description.md

@@ -0,0 +1 @@
+Add U-Boot boot loader for Marvell ARMADA38X `C`

util/me_cleaner/description.md

@@ -0,0 +1,2 @@
+__[me_cleaner](https://github.com/corna/me_cleaner)__ - Tool for
+partial deblobbing of Intel ME/TXE firmware images `Python`

util/mma/description.md

@@ -0,0 +1 @@
+Memory Margin Analysis automation tests `Bash`

util/msrtool/description.md

@@ -0,0 +1 @@
+Dumps chipset-specific MSR registers. `C`

util/mtkheader/description.md

@@ -0,0 +1 @@
+Generate MediaTek bootload header. `Python2`

util/nvidia/description.md

@@ -0,0 +1 @@
+nvidia blob parsers

util/nvramtool/description.md

@@ -0,0 +1,2 @@
+Reads and writes coreboot parameters and displaying information from
+the coreboot table in CMOS/NVRAM. `C`

util/post/description.md

@@ -0,0 +1 @@
+Userspace utility that can be used to test POST cards. `C`

util/qualcomm/description.md

@@ -0,0 +1 @@
+CMM script to debug Qualcomm coreboot environments. `CMM`

util/release/description.md

@@ -0,0 +1 @@
+Generate coreboot release `Bash`

util/riscv/description.md

@@ -0,0 +1,6 @@
+__riscv__
+  * _make-spike-elf.sh_ - Converts a flat file into an ELF, that can be
+                          passed to SPIKE, the RISC-V reference
+                          emulator.`Bash`
+  * _sifive-gpt.py_ - Wraps the bootblock in a GPT partition for
+                      SiFive's bootrom. `Python3`

util/rockchip/description.md

@@ -0,0 +1 @@
+Generate Rockchip idblock bootloader. `Python2`

util/romcc/description.md

@@ -0,0 +1,2 @@
+Compile a C source file generating a binary that does not implicitly
+use RAM. `C`

util/sconfig/description.md

@@ -0,0 +1 @@
+coreboot device tree compiler `Lex` `Yacc`

util/scripts/description.md

@@ -0,0 +1,25 @@
+__scripts__
+  * _config_ - Manipulate options in a .config file from the command
+              line `Bash`
+  * _cross-repo-cherrypick_ - Pull in patches from another tree from a
+                              gerrit repository. `Shell`
+  * _dts-to-fmd.sh_ -Converts a depthcharge fmap.dts into an fmaptool
+                     compatible .fmd format `Bash`
+  * _find-unused-kconfig-symbols.sh_ - Points out Kconfig variables
+                                       that may be unused. There are
+                                       some false positives, but it
+                                       serves as a starting point
+                                       `Shell`
+  * _gerrit-rebase_ - Applies all commits that from-branch has over
+                      to-branch, based on a common ancestor and gerrit
+                      meta-data `Bash`
+  * _get_maintainer.pl_ - Print selected MAINTAINERS information for
+                          the files modified in a patch or for a file
+                          `Perl`
+  * _maintainers.go_ - Build subsystem Maintainers `Go`
+  * _no-fsf-addresses.sh_ - Removes various FSF addresses from license
+                            headers `Shell`
+  * _parse-maintainers.pl_ - Script to alphabetize MAINTAINERS file
+                             `Perl`
+  * _ucode_h_to_bin.sh_ - Microcode conversion tool `Bash`
+  * _update_submodules_ - Check all submodules for updates `Bash`

util/showdevicetree/description.md

@@ -0,0 +1 @@
+Compile and dump the device tree `C`

util/spkmodem_recv/description.md

@@ -0,0 +1 @@
+Decode spkmodem signals `C`

util/superiotool/description.md

@@ -0,0 +1,2 @@
+A user-space utility to detect Super I/O of a mainboard and provide
+detailed information about the register contents of the Super I/O. `C`

util/testing/description.md

@@ -0,0 +1 @@
+coreboot test targets `Make`

util/uio_usbdebug/description.md

@@ -0,0 +1,2 @@
+Debug coreboot's usbdebug driver inside a running operating system
+(only Linux at this time). `C`

util/vgabios/description.md

@@ -0,0 +1 @@
+emulated vga driver for qemu `C`

util/viatool/description.md

@@ -0,0 +1 @@
+Extract certain configuration bits on VIA chipsets and CPUs. `C`

util/x86/description.md

@@ -0,0 +1 @@
+Generates 32-bit PAE page tables based on a CSV input file. `Go`

util/xcompile/description.md

@@ -0,0 +1 @@
+Cross compile setup `Bash`