CHEATSHEET.md

   1 # Dragora's Cheat Sheet
   2
   3 ## Bootstrapping
   4
   5 Prerequisities:
   6
   7 - A working C compiler, system toolchain, utilities.
   8
   9 - Enough hard disk space (7GB+) for the whole process.
  10
  11 - A superuser account is needed to perform all the steps.
  12
  13 - Clone or sync the git repository.
  14
  15 - Obtain or sync the sources (tarballs).  See the *sources/README.md* file.
  16
  17 Bootstrapping from Debian systems:
  18
  19 `apt update && apt upgrade`
  20
  21 `apt install build-essential flex git lzip genisoimage texinfo unzip zlib1g zlib1g-dev liblz1 liblz-dev`
  22
  23 ### Instructions:
  24
  25 Creates a cross compiler for your native architecture:
  26
  27 `./bootstrap -s0 2>&1 | tee stage0-log.txt`
  28
  29 Prepare a temporary system using the recent cross compiler:
  30
  31 `./bootstrap -s1 2>&1 | tee stage1-log.txt`
  32
  33 Enter the temporary system:
  34
  35 `./enter-chroot`
  36
  37 Start replacing the temporary system with the final system:
  38
  39 `qi order /usr/src/qi/recipes/*.order | qi build -S -p -i - 2>&1 | tee build-log.txt`
  40
  41 Set custom modifications, like a password for the superuser:
  42
  43 `passwd root`
  44
  45 Exit from the temporal session (enter-chroot):
  46
  47 `exit`
  48
  49 Produce an ISO image from the Stage 2:
  50
  51 `./bootstrap -s2 2>&1 | tee stage2-log.txt`
  52
  53 Burn or emulate the (hybrid) ISO image at
  54 *OUTPUT.bootstrap/stage2/cdrom/dragora-live.iso*.
  55
  56 Hints:
  57
  58 To speed up the build procedure multiple jobs can be passed to the compiler.<br/>
  59 Just give the -j option to the *bootstrap* script and pass the same one to the<br/>
  60 connected *qi* in the pipe.  Consider the value for -j taking into account the<br/>
  61 number of processors + 1, for example `-j3`
  62
  63
  64 ---
  65
  66 Under the terms of the GNU Free Documentation License,
  67 http://www.gnu.org/licenses/fdl.html
  68
  69 Updated: 2020-09-07