PiDP-8/I Software

Hex Artifact Content
Log In

Artifact a13acbc33e4dac03379b8dcdd88174d034b7dc90:

Wiki page [How to Run a Naked PiDP-8/I] by tangent 2019-05-18 20:37:44.
0000: 44 20 32 30 31 39 2d 30 35 2d 31 38 54 32 30 3a  D 2019-05-18T20:
0010: 33 37 3a 34 34 2e 36 32 33 0a 4c 20 48 6f 77 5c  37:44.623.L How\
0020: 73 74 6f 5c 73 52 75 6e 5c 73 61 5c 73 4e 61 6b  sto\sRun\sa\sNak
0030: 65 64 5c 73 50 69 44 50 2d 38 2f 49 0a 4e 20 74  ed\sPiDP-8/I.N t
0040: 65 78 74 2f 78 2d 6d 61 72 6b 64 6f 77 6e 0a 50  ext/x-markdown.P
0050: 20 35 62 36 32 32 61 34 32 66 30 64 38 64 64 38   5b622a42f0d8dd8
0060: 36 62 34 33 66 62 31 35 62 35 34 35 30 62 62 31  6b43fb15b5450bb1
0070: 64 31 39 33 33 37 35 66 39 0a 55 20 74 61 6e 67  d193375f9.U tang
0080: 65 6e 74 0a 57 20 34 33 37 37 0a 23 20 54 68 65  ent.W 4377.# The
0090: 20 53 69 74 75 61 74 69 6f 6e 0d 0a 0d 0a 3e 20   Situation....> 
00a0: 22 54 68 65 20 53 20 69 6e 20 49 6f 54 20 73 74  "The S in IoT st
00b0: 61 6e 64 73 20 66 6f 72 20 53 65 63 75 72 69 74  ands for Securit
00c0: 79 2e 22 20 e2 80 94 20 5b 54 56 53 20 62 6c 6f  y." — [TVS blo
00d0: 67 5d 5b 74 76 73 5d 0d 0a 0d 0a 54 68 65 20 50  g][tvs]....The P
00e0: 69 44 50 2d 38 2f 49 20 62 69 6e 61 72 79 20 4f  iDP-8/I binary O
00f0: 53 20 69 6d 61 67 65 73 20 73 68 69 70 70 65 64  S images shipped
0100: 20 66 72 6f 6d 20 5b 74 68 69 73 20 73 69 74 65   from [this site
0110: 5d 5b 73 69 74 65 5d 20 61 72 65 20 66 61 69 72  ][site] are fair
0120: 6c 79 20 77 65 6c 6c 20 6c 6f 63 6b 65 64 20 64  ly well locked d
0130: 6f 77 6e 2e 20 54 68 65 79 20 73 68 69 70 20 77  own. They ship w
0140: 69 74 68 20 74 68 65 20 6e 6f 72 6d 61 6c 20 52  ith the normal R
0150: 61 73 70 62 69 61 6e 20 64 65 66 61 75 6c 74 20  aspbian default 
0160: 75 73 65 72 20 6e 61 6d 65 20 63 68 61 6e 67 65  user name change
0170: 64 20 74 6f 20 61 6e 20 75 6e 63 6f 6d 6d 6f 6e  d to an uncommon
0180: 20 6e 61 6d 65 2c 20 74 68 61 74 20 75 73 65 72   name, that user
0190: 20 68 61 73 20 61 20 76 65 72 79 20 73 74 72 6f   has a very stro
01a0: 6e 67 20 64 65 66 61 75 6c 74 20 70 61 73 73 77  ng default passw
01b0: 6f 72 64 20 77 68 69 63 68 20 79 6f 75 20 61 72  ord which you ar
01c0: 65 20 66 6f 72 63 65 64 20 74 6f 20 63 68 61 6e  e forced to chan
01d0: 67 65 20 6f 6e 20 66 69 72 73 74 20 6c 6f 67 69  ge on first logi
01e0: 6e 20 74 6f 20 73 6f 6d 65 74 68 69 6e 67 20 64  n to something d
01f0: 69 66 66 65 72 65 6e 74 2c 20 74 68 65 20 4f 53  ifferent, the OS
0200: 20 77 6f 6e 27 74 20 61 63 63 65 70 74 20 61 20   won't accept a 
0210: 77 65 61 6b 20 70 61 73 73 77 6f 72 64 20 62 79  weak password by
0220: 20 64 65 66 61 75 6c 74 2c 20 61 6e 64 20 74 68   default, and th
0230: 65 72 65 20 61 72 65 20 6e 6f 20 6e 65 74 77 6f  ere are no netwo
0240: 72 6b 65 64 20 73 65 72 76 69 63 65 73 20 72 75  rked services ru
0250: 6e 6e 69 6e 67 2e 0d 0a 0d 0a 28 4f 70 65 6e 53  nning.....(OpenS
0260: 53 48 20 6d 75 73 74 20 62 65 20 5b 6d 61 6e 75  SH must be [manu
0270: 61 6c 6c 79 20 72 65 61 77 61 6b 65 6e 65 64 5d  ally reawakened]
0280: 5b 73 73 68 64 5d 20 61 66 74 65 72 20 69 6e 73  [sshd] after ins
0290: 74 61 6c 6c 61 74 69 6f 6e 2c 20 61 6e 64 2c 20  tallation, and, 
02a0: 6f 6e 63 65 20 64 6f 6e 65 2c 20 74 68 65 20 64  once done, the d
02b0: 65 66 61 75 6c 74 20 63 6f 6e 66 69 67 75 72 61  efault configura
02c0: 74 69 6f 6e 20 6f 6e 20 52 61 73 70 62 69 61 6e  tion on Raspbian
02d0: 20 69 73 20 71 75 69 74 65 20 73 65 63 75 72 65   is quite secure
02e0: 2e 29 0d 0a 0d 0a 59 65 74 2c 20 73 6f 6d 65 20  .)....Yet, some 
02f0: 70 65 6f 70 6c 65 20 77 61 6e 74 20 74 68 65 69  people want thei
0300: 72 20 50 69 44 50 2d 38 2f 49 20 74 6f 20 6a 75  r PiDP-8/I to ju
0310: 73 74 20 62 65 20 61 6e 20 61 70 70 6c 69 61 6e  st be an applian
0320: 63 65 3a 20 74 68 65 79 20 77 61 6e 74 20 69 74  ce: they want it
0330: 20 74 6f 20 74 75 72 6e 20 6f 6e 20 61 6e 64 20   to turn on and 
0340: 72 75 6e 20 74 68 65 20 50 44 50 2d 38 20 73 69  run the PDP-8 si
0350: 6d 75 6c 61 74 6f 72 3a 20 6e 6f 20 75 73 65 72  mulator: no user
0360: 20 6e 61 6d 65 73 2c 20 6e 6f 20 70 61 73 73 77   names, no passw
0370: 6f 72 64 73 2e 20 49 20 72 65 73 69 73 74 20 73  ords. I resist s
0380: 68 69 70 70 69 6e 67 20 4f 53 20 69 6d 61 67 65  hipping OS image
0390: 73 20 63 6f 6e 66 69 67 75 72 65 64 20 74 68 69  s configured thi
03a0: 73 20 77 61 79 20 62 65 63 61 75 73 65 20 52 61  s way because Ra
03b0: 73 70 62 69 61 6e 20 69 73 20 61 20 66 75 6c 6c  spbian is a full
03c0: 2d 66 65 61 74 75 72 65 64 20 6f 70 65 72 61 74  -featured operat
03d0: 69 6e 67 20 73 79 73 74 65 6d 2e 20 57 68 65 6e  ing system. When
03e0: 20 6e 65 74 77 6f 72 6b 65 64 2c 20 69 74 20 69   networked, it i
03f0: 73 20 63 61 70 61 62 6c 65 20 6f 66 20 62 65 69  s capable of bei
0400: 6e 67 20 61 20 70 6f 77 65 72 66 75 6c 20 69 73  ng a powerful is
0410: 6c 61 6e 64 20 66 6f 72 20 61 6e 20 61 74 74 61  land for an atta
0420: 63 6b 65 72 20 6f 6e 20 74 68 65 20 6e 65 74 77  cker on the netw
0430: 6f 72 6b 2e 20 45 76 65 6e 20 73 6f 6d 65 20 6f  ork. Even some o
0440: 66 20 74 68 65 20 6d 6f 73 74 20 68 65 61 76 69  f the most heavi
0450: 6c 79 2d 70 72 6f 74 65 63 74 65 64 20 77 65 62  ly-protected web
0460: 20 73 65 72 76 69 63 65 73 20 68 61 76 65 20 62   services have b
0470: 65 65 6e 20 74 61 6b 65 6e 20 64 6f 77 6e 20 62  een taken down b
0480: 79 20 73 6d 61 6c 6c 20 61 72 6d 69 65 73 20 6f  y small armies o
0490: 66 20 6c 65 73 73 65 72 20 73 79 73 74 65 6d 73  f lesser systems
04a0: 20 e2 80 94 20 73 75 63 68 20 61 73 20 6e 65 74   — such as net
04b0: 77 6f 72 6b 65 64 20 2a 70 72 69 6e 74 65 72 73  worked *printers
04c0: 2a 20 e2 80 94 20 70 6f 75 6e 64 69 6e 67 20 6f  * — pounding o
04d0: 6e 20 74 68 65 6d 20 69 6e 20 63 6f 6e 63 65 72  n them in concer
04e0: 74 2e 0d 0a 0d 0a 49 20 72 65 66 75 73 65 20 74  t.....I refuse t
04f0: 6f 20 62 75 69 6c 64 20 4f 53 20 69 6d 61 67 65  o build OS image
0500: 73 20 74 68 61 74 20 63 6f 6e 74 72 69 62 75 74  s that contribut
0510: 65 20 74 6f 20 74 68 69 73 20 70 72 6f 62 6c 65  e to this proble
0520: 6d 2e 0d 0a 0d 0a 49 20 61 6c 73 6f 20 64 6f 20  m.....I also do 
0530: 6e 6f 74 20 62 65 6c 69 65 76 65 20 69 6e 20 72  not believe in r
0540: 65 73 74 72 69 63 74 69 6e 67 20 61 63 63 65 73  estricting acces
0550: 73 20 74 6f 20 74 65 63 68 6e 69 63 61 6c 20 69  s to technical i
0560: 6e 66 6f 72 6d 61 74 69 6f 6e 2c 20 65 76 65 6e  nformation, even
0570: 20 77 68 65 6e 20 6d 61 6b 69 6e 67 20 75 73 65   when making use
0580: 20 6f 66 20 74 68 61 74 20 69 6e 66 6f 72 6d 61   of that informa
0590: 74 69 6f 6e 20 69 73 20 68 69 67 68 6c 79 20 69  tion is highly i
05a0: 6e 61 64 76 69 73 61 62 6c 65 2c 20 73 6f 20 69  nadvisable, so i
05b0: 6e 20 74 68 61 74 20 73 70 69 72 69 74 2c 20 49  n that spirit, I
05c0: 20 77 69 6c 6c 20 73 68 6f 72 74 6c 79 20 64 65   will shortly de
05d0: 73 63 72 69 62 65 20 68 6f 77 20 74 6f 20 64 69  scribe how to di
05e0: 73 63 61 72 64 20 74 68 65 20 70 72 6f 76 69 64  scard the provid
05f0: 65 64 20 73 65 63 75 72 69 74 79 20 70 72 6f 76  ed security prov
0600: 69 73 69 6f 6e 73 2e 0d 0a 0d 0a 42 65 66 6f 72  isions.....Befor
0610: 65 20 49 20 67 65 74 20 74 6f 20 74 68 61 74 2c  e I get to that,
0620: 20 79 6f 75 20 6d 61 79 20 77 61 6e 74 20 74 6f   you may want to
0630: 20 63 6f 6e 73 69 64 65 72 20 75 73 69 6e 67 20   consider using 
0640: 74 68 65 20 5b 73 65 72 69 61 6c 20 6f 72 20 54  the [serial or T
0650: 65 6c 6e 65 74 20 63 6f 6e 73 6f 6c 65 20 6f 70  elnet console op
0660: 74 69 6f 6e 73 5d 5b 73 74 63 6f 5d 20 69 6e 73  tions][stco] ins
0670: 74 65 61 64 2e 20 54 68 6f 73 65 20 6d 65 74 68  tead. Those meth
0680: 6f 64 73 20 68 61 76 65 20 66 65 77 65 72 20 73  ods have fewer s
0690: 65 63 75 72 69 74 79 20 70 72 6f 62 6c 65 6d 73  ecurity problems
06a0: 2c 20 79 65 74 20 61 63 68 69 65 76 65 20 6d 75  , yet achieve mu
06b0: 63 68 20 74 68 65 20 73 61 6d 65 20 65 6e 64 2e  ch the same end.
06c0: 0d 0a 0d 0a 5b 73 73 68 64 5d 3a 20 2f 64 6f 63  ....[sshd]: /doc
06d0: 2f 74 72 75 6e 6b 2f 52 45 41 44 4d 45 2e 6d 64  /trunk/README.md
06e0: 23 73 73 68 64 0d 0a 5b 73 74 63 6f 5d 3a 20 2f  #sshd..[stco]: /
06f0: 77 69 6b 69 3f 6e 61 6d 65 3d 53 65 72 69 61 6c  wiki?name=Serial
0700: 2b 6f 72 2b 54 65 6c 6e 65 74 2b 50 44 50 2d 38  +or+Telnet+PDP-8
0710: 2b 43 6f 6e 73 6f 6c 65 0d 0a 0d 0a 0d 0a 23 23  +Console......##
0720: 20 47 65 74 74 69 6e 67 20 52 69 64 20 6f 66 20   Getting Rid of 
0730: 74 68 65 20 4c 6f 67 69 6e 20 50 72 6f 6d 70 74  the Login Prompt
0740: 0d 0a 0d 0a 54 68 65 20 66 69 72 73 74 20 74 68  ....The first th
0750: 69 6e 67 20 79 6f 75 20 68 61 76 65 20 74 6f 20  ing you have to 
0760: 64 6f 20 6f 6e 20 6c 6f 67 67 69 6e 67 20 69 6e  do on logging in
0770: 20 69 73 20 63 68 61 6e 67 65 20 79 6f 75 72 20   is change your 
0780: 75 73 65 72 20 6e 61 6d 65 20 62 61 63 6b 20 66  user name back f
0790: 72 6f 6d 20 60 70 69 64 70 38 69 60 20 74 6f 20  rom `pidp8i` to 
07a0: 60 70 69 60 2c 20 62 65 63 61 75 73 65 20 73 6f  `pi`, because so
07b0: 6d 65 20 63 68 61 6e 67 65 73 20 77 65 20 77 69  me changes we wi
07c0: 6c 6c 20 6d 61 6b 65 20 62 65 6c 6f 77 20 6f 6e  ll make below on
07d0: 6c 79 20 77 6f 72 6b 20 70 72 6f 70 65 72 6c 79  ly work properly
07e0: 20 77 69 74 68 20 75 73 65 72 20 60 70 69 60 20   with user `pi` 
07f0: 64 75 65 20 74 6f 20 68 61 72 64 2d 63 6f 64 65  due to hard-code
0800: 64 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20  d configuration 
0810: 66 69 6c 65 73 20 69 6e 20 74 68 65 20 73 74 6f  files in the sto
0820: 63 6b 20 4f 53 2e 0d 0a 0d 0a 47 69 76 65 20 74  ck OS.....Give t
0830: 68 65 73 65 20 63 6f 6d 6d 61 6e 64 73 2c 20 62  hese commands, b
0840: 65 69 6e 67 20 2a 76 65 72 79 20 63 61 72 65 66  eing *very caref
0850: 75 6c 2a 20 68 6f 77 20 79 6f 75 20 74 79 70 65  ul* how you type
0860: 20 74 68 65 6d 2c 20 62 65 63 61 75 73 65 20 79   them, because y
0870: 6f 75 20 63 61 6e 20 6c 6f 63 6b 20 79 6f 75 72  ou can lock your
0880: 73 65 6c 66 20 6f 75 74 20 6f 66 20 74 68 65 20  self out of the 
0890: 73 79 73 74 65 6d 20 69 66 20 79 6f 75 20 66 61  system if you fa
08a0: 74 2d 66 69 6e 67 65 72 20 74 68 65 6d 3a 0d 0a  t-finger them:..
08b0: 0d 0a 20 20 20 20 24 20 65 78 65 63 20 73 75 64  ..    $ exec sud
08c0: 6f 20 2d 69 0d 0a 20 20 20 20 23 20 73 79 73 74  o -i..    # syst
08d0: 65 6d 63 74 6c 20 73 74 6f 70 20 70 69 64 70 38  emctl stop pidp8
08e0: 69 0d 0a 20 20 20 20 23 20 6b 69 6c 6c 61 6c 6c  i..    # killall
08f0: 20 2d 75 20 70 69 64 70 38 69 20 2d 39 0d 0a 20   -u pidp8i -9.. 
0900: 20 20 20 23 20 75 73 65 72 6d 6f 64 20 2d 6c 20     # usermod -l 
0910: 70 69 20 2d 64 20 2f 68 6f 6d 65 2f 70 69 20 2d  pi -d /home/pi -
0920: 6d 20 70 69 64 70 38 69 0d 0a 20 20 20 20 23 20  m pidp8i..    # 
0930: 67 72 6f 75 70 6d 6f 64 20 2d 6e 20 70 69 20 70  groupmod -n pi p
0940: 69 64 70 38 69 0d 0a 20 20 20 20 23 20 65 78 69  idp8i..    # exi
0950: 74 0d 0a 0d 0a 4e 6f 77 20 6c 6f 67 20 62 61 63  t....Now log bac
0960: 6b 20 69 6e 20 61 73 20 75 73 65 72 20 60 70 69  k in as user `pi
0970: 60 2c 20 77 69 74 68 20 74 68 65 20 73 61 6d 65  `, with the same
0980: 20 70 61 73 73 77 6f 72 64 20 79 6f 75 20 68 61   password you ha
0990: 64 20 66 6f 72 20 75 73 65 72 20 60 70 69 64 70  d for user `pidp
09a0: 38 69 60 20 70 72 69 6f 72 20 74 6f 20 74 68 69  8i` prior to thi
09b0: 73 20 63 68 61 6e 67 65 2e 0d 0a 0d 0a 49 66 20  s change.....If 
09c0: 79 6f 75 20 68 61 76 65 20 74 68 65 20 50 69 44  you have the PiD
09d0: 50 2d 38 2f 49 20 50 43 42 20 61 74 74 61 63 68  P-8/I PCB attach
09e0: 65 64 20 74 6f 20 79 6f 75 72 20 50 69 20 61 6e  ed to your Pi an
09f0: 64 20 79 6f 75 20 74 72 79 20 74 6f 20 72 65 73  d you try to res
0a00: 74 61 72 74 20 74 68 65 20 73 69 6d 75 6c 61 74  tart the simulat
0a10: 6f 72 2c 20 74 68 65 20 66 72 6f 6e 74 20 70 61  or, the front pa
0a20: 6e 65 6c 20 77 69 6c 6c 20 6e 6f 74 20 6c 69 67  nel will not lig
0a30: 68 74 20 75 70 20 6e 6f 77 2e 20 20 54 68 69 73  ht up now.  This
0a40: 20 69 73 20 62 65 63 61 75 73 65 20 74 68 65 20   is because the 
0a50: 50 69 44 50 2d 38 2f 49 20 73 6f 66 74 77 61 72  PiDP-8/I softwar
0a60: 65 20 77 61 73 20 62 75 69 6c 74 20 77 69 74 68  e was built with
0a70: 20 74 68 65 20 6b 6e 6f 77 6c 65 64 67 65 20 74   the knowledge t
0a80: 68 61 74 20 74 68 65 20 64 65 66 61 75 6c 74 20  hat the default 
0a90: 75 73 65 72 20 6e 61 6d 65 20 77 61 73 20 60 70  user name was `p
0aa0: 69 64 70 38 69 60 2e 20 20 59 6f 75 20 6e 65 65  idp8i`.  You nee
0ab0: 64 20 74 6f 20 72 65 62 75 69 6c 64 20 61 6e 64  d to rebuild and
0ac0: 20 72 65 69 6e 73 74 61 6c 6c 20 69 74 20 74 6f   reinstall it to
0ad0: 20 66 69 78 20 74 68 69 73 3a 0d 0a 0d 0a 20 20   fix this:....  
0ae0: 20 20 24 20 63 64 20 7e 2f 70 69 64 70 38 69 0d    $ cd ~/pidp8i.
0af0: 0a 20 20 20 20 24 20 72 6d 20 2e 66 73 6c 63 6b  .    $ rm .fslck
0b00: 6f 75 74 0d 0a 20 20 20 20 24 20 66 6f 73 73 69  out..    $ fossi
0b10: 6c 20 75 73 65 72 20 64 65 66 61 75 6c 74 20 70  l user default p
0b20: 69 64 70 38 69 0d 0a 20 20 20 20 24 20 66 6f 73  idp8i..    $ fos
0b30: 73 69 6c 20 6f 70 65 6e 20 7e 2f 6d 75 73 65 75  sil open ~/museu
0b40: 6d 2f 70 69 64 70 38 69 2e 66 6f 73 73 69 6c 20  m/pidp8i.fossil 
0b50: 72 65 6c 65 61 73 65 0d 0a 20 20 20 20 24 20 2e  release..    $ .
0b60: 2f 63 6f 6e 66 69 67 75 72 65 20 26 26 20 74 6f  /configure && to
0b70: 6f 6c 73 2f 6d 6d 61 6b 65 20 26 26 20 73 75 64  ols/mmake && sud
0b80: 6f 20 6d 61 6b 65 20 69 6e 73 74 61 6c 6c 0d 0a  o make install..
0b90: 20 20 20 20 24 20 73 75 64 6f 20 73 79 73 74 65      $ sudo syste
0ba0: 6d 63 74 6c 20 72 65 73 74 61 72 74 20 70 69 64  mctl restart pid
0bb0: 70 38 69 0d 0a 0d 0a 54 68 61 74 20 73 68 6f 75  p8i....That shou
0bc0: 6c 64 20 6c 69 67 68 74 20 74 68 65 20 70 61 6e  ld light the pan
0bd0: 65 6c 20 62 61 63 6b 20 75 70 2e 0d 0a 0d 0a 4e  el back up.....N
0be0: 6f 77 20 77 65 20 63 61 6e 20 66 69 6e 61 6c 6c  ow we can finall
0bf0: 79 20 73 65 74 20 75 70 20 61 75 74 6f 2d 6c 6f  y set up auto-lo
0c00: 67 69 6e 3a 0d 0a 0d 0a 20 20 20 20 24 20 73 75  gin:....    $ su
0c10: 64 6f 20 72 61 73 70 69 2d 63 6f 6e 66 69 67 0d  do raspi-config.
0c20: 0a 20 20 20 20 0d 0a 54 68 65 6e 20 67 6f 20 74  .    ..Then go t
0c30: 6f 20 2a 2a 42 6f 6f 74 20 4f 70 74 69 6f 6e 73  o **Boot Options
0c40: 2a 2a 20 e2 86 92 20 2a 2a 44 65 73 6b 74 6f 70  ** → **Desktop
0c50: 20 2f 20 43 4c 49 2a 2a 20 e2 86 92 20 2a 2a 43   / CLI** → **C
0c60: 6f 6e 73 6f 6c 65 20 41 75 74 6f 6c 6f 67 69 6e  onsole Autologin
0c70: 2a 2a 2e 0d 0a 0d 0a 49 74 20 77 69 6c 6c 20 6f  **.....It will o
0c80: 66 66 65 72 20 74 6f 20 72 65 62 6f 6f 74 20 79  ffer to reboot y
0c90: 6f 75 72 20 73 79 73 74 65 6d 20 74 6f 20 74 65  our system to te
0ca0: 73 74 20 74 68 69 73 2e 20 20 49 74 20 73 68 6f  st this.  It sho
0cb0: 75 6c 64 20 73 75 63 63 65 65 64 2e 0d 0a 0d 0a  uld succeed.....
0cc0: 0d 0a 23 23 20 41 74 74 61 63 68 69 6e 67 20 74  ..## Attaching t
0cd0: 68 65 20 43 6f 6e 73 6f 6c 65 20 74 6f 20 74 68  he Console to th
0ce0: 65 20 53 69 6d 75 6c 61 74 6f 72 20 62 79 20 44  e Simulator by D
0cf0: 65 66 61 75 6c 74 0d 0a 0d 0a 49 6e 73 74 65 61  efault....Instea
0d00: 64 20 6f 66 20 62 6f 6f 74 69 6e 67 20 74 6f 20  d of booting to 
0d10: 61 20 4c 69 6e 75 78 20 63 6f 6d 6d 61 6e 64 20  a Linux command 
0d20: 70 72 6f 6d 70 74 2c 20 79 6f 75 20 6d 61 79 20  prompt, you may 
0d30: 70 72 65 66 65 72 20 74 6f 20 68 61 76 65 20 74  prefer to have t
0d40: 68 65 20 52 61 73 70 62 69 61 6e 20 63 6f 6e 73  he Raspbian cons
0d50: 6f 6c 65 20 61 74 74 61 63 68 65 64 20 74 6f 20  ole attached to 
0d60: 74 68 65 20 50 69 44 50 2d 38 2f 49 20 73 69 6d  the PiDP-8/I sim
0d70: 75 6c 61 74 6f 72 20 63 6f 6e 73 6f 6c 65 2c 20  ulator console, 
0d80: 73 6f 20 74 68 61 74 20 79 6f 75 20 73 65 65 20  so that you see 
0d90: 74 68 65 20 70 72 6f 67 72 61 6d 20 79 6f 75 27  the program you'
0da0: 72 65 20 73 69 6d 75 6c 61 74 69 6e 67 3a 20 4f  re simulating: O
0db0: 53 2f 38 2c 20 54 53 53 2f 38 2c 20 53 70 61 63  S/8, TSS/8, Spac
0dc0: 65 77 61 72 21 20 6f 72 20 77 68 61 74 20 68 61  ewar! or what ha
0dd0: 76 65 20 79 6f 75 2e 0d 0a 0d 0a 54 68 65 20 73  ve you.....The s
0de0: 69 6d 70 6c 65 73 74 20 77 61 79 20 49 20 63 61  implest way I ca
0df0: 6e 20 74 68 69 6e 6b 20 6f 66 20 74 6f 20 64 6f  n think of to do
0e00: 20 74 68 61 74 20 69 73 3a 0d 0a 0d 0a 20 20 20   that is:....   
0e10: 20 24 20 65 63 68 6f 20 70 69 64 70 38 69 20 3e   $ echo pidp8i >
0e20: 3e 20 7e 2f 2e 70 72 6f 66 69 6c 65 0d 0a 20 20  > ~/.profile..  
0e30: 20 20 24 20 73 75 64 6f 20 72 65 62 6f 6f 74 0d    $ sudo reboot.
0e40: 0a 0d 0a 54 68 61 74 20 73 68 6f 75 6c 64 20 64  ...That should d
0e50: 72 6f 70 20 79 6f 75 20 69 6e 74 6f 20 74 68 65  rop you into the
0e60: 20 53 49 4d 48 20 63 6f 6e 73 6f 6c 65 20 61 66   SIMH console af
0e70: 74 65 72 20 74 68 65 20 68 6f 73 74 20 4f 53 20  ter the host OS 
0e80: 62 6f 6f 74 73 2e 0d 0a 0d 0a 49 66 20 79 6f 75  boots.....If you
0e90: 20 6e 65 65 64 20 74 6f 20 67 65 74 20 62 61 63   need to get bac
0ea0: 6b 20 74 6f 20 4c 69 6e 75 78 2c 20 74 68 65 72  k to Linux, ther
0eb0: 65 20 61 72 65 20 61 20 63 6f 75 70 6c 65 20 6f  e are a couple o
0ec0: 66 20 77 61 79 73 2e 0d 0a 0d 0a 49 66 20 79 6f  f ways.....If yo
0ed0: 75 20 6a 75 73 74 20 6e 65 65 64 20 74 6f 20 72  u just need to r
0ee0: 75 6e 20 61 20 73 69 6e 67 6c 65 20 63 6f 6d 6d  un a single comm
0ef0: 61 6e 64 2c 20 79 6f 75 20 63 61 6e 20 70 72 65  and, you can pre
0f00: 73 73 20 3c 6b 62 64 3e 43 74 72 6c 2d 45 3c 2f  ss <kbd>Ctrl-E</
0f10: 6b 62 64 3e 20 61 6e 64 20 74 68 65 6e 20 72 75  kbd> and then ru
0f20: 6e 20 79 6f 75 72 20 63 6f 6d 6d 61 6e 64 20 66  n your command f
0f30: 72 6f 6d 20 74 68 65 20 60 73 69 6d 3e 60 20 70  rom the `sim>` p
0f40: 72 6f 6d 70 74 20 77 69 74 68 20 74 68 65 20 60  rompt with the `
0f50: 21 60 20 73 68 65 6c 6c 20 65 73 63 61 70 65 3a  !` shell escape:
0f60: 0d 0a 0d 0a 20 20 20 20 73 69 6d 3e 20 21 64 66  ....    sim> !df
0f70: 20 2d 68 0d 0a 20 20 20 20 2e 2e 2e 64 69 73 6b   -h..    ...disk
0f80: 20 66 72 65 65 20 73 70 61 63 65 20 72 65 70 6f   free space repo
0f90: 72 74 2e 2e 2e 0d 0a 20 20 20 20 73 69 6d 3e 20  rt.....    sim> 
0fa0: 63 0d 0a 20 20 20 20 2e 2e 2e 73 69 6d 75 6c 61  c..    ...simula
0fb0: 74 69 6f 6e 20 63 6f 6e 74 69 6e 75 65 73 2e 2e  tion continues..
0fc0: 2e 0d 0a 0d 0a 49 66 20 79 6f 75 20 6e 65 65 64  .....If you need
0fd0: 20 74 6f 20 64 6f 20 6d 6f 72 65 20 74 68 61 6e   to do more than
0fe0: 20 74 68 61 74 2c 20 49 20 72 65 63 6f 6d 6d 65   that, I recomme
0ff0: 6e 64 20 71 75 69 74 74 69 6e 67 20 6f 75 74 20  nd quitting out 
1000: 6f 66 20 53 49 4d 48 20 76 69 61 20 3c 6b 62 64  of SIMH via <kbd
1010: 3e 43 74 72 6c 2d 45 3c 2f 6b 62 64 3e 20 60 71  >Ctrl-E</kbd> `q
1020: 75 69 74 60 2e 20 20 44 6f 20 79 6f 75 72 20 4c  uit`.  Do your L
1030: 69 6e 75 78 20 77 6f 72 6b 2c 20 61 6e 64 20 77  inux work, and w
1040: 68 65 6e 20 64 6f 6e 65 2c 20 72 65 2d 73 74 61  hen done, re-sta
1050: 72 74 20 74 68 65 20 73 69 6d 75 6c 61 74 6f 72  rt the simulator
1060: 20 61 6e 64 20 72 65 2d 61 74 74 61 63 68 20 74   and re-attach t
1070: 6f 20 69 74 3a 0d 0a 0d 0a 20 20 20 20 24 20 73  o it:....    $ s
1080: 75 64 6f 20 73 79 73 74 65 6d 63 74 6c 20 72 65  udo systemctl re
1090: 73 74 61 72 74 20 70 69 64 70 38 69 0d 0a 20 20  start pidp8i..  
10a0: 20 20 24 20 70 69 64 70 38 69 0d 0a 0d 0a 0d 0a    $ pidp8i......
10b0: 23 23 20 4c 69 63 65 6e 73 65 0d 0a 0d 0a 43 6f  ## License....Co
10c0: 70 79 72 69 67 68 74 20 c2 a9 20 32 30 31 37 2d  pyright © 2017-
10d0: 32 30 31 39 20 62 79 20 57 61 72 72 65 6e 20 59  2019 by Warren Y
10e0: 6f 75 6e 67 2e 20 54 68 69 73 20 64 6f 63 75 6d  oung. This docum
10f0: 65 6e 74 20 69 73 20 6c 69 63 65 6e 73 65 64 20  ent is licensed 
1100: 75 6e 64 65 72 20 74 68 65 20 74 65 72 6d 73 20  under the terms 
1110: 6f 66 20 5b 74 68 65 20 53 49 4d 48 20 6c 69 63  of [the SIMH lic
1120: 65 6e 73 65 5d 5b 73 6c 5d 2e 0d 0a 0d 0a 0d 0a  ense][sl].......
1130: 5b 74 76 73 5d 3a 20 20 68 74 74 70 3a 2f 2f 77  [tvs]:  http://w
1140: 77 77 2e 74 65 73 74 61 6e 64 76 65 72 69 66 69  ww.testandverifi
1150: 63 61 74 69 6f 6e 2e 63 6f 6d 2f 69 6f 74 2f 73  cation.com/iot/s
1160: 2d 69 6f 74 2d 73 74 61 6e 64 73 2d 73 65 63 75  -iot-stands-secu
1170: 72 69 74 79 2f 0d 0a 5b 73 69 74 65 5d 3a 20 2f  rity/..[site]: /
1180: 0d 0a 5b 73 6c 5d 3a 20 20 20 2f 64 6f 63 2f 74  ..[sl]:   /doc/t
1190: 72 75 6e 6b 2f 53 49 4d 48 2d 4c 49 43 45 4e 53  runk/SIMH-LICENS
11a0: 45 2e 6d 64 0a 5a 20 39 32 31 30 62 31 36 30 39  E.md.Z 9210b1609
11b0: 34 35 30 30 34 66 61 35 31 64 66 35 30 36 35 31  45004fa51df50651
11c0: 32 64 33 38 61 32 30 0a                          2d38a20.