Inter-OfficeMemorandumToCedarInterestDateOct1,1982FromDaveGifford,revisedbyMDSLocationPaloAltoSubjectCIFSManual(3.4)OrganizationPARC/CSLXEROXFiledon:[Indigo]Documentation>CIFSManual.(tiogapress)CedarInterimFileSystemAbstractTheCedarInterimFileSystemprovidesbasicfilestorageanddirectoryservicesinsupportoftheCedarProgrammingEnvironment.ThismanualdescribestheCedarInterimFileSystem'sconcepts,facilities,andinterfaceintwoparts.ThefirstpartofthemanualisintendedforthecasualCedaruseranddescribesbasicfilesystemconcepts.ThesecondpartisintendedforprogrammerswhowillmakedirectuseoftheCIFSprogramminginterface.TheappendixcontainsanexampleprogramthatusesCIFS.PartA:UsersGuideA.1ConceptsCIFSisaclientfilesystem;itrunswithCedarandprovidesaunifiedviewofserverfilesystemssuchasIFS,Juniper,andMaxc.Likeotherfilesystems,CIFSimplementsthefileasthebasicobjectforlong-terminformationstorage.InCIFSafileisanarrayof512bytepages.Clientscancreate,read,alter,anddeletefiles.Filesarecatalogedindirectories.Adirectoryisasetofentries,andeveryentryhasanentrynamethatisuniquewithinitsdirectory.Anentrydescribeseitherafile,adirectory,oralink(linkswillbediscussedlater).Everyentrycanincludeacomment,whichisatextstringthatisnotinterpretedbyCIFS.Likefiles,directoriescanbecreated,examined,altered,anddeletedbyaclient.Wheneveradirectoryiscreateditmustbepermanentlycatalogedinasingleparentdirectory.Thisrequirementcausesdirectoriestobearrangedinatree,andappropriatelyenoughtherootofthetreeiscalled1pqНОa╦Н!┐ pН ЛО]пНО]пНН+╞О]пН6О]пН8іН:3Н ЛОYХНОYХН╒Н Н$ЇН&ЁН6ОYХН@[ОYХНCtН ЛОVНОVН╦НнН+╞ОVН6ОVrН{ОNVpН ЛОDYН ┼НОDYП.Н6└sН$О8Н"[Н+Н0&tНўО,XpНўО)яН∙Н╪НюНіН tН&Н)■Н,Н0нН3■Н9uН>▐Н@LНEgНG/НўО(*НІ НCН"PН%ZН*4Н0Н2\Н6dН;IН>НC⌡НўО&┌ НrН2НЮН≈НLН#╒Н&┐Н)dН,PН.Н0{Н5mН6БН<їН>МНAUНEwНўО$шНЎН█Н▄НН≈Н#)Н)оН,ЎН1gН4bН5ЕН;╦Н> НF▀НўО#4Н8НлН█НБНzН╧Н M Н(© Н/Н1ЇН7∙Н<ьН>╗НDНўО!▄Н|НutНўОНгНґН█uНўО~Н8pНўОВН~НuНKОВНФОВНН├pНUОВНnОВНЮН#Н&MН*│Н-TН2ЪН4DН9НJОВН>нОВНBGНDЇpНўОOННтНН┐Н]Н"KН%·Н)`Н+МН1hН5@ Н<мuН?PОOН?©ОOpНAхОOНBmОOНC≥НFНўО╗НеННV Н ъН&jН(9Н+ЛН-Н/}Н0ХН2вН6^Н8Н:╙Н=╧НB]НGНўОНН{НЫН╟НҐНўОyННaНwuН'ОyНвОy pН ОyН!ОyН#Н(АН*OН+{Н-≥uН/TОyН/ООypН3$ОyН4ОyН6╪Н:rН>Н@uНBqОyНCОyНEКpНўОрН|НХН▒НжН╠ Н"`Н$ЁН(GН.0Н2Н3GН6 Н73 Н=]Н?"Н@LНCНFДНўО+Н■Н▓НВНЦН lН"ЛН'аuН(ЮО+Н){О+pН.!О+Н.СО+Н2ЖН4WН5vН8#Н;НН>╠Н@НB| НўО ┐Н▌НГНШН& Н╧Н"(Н#ЧН)Н/─Н4OН6КН;єН=└Н>▓НBВНўОэН аН}НсН├НфННС Н'жН-тН/lН0─uН4UОэН5ОэН8rpН=┴ОэН>ҐОэНAа НўО 5НВ Н╣НsНtН!?Н"ЩН$6Н'aН*(Н2╚Н7╔Н:Н=Н>шНAJНDНE≤vН)хОЖЎTVm$тОпН ─НZ ННYНЛНсН!©Н"ХН%╗Н&р Н,ШН.ЎН/ГН2ЁН6|Н9'Н;НA НE≥Н=О(НэНrН]uН▒О(Н,О(pНрО(Н╨О(НсНJНН!BН%#Н'Эtherootdirectory.Everydirectoryandfilecanbereachedfromtherootdirectory.Anobject'sabsolutepathnamespecifiesthewaytheobjectisreachedfromtheroot.Thus,absolutepathnamesareunambiguous.Examplesofabsolutepathnamesare:/indigo/cedar/top/rigging.df!2/phylum/lad/bookpress/Byconventiontheleadingslashonthesenamesmeanstheyarerelativetotherootdirectory.SubsequentslashescauseCIFStowalkdownthetreeofdirectories.Directoriesthatarechildrenoftherootdirectorycorrespondtofileservers.Thiscorrespondencedetermineswhereachildoftherootanditsdescendantsarephysicallystored.Thus,/iris/mesaisstoredonthefileservernamediris.Alinkisadirectoryentrythatpointstoanotherdirectoryentry.Theentrypointedtoiscalledthetargetofthelink.Linksarenamedbyabsolutepathnamesinthesamemannerasfilesanddirectories.Anexampleofalinkis:/ivy/cassatt/history/paint.tiogatarget/louvre/renoir/paint.tiogaAreferenceto/ivy/cassatt/history/paint.tiogawillberesolvedto/louvre/renoir/paint.tiogabyCIFS.Oncealinkisestablisheditstargetcanbechanged.Thus,linksarethebasicindirectionmechanismofCIFS.CIFSrestrictslinkstopointatfileentries.Thiswouldbetheendoftheconceptssectionexceptthatitisverycumbersometoalwaystypeabsolutepathnames.Thus,CIFShasamechanismcalledpathnameexpansionbuiltintoitthatallowsclientstoabbreviatenames.Ifapathnamedoesnotbeginwithslashitiscalledarelativepathname.Suchnamesareinterpretedrelativetoacontextthatincludessearchrules(describedlater)andasingleworkingdirectory.Relativepathnamesareinterpretedrelativetotheworkingdirectory.Forexample,iftheworkingdirectoryis/ivy/jeffersonthentherelativepathnamecongress/constitution.tiogaisexpandedbyCIFStotheabsolutepathname/ivy/jefferson/congress/constitution.tiogaInadditiontotraversingthetreeofdirectoriesoutfromtherootdirectoryCIFSisalsowillingtoworktheotherway.ThebackslashcharactercausesCIFStotraverseinreverse.Considerthepathname:/ivy/jefferson\\indigo/franklin/kite.tiogaThefirstbackslashtellsCIFStogobackupto/ivyandthesecondbackslashcausesittogobackonemoreleveltotheroot.Thisfacilityisintendedforuseinrelativepathnames.Forexample,iftheworkingdirectoryis/ivy/freudthenCIFSexpands\skinner/rat.mesato:/ivy/skinner/rat.mesaAclientcanthusgoupanddownthedirectorytreeandusetheworkingdirectoryasaconvenientreferencepoint.Thereisonefinalmechanismthatisbroughtintoplayforrelativepathnamesthatonlyconsistofanentryname(e.g.thepathletter.tioga).Ifthepathnamesafile,andthefileisnotfoundintheworkingdirectory,alistofotherdirectoriesistriedinturn.Thislistofdirectoriesiscalledthesearchrules.Logicallytheworkingdirectoryisthefirstmemberofthesearchrulesbecauseitistriedbeforeanyoftheotherdirectories.Forexample,ifthesearchrulesare:/ivy/ravel(workingdirectory)/ivy/beethoven[1]/ivy/debussy[2]2pНўОb)uН Оb)Н▒Оb)НГpНЧОb)Н_Оb)НUН"'Н$чН'GН)рН+цН0ЕН4LН6╚Н9≥ НўО_╙НСuНзО_╙Н┼О_╙ННpН╚О_╙Н /О_╙Н%Н'hН*2Н,┐Н0▌Н1ЛН7Н:YН<╙Н@XНD НўО^НтННkНпН&Н'хН-7Н0]Н4║НoО[└НoОYНўОV├Н НXНУНН!╒Н#ФН'ўН,0Н0╡Н4Н6▓Н;╞Н=⌡Н@9НCf НўОTч НН÷НUН Н!╦Н$ЧН(хН+(Н-ЙН/ёНўОR_ НфНіНН│Н KН"ҐН%╪Н+═ Н2нН4▐Н7 Н< Н?ф НўОP╦ Н╨НьНН─Н?Н єН#≤Н&UН(5 Н/щН26 Н8²Н=╗uНA└ОP╦НB4ОP╦pНH#ОP╦НH├ОP╦НўОOНяНвН7Н═Н╛uН 3ОOН √ОOpНўОL▓uН6ОL▓Н≥ОL▓pНОL▓НeОL▓НjН░Н^НМН╦Н#вН%┌Н*┴Н0WН4ЎН7▓Н;"Н@*НAтНC<НG/uНўОJЙpНхОJЙН└ОJЙН╦НMНbНmНВН$ЄН&ФН,▀Н/ГН4aН6FН8шН<▐НAоНCЄНFьНўОICН8Н▀ННҐНФН!ЁНoОFдuН1ОDEpНОDEНфОDEНўОAфН&НuН╙ОAфН[ОAфpН(┌ОAфН)─ОAфН+Н,ЖН2PuН3ЙОAфН4⌡ОAфpНC⌡ОAфНDbОAфНE┐НўО@Н<НUННl НcН-Н!ЧН$xН&XН,┌Н0HН3┬Н5кН8Н;| НB\НўО>wНgНВН╛НбНН аН$`Н%ЫН(bНўО;ЫНХН6НGНфН²НvНЖН%╠Н*nН.чН1лН3BН4нН7Щ Н@,НAЗНFНўО:QН4НsНцН╡Н"~Н%Н&NН-≤uН1╗О:QН2XО:QН4рН8▌pН?О:QН?иО:QНBbНERНFаНўО8╙НФН6НП Н╙Н"ЮН$mН%╒Н(тН,÷Н/зН2[Н61Н9WН<©Н> Н?≈НC uНDоО8╙НESО8╙НўО7НвpНВО7Н┘О7ННlНв Н&Н*ЖН,╪uН-ЩО7Н.≤О7pН2ДО7Н3SО7Н5йuН;EО7Н;иО7Н?▄pНBКО7НCdО7НўО5[НcН0НpuНrО5[НYО5[На pН$fО5[Н%oО5[Н)ЮН-Н1vН3Ю Н; Н?ЩНAбНD8НўО3Є НЮНнНАН┘Н!&Н&юН,тuН.┌О3ЄН/3О3ЄpН7;О3ЄН7╙О3ЄН:єН=FНBfНEоuНўО2 pНяО2 Н4О2 Н=Н$~Н&yН*.Н+эН.<Н3╙Н6яНoО/▌П*НўО-Н▀Н Нф Н*Н≤Н!iН#1 Н)НН,rН/ХН2VН5SН;3Н>ВН@qНCLНGЮНўО+gН"НzННЄН└Н"⌡Н(|Н,ўН0ZН2Н7Н8©Н>=НDНFhНўО)юНoО'AП*НўО$бН░НrН⌡Н┬НGН ЪН"ЫН&JН(guН*О$бН*пО$бpН-О$бН-їО$бН/цН2,Н6хН<ЯНA5НB∙НDNНFHНўО#НcННPННqНOН!sН&Н'yН-?Н/├Н2Н3ҐН8╔Н;уНA НCЎНўО!sННnНеН≈uНО!sНЁО!spН#├О!sН#УО!sН&╛Н*auН/╧О!sН0CО!spН:╔О!sН;О!sНoОТНўОuН:НШН├Н▄Н|Н▌НFН"Н$qН*CН-Н/ҐН22Н4▓Н9ИН?╩НAiНB⌠ НўОнН╚НўОOНІН)НшННLН"!Н#⌠Н(рН+╠Н.╪Н1Н5ФН9Н=^Н@3НCSНGжНўО╗Н╒Н9НЩННfuН░О╗НСО╗pН%DО╗Н&╚О╗Н(1Н*■Н-ЎН2Н33Н5ЫН8ЄН;Н=└Н>ТНAlНE~НG/НўОН$ НmНІННЙН!╘ Н(vН*Н-gН/4Н3SН6▄Н8ИН:а НA▌НCНG/uНўОYНСpНІОYНBОYНIНЎН#+Н)Н*■Н- Н/ВН5zН7IН9ЎН>НA─НFЇНH#НўО╡НТНDНДН²НЩН°Н&&Н(яН.╒Н0Н2cН6°Н9ЫНoО3 Н&╟О3Н,│ НoОЄ Н.qОЄНoО 5Н.qО 5vН)хОЖ zTVm$НAуНD8Н=О"PН1НюНBН=НнН╙Н,Н ┴Н$Н)MН*фН,TН/ЎН40Н6ТН8оН;RН?НFЦН=О ╗ННnНнННdНЧО* Н?О*Н% НЧО╚ Н'О╚НЧО,Н'О,Н=ОўuНшОўН vОўpНбОўНюОўНПНАН!НЧО/Н=О╠uНТО╠НГО╠ pН<О╠Н:О╠НkН[Н°НЧО2Н=ОЁН:Н ≤Н≤Н)Н∙uН=О 5Нг vН)хОЖ TVm$ЯThenemperor.musicwouldbeexpandedto/ivy/beethoven/emperor.musicandLaMer.musicwouldbeexpandedto/ivy/debussy/LaMer.musicassumingmymusicalhistoryiscorrect.A.2PragmaticsItwouldbeniceifyoudidnotneedtoknowanythingabouthowCIFSworked,butalasthereareafewimportantthingsthatwillhelpyoucomprehendwhatisgoingonwhensomethingfunnyhappens.CIFSmakescopiesoffilesanddirectoriesonthelocaldiskofthemachineyouareusing.Thesecopiesarecatalogedbyaninvisibledirectorycalledthelocalsystemdirectory(orLSD).ThelsdcommandcanbeusedtolistthecontentsoftheLSD.Whenyoualterafile,thechangesarenotreflectedatthefile'spermanenthomeuntilyouissueabackupcommand(seeSectionA.3).Thishastwoimportantconsequences.First,iftwopeoplemodifyafileorupdateadirectoryatthesametimethelastonetodoabackupwins.Thecatalogcommandwillfixanydirectoryproblemsthatmightresult,butingeneralconcurrentmodificationofafileoradirectoryisnotagoodidea.Second,ifyoumodifyafilethatyoucannotwriteonCIFSwillnotcomplainatthetime.Whenbackuprunsitwillbeunabletocopyyourmodificationtothefile'spermanenthome,andyouwillhavetocopyyourmodificationsoutofthefileandusetheresetcommandtoflushthechanges.CIFSsupplementsthedirectorysystemsoffileserverswithitsownsetofdirectories.Iftheabsolutepathnameofadirectoryispath,thentheCIFSdirectoryisstoredinafilecalledpath/dir.bt.ThecatalogcommandwillinitializeexistingdirectoriesforusewithCIFS.ThemkdircommandautomaticallyinitializesCIFSdirectoriesandcatalogisnotneededinthiscase.Inordertousefilesinnon-CIFSdirectoriesthefile'sabsolutepathnamemustbegiven.Forexample:/iris/redell/pilot/paper.pressForcompatibility,thedirectory/localreferstothePilotCommonSoftwareDirectory.A.3HowtouseCIFSCIFSisintheCedarbootfile.TouseCIFScommands,type:runfilesystemcommandsTheUserExecwillthenunderstandthefollowingsetofsimplefilesystemcommands:asrpathAddsthedirectorypathtothebeginningofthesearchrules.backupCopiesallofthefilesthathavebeenmodifiedtopermanentstorage.catalogpathInitializeaCIFSdirectorysystemonthedirectorytreethatstartsatpath.IftherealreadyisaCIFSdirectorysystem,itischeckedforconsistencyandrepairedifnecessary.commentpathcommentReplacesthecommentontheentrypathbycomment.Ifcommentisnotspecified,thecommentonpathisdeleted.3pНўОb)uНLОb)НГОb)pН3Оb)Н1Оb)НaНRН%▓НoО_╚НўО],uНeО],НXО], pНґО],Н╚О],НэНлН$ НoОZўНўОX0Н╚Н Н Н Н uНўОU╠Н8 pНўОS3Н$НQНAН/Н▐НEН╧Н -Н#┴Н%7Н(УН.╔Н2├Н5┴Н9=Н>}Н@ЩНCЁНG;НўОQ▄ННкНVН≤Н░Н!eН$╘Н'┼ Н/╒Н3)Н4ЎН8╡Н:БН>юНE█НўОOДНўОMfНpН╣НЯН╦НЁН w Н'3Н)GН+ЁН/Н2Н3иН66Н;хН>▄Н@МНE█НўОK©НЖНdН▓Н╗НЁН#FН)2Н-DuН/ҐОK©Н0!ОK©Н3Н7▄pН=BОK©Н=╩ОK©Н? НDutНGhОK©НGкОK©pНўОJНН Н▀НфНuН╡Н!Н&│Н(:Н*≥НўОG≥НмН▄Н╧НЙНЄНН"OН$╙Н''Н,тН.tН0эН4)Н;Н>ТНBBНEНHetНўОEРpН┌ОEРНОEРННВНЫН$)Н'gН)ЪН,нН3SН<ЧН@юНBDНEНўОDJНiН░НВН╧НJНqН"AН#вН&4Н)╟Н,сН/0Н1ўН4WН6Н8tН9/ОDJН9ЮОDJpН=ъОDJН>эОDJНAФtНD╪ОDJНEbОDJpНўОBёННлНФН▐Н jН&{Н)RН-SН1Н4 Н5юН:⌡ НA▀НўО@ЭНqНєННФННУНkНЙН Н# Н'┐Н,╨Н.$Н0ЕН5╛Н6ЮН9TН<,Н>МНA┌НDНG┴НўО?TН[НЧНlНbНСНKН#=tН'NО?TН'ЧО?TpН+ЬО?TН,|О?TН/Н0YН2ЩН4ФН9fН; Н>WНA▀НўО=ґН_НаН НРН#Н!щН$≈Н'EН*▌Н,?Н/■Н2рН;]Н=уН?▒НAТНD`НGНўО<tН О<Н▒О<pНiО<НО<НйНyНЛН KНўО9┤НN Н*НuН 4Н%Н&еН)Н-≈Н0·Н2eН5UН7^Н9Н@fНAтНD НўО7ЮНуН√НPН{НNuН╩О7ЮНkО7ЮpН IО7ЮН!&О7ЮН$NН&ўН*dН07Н1єН5хН7xН8ёН; uН?О7ЮН?ІО7Ю pНETО7ЮНFЇО7ЮtНўО69pНсО69НnО69Н┬Н├ Н!hН&е Н-гН0WН3 Н6▌Н;дtН>ПО69Н@О69pНC.О69НCиО69НўО4▒Н Н3НХ Н%√tН(MО4▒Н(СО4▒pН- О4▒Н-┐О4▒Н.▄Н1Н5йН7xН:НўО2Н╘Н┴НdНННЬН"⌡ Н)uН,Н/rН5 Н8_Н`О─Н?╦О─НA6НD╩Н1ОыН°НфН{НMН# Н$vН%БН+0Н-m Н4═Н7XН<фН>' tНoОZwНUОZНОZНopН1ОэНН≥Н бН"ИН%iuН)ОэН)нОэpН,QОэН-ОэuН.mОэН/ОэpН3ўОэН5PОэuН6РОэН7█ОэpН<ьОэН=;ОэН>eН@З НG/Н1О 5Н9uН@О 5НПО 5pНRО 5Н╣О 5НҐvН)хОTVm$ЁНКН▐uНОpН╩ОppcdpathChangestheworkingdirectorytobepath.CIFSDeletepathIfpathisafileitisdeleted.Ifpathisalinkitisdeletedbutitstargetisnot.IfpathisadirectoryanerrorissignalledddpathDeletesthedirectorypath.dsrpathDeletesthedirectorypathfromthesearchrules.groupresetprefixResetallfilesthatwhosenamesbeginwithprefix.linkpathtargetCreatesalinkcalledpath,andmakesitstargetpathtarget.ls[pattern][-dirpath][-patpattern]Listtheentriesindirectorypath.If-dirisnotspecified,theworkingdirectoryisassumed.Thepatterncancontainregularcharactersandthereservedcharacters"*"(matchanysequenceofcharacters)and"#"(matchanyonecharacter).lsdListthecontentsofthelocalsystemdirectory.Thelistingisprintedinthefollowingformat:AbsolutePathname(timelastmodified){Dirty}If{Dirty}isnotpresent,thenthelocalcopyofthefilehasnotbeenmodified.lsrListthesearchrules.makepathAsimplewayofcreatingatextfile.mkdirpathCreatesadirectorycalledpath.pbfPrintsthenumberofpagesthatCIFSwilltrytokeepfree.pwdPrintstheworkingdirectory.CIFSRenamefromPathtoPathRenamesthefilenamedfromPathtobenamedtoPath.resetabsolutePathDiscardsanyupdatesthathavebeenmadetoabsolutePaththathavenotbeenpermanentlyrecordedwithbackup.absolutePathmustbeanabsolutepathname.sbfpages4tНoОb$wНIОb$НЗОb$pН1О_їНюННvН%HН&ЖuН(ГО_їН)≤О_їtНoО]* wНО]*НЄО]*pН1ОZ╛uН╞ОZ╛Н`ОZ╛pНЎОZ╛Н!ОZ╛Н&НMНЁННnН$uН%≈ОZ╛Н&GОZ╛pН(╔ОZ╛Н)ОZ╛Н*Н+4Н-ЩН/PН0╧Н5┼Н8Н9ъН=ҐН?%НBouНCНОZ╛НD·ОZ╛pНFЩОZ╛НG`ОZ╛НHeН1ОYННСНeНпtНoОV┬wНTОV┬НОV┬pН1ОT ННzuНLОT НЭОT tНoОQ█wНЇОQ█НhОQ█pН1ОOННzuНLОOНЭОOpН"^ОOН"вОOН%еН($Н,^uН/6ОOtНoОL▓ wН'ОL▓НвОL▓pН1ОJНЭНЛНзН╗Н!жН&Н)ДuН,ЪОJН-╟ОJtНoОG≤wН0ОG≤НЮОG≤НJpН1ОEННDНuНОEН╦ОEpН!√ОEН"rОEН%)Н)bН+<Н/uН2DОEН2ЄОEtНoОB²wНФОB²НTОB²НtНМОB²Н\ОB²wНxОB²Н(ОB²НН FpН1О@ НИН>Н╔НIuН#О@ Н#аО@ pН%·О@ Н&ЙО@ Н(bН+Н,fН.я Н4эН71Н<~НBFНC╗Н1О>xН=Н/ННН"Н&Г Н-┬Н0sН3Н8Ё Н?TНBНFНН1О<яННр Н ╦Н#pН&ІН+SН-ТН0÷ tНoО:TpН1О7жН%НЇНYНDН!жН%OН)Щ Н1Н4Н8eН:Н? Н@ЙНC|Н1О6/uНРО3╡Н iН#ЙН&wН,kpН1О14НЁНҐН)Н·Н!йН$ЯН'PН*√Н-ХН/║Н2Н4jН6ъН9TН<╠tНoО.ЇpН1О,:НСНRН▄tНoО)╪wНО)╪НхО)╪pН1О'?НҐН"НЗНЁН!ЙН#Н%лtНoО$бwНZО$бН О$бpН1О"DННDНuН" О"DН"ЎО"DtНoОгpН1ОIН(Н┤НЁНlН#7Н&Н)╨Н,eН.█Н0<Н3█tНoОлpН1ОOН(Н┤Нч tНoОя wНКОяНZОяНТpН1ОTН#Н┌НЛuН!rОTН!АОTpН'uОTН'ДОTН)#Н+uН/ ОTН0ОTtНoОвwНкОвН|Ов pН1ОYНҐНOНXН"Н%OН(²Н,OuН-ООYН.÷ОY pН5ИОYН6XОYН8╘Н;АН>GНA√ Н1О╡НМtНО╡Н╦О╡pН5О╡uН ∙О╡Н!EО╡ pН(·О╡Н)хО╡Н,Н-ВН/ГН5VН8|tНoО 5wН║О 5НQО 5vН)хОЖ╔TVm$"wНzО*▌НИО*▌Н┐pН юО(Н╡НН{uНО(НpО(pН О(Н sО(Н!╡Н#ёuН()О(Н( О(tНЧО%⌠wНZО%⌠НО%⌠ pН юО#НlННGН'Н─Н!НН%юuН'─О#Н(0О# pН/⌡О#Н0 О#Н2{Н5сН8ZН;х НCсН юО!otН зО!oН▀О!opНО!ouНhО!oНО!o pНqО!oН⌡О!oНыН йН"╨Н()SetbasefreepagessetsthenumberofpagesthatCIFSwilltrytokeepfree.Ifnoargumentissupplied,CIFSwillensurethatthereareenoughfreepagesaccordingtothecurrentsetting.SettingthenumberofbasefreepagestobemorethanthesizeofthelocaldiskwillcauseCIFSnottocachefiles.swapfileafilebSwapthecontentsoffileaandfileb.wherepathAppliespathnameexpansiontopathandprintstheresult.typepathTypesthecontentsofpath.unlockEmergencybruteforceunlockofallfiles.A.4TheSalvagerCIFSincludesasalvagerthatwillrebuildtheLSDfromtheleaderpagesofallfilesonthedisk.ThesalvagerisinvokedbybootingCedarwiththe"l"switchandansweringthequestionsintheobviousway.SalvagingcantakeseveralminutesonaDorado.PartB:ProgrammersGuideTheprogrammer'sinterfacetoCIFSisimplementedbythreedefinitionsfiles:CIFS,CIFSFeedback,andFileLookup.Thesefilesarereproducedbelow,withthecommentsinthefilesservingasitsdocumentation.ThefileCIFScontainstheinterfacesofmostusetotheapplicationsprogrammer.CIFSFeedbackisforusebythe"Watcher".FileLookupprovidesaccesstoagenerallyusefulsinglepacketprotocolforinterrogatingIFSfileservers.--CIFS.mesaJune2,19826:55pm--InterfacetotheCedarInterimFileSystem.--CodedAugust,1981byD.Gifford--Lasteditedby--MBrownonAugust30,19821:06pmDIRECTORYAscii:TYPEUSING[NUL],File:TYPEUSING[Capability],Rope:TYPEUSING[ROPE];CIFS:CEDARDEFINITIONS={--PublicProcedures--OperationsthateveryonewillwanttouseOpenFile:TYPE=REFFileObject;FileObject:TYPE;--Thistyperepresentsanopenfile.--IfaninstanceisnotNIL,itrepresentsanopenfile.Context:TYPE=REFContextObj;--IfNILissuppliedasacontext,CIFSwilluseitsdefaultcontext5pН1Оb)НtНsН#НрН WН"⌡Н'╚Н)HН,ВН/╘Н3AН5яН7эН9oН<єН@НA{НCeН1О`┌НаНнНїН wН%Н'ТН+╒Н.Н3(Н6Н: Н@nНBAНDеН1О^зН┴Н=Н╗Н#ъН%єН(йН+╒Н/xН12Н3.Н6мН9ЧНН=Н²НuНеОN>Н uОN>tНoОKюpН1ОIBНXНН ─Н%Н&©Н(╞uНўОFдН8НШpНўОDFНwНОН.Н┐НfН"&Н'Н)xН,ъН0ZН2оН7Н:ФН<ЁН>╦НA╨НCуНFIНўОB·Н⌡НЯНrНхНыН"ЫН'&Н*VН,кН/(Н3wН6CН<оН?CНElНG/НўО@ВНнН┌НІНAН!;Н%кН+Н- Н.3tНўО>yНгНґ НpНўО;ШНoННїН?Н"щН$3 Н,nН.SН1ф Н8Н;пН?фНўО:TН~ НН'Н.Н!⌡ Н(ЧН-|Н0╟Н3)Н9пН;≈Н>НAНEМНGЄНўО8╛ НЭНзНIН Н%mН'с Н.Н/аН3$Н5÷Н7SН9╧НAU НўО7ННsНіННН T Н'Ъ Н/sН4ВН8ЫН:°Н;╩НA√НEєНўО5^Н НwНЄН ыН#░Н%ЫНўО0aН%НўНН█НсН БНўО.╦Н%НКН НЫНН!Н#щНўО-Н%Н∙Н╚НЯНМНХНўО+gН%Н)НXНўО)ЎН-НСНЫНЇНТН!:Н$IНўО$цН ІО#Н║НнН Н ІО!qНН4НoН ІОхНДННLНўОwНэНu Н |Н"aНўО%Н%Нi НўО|Н% Н+НЫНуН ─Н#щН%▀Н ІО*НMНzН_Н╪ Н ІО│ НТН©ОьН6НPН` НБНрН"EН©О/Н6Н╦Н╗НЖНaНжН AН!≈ Н(Н* Н-|Н ІОчНgН■НyНу Н©О 5Н6Н╦НйН6НфНtН·Н#кН'Н*+Н,═Н.zН3#vН)хОЩ TVm$)Н┬Н═Н∙НlН=ОC#НЄН$Н:Н─Н|НwН=ОAuНЄН ╦Н ГН=О?фН╪Н ┌Н┬НFН┐НиНьН=О:╨НEО9Н 0Н]Н≤НEО7]Н √Н цНЧНEО5╞Н sН═НшН=О2QН kН ННПН=О.ТНЄН Ь Н=О-EНЄ Н ╨Н┬НdННlННEО)ХНэН НННK НEО(: Н ┐НNО&▀НеНъНО НqНaНтНNО$эНеН GН7Н┘НПНeНпН& Н ╗Н"≥Н&НEО!НЖН#ННd НNОяНеН GН YНеНUНН-НZН Н"╨Н%/Н' Н+╡НEОs Н3НEОhН юНМНрНEО╧Н╪Н ] НContextObj:TYPE;Mode:TYPE=CARDINAL;--anycombinationofmodescanbeused,butusefulsets--ofcombinatatonsare:--{read},{write},{write,create},{write,replace},{write,create,replace}--dontCheckcanbeincludedinanyofthesesetsread:Mode=1;--readmodesetsanon-exclusivelockonthefilewrite:Mode=2;--writemodesetsanexclusivelockonthefile--includesreadbydefaultcreate:Mode=4;--createmodewillcreateafileifitdoesn'texist--normallywriteandcreatemodesareusedtogetherreplace:Mode=8;--Imaginethatthefileopenedis"foo"--andthefilethat"foo"isstoredinisF--replacemodedoesthefollowing:--(1)itcreatesanewemptyfileF'atOpentime--(2)thisisthefilereturnedtotheclientbyGetFC--(3)atclosetimeitmakes"foo"pointtoF'--(4)Fismadetemporarysoitwillbedeletedatthe--nextbootdontCheck:Mode=16;--Iffileisonthelocaldisk,assumethatthecopyiscurrentanddon't--checktheremotesever--Usefulasaperformanceoptimizationforfilesthatare"immutable"maxPath:CARDINAL=200;--Maximumpathlengthis200charactersmaxComment:CARDINAL=300;--Maximumcommentlengthis300charactersClose:PROC[fh:OpenFile];--Closeafile--Errors:NoneConnect:PROC[name,password:Rope.ROPE];--Setconnectcredentials--Errors:NoneCreateDir:PROC[name:Rope.ROPE,c:Context_NIL];--Createadirectory--Errors:{illegalFileName,localDiskFull,noSuchDirectory,ConnectionErrors,--CredentialsErrors}Delete:PROC[name:Rope.ROPE,c:Context_NIL];--Deleteafile--FilesarecreatedbyOpen--Errors:{illegalFileName,noSuchFile,requestRefused,localDiskFull,--fileBusy,noSuchDirectory,ConnectionErrors,CredentialsErrors}6pН ІОa▒ НєН ІО\⌡Н1Н^НCН ІОZСН-Нн Н╪НuНоН"ZН$KН'ъН*`Н.yН ІОYLН-НФН Н ІОW╔Н╠Н┘Н╩НBН#MН'сН-≥Н2 Н6zН ІОUЩН-Н)Н╣Н╔Н LН!ЗН$ Н&SН)щН ІОTVНJНLН1Н©ОR╞Н6НPН&НгНЯН#▐Н&┬Н(▌Н*НН ІОQНґН╞Н■Н©ОO`Н6НЁН┴Н*НН!ВН$ПН&ЖН)VН©ОM╧Н6Н≥НЄН╟Н ІОLН2Н4НН©ОJjН6Н8НН╧Н╪НФН"OН#╟Н%Н)дН©ОHцН6НН└Н;Н >Н$≤Н&КН*'Н ІОGНМНОНтН©ОEtН6Н█Н[Н╩Н$Н"Н#oН©ОCмН6НМНMНІН└НYНеН#ХН%√Н'Н©ОB%Н6НТНиНЗНY Н©О@~Н6Н]НЁН:НdНRН ▄Н"УН$╧Н&QН*Н©О>вН6Н]НЪНjНйН3Н нН"}Н$эН(°Н*≤Н©О=/Н6Н]НЖН]Н┌НыН Н#ФН'┘Н)4Н©О;┬Н6Н]НиН5НТН≈Н![Н"╡Н%]Н'NН,"Н-╩Н©О9АН>НNН ІО89 Н,Н.НН©О6▓Н6Н╦Н!Н█Н⌠НРН9Н Н%GН(Н*uН-гН/3Н3ЭН6ЄН©О4КН6ННwНН©О3CН6НіНTН~ Н┌Н'{Н)╦Н,іН/tН1г Н ІО/УНЮН)ННгО.MН>НЛННLН ╦Н#M Н ІО,і ННdН!IНгО*ЪН>НЛНУН".Н# Н&/ Н ІО'╟НЗНjН НгО& Н>НН2НгО$aН>НПН ІО!Н╘НН■Н# НгОkН>Н·Н╣ НгОдН>НПН ІОu Н⌡ННї Н%БН'zН,╠Н.>НгОнН>НєНмНгО'Н>НПН О Н)дН4╦НгОНцН ІО1Н∙НН║ Н#шН%tН*╚Н,8НгО┴Н>НєНнНгОБН>Н НННЇНЁНгО ;Н>НПН О Н(░Н2° НгО⌠НцНgН"[Н-фvН)хОЩЪнTVm$Ў&мНVО-Н мН3Н\НVО+eН мНН~ Н"SН-GНVО)ҐН RНEО&kН$Н■Н0 НjНН#:Н$гНVО$бН мН3Н]НVО#Н мН )Н}НFНBНVО!pН мНН~ Н!Н++ НVОхН RНDeleteDir:PROC[name:Rope.ROPE,c:Context_NIL];--Deleteadirectory--Errors:{noSuchDirectory,directoryNotEmpty,ConnectionErrors,CredentialsErrors}GetFC:PROC[fh:OpenFile]RETURNS[fc:File.Capability];--ReturnsthePilotFileCapabilityofanopenfile--Errors:NoneGetPathname:PROC[fh:OpenFile]RETURNS[path:Rope.ROPE];--Returnsthepathnameofanopenfile--Errors:NoneOpen:PROC[name:Rope.ROPE,mode:Mode,c:Context_NIL]RETURNS[fh:OpenFile];--Openafile--Errors:{ConnectionErrors,CredentialsErrors,FileErrors,localDiskFull,fileBusy,--noSuchDirectory}Rename:PROC[from:Rope.ROPE,to:Rope.ROPE,c:Context_NIL];--Renameafile--Errors:{ConnectionErrors,CredentialsErrors,FileErrors,localDiskFull,fileBusy,--noSuchDirectory,fileAlreadyExists}Swap:PROC[filea:Rope.ROPE,fileb:Rope.ROPE,c:Context_NIL];--Swapthecontentsoffileaandfileb--Errors:{ConnectionErrors,CredentialsErrors,FileErrors,localDiskFull,fileBusy,--noSuchDirectory}--PublicProcedures--OperationsthatsomepeoplewillwanttouseAddSearchRule:PROC[path:Rope.ROPE,before:BOOLEAN,c:Context_NIL];--Addasearchrule--IfbeforeisTitwilladditbeforetheothersearchrules--Errors:{ConnectionErrors,CredentialsErrors,localDiskFull,noSuchDirectory}CopyContext:PROC[from:Context_NIL]RETURNS[c:Context];--Copyacontext--Iffromisomitted,CopyContextwillreturnacopyofthedefault--context.--Errors:NoneCreateContext:PROCRETURNS[c:Context];--Createanewcontextfortheinterpretationofnames--The"JerryBrown"Operation--Errors:NoneCreateLink:PROC[path,targetPath:Rope.ROPE,c:Context_NIL];--causespathtopointtotargetPath--wheneverpathisusedasafilename,itwillberesolvedto7pН ІОb! Н°НН╗ Н%БН'zН,╡Н.?НгО`xН>НєНнНгО^оН>НПН!■Н.Н9mН ІО[~НвНGНХН©ОYуН,Н║НгОX-Н>НvНуННС Н%√Н'OН)@Н,╡НгОV└Н>НПН ІОS3НзНJНКН©ОQ┼Н,Н/ НгОOАН>НvНуН7Н ПН"ЮН&SНгОN8Н>НПН ІОJГНЗНjН Н#@Н'░Н+ЙН-┌Н2╧Н4FН©ОI>Н,Нм НгОG√Н>Н Н3НгОEМН>НПН"Н-U Н48 Н= НгОDDН>Н ІО@СН²Н НQ Н$▀Н&Ё Н.МН0┘Н5ҐН7IНгО?JН>Н╛НжНгО=╒Н>НПН"Н-U Н48 Н= НгО;ЫН>Н2Н ІО8╗НЕНUН@ Н"zН&$ Н.^Н/ЖН5.Н6╩НгО6ЪН>НТНSНбН{Н!┼Н$AНгО5VН>НПН"Н-U Н48 Н= НгО3ўН>НўО0\Н%Нi НўО.ЄН% Н+НЫН▄Н Н"ЁН&Н'ЎН ІО+b НН┼Н █ Н(гН-░Н5uН7 ННYН┐Н╪НгО(Н>НюНН{НГН=НХН ═Н!ЖН&EН(╔Н,DН0~НгО&hН>НПН"Н-U Н6*Н ІО#Н≈ННKН$┌Н&Н©О!nН,Н(НгОфН>НСННгОН>НюН'Н⌠Н Н%iН(Н,CН-mН0©Н2xН4вНгОtН>НгОкН>НПН ІОz НHН©ОяН,Н(НгО)Н>НєНмН╩Н░Н мН#- Н+лН-┘НгО─Н>ННDНdНгОвН>НПН ІО ├ НaНяНЁ Н$╩ Н,УН.█Н3дН5QНгОщН>НxН·НMНЛН НгО 5Н>НsН≥ННAН ОН"Н$┌Н( Н)ПН,⌡Н.▄Н3ЗvН)хОЖЪTVm$cНЇНVО'КН мН3Н\НJНН\Н╪ Н$[Н&НVО&AН мН╔НсНСНVО$√Н мННEО!B Н ПН`НB НJ Н%└Н'Н,SН-ЮНVО≤Н мНН-НэН{Н) НVОМН мНН(Н■НпН~Н╗НН!)Н"Н%*Н'Н,┴НVОCН м НVО≥Н мНН Н%Д Н.╧НVООН RНEО НвНGНCНz--targetPath--Errors:{ConnectionErrors,CredentialsErrors,localDiskFull,noSuchDirectory,--linkAlreadyExists}DeleteContext:PROC[c:Context_NIL];--Destroyacontextfortheinterpretationofnames.--The"EdwardKennedy"Operation--Errors:NoneDeleteSearchRule:PROC[path:Rope.ROPE,c:Context_NIL];--Deleteasearchrule--Errors:NoneEProc:TYPE=PROC[name,link,comment:REFTEXT]RETURNS[stop:BOOLEAN];--Procedurethatiscalledfordirenumeration--nameistheentryname--iflink.length#0thenlinkisthepaththatnamewillberesolvedto--ifcomment.length#0thencommentisacommentfornameEnumerate:PROC[dir:Rope.ROPE,pattern:Rope.ROPE,p:EProc,c:Context_NIL];--Enumeratethecontentsofadirectory--patterncancontain"*"and"#"--apatternof"*"enumeratestheentiredirectory.--Ifdir=NILordir=""Enumerateassumesthewdir--Errors:{ConnectionErrors,CredentialsErrors,localDiskFull,noSuchDirectory}GetSearchRules:PROC[c:Context_NIL]RETURNS[LISTOFRope.ROPE];--Returnsthelistofpathsinthesearchrules--Errors:NoneGetWDir:PROC[c:Context_NIL]RETURNS[path:Rope.ROPE];--Returnthepathoftheworkingdirectory--Errors:NoneLogin:PROC[name,password:Rope.ROPE];--Setcredentials--Errors:NoneSetDefaultContext:PROC[c:Context];--Setthedefaultcontext--Errors:NoneSetComment:PROC[path,comment:Rope.ROPE,c:Context_NIL];--Setsthecommentonthespecifiedpathtobecomment--Errors:{ConnectionErrors,CredentialsErrors,FileErrors,localDiskFull,--noSuchDirectory}SetWDir:PROC[path:Rope.ROPE,c:Context_NIL];--Setworkingdirectory--Errors:{ConnectionErrors,CredentialsErrors,localDiskFull,--noSuchDirectory}8pНгОb)Н> НгО`─Н>НПН"Н-U Н6*НгО^вНцН ІО[┘ НHН╦НЄН"КН$xНгОYэН>НjН■НiНіН! Н)╔Н+^НгОX3Н>ННХН █НгОV┼Н>НПН ІОS8НfНжН!ы Н*Н+╚Н0БН2oНгОQ▐Н>НєНнННгОOФН>НПН ІОL∙НGНtНYНиН!DН$iН*КН.GН©ОJЛН,ННгОICН>НлН ННЩН":Н$m НгОG Н>НЧНjНиН]НгОEЯН>Н÷Н┼Н╟Н!|Н"ХН%GН(nН+<Н.ЭН1їН3≤Н9НгОDHН>Н÷НфН!ЛН'УН)aН*┼Н0⌠Н2пН ІО@Ж Н6НіН╣ Н$ОН*' Н2aН4&Н8√Н:.Н?fН@РНгО?MН>НEНєН Н!лН"ЖНгО=єН>НЩН┬НgНЩН"ЄНгО;ШН>НhН'НЮНu Н"ЎН%Н) НгО:RН>НюНСНьНКН╞НАНфН!╚Н(╡Н-ЪН0^НгО8╘Н>НПН"Н-U Н6*Н ІО5WНGНІН╡Н#ИН%vН©О3ўН,Н.Нґ НгО2Н>НvНуННлН wН"%Н$└Н(ЎНгО0\Н>НПН ІО- НYНиНеНЭН!┴Н©О+aН,Н/ НгО)╦Н>НРНQНxН1Н░Н$ГНгО(Н>НПН ІО$ҐН1Н║НН!▓ НгО#Н>Н· НгО!lН>НПН ІОНЎН.Н *НгОqН>Н·НЩНіНгОхН>НПН ІОv НvНФНхН%J Н-└Н/Н4TН5АНгОмН>Н"Н┌Н┼Н▒Н ПН&╛Н)рН+│Н-rНгО$Н>НПН"Н-U Н48 НгО{Н>Н ІО)НЖНfНi Н$ёН&<Н+sН-НгО ─Н>Н·НУНгОвН>НПН"Н-U НгО .Н>vН)хОЪЕTVm$gН▄Н5НVО.ЩН мННEО+· ННuНWНы Н&Н'╛Н,ЦН.pНVО)ОН мН╠ННН НН;Н"aН$Н&НVО(@Н мНН Н%Д Н,г НVО&░Н мНEО#2Н┘НУНЬ Н2НкН$Н%▐НVО!┐Н мН-Н└НVОсН мНН Н%Д НVО$Н мН=ОеНЄН Ь Н=ОНЄ Н ╨Н┬НвН═НKН╗Н!VНEОЇНуНEНА ННЁН#ЙН%wНNО--PublicProcedures--OperationsthathardlyanyonewillwanttouseExpand:PROC[name:Rope.ROPE,c:Context_NIL]RETURNS[path:Rope.ROPE];--Expandsanameintoafullpathname--MayraiseCIFS.Errorifthefileisnotinthedir--system.--Errors:{ConnectionErrors,CredentialsErrors,FileErrors,localDiskFull,--noSuchDirectory}ExplicitBackup:PROC[name:Rope.ROPE,c:Context_NIL]RETURNS[version:INT];--Explicitbackupofthenamedfiletoitsremoteserverhome--Theserver'sversionnumberforthebackingfileisreturned--IfnamehasaversionnumberthenExplicitBackupwilluse--thatnumberforthebackingfile--Errors:{ConnectionErrors,CredentialsErrors,FileErrors,fileBusy}GetBaseFreeSpace:PROCRETURNS[pages:INT];--Getsthenumberoffreepagesthatshouldbemaintained--onthelocaldisk--Errors:NoneOpenButDontHandleError:PROC[name:Rope.ROPE,mode:Mode,c:Context_NIL]RETURNS[fh:OpenFile];--Openafile--SameasOpen,exceptthatitwillnotautomaticallyhandle--acredentialerror.--Errors:{ConnectionErrors,CredentialsErrors,FileErrors,localDiskFull,fileBusy,--noSuchDirectory}Reset:PROC[name:Rope.ROPE,c:Context_NIL];--Resetafilefromitsbackingstore--namemustbeanabsolutepathname--Errors:{noSuchFile}SetBaseFreeSpace:PROC[pages:INT_0];--Setsthenumberoffreepagesthatshouldbemaintained--onthelocaldisk--Ifpagesisomitted,CIFSwilljustensurethatthereare--enoughfreepagesaccordingtothecurrentsetting--Errors:None--Exceptionalconditions--Unfortunately,everyonehastoknowaboutthese--IneachCIFScallthemostlikelyerrorsarelisted.However,aclient--shouldbepreparedforvariantofErrorCode.Themessage"error"is--essential,andshouldbeshowntotheuser.HandleError:PROC[code:ErrorCode,error:Rope.ROPE,reply:CHARACTER_Ascii.NUL]RETURNS[resume:BOOLEAN];--Attemptstohandleacredentialerror.Theusageofthisprocedureis:9pНўОa┼Н%Нi НўО_эН% Н+НЫНHН!Н#╪Н'Н(гН ІО\─НFНІНR Н$▄Н&$Н+[Н,ХН©ОZрН,Н/ НгОY$Н>НыННбН НдН"OН%uНгОWvН>НnН╘ НЕН FН"╔Н%Н&zН(ОН*²Н,ЩНгОUхНGНгОTН>НПН"Н-U Н48 НгОRmН>Н ІОOНЇН'Н ц Н(ЩН*∙Н/лН1YН©ОMcН,НпНгОK╣Н>НTН)НБНBН#хН&2Н'ЮН)╨Н.bН2nНгОJН>ННЪНгН"ТН%1Н'░Н,╠Н/Н0├НгОHYН>НюН─НУННФН$Н'9 Н0юН3kНгОF╚НцН▒НҐНЗНZН#{НгОDЩН>НПН"Н-U Н48Н ІОA║НсНC Н)сНгО?СН>Н┘НДННйН √Н$aН'0Н+╛Н-° НгО>EН>НEНєНЙНгО<≈Н>НПН ІО9;Н╡Н#"Н'Ў Н/ЫН4HН8╒Н::Н?rН@ЧН©О7█Н,Нм НгО5ъН>Н Н3НгО41Н>НЧН╛НоНН!НН#DН%ОН(dН0вНгО2┐Н>Нh НЎНгО0жН>НПН"Н-U Н48 Н= НгО/(Н>Н ІО+лНШНkН Н#AН$ыН*Н+²НгО*Н>Н Н3Н²ННчН"ЪНгО(pН>НЧНfНWНGН!ІН$эНгО&бН>НПН ІО#fНp Н"Н%Н&╒НгО!╦Н>Н"Н┌НўНgН 4Н#ЪН&мН+IН-9 НгО Н>НEНєНЙНгО\Н>НюН▀НВНeН!Н#еН&gН*лН- Н1$НгОўН>Н(НУНюН#Н$╞Н'Н+ьНгОН>НПНўОєН% Нє НўОЖН% НiНEН╨Н!hН%'Н) НўОHН%НТН%НыНdНдН Н"ъН&уН))Н-╞Н3ЦН5 НўО Н%Н═Н▒НcН║Н!=Н"Ж Н*╚Н-┐Н2шН7ґНўОМН% НЖНґН)НН!iН#Н%wН ІО ▒Н?Н╞Нр Н&Н)О Н2)Н6+Н?╪НAH Н©ОЦН,НяН©О 5Н6Н)НвН^Н┬ Н#чН(,Н+Н.оН0┬Н3*Н9╛vН)хО╚TVm$т мНOНН├НТН╘НTНЖН#[Н&)Н)ЁНVО0\Н мНЇН└НOН▐Н>Н²Н$gНVО.ЄН мНН=О+bНЄ Н3 Н=О)╨НЄ НЬНтНIНВНІН!≤Н=О(НЄН┐НЄНhНСНSН╞НnНdН!╦Н&>Н,rН-°Н=О&hНЄН/Н НРН0НлН┘ Н#:Н&Н+jН0<Н=О$юНЄ Н┘Н<Н╦Н╘НЬНіННEО!nНнН>Нa Н⌠Н"~ Н*╦Н.╨Н8KН9в НNОфН╩Н`НNОНеН╦НfНМН НmН ╩Н#⌠Н'^Н)Н+╧Н2;НNОtНеН1Н--CIFS.Operation[args!--CIFS.Error=>{IFCIFS.HandleError[code,error,reply]THENRESUME}];--NOTE:TheabovecodeisincludedinCIFS,soaclientdoesnothave--towriteit.Thisprocedureisexportedonlyforcompleteness.Error:SIGNAL[code:ErrorCode,error:Rope.ROPE,reply:CHARACTER_Ascii.NUL];--errorusuallycontainsaninterestingmessage--replyisthecodepassedfromserver(seeSTPReplyCode.mesa)ErrorCode:TYPE={--connectionerrorsnoSuchHost,noRouteToNetwork,noNameLookupResponse,alreadyAConnection,noConnection,connectionClosed,connectionRejected,connectionTimedOut,--credentialserrorsaccessDenied,illegalUserName,illegalUserPassword,illegalUserAccount,illegalConnectName,illegalConnectPassword,credentialsMissing,--protocolerrorsprotocolError,--fileerrorsillegalFileName,noSuchFile,requestRefused,--remotestreamerrorsaccessError,--catchallundefinedError,--localdiskfulllocalDiskFull,--fileislockedfileBusy,--filealreadyexistsforarenamecommandfileAlreadyExists,--directorydoesnotexistnoSuchDirectory,--directorycontainsfilesandcannotbedeleteddirectoryNotEmpty,--linkalradyexistslinkAlreadyExists};ConnectionErrors:TYPE=ErrorCode[noSuchHost..connectionTimedOut];CredentialsErrors:TYPE=ErrorCode[accessDenied..credentialsMissing];FileErrors:TYPE=ErrorCode[illegalFileName..requestRefused];}..--CIFSFeedback.mesa--InterfaceforCIFStoreportSTPactivities--CodedbyM.D.Schroeder,July16,19821:49pm--Lasteditedby--MBrownonAugust30,19821:24pmDIRECTORY10pН©Оb!Н6Н╒Н┘Н©О`wНц НЧН■Н4Н-IН1Н4ЪН9∙Н©О^мН6Н8НННYН еН&kН(Н,&Н-ЙН/Н2тН6Н8zН©О]#Н╨НhНФНН2Н!╣Н#!Н(щН+ЖН.4Н ІОYоНЦНОН Н#DН'/ Н/iН3kН<ЭН>┴ Н©ОX%Н6Н╗НZНЎНў Н&gН©ОV{Н6НЎН*Н┴НпН6Н"²Н&╙Н)vН ІОS' Н Н6НН©ОQ}Н6 Н2Н©ОOс НшН#╚Н3НН©ОN*НЬН#XН©ОL─Н©ОJжН6 НН©ОI,НН"HН.ЩН©ОG┌Н╟Н*█Н©ОEьН6НєН©ОD. Н©ОB└Н6Н÷Н©О@зН Н ╞Н©О?0Н6НщНMН©О=├Н©О;эН6НкН©О:2Н©О8┴Н6Н|НjН©О6ъ Н©О55Н6Н÷НН©О3▀Н©О1АН6Н÷НsН'НdН▌Н#wН©О07Н©О.█Н6НН8НґН©О,ЦН©О+9Н6ННkНYН!Н#⌡Н&Н(Н©О)▐Н©О'ЕН6НН0Н©О&;Н©О$▒Н ІО!>НBНoНTП*Н ІО■Н!НNН3П,Н ІОЙ Н╩НХНмП+НўО√НўО≤Н%НўОНН%НКН)НщН▄Н╞Н"Ё НўОDН%Н∙Н▒НбНҐ Н≤Н"▓Н$оН(Н+$НўО Н%Н)НXНўОПН-НСНЫНЇНТН!:Н$IНўО СvН)eОЩ┌TVm$ЦНиНьН=ОНEОqН sН═НшН=ОН&Ню НгН ╛Н=ОмНН┴Н╠Н! НиН VНEО$Н╪НqННїН НQНтН"ОН$Н'н Н.fНEО{Н ║Н НрНьНН╘Н# Н*JН+√Rope:TYPEUSING[ROPE];CIFSFeedback:CEDARDEFINITIONS={Register:PROC[p:PROC[Rope.ROPE]_NIL];--CIFSwillcalltheregisteredprocedurewithaRopedescribingeach--filemanipulationactivityonaremoteserver.Registeringp~NILwill--stopsuchreporting.--Thestyleofuseis:passanon-emptyropeatthestartofanactivity,--passanemptyrope(e.g.NIL)attheendoftheactivity.}..--FileLookup.mesa--M.D.Schroeder,September7,198211:54amDIRECTORYRope:TYPEUSING[ROPE],System:TYPEUSING[GreenwichMeanTime];FileLookup:CEDARDEFINITIONS=BEGINResult:TYPE={noResponse,noSuchPort,noSuchName,ok};LookupFile:PROC[server,file:Rope.ROPE]RETURNS[result:Result,version:CARDINAL,create:System.GreenwichMeanTime,count:LONGCARDINAL];--ThisprocedureusestheLookupFilepacketexchangeprotocoltoobtainthe--versionnumber,createtime,andbytelengthofafileonaremotefileserver.--Thefilenamemaybespecifiedcompletewithversionnumber,with"!h",with"!l",--orwithnoversion.Thefilenamescanbespecifiedeitherwiththe"<..>..>.."syntax--orwiththe".../.../..."syntax(besurethatthenamedoesnotstartwitha'/).--Iftheresultis"ok"thentherequestedfileexistswiththereturned--versionnumber,createtime,andbytelength."noSuchName"meansthateither--theservernamewasnonsenseorthatthefiledoesnotexistonthatserver.--"noSuchPort"meansthattheserverrespondedwithano-such-porterrorpacket--whenproddedontheLookupFilesocket."noResponse"meansthateithertheNLS--didn'trespondtotheservernamelookup,theLookupFilepacketdidn'tgettothe--server,ortheserverdidnotrespondtoit.--LookupFilecachesthestateoftheserverasderivedfrompreviouslookupattempts.--Ifthecachedstateforaserveriseither"noResponse"or"noSuchPort"then--LookupFileimmediatelyreturnsthatresultwithoutattemptinganycommunication.--Suchnegativecacheentriesareflushedafterfiveminutes.Positivecacheentries--containthePupaddressoftheserver,eliminatingtheneedtodoaNLSlookup--ontheservername.--Thelongestthatyoushouldhavetowaitforaresponseis~4*(2+0.5*MIN[8,hopCount])--seconds.Thisisthetimeitwilltaketodecidedthataserverisn'tgoingtorespondinthe--caseofanuncacheddownserver.Mostanswersaredeterminedmuchmorequickly.11pН ІОb!НДННLНўО^мН≈Н1 Н&8Н(НўО[xН┼НЗН"Н▓ Н&:Н'гН ІОYнН-НБН█ННw Н бН'EН*`Н+┼Н/? Н5вН ІОX$ННzНCН IН!sН&Н*~ Н1╩Н3Н4■Н7іН ІОVzН╒Нт Н ІОTпН-НН6НОНdНIНBНlН&gН)≤Н+0Н-░Н0÷Н2XН4IН ІОS&Н╒Н⌠НлНЭНЪН!▀Н##Н%┐Н(:Н)СН,SН ІОOрНўОJтН%НўОI*Н%НVНQ Н,Н Н!÷Н$ЕН(єНўОEжН ІОD,НДННLН ІОB┌НМННUНўО?. НіН? Н$FН&+НўО;ыНwНєН┴Н = Н( Н0ЯНўО8┘ НіННщН юН(╒Н©О6шН,НтН|Н$ҐНгО51НCН&ЄН+Н/п НўО1щН%Н?НбН╩Н Н$≥Н(ТН.РН4`Н6Н:SНўО03Н%НЛНqНsНЯН"╗Н%╦Н)РН+╚Н,уН/>Н1DН2nН7Н9НўО.┴Н%НЩНfН&Н)НН!жН'ЎН*ыН/║Н5%Н8@Н;ЎН>ьНўО,ъН%НХНН НґН┘НОН$2Н&ЎН(ўН.jН2WН5qН7я Н=тНўО+5Н%НХННcН╪Н Н"jН%dН(2Н*▒Н.QН1│Н3ЖН7Н:!Н;KНўО'АН%НіННяН=Н≥Н©Н Н&_Н(хН,}Н/≤Н1ВНўО&7Н%НЛНqНsНЯН"╗Н%╦Н*нН4╪Н9Н;нНўО$█Н%Н└Н▒НPНЭН ЦН"їН%uН'тН*>Н-nН/ЦН3Н5Н7ХНўО"ЦН%НШН?Н Н mН$yН+(Н.CН/lН7┬Н:ЗНўО!9Н%НзН_НeНд Н#CН(MН1ZН5·Н8lН╦НўО▐Н%Н'НjННxН└Н#DН(CН*ё Н2!Н6|Н:Н<хН>wНўОЕН%Н┴НMНґН╧Н.НёН$ФН&■НўО░Н% НёНТНSН└Н!=Н#°Н'╘Н)WН.LН1ЁН7BН;ИНўОФН%НіНН≥НйНН1Н!=Н"╘Н&∙Н/╒Н1fН:<НўО<Н% Нё Н{Н".Н$ЭН(гН-с Н4╨Н7Z НўО▓Н%Н≥ННрНCН!√Н&vН)╠Н,hН2{Н7⌡Н;gНўОХН%ННcНGН1НЙН!IН%ў Н,ЮН/?Н2°Н4KН6QН7{Н:пНўО>Н%Н+Н┼Н≈НўОЙН%НЩН╞Н}Н4Н╟Н"ВН$╔Н'·Н)эН+Н0╙Н2Н3ёН6╡Н8≈НўО @Н%НН1Н°НЭН!НwН"#Н%Н&йН+ЛН.╩Н/ДН3ЯН6ЙН:ЄН{h.PutF["%s\n",IO.rope[error]];CONTINUE;};IO.EndOfStream=>{h.PutChar['\n];CONTINUE;};};fh_CIFS.Open[name:argv[1],mode:CIFS.read];riS_FileIO.StreamFromOpenFile[openFile:fh];;DOIFUserExec.UserAbort[]THENEXIT;n_riS.GetBlock[buffer];h.PutBlock[buffer];IFn#256THENEXIT;12pНўОa▌tНўОZН#НгpНўОU Н% НўОScН%НХНbННўОPН ІОNdН ІОL╨НYН├НюН* Н1EН;ЁН ІОKН÷НлНН ІОIeН ІОG╩Н ІОFНўОB╪НґН ІОAН╠НЎНpН#ЯН(╧Н ІО?hН⌡Н ІО<Н-НІНъН ІО:iН=ННН =Н ІО8©НфНўО7Н├НУНўНтННpН ІО3юН╦Н!$Н# Н©О2НЩ Н©О0lНk Н©О.бНGНЕНrН©О-Н┐Н©О+mН┐НRН7Н©О)цНgНцНН⌠Н©О(Н╞ Н⌡Н1Н©О&oН©О$дННгО# НН≤НnО!p ННnОфНnОНгОq НkННпОгНnОНnОsНгОхН©ОН┐НН{Н"XН&ї Н©ОtНЯН~П#Н*|Н©ОйНгО НЇНIН#чНгО uНН÷НгОкНгО !НЇННГН}НvН)eОЖ"TVm$LVОФН FН▒Н vНН║НVО<НNО▓Н >НИН╦НмНcНNОХНENDLOOP;IFn>0ANDbuffer[n-1]#'\nTHENh.PutChar['\n];};UserExec.ResetUserAbort[];IFriS#NILTHENriS.Close[];IFfh#NILTHENCIFS.Close[fh];};--MainlineUserExec.RegisterCommand["Type.~",Type,"Typefile",typeC];}.13pНгОb)Н©О`┌Н╞НZН)Н!>Н%тН©О^зН©О]3Н©О[▄Н╞НяНfН©ОYДН╞НcНЬН©ОX=Н ІОSGН-Н ІОQ═П"Н%жН)ІН-ОН1aН ІОNQvН)eОкTVm$T TIMESROMANЧ÷ HELVETICAЧ÷ TIMESROMANЧ÷ TIMESROMANЧ÷ TIMESROMANЩ┘LOGOЭЄ TIMESROMANЧ TIMESROMANЧ÷L╟ ┼ Р'Z-▐3╔9у@[E{M"PEQNЧ÷LOGOЭЄ TIMESROMANЧФ TIMESROMANЧY TIMESROMANЧ÷j/TR≥д■ЫЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪCifsManual.press 1-Oct-82 11:20:41