CHEATSHEET.md

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