1General information on boot logs 2================================ 3 4To gather good boot logs, you must set the debug level to Spew. 5 6If your board uses CMOS configuration[1], you can do it like this: 7 8```shell 9nvramtool -w debug_level=Spew 10``` 11 12Else you will need to have to set the default log level at compile 13time, to do that go in `Console --->` in make menuconfig, then set 14`Default console log level` to SPEW. 15 16Reference: 17---------- 18 19[1] in make menuconfig you should have: `General setup --->`, `[*] Use CMOS for configuration values`. 20 This option is also known as `CONFIG_USE_OPTION_TABLE` in `Kconfig`. 21 22Gather information through SSH 23============================== 24 25`board_status.sh` can gather information through ssh with the `-r` 26option. 27 28When using `-r <host>`, The script will attempt to log into 29root@host. 30 31In order for `-r <host>` to work, the script has to be able 32to log into the remote host's root account, without having 33to provide a password. 34 35That can be achieved with the use of SSH keys and ssh-agent. 36 37`board_status.sh` expects the remote host to have the following 38programs in its path: `cbmem`, `dmesg`. 39 40Boot log gathering through a serial port 41======================================== 42 43When using `board_status.sh -s </dev/xxx>`, script starts by retrieving the 44boot log through the serial port. 45 46To produce such logs, power off the board, run `board_status.sh` 47with the right arguments, power on the board. 48 49At that point the logs will be displayed by `board_status.sh` as they 50are produced by the board. 51 52<kbd>Enter</kbd> will have to be pressed once the board has booted and is in a 53state where the script is able to log into that board. 54 55Publishing 56========== 57 58It expects the user to already have an account in 59[coreboot's Gerrit instance](https://review.coreboot.org). 60 61The `-u` switch will publish the results: It will make a `git patch` out 62of the status information, that will be directly pushed in the 63board-status repository. 64