Hex Artifact Content
Not logged in

Artifact c51c4168216d0ce93136a6a5031ab5f063470f84:

Unrecognized artifact
0000: 54 68 65 20 67 6f 61 6c 20 6f 66 20 74 68 65 20  The goal of the 
0010: 6c 69 62 63 20 63 72 61 74 65 20 69 73 20 74 6f  libc crate is to
0020: 20 68 61 76 65 20 43 49 20 72 75 6e 6e 69 6e 67   have CI running
0030: 20 65 76 65 72 79 77 68 65 72 65 20 74 6f 20 68   everywhere to h
0040: 61 76 65 20 74 68 65 0a 73 74 72 6f 6e 67 65 73  ave the.stronges
0050: 74 20 67 75 61 72 61 6e 74 65 65 73 20 61 62 6f  t guarantees abo
0060: 75 74 20 74 68 65 20 64 65 66 69 6e 69 74 69 6f  ut the definitio
0070: 6e 73 20 74 68 61 74 20 74 68 69 73 20 6c 69 62  ns that this lib
0080: 72 61 72 79 20 63 6f 6e 74 61 69 6e 73 2c 20 61  rary contains, a
0090: 6e 64 20 61 73 20 61 0a 72 65 73 75 6c 74 20 74  nd as a.result t
00a0: 68 65 20 43 49 20 69 73 20 70 72 65 74 74 79 20  he CI is pretty 
00b0: 63 6f 6d 70 6c 69 63 61 74 65 64 20 61 6e 64 20  complicated and 
00c0: 61 6c 73 6f 20 70 72 65 74 74 79 20 6c 61 72 67  also pretty larg
00d0: 65 21 20 48 6f 70 65 66 75 6c 6c 79 20 74 68 69  e! Hopefully thi
00e0: 73 20 63 61 6e 0a 73 65 72 76 65 20 61 73 20 61  s can.serve as a
00f0: 20 67 75 69 64 65 20 74 68 72 6f 75 67 68 20 74   guide through t
0100: 68 65 20 73 65 61 20 6f 66 20 73 63 72 69 70 74  he sea of script
0110: 73 20 69 6e 20 74 68 69 73 20 64 69 72 65 63 74  s in this direct
0120: 6f 72 79 20 61 6e 64 20 65 6c 73 65 77 68 65 72  ory and elsewher
0130: 65 20 69 6e 0a 74 68 69 73 20 70 72 6f 6a 65 63  e in.this projec
0140: 74 2e 0a 0a 23 20 46 69 6c 65 73 0a 0a 46 69 72  t...# Files..Fir
0150: 73 74 20 75 70 2c 20 6c 65 74 27 73 20 74 61 6c  st up, let's tal
0160: 6b 20 61 62 6f 75 74 20 74 68 65 20 66 69 6c 65  k about the file
0170: 73 20 69 6e 20 74 68 69 73 20 64 69 72 65 63 74  s in this direct
0180: 6f 72 79 3a 0a 0a 2a 20 60 72 75 6e 2d 74 72 61  ory:..* `run-tra
0190: 76 69 73 2e 73 68 60 20 2d 20 61 20 73 68 65 6c  vis.sh` - a shel
01a0: 6c 20 73 63 72 69 70 74 20 72 75 6e 20 62 79 20  l script run by 
01b0: 61 6c 6c 20 54 72 61 76 69 73 20 62 75 69 6c 64  all Travis build
01c0: 65 72 73 2c 20 74 68 69 73 20 69 73 0a 20 20 72  ers, this is.  r
01d0: 65 73 70 6f 6e 73 69 62 6c 65 20 66 6f 72 20 73  esponsible for s
01e0: 65 74 74 69 6e 67 20 75 70 20 74 68 65 20 72 65  etting up the re
01f0: 73 74 20 6f 66 20 74 68 65 20 65 6e 76 69 72 6f  st of the enviro
0200: 6e 6d 65 6e 74 20 73 75 63 68 20 61 73 20 69 6e  nment such as in
0210: 73 74 61 6c 6c 69 6e 67 20 6e 65 77 0a 20 20 70  stalling new.  p
0220: 61 63 6b 61 67 65 73 2c 20 64 6f 77 6e 6c 6f 61  ackages, downloa
0230: 64 69 6e 67 20 52 75 73 74 20 74 61 72 67 65 74  ding Rust target
0240: 20 6c 69 62 72 61 72 69 65 73 2c 20 65 74 63 2e   libraries, etc.
0250: 0a 0a 2a 20 60 72 75 6e 2e 73 68 60 20 2d 20 74  ..* `run.sh` - t
0260: 68 65 20 61 63 74 75 61 6c 20 73 63 72 69 70 74  he actual script
0270: 20 77 68 69 63 68 20 72 75 6e 73 20 74 65 73 74   which runs test
0280: 73 20 66 6f 72 20 61 20 70 61 72 74 69 63 75 6c  s for a particul
0290: 61 72 20 61 72 63 68 69 74 65 63 74 75 72 65 2e  ar architecture.
02a0: 0a 20 20 43 61 6c 6c 65 64 20 66 72 6f 6d 20 74  .  Called from t
02b0: 68 65 20 60 72 75 6e 2d 74 72 61 76 69 73 2e 73  he `run-travis.s
02c0: 68 60 20 73 63 72 69 70 74 20 74 68 69 73 20 77  h` script this w
02d0: 69 6c 6c 20 72 75 6e 20 61 6c 6c 20 74 65 73 74  ill run all test
02e0: 73 20 66 6f 72 20 74 68 65 20 74 61 72 67 65 74  s for the target
02f0: 0a 20 20 73 70 65 63 69 66 69 65 64 2e 0a 0a 2a  .  specified...*
0300: 20 60 63 61 72 67 6f 2d 63 6f 6e 66 69 67 60 20   `cargo-config` 
0310: 2d 20 43 61 72 67 6f 20 63 6f 6e 66 69 67 75 72  - Cargo configur
0320: 61 74 69 6f 6e 20 6f 66 20 6c 69 6e 6b 65 72 73  ation of linkers
0330: 20 74 6f 20 75 73 65 20 63 6f 70 69 65 64 20 69   to use copied i
0340: 6e 74 6f 20 70 6c 61 63 65 20 62 79 0a 20 20 74  nto place by.  t
0350: 68 65 20 60 72 75 6e 2d 74 72 61 76 69 73 2e 73  he `run-travis.s
0360: 68 60 20 73 63 72 69 70 74 20 62 65 66 6f 72 65  h` script before
0370: 20 62 75 69 6c 64 73 20 61 72 65 20 72 75 6e 2e   builds are run.
0380: 0a 0a 2a 20 60 64 6f 78 2e 73 68 60 20 2d 20 73  ..* `dox.sh` - s
0390: 63 72 69 70 74 20 63 61 6c 6c 65 64 20 66 72 6f  cript called fro
03a0: 6d 20 60 72 75 6e 2d 74 72 61 76 69 73 2e 73 68  m `run-travis.sh
03b0: 60 20 6f 6e 20 6f 6e 6c 79 20 74 68 65 20 6c 69  ` on only the li
03c0: 6e 75 78 20 36 34 2d 62 69 74 20 6e 69 67 68 74  nux 64-bit night
03d0: 6c 79 0a 20 20 54 72 61 76 69 73 20 62 6f 74 73  ly.  Travis bots
03e0: 20 74 6f 20 62 75 69 6c 64 20 64 6f 63 75 6d 65   to build docume
03f0: 6e 74 61 74 69 6f 6e 20 66 6f 72 20 74 68 69 73  ntation for this
0400: 20 63 72 61 74 65 2e 0a 0a 2a 20 60 6c 61 6e 64   crate...* `land
0410: 69 6e 67 2d 70 61 67 65 2d 2a 2e 68 74 6d 6c 60  ing-page-*.html`
0420: 20 2d 20 75 73 65 64 20 62 79 20 60 64 6f 78 2e   - used by `dox.
0430: 73 68 60 20 74 6f 20 67 65 6e 65 72 61 74 65 20  sh` to generate 
0440: 61 20 6c 61 6e 64 69 6e 67 20 70 61 67 65 20 66  a landing page f
0450: 6f 72 20 61 6c 6c 0a 20 20 61 72 63 68 69 74 65  or all.  archite
0460: 63 74 75 72 65 73 27 20 64 6f 63 75 6d 65 6e 74  ctures' document
0470: 61 74 69 6f 6e 2e 0a 0a 2a 20 60 72 75 6e 2d 71  ation...* `run-q
0480: 65 6d 75 2e 73 68 60 20 2d 20 73 65 65 20 64 69  emu.sh` - see di
0490: 73 63 75 73 73 69 6f 6e 20 61 62 6f 75 74 20 51  scussion about Q
04a0: 45 4d 55 20 62 65 6c 6f 77 0a 0a 2a 20 60 6d 69  EMU below..* `mi
04b0: 70 73 60 2c 20 60 72 75 6d 70 72 75 6e 60 20 2d  ps`, `rumprun` -
04c0: 20 69 6e 73 74 72 75 63 74 69 6f 6e 73 20 74 6f   instructions to
04d0: 20 62 75 69 6c 64 20 74 68 65 20 64 6f 63 6b 65   build the docke
04e0: 72 20 69 6d 61 67 65 20 66 6f 72 20 65 61 63 68  r image for each
04f0: 20 72 65 73 70 65 63 74 69 76 65 0a 20 20 43 49   respective.  CI
0500: 20 74 61 72 67 65 74 0a 0a 23 20 43 49 20 53 79   target..# CI Sy
0510: 73 74 65 6d 73 0a 0a 43 75 72 72 65 6e 74 6c 79  stems..Currently
0520: 20 74 68 69 73 20 72 65 70 6f 73 69 74 6f 72 79   this repository
0530: 20 6c 65 76 65 72 61 67 65 73 20 61 20 63 6f 6d   leverages a com
0540: 62 69 6e 61 74 69 6f 6e 20 6f 66 20 54 72 61 76  bination of Trav
0550: 69 73 20 43 49 20 61 6e 64 20 41 70 70 56 65 79  is CI and AppVey
0560: 6f 72 20 66 6f 72 0a 72 75 6e 6e 69 6e 67 20 74  or for.running t
0570: 65 73 74 73 2e 20 54 68 65 20 74 72 69 70 6c 65  ests. The triple
0580: 73 20 74 65 73 74 65 64 20 61 72 65 3a 0a 0a 2a  s tested are:..*
0590: 20 41 70 70 56 65 79 6f 72 0a 20 20 2a 20 60 7b   AppVeyor.  * `{
05a0: 69 36 38 36 2c 78 38 36 5f 36 34 7d 2d 70 63 2d  i686,x86_64}-pc-
05b0: 77 69 6e 64 6f 77 73 2d 7b 6d 73 76 63 2c 67 6e  windows-{msvc,gn
05c0: 75 7d 60 0a 2a 20 54 72 61 76 69 73 0a 20 20 2a  u}`.* Travis.  *
05d0: 20 60 7b 69 36 38 36 2c 78 38 36 5f 36 34 2c 6d   `{i686,x86_64,m
05e0: 69 70 73 2c 61 61 72 63 68 36 34 7d 2d 75 6e 6b  ips,aarch64}-unk
05f0: 6e 6f 77 6e 2d 6c 69 6e 75 78 2d 67 6e 75 60 0a  nown-linux-gnu`.
0600: 20 20 2a 20 60 7b 78 38 36 5f 36 34 2c 61 61 72    * `{x86_64,aar
0610: 63 68 36 34 7d 2d 75 6e 6b 6e 6f 77 6e 2d 6c 69  ch64}-unknown-li
0620: 6e 75 78 2d 6d 75 73 6c 60 0a 20 20 2a 20 60 61  nux-musl`.  * `a
0630: 72 6d 2d 75 6e 6b 6e 6f 77 6e 2d 6c 69 6e 75 78  rm-unknown-linux
0640: 2d 67 6e 75 65 61 62 69 68 66 60 0a 20 20 2a 20  -gnueabihf`.  * 
0650: 60 61 72 6d 2d 6c 69 6e 75 78 2d 61 6e 64 72 6f  `arm-linux-andro
0660: 69 64 65 61 62 69 60 0a 20 20 2a 20 60 7b 69 36  ideabi`.  * `{i6
0670: 38 36 2c 78 38 36 5f 36 34 7d 2d 61 70 70 6c 65  86,x86_64}-apple
0680: 2d 7b 64 61 72 77 69 6e 2c 69 6f 73 7d 60 0a 20  -{darwin,ios}`. 
0690: 20 2a 20 60 78 38 36 5f 36 34 2d 72 75 6d 70 72   * `x86_64-rumpr
06a0: 75 6e 2d 6e 65 74 62 73 64 60 0a 20 20 2a 20 60  un-netbsd`.  * `
06b0: 78 38 36 5f 36 34 2d 75 6e 6b 6e 6f 77 6e 2d 66  x86_64-unknown-f
06c0: 72 65 65 62 73 64 60 0a 20 20 2a 20 60 78 38 36  reebsd`.  * `x86
06d0: 5f 36 34 2d 75 6e 6b 6e 6f 77 6e 2d 6f 70 65 6e  _64-unknown-open
06e0: 62 73 64 60 0a 0a 54 68 65 20 57 69 6e 64 6f 77  bsd`..The Window
06f0: 73 20 74 72 69 70 6c 65 73 20 61 72 65 20 61 6c  s triples are al
0700: 6c 20 70 72 65 74 74 79 20 73 74 61 6e 64 61 72  l pretty standar
0710: 64 2c 20 74 68 65 79 20 6a 75 73 74 20 73 65 74  d, they just set
0720: 20 75 70 20 74 68 65 69 72 20 65 6e 76 69 72 6f   up their enviro
0730: 6e 6d 65 6e 74 0a 74 68 65 6e 20 72 75 6e 20 74  nment.then run t
0740: 65 73 74 73 2c 20 6e 6f 20 6e 65 65 64 20 66 6f  ests, no need fo
0750: 72 20 64 6f 77 6e 6c 6f 61 64 69 6e 67 20 61 6e  r downloading an
0760: 79 20 65 78 74 72 61 20 74 61 72 67 65 74 20 6c  y extra target l
0770: 69 62 73 20 28 77 65 20 6a 75 73 74 20 64 6f 77  ibs (we just dow
0780: 6e 6c 6f 61 64 0a 74 68 65 20 72 69 67 68 74 20  nload.the right 
0790: 69 6e 73 74 61 6c 6c 65 72 29 2e 20 54 68 65 20  installer). The 
07a0: 49 6e 74 65 6c 20 4c 69 6e 75 78 2f 4f 53 58 20  Intel Linux/OSX 
07b0: 62 75 69 6c 64 73 20 61 72 65 20 73 69 6d 69 6c  builds are simil
07c0: 61 72 20 69 6e 20 74 68 61 74 20 77 65 20 6a 75  ar in that we ju
07d0: 73 74 0a 64 6f 77 6e 6c 6f 61 64 20 74 68 65 20  st.download the 
07e0: 72 69 67 68 74 20 74 61 72 67 65 74 20 6c 69 62  right target lib
07f0: 73 20 61 6e 64 20 72 75 6e 20 74 65 73 74 73 2e  s and run tests.
0800: 20 4e 6f 74 65 20 74 68 61 74 20 74 68 65 20 49   Note that the I
0810: 6e 74 65 6c 20 4c 69 6e 75 78 2f 4f 53 58 0a 62  ntel Linux/OSX.b
0820: 75 69 6c 64 73 20 61 72 65 20 72 75 6e 20 6f 6e  uilds are run on
0830: 20 73 74 61 62 6c 65 2f 62 65 74 61 2f 6e 69 67   stable/beta/nig
0840: 68 74 6c 79 2c 20 62 75 74 20 61 72 65 20 74 68  htly, but are th
0850: 65 20 6f 6e 6c 79 20 6f 6e 65 73 20 74 68 61 74  e only ones that
0860: 20 64 6f 20 73 6f 2e 0a 0a 54 68 65 20 72 65 6d   do so...The rem
0870: 61 69 6e 69 6e 67 20 61 72 63 68 69 74 65 63 74  aining architect
0880: 75 72 65 73 20 6c 6f 6f 6b 20 6c 69 6b 65 3a 0a  ures look like:.
0890: 0a 2a 20 41 6e 64 72 6f 69 64 20 72 75 6e 73 20  .* Android runs 
08a0: 69 6e 20 61 20 5b 64 6f 63 6b 65 72 20 69 6d 61  in a [docker ima
08b0: 67 65 5d 5b 61 6e 64 72 6f 69 64 2d 64 6f 63 6b  ge][android-dock
08c0: 65 72 5d 20 77 69 74 68 20 61 6e 20 65 6d 75 6c  er] with an emul
08d0: 61 74 6f 72 2c 20 74 68 65 20 4e 44 4b 2c 0a 20  ator, the NDK,. 
08e0: 20 61 6e 64 20 74 68 65 20 53 44 4b 20 61 6c 72   and the SDK alr
08f0: 65 61 64 79 20 73 65 74 20 75 70 2e 20 54 68 65  eady set up. The
0900: 20 65 6e 74 69 72 65 20 62 75 69 6c 64 20 68 61   entire build ha
0910: 70 70 65 6e 73 20 77 69 74 68 69 6e 20 74 68 65  ppens within the
0920: 20 64 6f 63 6b 65 72 20 69 6d 61 67 65 2e 0a 2a   docker image..*
0930: 20 54 68 65 20 4d 49 50 53 2c 20 41 52 4d 2c 20   The MIPS, ARM, 
0940: 61 6e 64 20 41 41 72 63 68 36 34 20 62 75 69 6c  and AArch64 buil
0950: 64 73 20 61 6c 6c 20 75 73 65 20 74 68 65 20 51  ds all use the Q
0960: 45 4d 55 20 75 73 65 72 73 70 61 63 65 20 65 6d  EMU userspace em
0970: 75 6c 61 74 6f 72 20 74 6f 20 72 75 6e 0a 20 20  ulator to run.  
0980: 74 68 65 20 67 65 6e 65 72 61 74 65 64 20 62 69  the generated bi
0990: 6e 61 72 79 20 74 6f 20 61 63 74 75 61 6c 6c 79  nary to actually
09a0: 20 76 65 72 69 66 79 20 74 68 65 20 74 65 73 74   verify the test
09b0: 73 20 70 61 73 73 2e 0a 2a 20 54 68 65 20 4d 55  s pass..* The MU
09c0: 53 4c 20 62 75 69 6c 64 20 6a 75 73 74 20 68 61  SL build just ha
09d0: 73 20 74 6f 20 64 6f 77 6e 6c 6f 61 64 20 61 20  s to download a 
09e0: 4d 55 53 4c 20 63 6f 6d 70 69 6c 65 72 20 61 6e  MUSL compiler an
09f0: 64 20 74 61 72 67 65 74 20 6c 69 62 72 61 72 69  d target librari
0a00: 65 73 20 61 6e 64 0a 20 20 74 68 65 6e 20 6f 74  es and.  then ot
0a10: 68 65 72 77 69 73 65 20 72 75 6e 73 20 74 65 73  herwise runs tes
0a20: 74 73 20 6e 6f 72 6d 61 6c 6c 79 2e 0a 2a 20 69  ts normally..* i
0a30: 4f 53 20 62 75 69 6c 64 73 20 6e 65 65 64 20 61  OS builds need a
0a40: 6e 20 65 78 74 72 61 20 6c 69 6e 6b 65 72 20 66  n extra linker f
0a50: 6c 61 67 20 63 75 72 72 65 6e 74 6c 79 2c 20 62  lag currently, b
0a60: 75 74 20 62 65 79 6f 6e 64 20 74 68 61 74 20 74  ut beyond that t
0a70: 68 65 79 27 72 65 20 62 75 69 6c 74 0a 20 20 61  hey're built.  a
0a80: 73 20 73 74 61 6e 64 61 72 64 20 61 73 20 65 76  s standard as ev
0a90: 65 72 79 74 68 69 6e 67 20 65 6c 73 65 2e 0a 2a  erything else..*
0aa0: 20 54 68 65 20 72 75 6d 70 72 75 6e 20 74 61 72   The rumprun tar
0ab0: 67 65 74 20 62 75 69 6c 64 73 20 61 6e 20 65 6e  get builds an en
0ac0: 74 69 72 65 20 6b 65 72 6e 65 6c 20 66 72 6f 6d  tire kernel from
0ad0: 20 74 68 65 20 74 65 73 74 20 73 75 69 74 65 20   the test suite 
0ae0: 61 6e 64 20 74 68 65 6e 20 72 75 6e 73 0a 20 20  and then runs.  
0af0: 69 74 20 69 6e 73 69 64 65 20 51 45 4d 55 20 75  it inside QEMU u
0b00: 73 69 6e 67 20 74 68 65 20 73 65 72 69 61 6c 20  sing the serial 
0b10: 63 6f 6e 73 6f 6c 65 20 74 6f 20 74 65 73 74 20  console to test 
0b20: 77 68 65 74 68 65 72 20 69 74 20 73 75 63 63 65  whether it succe
0b30: 65 64 65 64 20 6f 72 0a 20 20 66 61 69 6c 65 64  eded or.  failed
0b40: 2e 0a 2a 20 54 68 65 20 42 53 44 20 62 75 69 6c  ..* The BSD buil
0b50: 64 73 2c 20 63 75 72 72 65 6e 74 6c 79 20 4f 70  ds, currently Op
0b60: 65 6e 42 53 44 20 61 6e 64 20 46 72 65 65 42 53  enBSD and FreeBS
0b70: 44 2c 20 75 73 65 20 51 45 4d 55 20 74 6f 20 62  D, use QEMU to b
0b80: 6f 6f 74 20 75 70 20 61 20 73 79 73 74 65 6d 0a  oot up a system.
0b90: 20 20 61 6e 64 20 63 6f 6d 70 69 6c 65 2f 72 75    and compile/ru
0ba0: 6e 20 74 65 73 74 73 2e 20 4d 6f 72 65 20 69 6e  n tests. More in
0bb0: 66 6f 72 6d 61 74 69 6f 6e 20 6f 6e 20 74 68 61  formation on tha
0bc0: 74 20 62 65 6c 6f 77 2e 0a 0a 5b 61 6e 64 72 6f  t below...[andro
0bd0: 69 64 2d 64 6f 63 6b 65 72 5d 3a 20 68 74 74 70  id-docker]: http
0be0: 73 3a 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 72  s://github.com/r
0bf0: 75 73 74 2d 6c 61 6e 67 2f 72 75 73 74 2d 62 75  ust-lang/rust-bu
0c00: 69 6c 64 62 6f 74 2f 62 6c 6f 62 2f 6d 61 73 74  ildbot/blob/mast
0c10: 65 72 2f 73 6c 61 76 65 73 2f 61 6e 64 72 6f 69  er/slaves/androi
0c20: 64 2f 44 6f 63 6b 65 72 66 69 6c 65 0a 0a 23 23  d/Dockerfile..##
0c30: 20 51 45 4d 55 0a 0a 4c 6f 74 73 20 6f 66 20 74   QEMU..Lots of t
0c40: 68 65 20 61 72 63 68 69 74 65 63 74 75 72 65 73  he architectures
0c50: 20 74 65 73 74 65 64 20 68 65 72 65 20 75 73 65   tested here use
0c60: 20 51 45 4d 55 20 69 6e 20 74 68 65 20 74 65 73   QEMU in the tes
0c70: 74 73 2c 20 73 6f 20 69 74 27 73 20 77 6f 72 74  ts, so it's wort
0c80: 68 20 67 6f 69 6e 67 0a 6f 76 65 72 20 61 6c 6c  h going.over all
0c90: 20 74 68 65 20 63 72 61 7a 79 20 63 61 70 61 62   the crazy capab
0ca0: 69 6c 69 74 69 65 73 20 51 45 4d 55 20 68 61 73  ilities QEMU has
0cb0: 20 61 6e 64 20 74 68 65 20 76 61 72 69 6f 75 73   and the various
0cc0: 20 66 6c 61 76 6f 72 73 20 69 6e 20 77 68 69 63   flavors in whic
0cd0: 68 20 77 65 20 75 73 65 0a 69 74 21 0a 0a 46 69  h we use.it!..Fi
0ce0: 72 73 74 20 75 70 2c 20 51 45 4d 55 20 68 61 73  rst up, QEMU has
0cf0: 20 75 73 65 72 73 70 61 63 65 20 65 6d 75 6c 61   userspace emula
0d00: 74 69 6f 6e 20 77 68 65 72 65 20 69 74 20 64 6f  tion where it do
0d10: 65 73 6e 27 74 20 62 6f 6f 74 20 61 20 66 75 6c  esn't boot a ful
0d20: 6c 20 6b 65 72 6e 65 6c 2c 20 69 74 0a 6a 75 73  l kernel, it.jus
0d30: 74 20 72 75 6e 73 20 61 20 62 69 6e 61 72 79 20  t runs a binary 
0d40: 66 72 6f 6d 20 61 6e 6f 74 68 65 72 20 61 72 63  from another arc
0d50: 68 69 74 65 63 74 75 72 65 20 28 75 73 69 6e 67  hitecture (using
0d60: 20 74 68 65 20 60 71 65 6d 75 2d 3c 61 72 63 68   the `qemu-<arch
0d70: 3e 60 20 77 72 61 70 70 65 72 73 29 2e 0a 57 65  >` wrappers)..We
0d80: 20 70 72 6f 76 69 64 65 20 69 74 20 74 68 65 20   provide it the 
0d90: 72 75 6e 74 69 6d 65 20 70 61 74 68 20 66 6f 72  runtime path for
0da0: 20 74 68 65 20 64 79 6e 61 6d 69 63 61 6c 6c 79   the dynamically
0db0: 20 6c 6f 61 64 65 64 20 73 79 73 74 65 6d 20 6c   loaded system l
0dc0: 69 62 72 61 72 69 65 73 2c 0a 68 6f 77 65 76 65  ibraries,.howeve
0dd0: 72 2e 20 54 68 69 73 20 73 74 72 61 74 65 67 79  r. This strategy
0de0: 20 69 73 20 75 73 65 64 20 66 6f 72 20 61 6c 6c   is used for all
0df0: 20 4c 69 6e 75 78 20 61 72 63 68 69 74 65 63 74   Linux architect
0e00: 75 72 65 73 20 74 68 61 74 20 61 72 65 6e 27 74  ures that aren't
0e10: 20 69 6e 74 65 6c 2e 0a 4e 6f 74 65 20 74 68 61   intel..Note tha
0e20: 74 20 6f 6e 65 20 64 6f 77 6e 73 69 64 65 20 6f  t one downside o
0e30: 66 20 74 68 69 73 20 51 45 4d 55 20 73 79 73 74  f this QEMU syst
0e40: 65 6d 20 69 73 20 74 68 61 74 20 74 68 72 65 61  em is that threa
0e50: 64 73 20 61 72 65 20 62 61 72 65 6c 79 0a 69 6d  ds are barely.im
0e60: 70 6c 65 6d 65 6e 74 65 64 2c 20 73 6f 20 77 65  plemented, so we
0e70: 27 72 65 20 63 61 72 65 66 75 6c 20 74 6f 20 6e  're careful to n
0e80: 6f 74 20 73 70 61 77 6e 20 6d 61 6e 79 20 74 68  ot spawn many th
0e90: 72 65 61 64 73 2e 0a 0a 46 6f 72 20 74 68 65 20  reads...For the 
0ea0: 72 75 6d 70 72 75 6e 20 74 61 72 67 65 74 20 74  rumprun target t
0eb0: 68 65 20 6f 6e 6c 79 20 6f 75 74 70 75 74 20 69  he only output i
0ec0: 73 20 61 20 6b 65 72 6e 65 6c 20 69 6d 61 67 65  s a kernel image
0ed0: 2c 20 73 6f 20 77 65 20 6a 75 73 74 20 75 73 65  , so we just use
0ee0: 20 74 68 61 74 0a 70 6c 75 73 20 74 68 65 20 60   that.plus the `
0ef0: 72 75 6d 70 62 61 6b 65 60 20 63 6f 6d 6d 61 6e  rumpbake` comman
0f00: 64 20 74 6f 20 63 72 65 61 74 65 20 61 20 66 75  d to create a fu
0f10: 6c 6c 20 6b 65 72 6e 65 6c 20 69 6d 61 67 65 20  ll kernel image 
0f20: 77 68 69 63 68 20 69 73 20 74 68 65 6e 20 72 75  which is then ru
0f30: 6e 20 66 72 6f 6d 0a 77 69 74 68 69 6e 20 51 45  n from.within QE
0f40: 4d 55 2e 0a 0a 46 69 6e 61 6c 6c 79 2c 20 74 68  MU...Finally, th
0f50: 65 20 66 75 6e 20 70 61 72 74 2c 20 74 68 65 20  e fun part, the 
0f60: 42 53 44 73 2e 20 51 75 69 74 65 20 61 20 66 65  BSDs. Quite a fe
0f70: 77 20 68 6f 6f 70 73 20 61 72 65 20 6a 75 6d 70  w hoops are jump
0f80: 65 64 20 74 68 72 6f 75 67 68 20 74 6f 20 67 65  ed through to ge
0f90: 74 20 43 49 0a 77 6f 72 6b 69 6e 67 20 66 6f 72  t CI.working for
0fa0: 20 74 68 65 73 65 20 70 6c 61 74 66 6f 72 6d 73   these platforms
0fb0: 2c 20 62 75 74 20 74 68 65 20 67 69 73 74 20 6f  , but the gist o
0fc0: 66 20 69 74 20 6c 6f 6f 6b 73 20 6c 69 6b 65 3a  f it looks like:
0fd0: 0a 0a 2a 20 43 72 6f 73 73 20 63 6f 6d 70 69 6c  ..* Cross compil
0fe0: 69 6e 67 20 66 72 6f 6d 20 4c 69 6e 75 78 20 74  ing from Linux t
0ff0: 6f 20 61 6e 79 20 6f 66 20 74 68 65 20 42 53 44  o any of the BSD
1000: 73 20 73 65 65 6d 73 20 74 6f 20 62 65 20 71 75  s seems to be qu
1010: 69 74 65 20 6e 6f 6e 2d 73 74 61 6e 64 61 72 64  ite non-standard
1020: 2e 0a 20 20 57 65 20 6d 61 79 20 62 65 20 61 62  ..  We may be ab
1030: 6c 65 20 74 6f 20 67 65 74 20 69 74 20 77 6f 72  le to get it wor
1040: 6b 69 6e 67 20 62 75 74 20 69 74 20 6d 69 67 68  king but it migh
1050: 74 20 62 65 20 64 69 66 66 69 63 75 6c 74 20 61  t be difficult a
1060: 74 20 74 68 61 74 20 70 6f 69 6e 74 20 74 6f 0a  t that point to.
1070: 20 20 65 6e 73 75 72 65 20 74 68 61 74 20 74 68    ensure that th
1080: 65 20 6c 69 62 63 20 64 65 66 69 6e 69 74 69 6f  e libc definitio
1090: 6e 73 20 61 6c 69 67 6e 20 77 69 74 68 20 77 68  ns align with wh
10a0: 61 74 20 79 6f 75 27 64 20 67 65 74 20 6f 6e 20  at you'd get on 
10b0: 74 68 65 20 42 53 44 20 69 74 73 65 6c 66 2e 0a  the BSD itself..
10c0: 20 20 41 73 20 61 20 72 65 73 75 6c 74 2c 20 77    As a result, w
10d0: 65 20 74 72 79 20 74 6f 20 64 6f 20 63 6f 6d 70  e try to do comp
10e0: 69 6c 65 73 20 77 69 74 68 69 6e 20 74 68 65 20  iles within the 
10f0: 42 53 44 20 64 69 73 74 72 6f 2e 0a 2a 20 4f 6e  BSD distro..* On
1100: 20 54 72 61 76 69 73 20 77 65 20 63 61 6e 27 74   Travis we can't
1110: 20 72 75 6e 20 61 20 56 4d 2d 69 6e 2d 61 2d 56   run a VM-in-a-V
1120: 4d 2c 20 73 6f 20 77 65 20 72 65 73 6f 72 74 20  M, so we resort 
1130: 74 6f 20 75 73 65 72 73 70 61 63 65 20 65 6d 75  to userspace emu
1140: 6c 61 74 69 6f 6e 0a 20 20 28 51 45 4d 55 29 2e  lation.  (QEMU).
1150: 0a 2a 20 55 6e 66 6f 72 74 75 6e 61 74 65 6c 79  .* Unfortunately
1160: 20 6f 6e 20 54 72 61 76 69 73 20 77 65 20 61 6c   on Travis we al
1170: 73 6f 20 63 61 6e 27 74 20 75 73 65 20 4b 56 4d  so can't use KVM
1180: 2c 20 73 6f 20 74 68 65 20 65 6d 75 6c 61 74 69  , so the emulati
1190: 6f 6e 20 69 73 20 73 75 70 65 72 20 73 6c 6f 77  on is super slow
11a0: 2e 0a 0a 57 69 74 68 20 61 6c 6c 20 74 68 61 74  ...With all that
11b0: 20 69 6e 20 6d 69 6e 64 2c 20 74 68 65 20 77 61   in mind, the wa
11c0: 79 20 42 53 44 20 69 73 20 74 65 73 74 65 64 20  y BSD is tested 
11d0: 6c 6f 6f 6b 73 20 6c 69 6b 65 3a 0a 0a 31 2e 20  looks like:..1. 
11e0: 44 6f 77 6e 6c 6f 61 64 20 61 20 70 72 65 2d 70  Download a pre-p
11f0: 72 65 70 61 72 65 64 20 69 6d 61 67 65 20 66 6f  repared image fo
1200: 72 20 74 68 65 20 4f 53 20 62 65 69 6e 67 20 74  r the OS being t
1210: 65 73 74 65 64 2e 0a 32 2e 20 47 65 6e 65 72 61  ested..2. Genera
1220: 74 65 20 74 68 65 20 74 65 73 74 73 20 66 6f 72  te the tests for
1230: 20 74 68 65 20 4f 53 20 62 65 69 6e 67 20 74 65   the OS being te
1240: 73 74 65 64 2e 20 54 68 69 73 20 69 6e 76 6f 6c  sted. This invol
1250: 76 65 73 20 72 75 6e 6e 69 6e 67 20 74 68 65 20  ves running the 
1260: 60 63 74 65 73 74 60 0a 20 20 20 6c 69 62 72 61  `ctest`.   libra
1270: 72 79 20 6f 76 65 72 20 6c 69 62 63 20 74 6f 20  ry over libc to 
1280: 67 65 6e 65 72 61 74 65 20 61 20 52 75 73 74 20  generate a Rust 
1290: 66 69 6c 65 20 61 6e 64 20 61 20 43 20 66 69 6c  file and a C fil
12a0: 65 20 77 68 69 63 68 20 77 69 6c 6c 20 74 68 65  e which will the
12b0: 6e 20 62 65 0a 20 20 20 63 6f 6d 70 69 6c 65 64  n be.   compiled
12c0: 20 69 6e 74 6f 20 74 68 65 20 66 69 6e 61 6c 20   into the final 
12d0: 74 65 73 74 2e 0a 33 2e 20 47 65 6e 65 72 61 74  test..3. Generat
12e0: 65 20 61 20 64 69 73 6b 20 69 6d 61 67 65 20 77  e a disk image w
12f0: 68 69 63 68 20 77 69 6c 6c 20 6c 61 74 65 72 20  hich will later 
1300: 62 65 20 6d 6f 75 6e 74 65 64 20 62 79 20 74 68  be mounted by th
1310: 65 20 4f 53 20 62 65 69 6e 67 20 74 65 73 74 65  e OS being teste
1320: 64 2e 0a 20 20 20 54 68 69 73 20 69 6d 61 67 65  d..   This image
1330: 20 69 73 20 6d 6f 73 74 6c 79 20 6a 75 73 74 20   is mostly just 
1340: 74 68 65 20 6c 69 62 63 20 64 69 72 65 63 74 6f  the libc directo
1350: 72 79 2c 20 62 75 74 20 73 6f 6d 65 20 6d 6f 64  ry, but some mod
1360: 69 66 69 63 61 74 69 6f 6e 73 20 61 72 65 20 6d  ifications are m
1370: 61 64 65 0a 20 20 20 74 6f 20 63 6f 6d 70 69 6c  ade.   to compil
1380: 65 20 74 68 65 20 67 65 6e 65 72 61 74 65 64 20  e the generated 
1390: 66 69 6c 65 73 20 66 72 6f 6d 20 73 74 65 70 20  files from step 
13a0: 32 2e 0a 34 2e 20 54 68 65 20 6b 65 72 6e 65 6c  2..4. The kernel
13b0: 20 69 73 20 62 6f 6f 74 65 64 20 69 6e 20 51 45   is booted in QE
13c0: 4d 55 2c 20 61 6e 64 20 69 74 20 69 73 20 63 6f  MU, and it is co
13d0: 6e 66 69 67 75 72 65 64 20 74 6f 20 64 65 74 65  nfigured to dete
13e0: 63 74 20 74 68 65 20 6c 69 62 63 2d 74 65 73 74  ct the libc-test
13f0: 0a 20 20 20 69 6d 61 67 65 20 62 65 69 6e 67 20  .   image being 
1400: 61 76 61 69 6c 61 62 6c 65 2c 20 72 75 6e 20 74  available, run t
1410: 68 65 20 74 65 73 74 20 73 63 72 69 70 74 2c 20  he test script, 
1420: 61 6e 64 20 74 68 65 6e 20 73 68 75 74 20 64 6f  and then shut do
1430: 77 6e 20 61 66 74 65 72 77 61 72 64 73 2e 0a 35  wn afterwards..5
1440: 2e 20 4c 6f 6f 6b 20 66 6f 72 20 77 68 65 74 68  . Look for wheth
1450: 65 72 20 74 68 65 20 74 65 73 74 73 20 70 61 73  er the tests pas
1460: 73 65 64 20 69 6e 20 74 68 65 20 73 65 72 69 61  sed in the seria
1470: 6c 20 63 6f 6e 73 6f 6c 65 20 6f 75 74 70 75 74  l console output
1480: 20 6f 66 20 74 68 65 20 6b 65 72 6e 65 6c 2e 0a   of the kernel..
1490: 0a 54 68 65 72 65 27 73 20 73 6f 6d 65 20 70 72  .There's some pr
14a0: 65 74 74 79 20 73 70 65 63 69 66 69 63 20 69 6e  etty specific in
14b0: 73 74 72 75 63 74 69 6f 6e 73 20 66 6f 72 20 73  structions for s
14c0: 65 74 74 69 6e 67 20 75 70 20 65 61 63 68 20 69  etting up each i
14d0: 6d 61 67 65 20 28 64 65 74 61 69 6c 65 64 0a 62  mage (detailed.b
14e0: 65 6c 6f 77 29 2c 20 62 75 74 20 74 68 65 20 6d  elow), but the m
14f0: 61 69 6e 20 67 69 73 74 20 6f 66 20 74 68 69 73  ain gist of this
1500: 20 69 73 20 74 68 61 74 20 77 65 20 6d 75 73 74   is that we must
1510: 20 61 76 6f 69 64 20 61 20 76 61 6e 69 6c 6c 61   avoid a vanilla
1520: 20 60 63 61 72 67 6f 20 72 75 6e 60 0a 69 6e 73   `cargo run`.ins
1530: 69 64 65 20 6f 66 20 74 68 65 20 60 6c 69 62 63  ide of the `libc
1540: 2d 74 65 73 74 60 20 64 69 72 65 63 74 6f 72 79  -test` directory
1550: 20 28 77 68 69 63 68 20 69 73 20 77 68 61 74 20   (which is what 
1560: 69 74 27 73 20 69 6e 74 65 6e 64 65 64 20 66 6f  it's intended fo
1570: 72 29 20 62 65 63 61 75 73 65 0a 74 68 61 74 20  r) because.that 
1580: 77 6f 75 6c 64 20 63 6f 6d 70 69 6c 65 20 60 73  would compile `s
1590: 79 6e 74 65 78 5f 73 79 6e 74 61 78 60 2c 20 61  yntex_syntax`, a
15a0: 20 6c 61 72 67 65 20 6c 69 62 72 61 72 79 2c 20   large library, 
15b0: 77 69 74 68 20 75 73 65 72 73 70 61 63 65 20 65  with userspace e
15c0: 6d 75 6c 61 74 69 6f 6e 2e 0a 54 68 69 73 20 69  mulation..This i
15d0: 6e 76 61 72 69 61 62 6c 79 20 74 69 6d 65 73 20  nvariably times 
15e0: 6f 75 74 20 6f 6e 20 54 72 61 76 69 73 2c 20 73  out on Travis, s
15f0: 6f 20 77 65 20 63 61 6e 27 74 20 64 6f 20 74 68  o we can't do th
1600: 61 74 2e 0a 0a 4f 6e 63 65 20 61 6c 6c 20 74 68  at...Once all th
1610: 6f 73 65 20 68 6f 6f 70 73 20 61 72 65 20 6a 75  ose hoops are ju
1620: 6d 70 65 64 20 74 68 72 6f 75 67 68 2c 20 68 6f  mped through, ho
1630: 77 65 76 65 72 2c 20 77 65 20 63 61 6e 20 62 65  wever, we can be
1640: 20 68 61 70 70 79 20 74 68 61 74 20 77 65 27 72   happy that we'r
1650: 65 0a 74 65 73 74 69 6e 67 20 61 6c 6d 6f 73 74  e.testing almost
1660: 20 65 76 65 72 79 74 68 69 6e 67 21 0a 0a 42 65   everything!..Be
1670: 6c 6f 77 20 61 72 65 20 73 6f 6d 65 20 64 65 74  low are some det
1680: 61 69 6c 73 20 6f 66 20 68 6f 77 20 74 6f 20 73  ails of how to s
1690: 65 74 20 75 70 20 74 68 65 20 69 6e 69 74 69 61  et up the initia
16a0: 6c 20 4f 53 20 69 6d 61 67 65 73 20 77 68 69 63  l OS images whic
16b0: 68 20 61 72 65 0a 64 6f 77 6e 6c 6f 61 64 65 64  h are.downloaded
16c0: 2e 20 45 61 63 68 20 69 6d 61 67 65 20 6d 75 73  . Each image mus
16d0: 74 20 62 65 20 65 6e 61 62 6c 65 64 20 68 61 76  t be enabled hav
16e0: 65 20 69 6e 70 75 74 2f 6f 75 74 70 75 74 20 6f  e input/output o
16f0: 76 65 72 20 74 68 65 20 73 65 72 69 61 6c 0a 63  ver the serial.c
1700: 6f 6e 73 6f 6c 65 2c 20 6c 6f 67 20 69 6e 20 61  onsole, log in a
1710: 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 61 74 20  utomatically at 
1720: 74 68 65 20 73 65 72 69 61 6c 20 63 6f 6e 73 6f  the serial conso
1730: 6c 65 2c 20 64 65 74 65 63 74 20 69 66 20 61 20  le, detect if a 
1740: 73 65 63 6f 6e 64 20 64 72 69 76 65 20 69 6e 0a  second drive in.
1750: 51 45 4d 55 20 69 73 20 61 76 61 69 6c 61 62 6c  QEMU is availabl
1760: 65 2c 20 61 6e 64 20 69 66 20 73 6f 20 6d 6f 75  e, and if so mou
1770: 6e 74 20 69 74 2c 20 72 75 6e 20 61 20 73 63 72  nt it, run a scr
1780: 69 70 74 20 28 69 74 27 6c 6c 20 73 70 65 63 69  ipt (it'll speci
1790: 66 69 63 61 6c 6c 79 20 62 65 0a 60 72 75 6e 2d  fically be.`run-
17a0: 71 65 6d 75 2e 73 68 60 20 69 6e 20 74 68 69 73  qemu.sh` in this
17b0: 20 66 6f 6c 64 65 72 20 77 68 69 63 68 20 69 73   folder which is
17c0: 20 63 6f 70 69 65 64 20 69 6e 74 6f 20 74 68 65   copied into the
17d0: 20 67 65 6e 65 72 61 74 65 64 20 69 6d 61 67 65   generated image
17e0: 20 74 61 6c 6b 65 64 0a 61 62 6f 75 74 20 61 62   talked.about ab
17f0: 6f 76 65 29 2c 20 61 6e 64 20 74 68 65 6e 20 73  ove), and then s
1800: 68 75 74 20 64 6f 77 6e 2e 0a 0a 23 23 23 20 51  hut down...### Q
1810: 45 4d 55 20 73 65 74 75 70 20 2d 20 46 72 65 65  EMU setup - Free
1820: 42 53 44 0a 0a 31 2e 20 44 6f 77 6e 6c 6f 61 64  BSD..1. Download
1830: 20 43 44 20 69 6e 73 74 61 6c 6c 65 72 20 28 6d   CD installer (m
1840: 6f 73 74 20 6d 69 6e 69 6d 61 6c 20 69 73 20 66  ost minimal is f
1850: 69 6e 65 29 0a 32 2e 20 60 71 65 6d 75 2d 69 6d  ine).2. `qemu-im
1860: 67 20 63 72 65 61 74 65 20 2d 66 20 71 63 6f 77  g create -f qcow
1870: 32 20 66 6f 6f 2e 71 63 6f 77 32 20 32 47 60 0a  2 foo.qcow2 2G`.
1880: 33 2e 20 60 71 65 6d 75 20 2d 63 64 72 6f 6d 20  3. `qemu -cdrom 
1890: 66 6f 6f 2e 69 73 6f 20 2d 64 72 69 76 65 20 69  foo.iso -drive i
18a0: 66 3d 76 69 72 74 69 6f 2c 66 69 6c 65 3d 66 6f  f=virtio,file=fo
18b0: 6f 2e 71 63 6f 77 32 20 2d 6e 65 74 20 6e 69 63  o.qcow2 -net nic
18c0: 2c 6d 6f 64 65 6c 3d 76 69 72 74 69 6f 20 2d 6e  ,model=virtio -n
18d0: 65 74 20 75 73 65 72 60 0a 34 2e 20 72 75 6e 20  et user`.4. run 
18e0: 69 6e 73 74 61 6c 6c 65 72 0a 35 2e 20 60 65 63  installer.5. `ec
18f0: 68 6f 20 27 63 6f 6e 73 6f 6c 65 3d 22 63 6f 6d  ho 'console="com
1900: 63 6f 6e 73 6f 6c 65 22 27 20 3e 3e 20 2f 62 6f  console"' >> /bo
1910: 6f 74 2f 6c 6f 61 64 65 72 2e 63 6f 6e 66 60 0a  ot/loader.conf`.
1920: 36 2e 20 60 65 63 68 6f 20 27 61 75 74 6f 62 6f  6. `echo 'autobo
1930: 6f 74 5f 64 65 6c 61 79 3d 22 30 22 27 20 3e 3e  ot_delay="0"' >>
1940: 20 2f 62 6f 6f 74 2f 6c 6f 61 64 65 72 2e 63 6f   /boot/loader.co
1950: 6e 66 60 0a 37 2e 20 6c 6f 6f 6b 20 61 74 20 2f  nf`.7. look at /
1960: 65 74 63 2f 74 74 79 73 2c 20 73 65 65 20 77 68  etc/ttys, see wh
1970: 61 74 20 67 65 74 74 79 20 61 72 67 75 6d 65 6e  at getty argumen
1980: 74 20 69 73 20 66 6f 72 20 74 74 79 75 30 0a 38  t is for ttyu0.8
1990: 2e 20 65 64 69 74 20 2f 65 74 63 2f 67 65 74 74  . edit /etc/gett
19a0: 79 74 61 62 2c 20 6c 6f 6f 6b 20 66 6f 72 20 74  ytab, look for t
19b0: 74 79 75 30 20 61 72 67 75 6d 65 6e 74 2c 20 70  tyu0 argument, p
19c0: 72 65 70 65 6e 64 20 60 3a 61 6c 3d 72 6f 6f 74  repend `:al=root
19d0: 60 20 74 6f 20 6c 69 6e 65 0a 20 20 20 62 65 6e  ` to line.   ben
19e0: 65 61 74 68 0a 0a 28 6e 6f 74 65 20 74 68 61 74  eath..(note that
19f0: 20 74 68 65 20 63 75 72 72 65 6e 74 20 69 6d 61   the current ima
1a00: 67 65 20 68 61 73 20 61 20 60 66 72 65 65 62 73  ge has a `freebs
1a10: 64 60 20 75 73 65 72 2c 20 62 75 74 20 74 68 69  d` user, but thi
1a20: 73 20 69 73 6e 27 74 20 72 65 61 6c 6c 79 0a 6e  s isn't really.n
1a30: 65 63 65 73 73 61 72 79 29 0a 0a 4f 6e 63 65 20  ecessary)..Once 
1a40: 74 68 61 74 27 73 20 64 6f 6e 65 2c 20 61 72 72  that's done, arr
1a50: 61 6e 67 65 20 66 6f 72 20 74 68 69 73 20 73 63  ange for this sc
1a60: 72 69 70 74 20 74 6f 20 72 75 6e 20 61 74 20 6c  ript to run at l
1a70: 6f 67 69 6e 3a 0a 0a 60 60 60 0a 23 21 2f 62 69  ogin:..```.#!/bi
1a80: 6e 2f 73 68 0a 0a 73 75 64 6f 20 6b 6c 64 6c 6f  n/sh..sudo kldlo
1a90: 61 64 20 65 78 74 32 66 73 0a 5b 20 2d 65 20 2f  ad ext2fs.[ -e /
1aa0: 64 65 76 2f 76 74 62 64 31 20 5d 20 7c 7c 20 65  dev/vtbd1 ] || e
1ab0: 78 69 74 20 30 0a 73 75 64 6f 20 6d 6f 75 6e 74  xit 0.sudo mount
1ac0: 20 2d 74 20 65 78 74 32 66 73 20 2f 64 65 76 2f   -t ext2fs /dev/
1ad0: 76 74 62 64 31 20 2f 6d 6e 74 0a 73 68 20 2f 6d  vtbd1 /mnt.sh /m
1ae0: 6e 74 2f 72 75 6e 2e 73 68 20 2f 6d 6e 74 0a 73  nt/run.sh /mnt.s
1af0: 75 64 6f 20 70 6f 77 65 72 6f 66 66 0a 60 60 60  udo poweroff.```
1b00: 0a 0a 48 65 6c 70 66 75 6c 20 6c 69 6e 6b 73 0a  ..Helpful links.
1b10: 0a 2a 20 68 74 74 70 73 3a 2f 2f 65 6e 2e 77 69  .* https://en.wi
1b20: 6b 69 62 6f 6f 6b 73 2e 6f 72 67 2f 77 69 6b 69  kibooks.org/wiki
1b30: 2f 51 45 4d 55 2f 49 6d 61 67 65 73 0a 2a 20 68  /QEMU/Images.* h
1b40: 74 74 70 73 3a 2f 2f 62 6c 6f 67 2e 6e 65 6b 6f  ttps://blog.neko
1b50: 63 6f 6e 65 6b 6f 2e 6e 6c 2f 62 6c 6f 67 2f 32  coneko.nl/blog/2
1b60: 30 31 35 2f 30 36 2f 30 34 2f 63 72 65 61 74 69  015/06/04/creati
1b70: 6e 67 2d 61 6e 2d 6f 70 65 6e 73 74 61 63 6b 2d  ng-an-openstack-
1b80: 66 72 65 65 62 73 64 2d 69 6d 61 67 65 2e 68 74  freebsd-image.ht
1b90: 6d 6c 0a 2a 20 68 74 74 70 73 3a 2f 2f 77 77 77  ml.* https://www
1ba0: 2e 66 72 65 65 62 73 64 2e 6f 72 67 2f 64 6f 63  .freebsd.org/doc
1bb0: 2f 68 61 6e 64 62 6f 6f 6b 2f 73 65 72 69 61 6c  /handbook/serial
1bc0: 63 6f 6e 73 6f 6c 65 2d 73 65 74 75 70 2e 68 74  console-setup.ht
1bd0: 6d 6c 0a 0a 0a 23 23 23 20 51 45 4d 55 20 73 65  ml...### QEMU se
1be0: 74 75 70 20 2d 20 4f 70 65 6e 42 53 44 0a 0a 31  tup - OpenBSD..1
1bf0: 2e 20 44 6f 77 6e 6c 6f 61 64 20 43 44 20 69 6e  . Download CD in
1c00: 73 74 61 6c 6c 65 72 0a 32 2e 20 60 71 65 6d 75  staller.2. `qemu
1c10: 2d 69 6d 67 20 63 72 65 61 74 65 20 2d 66 20 71  -img create -f q
1c20: 63 6f 77 32 20 66 6f 6f 2e 71 63 6f 77 32 20 32  cow2 foo.qcow2 2
1c30: 47 60 0a 33 2e 20 60 71 65 6d 75 20 2d 63 64 72  G`.3. `qemu -cdr
1c40: 6f 6d 20 66 6f 6f 2e 69 73 6f 20 2d 64 72 69 76  om foo.iso -driv
1c50: 65 20 69 66 3d 76 69 72 74 69 6f 2c 66 69 6c 65  e if=virtio,file
1c60: 3d 66 6f 6f 2e 71 63 6f 77 32 20 2d 6e 65 74 20  =foo.qcow2 -net 
1c70: 6e 69 63 2c 6d 6f 64 65 6c 3d 76 69 72 74 69 6f  nic,model=virtio
1c80: 20 2d 6e 65 74 20 75 73 65 72 60 0a 34 2e 20 72   -net user`.4. r
1c90: 75 6e 20 69 6e 73 74 61 6c 6c 65 72 0a 35 2e 20  un installer.5. 
1ca0: 60 65 63 68 6f 20 27 73 65 74 20 74 74 79 20 63  `echo 'set tty c
1cb0: 6f 6d 30 27 20 3e 3e 20 2f 65 74 63 2f 62 6f 6f  om0' >> /etc/boo
1cc0: 74 2e 63 6f 6e 66 60 0a 36 2e 20 60 65 63 68 6f  t.conf`.6. `echo
1cd0: 20 27 62 6f 6f 74 27 20 3e 3e 20 2f 65 74 63 2f   'boot' >> /etc/
1ce0: 62 6f 6f 74 2e 63 6f 6e 66 60 0a 37 2e 20 4d 6f  boot.conf`.7. Mo
1cf0: 64 69 66 79 20 2f 65 74 63 2f 74 74 79 73 2c 20  dify /etc/ttys, 
1d00: 63 68 61 6e 67 65 20 74 68 65 20 60 74 74 79 30  change the `tty0
1d10: 30 60 20 61 74 20 74 68 65 20 65 6e 64 20 66 72  0` at the end fr
1d20: 6f 6d 20 27 75 6e 6b 6e 6f 77 6e 20 6f 66 66 27  om 'unknown off'
1d30: 20 74 6f 0a 20 20 20 27 76 74 32 32 30 20 6f 6e   to.   'vt220 on
1d40: 20 73 65 63 75 72 65 27 0a 38 2e 20 4d 6f 64 69   secure'.8. Modi
1d50: 66 79 20 73 61 6d 65 20 6c 69 6e 65 20 69 6e 20  fy same line in 
1d60: 2f 65 74 63 2f 74 74 79 73 20 74 6f 20 68 61 76  /etc/ttys to hav
1d70: 65 20 60 22 2f 72 6f 6f 74 2f 66 6f 6f 2e 73 68  e `"/root/foo.sh
1d80: 22 60 20 61 73 20 74 68 65 20 73 68 65 6c 6c 0a  "` as the shell.
1d90: 39 2e 20 41 64 64 20 74 68 69 73 20 73 63 72 69  9. Add this scri
1da0: 70 74 20 74 6f 20 60 2f 72 6f 6f 74 2f 66 6f 6f  pt to `/root/foo
1db0: 2e 73 68 60 0a 0a 60 60 60 0a 23 21 2f 62 69 6e  .sh`..```.#!/bin
1dc0: 2f 73 68 0a 65 78 65 63 20 31 3e 2f 64 65 76 2f  /sh.exec 1>/dev/
1dd0: 74 74 79 30 30 0a 65 78 65 63 20 32 3e 26 31 0a  tty00.exec 2>&1.
1de0: 0a 69 66 20 6d 6f 75 6e 74 20 2d 74 20 65 78 74  .if mount -t ext
1df0: 32 66 73 20 2f 64 65 76 2f 73 64 31 63 20 2f 6d  2fs /dev/sd1c /m
1e00: 6e 74 3b 20 74 68 65 6e 0a 20 20 73 68 20 2f 6d  nt; then.  sh /m
1e10: 6e 74 2f 72 75 6e 2e 73 68 20 2f 6d 6e 74 0a 20  nt/run.sh /mnt. 
1e20: 20 73 68 75 74 64 6f 77 6e 20 2d 70 68 20 6e 6f   shutdown -ph no
1e30: 77 0a 66 69 0a 0a 23 20 6c 69 6d 69 74 65 64 20  w.fi..# limited 
1e40: 73 68 65 6c 6c 2e 2e 2e 0a 65 78 65 63 20 2f 62  shell....exec /b
1e50: 69 6e 2f 73 68 20 3c 20 2f 64 65 76 2f 74 74 79  in/sh < /dev/tty
1e60: 30 30 0a 60 60 60 0a 0a 31 30 2e 20 60 63 68 6d  00.```..10. `chm
1e70: 6f 64 20 2b 78 20 2f 72 6f 6f 74 2f 66 6f 6f 2e  od +x /root/foo.
1e80: 73 68 60 0a 0a 48 65 6c 70 66 75 6c 20 6c 69 6e  sh`..Helpful lin
1e90: 6b 73 3a 0a 0a 2a 20 68 74 74 70 73 3a 2f 2f 65  ks:..* https://e
1ea0: 6e 2e 77 69 6b 69 62 6f 6f 6b 73 2e 6f 72 67 2f  n.wikibooks.org/
1eb0: 77 69 6b 69 2f 51 45 4d 55 2f 49 6d 61 67 65 73  wiki/QEMU/Images
1ec0: 0a 2a 20 68 74 74 70 3a 2f 2f 77 77 77 2e 6f 70  .* http://www.op
1ed0: 65 6e 62 73 64 2e 6f 72 67 2f 66 61 71 2f 66 61  enbsd.org/faq/fa
1ee0: 71 37 2e 68 74 6d 6c 23 53 65 72 43 6f 6e 0a 0a  q7.html#SerCon..
1ef0: 23 20 51 75 65 73 74 69 6f 6e 73 3f 0a 0a 48 6f  # Questions?..Ho
1f00: 70 65 66 75 6c 6c 79 20 74 68 61 74 27 73 20 61  pefully that's a
1f10: 74 20 6c 65 61 73 74 20 73 6f 6d 65 77 68 61 74  t least somewhat
1f20: 20 6f 66 20 61 6e 20 69 6e 74 72 6f 64 75 63 74   of an introduct
1f30: 69 6f 6e 20 74 6f 20 65 76 65 72 79 74 68 69 6e  ion to everythin
1f40: 67 20 67 6f 69 6e 67 20 6f 6e 0a 68 65 72 65 2c  g going on.here,
1f50: 20 61 6e 64 20 66 65 65 6c 20 66 72 65 65 20 74   and feel free t
1f60: 6f 20 70 69 6e 67 20 40 61 6c 65 78 63 72 69 63  o ping @alexcric
1f70: 68 74 6f 6e 20 77 69 74 68 20 71 75 65 73 74 69  hton with questi
1f80: 6f 6e 73 21 0a 0a                                ons!..