Accessibility
 

 

   •  On This Page

Overview

Multics History Project

Multics Design Notebook

Multics System-
Programmers' Manual

Multics Repository
Documents

Multics Materials in the
MIT Archives

Multics Source
and Listings

 

   •  Links to Other Sites

Multicians.org

Wikipedia's Multics Entry

Multics Predecessor: CTSS

MIT Archives

Bull AtoS Technologies


Multics Documents

December 26, 2016, updated March 15, 2021

Overview

A huge number of documents were produced and distributed on paper in the course of the design, development, and deployment of the Multics system. This page provides a guide to locating them, many of which have by now been scanned and made available on-line.

The Multics History Project

In 2006, the Multics History Project scanned all of the Multics documents found on the bookshelves and in the personal files of M.I.T. Professor Jerry Saltzer with the exception of a few materials that were physically unsuitable for the available scanner, such as wide fanfold computer printout. The scanned documents, which filled eight banker's boxes, were then deposited with the MIT Archives. A link to that large, yet incomplete, archive is here, including tables of contents as a finding aid. In addition, the next three sections of this page provide descriptions and direct access to some of those materials that may be of particular interest.

A set of slides (PDF) that Olin Sibert presented at a 2006 meeting of the Software Preservation Group of the Computer History Museum offers more information about the Multics History Project.

The Multics Design Notebook

Between November 1964 and July 1965 the Multics design team authored a series of position papers known as the Multics Design Notebook. These papers explain goals and are sources of general design ideas rather than accurate descriptions of the system that was later implemented. While many of the ideas in the Multics Design Notebook were incorporated in the system, many other Design Notebook ideas were later modified, expanded, reduced, or fell by the wayside.

The Multics System-Programmers' Manual

[The following description was written by Thomas H. Van Vleck for the Multicians.org website.]

The Multics System Programmers' Manual (MSPM) was intended to be the primary design document for Multics. Most of the MSPM was written between 1965 and 1969.

While waiting for the PL/I compiler to become available in 1965 and 1966, the team designed Multics and documented the design in the MSPM, which grew to over 800 sections and about 3000 pages; every section went through serious review and many sections were rewritten or deeply revised several times.

The MSPM contained functional requirements, high-level design, and implementation plans for Multics. When we actually started building and integrating the system, we discovered that some of the MSPM designs were far too complex. Simpler, more efficient facilities were built instead, sometimes as interim measures intended to evolve into the full design eventually, and sometimes as recognition that the original plan attempted too much. The MSPM was updated to reflect some of the early redesigns, but quickly got behind.

Section numbers of the MSPM begin with B, like "BA.1." This is homage to the the CTSS Programmer's Guide, whose second edition's sections all begin with A.

Much of the MSPM is science fiction, describing features that might work one day in the future; some were never done. (One early I/O System design section mentioned the "on-line peripheral oil well.") Other parts of it provided high level functional specs for cool facilities we never did have time to build, e.g. the reserver. Other parts had low-level PL/I declarations of code that might or might not compile. In modern terms, the MSPM was a kind of requirements document, describing what Multics should do once built, intermixed with internal design documents specifying how to build the functions.

It is important to understand that the MSPM writing exercise was a step toward Multics, and that almost none of the design in the MSPM was implemented as written. But we would not have had as good a system without it: the MSPM represented an innovation in Process, a balance between formality, writing things down, peer review and imprecision, detail hiding, leaving specifics till later.

MSPM sections were handwritten by programmers, and then typed by secretaries on hectograph masters. Blue hectograph copies of a document were unapproved, and provisional. After design review, the official versions of documents were retyped on paper tape using Friden 2201 Flexowriters, proofread by the programmers, and then the paper tapes were used to produce mimeograph masters. Official versions of documents had black ink. CTSS was not used for system documentation, because it was too expensive. Xerography was not used for reproduction because it was expensive and unreliable. The Flexowriter tapes appear to have been discarded.

As sections were produced, they were distributed to every member of the project team. The MSPM occupied ten or twelve four-inch three-ring binders, more than one shelf of a standard office bookcase. Just keeping up with filing the updates took substantial time. As a result, each person's copy of the MSPM may have some variations.

The table below does not include section BS, System Module Abstracts. That section consisted of one-page writeups for actual code as we really began building and integrating the system in 1966-68. The idea was that we would update the MSPM as we actually wrote code, to produce a system and documentation that matched it. We fell behind rapidly. Management insisted that we at least have a one-page abstract for everything in the system, and that may have been true for a short time.

The copy of the MSPM that was scanned is the one that was found on Prof. Jerry Saltzer's bookshelf in the spring of 2006. Since the MSPM was a frequently-updated loose-leaf notebook there is no reason to believe that this copy is identical to any other copy, but since Jerry acted as the editor of the MSPM it is probably as authoritative as any version to be found.

A Few Multics Repository Documents (B00, G00, M00)

Documents about Multics that did not fit in the Multics System-Programmers' Manual or the several series of staff bulletins were issued in three numbered series collectively known as the Multics Repository. The serial numbers began with "B" for documents that originated at Bell Labs, "G" for documents that originated at General Electric, and "M" for documents that originated at MIT Project MAC. There were several hundred such documents, but only a few have been located and scanned. Lists of all repository documents that were not declared obsolete as of December, 1969, are in M0116 (M00s, PDF), M0118 (G00s, PDF), and M0119 (B00s, PDF). The repository documents that have been located include several that were omitted from these lists because they were considered to be obsolete.

It appears that the MIT Archives may have many more Multics Repository documents. In the Archives finding aid (see next section), they are listed in box numbers 53, 54, and 55.

Multics Materials in the MIT Archives

Throughout the 1970s many documents pertaining to Multics were accumulated in a small conference room at Project MAC known as the Multics History Room. When MIT stopped working on Multics the contents of the Multics History Room, about 33 file drawers, were moved to a basement storage area, to join many other Project MAC historical files. Some time in the 1990s, following a basement flood, the materials in the basement storage area, including the contents of the Multics History Room, were transferred to the MIT Archives, a part of the MIT Libraries, for rescue. The Archives created a finding aid for the entire set of files, but given the flood the condition of the paper files is uncertain. Below are two lists: (1) the contents of the Multics History Room before it was moved and (2) the Multics section (pages 10-17) of the Archives finding aid. These two documents provide two slightly different descriptions of the same materials. To connect the two documents, where the Archives finding aid refers to "CSR Box n" it is actually referring to file drawer n in the Multics History Storage list.

The Archives materials listed here are only those that came from the Project MAC Computer Systems Research group. It is likely that there are other Multics-related documents elsewhere in the Archives that have come from Project MAC, the Laboratory for Computer Science, or individual faculty members. For example, the Archives received eight boxes of Multics-related personal files of Professor Saltzer after they were scanned by the Multics History Project. Those eight boxes are not included in this version of the finding aid.

Multics Source and Listings

In addition to the documents listed above, Bull HN (the successor to Honeywell Information Systems, which was itself the successor to the General Electric Computer Division) has generously contributed the source code for the final commercial Multics release, MR 12.5, November 1992, for academic purposes.


CSAIL LOGO
Preservation Credits: Scanning from paper was done by Roger Roach and Olin Sibert for the Multics History Project. The contribution of Multics source and listings by Bull AtoS Technologies was arranged by Bernard Nivelet. Those files are stored on web servers of MIT Information Services & Telecommunications.

Design Credits: The Multics logo is by Stan Zanarotti. The CSAIL logo is a work-for-hire chosen by the CSAIL logo committee. Page design and style are borrowed from the MIT Information Services & Telecommunications standard template.


Please send corrections, comments and suggestions to: Saltzer@mit.edu