NameDBImpl.Mesa
Copyright Ó 1987, 1990 by Xerox Corporation. All rights reserved.
Last modified by Swinehart, October 4, 1989 5:15:47 pm PDT
Polle Zellweger (PTZ) August 23, 1990 9:18:26 pm PDT
Vin, July 24, 1990 1:24 pm PDT
DIRECTORY
Atom USING [ MakeAtom ],
BasicTime USING [ FromNSTime, GMT, Now, nullGMT, Period, ToNSTime, Update ],
Booting USING [ RegisterProcs, RollbackProc ],
Commander USING [ CommandProc, Handle, Register ],
CommandTool USING [ NextArgument ],
Convert USING [ CardFromRope ],
DESFace USING [ CorrectParity, EncryptBlock ],
IO,
LoganBerry USING [ AttributeType, AttributeValue, Close, DeleteEntry, Error, Open, OpenDB, ReadEntry, WriteEntry ],
LoganBerryExtras USING [ IsLocal, RegisterWriteProc, WriteProc ],
NameDB USING [ AttributeSeq, Authenticity ],
NameDBBackDoor,
Process USING [ Detach ],
RefID USING [ nullID ],
RefTab USING [ Create, Fetch, Ref, Store ],
Rope USING [ Equal, Length, ROPE, SkipOver ],
RPC USING [ EncryptionKey ],
SymTab USING [ Create, Delete, Erase, Fetch, Ref, Store ],
UserProfile USING [ Token ],
VoiceUtils USING [ NetAddress, NetAddressFromRope, nullNetAddress ]
;
NameDBImpl:
CEDAR
MONITOR
Lock as little as possible
IMPORTS Atom, BasicTime, Booting, Commander, CommandTool, Convert, DESFace, IO, LoganBerry, LoganBerryExtras, Process, RefTab, Rope, SymTab, UserProfile, VoiceUtils
EXPORTS NameDB, NameDBBackDoor = {
Data
ROPE: TYPE= Rope.ROPE;
AttributeSeq: TYPE = NameDB.AttributeSeq; -- LoganBerry.Entry = LIST OF [$attribute, value]
OpenDB:
TYPE =
REF OpenDBBody;
nullDB: OpenDB = NIL;
OpenDBBody:
TYPE =
RECORD [
db: LoganBerry.OpenDB←RefID.nullID,
dbCache: DBCache ← NIL,
timeoutCache: BOOL←TRUE, -- TRUE if should time out entries based on timeToLive
timeToLive: INT ← 20 -- Seconds duration of NameDB cache entries.
];
Error:
PUBLIC
ERROR [ec:
ATOM, explanation: Rope.
ROPE ←
NIL] =
CODE;
Mostly just repeats LoganBerry errors.
DBCache: TYPE = SymTab.Ref;
DBHandle:
TYPE =
RECORD [
-- In case there ever have to be instances
dbPrefix: Rope.ROPE,
conversation: RPC.Conversation←RPC.unencrypted,
white: OpenDB←nullDB, -- Name/number database
blue: OpenDB←nullDB, -- Name/Lark/Workstation/Preferences database
red: OpenDB←nullDB, -- GV cache database
doCache: BOOL ← TRUE,
whiteTTL: INT ← 60*60*4, -- 4 hours cache duration
blueTTL: INT ← 20, -- short cache duration
redTTL: INT ← 60*60 -- 1 hour cache duration
];
dbHandle: DBHandle; -- There is but one instance now.
minQueryInterval:
INT ← 60;
Don't query Grapevine about any given value any more frequently.
conversationLevel: RPC.ConversationLevel ← ECB;
Procedures exported to NameDB
GetAttributes:
PUBLIC
PROC[rName:
ROPE, key:
ATOM←$rname, dbType:
ATOM←$white]
RETURNS [value: AttributeSeq←NIL] = {
ENABLE { UNWIND => NULL; LoganBerry.Error => Error[ec, explanation]; };
RETURN[ReadEntry[db: DBFromType[dbType], key: key, value: rName].attributes];
};
GetAttribute:
PUBLIC
PROC[
rName: ROPE, attribute: ATOM, default: ROPE←NIL, key: ATOM←$rname]
RETURNS [value: ROPE←NIL] = {
ENABLE { UNWIND => NULL; LoganBerry.Error => Error[ec, explanation]; };
dbKType: ATOM;
dbType: ATOM;
openDB: OpenDB;
cached: BOOL←FALSE;
attributes: AttributeSeq;
If key#rname, acquire the rname
[dbKType, , openDB] ← WhichDB[key];
IF dbKType#$noProbe
THEN {
attributes ← ReadEntry[db: openDB, key: key, value: rName].attributes;
rName ← FetchAttribute[attributes, $rname, NIL].value;
IF rName=NIL THEN RETURN[default];
};
If attribute is not in the same entry, use rName to get the entry it's in.
[dbType, , openDB] ← WhichDB[attribute];
SELECT dbType
FROM
$red => RETURN[GetGVAttribute[rName, attribute, default]];
$noProbe => RETURN[rName];
#dbKType => attributes ← ReadEntry[db: openDB, key: $rname, value: rName].attributes;
ENDCASE;
Obtain the specified attribute
value ← FetchAttribute[attributes, attribute, default].value;
If we're dealing with a timed value, select one of timed.attribute and untimed.attribute
IF value.Equal["#"]
THEN {
value ← FetchAttribute[attributes, TAttr[attribute, "time"]].value;
value ← FetchAttribute[attributes, TAttr[attribute,
(IF value#NIL AND RelTime[value] > 0 THEN "timed" ELSE "untimed")], default].value;
};
};
SetAttribute:
PUBLIC
PROC[rName:
ROPE, attribute:
ATOM, value:
ROPE] = {
ENABLE { UNWIND => NULL; LoganBerry.Error => Error[ec, explanation]; };
dbType: ATOM;
openDB: OpenDB;
attributes: AttributeSeq;
previousValue: ROPE;
IF value#
NIL
THEN
SELECT attribute
FROM
$larkhost, $workstationhost => {
These secondary keys must be unique. Cancel any previous values.
oldRname: ROPE=GetAttribute[value, $rname, NIL, attribute];
IF oldRname#NIL THEN
SetAttribute[rName: oldRname, attribute: attribute, value: NIL];
};
ENDCASE;
[dbType, , openDB] ← WhichDB[attribute];
IF dbType=$noProbe
THEN
RETURN;
Can't alter primary key! And deletion of entire entries is done by hand.
attributes ← ReadEntry[openDB, $rname, rName,
FALSE].attributes;
Don't trust cached values for write!
IF attributes=NIL THEN attributes ← LIST[[$rname, rName]];
previousValue ← FetchAttribute[attributes, attribute].value;
IF previousValue.Equal[value] THEN RETURN; -- previous was untimed and equal
attributes ← StoreAttribute[attributes, attribute, value];
IF previousValue.Equal["#"]
THEN {
-- Remove the timed values
attributes ← StoreAttribute[attributes, TAttr[attribute, "timed"], NIL];
attributes ← StoreAttribute[attributes, TAttr[attribute, "untimed"], NIL];
attributes ← StoreAttribute[attributes, TAttr[attribute, "time"], NIL];
};
LoganBerry.WriteEntry[db: openDB.db, entry: attributes, replace: TRUE];
};
SetAttributeTimed:
PUBLIC
PROC[
rName: Rope.ROPE, attribute: ATOM, value: Rope.ROPE,
time: BasicTime.GMT�sicTime.nullGMT, interval: INT𡤀] = {
ENABLE LoganBerry.Error => Error[ec, explanation];
dbType: ATOM;
keyClass: KeyClass;
openDB: OpenDB;
attributes: AttributeSeq;
untimedValue: Rope.ROPE;
wasUntimed: BOOL;
IF time=BasicTime.nullGMT THEN time ← BasicTime.Update[BasicTime.Now[], interval];
[dbType, keyClass, openDB] ← WhichDB[attribute];
IF keyClass#$notKey
THEN
Error[$InvalidAttribute, "SetAttributeTimed cannot be applied to an attribute that is also a key"];
attributes ← ReadEntry[openDB, $rname, rName, FALSE].attributes; -- No trust cache
IF attributes=NIL THEN attributes ← LIST[[$rname, rName]];
untimedValue ← FetchAttribute[attributes, attribute].value;
wasUntimed ← ~Rope.Equal[untimedValue, "#"];
IF wasUntimed
AND untimedValue#
NIL
THEN
attributes ← StoreAttribute[attributes, TAttr[attribute, "untimed"], untimedValue];
attributes ← StoreAttribute[attributes, TAttr[attribute, "timed"], value];
attributes ← StoreAttribute[attributes, TAttr[attribute, "time"], TimeRope[time]];
IF wasUntimed THEN attributes ← StoreAttribute[attributes, attribute, "#"];
LoganBerry.WriteEntry[db: openDB.db, entry: attributes, replace: TRUE];
};
Authenticate:
PUBLIC
PROC[rName:
ROPE, key:
RPC.EncryptionKey]
RETURNS [authenticity: NameDB.Authenticity←$unknown] = {
ENABLE {
LoganBerry.Error => Error[ec, explanation];
Error => IF ec = $GVServersDown THEN CONTINUE;
};
keyRope: ROPE ← GetGVAttribute[rName, $key, NIL, TRUE, key];
RETURN[
SELECT
TRUE
FROM
keyRope=NIL => $nonexistent,
keyRope.Equal["?"] => $bogus,
ENDCASE => $authentic
];
};
IsAuthenticated:
PUBLIC PROC[rName:
ROPE]
RETURNS [authenticity: NameDB.Authenticity ← $unknown] = {
ENABLE {
LoganBerry.Error => Error[ec, explanation];
Error => IF ec = $GVServersDown THEN CONTINUE;
};
key: ROPE ← GetGVAttribute[rName, $key, NIL];
RETURN[
SELECT
TRUE
FROM
key=NIL => $nonexistent,
key.Equal["?"] => $perhaps,
ENDCASE => $authentic
];
};
HostFromInstance:
PUBLIC PROC[instance: Rope.
ROPE]
RETURNS [VoiceUtils.NetAddress←VoiceUtils.nullNetAddress] = {
netAddressAsRope: ROPE = GetAttribute[instance, $connect];
IF netAddressAsRope#
NIL
THEN
RETURN[VoiceUtils.NetAddressFromRope[netAddressAsRope]];
};
Grapevine update
nullKey: RPC.EncryptionKey = ALL[0];
GetGVAttribute:
PROC[
rName: ROPE, attribute: ATOM, default: ROPE,
keySupplied: BOOL←FALSE, encryptionKey: RPC.EncryptionKey←nullKey]
RETURNS[value: ROPE←NIL] = {
openDB: OpenDB ← DBFromType[$red];
attributes: AttributeSeq;
cached: BOOL;
[attributes, cached] ← ReadEntry[openDB, $rname, rName];
IF attributes=
NIL
OR
(attribute=$key
AND keySupplied
AND
~FetchAttribute[attributes, $key, "?"].value.Equal[KeyRope[encryptionKey]]) THEN
[attributes, cached] ← GetGVUpdate[rName, keySupplied, encryptionKey];
value ← FetchAttribute[attributes, attribute, default].value;
IF ~cached THEN QueueGVUpdate[rName, keySupplied, encryptionKey];
};
GetGVUpdate:
PROC[
rName: ROPE, keySupplied: BOOL←FALSE, encryptionKey: RPC.EncryptionKey←nullKey]
RETURNS[attributes: AttributeSeq←NIL, cached: BOOL←FALSE] = {
info: GVNames.Outcome;
openDB: OpenDB ← DBFromType[$red];
connect: ROPE;
changed: BOOL←FALSE;
keyRope: ROPE←NIL;
oldKeyRope: ROPE←NIL;
[info, connect] ← GVNames.GetConnect[rName];
SELECT info FROM
individual => IF connect=NIL OR connect.Length[]=0 THEN connect ← "?";
group, notFound => connect ← DeleteGVEntry[rName];
wrongServer, allDown => Error[$GVServersDown, "All GV servers down"];
protocolError => Error[$GVNamesProtocolViolation, "GV Names protocol violation"];
ENDCASE => Error[$GVNamesProtocolViolation, "Unknown return code"];
IF connect=NIL THEN RETURN;
IF keySupplied THEN {
SELECT GVNames.AuthenticateKey[rName, encryptionKey] FROM
group, notFound => keyRope ← DeleteGVEntry[rName];
individual => keyRope ← KeyRope[encryptionKey];
protocolError => Error[$GVNamesProtocolViolation, "GV Names protocol violation"];
wrongServer, allDown => Error[$GVServersDown, "All GV servers down"];
badPwd => keyRope ← "?";
ENDCASE => Error[$GVNamesProtocolViolation, "Unknown return code"];
IF keyRope=NIL THEN RETURN; -- Hmmm; individual existed for connect, but not now!
};
attributes ← ReadEntry[openDB, $rname, rName].attributes; -- accept cached value
-- attributes ← ReadEntry[openDB, $rname, rName, FALSE].attributes;
IF attributes=NIL THEN attributes ← LIST[[$rname, rName]];
IF ~connect.Equal[FetchAttribute[attributes, $connect, NIL].value] THEN {
DeleteFromCache[openDB, attributes];
changed ← TRUE; attributes ← StoreAttribute[attributes, $connect, connect]; };
oldKeyRope ← FetchAttribute[attributes, $key, NIL].value;
IF oldKeyRope=NIL AND keyRope=NIL THEN {
DeleteFromCache[openDB, attributes];
changed ← TRUE; attributes ← StoreAttribute[attributes, $key, "?"]; }
ELSE IF keyRope#NIL AND ~keyRope.Equal[oldKeyRope] AND ~keyRope.Equal["?"] THEN {
DeleteFromCache[openDB, attributes];
changed ← TRUE; attributes ← StoreAttribute[attributes, $key, keyRope]; };
IF changed THEN LoganBerry.WriteEntry[
db: dbHandle.red.db, entry: attributes, replace: TRUE];
RecordCache[openDB, attributes];
cached ← TRUE;
};
DeleteGVEntry:
PROC[rName:
ROPE]
RETURNS [nilRope:
ROPE←
NIL] = {
IF dbHandle.white=nullDB OR rName=NIL THEN RETURN;
LoganBerry.DeleteEntry[db: DBFromType[$red].db, key: $rname, value: rName];
};
QueueGVUpdate:
PROC[
rName: ROPE, keySupplied: BOOL←FALSE, encryptionKey: RPC.EncryptionKey] = TRUSTED {
Process.Detach[FORK ForkGVUpdate[rName, keySupplied, encryptionKey]];
};
ForkGVUpdate:
PROC[rName:
ROPE, keySupplied:
BOOL←
FALSE, encryptionKey:
RPC.EncryptionKey] = {
ENABLE Error => CONTINUE; -- Should report it, I guess.
[] ← GetGVUpdate[rName, keySupplied, encryptionKey];
};
KeyRope:
PUBLIC
-- to back door --
PROC[key:
RPC.EncryptionKey]
RETURNS[keyRope:
ROPE] =
TRUSTED {
encryptedKey: RPC.EncryptionKey;
cpKey: RPC.EncryptionKey ← key;
halves:
LONG
POINTER
TO
RECORD[firstHalf:
CARD, secondHalf:
CARD] ←
LOOPHOLE[LONG[@encryptedKey]];
DESFace.CorrectParity[LOOPHOLE[LONG[@cpKey]]];
DESFace.EncryptBlock[key: LOOPHOLE[cpKey], from: @key, to: LOOPHOLE[halves]];
keyRope ← IO.PutFR["%bB %bB", [cardinal[halves.firstHalf]], [cardinal[halves.secondHalf]]];
};
Utilities
ReadEntry:
PROC[
db: OpenDB, key: LoganBerry.AttributeType,
value: LoganBerry.AttributeValue, useCache: BOOL←TRUE]
RETURNS [attributes: AttributeSeq←NIL, cached: BOOL←FALSE] = {
IF dbHandle.doCache
AND useCache
THEN
IF key=$rname THEN attributes←ReadCache[db, value];
IF attributes#NIL THEN RETURN[attributes, TRUE];
attributes ← LoganBerry.ReadEntry[db: db.db, key: key, value: value].entry;
IF dbHandle.doCache
AND attributes#
NIL
THEN
IF useCache THEN RecordCache[db, attributes] ELSE DeleteFromCache[db, attributes];
};
FetchAttribute:
PUBLIC
-- to back door --
PROC[
attributes: AttributeSeq, attribute: ATOM, default: ROPE←NIL]
RETURNS [value: ROPE, valueLoc: AttributeSeq←NIL] = {
value ← default;
FOR aL: AttributeSeq ← attributes, aL.rest
WHILE aL#
NIL
DO
IF aL.first.type = attribute THEN RETURN[aL.first.value, aL]; ENDLOOP;
};
ExtractAttribute:
PUBLIC
-- to back door --
PROC[
attributes: AttributeSeq, attribute: ATOM]
RETURNS [newAttributes: AttributeSeq←NIL] = {
IF attributes=NIL THEN RETURN;
IF attributes.first.type=attribute THEN RETURN[attributes.rest];
newAttributes ← attributes;
FOR aL: AttributeSeq ← attributes, aL.rest
WHILE aL.rest#
NIL
DO
IF aL.rest.first.type # attribute THEN LOOP;
aL.rest ← aL.rest.rest;
RETURN;
ENDLOOP;
};
StoreAttribute:
PUBLIC
-- to back door --
PROC[attributes: AttributeSeq, attribute:
ATOM, value:
ROPE]
RETURNS[newAttributes: AttributeSeq] = {
oldLoc: AttributeSeq;
IF value=
NIL
OR value.Length[]=value.SkipOver[skip: "\015\011"]
THEN
RETURN[ExtractAttribute[attributes, attribute]];
newAttributes ← attributes;
oldLoc ← FetchAttribute[attributes, attribute].valueLoc;
IF oldLoc#
NIL
THEN oldLoc.first ← [attribute, value]
ELSE newAttributes ← Append[attributes, LIST[[attribute, value]]];
};
Append:
PUBLIC
-- to back door --
PROC[
a1, a2: AttributeSeq]
RETURNS [newAttributes: AttributeSeq] = {
IF a2=NIL THEN RETURN[a1];
IF a1=NIL THEN RETURN[a2];
newAttributes ← a1;
FOR aL: AttributeSeq ← a1, aL.rest
WHILE aL#
NIL
DO
IF aL.rest#NIL THEN LOOP;
aL.rest ← a2;
RETURN;
ENDLOOP;
ERROR;
};
DBFromType:
PROC[dbType:
ATOM]
RETURNS [openDB: OpenDB ← nullDB] = {
IF dbHandle.white=nullDB THEN Open[];
RETURN[
SELECT dbType
FROM
$white => dbHandle.white,
$blue => dbHandle.blue,
$red => dbHandle.red,
ENDCASE => nullDB
];
};
WhichDB:
PROC[keyType:
ATOM]
RETURNS [
dbType: ATOM←$blue, keyClass: KeyClass←$notKey, openDB: OpenDB ← nullDB] = {
mer: MapEntry ← NARROW[dbMap.Fetch[keyType].val, MapEntry];
IF mer#
NIL
THEN {
dbType ← mer.dbType;
keyClass ← mer.keyClass;
};
openDB ← DBFromType[dbType];
};
RelTime:
PUBLIC
-- to back door --
PROC[ropeTime:
ROPE]
RETURNS [relativeToNow:
INT] = {
RETURN[BasicTime.Period[from: BasicTime.Now[],
to: BasicTime.FromNSTime[Convert.CardFromRope[ropeTime]]]];
};
TimeRope:
PUBLIC
-- to back door --
PROC [time: BasicTime.
GMT ← BasicTime.nullGMT]
RETURNS[nowRope:
ROPE] = {
IF time = BasicTime.nullGMT THEN time ← BasicTime.Now[];
RETURN[IO.PutFR["%bB", [cardinal[BasicTime.ToNSTime[time]]]]];
};
TAttr:
PUBLIC
-- to back door --
PROC[attribute:
ATOM, prefix: Rope.
ROPE]
RETURNS [tAttr:
ATOM] = {
RETURN[Atom.MakeAtom[IO.PutFR["%g.%g", [rope[prefix]], [atom[attribute]]]]]; };
Open:
PROC[forceOpen:
BOOL←
FALSE] = {
ENABLE LoganBerry.Error => Error[ec, explanation];
prefixValue: IO.Value ← [rope[dbHandle.dbPrefix]];
IF forceOpen
THEN {
IF dbHandle.white#nullDB
THEN
LoganBerry.Close[db: dbHandle.white.db];
IF dbHandle.blue#nullDB
THEN
LoganBerry.Close[db: dbHandle.blue.db];
IF dbHandle.red#nullDB
THEN
LoganBerry.Close[db: dbHandle.red.db];
};
dbHandle.white ← LBOpen[IO.PutFR["%gWhitePages.df", prefixValue], dbHandle.whiteTTL];
dbHandle.blue ← LBOpen[IO.PutFR["%gBluePages.df", prefixValue], dbHandle.blueTTL];
dbHandle.red ← LBOpen[IO.PutFR["%gRedPages.df", prefixValue], dbHandle.redTTL, TRUE];
};
LBOpen:
PROC[dbName:
ROPE, timeToLive:
INT, alwaysTimeout:
BOOL←
FALSE]
RETURNS [
openDB: OpenDB] = {
openDB ← NEW[OpenDBBody ← []];
openDB.dbCache ← SymTab.Create[case: FALSE];
openDB.db ← LoganBerry.Open[dbName: dbName];
LoganBerryExtras.RegisterWriteProc[
proc: RecordWrite, db: openDB.db, ident: $nameDB, clientData: openDB];
openDB.timeoutCache ← alwaysTimeout OR ~LoganBerryExtras.IsLocal[openDB.db];
openDB.timeToLive ← timeToLive;
};
Entry caching
CacheEntry: TYPE = REF CacheEntryBody;
CacheEntryBody:
TYPE =
RECORD [
attributes: AttributeSeq ← NIL,
lastValid: BasicTime.GMT ← BasicTime.nullGMT
];
ReadCache:
PROC[openDB: OpenDB, keyValue: LoganBerry.AttributeValue]
RETURNS[attributes: AttributeSeq←NIL] = {
cacheEntry: CacheEntry;
IF openDB=NIL OR ~dbHandle.doCache THEN RETURN;
cacheEntry ← NARROW[SymTab.Fetch[openDB.dbCache, keyValue].val];
IF cacheEntry=
NIL
OR (openDB.timeoutCache
AND
BasicTime.Period[from: cacheEntry.lastValid, to: BasicTime.Now[]] > openDB.timeToLive)
THEN RETURN;
RETURN[cacheEntry.attributes];
};
RecordCache:
PROC[openDB: OpenDB, attributes: AttributeSeq] = {
cacheEntry: CacheEntry;
rName: ROPE ← FetchAttribute[attributes, $rname, NIL].value;
IF openDB=NIL OR rName = NIL THEN RETURN;
cacheEntry ← NARROW[SymTab.Fetch[openDB.dbCache, rName].val];
IF cacheEntry =
NIL
THEN {
cacheEntry ← NEW[CacheEntryBody ← []];
[] ← SymTab.Store[openDB.dbCache, rName, cacheEntry];
};
cacheEntry.attributes ← attributes;
cacheEntry.lastValid ← BasicTime.Now[];
};
RecordWrite:
-- INTERNAL -- LoganBerryExtras.WriteProc = {
Can't really be INTERNAL, because sometimes called from registered procedures, but always with monitor locked!
DeleteFromCache[NARROW[clientData], entry];
};
DeleteFromCache:
-- INTERNAL --
PROC[openDB: OpenDB, attributes: AttributeSeq] = {
rName: ROPE;
IF attributes=NIL OR openDB=NIL THEN RETURN;
rName ← FetchAttribute[attributes, $rname, NIL].value;
IF rName#NIL THEN []←SymTab.Delete[openDB.dbCache, rName];
};
Shell commands
CmdDBOpen: Commander.CommandProc = {
[cmd: Commander.Handle] RETURNS [result: REF ANY ← NIL, msg: ROPE ← NIL]
arg: ROPE ← CommandTool.NextArgument[cmd];
IF arg#NIL THEN dbHandle.dbPrefix ← arg;
Open[TRUE];
};
CmdDBDetails: Commander.CommandProc = {
[cmd: Commander.Handle] RETURNS [result: REF ANY ← NIL, msg: ROPE ← NIL]
DoDetails[cmd, CommandTool.NextArgument[cmd]];
};
DoDetails:
PROC[cmd: Commander.Handle, rName:
ROPE] = {
DoSomeDetails[cmd, rName, $white, TRUE];
DoSomeDetails[cmd, rName, $blue];
DoSomeDetails[cmd, rName, $red];
IO.PutChar[cmd.out, '\n];
};
DoSomeDetails:
PROC[
cmd: Commander.Handle, rName: ROPE, dbType: ATOM, includeRName: BOOL←FALSE] = {
attributes: AttributeSeq ← GetAttributes[rName, $rname, dbType];
IF attributes#NIL AND ~includeRName THEN attributes ← attributes.rest;
FOR attr: AttributeSeq ← attributes, attr.rest
WHILE attr#
NIL
DO
IO.PutF[cmd.out, "%g: %g\n", [atom[attr.first.type]], [rope[attr.first.value]]];
ENDLOOP;
};
CmdLarkDebug: Commander.CommandProc = {
[cmd: Commander.Handle] RETURNS [result: REF ANY ← NIL, msg: ROPE ← NIL]
larkNumber: ROPE ← CommandTool.NextArgument[cmd];
instance: ROPE ← CommandTool.NextArgument[cmd];
IF instance=
NIL
THEN
instance ← UserProfile.Token[key: "LarktestInstance", default: "Einstein.lark"];
DoOperate[cmd, larkNumber, "D", instance];
};
CmdLarkOperate: Commander.CommandProc = {
[cmd: Commander.Handle] RETURNS [result: REF ANY ← NIL, msg: ROPE ← NIL]
larkNumber: ROPE ← CommandTool.NextArgument[cmd];
instance: ROPE ← CommandTool.NextArgument[cmd];
IF instance=
NIL
THEN
instance ← UserProfile.Token[key: "ThrushClientServerInstance", default: "Strowger.lark"];
DoOperate[cmd, larkNumber, "O", instance];
};
DoOperate:
PROC[cmd: Commander.Handle, larkNumber:
ROPE, mode:
ROPE, instance:
ROPE] = {
[cmd: Commander.Handle] RETURNS [result: REF ANY ← NIL, msg: ROPE ← NIL]
rName: ROPE;
IF larkNumber=NIL THEN RETURN;
larkNumber ← IO.PutFR["173#%g#", [rope[larkNumber]]];
rName ← GetAttribute[larkNumber, $rname, NIL, $larkhost];
IF rName=NIL THEN RETURN;
SetAttribute[rName, $mode, mode];
SetAttribute[rName, $instance, instance];
DoDetails[cmd, rName];
};
CmdLarkOwner: Commander.CommandProc = {
[cmd: Commander.Handle] RETURNS [result: REF ANY ← NIL, msg: ROPE ← NIL]
larkNumber: ROPE ← CommandTool.NextArgument[cmd];
newOwner: ROPE ← CommandTool.NextArgument[cmd];
IF larkNumber=NIL OR newOwner=NIL THEN RETURN;
larkNumber ← IO.PutFR["173#%g#", [rope[larkNumber]]];
SetAttribute[newOwner, $larkhost, larkNumber];
DoDetails[cmd, newOwner];
};
CmdLarkDBGet: Commander.CommandProc = {
[cmd: Commander.Handle] RETURNS [result: REF ANY ← NIL, msg: ROPE ← NIL]
rName: ROPE ← CommandTool.NextArgument[cmd];
attribute: ROPE ← CommandTool.NextArgument[cmd];
value: ROPE;
IF rName=NIL OR attribute=NIL THEN RETURN;
value ← GetAttribute[rName, Atom.MakeAtom[attribute]];
IO.PutF[cmd.out, "Name: %g\n%g: %g\n\n", [rope[rName]], [rope[attribute]], [rope[value]]];
};
CmdLarkDBSet: Commander.CommandProc = {
[cmd: Commander.Handle] RETURNS [result: REF ANY ← NIL, msg: ROPE ← NIL]
rName: ROPE ← CommandTool.NextArgument[cmd];
attribute: ROPE ← CommandTool.NextArgument[cmd];
value: ROPE ← CommandTool.NextArgument[cmd];
IF rName=NIL OR attribute=NIL THEN RETURN;
SetAttribute[rName, Atom.MakeAtom[attribute], value];
DoDetails[cmd, rName];
};
CmdDBFlush: Commander.CommandProc = {
[cmd: Commander.Handle] RETURNS [result: REF ANY ← NIL, msg: ROPE ← NIL]
IF dbHandle.white#NIL THEN SymTab.Erase[dbHandle.white.dbCache];
IF dbHandle.blue#NIL THEN SymTab.Erase[dbHandle.blue.dbCache];
IF dbHandle.red#NIL THEN SymTab.Erase[dbHandle.red.dbCache];
};
CmdGVUpdate: Commander.CommandProc = {
[cmd: Commander.Handle] RETURNS [result: REF ANY ← NIL, msg: ROPE ← NIL]
rName: ROPE ← CommandTool.NextArgument[cmd];
[]�leteGVEntry[rName];
DoDetails[cmd, rName];
};
ForceOpenOnNextCall: Booting.RollbackProc = {
[clientData: REF ANY]
dbHandle.white ← dbHandle.red ← dbHandle.blue ← nullDB;
};
Mappings
KeyClass: TYPE = { primary, secondary, notKey };
MapEntry: TYPE = REF MER;
MER:
TYPE =
RECORD [
dbType: ATOM,
keyClass: KeyClass←$notKey
];
dbMap: RefTab.Ref ← RefTab.Create[];
rname is handled specially
[] ← dbMap.Store[$rname, NEW[MER ← [$noProbe, $primary]]];
whitePages; names, public addresses&numbers
[] ← dbMap.Store[$name, NEW[MER ← [$white, $secondary]]];
[] ← dbMap.Store[$fnm, NEW[MER ← [$white, $secondary]]];
[] ← dbMap.Store[$rgnm, NEW[MER ← [$white, $secondary]]];
[] ← dbMap.Store[$fstnm, NEW[MER ← [$white, $secondary]]];
[] ← dbMap.Store[$officenumber, NEW[MER ← [$white]]];
[] ← dbMap.Store[$homenumber, NEW[MER ← [$white]]];
[] ← dbMap.Store[$officeaddress, NEW[MER ← [$white]]];
[] ← dbMap.Store[$homeaddress, NEW[MER ← [$white]]];
bluePages; private voice system mappings
[] ← dbMap.Store[$larkhost, NEW[MER ← [$blue, $secondary]]];
[] ← dbMap.Store[$workstationhost, NEW[MER ← [$blue, $secondary]]];
[] ← dbMap.Store[$dotune, NEW[MER ← [$blue]]];
[] ← dbMap.Store[$instance, NEW[MER ← [$blue]]];
[] ← dbMap.Store[$interface, NEW[MER ← [$blue]]];
[] ← dbMap.Store[$mode, NEW[MER ← [$blue]]];
[] ← dbMap.Store[$multiring, NEW[MER ← [$blue]]];
[] ← dbMap.Store[$program, NEW[MER ← [$blue]]];
[] ← dbMap.Store[$ringmode, NEW[MER ← [$blue]]];
[] ← dbMap.Store[$ringtune, NEW[MER ← [$blue]]];
Blue is also the default for unknown attributes, so that we can extend the private mappings without recompiling this table.
redPages; cached Grapevine mappings
[] ← dbMap.Store[$connect, NEW[MER ← [$red]]];
[] ← dbMap.Store[$key, NEW[MER ← [$red]]];
[] ← dbMap.Store[$authenticity, NEW[MER ← [$red]]]; -- useful only for IsAuthenticated
Initialization
dbHandle.dbPrefix ← UserProfile.Token["ThrushSunDBPrefix", "/Growler-SUN///Strowger/"];
Default prefix value.
Commander.Register["NameDBOpen", CmdDBOpen, "Specify location of system databases.
Usage: NameDBOpen <directoryPrefix>
Example: NameDBOpen /Growler-SUN///Strowger/
Example: NameDBOpen /Strowger.lark//Strowger/
Example: NameDBOpen ///Users/self.pa/
(first example is the default)\n"];
Commander.Register["NameDBDetails", CmdDBDetails, "Print entire merged DB listing.
Usage: NameDBDetails <rName>\n"];
Commander.Register["LarkDebug", CmdLarkDebug, "Tune Lark into development server, debug mode.
Usage: LarkDebug <larkNumber> [<instance>]
Example: LarkDebug 110 (default instance is UserProfile.LarkTestInstance[])
Example: LarkDebug 110 Curie.lark\n"];
Commander.Register["LarkOperate", CmdLarkOperate, "Tune Lark into operational server, operational mode.
Usage: LarkOperate <larkNumber> [<instance>]
Example: LarkOperate 110 (default instance is UserProfile.ThrushClientServerInstance[])
Example: LarkOperate 110 Curie.lark\n"];
Commander.Register["LarkOwner", CmdLarkOwner, "Change assignment of Lark to user.
Usage: LarkOwner <larkNumber> <rName>
Example: LarkOwner 155 Swinehart.pa\n"];
Commander.Register["NameDBSet", CmdLarkDBSet, "Change Name database attribute.
Usage: NameDBSet <rName> <attribute> <value>
Example: NameDBSet Swinehart.pa ringmode S\n"];
Commander.Register["NameDBGet", CmdLarkDBGet, "Query Name database attribute.
Usage: NameDBGet <rName> <attribute>
Example: NameDBGet Swinehart.pa ringmode\n"];
Commander.Register["NameDBFlushCache", CmdDBFlush, "Flush local DB cache.
Usage: NameDBFlushCache\n"];
Commander.Register["NameDBGVUpdate", CmdGVUpdate, "Restore GV values from Grapevine.
Usage: NameDBGVUpdate <rName>
Example: NameDBGVUpdate Curie.lark\n"];
Booting.RegisterProcs[r: ForceOpenOnNextCall];
}.
Polle Zellweger (PTZ) July 19, 1990 3:06:43 pm PDT
Remove Pup dependencies: change to LoganBerry access via Sun RPC, remove conversation from DBHandle record.
changes to: DIRECTORY, DBHandle, SetAttribute, SetAttributeTimed, GetGVUpdate, DeleteGVEntry, ReadEntry, Open, LBOpen, ForceOpenOnNextCall, dbHandle, dbHandle, Commander
Polle Zellweger (PTZ) July 21, 1990 9:27:46 pm PDT
More Pup dependencies: remove references to GVNames.
changes to: DIRECTORY, NameDBImpl, GetGVUpdate
Polle Zellweger (PTZ) August 23, 1990 9:18:27 pm PDT
changes to: DIRECTORY, NameDBImpl, HostFromInstance, GetGVUpdate, dbHandle