Welcome to this verion of SIM-H 3.8-1 on Windows, pertaining to Research Unix v1. Special thanks to the following people for making this possible (in no particular order) Tim Newsham Warren Toomey Ralph Logan Hellwig Geisse Al Kossow James A. Markevitch John Cowan Michael Kerpan Jim Capp P. A. Osborne Brantley Coile Doug Merritt Sergio Pedraja Cyrille Lefevre Brad Parker Dennis Ritchie Brian Kernighan I'm sorry if I have left anyone off of the list. Feel free to drop me a note, and I'll add you in there. The website for the Unix-jun72 restoration is http://code.google.com/p/unix-jun72/ The main website for this project is http://sourceforge.net/projects/bsd42/ This particular release is covered by the Ancient Unix license where all code was released under a BSD style license. This restoration is released under the GPL 2.0 This is an easy to run package that should have you up and running Unix v1 in a quick instant. This version will allow up to 8 remote users to telnet into the host computer, and connect on the DC card in the emulated PDP/11. Sadly there are no games on this release, so don't over expect. By default you should install *everything*. This is the configuation file that I'm using. ------ set cpu 11/20 set cpu 32K set rk0 enabled att rk0 rk0.dsk set rf 2p set rf enabled att rf rf0.dsk set tc enabled att tc tape set hk disabled set rha disabled set tm disabled set rx disabled set rl disabled set tq disabled set tc enabled set rf enabled set ke enabled set dci en set dci lines=8 set dco 7b att dci 12323 load m792low.load dep system sr 173700 go 73700 ------ Unix v1 runs in under 32kb of ram. It does support multiple users, and it does include a C compiler from later releases. There is no 'cd' command, it's chdir. I know that will save someone out there some hassles. It's also worth noting that there is NO: *vi *TCP/IP *networking *UUCP *man pages Much of this would come later to the UNIX party, and most of what you may be used to are BSD additions. Because this is V1, all the source to the system is in assembly. By default on windows the console will not handle ascii correctly. I have enclosed a copy of Tera Term Pro that will connect on the correct port, the link is the "Attach a PTY". Just wait for the Operating System to boot up to the login prompt. You can use any telnet program that you wish, just connect to the localhost on port 7842. *Please note that this program is nowhere Vista compliant. The user data is dumped into the program file directory (bad) so you must run this program elevated as Administrator! (right click on the program link, and choose run as Administrator). ------ From the unix-jun72 readme.txt: Welcome to the 1st Edition UNIX repository. Here you will find the kernel source code and userland binaries which will allow you to run 1e UNIX on a PDP-11 simulator. Build Instructions ------------------ Unless otherwise noted, file and directory names refer to this repository. 1. Download the source code for the Simh simulator from here: http://simh.trailing-edge.com/. Make sure that you download version 3.8-0 or later; earlier versions need patches to work. 2. Unpack Simh somewhere. Make the BIN/ directory in Simh at the top level. Do make pdp11 to make the pdp11 simulator in the BIN/ directory. Copy the BIN/pdp11 executable into the tools/ directory. 2. Return to the 1st Edition top-level directory. Do a make. This will do several things. It will build tools/mkfs, tools/ml and tools/apout/apout. These tools are required to build the filesystems for 1e UNIX, and the kernel. It will create kernel sources with some necessary patches, assemble the kernel and build a bootable Simh memory image which is installed into the images directory. Finally, the make will build the rf0.dsk, rk0.dsk and tape images and install these in the images directory. You can also do a "make clean" to clean out the images/ and build/ directories. A "make clobber" will clean out the images/, build/ and tools/ directories. Running 1st Edition UNIX ------------------------ 1. Run ./simh.cfg which starts the pdp11 simulator. You should see this: PDP-11 simulator V3.8-0 ./simh2.cfg> #!tools/pdp11 Unknown command Disabling CR Disabling XQ RF: buffering file in memory TC0: 16b format, buffering file in memory Listening on port 5555 (socket 7) You will receive a login: prompt: 2. Type in root followed by . You should receive a # prompt. 3. Type in an ls -l command. You should see something like this: total 6 43 sdrwr- 2 root 620 Jan 1 00:00:00 bin 42 sdrwr- 2 root 250 Jan 1 00:00:00 dev 104 sdrwr- 2 root 110 Jan 1 00:00:00 etc 114 sdrwr- 2 root 50 Jan 1 00:00:00 tmp 41 sdrwr- 7 root 70 Jan 1 00:00:00 usr 4. To change directories, use chdir, e.g. chdir /usr. The only editor installed is `ed'. You can find an ed tutorial in notes/edtut.txt. 5. To log in multiple times, telnet to localhost port 5555. The system is configured to allow 8 remote logins. 6. To shut the system down, enter ctrl-E to stop the simulator, and q to quit. You do not need to sync the system before shutdown. Documentation ------------- The manuals for 1st Edition UNIX are available here: http://www.cs.bell-labs.com/who/dmr/1stEdman.html, and http://www.bitsavers.org/pdf/bellLabs/unix/UNIX_ProgrammersManual_Nov71.pdf Some documentation of the internals of the 1st Edition UNIX are available here: http://www.bitsavers.org/pdf/bellLabs/unix/PreliminaryUnixImplementationDocument _Jun72.pdf Details of the PDP-11/20 architecture and its peripherals can be found at: http://www.bitsavers.org/pdf/dec/pdp11/handbooks/PDP1120_Handbook_1972.pdf http://www.bitsavers.org/pdf/dec/pdp11/handbooks/PDP11_PeripheralsHbk_1972.pdf The C compiler from 2nd Edition UNIX is also installed and works, but the language is a very early dialect of C. The closest reference to the language at this point in time is this, but it is probably 2 years too late: http://cm.bell-labs.com/cm/cs/who/dmr/cman74.pdf The userland binaries come from a period somewhere between the 1st and 2nd Edition of UNIX. You may find the 2e manuals useful too: http://www.bitsavers.org/pdf/bellLabs/unix/Unix_2nd_Edition_Manual_Jun72.pdf Repository Layout ----------------- pages/ - OCR'd pages from the PreliminaryUnixImplementation document rebuilt/ - kernel source rebuilt from the OCR'd pages, as asm files patches/ - patches to rebuilt/ files to get kernel to run fs/ - userland binaries and files, used to make rf0.dsk and rk0.dsk src/ - source code for userland: there is not much available tools/ - tools and scripts to build the kernel and filesystem build/ - build area: patched kernel files, patched filesystems images/ - final disk and tape images to be used by the Simh simulator misc/ - misc. files, e.g. the Simh patch for KE11A support notes/ - notes on the work done to get 1e UNIX to run again diffs/ - Differences between pages/* and the high quality OCR done by James Markevitch. Includes headers and footers.