{"id":18469452,"url":"https://github.com/philspil66/unix-june-1972","last_synced_at":"2025-05-07T07:50:09.221Z","repository":{"id":171755421,"uuid":"547174318","full_name":"philspil66/UNIX-June-1972","owner":"philspil66","description":"This is the working source code to PDP-11 Unix from 1972.","archived":false,"fork":false,"pushed_at":"2022-10-07T09:13:42.000Z","size":491,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-05-07T07:50:02.718Z","etag":null,"topics":["pdp","pdp-11","unix","vintage-computers"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/philspil66.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-10-07T08:52:01.000Z","updated_at":"2024-05-26T13:09:51.000Z","dependencies_parsed_at":null,"dependency_job_id":"451076e6-2e1c-4faa-a3e7-8ae681f0db05","html_url":"https://github.com/philspil66/UNIX-June-1972","commit_stats":null,"previous_names":["philspil66/unix-june-1972"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/philspil66%2FUNIX-June-1972","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/philspil66%2FUNIX-June-1972/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/philspil66%2FUNIX-June-1972/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/philspil66%2FUNIX-June-1972/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/philspil66","download_url":"https://codeload.github.com/philspil66/UNIX-June-1972/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252839282,"owners_count":21812084,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["pdp","pdp-11","unix","vintage-computers"],"created_at":"2024-11-06T10:10:29.570Z","updated_at":"2025-05-07T07:50:09.201Z","avatar_url":"https://github.com/philspil66.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"# UNIX June 1972\n\nWelcome to the 1st Edition UNIX repository. Here you will find the kernel source code and userland binaries which will allow you to run UNIX on a PDP-11 simulator.\n\nBuild Instructions\n------------------\nUnless otherwise noted, file and directory names refer to this repository.\n\n1. Download the source code for the Simh simulator from here:\n   http://simh.trailing-edge.com/. \n   Make sure that you download version 3.8-0 or later; earlier versions need patches to work.\n\n2. Unpack Simh somewhere. Make the BIN/ directory in Simh at the top level.\n   Do make pdp11 to make the pdp11 simulator in the BIN/ directory. Copy the BIN/pdp11 executable into the tools/ directory.\n\n2. 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.\n3. \n   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.\n\nRunning 1st Edition UNIX\n------------------------\n\n1. Run ./simh.cfg which starts the pdp11 simulator. You should see this:\n\n     PDP-11 simulator V3.8-0\n     \n     ./simh2.cfg\u003e #!tools/pdp11\n     \n     Unknown command\n     \n     Disabling CR\n     \n     Disabling XQ\n     \n     RF: buffering file in memory\n     \n     TC0: 16b format, buffering file in memory\n     \n     Listening on port 5555 (socket 7)\n\n   You will receive a login: prompt:\n\n2. Type in root followed by \u003cRETURN\u003e. You should receive a # prompt.\n\n3. Type in an ls -l command. You should see something like this:\n\n   total    6\n   \n    43 sdrwr-  2 root    620 Jan  1 00:00:00 bin\n   \n    42 sdrwr-  2 root    250 Jan  1 00:00:00 dev\n   \n   104 sdrwr-  2 root    110 Jan  1 00:00:00 etc\n   \n   114 sdrwr-  2 root     50 Jan  1 00:00:00 tmp\n   \n    41 sdrwr-  7 root     70 Jan  1 00:00:00 usr\n   \n\n4. 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.\n\n5. To log in multiple times, telnet to localhost port 5555.  The system is configured to allow 8 remote logins.\n\n6. 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.\n\nDocumentation\n-------------\n\nThe manuals for 1st Edition UNIX are available here:\nhttp://www.bitsavers.org/pdf/bellLabs/unix/UNIX_ProgrammersManual_Nov71.pdf\n\nSome documentation of the internals of the 1st Edition UNIX are available here:\nhttp://www.bitsavers.org/pdf/bellLabs/unix/PreliminaryUnixImplementationDocument\n_Jun72.pdf\n\nDetails of the PDP-11/20 architecture and its peripherals can be found at:\nhttp://www.bitsavers.org/pdf/dec/pdp11/handbooks/PDP1120_Handbook_1972.pdf\nhttp://www.bitsavers.org/pdf/dec/pdp11/handbooks/PDP11_PeripheralsHbk_1972.pdf\n\nThe C compiler from 2nd Edition UNIX is also installed and works, but the\nlanguage is a very early dialect of C. \n\nThe userland binaries come from a period somewhere between the 1st and 2nd\nEdition of UNIX. You may find the 2e manuals useful too:\nhttp://www.bitsavers.org/pdf/bellLabs/unix/Unix_2nd_Edition_Manual_Jun72.pdf\n\nRepository Layout\n-----------------\n\npages/\t\t- OCR'd pages from the PreliminaryUnixImplementation document\n   \nrebuilt/\t- kernel source rebuilt from the OCR'd pages, as asm files\n   \npatches/\t- patches to rebuilt/ files to get kernel to run\n   \nfs/\t\t- userland binaries and files, used to make rf0.dsk and rk0.dsk\n   \nsrc/\t\t- source code for userland: there is not much available\n   \ntools/\t\t- tools and scripts to build the kernel and filesystem\n   \nbuild/\t\t- build area: patched kernel files, patched filesystems\n   \nimages/\t\t- final disk and tape images to be used by the Simh simulator\n   \nmisc/\t\t- misc. files, e.g. the Simh patch for KE11A support\n   \nnotes/\t\t- notes on the work done to get 1e UNIX to run again\n   \ndiffs/\t\t- Differences between pages/* and the high quality OCR\n\n   \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphilspil66%2Funix-june-1972","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fphilspil66%2Funix-june-1972","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphilspil66%2Funix-june-1972/lists"}