Jump to content

Initramfs/Inspecting: Difference between revisions

From postmarketOS Wiki
mNo edit summary
Describe available programs from https://github.com/postmarketOS/pmbootstrap/pull/1358
Line 22: Line 22:


If the telnet command does not work out of the box, read [[connect via USB Networking in the Initramfs]].
If the telnet command does not work out of the box, read [[connect via USB Networking in the Initramfs]].
=== Additional programs ===
After installing the <code>debug-shell</code> initramfs hook, the <code>evtest</code>, <code>fftest</code> and <code>fbdebug</code> programs are available in the initramfs ({{github|1358}}).


=== Tips and tricks ===
=== Tips and tricks ===
* [http://www.microhowto.info/howto/copy_a_file_from_one_machine_to_another_using_netcat.html copy files to/from the initramfs with <code>nc</code> while it is running]
* [http://www.microhowto.info/howto/copy_a_file_from_one_machine_to_another_using_netcat.html copy files to/from the initramfs with <code>nc</code> while it is running]

Revision as of 18:23, 26 March 2018

Note This is considered a security hole. Only use it for debugging, and uninstall the debug-shell hook afterwards.

This page explains how to connect to your device when it has booted to the initramfs by installing the debug-shell hook. This is useful if you want to know more about the boot process, simply inspect the initramfs or if you want to debug why something doesn't work.

It is possible to enable a telnet daemon that gives you a shell this way:

$ pmbootstrap initfs hook_add debug-shell
$ pmbootstrap flasher boot # or however you flash/boot the kernel
(wait until the device booted up and you are connected to it)
$ telnet 172.16.42.1
Trying 172.16.42.1...
Connected to 172.16.42.1.
Escape character is '^]'.

Type 'pmos_continue_boot' to continue booting:
# echo "hello world"
hello world
# pmos_continue_boot
Connection closed by foreign host.

If the telnet command does not work out of the box, read connect via USB Networking in the Initramfs.

Additional programs

After installing the debug-shell initramfs hook, the evtest, fftest and fbdebug programs are available in the initramfs (#1358).

Tips and tricks