mirror of
https://github.com/PDP-10/its.git
synced 2026-02-13 03:23:58 +00:00
Various ITS documentation files.
This commit is contained in:
13
doc/emacs/-read-.-this-
Normal file
13
doc/emacs/-read-.-this-
Normal file
@@ -0,0 +1,13 @@
|
||||
The files TS > are the dumped copies of EMACS. There need only be two of them.
|
||||
The file TECMAC <number> is the current versions of TECMAC for the
|
||||
TECO version <number>. Please do not delete any of them.
|
||||
Files TCM<number> <number> are dumped versions of TECMAC. Please
|
||||
keep 2 for each distinct FN1.
|
||||
Finally, the files [PURE] <number> are the sharable copies of the
|
||||
EMACS library. THEY MUST NOT BE REAPED UNLESS YOU KNOW WHAT USES THEM.
|
||||
Each TCMnnn file, each TECMAC nnn file, and each TS nn file, uses
|
||||
the [PURE] file which is the most recent [PURE] file written
|
||||
before it (the TS, TECMAC or TCMnnn file) was written.
|
||||
If you don't understand this, don't delete ANY [PURE] file.
|
||||
I (RMS) take good care of flushing any garbage I can find in
|
||||
this directory, so you need not attend to it.
|
||||
31
doc/inquir/-user-.-note-
Normal file
31
doc/inquir/-user-.-note-
Normal file
@@ -0,0 +1,31 @@
|
||||
|
||||
This is the file directory for user information
|
||||
|
||||
LSR1 LOCK is used by INQUIR to prevent more than one INQUPD from trying
|
||||
to update the data base at once. The data base is locked when
|
||||
LSR1 LOCK is open for writing.
|
||||
|
||||
LSR1 > is the most recent valid copy of the INQUIR data base.
|
||||
Do not alter that file with anything but INQUIR unless you
|
||||
know what you are doing.
|
||||
LSR1 NEW is a new version being written.
|
||||
LSR1 OLD and LSR1 OLDOLD are the next 2 older versions.
|
||||
LSR1 2, if it exists, means that an INQUPD crashed while renaming
|
||||
versions.
|
||||
However, the situation is under control and will be cleaned up
|
||||
automatically by INQUPD the next time it runs.
|
||||
|
||||
.UPD1. and .UPD1$ files are updates sent by INQUIR, but not yet stuck
|
||||
into the LSR1 file.
|
||||
|
||||
INQUIR UPDATE is an archive of all the INQUIR updates done. WHen it
|
||||
gets large, rename it to OUPDAT >. Only a few months of OUPDAT
|
||||
files need be kept around.
|
||||
|
||||
ULIST > files are output from the INQUIR command ULIST. It is OK
|
||||
to delete them if they are more than a few days old, since they are
|
||||
easy to regenerate.
|
||||
|
||||
SETMSN is a program run by the default .DDT. (INIT) file. It
|
||||
sets the user's msname according to the FILE DIRECTORIES item in his
|
||||
INQUIR entry.
|
||||
82
doc/inquir/lsr1.doc
Normal file
82
doc/inquir/lsr1.doc
Normal file
@@ -0,0 +1,82 @@
|
||||
-*-Text-*-
|
||||
|
||||
This file describes the format of the new LSR1 user data base.
|
||||
Note that a standard library, SYSENG;LSRTNS >, exists for
|
||||
referencing this data base. Use it!
|
||||
|
||||
The file header:
|
||||
|
||||
HDRSID==0 ; wd 0 SIXBIT /LSR1!!/
|
||||
HDRDAT==1 ; wd 1 Date of compilation as sixbit YYMMDD
|
||||
HDRTIM==2 ; wd 2 Time of compilation as sixbit HHMMSS
|
||||
HDRUNM==3 ; wd 3 Address in file of UNAME table.
|
||||
HDRLNM==4 ; wd 4 Address in file LASTNAME table.
|
||||
HDRDAT==5 ; wd 5 Address in file of start of data area.
|
||||
; The data area must start on a page boundary,
|
||||
; and it must be the last thing in the file.
|
||||
;....
|
||||
|
||||
The UNAME table:
|
||||
|
||||
wd 0 Number of entries in this table,
|
||||
followed by entries, one per page of data area,
|
||||
each containing the UNAME of the first data area
|
||||
entry which begins on that page.
|
||||
|
||||
The LASTNAME table:
|
||||
|
||||
wd 0 Number of entries in this table,
|
||||
followed by entries, in order by last name
|
||||
Each entry looks like this:
|
||||
rh addr in file of entry
|
||||
lh addr in file of Last-name string
|
||||
|
||||
The lastname strings are word-aligned upper-case ASCIZ strings,
|
||||
and they follow the LASTNAME table.
|
||||
|
||||
The data area:
|
||||
|
||||
It starts on a page boundary. It is made up of consecutive entries,
|
||||
in order by UNAME, each looking like this:
|
||||
|
||||
LDACNT==0 ; entry wd 0 lh
|
||||
; the number of words in the entry,
|
||||
; including this one.
|
||||
; entry wd 0 rh -1
|
||||
|
||||
followed by unaligned ASCIZ strings, one per item, separated
|
||||
only by the single ^@ that ends the ASCIZ. The strings are associated
|
||||
with their meanings according to their numerical position in the entry.
|
||||
The entire entry is then padded to a word boundary with nulls.
|
||||
Note that the low bit is set in the count-words of entries
|
||||
and not in any other words of the data area.
|
||||
|
||||
The entries are sorted in ascii order, which is NOT the same
|
||||
as the order obtained by arithmetically sorting the SIXBIT unames.
|
||||
|
||||
The end of the data area is marked by ,,-1, which
|
||||
is tantamount to an entry 0 words long.
|
||||
That word is also the last word of the file.
|
||||
|
||||
The standard symbols for all the items are these:
|
||||
|
||||
I$==,-1
|
||||
I$UNAM==0 ;UNAME
|
||||
I$NAME==1 ;FULL NAME
|
||||
I$NICK==2 ;NICKNAME
|
||||
I$SSN==3 ;SOC SEC #.
|
||||
I$MITA==4 ;MIT ADDRESS
|
||||
I$MITT==5 ;MIT TELEPHONE NUMBER
|
||||
I$HOMA==6 ;HOME ADDRESS
|
||||
I$HOMT==7 ;HOME TELEPHONE NUMBER
|
||||
I$SUPR==10 ;SUPERVISOR(S)
|
||||
I$PROJ==11 ;PROJECT
|
||||
I$DIR==12 ;FILE DIR NAMES
|
||||
I$AUTH==13 ;AUTHORIZATION
|
||||
I$GRP==14 ;GROUP AFFILIATION
|
||||
I$REL==15 ;RELATION TO GROUP
|
||||
I$BRTH==16 ;BIRTHDAY
|
||||
I$REM==17 ;REMARKS
|
||||
I$NETA==20 ;NETWORK ADDRESS
|
||||
I$ALTR==21 ;USER &TIME OF LAST ALTERATION
|
||||
I$MACH==22 ;I.T.S.'S TO BE KNOWN ON.
|
||||
7906
doc/mudman/muddle.order
Normal file
7906
doc/mudman/muddle.order
Normal file
File diff suppressed because it is too large
Load Diff
713
doc/sysdoc/peek.bugs
Executable file
713
doc/sysdoc/peek.bugs
Executable file
@@ -0,0 +1,713 @@
|
||||
Date: Fri, 5 May 89 14:14:14 EDT
|
||||
From: Devon Sean McCullough <DEVON@AI.AI.MIT.EDU>
|
||||
To: BUG-PEEK@AI.AI.MIT.EDU
|
||||
Message-ID: <591317.890505.DEVON@AI.AI.MIT.EDU>
|
||||
|
||||
watching the comsat stats file with 1C, it said
|
||||
MPV; DSKTY3+1>>ILDB B,A B/ 0,,65 a/ 350700,,32000
|
||||
d/ 134
|
||||
|
||||
p/ c,,pdl+2
|
||||
pdl+2/ cam dsktlp+2
|
||||
pdl+1/ cam disk+23
|
||||
pdl/ cam beg8+1
|
||||
|
||||
|
||||
Date: Sun, 20 Mar 88 13:48:17 EST
|
||||
From: Devon Sean McCullough <DEVON@AI.AI.MIT.EDU>
|
||||
To: BUG-PEEK@AI.AI.MIT.EDU
|
||||
Message-ID: <344793.880320.DEVON@AI.AI.MIT.EDU>
|
||||
|
||||
I was sitting in 0C watching COMSAT and I got
|
||||
MPV; 11772>>ILDB 2,1 2/ 151 1/ AOS 16,32000
|
||||
with no apparent provocation. A day or so ago I got MPV right on
|
||||
the heels of a **MORE** (not --more-- which was strange) but I
|
||||
didn't notice where. 31777 seems to be the last word of the buffer
|
||||
being monitored.
|
||||
|
||||
Received: from XX.LCS.MIT.EDU (CHAOS 2420) by AI.AI.MIT.EDU 21 Jan 87 00:29:12 EST
|
||||
Date: Wed, 21 Jan 1987 00:25 EST
|
||||
Message-ID: <SRA.12272592709.BABYL@XX.LCS.MIT.EDU>
|
||||
From: Rob Austein <SRA@XX.LCS.MIT.EDU>
|
||||
To: Alan Bawden <ALAN@AI.AI.MIT.EDU>
|
||||
Cc: BUG-COMSAT@AI.AI.MIT.EDU, BUG-PEEK@AI.AI.MIT.EDU, JTW@AI.AI.MIT.EDU
|
||||
Subject: PEEK shouldn't ever PCLSR anyone
|
||||
In-reply-to: Msg of 18 Jan 1987 22:51-EST from Alan Bawden <ALAN@AI.AI.MIT.EDU>
|
||||
|
||||
Date: Sunday, 18 January 1987 22:51-EST
|
||||
From: Alan Bawden <ALAN@AI.AI.MIT.EDU>
|
||||
|
||||
In the case of the DQ device screw, I don't really understand why PEEK
|
||||
PCLSRing the -server- would cause any kind of deadlock to be broken.
|
||||
|
||||
Not that surprising. Remember that DQ: is a very strange file. In
|
||||
particular, see the code that uses register Y in OUTPUT and BOJINT to
|
||||
avoid hanging forever at the SIOT in OUTPUT. I would not be surprised
|
||||
if that code was intimately involved in this bug, I doubt anybody has
|
||||
ever tried to make a JOB device do anything this twisted before.
|
||||
|
||||
Date: Sun, 18 Jan 87 22:51:43 EST
|
||||
From: Alan Bawden <ALAN@AI.AI.MIT.EDU>
|
||||
Subject: PEEK shouldn't ever PCLSR anyone
|
||||
To: BUG-COMSAT@AI.AI.MIT.EDU, BUG-PEEK@AI.AI.MIT.EDU
|
||||
cc: JTW@AI.AI.MIT.EDU
|
||||
Message-ID: <141778.870118.ALAN@AI.AI.MIT.EDU>
|
||||
|
||||
I just found two obvious places in PEEK that would cause a job to get
|
||||
PCLSR'd.
|
||||
|
||||
The first would PCLSR any job that PEEK suspected might be a MUDDLE job (it
|
||||
had some test involving the contents of the job's accumulators). Despite
|
||||
the comment that threatened to "BREAK THE NECK OF THE ASSHOLE WHO REMOVES
|
||||
ANY CODE HERE WITHOUT CONSULTING ME AND OBTAINING PERMISSION", I removed
|
||||
it.
|
||||
|
||||
The second would PCLSR any job that PEEK suspected might be an interesting
|
||||
job device server. Any job whose JNAME started with the three characters
|
||||
"JOB" would be PCLSR'd when PEEK went into "C" mode because PEEK used
|
||||
.IOT's on the USR: device to probe around in its memory (to see if it was
|
||||
an MLDEV, or other device server it knows about). I fixed this to use
|
||||
memory mapping instead.
|
||||
|
||||
In the case of the DQ device screw, I don't really understand why PEEK
|
||||
PCLSRing the -server- would cause any kind of deadlock to be broken. But
|
||||
in any case, now there is a good chance that the next time COMSAT and DQ
|
||||
get into this state, the mere act of discovering the lossage in PEEK (by
|
||||
going into "C" mode to read the STATS file) will not cause the lossage to
|
||||
vanish. Perhaps we will be able to find the problem now.
|
||||
|
||||
Received: from AI.AI.MIT.EDU by MC.LCS.MIT.EDU via Chaosnet; 13 MAY 86 12:43:22 EDT
|
||||
Date: Tue, 13 May 86 12:44:25 EDT
|
||||
From: Alan Bawden <ALAN@AI.AI.MIT.EDU>
|
||||
To: ZVONA@MC.LCS.MIT.EDU
|
||||
cc: BUG-PEEK@MC.LCS.MIT.EDU
|
||||
In-reply-to: Msg of Mon 12 May 86 20:15:40 EDT from David Chapman <ZVONA at MC.LCS.MIT.EDU>
|
||||
Message-ID: <[AI.AI.MIT.EDU].38227.860513.ALAN>
|
||||
|
||||
Date: Mon, 12 May 86 20:15:40 EDT
|
||||
From: David Chapman <ZVONA at MC.LCS.MIT.EDU>
|
||||
BUG-PEEK is currently archived in MC:RMS;. Should it live in AI:RMS;?
|
||||
Some other directory on AI? Some altogether different place?
|
||||
|
||||
Probably it should go into AI:SYSDOC;.
|
||||
|
||||
Date: Mon, 12 May 86 20:15:40 EDT
|
||||
From: David Chapman <ZVONA@MC.LCS.MIT.EDU>
|
||||
To: BUG-PEEK@MC.LCS.MIT.EDU, KS-ITS@MC.LCS.MIT.EDU
|
||||
cc: ZVONA@MC.LCS.MIT.EDU
|
||||
Message-ID: <[MC.LCS.MIT.EDU].911011.860512.ZVONA>
|
||||
|
||||
BUG-PEEK is currently archived in MC:RMS;. Should it live in AI:RMS;?
|
||||
Some other directory on AI? Some altogether different place?
|
||||
|
||||
Date: Tue, 4 Mar 86 18:15:40 EST
|
||||
From: Alan Bawden <ALAN@MC.LCS.MIT.EDU>
|
||||
Subject: "W" mode sorting
|
||||
To: BUG-PEEK@MC.LCS.MIT.EDU
|
||||
cc: MOON@MC.LCS.MIT.EDU
|
||||
Message-ID: <[MC.LCS.MIT.EDU].838752.860304.ALAN>
|
||||
|
||||
The Internet Routing table ("W" mode) sorting-by-age feature doesn't seem
|
||||
to be functioning properly on AI right now. Perhaps this is because
|
||||
currently AI has entries that are more than 5 days old?
|
||||
|
||||
Date: Mon, 3 Mar 86 02:12:36 EST
|
||||
From: Alan Bawden <ALAN@MC.LCS.MIT.EDU>
|
||||
Subject: " mode in PEEK
|
||||
To: BUG-ITS@MC.LCS.MIT.EDU, BUG-PEEK@MC.LCS.MIT.EDU
|
||||
Message-ID: <[MC.LCS.MIT.EDU].836305.860303.ALAN>
|
||||
|
||||
I added a new mode to PEEK for printing the contents of the system message
|
||||
buffer. (Type a doublequote to get it.) This is especially useful for
|
||||
looking at crash dumps. While I was at it I added a few features to crash
|
||||
dump mode itself. For a good example try (on AI):
|
||||
:PEEK <CRASH;IMP NXM
|
||||
and after looking at the crash dump display, type " to see some more
|
||||
interesting error messages.
|
||||
|
||||
Received: from XX.LCS.MIT.EDU by MC.LCS.MIT.EDU 5 Jan 86 12:36:54 EST
|
||||
Date: Sun, 5 Jan 1986 12:32 EST
|
||||
Message-ID: <SRA.12172848298.BABYL@XX.LCS.MIT.EDU>
|
||||
From: Rob Austein <SRA@XX.LCS.MIT.EDU>
|
||||
To: Chris Lindblad <CJL@OZ.AI.MIT.EDU>
|
||||
Cc: Alan Bawden <ALAN@MC.LCS.MIT.EDU>, BUG-HOSTS3@MC.LCS.MIT.EDU,
|
||||
BUG-PEEK@MC.LCS.MIT.EDU, BUG-RANDOM-PROGRAM@MC.LCS.MIT.EDU,
|
||||
GUMBY@MC.LCS.MIT.EDU, namecallers@MC.LCS.MIT.EDU
|
||||
Subject: Ick!
|
||||
In-reply-to: Msg of 2 Jan 1986 14:33-EST from Chris Lindblad <CJL@OZ.AI.MIT.EDU>
|
||||
|
||||
(Oh bleep, let's put this on namecallers and get it over with already).
|
||||
|
||||
From: Chris Lindblad <CJL@OZ.AI.MIT.EDU>
|
||||
|
||||
Alan points out that when generating the hosts3 table, you only have to
|
||||
be compatible with people who have been using the hosts3 table.
|
||||
|
||||
Not quite. Eg, JIS has MIT-OA.MIT.EDU as the IN-ADDR translation for
|
||||
18.10.0.79, so if anybody out there is still using the old cannonical
|
||||
name algorithm (name->address->name) they will think that is OA's
|
||||
primary name, thus will include it in mail headers, thus people using
|
||||
HOSTS3.BIN should be able to recognize it to avoid barfing on replies.
|
||||
This is probably not as much of a problem for AI as for LCS because of
|
||||
the relative numbers of TCP/IP machines.
|
||||
|
||||
There are bugs in your algorithm anyway. You are taking the name MITAI
|
||||
and generating MIT-MITAI.ARPA, which was never in any domain. (The arpa
|
||||
domain only contained the primary names of hosts).
|
||||
|
||||
Mea culpa.
|
||||
|
||||
I really think it is silly to be genrating all these names. Just because
|
||||
JIS was lazy, and made names like mit-foo.mit.edu shouldn't be a reason
|
||||
for us to clutter our host tables with them. I suggest that as soon as
|
||||
possible, we eliminate references to the mit.edu domain. The longer
|
||||
they're there, the harder it will be to take them out, and there's no
|
||||
better time to make changes like this than during IAP.
|
||||
|
||||
Agreed. I never intended that all that cruft be there permenantly,
|
||||
just for transition to try to keep the world from falling apart too
|
||||
badly too fast. IAP does seem like a good time to punt it.
|
||||
|
||||
Over the next year, more than 100 hosts will be added to the host table.
|
||||
We better start making each entry more compact if we expect it to keep
|
||||
working. Alan says that we have only two pages left.
|
||||
|
||||
Right, but the key point is that HOSTS3 isn't going to work much
|
||||
longer. One of two things will happen: (1) the NIC table will no
|
||||
longer be anything like exhaustive, in which case the table is
|
||||
incomplete, or (2) the NIC table will grow to the point where it is
|
||||
completely unusable. My guess is that we will end up with a
|
||||
HOSTS3.BIN that contains info for MIT, and Chaos-only machines will
|
||||
either have to grok domains or just start blindly sending mail to some
|
||||
forwarder if the address is unrecognized. Eventually HOSTS3 may
|
||||
become identical with HOST3C if/when chaos machines grok domains, but
|
||||
that's not for a while yet.
|
||||
|
||||
For the AI host table. I would be happy if you didn't generate any
|
||||
names, and I specify all the names I want.
|
||||
|
||||
Ok. Nag me if you don't hear about this in the next few days.
|
||||
|
||||
Received: from OZ.AI.MIT.EDU by MC.LCS.MIT.EDU via Chaosnet; 2 JAN 86 14:41:23 EST
|
||||
Date: Thu, 2 Jan 1986 14:33 EST
|
||||
Message-ID: <CJL.12172083807.BABYL@MIT-OZ>
|
||||
From: Chris Lindblad <CJL@OZ.AI.MIT.EDU>
|
||||
To: Rob Austein <SRA@XX.LCS.MIT.EDU>
|
||||
Cc: Alan Bawden <ALAN@MC.LCS.MIT.EDU>, BUG-HOSTS3@MC.LCS.MIT.EDU,
|
||||
BUG-PEEK@MC.LCS.MIT.EDU, BUG-RANDOM-PROGRAM@MC.LCS.MIT.EDU,
|
||||
GUMBY@MC.LCS.MIT.EDU
|
||||
Subject: Ick!
|
||||
In-reply-to: Msg of 2 Jan 1986 13:52-EST from Rob Austein <SRA at MIT-XX>
|
||||
|
||||
Date: Thursday, 2 January 1986 13:52-EST
|
||||
From: Rob Austein <SRA at MIT-XX>
|
||||
|
||||
The problem is that all of those names are in somebody or another's
|
||||
domain space at the present time. JIS has been advertising things
|
||||
like MIT-AI.MIT.EDU, etc. The way things are set up currently you can
|
||||
punt this cruft, but only a on a per-domain basis (ie, for all of
|
||||
AI.MIT.EDU). If you (primarily CJL) want to do this, fine, tell me,
|
||||
I'll do it. But you should think about it first, since people really
|
||||
have been using some of those stupid names.
|
||||
|
||||
Some thoughts on this.
|
||||
|
||||
Alan points out that when generating the hosts3 table, you only have to
|
||||
be compatible with people who have been using the hosts3 table.
|
||||
|
||||
There are bugs in your algorithm anyway. You are taking the name MITAI
|
||||
and generating MIT-MITAI.ARPA, which was never in any domain. (The arpa
|
||||
domain only contained the primary names of hosts).
|
||||
|
||||
I really think it is silly to be genrating all these names. Just because
|
||||
JIS was lazy, and made names like mit-foo.mit.edu shouldn't be a reason
|
||||
for us to clutter our host tables with them. I suggest that as soon as
|
||||
possible, we eliminate references to the mit.edu domain. The longer
|
||||
they're there, the harder it will be to take them out, and there's no
|
||||
better time to make changes like this than during IAP.
|
||||
|
||||
Over the next year, more than 100 hosts will be added to the host table.
|
||||
We better start making each entry more compact if we expect it to keep
|
||||
working. Alan says that we have only two pages left.
|
||||
|
||||
For the AI host table. I would be happy if you didn't generate any
|
||||
names, and I specify all the names I want.
|
||||
|
||||
Received: from XX.LCS.MIT.EDU by MC.LCS.MIT.EDU 2 Jan 86 13:50:05 EST
|
||||
Date: Thu, 2 Jan 1986 13:52 EST
|
||||
Message-ID: <SRA.12172076316.BABYL@XX.LCS.MIT.EDU>
|
||||
From: Rob Austein <SRA@XX.LCS.MIT.EDU>
|
||||
To: Alan Bawden <ALAN@MC.LCS.MIT.EDU>
|
||||
Cc: BUG-HOSTS3@MC.LCS.MIT.EDU, BUG-PEEK@MC.LCS.MIT.EDU,
|
||||
BUG-RANDOM-PROGRAM@MC.LCS.MIT.EDU, GUMBY@MC.LCS.MIT.EDU,
|
||||
SRA@XX.LCS.MIT.EDU, cjl@OZ.AI.MIT.EDU
|
||||
Subject: Ick!
|
||||
In-reply-to: Msg of 1 Jan 1986 02:41-EST from Alan Bawden <ALAN@MC.LCS.MIT.EDU>
|
||||
|
||||
The problem is that all of those names are in somebody or another's
|
||||
domain space at the present time. JIS has been advertising things
|
||||
like MIT-AI.MIT.EDU, etc. The way things are set up currently you can
|
||||
punt this cruft, but only a on a per-domain basis (ie, for all of
|
||||
AI.MIT.EDU). If you (primarily CJL) want to do this, fine, tell me,
|
||||
I'll do it. But you should think about it first, since people really
|
||||
have been using some of those stupid names.
|
||||
|
||||
Date: Wed, 1 Jan 86 02:41:38 EST
|
||||
From: Alan Bawden <ALAN@MC.LCS.MIT.EDU>
|
||||
Subject: Ick!
|
||||
To: BUG-PEEK@MC.LCS.MIT.EDU, BUG-RANDOM-PROGRAM@MC.LCS.MIT.EDU,
|
||||
BUG-HOSTS3@MC.LCS.MIT.EDU, SRA@MC.LCS.MIT.EDU
|
||||
cc: GUMBY@MC.LCS.MIT.EDU
|
||||
Message-ID: <[MC.LCS.MIT.EDU].770028.860101.ALAN>
|
||||
|
||||
Ugh, bletch! Yuck! I just had to go and shuffle the memory layout in
|
||||
(*gag*) PEEK because the HOSTS3 table has grown to be so huge that PEEK has
|
||||
trouble keeping both it and ITS mapped in at the same time. (Gumby, this
|
||||
is what caused that PEEK bug you discovered the other day.) If HOSTS3 gets
|
||||
to be another -two- ITS blocks long, it is going to take some serious
|
||||
thinking to keep PEEK working. Presumably there are other programs out
|
||||
there that, like PEEK, simply were not designed with a 73 block host table
|
||||
in mind.
|
||||
|
||||
I notice that the current host table contains shitloads of totally
|
||||
ridiculous host names. A particularly bad example is AI which has the
|
||||
names:
|
||||
|
||||
AI.AI.MIT.EDU
|
||||
AI
|
||||
AI.MIT.EDU
|
||||
MIT-AI
|
||||
MIT-AI.ARPA
|
||||
MIT-AI.MIT.EDU
|
||||
MIT-MITAI
|
||||
MIT-MITAI.ARPA
|
||||
MIT-MITAI.MIT.EDU
|
||||
MITAI
|
||||
MITAI.AI.MIT.EDU
|
||||
MITAI.MIT.EDU
|
||||
|
||||
Might I suggest eliminating any name that starts with "MIT-" and ends
|
||||
".MIT.EDU"? (Also in the case of AI, I think we can do without the nicname
|
||||
"MITAI" (without hyphen) and its derivatives.)
|
||||
|
||||
Date: Tue, 24 Dec 85 00:58:14 EST
|
||||
From: "Pandora B. Berman" <CENT@MC.LCS.MIT.EDU>
|
||||
Subject: total=out= inf.
|
||||
To: BUG-PEEK@MC.LCS.MIT.EDU
|
||||
Message-ID: <[MC.LCS.MIT.EDU].765406.851224.CENT>
|
||||
|
||||
there's a problem between the Normal mode of P and any other, at least, any
|
||||
other i usually use. when i start a PEEK, the Total= and Out= figures at the
|
||||
screen top are small and fit in their alloted spaces. however, if i switch
|
||||
to some other display (look at some particular job or channel, or the help
|
||||
display) and then back to N, these two numbers balloon to 10 or 12 or so
|
||||
figures long, and the Status column info goes all to hell.
|
||||
|
||||
Date: Thu, 19 Dec 85 21:31:35 EST
|
||||
From: David Vinayak Wallace <GUMBY@MC.LCS.MIT.EDU>
|
||||
Subject: weird display
|
||||
To: BUG-PEEK@MC.LCS.MIT.EDU
|
||||
Message-ID: <[MC.LCS.MIT.EDU].761687.851219.GUMBY>
|
||||
|
||||
Well MBECK was right; I finally was able to duplicate his bug. It's
|
||||
tricky; only seems ta appear if started w/jcl. The symptom is the
|
||||
runnable total and out columns have about 18 digits each, which
|
||||
suggest the uuo which prints them out is somehow bashed. Trumm
|
||||
appears to have a reasonable value in it.
|
||||
|
||||
I dunno.
|
||||
|
||||
Date: Thu, 19 Dec 85 18:04:06 EST
|
||||
From: David Vinayak Wallace <GUMBY@MC.LCS.MIT.EDU>
|
||||
Subject: Strange-looking numbers
|
||||
To: MBECK@MC.LCS.MIT.EDU
|
||||
cc: BUG-PEEK@MC.LCS.MIT.EDU
|
||||
In-reply-to: Msg of Wed 18 Dec 85 21:43:27 EST from Mark E. Becker <MBECK at MC.LCS.MIT.EDU>
|
||||
Message-ID: <[MC.LCS.MIT.EDU].761316.851219.GUMBY>
|
||||
|
||||
Date: Wed, 18 Dec 85 21:43:27 EST
|
||||
From: Mark E. Becker <MBECK at MC.LCS.MIT.EDU>
|
||||
|
||||
Was using Peek 593 when noticed some rather strange-looking numbers
|
||||
for "Runnable Total" and "Out".
|
||||
What do you mean by "strange-looking numbers?" I can't duplicate this.
|
||||
|
||||
Date: Wed, 18 Dec 85 21:43:27 EST
|
||||
From: "Mark E. Becker" <MBECK@MC.LCS.MIT.EDU>
|
||||
To: BUG-PEEK@MC.LCS.MIT.EDU
|
||||
cc: MBECK@MC.LCS.MIT.EDU
|
||||
Message-ID: <[MC.LCS.MIT.EDU].760171.851218.MBECK>
|
||||
|
||||
Was using Peek 593 when noticed some rather strange-looking numbers
|
||||
for "Runnable Total" and "Out". This was after the first display had
|
||||
been output... The JCL was :P 57J 8Z .
|
||||
|
||||
Regards,
|
||||
Mark
|
||||
|
||||
Date: Fri, 13 Dec 85 16:02:11 EST
|
||||
From: "Christopher C. Stacy" <CSTACY@MIT-MC.ARPA>
|
||||
Subject: [macrakis: Supdup lossage]
|
||||
To: BUG-PEEK@MIT-MC.ARPA
|
||||
Message-ID: <[MIT-MC.ARPA].753036.851213.CSTACY>
|
||||
|
||||
Date: Thu, 5 Dec 85 00:08:11 EST
|
||||
From: macrakis at harvard.HARVARD.EDU (Stavros Macrakis)
|
||||
To: bug-supdup at mit-mc.arpa, ddl at harvard.HARVARD.EDU
|
||||
Re: Supdup lossage
|
||||
|
||||
In supdup'ing from Harvard (Unix 4.3) to Mit-MC, everything seems to work
|
||||
perfectly until I try to run Peek. In particular, if I type ahead the
|
||||
Peek command (e.g. `P^KJ'), it hangs up. The only way I seem to be able
|
||||
to get out of this state is to quit (^^q) the supdup and reconnect.
|
||||
Actually, now that I do the test, it appears that even without typeahead,
|
||||
Peek's interrupt characters (commands) never get through. -- p^K ... wait
|
||||
for end of display (space worrks fine at end of screen) ... q [hangs up].
|
||||
The input characters do seem to be buffered up somewhere, because when
|
||||
you type ^Z when it's hung up and before you quit, when you reconnect,
|
||||
the peek has been ^Z'd.
|
||||
|
||||
Date: Mon, 2 Dec 85 17:58:51 EST
|
||||
From: "J. Noel Chiappa" <JNC@MIT-MC.ARPA>
|
||||
Subject: A display
|
||||
To: BUG-PEEK@MIT-MC.ARPA
|
||||
cc: JNC@MIT-MC.ARPA
|
||||
Message-ID: <[MIT-MC.ARPA].738887.851202.JNC>
|
||||
|
||||
Any change of moving the STY list to a separate display?
|
||||
These days that list is pretty long, and over a slow network
|
||||
link it's annoying to have to plought through the whole thing
|
||||
to see the TCP connection list.
|
||||
|
||||
Date: Tue, 6 Aug 85 06:26:44 EDT
|
||||
From: Ken Harrenstien <KLH@MIT-MC.ARPA>
|
||||
Subject: PEEK "bug" fixed
|
||||
To: CSTACY@MIT-MC.ARPA
|
||||
cc: BUG-PEEK@MIT-MC.ARPA, BUG-CRTSTY@MIT-MC.ARPA
|
||||
Message-ID: <[MIT-MC.ARPA].602153.850806.KLH>
|
||||
|
||||
Date: Thu, 9 May 85 00:12:55 EST
|
||||
From: Christopher C. Stacy <CSTACY@MIT-MC>
|
||||
In-reply-to: Msg of Wed 8 May 85 06:33:43 EST from Ken Harrenstien <KLH>
|
||||
|
||||
I still can't reproduce anything close to the the behaviour you
|
||||
described.
|
||||
|
||||
Date: Wed, 8 May 85 06:33:43 EST
|
||||
From: Ken Harrenstien <KLH>
|
||||
To: CSTACY
|
||||
cc: KLH, BUG-PEEK
|
||||
|
||||
Here is how to tickle the PEEK bug. Connect to MC from somewhere
|
||||
else on the Arpanet. Say ":P A". PEEK will clear the screen, and
|
||||
then do nothing.
|
||||
|
||||
OK, I found the problem. It turns out to be in CRTSTY when acting as
|
||||
a SUPDUP user program (CTN). By using IPLIST (like using a howitzer on a
|
||||
housefly) I found that PEEK was sending %TDORS, and ITS was waiting
|
||||
for the remote site to respond with the appropriate Intelligent Terminal
|
||||
Protocol sequence (^\ ^P <V> <H>, which reports the cursor position)
|
||||
before allowing PEEK to do anything else! Since CTN was not responding
|
||||
with that sequence until the user typed some input (due to a spazz
|
||||
by whoever wrote the %TDORS handling code), the effect was that whenever
|
||||
any ITS program did a .RESET TYOC, all output would stop until the user
|
||||
became impatient... as it happens, PEEK does such a reset every time
|
||||
any character is typed at it.
|
||||
|
||||
I have merged the fix into the SYSENG source of CRTSTY.
|
||||
|
||||
Date: Fri, 10 May 85 17:58:29 EST
|
||||
From: Christopher C. Stacy <CSTACY@MIT-MC>
|
||||
To: KLH@MIT-MC
|
||||
cc: BUG-PEEK@MIT-MC
|
||||
In-reply-to: Msg of Thu 9 May 85 20:49:01 EST from Ken Harrenstien <KLH>
|
||||
Message-ID: <[MIT-MC].495962.850510.CSTACY>
|
||||
|
||||
Date: Thu, 9 May 85 20:49:01 EST
|
||||
From: Ken Harrenstien <KLH>
|
||||
To: BUG-PEEK
|
||||
|
||||
This time I said :P A and nothing whatsoever hapened.
|
||||
I ctl-Z'd and found I was at loc 22001, executing an .IOT 14,15
|
||||
with the value "A in 15. I thought the problem might be TCP related
|
||||
but this seems more unlikely. CSTACY, maybe you should try
|
||||
logging in as something else?
|
||||
|
||||
Something is obviously screwing you, but I still can't duplicate it.
|
||||
The previous tests were conducted under a variety of UNAMEs.
|
||||
Here are the gory details of my latest attempt.
|
||||
|
||||
I logged into MC over 1200 baud dialup, and did :TN NIC and logged in
|
||||
over there. I ran @TELNET MC and NIC connected me to MC where I
|
||||
received a DDT and did not log in (having made arrangements with PWORD
|
||||
for this earlier). I typed ":P A". I got the same results as
|
||||
yesterday -- PEEK worked.
|
||||
|
||||
I flushed all my connections back to MC and typed ":TN NIC". I logged
|
||||
into NIC and did "@TELNET MC". NIC connected me to MC and I logged in
|
||||
as a normal user without any init file. I typed ":P A", and PEEK
|
||||
worked. I typed "J" and it worked; I used "X" to gun myself down.
|
||||
|
||||
Maybe somehow the problem is terminal-type specific.
|
||||
Does it happen to you if you don't run TCTYP?
|
||||
|
||||
Date: Thu, 9 May 85 20:49:01 EST
|
||||
From: Ken Harrenstien <KLH@MIT-MC>
|
||||
To: BUG-PEEK@MIT-MC
|
||||
Message-ID: <[MIT-MC].494254.850509.KLH>
|
||||
|
||||
This time I said :P A and nothing whatsoever hapened.
|
||||
I ctl-Z'd and found I was at loc 22001, executing an .IOT 14,15
|
||||
with the value "A in 15. I thought the problem might be TCP related
|
||||
but this seems more unlikely. CSTACY, maybe you should try
|
||||
logging in as something else?
|
||||
|
||||
Date: Thu, 9 May 85 00:12:55 EST
|
||||
From: Christopher C. Stacy <CSTACY@MIT-MC>
|
||||
Subject: can't reproduce bug
|
||||
To: KLH@MIT-MC
|
||||
cc: BUG-PEEK@MIT-MC
|
||||
In-reply-to: Msg of Wed 8 May 85 06:33:43 EST from Ken Harrenstien <KLH>
|
||||
Message-ID: <[MIT-MC].492640.850509.CSTACY>
|
||||
|
||||
|
||||
I still can't reproduce anything close to the the behaviour you
|
||||
described.
|
||||
|
||||
Date: Wed, 8 May 85 06:33:43 EST
|
||||
From: Ken Harrenstien <KLH>
|
||||
To: CSTACY
|
||||
cc: KLH, BUG-PEEK
|
||||
|
||||
Here is how to tickle the PEEK bug. Connect to MC from somewhere
|
||||
else on the Arpanet. Say ":P A". PEEK will clear the screen, and
|
||||
then do nothing.
|
||||
|
||||
I did some tests from various net hosts (using TELNET to get to the
|
||||
remote site, and their TELNET to get to MC.) I invoked PEEK with
|
||||
":PEEK", and ":P A", and excersized the A,J,N,Z, and X commands.
|
||||
I tried several of these tests 2 or 3 times.
|
||||
|
||||
1. PEEK works normally over LispM or MINITS Chaosnet SUPDUP.
|
||||
|
||||
2. Over a MINITS Chaosnet TELNET connection, PEEK works normally,
|
||||
except that it does not update the display automatically.
|
||||
PEEK starts up, displays whatever it is supposed to *twice*,
|
||||
and then just sits there, and you have to type another command,
|
||||
or use SPACE or Z. I think it is supposed to be a feature that
|
||||
there is a long (infinite?) initial sleep time when the
|
||||
console is a printing terminal. All the commands seem to work.
|
||||
It is a bug that on a printing terminal it does the initial
|
||||
display twice.
|
||||
|
||||
3. I tested PEEK TNing to MC from SCORE, being a Datamedia
|
||||
terminal. PEEK worked normally.
|
||||
|
||||
4. From BRL-BMD as a printing terminal, the sucky TCP connection
|
||||
was almost unbearably slow, but PEEK seemed to behave the same
|
||||
as on a MINITS Chaos TELNET connection.
|
||||
|
||||
5. From SRI-NIC as a printing terminal, PEEK seemed to behave the
|
||||
same as on a MINITS Chaos TELNET connection. BTW, the thing
|
||||
which it echoes at ":P A" is an "A" (folowed by the correct
|
||||
display.)
|
||||
|
||||
6. As a final test, I came in from SRI-NIC and :TCTYP DM2500.
|
||||
I typed ":P A". It echoed "A", paused for 1 second, and
|
||||
gave me one normal ARPAnet display. After 20 seconds it
|
||||
updated it. I typed "J", and it did. I used the "X"
|
||||
command to gun myself down.
|
||||
|
||||
|
||||
Beats me to death.
|
||||
|
||||
|
||||
Date: Wed, 8 May 85 06:33:43 EST
|
||||
From: Ken Harrenstien <KLH@MIT-MC>
|
||||
To: CSTACY@MIT-MC
|
||||
cc: KLH@MIT-MC, BUG-PEEK@MIT-MC
|
||||
Message-ID: <[MIT-MC].491306.850508.KLH>
|
||||
|
||||
Here is how to tickle the PEEK bug. Connect to MC from somewhere
|
||||
else on the Arpanet. Say ":P A". PEEK will clear the screen, and
|
||||
then do nothing. That's right, nothing. Eventually you will get
|
||||
impatient, and type a space. Bang! Suddenly there is a flash
|
||||
of something echoed too quickly to see (^A?), and the PEEK "A" display
|
||||
appears. As far as X and Y go, nothing will happen. I don't know if
|
||||
all this is something net-specific, but if it is it should be flushed.
|
||||
Possibly the JCL handling is messed up?
|
||||
|
||||
It seems to be solidly repeatable.
|
||||
|
||||
Date: Tue, 7 May 85 19:19:52 EST
|
||||
From: Christopher C. Stacy <CSTACY@MIT-MC>
|
||||
To: KLH@MIT-MC
|
||||
cc: BUG-PEEK@MIT-MC
|
||||
In-reply-to: Msg of Tue 7 May 85 17:33:21 EST from Ken Harrenstien <KLH>
|
||||
Message-ID: <[MIT-MC].490642.850507.CSTACY>
|
||||
|
||||
|
||||
When I run PEEK, it automatically displays things for me. The X and Y
|
||||
commands work fine for me. Glancing at a source compare of the latest
|
||||
PEEK with the version from 1983, the only changes I see are where
|
||||
people have installed some meter modes for some network stuff.
|
||||
|
||||
However, there is a very old bug which bites me sometimes, where PEEK
|
||||
apparently does not turn its interrupts on or something. When it gets
|
||||
to a **MORE** break, it hangs (and the prompt is wrong so the more
|
||||
handler has clearly not gone off.) I think that in this mode, no
|
||||
characters typed do anything. Somebody should track this down
|
||||
someday, but it is sporadic and has been happenning for years.
|
||||
|
||||
Are you thinking of this latter bug, or are you claiming that PEEK is
|
||||
completely broken? It normally works fine for me many times each day.
|
||||
|
||||
Date: Tue, 7 May 85 17:33:21 EST
|
||||
From: Ken Harrenstien <KLH@MIT-MC>
|
||||
To: BUG-PEEK@MIT-MC
|
||||
Message-ID: <[MIT-MC].490459.850507.KLH>
|
||||
|
||||
For a few months now I've noticed that PEEK has been broken. I
|
||||
wasn't quite sure whether to believe it at first, but now I'm
|
||||
relatively sure. The problem is that PEEK does not go ahead and
|
||||
show things on its own -- you hae to type a space or something to force
|
||||
output, it seems. For certain commands like X and Y it simply does
|
||||
not work or do anything. Now, I grant this may hae happened because of
|
||||
someone's idea of "new improved featurefulness" but I find it annoying.
|
||||
|
||||
Date: 26 January 1985 02:39-EST
|
||||
From: Christopher C. Stacy <CSTACY @ MIT-MC>
|
||||
To: BUG-FINGER @ MIT-MC, BUG-PEEK @ MIT-MC
|
||||
cc: ALAN @ MIT-MC
|
||||
|
||||
Does not mention when system is being debugged unless users are not allowed on.
|
||||
|
||||
Date: 13 January 1985 01:37-EST
|
||||
From: Christopher C. Stacy <CSTACY @ MIT-MC>
|
||||
To: HDT @ MIT-MC
|
||||
cc: BUG-PEEK @ MIT-MC
|
||||
|
||||
First, you could just re-own the wholine job with :JOB WHOLIN
|
||||
and then :KILL it, rather than using PEEK. I don't know why
|
||||
PEEK behaves the way you describe, but someone can look at it
|
||||
someday I guess.
|
||||
|
||||
Date: 13 January 1985 01:30-EST
|
||||
From: Howard D. Trachtman <HDT @ MIT-MC>
|
||||
To: BUG-PEEK @ MIT-MC
|
||||
cc: HDT @ MIT-MC
|
||||
|
||||
I had a detached tree which I was trying to kill in peek.
|
||||
I couldn't kill it. Basically I just wanted to get rid of
|
||||
my wholin which was disowned and screwing me. number, etg. 32Y
|
||||
offered to kill my entire tree (two hactr*'s) and I thought this
|
||||
was a bug. I got rid of some useless jobs so that if it actually
|
||||
went and killed the tree off I could live also. But they still wouldn't
|
||||
got away. 5 minutes later, the system console printed that
|
||||
it killed my hour old detached job. If this is at all interesting,
|
||||
I can provide some more info, but I don't want to bore you all otherwise.
|
||||
|
||||
Date: 22 December 1984 04:32-EST
|
||||
From: Pandora B. Berman <CENT @ MIT-MC>
|
||||
Subject: PEEK down warning broken
|
||||
To: BUG-PEEK @ MIT-MC
|
||||
cc: BUG-FOO @ MIT-MC
|
||||
|
||||
P pretends it is warning you that the system is being taken down. however,
|
||||
the warning code is fukt. the warning (in the J display, at least) looks like
|
||||
System going down in <timeA> (<timeB>)
|
||||
where <timeA> is supposedly the remaining increment until the actual <timeB>
|
||||
occurs. you'd expect that <timeB> would remain constant and <timeA> would
|
||||
decrement to 0. what really happens, though, is <timeA> remains constant
|
||||
(and doesn't jibe with the down warnings produced at top level), and <timeB>
|
||||
increments to fit <timeA>!! please fix.
|
||||
|
||||
Date: 25 August 1984 16:16-EDT
|
||||
From: David A. Moon <MOON @ MIT-MC>
|
||||
To: BUG-PEEK @ MIT-MC
|
||||
|
||||
Needs to be fixed to work when the amount of free memory in the header
|
||||
runs into four digits (!!)
|
||||
|
||||
Date: 18 March 1984 21:40-EST
|
||||
From: Jon Solomon <JSOL @ MIT-MC>
|
||||
To: BUG-PEEK @ MIT-MC
|
||||
|
||||
Sigh, every time I peek at the comsat stats file it gives me
|
||||
an :$MPV not handled$ error and punts. This time after perhaps
|
||||
two screenfuls. I'm on a vt100 running in vt52 mode, and I have
|
||||
had this happen on vt100s running vt100 mode, and H19s.
|
||||
|
||||
--jsol
|
||||
|
||||
Date: 15 November 1983 19:04 EST
|
||||
From: Alan Bawden <ALAN @ MIT-MC>
|
||||
Subject: E
|
||||
To: BUG-PEEK @ MIT-MC
|
||||
|
||||
Is there documentation anywhere for the "E" command?
|
||||
|
||||
Date: 28 October 1983 06:56 EDT
|
||||
From: David Vinayak Wallace <GUMBY @ MIT-MC>
|
||||
To: BUG-PEEK @ MIT-MC
|
||||
|
||||
How come the down time message is so fukt?
|
||||
|
||||
Date: 21 October 1983 16:47 EDT
|
||||
From: Jeffrey P. Golden <JPG @ MIT-MC>
|
||||
To: BUG-PEEK @ MIT-MC
|
||||
|
||||
Someone should fix the "System going down in" message in PEEK.
|
||||
The times it gives are preposterous.
|
||||
|
||||
Date: 19 July 1983 03:10 EDT
|
||||
From: Jeffrey P. Golden <JPG @ MIT-MC>
|
||||
To: BUG-PEEK @ MIT-MC
|
||||
|
||||
When I use LOCK to take the system down, it used to say
|
||||
'System going down in 15:00' or whatever.
|
||||
Now it says:
|
||||
'System going down in 3:06:21:21 ( 3:09:28:44)'
|
||||
These huge mysterious numbers are not very helpful.
|
||||
|
||||
Date: 9 July 1983 06:46 EDT
|
||||
From: Christopher C. Stacy <CSTACY @ MIT-MC>
|
||||
Subject: [ELLEN: forwarded]
|
||||
To: BUG-PEEK @ MIT-MC
|
||||
|
||||
Date: 07/08/83 03:46:40
|
||||
From: ELLEN
|
||||
To: CSTACY
|
||||
cc: ELLEN
|
||||
|
||||
wierd Peek...
|
||||
Peek seems not only to not allow you to type a space to redisplay
|
||||
during an "O", but it also sometimes gets into a state where a space
|
||||
will not do anything, no how... I can identify this state because
|
||||
the "More" at the bottom will be
|
||||
|
||||
**More**
|
||||
|
||||
instead of
|
||||
|
||||
--More--
|
||||
|
||||
I regret that at this instant I cannot tell you how to produce this
|
||||
state. But I suspect it might be related to hopping in and out of
|
||||
PEEK repeatedly... as I sometimes do... then one time I suddenly
|
||||
notice this wierdness...
|
||||
I consider this highly wierd, and am sending this to you, to forward
|
||||
as you please, since I believe it was you who last modified PEEK.
|
||||
Cheers.
|
||||
|
||||
gsb@MIT-ML (Sent by TAR@MIT-ML) 05/08/83 00:56:23
|
||||
To: (BUG PEEK) at MIT-ML
|
||||
If i type ahead stuff at peek (like i do
|
||||
peek
|
||||
jjjjjjjjjjjjjjjjjj
|
||||
)
|
||||
then i can make it use **MORE** rather than --More--.
|
||||
This is especially amusing because in **MORE** in peek, the two things
|
||||
which do not work are space and rubout.
|
||||
|
||||
|
||||
20
doc/system/-read-.-this-
Normal file
20
doc/system/-read-.-this-
Normal file
@@ -0,0 +1,20 @@
|
||||
This directory contains the files which are assembled to produce the system, ITS.
|
||||
|
||||
ITS Main part of system
|
||||
IMP ARPA Network
|
||||
ITSDEV Miscellaneous devices
|
||||
ITSDIS E&S display
|
||||
ITSMSP Message slurper
|
||||
MTAPE Macrotape
|
||||
UTAPE Microtape
|
||||
TS3TTY Terminal service
|
||||
TTYTYP Terminal type definitions
|
||||
WHOVAR Wholine variables in TV-11
|
||||
TV TV service (runs in 11)
|
||||
DISK Disk service and file system
|
||||
FSDEFS Machine-independent file system definitions
|
||||
DC10 Systems Concepts DC10 disk control definitions
|
||||
RP10 DEC RP10 disk control definitions
|
||||
RH10 DEC RH10 disk control definitions
|
||||
TIME Real (wall clock) time routines
|
||||
|
||||
89
doc/xfont/kst.format
Normal file
89
doc/xfont/kst.format
Normal file
@@ -0,0 +1,89 @@
|
||||
M.I.T. FONT FILES: THE KST FORMAT
|
||||
|
||||
Each KST font file (usually has "KST" as its second filename)
|
||||
has the following general format, regardless of type style or size:
|
||||
|
||||
a two-word header ("word" means 36-bit PDP-10 word)
|
||||
an arbitrary number of character blocks (up to 128.), of a
|
||||
variable number of words each
|
||||
an end-of-file flag, the number -1 (77777777777777777777 octal)
|
||||
(however, there have always been two such flags at the end
|
||||
of all KST font files, and should continue that way).
|
||||
|
||||
THE HEADER
|
||||
|
||||
The first word is the "KSTID", which is ignored by all programs
|
||||
at M.I.T. It is normally zero. The second word contains the Column
|
||||
Position Adjust (CPA), which is 0 for all of our files, the baseline
|
||||
(BL) of the font, and the height (HT) of the font. Arrangment is as
|
||||
|
||||
0 8 9 17 18 35
|
||||
------------------------------------------
|
||||
| CPA | BL | HT |
|
||||
------------------------------------------
|
||||
|
||||
The height is the total number of scan lines required by any character
|
||||
in the font, and is the number of scan lines contained in each
|
||||
character block which follows. The basseline gives the number of scan
|
||||
lines ABOVE the baseline for every character in the font.
|
||||
|
||||
THE CHARACTER BLOCK
|
||||
|
||||
Each character block has a three-word header. The first word is a
|
||||
1, which serves as a convenient separator between character blocks.
|
||||
[This is because only the high 32. bits of each raster word are used,
|
||||
with the low 4 being zero.] The second word contains the left kern
|
||||
(LK) for the character, and the Ascii code:
|
||||
|
||||
0 17 18 35
|
||||
------------------------------------------
|
||||
| LK | Ascii char code |
|
||||
------------------------------------------
|
||||
|
||||
The third word contains the raster width (RW) for the character, and
|
||||
its character width (CW):
|
||||
|
||||
0 17 18 35
|
||||
------------------------------------------
|
||||
| RW | CW |
|
||||
------------------------------------------
|
||||
|
||||
The left kern gives the number of units (XGP points) to start the
|
||||
actual raster display to the LEFT of the current character position.
|
||||
A negative number means to start the raster to the right of the
|
||||
current position abs(LK) units. The raster width gives the number
|
||||
of bits which occur in each line of the following raster array for
|
||||
the character. The character width is the number of units to advance
|
||||
the current position after the character is printed. NOTE: CW is not
|
||||
measured from where the raster actually is placed, but from the
|
||||
current character position; that is, the LK is totally ignored when
|
||||
advancing the current position. This means that, in general,
|
||||
adjusting the left kern of a character requires changing its CW as
|
||||
well.
|
||||
|
||||
After this three-word header comes the actual raster display.
|
||||
There are HT lines, each of RW bits. The bits are grouped into 8-bit
|
||||
bytes, with four bytes per PDP-10 word. The low 4 bits of each word
|
||||
in the raster display MUST be zero. The bytes in each word correspond
|
||||
left to right with bits from the raster matrix (that is, bytes are
|
||||
used left to right in printing each line of the character). However,
|
||||
within each byte the bits are REVERSED, so are used right to left
|
||||
within the byte. This is an artifact of the way the bytes are shipped
|
||||
to the PDP-11 running the XGP. If RW is not a multiple of 8 bits,
|
||||
the remaining bits in the last byte of each scan line are zero. Each
|
||||
scan line begins on a new 8-bit byte. After the last scan line,
|
||||
remaining bytes in the word are zero.
|
||||
|
||||
The next word after the last scan line will be either a 1,
|
||||
signalling the next character block, or -1 for the end-of-file
|
||||
(followed by another -1).
|
||||
|
||||
NOTES
|
||||
|
||||
* The order of the character blocks within the file is not significant
|
||||
(that is, they don't have to be in "alphabetical" order).
|
||||
* The low order bits in each raster display word must be zero; unused
|
||||
bits in scan line raster must be zero.
|
||||
* Not all 128. Ascii characters need to be defined in the file.
|
||||
* Each raster display must have HT lines, even if those below the
|
||||
baseline are zero (unlike the AST files in this respect).
|
||||
Reference in New Issue
Block a user