mirror of
https://github.com/DoctorWkt/pdp7-unix.git
synced 2026-02-22 15:28:01 +00:00
164 lines
3.7 KiB
Markdown
164 lines
3.7 KiB
Markdown
# pdp7-unix
|
|
|
|
|
|
## About
|
|
|
|
pdp7-unix is a project to resurrect Unix on the PDP-7 from scans of the original
|
|
assembly code done by
|
|
[Norman Wilson](http://www.cs.toronto.edu/~norman/pers/index.html).
|
|
The scans of PDP-7 Unix are in the [Unix Archive](http://www.tuhs.org/)
|
|
[as the files 0*.pdf](http://www.tuhs.org/Archive/Distributions/Research/McIlroy_v0/).
|
|
|
|
## Current Status
|
|
|
|
### March 2016
|
|
|
|
We've written an assembler, a user-mode simulator and
|
|
commented several source files. We now have these utilities running:
|
|
as, cat, chmod, chown, chrm, cp, date, ln, ls, mv, stat. We have a working
|
|
shell with some functionality missing. We have a working filesystem and
|
|
we can now boot the kernel, launch init, login, get to a shell prompt and
|
|
run the utilities.
|
|
|
|
Things to do: bring the
|
|
system fully up on a PDP-7 system, fix any bugs and document everything.
|
|
We have a [real PDP-7](http://physics.uoregon.edu/outreach/movies/pdplives/)
|
|
and [SimH](http://simh.trailing-edge.com/) as target platforms.
|
|
|
|
### October 2019
|
|
|
|
A second notebook with missing sources has been
|
|
discovered and scanned. New files are being added to the scans
|
|
directory as they are typed in!
|
|
|
|
## Building pdp7-unix
|
|
|
|
pdp7-unix requires [Perl5](https://www.perl.org/) to build.
|
|
|
|
To compile it:
|
|
|
|
`make pdp7`
|
|
|
|
## Running pdp7-unix
|
|
|
|
You will need [simh](http://simh.trailing-edge.com/) 4.0 to run pdp7-unix. You can get the source code [here](https://github.com/simh/simh).
|
|
On 64-bit systems, you may need to set the C compiler's optimisation level to -O1.
|
|
|
|
### Running from source
|
|
|
|
To run pdp-unix from the pdp7-unix source tree, do:
|
|
|
|
`make run`
|
|
|
|
Press `ctl-e` to break out the simulator into simh
|
|
|
|
### Typical Output
|
|
|
|
A typical pdp7-unix session on simh looks like:
|
|
|
|
<pre>
|
|
pdp7 unixv0.simh
|
|
|
|
PDP-7 simulator V4.0-0 Current git commit id: aff3346e
|
|
CPU idle disabled
|
|
8KW, EAE
|
|
/Users/tom/projects/pdp7-unix/build/unixv0.simh-13> att rb image.fs
|
|
RB: buffering file in memory
|
|
/Users/tom/projects/pdp7-unix/build/unixv0.simh-18> att -U g2in 12345
|
|
Listening on port 12345
|
|
PDP-7 simulator configuration
|
|
|
|
CPU idle disabled
|
|
CLK 60Hz, devno=00
|
|
PTR devno=01
|
|
PTP devno=02
|
|
TTI devno=03
|
|
TTO devno=04
|
|
LPT disabled
|
|
DRM disabled
|
|
RB devno=71
|
|
DT disabled
|
|
G2OUT devno=05
|
|
G2IN devno=43-44
|
|
|
|
login: ken
|
|
password: ken
|
|
@ ls system
|
|
system?
|
|
@ ls system
|
|
dd
|
|
ttyin
|
|
keyboard
|
|
pptin
|
|
ttyout
|
|
display
|
|
pptout
|
|
apr
|
|
as
|
|
bc
|
|
cas
|
|
cat
|
|
check
|
|
chmod
|
|
chown
|
|
chrm
|
|
cp
|
|
date
|
|
db
|
|
ds
|
|
dskres
|
|
dsksav
|
|
dsw
|
|
ed
|
|
init
|
|
ln
|
|
ls
|
|
lsd
|
|
lsl
|
|
nm
|
|
od
|
|
p
|
|
pd
|
|
mv
|
|
password
|
|
roff
|
|
rn
|
|
rm
|
|
sh
|
|
stat
|
|
tm
|
|
@
|
|
</pre>
|
|
|
|
|
|
## Source Tree
|
|
|
|
The code in the original scans are (c) Novell who own the rights to the Unix
|
|
source code. Everything that didn't come from the scanned files is GPLv3.
|
|
|
|
* /build is an area to build the kernel & filesystem and run them
|
|
* /man holds man pages
|
|
* /misc holds miscellaneous notes and information
|
|
* /scans holds the unmodified OCR versions of the scanned files
|
|
* /src/cmd holds the modified source code of the user-mode programs
|
|
* /src/sys holds the modified source code of the kernel
|
|
* /src/other holds PDP-7 source code which did not come from the scanned files
|
|
* /tools holds the source for the tools written to assist the project
|
|
|
|
## License
|
|
|
|
pdp7-unix is under the [GPLv3](LICENSE)
|
|
|
|
|
|
## Mailing List
|
|
|
|
We have a
|
|
[mailing list](http://minnie.tuhs.org/cgi-bin/mailman/listinfo/pdp7-unix)
|
|
for those people actively involved in the restoration effort. Send e-mail
|
|
to Warren Toomey (DoctorWkt) if you are keen to help out.
|
|
|
|
## Travis Status
|
|
|
|
<a href="https://travis-ci.org/DoctorWkt/pdp7-unix">
|
|
<img src="https://api.travis-ci.org/DoctorWkt/pdp7-unix.png"></a>
|