docs/wiki/Inspecting-the-initramfs/index.html


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="utf-8">

    <title>postmarketOS</title>

    <meta name="description" content="Aiming for a 10 year life-cycle for smartphones">
    <meta name="keywords" content="postmarketOS">

    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <meta name="robots" content="all">

    <link rel="canonical" href="https://postmarketos.org/wiki/Inspecting-the-initramfs/">

    <link href="/pmosweb/static/css/tachyons.min.css" rel="stylesheet">
    <link href="/pmosweb/static/css/main.css" rel="stylesheet">
  </head>

  <body>
    <div class="mw7 center">
      <div class="cf ph2-ns">
        <a class="title" href="/pmosweb/">
          <h1 class="f2 lh-title">
            <img src="/pmosweb/static/img/recycle.png"></img>
            <span>postmarketOS</span>
          </h1>
        </a>
        <div class="menu">
        <ul>
          <li><a href="/pmosweb/">Home</a></li>
          <li><a href="/pmosweb/wiki/">Wiki</a></li>
          <li><a href="/pmosweb/blog/">Blog</a></li>
        </ul>
        </div>
        
<h1>Inspecting the initramfs</h1>
<p>This page explains how to connect to your device when it has booted to the [[initramfs|Initramfs-development]] by installing the so-called <a href="https://github.com/postmarketOS/pmbootstrap/blob/master/aports/postmarketos-mkinitfs-hook-usb-shell/20-usb-shell.sh">usb-shell hook</a>. This is useful if you want to know more about the [[boot process]], simply inspect the initramfs or you want to debug why something doesn't work.</p>
<p><strong>NOTE: This is considered a security hole. Only use it for debugging, and uninstall the usb-shell hook afterwards</strong></p>
<p>By default, initramfs launchs a telnet daemon listening on <code>:23</code> waiting for your partition password.</p>
<p>It is possible to enable a second telnet daemon on <code>:24</code> that gives you a shell this way:</p>
<pre class="codehilite"><code class="language-shell">./pmbootstrap.py initfs hook_add usb-shell
./pmbootstrap.py install</code></pre>


<p>After reflashing the kernel or booting with the new initramfs image, you should be able to connect to the new telnet instance.</p>

      </div>
    </div>
  </body>
</html>