From 15f84cc33bd6a7180a2252ac9fae914d2118dbec Mon Sep 17 00:00:00 2001 From: Alexey Vazhnov Date: Sat, 13 Feb 2021 20:22:53 +0100 Subject: Documentation: util/board_status/README formatting Improve markdown formatting. Split paragraphs to avoid too long text. Change-Id: Ia3a74460a49f28301c5e2e3b061aeb1e0eeb6c16 Signed-off-by: Alexey Vazhnov Reviewed-on: https://review.coreboot.org/c/coreboot/+/50637 Tested-by: build bot (Jenkins) Reviewed-by: Patrick Georgi --- util/board_status/README | 50 ------------------------------- util/board_status/README.md | 63 +++++++++++++++++++++++++++++++++++++++ util/board_status/board_status.sh | 4 +-- 3 files changed, 65 insertions(+), 52 deletions(-) delete mode 100644 util/board_status/README create mode 100644 util/board_status/README.md (limited to 'util/board_status') diff --git a/util/board_status/README b/util/board_status/README deleted file mode 100644 index c462e7de2c..0000000000 --- a/util/board_status/README +++ /dev/null @@ -1,50 +0,0 @@ -General information on boot logs -================================ -To gather good boot logs, you must set the debug level to Spew. - -If your board uses CMOS configuration[1], you can do it like this: -nvramtool -w debug_level=Spew - -Else you will need to have to set the default log level at compile -time, to do that go in "Console --->" in make menuconfig, then set -"Default console log level" to SPEW - -Reference: ----------- -[1] in make menuconfig you should have: [*] Use CMOS for configuration values - This option is also known as CONFIG_USE_OPTION_TABLE in Kconfig. -Information through SSH -====================== -board_status.sh can gather information through ssh with the -r -option. - -When using "-r ", The script will attempt to log into -root@. -In order for "-r " to work, the script has to be able -to log into the remote host's root account, without having -to provide a password. -That can be achieved with the use of SSH keys and ssh-agent. - -board_status.sh expects the remote host to have the following -programs in its path: cbmem, dmesg - -Boot log gathering through a serial port -======================================= -When using -s , board_status.sh starts by retrieving the -boot log through the serial port. - -To produce such logs, power off the board, run board_status.sh -with the right arguments, power on the board. -At that point the logs will be displayed by board_status.sh as they -are produced by the board. - -Enter will have to be pressed once the board has booted and is in a -state where the script is able to log into that board. - -Publishing -========== -The -u switch will publish the results: It will make a git patch out -of the status information, that will be directly pushed in the -board-status repository. -It expects the user to already have an account in coreboot's gerrit -instance. diff --git a/util/board_status/README.md b/util/board_status/README.md new file mode 100644 index 0000000000..89db5c8dce --- /dev/null +++ b/util/board_status/README.md @@ -0,0 +1,63 @@ +General information on boot logs +================================ + +To gather good boot logs, you must set the debug level to Spew. + +If your board uses CMOS configuration[1], you can do it like this: + +```shell +nvramtool -w debug_level=Spew +``` + +Else you will need to have to set the default log level at compile +time, to do that go in `Console --->` in make menuconfig, then set +`Default console log level` to SPEW. + +Reference: +---------- + +[1] in make menuconfig you should have: `General setup --->`, `[*] Use CMOS for configuration values`. + This option is also known as `CONFIG_USE_OPTION_TABLE` in `Kconfig`. + +Gather information through SSH +============================== + +`board_status.sh` can gather information through ssh with the `-r` +option. + +When using `-r `, The script will attempt to log into +root@host. + +In order for `-r ` to work, the script has to be able +to log into the remote host's root account, without having +to provide a password. + +That can be achieved with the use of SSH keys and ssh-agent. + +`board_status.sh` expects the remote host to have the following +programs in its path: `cbmem`, `dmesg`. + +Boot log gathering through a serial port +======================================== + +When using `board_status.sh -s `, script starts by retrieving the +boot log through the serial port. + +To produce such logs, power off the board, run `board_status.sh` +with the right arguments, power on the board. + +At that point the logs will be displayed by `board_status.sh` as they +are produced by the board. + +Enter will have to be pressed once the board has booted and is in a +state where the script is able to log into that board. + +Publishing +========== + +It expects the user to already have an account in +[coreboot's Gerrit instance](https://review.coreboot.org). + +The `-u` switch will publish the results: It will make a `git patch` out +of the status information, that will be directly pushed in the +board-status repository. diff --git a/util/board_status/board_status.sh b/util/board_status/board_status.sh index 1024ff67b2..292bffac73 100755 --- a/util/board_status/board_status.sh +++ b/util/board_status/board_status.sh @@ -32,11 +32,11 @@ case $(uname) in echo "Please install gmake, or build and install devel/gmake from ports." exit $EXIT_FAILURE else - MAKE=gmake + MAKE='gmake' fi ;; *) - MAKE=make + MAKE='make' ;; esac -- cgit v1.2.3