Interlisp.medley/docs/internal/STREAMS-KOTO.PRESS

StreamsandFileDevicesEdited30Nov84,vanMelleAnInterlispStreamisanobjectofdatatypeSTREAMthatiscapableofperforming,attheleast,sequentialinputand/oroutputofbytes.Somestreamscandomuchmore.Streamsareusedforaccesstoopenfiles,forwritingtothedisplay,forchattingtoremotehosts,andwhateverotherusespeoplecomeupwith.Thisdocumentdescribeshowonegoesaboutdefininganewdevice,themeaningsoftherecordfieldsoftheSTREAMandFDEVdatatypes,andanythingelsethatseemedrelevantatthetime.TheimplementationofStreamsisstronglyobject-oriented.EverySTREAMhasapointertoadevice(thedatatypeFDEV),whichcontainsavectoroffunctionstobecalledwhencertainoperationsarerequiredofthestream.Therecanbemanystreamswiththesamedevice.Intheobject-orientedtermsofLOOPS,onecanthinkofthedeviceasaclass,whichprovidesasetofmethodsthatimplementclassoperations,andthestreamsasinstances.Devicesandstreamsalsohavelocalstate,whichmightbethoughtofasclassandinstancevariables.DeclarationsforSTREAMandFDEVcanbeobtainedbyloadingEXPORTS.ALL.OPENSTREAM,CLOSEF,FORCEOUTPUT,READP,EOFP,GETEOFPTR,GETFILEINFO,SETFILEINFO,DIRECTORY,COPYBYTES,DELFILE,RENAMEFILE,FULLNAMEaresomeoftheLispfunctionscalledbytheprogrammerthatultimatelyturnintooperationsatthedevicelevel.Thedescriptionsthatfollowsometimesalludetothesefunctions,andknowledgeofhowtheyoperatemayoccasionallygivethereaderadditionalcluesastohowthedeviceoperationswork.Typically,somepartoftheoperationishandledbythe``generic''filesystemcode,whichthencallsonthedevicetohandlethatpartoftheoperationthatisdevice-specific.Forexample,thefunctionOPENFILEtakesthenameofthefileitistoopenandfillsinhostanddirectorydefaults,anddecideswhichdevicehandlessuchafile.Itthencallsontheparticulardevicetoactuallyopenthefile.Afterthefileisopened,thegenericfilesystemcoderegistersthefileon(OPENP).Asanotherexample,operationsinvolvingopenstreamsfirstcoercenon-streams(e.g.filenames)toopenstreamsbeforecallingthedevice-specificoperation.DevicesAdeviceisanobjectoftypeFDEV(sonamedforhistoricalreasons:``FileDevice'').Thestandardwaytodefineanewdeviceistocreatesuchanobject,byperforming(createFDEV--),andthenpassthenewlycreatedFDEVtothefunction\DEFINEDEVICE.\DEFINEDEVICEisthewayadevice``announces''itselftothegenericfilesystem.(\DEFINEDEVICENAMEDEV)[Function]InstallsdeviceDEV,givingitthenameNAME.NAMEmustbeanuppercaselitatom.Thegenericfilesystemcodemakesuseofthenametolocatethedevicethatiswillingtodealwithfileswhosefullnamebegins{NAME}.Itispermissibletohavemorethanonenamemaptothesamedevice;thiseffectivelyprovidesdevicesynonyms.Devicesareencouraged,however,toalwayscreatefilenamesusingthecanonicaldevicename,independentofwhatnamewaspassedin.NAMEcanbeNIL,inwhichcasethegenericfilesystemcodeneverconsultsthedevicedirectly.However,itsEVENTFNisstillrunaroundLispexits,anditcanbeusedasthedeviceforastreamcreatedbynonstandardmethods.
êq?€`½îïpÿ
êq?€`½îïî
êïg_pîâïaoqî&*î*’î/Iî7|ïaorïaoî7‚ïaoî	ôï]Âsî
[
î»îî±î¦îcï]Âî	ôïZar
îDî·îe
îÏ
î½îÐ
î†î%î%ïZatïZaî*ïZarïZaî*žî-i
î.Òî3Í
î5ƒ
î=
î>œî@ùîDr	îJÁîJÁïZaî	ôïXŽî
uîóî:
îÌî<1B>îîî›î$gî&Ë
î(ªî,Yî0î0zî5ˆî7µî:Éî<ßî@Ä
îBKîE•îH²îJÁîJÁïXŽî	ôïVÄî´
îrîâîúîHî˜
î!Wî&î)ñî,¹î2¤î6Rî9[î=äîA<C3AE>
îCÀîGAîG×îJÁîJÁïVÄî	ôïTúîoîfî|î:îfî#Xî(Õî*î-î1Áî43î:a
î<-î>ŸîBÿîFÄ
îH<C3AE>îJÁîJÁïTúî	ôïS0tîþïS0rïS0îVîßîßïS0tïS0î;ïS0rïS0î“	îÎîWî#Öî&^î(ýî-·î2È
î43î6dî9_ïS0î	ôïO¶îÔ
î²
îtî±
î&î$mî.?î.Íî2Ëî2ËïO¶tïO¶î7ÕïO¶rïO¶î8dî:âî<î@ã
îBšîCÎîHîJÂîJÂïO¶î	ôïMãîaîaïMãtïMãî½ïMãrïMã
îõîàî î+î"-
î#Æî) 
î+.
î-î0Ôî4iî8Í	î?VîAŠîF÷
îH<C3AE>îJÁîJÁïMãî	ôïLî³î1î*î®
î—îZî Fî#Wî%¯î)%î-¶î.5
î/þî2Uî;Àî?ƒ
îA4îA4ïLsïLîDêïLrïLîEÁîHdîJÁîJÁïLî	ôïJFî
e
îôî(î@
îÅîÅîÅïJFuïJFîyïJFrïJFî-î
î$nî%nî'a
î(ðî(ðïJFuïJFî-®ïJFrïJFî.	î0¬î7aî:f
îA;îCÈîEüîJÁîJÁïJFî	ôïHi
î·î·ïHiuïHiîðïHirïHiîàîzî¬îwî~î"]î%·î)î,©î0Èî4Ñ
î6Öî<
î=Õ
î?˜îBÛîE¥îJÁîJÁïHiî	ôïFŒ	îÔî,îåîôîôïFŒtïFŒîþïFŒrïFŒîVî!ßî!ßïFŒtïFŒî%;ïFŒrïFŒî%“î'ð
î)³î/1
î0ÿî5¶î5¶ïFŒtïFŒ
î>óïFŒrïFŒî?PïFŒî	ôïCt	îZïCrïCîyîyïCtïCîƒïCrïCî¢î¢ïCtïC
î"ßïCrïCî#þî#þïCtïCî(1ïCrïCî)Pî)PïCtïCî,¬ïCrïCî-Ëî-ËïCtïCî5ZïCrïCî6yî6yïCtïC
î?¶ïCrïCî@Õî@ÕïCtïC
îJïCrïCîJÂîJÂïCî	ôïA?tîƒïA?rïA?îbîbïA?tïA?îñïA?rïA?îÑîÑïA?tïA?î ²ïA?rïA?î!‘î!‘ïA?tïA?	î)÷ïA?rïA?î*Öî*ÖïA?tïA?î1ŽïA?rïA?î2î4kî7ÿ
î9¹î<î?3îE-îHó
îJÁîJÁïA?î	ôï?lîŠ	îŸî£	îLî!‡î$”	î+s
î-Dî/Úî4Sî8%î8ãî;ñîC·îF»îJÁîJÁï?lî	ôï=¢î«îÎ
îî
	î ^î#î)ú
î+¶î.¼î1Îî6¸î9¿îAZîDJîF¬îJÁîJÁï=¢î	ôï;Ø	î6îy
îú
îzîOî€î”	î&î)`ï;Øî	ôï8g	î>îÊî¨
î\î¶î Õ
î"<î'<27>
î)xî+Ñ
î1òî4Uî8Êî<bî@hîCˆîF<C3AE>
îH<C3AE>îJÁîJÁï8gî	ôï6<C3AF>î
î•îòî˜îS
îåîî#î%¿
î'î0Oî0®î30î8×î;î@]î@]ï6<C3AF>tï6<C3AF>îGï6<C3AF>rï6<C3AF>îGsîJÁîJÁï6<C3AF>î	ôï4Êî&î¹
îEîxî³
îÝ
î
îžîâîmî!é
î#kî&6î(Áî.aî3¶î6@î:ðî>ÎîBäîG¿îJÁîJÁï4Êî	ôï3îî
©î
îsî}îp
î\î¡	î·î#Þ
î%rî*jî-Áî0î2ªî3î6™î8Þî;+
î<}îA—îCÜîH‡îJÁîJÁï3î	ôï16îîÕîFî¶î/
îFîFï16tï16î$'ï16rï16î%î%¬
î'Îî,çî2Æ	î9î?’îCîHîJÁîJÁï16î	ôï/cî
îŒî`	îÐ
î Pî#“î(Xî,wî0ªî2Ûî;È	îAÃï/cî	ôï*×vîjï*×rï*×îpï*×î	ôï'/î€îÁ
î,
îî0
îèîöîöï'/tï'/îRï'/rï'/îØî"î&˜î(Ô	î.´î4î7Œ	î=¥î>*îAîF—îIA
îJÁîJÁï'/î	ôï%\îîîäî
îR
îàîÁîÑ
î!¢î%ï
î'Ë	î.Øî.Øï%\tï%\î/¯ï%\wï%\î4Rï%\rï%\î4¸î4¸ï%\tï%\î8ùî;~ï%\rï%\î<<î>ÓîAØîD±îFðîJÂîJÂï%\î	ôï#tî—î—ï#ttï#tîóï#trï#tîU
îßîîkîkï#ttï#tî&Vï#trï#tî'î'qî'qï#ttï#tî2\ï#trï#tî2¾
î4î6Aî8õî9üî>îFîIB
îJÂîJÂï#tî	ôï!¡î%î½î÷îHï!¡î	ôï0t
î<16>î<16>ï0xï0îï0tï0îÜîÜï0xï0îDï0tï0îï0rï0îDL	îObï0î‘ïCî/î`î`ïCxïCîÈïCrïCî•î ¤
î!éî$7î'æî'æïCxïCî+^ïCrïCî,*î,Ÿî,ŸïCxïCî0ïCrïCî0Œî3â
î5Â
î7¢î=úîBîîCcîF)îJÁîJÁïCî‘ïyîÜî:îbî|î Õ
î"qî$´î(V
î)çî-¿î0
î4'î6×
î8&î<‹
î>î@øîCôîFÃîJÁîJÁïyî‘ï¯îýî îÑî<1B>ï¯xï¯îùï¯rï¯
î iî Ó
î".
î#~
î*˜
î,*î/Sî2Éî5Ñî8`î<î?
î@‘îBÔîF4îJÁîJÁï¯î‘ïåî
î‘îî#,î)Çî*4î/8î1s
î9
î>Á
î@VîD îH‡îJÁîJÁïåî‘ïî¦î îQî 1î$Eî(.
î/é
î1tî4¢î83î:±î>çî@lïî‘ï7xî	ï7rï7î‰î
îùîùï7tï7î~ï7rï7îV
îþî"î$ëî'Cî,î.eî2Ùî6î9Üî?îAmîE¨îJÂîKîKï7î‘ïdî¨îhîhïdtïdîIïdrïdî´
î î"‰î%î)¥î,¢î0î2«
î3æî6W
î8-î;M
î<âî?&îCNîEpîF€îJÁîJÁïdî‘ï
‘î*
îø
î¨î$ï
‘
â
êq?€`½2Ifadeviceneverwantstobeinvokedbyname,andhasnointerestingEVENTFNorHOSTNAMEPmethods,thenthereisnoneedtoeverregisteritwith\DEFINEDEVICE.(\REMOVEDEVICEDEV)[Function]RemovesdeviceDEVfromthelistofknowndevices,aswellasanynamethatmapstothatdevice.(\GETDEVICEFROMNAMENAMENOERRORDONTCREATE)[Function]ReturnsthedeviceassociatedwithNAME.NAMEcanbealitatomorstring;itiscoercedtouppercase,andifitbeginswithanopenbrace,isassumedtobeafilename,fromwhichthehostnameisextracted.Ifnosuchdeviceisknown,attemptstofindonebypollingtheHOSTNAMEPmethodsofallknowndevices(seebelow);ifadeviceisstillnotfound,causesaFILENOTFOUNDerrorunlessNOERRORistrue.IfDONTCREATEistrue,itneverattemptstocreateadevice,justreturnsanexistingdeviceifthereisone,NILotherwise.ThefieldsofanFDEVaredividedupintoinformationalfieldsand``methods''.DEVICENAMEApointerfield,thenameofthedevice,standardlyalitatom.Useofthisfieldislargelyuptothedevice,butitisusuallyselectedtobethenamethatappearsinsidebracesinfilenamesopenedonthisdevice.Fordevicesthatdonotsupportthenotionofnamedfiles,DEVICENAMEcanbeanythingthattheimplementorcarestousefordebuggingassistance.RESETABLEAflag,trueif(SETFILEPTRstream0)canbeperformed.Currentlyunused.RANDOMACCESSPTrueifthestreamisrandomlyaccessable,i.e.,ifSETFILEPTRworksonthiskindofstream.NODIRECTORIESTrueiffilesopenedonthisdevicedonot(usually)haveadirectoryaspartoftheirname.TheprincipaluseforthisisbytheCONNcommand,whichwillnottrytoconnecttotheuser'shomedirectoryifgivenahostonly,e.g.,CONN{DSK}.BUFFEREDTrueifstreamsofthissortarebufferedinamannercompatiblewiththemicrocodedversionsofBINandBOUT.Morespecifically,BUFFEREDimpliesthatthedeviceimplementstheGETNEXTBUFFERmethod.Seedescriptionofbufferedstreams.PAGEMAPPEDTrueifthisstreamisimplementedbythepagemappedfunctions.Allpagemappedstreamsarealsobuffered,soifthisflagistrue,soshouldbeBUFFERED.Seedescriptionofpagemappedstreams.FDBINABLETrueifstreamsonthisdeviceobeytherulesformicrocodedBINwheneversuchstreamisopenforinputaccess.FDBOUTABLETrueifstreamsonthisdeviceobeytherulesformicrocodedBOUTwheneversuchstreamisopenforoutputaccess.Currentlyunused,asthespecneedsrevision.FDEXTENDABLESpecialkindofFDBOUTABLE.Currentlyunused,asthespecneedsrevision.DEVICEINFOApointertoarbitrarydevice-specificinformation.Thestandarduseforthisistoholdlocalstatespecifictooneofseveralsimilardevicesthatsharemethods.Forexample,î$ï
‘î
êïførî	ôïhspî
 ïhsî‘ïb
r
îÿîîBî÷îÂ
î [
î"7î'_
î)Fî-Hî/êî2J
î4;
î:Úî:Úïb
tïb
î@»ïb
rïb
îA,
îBÛîBÛïb
tïb
îJjïb
rïb
îJÂîJÂïb
î‘ï`.îGî>î˜
îÖ
î®î"Ü
î$\î'2î+à
î-î/óî/óï`.tï`.î:Þï`.rï`.î;;ï`.î	ôï\´t
î<16>î<16>ï\´xï\´îõï\´tï\´îÌï\´rï\´îDL	îObï\´î‘ïYÇîRîfîfïYÇxïYÇîÎïYÇrïYÇî&î ^î"<22>î$<24>
î&(î*}î/m
î0îî3¬
î5-î7 î;1î=ÐîA@
îBÀîE_îIxïYÇî	ôïVVtîÀîÀïVVxïVVî8ïVVtïVVîîïVVxïVVî$ÃïVVtïVVî%šî%šïVVxïVV	î-€ïVVtïVVî.WïVVrïVVîDL	îObïVVî‘ïSiîîîuîß	î#nî&¯î&¯ïSixïSiî*'ïSirïSiî+,î+Úî+ÚïSixïSiî/RïSirïSiî0î2³
î4Ìî6î:õ
î<áîAV
îBÔ
îDhîIB
îJÂîJÂïSiî‘ïQŸ	î;îÜ
î&
îeî œî#ž
î%xî(Óî,È
î.î3”
î5+
î7î8î:kî>kîA»îE¯îG÷îJÁîJÁïQŸî‘ïOÕîE
î¦	îØîS
îË
îÇî"ìî'#
î(…î-Uî2×
î4{î7]î9ý
î;ïî@†îBÚîBÚïOÕtïOÕîJiïOÕrïOÕîJÁîJÁïOÕî‘ïNî5
îî
î¨î#‡î&lî+€
î,ùî.<î2–
î4î6Ñî9]î=ØîB(îCkîCkïNtïNîGäîK@îK@ïNî‘ïL/îÄïL/rïL/î+î}î€î€ïL/xïL/î"4ïL/rïL/î"›
î#èî'î'k
î(Ïî(ÏïL/xïL/	î0µïL/rïL/î1
î2jî5†
î6¾î:iî?×
îAgîEIîFUîJÁîJÁïL/î‘ïJ\îî†
îIî"î"6
î#iî&Ã
î(
î*Öî*ÖïJ\tïJ\î-[ïJ\rïJ\î-³	î3¯ïJ\î	ôïFâî<0C>î!
î¬
îoîoïFâtïFâîËïFârïFâî#îIî
îðî"˜î*ôî.xî1
î7ÄïFâî	ôïCht	îZïChrïChî/î–î5î –î"Ïî&i
î'üî*5î.ª	î5.î64î;î;sî>
î?®îB)îE1
îFwîJÁîJÁïChî/ïA•
î,
îÄî
î!‘î#ü
î%<
î&’î++î0?
î1×
î3²î5ûî9¥î<\îAOîE8îIB
îJÂîJÂïA•î/ï?Ëî6î!õ
î#Þî&aî*Üî+Eî-Òî2zî5*
î7î9jî>Tî@–îDÏ
îFjîJÁîJÁï?Ëî/ï>
îkîkï>
tï>
	î"Ñï>
rï>
î#Nî%Ð
î'¸î-]î0!î2w
î:Œî=ö
î?›îBîD;îJÂîJÂï>
î/ï<.
î‰î<1D>ï<.î	ôï8½tîƒï8½rï8½î/îŽînî#
îVîVï8½tï8½
î(“ï8½rï8½î(ëî-,î-,ï8½tï8½
î.Úï8½rï8½î/2î1<C3AE>
î3R	î:;î:“î@¡îE?ï8½î	ôï5Ctîßï5Crï5Cî/î€
îØî.î"“
î#öî*
î0éî3s
î4Ëî4Ëï5Ctï5C	î=1ï5Crï5Cî=­îA£
îC îF6îI6
îJÁîJÁï5Cî/ï3pîuï3pî	ôï/ÿtîßï/ÿrï/ÿî/î‘
îùîìî#Î
î%Ûî(‚î,Ë
î.×î1Rî6úî:Gî;xîAL
îCîEì
îG«îJÂîJÂï/ÿî/ï.,îhîîî$ïî'‡î)çî,ª
î.9
î0Xî2Úî2Úï.,tï.,î66ï.,rï.,î6ßî=·îAåîD±îGHîIB
îJÂîJÂï.,î/ï,Yî
î”îÅî#lî'î,±
î-äî1iî2fî50î8rî;%î;%ï,Ytï,Yî?XîC‹ï,Yrï,YîCèï,Yî	ôï(ßtî¬ï(ßrï(ßî/î|
îÐî µ
î"aî$óî'œî)ãî/m
î1î2+î7'	î>$îA0îC<C3AE>	îJÁîJÁï(ßî/ï'î<1C>
î{î{ï'tï'î!ï'rï'î!«î$†î$†ï'tï'î'âï'rï'î(äî)<29>î-rî4íî4íï'tï'î;¥ï'rï'î<PîA9îD+îF®îJÂîJÂï'î/ï%9	îeî –î –ï%9tï%9î+<2B>ï%9rï%9î+Ùî1
î1bî3Ê
î:§
î<2îAœîFfï%9î	ôï!¿t	îZï!¿rï!¿î/î˜
îî´î#1
î$«
î-
î/î1{	î9”	î?òî@†îBä	îJÁîJÁï!¿î/ïìîbîöî"
î(1
î*4
î+Õî.µî1«
î3Wî6Ò
î8Öî=Ž
î?¿î?¿ïìtïìîFwïìrïìîG”îHYîJÁîJÁïìî/ï
î
î—	î'tî,>ïî	ôï¨tîƒï¨rï¨î/î]
î‘î W
î"1î$¤î(¹î+èî.î1Hî3X	î:šî:šï¨tï¨î=ï¨rï¨î=xîC}îF€îJÁîJÁï¨î/ïÕ
îmî°î¿î!9î%ïÕî	ôïdt	îZïdrïdî/î 
îî!"
î#>î%õî*Mî-¿î05î3¦î5ú	î=~î=~ïdtïdî@ÚïdrïdîAwîG¿îJÁîJÁïdî/ï‘îp
î®îñî"î&@î*uî*Íî0Ûî5Ì
î7Mî9~î<_î@îEï‘î	ôï tîï rï î/î»î»
î Fî Fï tï 	î(¬ï rï î)[î)³î/Áî4²
î63î8dî;Eî>÷îCõï î	ôï¦t	îZï¦rï¦î/î£îN
îãî$kî-mî5-î5šî8Wî=Öî@1îBUîDÛ
îF.
îGÂîJÂîJÂï¦î/ï
Óîcî„î"\
î#ûî&—
î(Bî,Âî15î5íî8«î<:îBîB†îE!îJÁîJÁï
Óÿ	
êq?€`½3theDolphindiskprovidesaseparateFDEVforeachpartitionofthemachine;theDEVICEINFOfieldofeachhaspointerstothepartition'sdirectoryandotherinformationspecifictofilesonthatpartitiononly.Thefollowingfieldsareallpointerfields,andcontainfunctionsforimplementingvariousdeviceoperations.Notalldevicesneedhaveallfieldsfilledin;therequiredonesarelistedfirstandsoindicated.Some``required''fieldshavedefaultsspecifiedintheFDEV(orSTREAM)recorddeclaration,sotheimplementorneednotexplicitlyfillthosefieldsifthedefaultisreasonable.Eachfieldispresentedwithitsarguments,inthestyleofafunctiondefinition;ofcourse,itisthecontentsofthefield,notthefieldname,thatisthefunction.Usingobject-orientedterminology,theoccupantsofthesefieldsarereferredtoas``methods''.Forexample,``theBINmethod''means``thefunctionthatoccupiestheBINfield''.Oneoftheargumentstoeachmethodisusuallyeitherthedeviceitself,orastreamopenonthedevice,sothatthedevice(andhenceitsDEVICEINFO)isusuallyaccessibletoallthesefunctions.Argumentsthatarefilenamesorpatternsorpiecesoffilenamescanbeeitherlitatomsorstrings,andalreadyhavetheirhostand/ordirectorypartsappropriatelyfilledinfromtheconnecteddirectorydefaults.Thedevicemayassumethatthehostfieldofthefilenameisindeedanamethatthedevicehassaiditimplements(seeHOSTNAMEP).``Full''filenamesreturnedbythesefunctions(orstoredintheFULLFILENAMEfieldofastream)shouldbelitatoms,andatleastinthecurrentimplementationshouldbealluppercase.Fieldsrequiredofeverydevice:(HOSTNAMEPHOSTNAMEDEVICE)Calledbythegenericfilesystemcodewhenpresentedwithahostnameforwhichthereisasyetnodevicedefined.Thefunctionshouldreturnnon-NILifit``recognizes''HOSTNAME.Therearetwowaysinwhichthismethodisinvoked:(1)ToobtainadeviceforHOSTNAME,forexample,sothatafilecanbeopenedonit.Inthiscase,DEVICEisanalreadydefineddevice(theonewhoseHOSTNAMEPmethodisbeingcalled),andthefunctionshouldreturneitheranewdevice,orT,meaningitiswillingtotakeresponsibilityforthishostnameaswellasanypreviousnameunderwhichthedevicewasregistered.Ineithercase,thecallerwillinstallthereturneddevice,orDEVICEifvaluewasT,asthedevicetowhichHOSTNAMEmaps.(2)Asapurepredicate.Inthiscase,DEVICEisNIL,andthefunctionneedonlyreturnTorNIL,indicatingwhetheritbelievesthatHOSTNAMEisthenameofahost.Inpractice,theHOSTNAMEPmethodneedonlytakecareofthefirstcase,sincethatalsotakescareofthesecondcase.Thesecondcaseisprovidedsothatthedeviceneednotbecreateduntilthereisanactualuseforit,shouldthedevicewishtoavoidunnecessarywork.Inpracticeitisrarethatanyonetestsahostnamewithoutsubsequentlyneedingtohavethedevicecreatedinfull.TherearebasicallythreekindsofdevicesinthesystemasdistinguishedbytheirHOSTNAMEPmethods.(1)Predefineddeviceswithexactlyonename,orstrictlyinternaldeviceswithnonotionofname.Forexample,theCOREdevicealwaysexists,andhasexactlyonename;theSPPdevice(anetworkbytestream)hasnoname(itsupportsnofilesdirectly).SuchdeviceshaveaHOSTNAMEPmethodofNILLtheonlynametheyevergobyistheonetheygaveto\DEFINEDEVICE,ifany.Thisisthedefault.îJÁï
Óî
êïførîI¾ïhspîJjïhsî/ïb
rî®îBî"Nî'ùî)Dî.ºî.ºïb
tïb
î2ïb
rïb
î2¼î5î8iî>
î?÷îBvîH<C3AE>îJÁîJÁïb
î/ï`.t	î•ï`.rï`.î €î$
î&3î)Éî,¤î2S
î4gî7,
î>îD6îGRîJÁîJÁï`.î/ï^[
î„î#<
î$¼î'z
î)Rî+ñî1Xî4Gï^[î	ôïZêîµî«îGî†î_îî#î%£î*iî0Lî2sî;î?ÄîCð
îJÁîKîKïZêî	ôïY îåîõîÜîZîÁîÑî ¤î$Uî&žî)î.Ëî2î4<C3AE>î8Yî;Qî>)
î@	îFtîGîJÁîJÁïY î	ôïWVîáî”îÛîî"¾
î$mî&Îî&ÎïWVtïWVî**ïWVrïWVî*±î,ïî,ïïWVtïWVî1ùïWVrïWVî2ùî7Hî>¬
î@qîBÑ
îJÁîJÁïWVî	ôïUƒî
=î<0F>	îkî|îî¤
îòî"=î&Ï
î('
î/5î/§î3î6
î7xî=¡î@§îBm	îIB
îJÂîJÂïUƒî	ôïS¹îaî<0F>
îdî<12>î
îê
î ±î%d
î&Ç
î(Aî*®î0&
î1íî4Zî7íî:oî<Üî@îD<îG
îH<C3AE>îJÁîJÁïS¹î	ôïQïî£îîîîCî%!î'cî-¢
î/>î2©î6=î8tî=–
î?'
î@¸îGÞîHFîJÂîJÂïQïî	ôïP%î”îuîuïP%tïP%îúïP%rïP%îRîÜîñî!Òî'î)¸î/î1Fî1FïP%tïP%î3ËïP%rïP%î4#î7ØïP%î	ôïL«îÍ
î]î’î
î˜îŸî }
î!Àî&Eî*î,;î0Tî3Ü
î5wî6xî:¾î>
î?âîBîFˆ
îH"îJÁîJÁïL«î	ôïJáîDîxîšî‚îNîNïJátïJá	î!´ïJárïJáî"¥
î$î(£	î.Ð
î0pî2Qî5Ê	î<î<„îCƒîFBîH‡îJÁîJÁïJáî	ôïIî
î¾îß
î„î|
îî`î"„î$ð
î&Ãî*Žî/¢
î1Gî5Øî8qî=#î@KîCqîFJîJÁîJÁïIî	ôïGDî¡îèî2î¢
î /î#uî%³î,î1¾î7î7ƒî:9î>[îA>îEåîH‘îJÂîJÂïGDî	ôïEzîÏîà
î|î½îîª
îùî`î nî$î&Àî)î-'î/î29
î3r	î:¹î=iî=iïEztïEzîDøïEzrïEz
îF1îF™îJÁîJÁïEzî	ôïC§î3îMî¼
î<17>îïî ¿î"Óî&Ë
î(Pî*†î*†ïC§tïC§î4šïC§rïC§î4øî7ý
î9<C3AE>î:<3A>î?NîC<C3AE>
îEeîJÁîJÁïC§î	ôïAÔî}
î
èîÞ
î^î<14>î(
î"Ïî'
î(Üî*<2A>	î0ÝïAÔî	ôï>cî
åîC
îÎîTî<1C>ï>cî	ôï;&t	î1î1ï;&xï;&îÛï;&tï;&î²î²ï;&xï;&î!ï;&tï;&îøï;&yï;&îþï;&î‘ï89rîº
îˆî¹îQîŒî#Øî&ïî*uî0…î3pî4mî77î:Èî<Øî@µîD
îEM
îFÎîHé
îJÁîJÁï89î‘ï6oî­îÛî;îìî";î&<26>î*”î-Sï6otï6oî/Øï6orï6oî09
î1t
î2¤
î:{î:{ï6oxï6oîA%ï6orï6oîAÜîB<îFîHDîJÁîJÁï6oî‘ï4œî¿
î?îîŽî h
î!¦î&Üï4œîàï1¸îã
îäîîî!$î#<î#<ï1¸xï1¸î)æï1¸rï1¸î*Ÿî,·î2`
î3ÿî6§î7­î9ñî<W
î>#îBÚ
îD»îFCîF¤
îHOîJÁîJÁï1¸îàï/îîAîAï/îxï/îî°ï/îrï/îîR
îÚ
îæî$Óî)ëî.Iî1=î4î8Kî8Kï/îtï/îî?Úï/îrï/îî@{îEŸ
îG&îJÁîJÁï/îîàï.îîîKî"šî&íî*õî.¹î/¿î2‡î6ü
î8›î8›ï.tï.î9rï.rï.î:*î?œ
î@Í
îBîFo
îG÷îJÁîJÁï.îàï,H
îAîuî!
î#ýî'´
î)Zî,>
î-åî0~î6
î9·î=°îA³îD
îHCîJÁîJÁï,Hîàï*~
îWî·
îaî %î#Dî%}î)	î+‹î/nî1§î7î;Œ
î=*î=*ï*~xï*~îA™ï*~rï*~îAø
îC3îFµîI:îI:ï*~tï*~îJï*~rï*~îJÁîJÁï*~îàï(«
îaî’î¦
î&î!î!ï(«xï(«î'­ï(«rï(«î(î+zï(«îàï%Çîì
îáîðî	î":î"¤
î$Xî&Üî*î*ï%Çxï%Çî.vï%Çrï%Çî.à
î00î00ï%Çtï%Çî2µï%Çrï%Çî3wî6î8Vî=¯î@ïîCëîGüîGüï%Çtï%ÇîHÓï%Çrï%ÇîI+
îJÁîJÁï%Çîàï#ôtîeï#ôrï#ôî	îBî"_
î#‡î(Œî++î++ï#ôxï#ôî1Õï#ôrï#ôî2-
î3kî5œî9-
î:¸î;µî>„ï#ôî‘ï!
î<îŽîÉîÉï!tï!î!Xï!rï!î!ºî&žî)Öî,Êî/žî2h
î3ýî68î8ëî<
î?ZîBîDªîH
îJÁîJÁï!î‘ï4
îîMî®îÆîîÇî#)î%é
î''î,Ç
î.]î0üî3.î7Bî:pî<·
î>zîCîF)îIƒ
îJÁîJÁï4î‘ïj
îuîiîÑî
î£î!î#aî'–î*¸
î,Zî0

î7›î;`î;Ù
î=<3D>îB®
îCø
îEWîH"îJÁîJÁïjî‘ï î)î
îîÑîbî$;î,Cî1I
î2Éî5áî8î<&î@¿
îB?îDŸï î‘ï¼î¢îî¡î 9î#ü
î%Åî*œ
î,Zî.Êî3T
î5î=y
î?†îBÛîBÛï¼tï¼îJjï¼rï¼îJÂîJÂï¼î‘ïéîôïéîàïî	îðî!¯î$Áî)Sî+÷î0
î1Äî64î;?î?þîC
îEîI6
îJÁîJÁïîàï;îî<18>îWî!6î#¥î#¥ï;tï;î'
ï;rï;î'˜î+êî0^î4yî7Aî9Æî>qîA,îEuîGäîGäï;tï;îJiï;rï;îJÁîJÁï;îàïhîü
îyî¦î!Žî&Oî(ž
î*}î.î/½î5"
î7î9Ç	î?aî?ÀîCîGªîJÂîJÂïhîàïžîîïžtïžî©ïžrïžî?î"V
î$î$ïžtïžî'{ïžrïžî+Iî.qî2?î5^î8q
î:q
î<|
î=øî@fîC!îF?îIA
îJÁîJÁïžîàïËtîËïËrïËî{
î ®î#xî#Ðî&º
î'øî*)î.¥ïËÿs
êq?€`½4(2)Devicesthatdon'tknowaheadoftimewhattheirnamewillbe,butforwhichtheremightbemanyincarnations.Thisisthemodelforremotefileservers.ThestandardwayofhandlingthiscaseistodefineadummydevicethathasonlyaHOSTNAMEPmethod,andnoname.WhentheHOSTNAMEPmethodgetscalledwithanamethatthedeviceknowsitcanservice,itcreatesadevicebythatname.Ifgivenanamethatisasynonymofanothername,itmightjustreturntheexistingdeviceofthecanonicalname(using\GETDEVICEFROMNAMEtofindtherightdevice).Ineithercase,theHOSTNAMEPmethodofthenewdeviceisusuallyNILLtheoriginaldeviceistheonlyonethatworriesaboutcreatingnewinstancesofthisclassofdevice.(3)Like(2),butallthedifferentnamesarehandledbyasingledevice,whichtakescareinternallyofthemultiplexingamong,say,differentremotehosts.HOSTNAMEPreturnsTinthiscase.Thisisusuallyclumsierthan(3),sodiscouraged.(EVENTFNDEVICEEVENT)CalledaroundLispexits,toallowthedevicetodoanynecessarycleaningup,clearingofcaches,disconnectswithremotehosts,etc.EVENTisoneofthefollowinglitatoms:BEFORELOGOUT,BEFORESYSOUT,BEFOREMAKESYS,BEFORESAVEVM,AFTERLOGOUT,AFTERSYSOUT,AFTERMAKESYS,AFTERSAVEVM,AFTERDOSYSOUT,AFTERDOMAKESYS,AFTERDOSAVEVM.TheAFTERxxxeventsareallrunwhenLispisbootedfromamemoryimagethatresultedfromaLOGOUT,SYSOUT,etc.TheAFTERDOxxxeventsrunwhencontinuingLispinthesameincarnationfollowingtheSYSOUT,etc.(thereisnosucheventforLOGOUT,ofcourse).The``after''eventsarecalledinthesameorderinwhichthedevicesweredefined;the``before''eventsinthereverseorder.Forexample,theBEFORELOGOUTeventfortheLeafremotefileserverdevicesperformsaFORCEOUTPUTonallitsopenfilesandthenbreakstheconnectionwiththefileserver.TheAFTERxxxeventsfortheLeafdevicescalls\REMOVEDEVICEonitselftoflushanyconnectionbetweenthenameandtheserver(sincenamesandaddressescanchangeoverexit).TheAFTERxxxeventsfortheDoradodiskdevicerebuildsitscacheofthedisk'sdirectory.ThereareafewdevicesinthesystemthatexistonlyfortheirEVENTFN.Inmostcases,asimplerwaytotellthesystemyouwantsomethingperformedaroundexitistoaddyoureventfunctiontothelistAROUNDEXITFNSinsteadofgoingtotheexpenseofdefiningadeviceforit.Thereisyetanotherlist,\SYSTEMCACHEVARS,forhandlingamorespecialized``aroundexit''operation:everytimeLispisbooted,eachofthevariablesinthelist\SYSTEMCACHEVARSissettoNIL.Thefollowingarerequiredofallnameddevices,thatis,devicesthatmapfromsomehostnametothedevice,uponwhichfilesmightbeopenedorotherwisemanipulated:(DIRECTORYNAMEPHOST/DIRDEVICE)TrueifHOST/DIRisavaliddirectorynameonDEVICE.Functionshouldideallyperformrecognitionaswell,andreturnthe``true''name.Forexample,given``{PHYLEX:}<LISP>''asargument,itmightreturn{Phylex:PARC:Xerox}<Lisp>.HOST/DIRmightincludeasubdirectoryname.Thedeviceshouldattempttotellthetruthaboutwhetherthesubdirectoryexistsornot,thoughthismaynotbepossiblefordeviceswithfakesubdirectories.DefaultstoNILL,i.e.,devicesupportsnodirectories.UsedbythecommandCONNandthefunctionDIRECTORYNAMEP.(OPENFILENAMEACCESSRECOGPARAMETERSDEVICE)î.¥ïËî
êïførî	ôïhspî
 ïhsîàïb
rîÞîÒîuî Ýî$qî(H
î)×î,Ñî0î3î6´î93î;Rî=¨î?»îCœîFúîJÁîJÁïb
îàï`7
îõîäî"î"ºî%÷
î'ˆî*î.fî0Èî5‘î8î=*î=Ôî@ÐîFŒîI6
îJÁîJÁï`7îàï^mî|î
îÕ
î &
î!¹î%Öî&æî+ßî0î2¹î5î8î9!î9!ï^mtï^mî@°ï^mrï^mîAîF`îHé
îJÁîJÁï^mîàï\šîßîNîNî–î–ï\štï\šî&%ï\šrï\šî&”î+„î.:î2î5î6-î9Ôî<Šî>ÒîBýîG'
îHeîJÂîJÂï\šîàïZÇî˜
îÊî*î1î#O
î%'î'Ðî+Âî,$
î-ƒî1î2î5³î8\
î9¤î:«î@`
îAõîFØîJÁîJÁïZÇîàïXý
îkî•îjî$Íî(aî.<2E>î4
î7î:—îAÚîFÎîJÁîJÁïXýîàïW3tî"þïW3rïW3î#p
î%	î'âî*-î-iî2gî2Ø
î4”î8jî;œî=çî=çïW3tïW3îEvïW3rïW3îEçîJÁîJÁïW3îàïU`
î<15>îîóî9
î ©î%]î%]ïU`tïU`î(¹ïU`rïU`î,|î1…î5Ì
î7<î9Ÿî<¼î?kîB<îGîJÁîJÁïU`îàïS<C3AF>îæî¦î!F
î"Ñî%Cî(D
î)Ïî-èïS<C3AF>îàïP©îîOîÜîhî dî"Ðî(~î,Îî//î4…
î6Žî7Æî;»î@bîDzîHîJÂîJÂïP©îàïNß	îï
î’îÜî%Ãî*Šî-,î2¸î7Hî;î;wî;wïNßtïNßîCïNßrïNßîCwîHîHïNßtïNßîHéïNßrïNßîIA
îJÁîJÁïNßîàïMîRîiîÁî«
îéî"jî'¼î*³î-
î.›î6ïMî	ôïIÏtîƒîƒïIÏxïIÏîòïIÏtïIÏîÉîÉïIÏxïIÏî«ïIÏtïIÏîˆïIÏî‘ïFârîØî‚îŠî 
î!žî%3î'‚î+³
î-Q
î/Fî1×î7×î=1î?ŠîD¢
îFJîJÂîJÂïFâî‘ïE
îìîîÚî#Æî&hî'î'ïExïEî*éïErïEî+‡
î-î/Î
î1Ÿî4î::î?ýî?ýïEtïEîJïErïEîJÁîJÁïEî‘ïCEtî¥ïCErïCEî¢î¢ïCEtïCEî'<27>ïCErïCEî)Šî)ŠïCEtïCEî3žïCErïCEî5›î5›ïCEtïCE
î>ØïCErïCEî@Õî@ÕïCEtïCE
îJïCErïCEîJÂîJÂïCEî‘ïArtî¥ïArrïArîÌîÌïArtïAr
î%	ïArrïArî&/î&/ïArtïArî1ïArrïArî2@î2@ïArtïAr
î>ïArrïArî?(î?(ïArtïArîJïArrïArîJÂîKîKïArî‘ï?ŸîPîPï?Ÿtï?Ÿîƒï?Ÿrï?Ÿîîî Zî"0î$­î(Hî+G
î,›î1î4hî5zî:Ìî>¾îArîF<C3AE>îIÅîJÂîJÂï?Ÿî‘ï=Ìtî›ï=Ìrï=ÌîÌîÌï=Ìtï=ÌîÖï=Ìrï=Ìîîäî ½î#çî#çï=Ìtï=Ìî)Èï=Ìrï=Ìî,²î1=î4&î8-	î?TîB¿
îDÀîGrîJÁîJÁï=Ìî‘ï;ù
îÙî
î |î |ï;ùtï;ùî%†ï;ùrï;ùî&€î)'î-D
î.Ì
î0îî4:î8î:dî:dï;ùtï;ùî?nï;ùrï;ùî@h
îB=îGvîHîJÁîJÁï;ùî‘ï:&îî(î^î4
î Äî#î&dî)ø
î+ˆî/uî1¶î6^î9‘î>éîA*	îF¸îJÂîJÂï:&î‘ï8\
îîBîÅîOï8\î‘ï5xîuî}îîï5xtï5xî&*ï5xrï5xî&êî*Øî-Pî/éî3Rî81î:Óî?îDîIÄîJÁîJÁï5xî‘ï3¥t
îÎï3¥rï3¥îi
îƒî‡î uî#ûî&ûî)Çî-î1mî3à	î:êî>î@‹îCîGîHîJÂîJÂï3¥î‘ï1ÒtîÄï1Òrï1Òî^î›îÜî @î#sî(=î+Oî+Oï1Òtï1Òî6:ï1Òrï1Òî6Ä
î8Ïî<-
î=àîAUîCú	îJÁîJÁï1Òî‘ï/ÿî:î×îÓîÈî"eî&®î*Öî/Vî2Kî8šî;bî@FîCœîGUîHîJÁîJÁï/ÿî‘ï.5tîÄï.5rï.5î,î6îEîvî$Oî'
î+!î0<î1èî5„
î7î9@î<Ú	îB~ï.5î‘ï+Hîwî±îÂîIîõ
î ‰î"Îî'.î)áî,öî/ôî2î5Bî5Bï+Htï+Hî;#ï+Hrï+Hî;æî<R
î>îAIîDùîF
îJÂîJÂï+Hî‘ï)uîK
îÛîîZîµî Mî#Šî*
î0¬î5Hî7Õ
î9"
î:²î=Jî@fîCûîIB
îJÂîJÂï)uî‘ï'«îÖî÷î÷ï'«tï'«îâï'«rï'«î Nî$ä
î&ƒî*1
î+Åî.
î3%
î4Äî:î;%î?MîApîCîCoîGU
îH¦îJÁîJÁï'«î‘ï%Øî¿îzîzï%Øtï%Øî%êï%Ørï%Øî&ïî)Rî/0î0‚î4:
î;?î@ÑîDR	îJÁîJÁï%Øî‘ï$îî
î÷
î5îøî"ú
î$…î&¶î,?
î-¿î/ðî1þî1þï$tï$î?nï$rï$î?Æ
îAîBó
îDsîDsï$tï$îFøï$rï$îGUï$î	ôï ‹î­îšîÐî>
îÙî©î"î'î)¿î+dî0î2»î5·î8þî<rîB…
îDîFUîJÁîJÁï ‹î	ôïÁî
Xî5îóîº
î}î+
îÁî%¸î-™ïÁî	ôï„tîdîdï„xï„îDï„tï„îîï„xï„î"Šï„tï„î#gï„î‘ï—rî1
îÖîÖï—xï—î¶ï—rï—î<1C>
î2î¡î#Kî)]î-`
î/«î/«ï—xï—î4ï—rï—î5<î6î<-î@êîEšîJÁîJÁï—î‘ïÍ
î»
îiî¬îbî#Žî%ìî*.î.Cî.Èî1qî7>î:ð
î; ïÍtïÍîH9ïÍrïÍ
îIA
îJÂîJÂïÍî‘ïúî‹
î[îËî"rî"rïútïúî7qïúrïúî8Èî9Éî9Éïúxïúî?©ïúrïúî@©îEîIÅîJÂîJÂïúî‘ï'îoî…îîäî$&î(Ÿî-©
î/Wî1µî4î7‡î;gî@³îCîJÁîJÁï'î‘ï]îK
îîêî¢î Iî#Uî%Ð
î'Éî-
î/Rî4î7@î:JîCaîCîîIA
îJÁîJÁï]î‘ï“tîíï“rï“îîÞî`î",
î$rî+±î,wî0J
î2†î5%î;Âî;Âï“tï“î?ï“rï“î?äîBÛîEzîJÁîJÁï“î‘ï
Àt
îSï
Àrï
Àî°ï
Àî	ôï
ztîZîZï
zxï
zîÒï
ztï
zî©î©ï
zxï
zî)ï
ztï
zîîï
zxï
zîüï
ztï
zî Óî Óï
zxï
z	î(¯ï
ztï
zî)†î)†ï
zxï
zî-õï
ztï
zî.Òï
zÿA
êq?€`½y5UsedtoimplementtheOPENFILEandOPENSTREAMfunctions.OpensthefilenamedNAMEonthisdeviceforaccessACCESS,returningaSTREAM.ThestreamisusuallyonDEVICE(itsDEVICEfieldisDEVICE),butisnotrequiredtobe.TheargumentsACCESS,RECOG,PARAMETERSareaswiththeOPENFILEfunctioninthemanual.Thus,ifNAMEdoesnotincludeaversionnumber,recognitionisaccordingtoRECOG,whichshouldbeappropriatelydefaultedperACCESS(INPUTimpliesOLD,OUTPUTimpliesNEW,BOTHimpliesOLD/NEW).TheargumentNAMEcanalsobeaSTREAM,whichmustbeaclosedstream.OPENFILEshould``reopen''thestream.Thevaluereturnedinthiscasemaybeanewstream(withthesamenameastheold),ortheoldstream(NAME)itself.Itislikelythatthespecificationwillbechangedatsomepointtorequirethattheoldstreamitselfbereturned,suitablyreopened.TheargumentPARAMETERSisalistofpairs(OPTIONVALUE).ThemostinterestingOPTIONsareasfollows:TYPEFornewfiles,thetypeofthefile(TEXTorBINARY).Ifthisparameterisnotspecified,thevalueoftheglobalvariableDEFAULTFILETYPE(initiallyTEXT)shouldbeused.CREATIONDATEFornewfiles,thedateofitscreation.Thedeviceshouldusethisifatallpossibleinsteadoflettingthecreationdatedefaulttothecurrentdateandtime.LENGTHTheintendedlengthofthefile,inbytes.Thisneednotbeaccurateitisonlyahintthatmayallowsmarterallocation.Forexample,ifthedeviceknowsthatitdoesnothaveroomforafileofthespecifiedlength,itshouldimmediatelycauseaFILESYSTEMRESOURCESEXCEEDEDerrorfortheintendedfile.DON'T.CHANGE.DATEForoldfilesbeingopenedforaccessBOTH,don'tchangethecreationdateofthefile.ACCESS=BOTHwouldnormallyimplythatthecontentofthefileistochange,andthusitscreationdateshouldbeupdated.Useofthisparameterisaformof``cheating''tomakeitlookasthoughthefilehadnotchanged.Forexample,thecodethatrewritesfilemapsusesthisparameter,sincerewritingthefilemapdoesnotlogicallychangethefile'scontent.SEQUENTIALIfT,isahintthatthefilewill,orneed,onlybeaccessedsequentially,whichmayallowthedevicetoopenthefileinamoreefficientmode.Anyparametersthatthedevicedoesnotunderstandshouldbeignored,ratherthanbecauseforanerror.AlldevicesareencouragedtosupportatleastTYPEandCREATIONDATE.TheadditionaloptionsENDOSTREAMOPandBUFFERSarehandledbythegenericfilesystemcode;specifyingthemisequivalenttocallingSETFILEINFO(q.v.)immediatelyaftertheopen.FinepointaboutACCESS=OUTPUT:thisoperationalwaysproducesanew,emptyfile,independentofwhetheritsnameisexactlythenameofanexistingfile.Thatis,itreplacesanyoldfilebythesamename.Onopening,suchafilehasanendoffileofzero.Ofcourse,sinceRECOGdefaultstoNEWinthiscase,thenamecanonlyclashwithanoldfilenameifaversionwasexplicitlyspecified,orRECOGisOLDorOLD/NEW.Toopenanoldfileforoutputbutpreserveitscontents,i.e.,onlywriteoverpartofthefile,oneshouldopenforACCESS=BOTH(sincetopreservetheoldcontentsoneimplicitlyreadsthem).î.Òï
zî
êïg,tîI¾ïhspîJjïhsî‘ïb
rî

îŸîfî¬î¬ïb
tïb
î%dïb
rïb
î%Ñî(oî(oïb
tïb
	î0Õïb
rïb
î1A	î7xî7åî<î>_î@®îEîEïb
xïb
îH‘ïb
rïb
îHé
îJÁîJÁïb
î‘ï`.îî3îOî;î;ï`.xï`.î!»ï`.rï`.î"yî(]î)hî)hï`.tï`.î.rï`.rï`.î/.î/”î2Kî6™
î7åî<t
î>Yî>Yï`.xï`.îBÈï`.rï`.îC.îE`îE`ï`.tï`.îJjï`.rï`.îJÂîJÂï`.î‘ï^[îª
îîï^[xï^[îqï^[rï^[
î³î
îvî Öî&M
î'æî*î*‹î-Nî3äî3äï^[xï^[î8ªï^[tï^[î9›î9›ï^[xï^[î=Ýï^[tï^[î>Íî>Íï^[xï^[	îF©ï^[rï^[îGîI@
îJÁîJÁï^[î‘ï\ˆîžîñîñï\ˆtï\ˆî©ï\ˆrï\ˆî#î"Œ
î$.î&<26>î+³î,-î/õ
î1Jî1Jï\ˆxï\ˆî4Âï\ˆrï\ˆî5<î8_î:Çî?–î@µîEnîJÂîJÂï\ˆî‘ïZµ
î¯
îî=
î Þî ÞïZµxïZµî$ÚïZµrïZµî%¬î)ªî.
î/úî8Xî>\î@Äî@ÄïZµxïZµîEDïZµrïZµîE½îF6ïZµtïZµîJiïZµrïZµîJÁîJÁïZµî‘ïXâî'î'ïXâtïXâî¬ïXârïXâî\î\ïXâtïXâîfïXârïXâî¾î"Tî"TïXâtïXâî$ÙïXârïXâî%‰î%‰ïXâtïXâî(åïXârïXâî)=î-Óî-ÓïXâtïXâî3´ïXârïXâ
î4ŠïXâî‘ïUõî]îyîyïUõxïUõîñïUõrïUõîlîìî"¬
î$’î%²î%²ïUõtïUõî*¼ïUõrïUõî+Žî/Žî2ê
î4Ðî5ðî:î>Ëî?Fî?FïUõtïUõîEþïUõrïUõîFxîJÂîJÂïUõî‘ïT"	îcî›î:î˜î Hî#Éî)9
î*Àî-9î/ÿî2Ü
î4¦î5©î8pî<¸î@"îBZîE¯îI@
îJÁîJÁïT"î‘ïRXîÃîÏ
îfî˜îÓî î ŽïRXxïRXî$ïRXrïRXî$Ùî(]î(¶î(¶ïRXsïRX
î)¾
î*½î-—î/±î1sî7™î9—
î;
î?4
î@WîCîEÎ
îGîJ¯îJ¯ïRXî‘ïPŽîªîkî4îšî$
î<1D>î"'î&î*ÆïPŽrïPŽî*ÌïPŽî‘ïMªî=î:î:ïMªxïMª	î!ïMªrïMªî!r
î"´î#´î%Æ
î'Uî*…î*þïMªxïMªî/}ïMªrïMªî/Ùî/ÙïMªxïMªî3ÍïMªrïMª
î4ùî5Uî8
î;2
îA¼îA¼ïMªxïMªîF;ïMªrïMªîGîI@
îJÁîJÁïMªî‘ïKàîBïKàîàïHütî<ïHürïHüîÌî lî#Pî&Šî(ßî+ä
î-“î/èî2Fî2¿ïHütïHüî6ïHürïHüî6—
î8Qî8QïHütïHüî=[ïHürïHü
î>§î?#
î@œîC2îIƒ
îJÁîJÁïHüîÌïG)î 	î&î(8î+¹
î-Jî/‚î3zî8†î8†ïG)tïG)îEïG)rïG)îE}	îJÁîJÁïG)îÌïEVtî!(ïEVrïEVî!ùî&C
î(î+ïEVîàïBitîôïBirïBiî"Âî%Lî(î+@î-î0d
î1ýî3¸î9.î9”î<Lî@nîDÇîGîIŽ
îJÁîJÁïBiîÌï@–
îIî!î&=î*Ò
î,oî0”î2×î7ùî:âî?k
î@ýîC@îGëîJÁîJÁï@–îÌï>Ìî Uî#Pï>Ìîàï;ètîêï;èrï;èîÌî žî&Qî*ƒ
î,7î.‘î1L
î2õî6Úî7[î:nî=Åî@4
îB 
îIƒ
îJÁîJÁï;èîÌï:î äî"î$òî'Àî*Äî.jî3^
î9íî:tî=îBí
îDNîF­îJÁîJÁï:îÌï8Kî!îî$œ
î%Ôî(äî+9î.aî1éî4î5î7]
î8÷î;8î@ÐîE@
îFwîJÁîJÁï8KîÌï6<C3AF>
î%®î)rî*®î*®ï6<C3AF>tï6<C3AF>î/î5?î=ãîD›ï6<C3AF>rï6<C3AF>îE2îH³îJÂîJÂï6<C3AF>îÌï4®îýî%‡î'Æï4®îàï1Êtî"'ï1Êrï1Êî"Âî%«î(Qî+|î/ƒî4žî7î;dî;dï1Êtï1Êî>Àï1Êrï1Êî?ÜîC­îH‘îJÂîJÂï1ÊîÌï/÷î#î&

î'³î*î,Äî-Cî-Cï/÷xï/÷î1Ãï/÷rï/÷î2Cî4"î4"ï/÷tï/÷î7~ï/÷rï/÷î7þî<"îAèîEÊîH<C3AE>îJÁîJÁï/÷îÌï.$î"‰
î$î&Mî(Œ
î)Î
î+Rî0'î2´î5Žî7>î<Sî?-îC{
îEBîJÁîKîKï.$îÌï,Zî ~
î"î$ î+
î,Uî-dî0¯
î2Mî9
î:›î>2
î?mîBh
îCüîH<C3AE>îJÁîJÁï,ZîÌï*<2A>î î" î$ïî*<2A>î*îî-sî3î5Uî8uî;î@!îE|îHOîJÁîJÁï*<2A>îÌï(Æ	î$«î(%î.î0mî5rî8©î;&î@•îEDîG«îJÁîJÁï(ÆîÌï&üî"Šï&üîàï$t	îFï$rï$îÌ
î,î,ï$tï$î ï$rï$î ¾
î"î#î%Îî(xî*´î,ùî/×
î1xî5	î7þ
î9Ìî? îFäîJÁîJÁï$îÌï"Eî ¢î$î&Kî*_
î+ßî/"î1Sî3<C3AE>
î5
î6
î9nî>”îB?ï"Eî‘ïaîi	îBîåîî#1î&6î(€	î/yî3Ç
î5Žî:Ãî>¤îAŸ
îCfîFïîHþ
îJÁîJÁïaî‘ï—î+îƒî¦î>îd	î$…
î&î*ß
î,Jî/@î/@ï—tï—î2œï—rï—î2ôî5}î5}ï—tï—î?‘ï—rï—î?îï—î‘ïªî{	îþîëîëïªtïªî(ÿïªrïªî)˜î,bî,bïªtïªî2Cïªrïªî2Üî5Cî: 
î<¯î?!îCúîFuîJÁîJÁïªî‘ï×î!	îeî¿
îý	î%x
î&øî++î++ï×tï×
î4hï×rï×î4Àî8.
î?ÑîBÞîEîHWï×î‘ïêîîîCîCïêxïêî Ãïêrïêî!<21>î#Øî#Øïêtïêî(âïêrïêî*6î-*î3£î8[î>ˆî@îC£îH/îJÁîJÁïêî‘ï
îS
îåîî »î$S
î%˜î*î,Cî/Ú
î1l
î36î8î:®î;î>*î?Ç
î@öîFîH‡îJÁîJÁïî‘ïMîÙ
îµîôîQîGî­
î ìî&mî)}î*ˆî,Ðî/%
î0öî3<C3AE>
î5&î7n
î9î<@î<¦
î>—îCîFmîFmïMxïMîJiïMrïMîJÁîJÁïMî‘ïƒî×
î¡î¡ïƒtïƒî&ïƒrïƒîÉ
î”îPî"³î%/î)
î+²î.çî2tî5ª
î7¸î:<î<Áî@<40>
îBîCbîHCîJÁîJÁïƒî‘ï°	îS	îC
îèîèï°xï°î!äï°rï°î"K
î#™î#™ï°tï°î&ï°rï°î&…
î(*î(*ï°tï°î.ï°rï°î.Éî/1
î18î4Š
î6\î8¥î:ïî=
îA\îC½îIîJÁîJÁï°î‘ïÝînîîLîáî#î&
î'ãî*[î-5î/ùî4‹î8î:lî:lïÝxïÝî>ìïÝrïÝî?‹îA‹îA‹ïÝtïÝîDçïÝrïÝîE†îIB
îJÂîJÂïÝî‘ï
îÚîîEî‚î!ÿ	î'èî+Xî/0ï
ÿ
€
êq?€`½Ì6Exceptionhandling:Ifthedesiredfileisnotfound,theOPENFILEmethodshouldreturnNILratherthancauseaFILENOTFOUNDerror.Thisissothatthegenericfilesystemcodecancausetheerrorusingtheoriginalfilename,nottheonepackedwithhostanddirectorypassedintotheOPENFILEmethod.Thedeviceshouldfeelfreetosignalanyothererrorsitselfonfailingtoopenthefile,e.g.,FILEWON'TOPENforabusyfile,PROTECTIONERROR,orFILESYSTEMRESOURCESEXCEEDED.Ideally,thiserrorshouldbesignaledinawaythatisresumable,i.e.,sothatausercould,inthebreak,takesomeactiontoremedytheconditionandthentypeOKtocontinue.InmostcasesitsufficesthatalltheinternalfunctionsbelowtheOPENFILEbenamedwithbackslashes,sothattheerrorcodewillchoosetoresumebyrevertingtotheOPENFILEandtryingagain.Thedevicedoesnotneedtoknowaboutthesetofopenfiles(i.e.,thevalueof(OPENP)),andingeneralshouldignoreit.Thatis,thedeviceshouldperformtheopenasiftherewerenootherfilesopenandhencenoconflict.ThegenericfilesystemcodelooksatthestreamreturnedfromtheOPENFILEmethodandthenworriesaboutwhetherthereisactuallyanotherstreamopenbythesamename.Ifthereis,itclosesthenewlyopenedstreamandtheneitherreturnsthepre-existingstream,orcausesaFILEWON'TOPENerrorifthenewandoldaccessmodesareinconflict.Thisdesigniscrufty,butIbelieveitstemsprincipallyfromtherecognitionproblemyoudon'tknowthefullnameofafileuntilyouopenit,soyoucan'ttelluntilthenwhetheryoushouldhavetriedtoopenitinthefirstplace.Itwill,ofcourse,havetobecompletelychangedwhenwegotomultiplestreamsperfile.(REOPENFILENAMEACCESSRECOGPARAMETERSDEVICEOLDSTREAM)ThisisexactlylikeOPENFILE,exceptthatitiscalledafterLOGOUT(orother``after''events)onthenameofanystreamthatwasleftopenoverexit.TheideaistomaintaintheillusionthatthefilereallywasopenoverLOGOUT,butcheckandmakesurenothingchanged.ThegenericfilesystemcodeusestheVALIDATIONfieldtotestwhetherthefilechangedbehindyourback.OLDSTREAMisthestreamthatwasopenbeforeexit,andissuppliedforthebenefitofdeviceswherethereisnopossibilitythatthefilechanged(e.g.,{CORE}),sothattheycanjustreturnOLDSTREAMdirectly.OLDSTREAMisalsoofuseforthosedevicesthathavetocheatinordertomaintaintheillusion.Thiswillhavetochangewhenwegotomultiplestreamsperfile.(GETFILENAMENAMERECOGDEVICE)Performs``recognition''onNAME.Thatis,itreturnsthefullnameofthefilethatwouldbeopenedbyOPENFILEintheindicatedrecognitionmode,orNILifthefileisnotfound.ItisnotnecessarythatOPENFILEactuallybecapableofopeningthefile(thereisnoneedtocheckprotection,forexample).UsedbyINFILEP,OUTFILEP,FULLNAME.(DELETEFILENAMEDEVICE)DeletesthefilenamedNAME,returningitsfullnameonsuccess,NILonfailure.RecognitionmodeisimplicitlyOLDEST.Localdevices,afterrecognizingthefile,shouldmakesurethatitisnotOPENP(openfilescannotbedeleted).ThisandRENAMEFILEareusuallytheonlydevicemethodsthatneedtoknowanythingaboutwhatfilesareopen.(GENERATEFILESDEVICEPATTERNDESIREDPROPSOPTIONS)EnumeratesfilesmatchingPATTERN.Returnsa``filegeneratorobject''oftheform(NEXTFILEFNINFOFN.ArbitraryState).ThisisdescribedinmoregorydetailunderDirectoryEnumeration.î/0ï
î
êïførî	ôïhspî
 ïhsî‘ïb
rîúî#î¡
îî!tî&3î(“
î)øî,dî0Àî3î3ïb
tïb
î9Ïïb
rïb
î:Nî?NîC¿îGäîGäïb
tïb
îJiïb
rïb
îJÁîJÁïb
î‘ï`.îqîjîòîñîñï`.tï`.î &î#„î'·ï`.rï`.î(î+­î,î.ó
î03
î1Ëî4lî6Ÿî;9î=uîAÃîDÜîG;îJÁîJÁï`.î‘ï^[îÕî+î¹îýî èî#5î'2î)‹î+Ðî.`î2õî5ôî8Ñî;nîA îEj
îFý
îH<C3AE>îJÁîJÁï^[î‘ï\‘tîIï\‘rï\‘î«îçîJîþî$î(rî*ùî-£
î/.î2ôî5rî8ëî<½î?ô
îA×îEô
îG~îJÁîJÁï\‘î‘ïZ¾îüîÉî·îJîJïZ¾tïZ¾î·î"üî&XïZ¾rïZ¾î&ëî)4î*lî-¿î0Œî0ŒïZ¾tïZ¾	î:î>6ïZ¾rïZ¾î?!
î@òî@òïZ¾tïZ¾îE_îK@îK@ïZ¾î‘ïXëîîºïXërïXëî uî Ùî%œî(î+iî/¾
î1<C3AE>î6¿
î8Jî9Sî<	î>³
î?ý	îFÆîI+
îJÁîJÁïXëî‘ïWîiîŸî£îÏ
îˆîòî$)î'-î*Êî.ê
î0£î5¡î8î>/î@ñîD!îG;îG;ïWtïW
îHéïWrïWîIA
îJÁîJÁïWî‘ïUEîvîè
î¤îëîJ
î Œî%_î(î)ôî,?î1=î7"î;î=dî=dïUEtïUEîDïUErïUEîDŽ
îFkîJÂîJÂïUEî‘ïSrî”î
îÆî|î!Åî%î(Nî*àî/M
î0äî5•
î7zî=2
î>ÉîAîAïSrtïSrîGÊïSrrïSrîH9îJÂîJÂïSrî‘ïQŸîcîâïQŸî‘ïN»îNîvî‹îåî (
î!¼î%_î)$î+jî-m
î/î2cî55î8(î:mî=û
î?šî?šïN»tïN»îE{ïN»rïN»
îF¸îIA
îJÁîJÁïN»î‘ïLèî8î†î<1D>î î|î"—î$1î&fî*~î.Ìî3÷î6,î9s
î:ø
î</î?<3F>îB´
îD<C3AE>îHîJÁîJÁïLèî‘ïKîøî¥î‘
î<1C>î!¿î";î%î)Äî,"î0’î3Íî7]
î8ìî;Aî?¦îE4îH<C3AE>îJÁîJÁïKî‘ïITtîIïITrïITî¼î±îUî"hî'%î*ñî0*î3Ÿ
î4øî9÷î>íîCIîF§
îH<C3AE>îJÁîJÁïITî‘ïG<C3AF>îôîðî\
îÅî4îÞ
î î#éî&.î*î.×î3,î5Éî8Ôî<¤îA;îC€îJÁîJÁïG<C3AF>î‘ïE·î/
îÊîÙîÜîÜïE·tïE·î î%#î(ïE·rïE·î(Ýî,%
î-]î/”î2Yî4çî7'î;
î?9îAe
îBêîGýîHZîHZïE·sïE·îJ¯îJ¯ïE·î‘ïD!îú
îî‰î‚îOî	
î î#
î(„î+5î-
î2È
î:î<×î?ÍîA¬îC­îF¥
îGÿîHæîJ¯îJ¯ïD!î‘ïB¤îî4îáî%
î{î“î%î öî#<23>î%ñî*î,2î/³î2>î4È
î6
î8º
î9¸
î:ýî<Ïî?îB
îBe
îC}îEÑ
îGîJ¯îJ¯ïB¤î‘ï@êî
î>
î§	îîGî"
î#¬
î%
î&Gî*‚î.Qî0#î1ëï@êrï@êî1ñï@êî	ôï=­t
îîï=­xï=­î€ï=­tï=­îWîWï=­xï=­î×ï=­tï=­î®î®ï=­xï=­î!ªï=­tï=­î"<22>î"<22>ï=­xï=­	î*]ï=­tï=­î+4î+4ï=­xï=­î/£ï=­tï=­î0zî0zï=­xï=­î7Âï=­tï=­î8Ÿï=­î‘ï:ÀrîŸ
î
î<19>î/î/ï:Àtï:Àî"çï:Àrï:Àî#»î'ÿî*Â
î,
î-oî1Yî4Šî4Šï:Àtï:Àî9”ï:Àrï:Àî:î<Cî?ÖîDfîHé
îJÁîJÁï:Àî‘ï8íîÜî‡
î-îºîî!Ïî$gî&Çî*$î-*î0î0Šî3Nî62
î7Š
î9$î>ÈîAîE×îH<C3AE>îJÁîJÁï8íî‘ï7#îøî¿îjîÚîòîòï7#tï7#î$üï7#rï7#î%Ùî(Xî,6î.ìî2žî5–î:§î@iî@îîCÄîHˆîJÂîJÂï7#î‘ï5PîÝîôî¿îðîðï5Ptï5P	î%Vï5Prï5Pî%®î(®
î*.î,‹î1¨î3Ùî6î;Qî?ÈîBÔîEðï5Pî‘ï2cxîÙï2crï2cîj
îáîKî Åî#<23>î&Tî)Ðî.(î16î3ø
î5oî;î=Mî?·îDg
îF*îJÂîJÂï2cî‘ï0™î»îU
îÓ
îë
î"wî%Vî'Çî*Aî/¿î3+î3+ï0™tï0™î85ï0™rï0™
î9ž
î;tî>SîAtîDîFÃîJÂîJÂï0™î‘ï.ÆxîÙï.Ærï.ÆîZî<1D>îîï.Æxï.Æî%fï.Ærï.Æî%ç
î'Nî*
î+Èî.8î0pî4î8Éî;‘î>Ò
î@{îD
îE½îIB
îJÂîJÂï.Æî‘ï,üîîKîúï,üî‘ï*sîæîãî]
î<18>î#îô
î ˆ
î!ð
î##î'^î+-î,ÿî.Çï*rï*î.Íï*î	ôï&Ûtîßîßï&Ûxï&ÛîWï&Ûtï&Ûî.î.ï&Ûxï&Ûî*ï&Ûtï&Ûî
î
ï&Ûxï&Ûî"pï&Ûtï&Ûî#Mï&Ûî‘ï#îrîKî¬
î ‰î ‰ï#îxï#îî$
ï#îrï#îî$´î%î(,î)Æ
î*óî/zî1¯î4î7¤
î94î;iî=§î@KîDL
îFîJÁîJÁï#îî‘ï"$
î`î`ï"$tï"$îï"$rï"$îq
îòî$î"å
î)ãî-â
î/yî/yï"$tï"$î1þï"$rï"$î2X
î3Œî5¾î7ù
î98î;î?´î@

îAX
îB—îDÞîJÁîJÁï"$î‘ï QîPîPï Qtï Qîï Qrï Qîî‚
î!dî&R
î'ýî-7î/‡î1àî5Ò
î70
î9'î<t
î>îAã
îH³îJÂîJÂï Qî‘ï~î©î
îf
î4î4ï~tï~î"ï~rï~î"Åî"Åï~tï~î)}ï~rï~î*-î*-ï~tï~î0åï~rï~î1Bï~î	ôï8t
îîï8xï8î€ï8tï8îWîWï8xï8îÆï8tï8î£ï8î‘ïKrîƒîîîaîòîòïKxïKî"jïKrïKî#Sî)dî+Iî-Ýî1¨
î3¹î8Îî8ÎïKtïKî;SïKrïKî;ä
î=öîB¯îC@
îJÁîJÁïKî‘ïxî`
îÇ	îÙîÙïxtïxî ãïxrïxî!ºî";î%ýî+î.L
î5“î7íî:¨î?îBÉîE¼îH[
îIƒ
îJÁîJÁïxî‘ï¥îéîéï¥tï¥îï¥rï¥î‡îVî&î –î"î
î$Äî*Jî*´î*´ï¥sï¥î-î/5	î7.î8øî<¦î>zî@áîD8îH–îJ¯îJ¯ï¥î‘ïÒî
îOî'î<1B>î‚î!
î#?î$öî'‘ïÒrïÒî'—ïÒî	ôï•t
î<16>î<16>ï•xï•îüï•tï•îÓîÓï•xï•î!-ï•tï•î"î"ï•xï•î*ûï•tï•î+Òî+Òï•xï•î1
ï•tï•î1Þï•î‘ï¨r	îîÜî Ãî Ãï¨xï¨î&ï¨rï¨î&çî'Yî,{î-“î0˜î6Ÿî;Q
î<÷î?CîB•îCï¨xï¨	îJiï¨rï¨îJÁîJÁï¨î‘ï
Þxîï
Þrï
ÞîXîîï
Þxï
Þ
î¼ï
Þrï
Þ
îäî<î!&
î"dî(\
î)Üî-@î06î3Ðî7£î7£ï
Þzï
Þî=™
îE-ï
Þrï
ÞîEŠï
Þ„
êq?€`½7(RENAMEFILEOLDNAMENEWNAMEDEVICE)RenamesthefilenamedOLDNAMEtohavenameNEWNAME.Returnsthefullnameofthenewfileifsuccessful,NILifnot.RecognitionmodeisimplicitlyOLDforOLDNAME,NEWforNEWNAME.ThegenericfilesystemcodeinvokesthismethodtoimplementthefunctionRENAMEFILEonlywhenthehostfieldsofbothfilenamesmaptothesamedevice.Defaultsto\GENERIC.RENAMEFILE,whichisalsothefunctionthatthesystemcallswhentheoldandnewnamesareondifferentdevices.\GENERIC.RENAMEFILEisdefinedtocopyOLDNAMEtoNEWNAMEandthendeleteOLDNAME.Thefollowingmethodsareinvokedforopenstreams.Theyareallrequired:(BINSTREAM)ReturnsthenextbyteofinputfromSTREAM,ortakestheappropriateactionifatendoffile.Unlessadevicehasagoodreasonnotto,itshouldcall(\EOF.ACTIONSTREAM)atendoffile/stream.ThedeviceBINmethodisactuallynotuseddirectly.Rather,everystreamhasaSTRMBINFNfield,whichisthefunctionactuallyappliedtodotheinput.TheSTRMBINFNfieldcouldthusbeusedtofakeaspecializationofthedevicedifferingonlyintheBINmethod.However,thetypicaluseofSTRMBINFNistotemporarilyoverridethedevicedefault.Inparticular,settingastream'saccesstoINPUTorBOTHautomaticallysetsthestream'sSTRMBINFNtobethedevice'sBINmethod;settingaccesstoNILorOUTPUTsetstheSTRMBINFNtobeanerror.Thisrelievesthedevice'sBINmethodofanyneedtocheckthestream'saccessoneverycalltoBIN.SomenetworkstreamstemporarilysettheirSTRMBINFNtobeaninputeaterwhentheyreceivea``clearoutput''command.Currently,allInterlisp-Dstreamshavebytesize8,soBINalwaysreturnsan8-bitinteger.CallstothefunctionBINarecompiledintotheBINopcode,whichrunsinmicrocodeonsomemachinesiftherequirementsforitaremet.Moreonthislater.(BOUTSTREAMBYTE)OutputsBYTEtoSTREAM.AswithBIN,thismethodisnotuseddirectly.Rather,everystreamhasaSTRMBOUTFNfield,whichisthefunctionactuallyappliedtodotheoutput.Settingastream'saccesstoOUTPUTorBOTHautomaticallysetsthestream'sSTRMBOUTFNtobethedevice'sBOUTmethod.ThereexistsaBOUTopcode,butthedesignisincomplete.(PEEKBINSTREAMNOERRORFLG)ReturnsthenextinputbytefromSTREAM,butdoesnotadvancethestreampointer.ThusasubsequentPEEKBINorBINwillreturnthesamebyte.Atendofstream,thedeviceshouldtakeeofactionaswithBIN,unlessNOERRORFLGistrue,inwhichcaseitshouldreturnNIL.(READPSTREAMFLG)ReturnstrueifinputisavailablefromSTREAM,thatis,ifaBINrightnowwouldsucceedwithoutwaiting.Defaultsto\GENERIC.READP,whichusesEOFPandPEEKBIN.îEŠï
Þî
êïførîI¾ïhspîJjïhsî	ôïb5t
îîïb5xïb5îúïb5tïb5îÑîÑïb5xïb5î!
ïb5tïb5î!Øî!Øïb5xïb5î&Gïb5tïb5î'$ïb5î‘ï_HrîUîˆîÅîîï_Hxï_Hî%ï_Hrï_Hî%k
î&íî*î-›î-›ï_Hxï_Hî3Ëï_Hrï_Hî4|î4×î9àî<î>qîB
îC’îEÅîH‡îJÁîJÁï_Hî‘ï]~
îã
î~î~ï]~tï]~îï]~rï]~î{
îÍî‰î 

î'¡î+f
î,Ä	î2Ìî2Ìï]~tï]~î5Qï]~rï]~î5Èî7÷î7÷ï]~xï]~î=éï]~rï]~î>¸î>¸ï]~tï]~îA=ï]~rï]~îA´îCâîCâï]~xï]~îJï]~rï]~îJÁîKîKï]~î‘ï[«î_îî|îîî"*î'î)´î.´
î0Yî71î9‡î>ôî>ôï[«tï[«	îGZï[«rï[«îG×îJÁîJÁï[«î‘ïYØî,îsîSî í
î#Žî'°î.¼î2¾
î5Tî8›î=îB<C3AE>îCîîIA
îJÁîJÁïYØî‘ïXtî †ïXrïXî!Kî%=
î&<26>î)Bî+ˆî0äî3˜î5Þî:?î=3î@ÎîCîEcîH
îJÁîJÁïXî‘ïV;îî¢
îæîÅî%î%ãî%ãïV;tïV;î5ØïV;rïV;î6›
î8Dî=
î?jîB÷îB÷ïV;xïV;îHéïV;rïV;îIA
îJÁîJÁïV;î‘ïThxîÁïThrïThîî¢î™î vî vïThxïThî&hïThrïThî&ÅïThî	ôïP÷î<0C>î{îÙîÿîî!î$`î)|î)Ôî--î/Sî1î6™ïP÷î	ôïMºtî'î'ïMºxïMºîõïMºtïMºîÒïMºî‘ïJÍrîÕîCîbî€
î Hî#ÿî'uî'uïJÍxïJÍî,CïJÍrïJÍî-0
î/î2<C3AE>î4ý
î<eî@‰
îAú
îC¢îFh
îH0îJÁîKîKïJÍî‘ïIî#îhîÃîRî–î" î&‘î)î+>
î,®î1?î3âî4[ïItïI
î>¶î>¶ïIxïIîC„ïItïIîD[ïIrïIîDû
îF­îI6
îJÁîJÁïIî‘ïG0îiïG0î‘ïDLîpîºîºïDLtïDLî?ïDLrïDLîÍîÝ
î!Qî&kî(çî,*î1zî2î6øî:´î?+îA¨îBÛîBÛïDLtïDLîJjïDLrïDLîJÂîJÂïDLî‘ïByîýîí
î>îƒî Ýî%Ôî* 
î,3
î.î0cî4Gî4²î7oî7oïBytïByî>þïByrïByî?iîB|îF)îHÿ
îJÂîJÂïByî‘ï@¦î«
î8îî$
î!l
î#î%Bî)cî.ãî1Ú
î3hî5¦î5¦ï@¦tï@¦î8+ï@¦rï@¦î8<C3AE>î=Îî>3îDDîF‚îJÁîJÁï@¦î‘ï>Óîó
î™î™ï>Ótï>Óî(ï>Órï>Óîš
îó
îŽ
î&Þî,5î.<2E>î2¯î7˜î8
î9È
î@=îD<C3AE>îE¤îJÁîJÁï>Óî‘ï=îµ
î{î{ï=tï=î®ï=rï=îM
î)î)ï=tï=î …ï=rï=î!#î)¦î,_î.Öî4:î4:ï=tï=î;Éï=rï=î<g
î>-
î@7îB®îGäîGäï=tï=îJiï=rï=îJÁîJÁï=î‘ï;-îîWîU
îôîôï;-tï;-î"yï;-rï;-î"ð
î$¦î$¦ï;-tï;-î)°ï;-rï;-î*'î,¹î/
î/
ï;-tï;-î6™ï;-rï;-î7
î8¯
î:’
î<tî@-î@¥îC®îH<C3AE>îJÁîJÁï;-î‘ï9Zî‡î‡ï9Ztï9Zîï9Zrï9ZîjîJ
îÛî!Uî$‰
î&î)Æî+þî1!î5
î6ãî:oî<Ñ
î>Wî>Wï9Ztï9Zî@Üï9Zrï9ZîA‘îAïîE›îJÁîJÁï9Zî‘ï7‡îf
î«îªî!Òî!Òï7‡tï7‡î)aï7‡rï7‡î)É
î+Y
î-,
î/î2Šî5Óî9iî<[î@âîAïîEÑîJÁîJÁï7‡î‘ï5´îÅï5´î‘ï2Ð	î÷î¸
î–î$[î'sî,x
î-Ø
î/nî/nï2Ðtï2Ðî1óï2Ðrï2Ðî2Kî6€î;
î<Æî?ÝîDNï2Ðî‘ï/ãîü
î¤îþîmîmï/ãtï/ãîòï/ãrï/ãî rî"Áî(³î+ƒî-Ýî-Ýï/ãtï/ãî0bï/ãrï/ãî0âî5úî9ÿî=
î>¼îE^
îG^îJÂîJÂï/ãî‘ï.îh
î›îÌî!êî#ù
î%!î'Gî*2î*Šî.
î/òî2dî5_ï.î	ôï*Ótîþîþï*Óxï*ÓîÌï*Ótï*Óî£î£ï*Óxï*Óî©ï*Ótï*Óî†ï*Óî‘ï'ærî±î±ï'æxï'æî·ï'ærï'æî
î—î—ï'æxï'æîeï'ærï'æî î t
î"[î%Jî%Jï'ætï'æî'Ïï'ærï'æî(ƒî*ùî/×
î1î3cî6tî;’î;îî@¬îD6îH{îJÂîJÂï'æî‘ï&î­î­ï&tï&	îï&rï&î‰îî!û
î#Wî%§î+î0î4å
î6ƒ
î8zî:Éî?~î?õîDŠîE¥îJÂîJÂï&î‘ï$@î‡
îîï$@tï$@î)ï$@rï$@î™
îHîHï$@tï$@î ¤ï$@rï$@î!î)hî+ôî.=î3rî3rï$@tï$@	î;Øï$@rï$@î<H
î=á
î?¼îBîG
îG
ï$@tï$@îJiï$@rï$@îJÁîJÁï$@î‘ï"mîpï"mî‘ï‰îcîèîåîåï‰tï‰îAï‰rï‰î™î!ˆî#Úî&î**
î+h
î2Jï‰î	ôïCtîƒîƒïCxïCîQïCtïCî(î(ïCxïC	îïCtïCîõïCî‘ïVrîáî\î†îJî"tî%öî%öïVxïVî*ÄïVrïVî+½î.Xî1£î42î9™î<î@žîEÕîFvîIÄîJÁîJÁïVî‘ïŒ	î™î™ïŒtïŒîzïŒrïŒîä
îŒîŒïŒtïŒî"ïŒrïŒî"{î%î)î+\î.½î2î2q
î4Pî6ë
î8ˆî=3î?vîCœîGøîJÂîJÂïŒî‘ï¹îÁî¨
î)îîï¹tï¹î™ï¹rï¹îIî"<î"<ï¹xï¹	î*,ï¹rï¹î*„
î+Âî.Ï
î0Oî4,î6ì
î8î<^î@]î@]ï¹tï¹îBâï¹rï¹îC?ï¹î	ôïstîÕîÕïsxïsî£ïstïsîzîzïsxïsî¶ïstïsî“ïsî‘ï†rî¬îu
î¼îJ
î<1E>î$9î'…î'…ï†xï†î,Sï†rï†î-î/Êî1t
î2¼î3Íî3Íï†tï†î6Rï†rï†î6¾î9ôî<Ýî@îîEèîJÁîJÁï†î‘ï
³îŠîâî5
îµîµï
³tï
³
î(wï
³rï
³î)'î-î/Ïî/Ïï
³tï
³î3+ï
³rï
³î3ƒî6î6ï
³tï
³î;íï
³rï
³î<Jï
³è
êq?€`½,8Roughlyspeaking,READPisthecomplementofEOFPforstreamsthatarenotarrivinginrealtime.Itisinterestinglydifferentfornetworkstreams,orthekeyboard.FLGisabitofcruftthatnoteveryonepaysattentionto,andmaybeflushedatsomepoint:ifFLGisNIL,thenREADPshouldreturnNILiftheonlyinputwaitingisanendoflinecharacter.(EOFPSTREAM)ReturnstruewhenSTREAMis``atendoffile'',i.e.,aBINwouldcauseanendoffileactiontooccur.Notethatforanetworkstream,itispossibleforbothEOFPandREADPtobefalsesimultaneously,viz.whenthereisnoinputwaiting(bufferedlocally),buttheremoteendofthestreamhasnotindicatedthatthereisnomoreinput.TherearesomewhocallEOFPonstreamsopenonlyforoutput.Thisisacrock;outputstreamsarealwaysatendoffile.Buttoavoidcomplaints,adevicecouldreturnTforEOFPonanoutputstream.(BLOCKINSTREAMBUFFERBYTEOFFSETNBYTES)Performsbulkinputtransfer:retrievesthenextNBYTESbytesfromSTREAMandstorestheminsuccessivebytepositionsinBUFFERstartingatBYTEOFFSET.Defaultsto\GENERIC.BINS,whichrepeatedlycallsBINand\PUTBASEBYTE.Itisalmostalwaysthecasethatadevicewithanon-trivialBLOCKINmethodcanbemadetobeaBuffereddevice,therebybenefitingfromotherBufferedoperationsaswell.(BLOCKOUTSTREAMBUFFERBYTEOFFSETNBYTES)Performsbulkoutputtransfer:outputsNBYTESbytestoSTREAM,takingthebytesfromBUFFERstartingatBYTEOFFSET.Defaultsto\GENERIC.BOUTS,whichrepeatedlycalls\GETBASEBYTEandBOUT.(FORCEOUTPUTSTREAMWAITFORFINISH)ForcestoitsultimatedestinationanyoutputbufferedonSTREAMbutnotyetsent.WAITFORFINISHmeansthatthefunctionshouldnotreturnuntilitisconfidentthattheoutputhasreacheditsdestinationandbeencommitted.DefaultstoNILL,whichisreasonableforunbufferedstreams.Forexample,foranetworkstream,FORCEOUTPUTsendsthecurrentpacketbeingbufferedup.Forabufferedstreamtothedisk,FORCEOUTPUTwritesouttothediskany``dirty''pages,andmakessurethefileisinsuchastatethatifthemachinewerebootedafterFORCEOUTPUTreturns,thatthefilecouldbesuccessfullyreopenedwithnoinformationlost.(GETFILEINFONAME/STREAMATTRIBUTEDEVICE)ReturnsthevalueofthespecifiedATTRIBUTEofNAME/STREAM,whichcanbeanopenStreamorthenameofa(closed)file.ReturnsNILforattributesitdoesn'tknowabout.Itisconsideredgoodcitizenship,thoughnotabsolutelyrequired,toknowaboutthefollowingattributes:LENGTHLengthofthestream/fileinbytes.Ifthedevice'smethodreturnsNIL,butthestreamisrandomaccess,thegenericGETFILEINFOcodetriesthedevice'sGETEOFPTRmethodinstead.SIZELengthinpages,i.e.,(FOLDHIlengthBYTESPERPAGE).î<Jï
³î
êïførî	ôïhspî
 ïhsî‘ïb
rî0î>î>ïb
tïb
î qïb
rïb
î!
î"vî$Þ	î,º
î.|î.|ïb
tïb
î1Øïb
rïb
î2gî4®î9ªî<<3C>î>ÞîA\îF‚
îH9îJÁîJÁïb
î‘ï`.îÞî6
î€
î¾îVî#Êî%Ùî*ÿî0
î1²î3ãî9¾ï`.î‘ï]JxîÍï]Jrï]Jî(
îjîjî\
îëîî´î ýî&¬î)§î/>î1î3¦î6€
î8Gî<ø
î>gîAÎîE¹
îFïîFïï]Jxï]JîI+ï]Jrï]JîIƒ
îJÁîJÁï]Jî‘ï[€tîï[€rï[€îÆî½î½ï[€tï[€îðï[€rï[€îHî’î#‘î#‘ï[€tï[€î&ï[€rï[€î&n
î'¡î)Òî,¼î06î4Ø
î6
î7Ùî:b
î;íî>t	îD0ï[€î	ôïX:tîþîþïX:xïX:îÌïX:tïX:î©ïX:î‘ïUMrîÏî»îxîxïUMxïUMî!FïUMrïUMî!Õ
î#Jî%œî(\
î*î-˜î04î1hî1hïUMtïUMî3íïUMrïUMî4|î8°î<m
î>gîA'
îBéîEZîIA
îJÁîJÁïUMî‘ïSzîÈîpîî÷îVî£î%î*
î+{
î-	î2iî4Èî8$î8$ïSztïSzî;€ïSzrïSzî<(î?î?ïSztïSzîC5ïSzrïSzîCÝ
îE­
îGÀîJÁîJÁïSzî‘ïQ§î1î°î \î#Û
î%>
î'<î*Ûî/¢î5«î:Èî=?î?–îD2îFà
îH<C3AE>îJÁîJÁïQ§î‘ïOÝîÒîî_îî!¾î%
î&V
î(.î+’î/ïOÝî‘ïLùîîÂîCî4î¬î¬ïLùtïLùî#ïLùrïLùî#|
î%qî*Rî-²î0¸î2äî7—î8î;
î<mî=†îA îEüîJÁîJÁïLùî‘ïK&îÈî
îŒî&
îÃîfîÐî"S
î#åî'†
î.«î/ºî3àî7‹î;œî;œïK&tïK&î<sïK&rïK&î<Ýî>ýî>ýïK&tïK&îBYïK&rïK&îBÃ
îD­
îF<C3AE>îJÁîJÁïK&î‘ïISî×ïISî	ôïFtîƒîƒïFxïFîQïFtïFî(î(ïFxïFî²ïFtïFî‰î‰ïFxïF	î#õïFtïFî$Ìî$ÌïFxïFî)^ïFtïFî*;ïFî‘ïC)rîxîªîVî"Üî(`î*Ãî-Öî-ÖïC)xïC)î2hïC)rïC)î2òî6ˆî9òî9òïC)xïC)î>ÀïC)rïC)î?JîBîEçîIA
îJÁîJÁïC)î‘ïA_	îÐî¶îN
î Óî ÓïA_xïA_î%]ïA_rïA_î%ºî*y
î+éî+éïA_xïA_	î3UïA_rïA_î4	î4gî9¿
î;Dî;DïA_tïA_îF/ïA_rïA_îFäîJÁîJÁïA_î‘ï?Œ	î
îìîìï?Œtï?Œîqï?Œrï?ŒîÉîRîRï?Œtï?Œî)fï?Œrï?Œî)Ãï?Œî‘ï<Ÿ
îî
î?î†îÎîî åî#—î$§î(Îî+Ìî,Ü
î3sî3sï<Ÿtï<Ÿî9Tï<Ÿrï<Ÿî9¿î>¬îA
îBñîF‚
îH
îIÅîJÂîJÂï<Ÿî‘ï:Ìîî‡îW	î%¦î(Þî,Mî1×	î8Q
î9Òî<•ï:Ìî	ôï7<C3AF>tîZîZï7<C3AF>xï7<C3AF>î(ï7<C3AF>tï7<C3AF>îÿîÿï7<C3AF>xï7<C3AF>î‰ï7<C3AF>tï7<C3AF>î`î`ï7<C3AF>xï7<C3AF>	î$Ìï7<C3AF>tï7<C3AF>î%£î%£ï7<C3AF>xï7<C3AF>î*5ï7<C3AF>tï7<C3AF>î+ï7<C3AF>î‘ï4¢rîhî‰îêî#`î(Eî(Eï4¢xï4¢î,×ï4¢rï4¢î-Pî-Éî1O
î2ñî2ñï4¢xï4¢î7¿ï4¢rï4¢î8<C3AE>î<®î?îB†îEßîEßï4¢xï4¢îJiï4¢rï4¢îJÁîJÁï4¢î‘ï2Øî[
îØîØï2Øxï2Ø	îDï2Ørï2Øîînî$Ó
î&eî&eï2Øtï2Ø
î2'ï2Ørï2Øî2èî6×	î=eî@Uî@Uï2Øtï2ØîJiï2Ørï2ØîJÁîJÁï2Øî‘ï1îîï1tï1îvï1rï1îÓï1î	ôï-¿tîßîßï-¿xï-¿î­ï-¿tï-¿î„î„ï-¿xï-¿î$ï-¿tï-¿î$îï-¿î‘ï*Òrî“
îÖîEî 9
î'Îî+î0î65
î8Ðî8Ðï*Òxï*Òî=žï*Òrï*Òî>¹îAÎîD×îGµîJÁîKîKï*Òî‘ï)xîï)rï)î„î§î!Tî#“î(èî-@î/”î3¡î6Å
î7û
î9Gî?AîAîîD-îH{îJÂîJÂï)î‘ï'>î„î1
îî <20>î#À	î*Àî+î0n
î1ðî1ðï'>tï'>î5Lï'>rï'>î5þî9Ý
î;	îA»îCË	îJÁîJÁï'>î‘ï%kî[ï%kî‘ï"‡î3îùî.îQî!<21>î&]î&]ï"‡tï"‡
î/šï"‡rï"‡î0î3Ïî6&î:åî?5îBöîH†îJÁîKîKï"‡î‘ï ´î9îaî÷îc
î î"kî%­î%­ï ´tï ´
î.êï ´rï ´î/mî3kî5Ü
î7ˆî9äî<Îî?lîDîH9îJÂîJÂï ´î‘ïáî¦î}î»î

îK
îØî!æî"ïî%þî(©
î)èî,&î1…î4´î9,î<Eî<Eïátïá
îE‚ïárïáîEæîJÁîJÁïáî‘ïî0îaî›î5
îøî$.î*î,ð
î.È
î6î8ˆïî	ôïÑtîßîßïÑxïÑ
î²ïÑtïÑî‰î‰ïÑxïÑî% ïÑtïÑî%÷î%÷ïÑxïÑî*fïÑtïÑî+CïÑî‘ïärî¬îòî<1B>
î îfî%î%ïäxïäî+šïärïäî,
î-§î-§ïäxïä
î6zïärïäî7>î;0î=¢
î?y
îAQîD¨îI+
îJÁîJÁïäî‘ïîÃîV
îâîàîÑî cî ¼î%Åî%Åïtïî(Jïrïî(£î*³	î0—
î1Àî6Nî9ßî=èî>A
î?<3F>
î@Ì	îGîJÁîJÁïî‘ïGîƒîîK	î$™î*O
î+Ïî/^î3î5@î;
îA'ïGîàï©tîêï©rï©îÌî"k
î$î&K
î-0
î.Âî2‘î2û
î4bî6¥î;§î@“îE(îE(ï©tï©îG­ï©rï©îHoîJÁîJÁï©îÌïÖî Zî$ø
î&”î+áî0tî3î7øî7øïÖtïÖ
îA5ïÖrïÖîAêîE^îH<C3AE>îJÁîJÁïÖîÌï
î"¼î"¼ï
tï
î*Kï
rï
î*£î/}î4ï
îàï
\tî<ï
\rï
\îÌî"Y
î#Ùî'Íî*2î*2ï
\tï
\î0êî0êï
\rï
\î4›ï
\tï
\î5rî@]ï
\rï
\î@ºï
\	<
êq?€`½á9CREATIONDATEDatewhenthefile'scontentswerecreated,asastring.Thecreationdatedoesnotchangewhenafileiscopiedorrenamed,onlywhenitischanged.WRITEDATEDatewhenthefilewaswrittentoitscurrentplaceofstorage.READDATEDatewhenthefilewaslastread.ICREATIONDATE,IWRITEDATE,IREADDATEThecreation,writeandreaddatesasintegers,suchasfromthefunctionIDATE.TYPETypeofthecontents:TEXTforfilesthatcontainonly``text''(generallymeaning7-bitascii),BINARYforallothers.NILmeansunknown.AUTHORNameoftheuserwhocreatedthefile(astring).Thefollowing``generic''attributesaregenerallyhandledbythegenericsideofGETFILEINFOifthedevice'sGETFILEINFOmethodreturnsNIL:EOLTheendoflineconventionofthestream(CR,CRLForLF).BUFFERSThenumberofpagemapbuffersforusebythestream(seedescriptionofMAXBUFFERSfieldofpagemappedstreams).ENDOFSTREAMOPActiontotakeonanyattempttoreadbeyondtheendoffile.Thisisafunctionofoneargument,thestream.Thefunctioncancauseanerror,orreturnavalue,whichisinterpretedasavaluetoreturnfromBIN.ThedefaultENDOFSTREAMOPcausesanENDOFFILEerror.ACCESSAnatomdescribingtheaccessmodeofthestream(INPUT,OUTPUT,etc).Thisissogenericthatitishandledbeforethedevice'smethodeverseesit.BYTESIZE,OPENBYTESIZEThesizeofbytestransmittedonthestream.Always8thesedays.(SETFILEINFONAME/STREAMATTRIBUTEVALUEDEVICE)SetsthevalueofthespecifiedATTRIBUTEofNAME/STREAMtobeVALUE.ReturnsTifsuccessful,NILifunsuccessful,orforattributesitdoesn'tknowabout.ItisnotgenerallyrequiredthatSETFILEINFOrecognizeanyattributesatallNILLisaperfectlygoodfillerforthisslot.MostdevicesrecognizenomorethanTYPEandCREATIONDATE(ICREATIONDATE),andeventhosearenotveryimportant,asmostapplicationssetthoseattributesinthePARAMETERSargumenttoOPENFILEwhencreatingafile.ATTRIBUTE=LENGTHimpliesactuallytruncating(orlengthening)thefile;however,theSETFILEINFOneednothandlethisitselfifitreturnsNIL,thenthegenericfilesystemwillattempttousetheSETEOFPTRmethodinstead.Thefollowingoperationsareonlyrequiredofrandomaccessstreams.Theydefaulttothefunction\IS.NOT.RANDACCESSP,whichcausesa``Streamisnotrandaccessp''errorwhencalled.(GETFILEPTRSTREAM)Returnsthecurrentfilepointer(byteposition)inSTREAM.Thefilepointeriszerowhenthestreamisopened(exceptforACCESS=APPEND),andisincrementedbyoneforeachbyteread.î@ºï
\î
êïførîI¾ïhspîJjïhsîàïb
tîôïb
rïb
î"Âî&iî*iî-î0¢î6Yî9õî?`
îAZîBÑîGGîHîJÁîJÁïb
îÌï`.î%cî(mî*¼î/<î2Ëî3Ñî6
î7Zî;¢
î=AîC"îFîIš
îJÂîJÂï`.îÌï^d
î
î$Mï^dîàï[Ætîoï[Ærï[ÆîÌî úî$€î&±î(ëî+iî/ë
î1kî3î7°î;
î<ŸîA&ï[ÆîàïYtî˜ïYrïYîÌî úî$€î&±î(ëî+iî-ºî0«ïYîàïVxtîËïVxrïVxî{î{ïVxtïVx	î'áïVxrïVxî(‘î(‘ïVxtïVxî0 ïVxrïVxî0&ïVxîàïT^îÌî °î&Tî)Þî,¢î/Êî3`
î5î: î=Þ
î?šîCîEzîJÁîJÁïT^îÌïR”tî!ÿïR”rïR”î"\ïR”îàïOítî<ïOírïOíîÌî!s
î#Lî%Ëî+Ðî+ÐïOítïOíî/,ïOírïOíî/Òî2/î5;î8)î=$î@\îD“	îJÁîJÁïOíîÌïNî#5î&Lî)üî)üïNtïNî/ïNrïNî/^î1mî3.î7xî7Ðî7ÐïNtïNî:UïNrïNî:­î>ÂîD¨ïNîàïKstîêïKsrïKsîÌî!¹
î#Dî%uî(@î+î/®î1ßî4
î5<C3AE>î9³ïKsî‘ïH†îUîN
îa	î%^î'Ÿî-pî2§
î4<C3AE>î6Üî;<3B>î>S
î?ùî?ùïH†tïH†
îI6ïH†rïH†îIŽ
îJÁîJÁïH†î‘ïF³îÂî²î²ïF³tïF³
î ïïF³rïF³î!Gî&!î*¤î*¤ïF³tïF³î-)ïF³rïF³î-¨ïF³îàïDtîeïDrïDîÌî uî"þ
î$‰î'	î-í
î/xî1©î5êî6cïDtïD
î8ïDrïDî8Áî8ÁïDtïDî<ïDrïDî<u
î>î>ïDtïD
î?¹ïDrïD
î@<40>ïDîàïAetîÁïAerïAeîÌî £î%Í
î'†î-`î2î4Nî6Ã
î8¿î;î?<3F>îBZ
îI7
îJÂîJÂïAeîÌï?’t	î&2ï?’rï?’î&Šî)Š
î+	î2òî85ï?’îàï<ëtîËï<ërï<ëî"Âî'
î(±î+Ž
î-yî/ÿî4í
î6€î9î>Kî@<40>îC+
îDÉîGmîGØîJÂîJÂï<ëîÌï;
îî #î%y
î'î)<29>î/ýî2<î6âî7Iî:î?UîAÁîEU
îG&îJÁîJÁï;îÌï9N
îî#›î$µî(¤î,ž
î-ù
î4õ
î6“î7­î;D
î<áî@ýîDRîDRï9Ntï9NîF×ï9Nrï9NîG£îHîJÁîJÁï9NîÌï7{î"Cî"Cï7{tï7{î-.ï7{rï7{î-†î1<C3AE>
î3Sî3Sï7{tï7{î6¯
î94î<<3C>ï7{rï7{î<èî@‚î@Úî@àï7{îàï4Ôtîêï4Ôrï4ÔîÌ
î î#…	î*
î,aî0bî4+
î5Ùî8-î<‘î=
ï4Ôtï4ÔîA=ï4Ôrï4ÔîBîBï4Ôtï4ÔîGï4Ôrï4ÔîGíîJÂîKîKï4ÔîÌï3
î ¶
î!ô
î#Šî("î*Á
î+é
î-'î2Cî6bî8“î=ƒîB]îE3îGÝîI
ï3
îàï0ctîFî&Zï0crï0cî'¸î*¶î-‡
î/gî3!
î:<3A>
î<®î?4îD!îDÎîIeîJmîJmï0cîÌï.<2E>î!&î$"ï.<2E>î	ôï+Stîßîßï+Sxï+S
î²ï+Stï+Sî‰î‰ï+Sxï+Sî% ï+Stï+Sî%÷î%÷ï+Sxï+Sî)ëï+Stï+Sî*Âî*Âï+Sxï+Sî/1ï+Stï+Sî0ï+Sî‘ï(frîSî<15>î
î­îëî"€î"€ï(fxï(fî)ï(frï(fî){
î+î+ï(fxï(f
î3åï(frï(fî4J
î5Ö
î7¥î7¥ï(fxï(fî;™ï(frï(fî<Tî<¹îAÌîAÌï(ftï(fîB£ï(frï(fîC
îDF
îJjï(ftï(fîKAîKAï(fî‘ï&“îï&“rï&“în
î¡î©
î?î N	î&0
î'Xî+åî/tî3*ï&“î‘ï#¦
îß
î!îkî$î †î#)î#)ï#¦tï#¦
î,fï#¦rï#¦î,Ãî2²î5)	î;
î<~î?Gï#¦tï#¦îB£ï#¦rï#¦îBÿ
îDAîEBîJÁîJÁï#¦î‘ï!Óî7î¼î0îî (î äî$¢î)Ÿî/î
î2+î5ôî9Oî9Oï!Ótï!Óî<«ï!Órï!Óî=hî@Uî@Uï!Ótï!ÓîJiï!Órï!ÓîJÁîJÁï!Óî‘ï î
ï tï îõï rï 
î<1D>î ‹î$î'õî*<2A>î-Eî0˜	î7<C3AE>
î9‚î=!îDóîGSîJÂîJÂï î‘ï-	îs
îóî$î$ï-xï-	î"ï-rï-î"Xî(Q
î)Ñî)Ñï-tï-î0‰ï-rï-î0áî4gî9mî:jî<©ï-î‘ï@xî(ï@rï@îîCîCï@tï@îMï@rï@î +î%Fî*°	î1‘î4&î<pî?'îB`îH<C3AE>îJÁîJÁï@î‘ïmt
îÎïmrïmîcîÎî Qî$äî'“î-7
î.<2E>î3]î3]ïmtïmî5âïmrïmî6Ïî:î<qîAFîC½îHFîJÁîJÁïmî‘ïšîl
îìî3îdîdïštïšî"óïšrïšî#Kî(%î,¬ïšî	ôï î
îc	îPîêî Hî&
î(î-}î1Îî7^î8*î;÷î@â
îBÖîEzîJÁîJÁï î	ôïVtîéïVrïVî™îvî"€î#}î(°
î)îî,4î4=î7€î;î>ÑïVî	ôït
îîïxïîÖïtïî³ïî‘ï#rîÚîLî'î¢î$zî(î-Þ
î/Ÿî/Ÿï#xï#î4mï#rï#î5^î5÷î8âî;]î@5
îAµîDÊîH‘îJÂîJÂï#î‘ï
YîÒ
îî¾îWî!fî!fï
Yxï
Yî%æï
Yrï
Yî&>î'öî'öï
Ytï
Yî-ï
Yrï
Y
î.)î0²
î1ð
î9 
î;nî=ëî?úîBüîEÝîHÎï
Y<08>
êq?€`½710Althoughthisoperationisonlyabsolutelyrequiredforrandomaccessstreams,itisdesirabletosupplyitforotherstreamswherepossible.Forexample,whenreadingafilesequentiallythroughPupFtp,thestreamcancountthebytesastheygobyandthusgiveanaccuratevalueforGETFILEPTR.Ifastreamhasnoideaatallofposition,itcanmakeitsGETFILEPTRbethefunctionZEROandtherebyatleastavoidbreaksfromcodethatcallsGETFILEPTRcarelessly.(GETEOFPTRSTREAM)ReturnsthefilepointeroftheendofSTREAM,i.e.,thefilepointerthatGETFILEPTRwouldreturnafterthelastbyteofSTREAMisread.SameastheLENGTHattributeforastreamthatrepresentsafile.Ofcourse,non-randomaccessstreamsmayhavenoideawheretheendis,andcausinganon-randaccessperrorisperfectlyacceptable.(SETFILEPTRSTREAMBYTENUMBER)SetsthefilepointerofSTREAMtobeBYTENUMBER.ThespecialvalueBYTENUMBER=›1meanstheendofthestream;othernegativevaluesareillegal.SETFILEPTRbeyondtheendofthestreamispermissible,butithasnoimmediateeffectbeyondchangingthelogicalfilepointer.AttemptingtothenBINcausesanEOFerror.AttemptingtoBOUT(forafileopenforwrite)shouldextendthefile,sothatitseofisimmediatelybeyondthenewlyBOUTedbyte.AswithGETFILEPTR,thereisnorequirementthatthisworkonnon-randomaccessstreams,anditmaybecompletelyimpossibleonsomeofthem.However,forthosenon-randomaccessstreamsthatperformGETFILEPTR,itispossibletofakeSETFILEPTRforvalueslargerthanthecurrentfilepointerbyskippingsomenumberofbytesinthefile,e.g.,byperforming(RPTQ(DIFFERENCEBYTENUMBER(GETFILEPTRSTREAM))(BINSTREAM)).TherearesomeapplicationsforwhichforwardSETFILEPTRisalltherandomaccessthatisactuallyrequired,soitisnicetobeabletoaccommodatesuchapplications.(BACKFILEPTRSTREAM)BacksupthefilepointerinSTREAMbyonebyte.Functionallythesameas(SETFILEPTRSTREAM(SUB1(GETFILEPTRSTREAM)),butmaybepossibleonnon-randomaccessstreamsbymaintainingaone-characterbuffer,whichisallthebackingupthisoperationisformallyrequiredtoperform.IbelievethemainuseforthisisinREAD,whichneedstobackupthestreamonecharacterwhen,forexample,itreadsabreakcharacterterminatinganatom.(SETEOFPTRSTREAMLENGTH)ChangesthelengthofSTREAMtobeLENGTH,i.e.,``sets''itsendoffilepointer.Thismayrequirelengtheningortruncatingthefile.Usedbythefunction\SETEOFPTRandbySETFILEINFOforattributeLENGTHwhenthedevice'sSETFILEINFOmethoddoesn'thandleit.Thefollowingthreefieldsareplaceholdersforpossiblefutureextensions.Thesefieldsarenotcurrentlyusedatall:(LASTCSTREAM)ReturnsthelastcharacterreadfromSTREAM,i.e.,thelastbytethatwasBINed,asacharacter.LASTCiscurrentlyimplementedviaBACKFILEPTR.îHÎï
Yî
êïførî	ôïhsp
îLïhsî‘ïb
rî®îRîz
î êî$	î*†î0î2Wî7yî;‰î@Ø
îB2
îC¢îIA
îJÁîJÁïb
î‘ï`7îß
îî3î±î …î$|î)ñî*Wî,âî2‘î6%î:øî<î>LîE»îJÁîJÁï`7î‘ï^mîîªîLî 
î$î&£î*i
î,Kî/<2F>
î1°
î3ßî6Éî:î= 
î?DîDØîH²îJÁîJÁï^mî‘ï\£t	î÷ï\£rï\£îÜîi
îôî&î!<21>î$
î&'î)&
î*Çî,½
î.~î4
î5wî8	î;Äî=¥î=¥ï\£tï\£	îFï\£rï\£îF™
îH‘îJÂîJÂï\£î‘ïZÐîØîØïZÐtïZÐî4ïZÐrïZÐîŒîî å
î"Pî%Fî(Õî,ÿî07î3Nî5íî8Ìî8ÌïZÐtïZÐ	îA2ïZÐrïZÐîAŠ
îGpïZÐî	ôïWŠt	î1î1ïWŠxïWŠîÿïWŠtïWŠîÜïWŠî‘ïT<C3AF>rîšîÍîî¡
î .î"`î$ë
î&wî&wïT<C3AF>xïT<C3AF>î+EïT<C3AF>rïT<C3AF>î+÷î.^î0<C3AE>î2Ìî7eî:î:ïT<C3AF>tïT<C3AF>	îBkïT<C3AF>rïT<C3AF>îBÅîFÃîJÂîJÂïT<C3AF>î‘ïRÊî¬îêîIî8
îÑîÑïRÊxïRÊî!ŸïRÊrïRÊî"
î#Qî&¢î'î*¦
î,5î.tî.tïRÊtïRÊî3~ïRÊrïRÊî3äî9Pî;mî<xî@ÇîCs	îIÄîJÁîJÁïRÊî‘ïP÷î\îí
î	î¹	î"¢î&¹î+·î.Æî2
î4)î7,î;Nî=¹î@{îBJîEîIÅîJÂîJÂïP÷î‘ïO-î©îì
î*î$©
î+*ïO-î	ôïKðt
îîïKðxïKðîÖïKðtïKðî­î­ïKðxïKð	î!ÉïKðtïKðî"¦ïKðî‘ïIrîVî—îáîˆ
î#î#ïIxïIî"ñïIrïIî#X
î$è
î&»î&»ïIxïI	î.×ïIrïIî/–î/þî2¶î7î:šî:šïIxïI	îB¶ïIrïIîCîDæ
îF­îJÂîJÂïIî‘ïG9îÂîK
îÖîîÁî!0î&mî*kî,‘î0pïG9î‘ïDUt	î÷ïDUrïDUî^î&î&ïDUïDUî fî"ÿ
î$™î&Ùî*ÂïDUïDUî+)
î,wî3çî6H
î7î9Ö
î;½îB]îFîJÁîJÁïDUî‘ïB‚îpîÖî1î î$Âî%O	î,˜
î.Mî1xî1xïB‚tïB‚î3ýïB‚rïB‚î4Šî8È
î:Àî:ÀïB‚tïB‚î=EïB‚rïB‚î=ÑîA îB,	îIA
îJÁîJÁïB‚î‘ï@¯tîíï@¯rï@¯îgîî2îŽîôî &î$î(|î,ëî/>î1ó
î3¬î6mî8<î:<3A>
î;ï
îCµîH<C3AE>îJÁîJÁï@¯î‘ï>Üîcîcï>Ütï>Üî¿ï>Ürï>Ü
î‚îºîîï>Üï>Üîï>Üî‘ï;ï
îƒî~î~ï;ïtï;ï	îäï;ïrï;ïî£î"

î#Z
î%B
î,ìî/šî2î5x
î7`	î?îCîH8îJÁîJÁï;ïî‘ï:
îÀî<14>
îg	î5	î#Ö
î%µî) 
î*³î.kî.Êî4Õî6ëî:a	îBîEüîJÁîJÁï:î‘ï8RîGî…î…ï8Rtï8R	î ëï8Rrï8Rî!²
î"ñ
î$Fî)l
î+î-ïî-ïï8Rtï8R	î6Uï8Rrï8Rî6Äî8êî<ÿî@ÒîCàîF(îJÁîJÁï8Rî‘ï6îhîœ
îî!î%
î*š
î,Ãî0Å
î2âî5°î8ßî</
î>š	îF6îF6ï6tï6îK@îK@ï6î‘ï4¬
î¸î¸ï4¬xï4¬	î"Ôï4¬tï4¬î#¿
î-çî-çï4¬xï4¬î2µï4¬tï4¬
î5Mî9”î9”ï4¬xï4¬î>bï4¬tï4¬
î@ï4¬rï4¬î@ÓîA>îE$îG]îJÁîJÁï4¬î‘ï2Ùîî,îî#1î#1ï2Ùtï2Ù	î+—ï2Ùrï2Ùî,
î-Yî/0î1wî6~î:rî='
î>{îCuîI+
îJÁîJÁï2Ùî‘ï1
î¹
î÷î¶
î6
îùîÃ
îC
î%¸î(ºî0ï1î	ôï-Étîßîßï-Éxï-Éî­ï-Étï-ÉîŠï-Éî‘ï*Ürî›
îÏîPîÚî À
î"<22>î"<22>ï*Üxï*Üî'^ï*Ürï*Üî(
î*#î,ðî0xî1 î9<î;½î?\
îA,îA,ï*Ütï*Ü
îK@îK@ï*Üî‘ï)	xî_ï)	tï)	î8îE
î%\î%\ï)	xï)	î**ï)	tï)	
î+Øï)	rï)	î,Šî.ßî1¸
î3~î8<C3AE>
î:j	îBîEüîJÁîJÁï)	î‘ï'6
î±
îeî´î$[î)î-4
î.Åî0Øî3[î8<C3AE>
î:Óî=˜îCà
îEpîJÁîJÁï'6î‘ï%lîö
î}îîbîEî"Îî%î([î*ªî,Àî/9
î0
î2î2ï%ltï%lî5bï%lrï%lî6î9þî=·
î?>îB]
îDHîF€îJÁîJÁï%lî‘ï#™îîÅî£î²î$R
î%zî(êî)çî-<2D>î3D
î:o
î<2î?…ï#™î	ôï \t	î1î1ï \xï \îÿï \tï \îÖîÖï \xï \î¦ï \tï \îƒï \î‘ïorîîFîb
îîïoxïoî"Îïorïoî#9
î$Ì
î&¢î&¢ïoxïoî+rïorïoî,5î.­î2’î4Qî6í
î8‹î:Øî?Ùî@DîCAîF)îJÁîJÁïoî‘ï¥
îå
î„	îçî" î$ºî%î(ˆ
î*^î,—î1çî1çï¥tï¥	î:Mï¥rï¥î:­î=?
î?î?ï¥tï¥
îHRï¥rï¥îH²îJÁîJÁï¥î‘ïÒîïîïïÒtïÒîùïÒrïÒîQî×î!î%øî%øïÒtïÒ
î/5ïÒrïÒî/<2F>î4gî8ôî=Jî>wïÒî	ôïXî¤îŠîìîxî¦îî#Çî%Þî*õî.ñ
î5Àî6 î9úî=†î?´îBîG´îJÁîJÁïXî	ôïŽ
î_î
GïŽî	ôïQtîÕîÕïQxïQî£ïQtïQî€ïQî‘ïdrîÌî1î¶î ¡î#Áî'-î'-ïdxïdî+ûïdrïdî,ßî/wî1Üî4aî7vî:Iî<ûî<ûïdtïdî?€ïdrïdîAÏ
îC„îD´	îJÂîKîKïdî‘ï‘tîÄï‘rï‘î
îZî
î$"î&1î&1ï‘tï‘
î/nï‘rï‘î/Ëï‘	˜
êq?€`½Ÿ11(FREEPAGECOUNTHOST/DIRDEVICE)IntendeduseistoreturnthenumberoffreepagesonHOST/DIR.MaybefoldedintoageneralGET/SETdevice/directoryinfooperation.(MAKEDIRECTORYHOST/DIRDEVICE)IntendeduseistocreateanewdirectoryHOST/DIR.TheremainingfieldsintheFDEVareforbufferedandpage-mappedstreams,andareignoredfornon-buffereddevices.Thesefieldsaredescribedinseparatesections.StreamsThefollowingfieldsareusedbyallstreams:DEVICEPointertothisstream'sFDEV.FULLFILENAME``Full''namebywhichthisfileisknowntotheuser.Shouldbeanuppercaselitatom,fullyqualifiedsothatgivingthesamenamebacktothefilesystemshouldproducethesamefile(totheextentthatthedevicecansupportsuchuniqueness).IsNILforunnamedstreams.FULLNAMEAccessfield.IsthesameasFULLFILENAME,unlessthatisNIL,inwhichcaseitisthestreamitself.ThisavoidsthecircularitythatwouldresultiftheFULLFILENAMEfieldcontainedthestreamdatum.NAMEDPAccessfield.IsTifthestreamsisnamed,i.e.,itsFULLFILENAMEisnon-NIL.ACCESSBITSContainsanumericcodedescribingwhataccessmodethefileisopenfor:thereareread,writeandappendbits.ThisfieldisusuallyaccessedindirectlyviatheACCESSfield.However,therearemacrosforreferringtoparticulartypesofaccessusingmoreefficientbittestoperations:(OPENEDSTREAM)ACCESSisnotNIL.(READABLESTREAM)Readbitison:ACCESSisINPUTorBOTH.(READONLYSTREAM)Onlythereadbitison:ACCESSisINPUT.(APPENDABLESTREAM)Appendbitison:ACCESSisOUTPUT,BOTHorAPPEND.(APPENDONLYSTREAM)Onlytheappendbitison:ACCESSisAPPEND.(DIRTYABLESTREAM)Appendorwritebitison:ACCESSisOUTPUT,BOTHorAPPEND.Yes,thisisoperationallythesameasAPPENDABLE,giventhefourpossiblevaluesofACCESS.(OVERWRITEABLESTREAM)Writebitison:ACCESSisOUTPUTorBOTH.(WRITEABLESTREAM)Writebitison,orappendbitisonandfileisatEOF.Avoidusingthisone,it'salittlestrange.î/Ëï‘î
êïførîIïhsp
îJjïhsî	ôïb5t
î<16>î<16>ïb5xïb5îmïb5tïb5îDîDïb5xïb5î!³ïb5tïb5î"<22>ïb5î‘ï_HrîbîÏ
î3
îØîýî"Sî'u
î)%î+êî/«
î1©î1©ï_Hxï_Hî7‰ï_Hrï_Hî8]î8Ûî<
î=ëîB.îDüîFîJÁîJÁï_Hî‘ï]~î î!+î#Þ	î)Ùï]~î	ôïZAt
î<16>î<16>ïZAxïZAîmïZAtïZAîDîDïZAxïZAî!³ïZAtïZAî"<22>ïZAî‘ïWTrî=î„
îÂ
îBîî î"Òî(qî(qïWTxïWTî.QïWTrïWTî.®ïWTî	ôïSãî
!îôîü
îî´î´ïSãtïSãî ïSãrïSãî ìî#–î&)î,î/$
î7þî=Ÿî@¬îCVîH²îJÁîJÁïSãî	ôïRîîîdî6îºî àî&Ø
î(Xî-€î2tïRî	ôïM„vî¹ïM„rïM„î¿ïM„î	ôïIÜî<0C>î{îÿî%î2
îîÁî#­ïIÜî	ôïFktîþïFkrïFkî/îÑ
îQîÃî$àî$àïFktïFkî(<ïFkrïFkî(™ïFkî	ôïBñtîïBñrïBñî/îqî
î!î$ûî'‡î)Û
î+3î/¢
î1<î3‡î6Ãî75î;Û
î=¸
î?•îEêîJÂîJÂïBñî/ïAîGîè
î!Œî$8î(8î*wî-Óî1rî4—
î6$î8cî:«î?îC\îH<C3AE>îJÁîJÁïAî/ï?TîÊîOî”î"î&Qî);î+¸î0î2Áî7çî;4îC:îCÞ
îEŠîEŠï?Ttï?TîHï?Trï?TîH²îJÁîJÁï?Tî/ï=<3D>îî!Üï=<3D>î	ôï:tî¬ï:rï:î/îzîÝîA
î ¬î"éî&D
î'Ðî'Ðï:tï:î1äï:rï:î2 î6žî9I
î:“î:“ï:tï:î=ï:rï:î=Ó
î?_îCHîF
îGG
îH<C3AE>îJÁîJÁï:î/ï8=î<1B>î-î¢î¢ï8=sï8=î"î%tî'R
î,rî.¨î1÷î4ö
î6	î7çîAlîCñîHîîJ¯îJ¯ï8=î/ï6sî•îâï6srï6sîèï6sî	ôï3tîþï3rï3î/îoîÆî
î ~î ~ï3tï3î!Uï3rï3î!­
î"àî%î)Ö
î+î/Ãî2(î3Ôî3Ôï3tï3î=èï3rï3î>@
î?~îB=ï3tï3îDÂï3rï3îEï3î	ôï/ˆt	îZï/ˆrï/ˆî/îôî"î#…î&Í	î-cî0Âî4Ñî8¨î;
î=u
î>äîBXîEîHœîJÂîJÂï/ˆî/ï-µîšîî ¾î%Ÿî(Žî)
î,î/D
î0©î5Qî:À	î@ÒîCîE_îE_ï-µtï-µîJiï-µrï-µîJÁîJÁï-µî/ï+âî›îî! î$<24>î&Éî+`î-„î3
î4¬	î:Ãî><
î?ÜîCÏîG]îJÁîJÁï+âî/ï*îUîCî  
î'Aï*î/ï'4tîçîçï'4xï'4î"µï'4tï'4î#Œï'4rï'4î'¸î'¸ï'4tï'4î,Âï'4rï'4î-
î.Xî0žî0žï'4tï'4î3#ï'4rï'4î3€ï'4î/ï$Gtî•î•ï$Gxï$Gî$cï$Gtï$Gî%:ï$Grï$Gî'¸î+(î-
î.Tî0¥î0¥ï$Gtï$Gî5¯ï$Grï$Gî6
î7Eî7Eï$Gtï$Gî;xï$Grï$Gî;Ð
î=fî=fï$Gtï$Gî@Âï$Grï$GîAï$Gî/ï!Ztî•î•ï!Zxï!Zî$cï!Ztï!Zî%:ï!Zrï!Zî'¸î*úî-+î0î2
î3Cî5”î5”ï!Ztï!Zî:žï!Zrï!Zî:ö
î<4î<4ï!Ztï!Zî@gï!Zrï!Zî@Äï!Zî/ïmt
î!Cî!Cïmxïmî&ïmtïmî&èïmrïmî'¸î,Ôî.Â
î0î2Qî2Qïmtïmî7[ïmrïmî7³
î8ñî8ñïmtïmî=ûïmrïmî>«î>«ïmtïmîBïmrïmîB_
îCõîCõïmtïmîHÿïmrïmîI\ïmî/ï€t
î!Cî!Cï€xï€î&ï€tï€î&èï€rï€î'¸î*úî-+î1åî3Ó
î5î7bî7bï€tï€î<lï€rï€î<Ä
î>î>ï€tï€îCï€rï€îCiï€î/ï“t	î lî lï“xï“î%:ï“tï“î&ï“rï“î'¸î-
î.Ëî2Jî4i
î5Øî8Zî8Zï“tï“î=dï“rï“î=í
î?\î?\ï“tï“îDfï“rï“îEFîEFï“tï“îH¢ï“rï“îHú
îJ<C3AE>îJ<C3AE>ï“î'¸ïÀtî,ÂïÀrïÀî-€î-èî-èïÀsïÀî0Dî2H
î3Vî9Úî;ªî>_
î?¢
îGÞîJ¯îJ¯ïÀî'¸ïíî)yî+½î/Êî2ü
î48î8Úïírïíî8àïíî/ï	t
î#Èî#Èï	xï	î(–ï	tï	î)mï	rï	î,®î0_î2M
î3‹î5Üî5Üï	tï	î:æï	rï	î;>
î<|î<|ï	tï	îA†ï	rï	îAÞ
îCtîCtï	tï	îFÐï	rï	îG-ï	î/ït	î lî lïxïî%:ïtïî&ïrïî'¸î+­î-Þ
î/_î1Ó
î3¬î8ªî:Û
î<\
î>xîADîCÂ
îEC
îFñîJ~îJÖîJÖïî'¸ï
Iî+©î/#î1•î4jî6nî7kî:jî>ýï
Iÿ©
êq?€`½”12ACCESSAccessfieldforreferringtotheACCESSBITSfieldsymbolically.ItsvalueisoneofthelegalvaluesoftheACCESSargumenttoOPENFILE:INPUT,OUTPUT,BOTH,APPEND;orNILwhenthestreamisclosed.ReplacingthisfieldhasthesideeffectofsettingtheBINABLE,BOUTABLE,STRMBINFNandSTRMBOUTFNfieldsappropriately(fromthecorrespondingdevicefields,ortovaluesconsistentwithnoaccess).USERCLOSEABLEFlag,trueifthestreamcanbeclosedbyCLOSEF.DefaultisT,butisNILforsuchthingsasdribblefilesandtheterminal.USERVISIBLEFlag,trueifthestreamistobelistedintheresultof(OPENP).DefaultisT,butisNILforsuchthingsasdribblefilesandtheterminal.BINABLETrueifBINmicrocodecanbeused.NormallysetautomaticallyfromFDBINABLEwheninputaccessisset.BOUTABLETrueifBOUTmicrocodecanbeused.NormallysetautomaticallyfromFDBOUTABLEwhenoutputaccessisset.EXTENDABLETrueifBOUTcanextendthebufferwhenCOFFSETreachesCBUFSIZE.Obsolete.STRMBINFNFunctioncalledbyBIN.ThisisnormallysetindirectlyasasideeffectofsettingtheACCESSfield.SettingACCESStoaninputaccess(INPUTorBOTH)setstheSTRMBINFNtobethestream'sdevice'sBINmethod.SettingtoanyotheraccesssetstheSTRMBINFNtobea``filenotopen''trap.STRMBOUTFNFunctioncalledbyBOUT.AswithSTRMBINFN,thisisnormallysetindirectly(fromthedevice'sBOUTmethod)asasideeffectofsettingtheACCESSfield.OUTCHARFNFunctioncalledtooutputasinglebyte.ThisislikeSTRMBOUTFN,exceptforbeingonelevelhigher:itisintendedfortextoutput.Hence,thisfunctionshouldconvert(CHARCODEEOL)intothestream'sactualendoflinesequence,andshouldadjustCHARPOSITIONappropriatelybeforeinvokingthestream'sSTRMBOUTFNtoactuallyputthecharacter.Defaultsto\FILEOUTCHARFN.TheOUTCHARFNforthedisplayadditionallyworriesaboutsuchthingsasECHOCONTROL.CHARPOSITIONCurrenthorizontalcharacterpositioninthestream.Incremented(andresettozero)byOUTCHARFN.UsedbythefunctionPOSITION.LINELENGTHMaximumlinelengthofthestream,incharacters.UsedbythefunctionLINELENGTH.Defaults(atcreationtime)tothevalueoftheglobalvariableFILELINELENGTH.EOLCONVENTIONThestream'sendoflineconvention:themannerinwhich``endofline''isencodedonthisstream.Thatis,outputofanendofline(functionTERPRI)producesthestream'sendoflinesequence,andoninput,thestream'sendoflinesequenceisconvertedto(CHARCODEEOL)byREADC.Thisisnotnecessarilythesameasthewaythatendoflineisencodedintheactualfilewrittenby,say,afileserver.Forexample,LispmightopenastreamtoaTenexfileserverwithEOLCONVENTIONofCR,whiletheservermightchoosetotakeeachoftheCRsinthestreamandactuallystoreaCR,LFsequenceinthephysicalfile.î>ýï
Iî
êïførî	ôïhsp
îLïhsî	ôïb
tîþïb
rïb
î/îsîwî Šî&

î'‘î)Æî)Æïb
tïb
	î2,ïb
rïb
î2ˆî5Œî=“î=ïî?ÁîC?
îD<C3AE>îG
îH‘îJÂîJÂïb
î/ï`.îNîU
îéî"#î"#ï`.xï`.î&£ï`.rï`.î'î-
î.<2E>î.<2E>ï`.tï`.î5Hï`.rï`.î6"î6"ï`.tï`.î:Uï`.rï`.î;î;ï`.tï`.î@ï`.rï`.î@Ñî@Ñï`.tï`.îD-ï`.rï`.îDæîDæï`.tï`.îIðï`.rï`.îJÁîJÁï`.î/ï^[
îÑîÑï^[tï^[îVï^[rï^[î»îNî!Œî%Ú
î'%î+…î+êî2;î4ºî7Çî:î<Xî?îB·
îDOîH<C3AE>îJÁîJÁï^[î/ï\ˆtîï\ˆrï\ˆîÚîÚï\ˆtï\ˆî$’ï\ˆrï\ˆî%[î%[ï\ˆtï\ˆî,êï\ˆrï\ˆî-[î/ýî/ýï\ˆtï\ˆ	î8cï\ˆrï\ˆî8Ôî<qîDÇîH‘îJÂîJÂï\ˆî/ïZµîðî$î'à
î)v
î*öî.ô	î5î8
î9Úî>6ïZµî	ôïWDtîßïWDrïWDî/î¥î‚
îÞî!8î%¢î('
î*î.9
î00î00ïWDtïWDî5:ïWDrïWDî6î6’î;Š
î<ñî<ñïWDtïWDî=ÈïWDrïWDî> îA
îB‚îB‚ïWDtïWDîEïWDrïWDîEˆîG¿îJÁîJÁïWDî/ïUqî
î˜î!/î#íî&vî(§î-óïUqî	ôïRt
î1ïRrïRî/îî6
îlî Ÿî$ã
î&#
î'¦
î)kî,ç
î.iî0<C3AE>î4:
î5Èî5ÈïRtïRî;©ïRrïRî<Zî<µîA†
îBÇîBÇïRtïRîCžïRrïRîDPîF¥
îGåîGåïRtïRîJjïRrïRîJÂîJÂïRî/ïP-î>î@î (
î!©î&@î(þî+‡î-¸î2þïP-tïP-î3ïP-î	ôïL³î/î/ïL³rïL³î–
îîïL³tïL³îˆïL³rïL³îî%Ïî(f
î*dî.î.”î4Éî6òî?hîBÚîBÚïL³tïL³îJiïL³rïL³îJÁîJÁïL³î/ïJàîµî/î"

î#Kî%?ïJàî	ôïGotî/î/ïGorïGoîs
î¼î¼ïGotïGoîïGorïGoî‡î&î(‹
î*dî-ßî.Mî4^î6cî>¶îBîBïGotïGo	îJjïGorïGoîJÂîJÂïGoî/ïEœîµîõî"Ó
î$î&ïEœî	ôïB+t	î/î/ïB+rïB+î\
î<1B>î<1B>ïB+tïB+îëïB+rïB+îCî! î%ìî(î,î/¢î/¢ïB+tïB+î5ƒïB+rïB+î5Ûî:Šî:ŠïB+tïB+îABïB+rïB+îAñîBIîGÖïB+î	ôï>±tîƒï>±rï>±î/î
î ÷
î"ìî"ìï>±tï>±î%qï>±rï>±î&Fî&Åî)Ö
î+:î0ÿî3	î9&
î:Îî;òî>ÁîB„
îD6îH‘îJÂîJÂï>±î/ï<Þtî9ï<Þrï<Þîî íî!Èî&Áî&Áï<Þtï<Þî+Ëï<Þrï<Þî,¦
î.©
î0îî4ëî9Lî9Åï<Þtï<Þî=øï<Þrï<Þî>Ò
î@ëî@ëï<Þtï<ÞîDGï<Þrï<ÞîE›îH<C3AE>îJÁîJÁï<Þî/ï;tî¾ï;rï;î3
î Ð
î"±î$ÿî*9î/Gî/Gï;tï;î1Ìï;rï;î2Aî7<C3AE>î8î<™
î>6î@ÇîDSîHNîJÁîJÁï;î/ï98î`î`ï98tï98î ïï98rï98î!G
î"Ç
î$Šî%‡î(qî*·î.ªî1dï98î	ôï5¾t	îZï5¾rï5¾î/î
î ø
î"íî"íï5¾tï5¾î&Iï5¾rï5¾î' î'Ÿ
î)ªî,¼î,¼ï5¾tï5¾î4Kï5¾rï5¾î5#î7¼
î9"î>çî@þ	îGîJÁîJÁï5¾î/ï3ëî`îPîPï3ëtï3ëî!¬ï3ërï3ëî"î'W
î(Øî)Õî,~î0
î1¥î5Úî8î8ï3ëtï3ëî=ï3ërï3ëî=mî@rï3ëî	ôï0qtîƒï0qrï0qî/îäî «
î",î&mî'kî+'î.`î.ºî1¥
î2äî5`î5`ï0qtï0q	î=Æï0qrï0qî>wîB˜îD¨îHDîJÁîJÁï0qî/ï.žî«îª
î!9
î"Þî(Ïî+Eî.4î32î3ñî8Ñî;ªîAXîFîJÁîJÁï.žî/ï,ÔtîÇî##ï,Ôrï,Ôî#¬î&†î(éî.8î2<î4÷
î6´î9mî?®îBiîFäîJÁîJÁï,Ôî/ï+
tî!Cï+
rï+
î!·î*î.Kî3ãî60î;iî;iï+
tï+
	îCÏï+
rï+
îDC
îEÞîJÂîJÂï+
î/ï).î¦îü	î"/î"¬î($
î)Éî)Éï).tï).
î5‹ï).rï).î6_î6Üî9ªî9ªï).tï).îA9ï).rï).îA¶îCêîF@îJÁîJÁï).î/ï'[îƒî#%î&Öî)Øî-À
î/Aî/Aï'[tï'[
î8~ï'[rï'[î8Ûï'[î	ôï#átîï#árï#áî/î3	î"†î(Eî-[
î.ãî1î5»î6
î=õî@ÿîD
îE¦îHó
îJÁîJÁï#áî/ï"tî¾ï"rï"îmîÅî#*
î$øî')î,pî,pï"tï"î3(ï"rï"î3…ï"î	ôï”t	îZï”rï”î/î«î 3î$=
î%Èî'úî,“
î.
î4§î4ÿî8e
î:3î<eîA¬îA¬ï”tï”	îJï”rï”îJÁîKîKï”î/ïÁî‚îfî#vî&å
î(eî*–î.
î/›î1Ìî5½î:Âî:ÂïÁtïÁ
îF„ïÁrïÁîFáïÁî	ôïGtî/î/ïGrïGîìîî!º
î#Yî%ô
î-^î/¤î4“
î6'î:î=e
î?îBO
îC¡îHé
îJÁîJÁïGî/ïtî®îSî¸î!Ýî#€î'Í
î)e
î+6î-Ì
î/dî1øî7Æî7Æïttïtî<Ðïtrïtî=®îCfîE¤îJÁîJÁïtî/ï¡îà
î“îBî$zî'+
î)+î-&î/î4Äî7u
î9)î;ØîA·
îCîIA
îJÁîJÁï¡î/ï×tî¢î"þï×rï×î#d
î%@î%@ï×tï×î)sï×rï×î*/î*•î-<2D>
î.Øî1,
î7áî:î=|
î?îAIîD
îF­îI6
îJÁîJÁï×î/ïîÅ
îî j
î!ùî$:î(î*eî.öî1,î3Äî4Ñî7î;_î;Æî>RîD
îFúîJÁîJÁïî/ï:î¥îÖî K
î!ÿî#/î'aî)Ïî-áî1î1ï:tï:î;ëï:rï:î<v
î>5î>5ï:tï:
î?ãï:rï:î@ÇîDîFãîJÁîJÁï:î/ïgîùîR
î Öî#¤î&ª
î(9î*mî*mïgtïg
î,ïgrïgî,û
î.î0´î4ùî7…î<mî?žî@Ÿî@Ÿïgtïg
îBMïgrïgîC
îC
ïgtïg
îD¯ïgrïgîE
îJÁîJÁïgî/ï”
î¯îàîûî":ï”	y
êq?€`½613Theconventionisencodedasatwo-bitfield;theconstantsCR.EOLC,LF.EOLC,CRLF.EOLCcanbeusedtorefertothecurrentlyknownvaluessymbolically.DefaultinInterlisp-DisCR.EOLC.ENDOFSTREAMOPFunctionofoneargument(thestream)calledwhenanattempttoreadbeyondtheendoffileoccurs.Ifthisfunctionreturnssomething,itshouldbeinterpretedasavaluetoreturnfromBIN(thevalueTiscurrentlyprohibited).Defaultsto\EOSERROR,whichcausesanENDOFFILEerror.VALIDATIONPointerfield,somecompactencodingofthestateofthefilesuchthatifthefile'scontentchanges,theVALIDATIONchanges.Thefile'sICREATIONDATEattributeusuallyworkswellenough.TheonlyuseforthisfieldistocheckwhetherthefilechangedoverLOGOUT,etc.iftheVALIDATIONofthestreamreturnedfromREOPENFILEisEQUALtotheVALIDATIONofthestreamopenbeforeLOGOUT,thestreamisassumedtobeunchnaged.Thiswillprobablybethesoleconcernofthedevicewhenwegotomultiplestreamsperfile.BYTESIZEBytesizeofthefile,i.e.,whatBINandBOUTtrafficin.Defaultsto8.Thisfieldisnotusedbymany;thereareprobablyalotofthingsthatwon'tworkifthebytesizeisnot8.OTHERPROPSListinpropertylistformatusedbythefunctionSTREAMPROP.AnalogoustoWINDOWPROP,etc.IMAGEOPSImageoperationsvector(objectoftypeIMAGEOPS)foruseofdevice-independentgraphicsoperations,suchasDSPXPOSITION,DSPFONT.Defaultsto\NOIMAGEOPS,avectorsuitablydefinedfornon-displaydevices.Seetheimplementors'manualchapterDevice-IndependentGraphics.IMAGEDATADevice-dependentdataforusebyIMAGEOPS.REVALIDATEFLGFlag.Thestandarduseofthisflagistosolveaproblemwithcorrectlymaintainingthecreationdate.Theproblemisthatthedefinitionof``creationdate''isthatthecreationdatechangeswheneverthecontentsofthefilechange.Iffollowedliterally,thiswouldmean,forexample,thatevertimeyouwroteoutapageofa{DSK}file,youwouldalsohavetorewriteitsleaderpagewithanewcreationdate.However,itsufficesinpracticetoonlychangethecreationdatewhenitwouldmatter,i.e.,whentherewouldbeanypossibilityofsomeagentotherthanthecurrentlyrunningLisptoseethechange.Usually,thismeanstheonlytimetoworryaboutiswhentheLispvmemissavedandafilethatwasopenbeforethesaveiswrittentoagainafterwards.Thus,theuseofthisflag(forthosedevicesthatcare)isasfollows:thedevice'sBEFORExxxeventssetthisflagtrueforanystreamsopenonthedevice.Then,wheneverthedeviceisabouttodosomethingthatwouldchangethefile'scontent,e.g.,writeoutanewpage,itfirsttestsREVALIDATEFLG.Iftheflagistrue,itupdatesthefile'screationdateandclearstheflag.NONDEFAULTDATEFLGFlag.StandarduseisinconjunctionwithREVALIDATEFLG,tomarkafilethatwasopenedinawaythattheuserconstrainedthecreationdateofthefile(e.g.,thePARAMETERSargumenttoOPENFILEincludedanexplicitcreationdate,ortheoptionDON'T.CHANGE.DATE).î":ï”î
êïførîIïhsp
îJjïhsî/ïb
rî3	î!l
î#î(©
î*†î+Þî0Æî4›î7'î=Dî=Dïb
tïb
îC%ïb
rïb
îD0îD0ïb
tïb
îJïb
rïb
îJÁîJÁïb
î/ï`.tî¾ï`.rï`.î*î!›
î#qî&’
î(&î+]
î,ñî/6î4õî9^î=pîE‡îEòîJÁîJÁï`.î/ï^[
î¯
î<1F>
î Ëî Ëï^[tï^[î&¬ï^[rï^[î'	ï^[î	ôïZátîßïZárïZáî/îï
î‡î!î'î)Íî.“î2fî5ù
î7Èî<°
î>=îA5îEûîH8îJÁîJÁïZáî/ïY
îÍîî™î 
î!nî#óî)Nî-ä	î4À
î5üî:Y
î<0
îC"
îD·îEÇîIA
îJÁîJÁïYî/ïWDî:îîïWDtïWDî!ïWDrïWDî!iî$ î'§î'§ïWDtïWDî(~ïWDrïWDî(ã
î*-î/åî7Gî7¬î=
î>™î>™ïWDtïWDîF(ïWDrïWDîFäîJÁîJÁïWDî/ïUqî9
îüîüïUqtïUqî X
î"Ýî&9ïUqrïUqî&‘î)ÙïUqî	ôïQ÷t	îZïQ÷rïQ÷î/îî¿î#nî)î/
î0Øî3Tî6¢
î8xî:ôî=yî@ÇîC±
îE/îG«îJÁîJÁïQ÷î/ïP$î0î!Ìî$Fî$FïP$tïP$	î,¬ïP$rïP$î-Lî2èî3ˆî6zî9Øî9ØïP$tïP$îDÃïP$rïP$îEcîJÁîJÁïP$î/ïNQîíîûî"õî(Bî(Öî+¼î.âî1fî3²î6`î9<C3AE>
î;
î<Ôî@ÁîFîHˆîJÂîJÂïNQî/ïL‡îûî sî sïL‡tïL‡î%}ïL‡rïL‡î&»î+àî.Ÿî.ŸïL‡tïL‡	î7ïL‡rïL‡î7ë
î:î<ÃîA’îG‰îJÁîJÁïL‡î/ïJ´t	î•ïJ´rïJ´î 

î!dî!dïJ´tïJ´î%—ïJ´rïJ´î&
î'§î)õî)õïJ´tïJ´	î2[ïJ´rïJ´î2Ï
î4vî6Ãî;!î>€îB»îB»ïJ´tïJ´îGÅïJ´rïJ´îH‘îJÂîJÂïJ´î/ïHáî‚
îÒî"C
î#Õ
î%ª	î,Ýî-Gî-GïHásïHáî/®î1½î6P
î7Ëî9žî;Çî?Ó
îA!îBôîFJîI
îJ¯îJ¯ïHáî/ïG
î—
îÊîî!Ôî#¦î%nïGrïGî%tïGî	ôïC¦tî¬ïC¦rïC¦î/î>îÈ
îaî Ÿî#?î%²î(îî(îïC¦tïC¦î+sïC¦rïC¦î+Ùî.pî.pïC¦tïC¦î1ÌïC¦rïC¦î22î6î8î8hî=É
î?W
î@ÄîA*îD"îG0
îH{îJÁîJÁïC¦î/ïAÓî<
î
î î#yî%Ÿî+>î,;î.
î/¨î3<C3AE>î6/î9Êî=
î>Jî@{îC\îEØ
îGîI\
îJcïAÓtïAÓîJiïAÓî	ôï>Y	î/î/ï>Yrï>YîJ
îSî"Eî$Üî)±î-G
î/žî2Xî8(î8(ï>Ytï>Y	î@Žï>Yrï>YîAÆîB§îIA
îJÁîJÁï>Yî/ï<†t	î•ï<†rï<†î Eî"Oï<†î	ôï9tî/î/ï9rï9î{	î"Aî&<26>î+.
î-î04î04ï9tï9î6ìï9rï9î8
î:fî<ú
î>ÑîJÁîJÁï9î/ï79î|
î#_î&q
î(î(ï79tï79î2ï79rï79î2×î2×ï79tï79î8¸ï79rï79î9xî9àî?D
î@Ôî@Ôï79tï79
îJï79rï79îJÁîJÁï79î/ï5fî<18>îâî"2î'cî)Ó
î1uî6Åî7î:Hî<ÛîFîJÁîJÁï5fî/ï3œîéîéï3œzï3œî'Öî-ï3œrï3œî-xï3œî	ôï0
tîƒï0
rï0
î/î"Oî%%î'4î){
î+Iî+Iï0
tï0
î2
ï0
rï0
î2°î2¶ï0
î	ôï,<2C>tîßï,<2C>rï,<2C>î/îˆîìî¢î#î%k
î'î)<29>î,
î-`
î.ìî2Fî3Oî8­î;¥îA$
îH‘îJÂîJÂï,<2C>î/ï*½îOîŒîôî"­î(
î)]î,î.M	î4s
î6	î;Þî?t
î@ÂîCqîE²îJÂîJÂï*½î/ï(óîî î%4î'tî,Á
î.[î0œî2åî7Äî8+
î9<C3AE>î?	îDDîFÅîJÂîJÂï(óî/ï')îî.î"Òî%uî(Nî+Hî-Ôî1~î3Çî4Èî7ä
î9sî:sî:sï')tï')î>¦ï')rï')î?îA˜îD$îH$îJÁîJÁï')î/ï%VîK
îÏî Jî!ùî%ðî)î+úî,ûî/¿î4Òî8î8_î>f
î?’îDO
îEÒîJÂîJÂï%Vî/ï#Œ
îÐîÛî uî"Çî'øî*ðî.—
î/àî3ÿî8£î;)î>ÑîBLîFj
îHNîJÁîJÁï#Œî/ï!Â
îÉ
î¢î#Uî')î*æî.,î0«î6¤î;øî?1
î@ÿîCsîEòîJÁîKîKï!Âî/ïøîjîåî#î%=î(1î+0
î,¹î0‰î4D
î5‹î9î;Tî>HîBP
îC—îG<îIÅîJÂîJÂïøî/ï.îiîî†î!Éî%èî(î*ï
î,-î0¯
î2/î5©
î<+ï.î	ôï½î/î5îÇî n
î"Yî%,î(î*üî.Ìî3Äî6Äî:]
î;û
î=ÝîC@îEÑîJÁîJÁï½î/ïótî¾ïórïóîoî#Óî&î(çî+Éî.×î1@î4
î9+î<È
î>úîA„îFIîFúîJÁîJÁïóî/ï î;îtî#<23>
î$×î(<28>
î*
î+ùî2qî5î9î=žî?×îBõîHîJÁîJÁï î/ïVî”îòîî ßî$g
î%§î(hî+aî+aïVtïVî6LïVrïVî7î7‚
î8ïî;8î=Ø
î?.îBS
îC“îH<C3AE>îJÁîJÁïVî/ïƒîEîUî"+î$´î(Zî*‹î-ïƒî	ôïtî;ïrïîÖî,îŽî"Dî$–
î%Þ
î'h
î.¼î1±î1±ïtïî<œïrïî=W
î>áîBOîCVîEšîHCîJÁîJÁïî/ï?î<
îîxî"‚î%€î(î+;
î2»î5Kî:»î=ð
î?ÛîBkîEîH<C3AE>îJÁîJÁï?î/ïux	îïurïuîvî%‚
î'î'ïutïuî-Íïurïuî.8î3¾
î5”î:Hî?kîB¬
îDUîF™îJÁîJÁïuî/ï
¢tî%vï
¢rï
¢
î&Lï
¢ÿ

êq?€`½£14F1,F2,F3,F4,F5Pointerfieldsforprivateusebythestream,tomaintainstream-specificstateofconcernonlytothedevice.StreamclientsthatwishtohanginformationonastreamwithoutregardtowhatkindofstreamitisshouldusethefunctionSTREAMPROP.FW6,FW7,FW8,FW916-bitwordfieldsforprivateusebythestream.DIRTYBITSObsolete.EXTRASTREAMOP?BufferedStreamsBufferedstreamsareonesthatconstrainthemselvestoobeyasetofconventionsthatmakeiteasyforanagent(e.g.,microcode)toperforminputoroutputonthestreamwithoutknowingaboutthedetailsofthestream'sphysicali/o.Thestreammaintainsa``currentbuffer''andtwoindicesintothatbuffer,theoffsetofthenextbyte,andtheoffsetoftheendofthebuffer.Aslongastheformerindexislessthanthelatter,thestreamguaranteesthatthebytesinthebufferbetweenthoseindicesarethetruecontentsofthefile/streamstartingatthecurrentfilepointer.Advancingthefirstindexeffectivelyadvancesthefilepointer.Whenitreachesthesecondindex,astream-specificoperationiscalledto``refill''thebuffer.Thefollowingfieldsareusedbybufferedstreams:COFFSETByteoffsetinthebufferCBUFPTRofthenextBINorBOUT.CBUFSIZE``Size''ofthecurrentbuffer,i.e.,byteoffsetthatisonebeyondthelastbyte.CBUFMAXSIZEForoutput,themaximumsizethebuffercanbewrittento.IfCOFFSETreachesCBUFSIZE,butCBUFSIZEislessthanCBUFMAXSIZE,thenthebuffercanbeextended.CBUFPTRPointertocurrentbuffer.MustbevalidifCOFFSETislessthanCBUFSIZEandBINABLEorBOUTABLEistrue.Itisnotnecessarythatthis``buffer''beanythingotherthansomechunkofmemory,aportionofwhichcontainsinterestingdata.Thus,thebytesfromoffsetCOFFSETtoCBUFSIZEmustbevalid,butCOFFSETneednotstartatzero,norneedCBUFSIZEorCBUFMAXSIZEcoincidewiththeendoftheunderlyingstructure.CBUFDIRTYFlag,trueifcurrentbufferhasbeenwrittento.Ingeneral,thedevicehassoleresponsibilityforsettingCBUFSIZE,CBUFMAXSIZE,andCBUFPTR;genericcodedoesnottouchthose.ThefieldsCOFFSETandCBUFDIRTYcanbechangedbygenericstreamclientsaswellasbydevice-specificcode.Forexample,codethatsimulatesaBINincrementsCOFFSET;codethatwritesdirectlytothestream'sbuffersetsCBUFDIRTYtrue.Thefollowingmethodsaredefinedfordevicesimplementingbufferedstreams:(GETNEXTBUFFERSTREAMWHATFORNOERRORFLG)[Devicemethod]CalledwhenSTREAMneedstohaveitsbufferfixed,i.e.,thestateofSTREAMissuchthatBIN(WHATFOR=READ)orBOUT(WHATFOR=WRITE)cannotproceed.Thismethodshoulddoî&Lï
¢î
êïførî	ôïhsp
îLïhsî	ôïb
t
î¢ïb
rïb
îRîRïb
tïb

îïb
rïb
î°î°ïb
tïb

î^ïb
rïb
îîïb
tïb

î¼ïb
rïb
îlîlïb
tïb

îïb
rïb
îrî/îÖî`î!uî%çî(3
î*î,>î0Ý
î2bî7ñîAîD
îE©îJ¤îJ¤ïb
î/ï`.î;
îÝî0î"¾î#8î'Ýî,î.Ôî1÷
î3™î6ô
î>l
î@fîA…îEèîJÁîJÁï`.î/ï^dîO
îÏîýî"ý
î$ˆî(É
î)ñ
î+/î/yî1Àî3ñî98î98ï^dtï^d	îAžï^drï^dîAûï^dî	ôïZêtîyïZêrïZêî
)î
)ïZêtïZêî®ïZêrïZêî^î^ïZêtïZêîãïZêrïZêî“î“ïZêtïZêîïZêrïZêî/îöîOî!Óî#âî(Nî*•
î,cî.”î2ÔïZêtïZêî3«î4‚î4‚ïZêyïZêî4ˆïZêî	ôïWptîƒïWprïWpî/î¼ïWpî	ôïSötîßïSörïSöî/îÃïSöî	ôïOavîcî(ïOarïOaî.ïOaî	ôïK¹î‚îJîtîyîî!Ô	î(–
î*î-Jî.Kî0>
î1Ì
î91î;Ôî?]
î@ˆîCbîEu
îG;îJÁîJÁïK¹î	ôïIïî
4	î;
îÏî
î˜
î Bî$–
î&‚î(Çî-î2	î7„î;Iî=ŽîAÀ
îC_îE¤îJÁîJÁïIïî	ôïH%î#î²îîÛî0îQî bî%¿î*‚î-î/°î4/î6ëî9žî>	î@NîCý
îEœîGáîJÂîJÂïH%î	ôïF[î
OîûîNî
î¹î
î¸
îfî ºî%2î%­
î'²î*¿
î,bî.¶î3:î6÷
î8Xî:áî=ûî@NîD-îF€îJÁîJÁïF[î	ôïD‘	î•î7îkîÔ
îWî‹î <20>î%Ïî)Aî-¯î/Øî2î4Åî:
î;“î=Ç
îD<EFBFBD>îIV
îJÁîJÁïD‘î	ôïBÇî=îîîAîGî·î<1F>î!Ëî$Œî(?
î.¼î4vî6¿î9î>î>ˆîB‰
îCÉîH<C3AE>îJÁîJÁïBÇî	ôï@ýîUîHîEî_î"U
î#“î'Y
î(Ù	î-Yî/Šî3Žï@ýî	ôï=Œî<0C>î{îÿî%î2
îî"jî'Vï=Œî	ôï:tî/î/ï:rï:î0îË
îKî!|î%{î%{ï:tï:î+\ï:rï:î+´
î-?î/pî2Qî2Qï:tï:î4Öï:rï:î5.
î6Äî6Äï:tï:î: ï:rï:î:}ï:î	ôï6¡tî/î/ï6¡rï6¡îM
îØî	î#¢î'ùî*^î-?î0Úî3y
î4·î74î;íî>î@oîCUï6¡î	ôï3't
î/î/ï3'rï3'îùîßî!^î'üî*Æî-Eî1’î4=
î6Nî;î=Cî=é
î?Œî?Œï3'tï3'îEmï3'rï3'îFîJÂîJÂï3'î/ï1Ttîçï1Trï1Tîî!çî!çï1Ttï1Tî(Ÿï1Trï1Tî)w
î+4î.î1<C3AE>î1<C3AE>ï1Ttï1T
î:Íï1Trï1Tî;ýî?sîB#îF¡îHþ
îJÁîJÁï1Tî/ï/<2F>îëï/<2F>î	ôï,tî/î/ï,rï,î
îéî"Îî'pî(î+Å
î-Õî1X
î2×î2×ï,tï,î8¸ï,rï,î9\
î:æî=™î@Üî@Üï,tï,îG”ï,rï,îH8îJÁîJÁï,î/ï*=tîï*=rï*=îl
îîï*=tï*=î%¾ï*=rï*=î&
î']î*mî*É
î,
î-Zî/¤î5‹î8.î:¥	î@
îAÏîGRîJÁîJÁï*=î/ï(jîJîÑî!ó
î#¢î)[î*|î/L
î0úî4ûî:P
î@úîDKîDÇîH<C3AE>îJÁîJÁï(jî/ï& îªîùî!«î!«ï& tï& î'Œï& rï& î'ú
î)‘î)‘ï& tï& î0Iï& rï& î0¸î4
î5áî9‡î;ïî;ïï& tï& îAÐï& rï& îB?îE„îGàîJÁîJÁï& î/ï$Í
î'îßîÈî#ƒî#ƒï$Ítï$Íî*;ï$Írï$Íî+ 
î-Cî-Cï$Ítï$Í
î6€ï$Írï$Íî7eî=-î@¥îCcîFy
îH<C3AE>îJÁîJÁï$Íî/ï"ú	îì	î#|ï"úî	ôï‰tî/î/ï‰rï‰î|î1
îdî"ýî&üî)Cî,qî0óî2rï‰tï‰î2xï‰î	ôïr
î±îÇîîBî¤î]
î$³î&Ýî+-î+-ïtïî1åïrïî2°î2°ïtï
î;íïrïî<¸î?\î?\ïtïîE=ïrïîF)îJÁîJÁïî	ôï<î
îî]îîÐî+îØî _î _ï<tï<î&@ï<rï<î&œî))î))ï<tï<î0¸ï<rï<î1î3t
î5:î:|
î<Mî@éîE-îI@
îJÁîJÁï<î	ôïiîé
î 
î¥îÈîlîûî ­î&ƒî)Ñî,¦î2¨î3Ûî3Ûïitïiî6`ïirïiî6î	î=îî=îïitïiîCÏïirïiîDÖîH#îJÂîJÂïiî	ôï–î
Æî‰
î	î:îWîVî!Éî!Éï–tï–î)Xï–rï–î)°î,jï–î	ôïî<0C>î{îÙîÿîÎî Ýî%uî-ÿî3iî8Uïî	ôï«t
î<16>î<16>ï«xï«î[ï«tï«î2î2ï«xï«î"ï«tï«î"éî"éï«xï«	î*Ùï«tï«î+°ï«rï«î@ºîEˆîJlï«tï«îObï«î‘ï¾rîòî°î°ï¾xï¾î~ï¾rï¾îî!ù
î#±î'
î(åî-î0ûî3˜î6
î9;
î:ÿî:ÿï¾xï¾î?Íï¾rï¾î@]
îAÓîE
îGäîGäï¾tï¾îJiï¾rï¾îJÁîJÁï¾î‘ï
ëî
ï
ëxï
ëîêï
ërï
ëî}îpîpï
ëtï
ëîÌï
ërï
ëî×
î¨î¨ï
ëtï
ëî#ï
ërï
ëî#—î$ï
ëxï
ëî)ðï
ërï
ëî*ƒî,vî,vï
ëtï
ëî0©ï
ërï
ëî1µî6;î;Óî<fî?‹îDŸîHé
îJÁîJÁï
ëÆ
êq?€`½h15whateverisnecessarytoallowtheoperationtoproceed.Thistypicallyincludesdisposingofthecurrentbuffersomehow(ifGETNEXTBUFFERwasinvokedbecausethebufferwasexhausted),andfetchinganewbufferconsistentwithSTREAM'scurrentposition.InthecaseofWHATFOR=READ,GETNEXTBUFFERreturnsTonsuccess,i.e.,ifSTREAMisnotatendoffile.WhenSTREAMisatendoffile,GETNEXTBUFFERshouldtakestandardendofstreamaction,returningwhatever\EOF.ACTIONreturns(ifanything).However,ifNOERRORFLGistrue,GETNEXTBUFFERshouldjustreturnNILimmediately.(RELEASEBUFFERSTREAMBUFFER)[Devicemethod]Performsanydevice-specificoperationrequiredwhenBUFFER,whichisthecurrentvalueofSTREAM'sCBUFPTRfield,is``released''(whentheCBUFPTRfieldisreplaced).Thisisusedsothatdifferentpagemap-likedevicescansharecertaincode.Forexample,inthecaseofpagemappedstreams,RELEASEBUFFERmarksthebufferdirtyinthecasethatthestream'sCBUFDIRTYfieldhasbeenset.Thismethodisnotcurrentlyused.Thefunctions\BUFFERED.BIN,\BUFFERED.PEEKBIN,\BUFFERED.BOUT,\BUFFERED.BINSand\BUFFERED.BOUTSaresuppliedforusebybufferedstreams;theyarestandardlyusedtoimplementtheBIN,PEEKBIN,BOUT,BLOCKINandBLOCKOUTdevicemethods.Inaddition,thefunctionCOPYBYTES,whenpresentedwithasourcestreamthatisbuffered,utilizestheGETNEXTBUFFERmethodtoefficientlycopybytestothedestinationabuffer-fullatatime.PagemappedStreamsPagemappedstreamsareaparticularkindofrandomaccessBufferedstreamthatbuffersitsdatainunitsofpages.Thedeviceprovidesmethodsthatreadorwritedatainunitsofpages,whilesystem-suppliedPagemappedfunctionshandletheresponsibilitiesofaBufferedstream,aswellasmanagingthefilepointerforrandomaccess.Ingeneral,astreamcanhaveseveralpagesofafilebufferedatatime,allowingthecodetomakesomeefforttomakeefficientuseofmulti-pagedtransferswhereapplicable.Tocreateapagemappeddevice,createanFDEV,fillinthenecessaryprivatefields,thencallthefollowingfunction:(\MAKE.PMAP.DEVICEDEVICE)[Function]Fillsinfieldsinthedeviceappropriateforpagemappeddevices,andreturnstheupdateddevice.ThefieldsitfillsaretheflagfieldsFDBINABLE,FDBOUTABLE,RESETABLE,RANDOMACCESSP,PAGEMAPPED,BUFFERED(alltrue),andthemethodsBIN,BOUT,PEEKBIN,BLOCKIN,BLOCKOUT,READP,EOFP,GETFILEPTR,BACKFILEPTR,SETFILEPTR,GETEOFPTR,SETEOFPTR,GETNEXTBUFFERandFORCEOUTPUT.APagemappeddeviceisrequiredtosupplythefollowingmethods(inadditiontothoserequiredofalldevicesandnotfilledinby\MAKE.PMAP.DEVICE):(READPAGESSTREAMFIRSTPAGE#BUFFERS)[Devicemethod]CausespagesofSTREAMtobereadintoBUFFERS.ThefirstpagereadisFIRSTPAGE#(zeroforthefirstpageofthefile).BUFFERSiseitherasinglepage-sizedbuffer(aVMEMPAGEP),inwhichcaseîJÁï
ëî
êïførîIïhsp
îJjïhsî‘ïb
rî_
îÀîÆ
îhî#î%Wî+o
î-î2’î3î6î;<3B>î@àîFã
îH<C3AE>îJÁîJÁïb
î‘ï`7î*î*îî ¸î ¸ï`7tï`7î+£ï`7rï`7î+üî.{î3Šî8|î:®î>­îA,
îH8îJÁîJÁï`7î‘ï^dî­îªîjîi	î#Œî&wî&wï^dxï^dî+Eï^drï^d
î,yî1î6%ï^dî‘ï[€
î@î}îI
îàîàï[€xï[€îÀï[€rï[€î$î èî èï[€tï[€î$Dï[€rï[€î%î%ï[€tï[€î/ëï[€rï[€î0Oî4ßî4ßï[€tï[€î5¶ï[€rï[€î6
î7þî<åî?V
î@•î@•ï[€xï[€îEcï[€rï[€îEÇ
îGîIW
îJÂîJÂï[€î‘ïY­î%
î»îXî»î¯î¯ïY­xïY­î }ïY­rïY­î à
î"*
î# î&4
î'Ëî*hî*hïY­tïY­î5SïY­rïY­î5¶î:î<áîBVîDê
îF€îJÁîJÁïY­î‘ïWÚîÕî°î aî aïWÚtïWÚ
î)žïWÚrïWÚî)ûî.ƒî04	î6‡î6äî<í
î>%î>%ïWÚxïWÚ	îFïWÚrïWÚîFr
îG´îJÁîJÁïWÚî‘ïVtî|ïVrïVîÔî î"<22>î&<26>î&<26>ïVtïVî)ïVrïVî)lî1ïVî	ôïR<C3AF>t
î<16>î<16>ïR<C3AF>xïR<C3AF>î[ïR<C3AF>tïR<C3AF>î2î2ïR<C3AF>xïR<C3AF>î ¼ïR<C3AF>tïR<C3AF>î!“ïR<C3AF>rïR<C3AF>î@ºîEˆîJlïR<C3AF>tïR<C3AF>îObïR<C3AF>î‘ïO rî¦îyî"Æî)î.Ùî2¿î2¿ïO xïO î7IïO rïO î8Yî<•
î>3î@ÄîE¼îI6
îJÁîJÁïO î‘ïMÖxî_ïMÖrïMÖ
î™î™ïMÖtïMÖîzïMÖrïMÖî×î 5
î!xî'úî+þî.5î.5ïMÖtïMÖî4ïMÖrïMÖî4sî7y
î8¼	î>åî?BîB2
îCuîFˆ
îH#îJÂîJÂïMÖî‘ïLî*î–î#Sî%Ôî)iî-ãî1vî1òî4“î:W
î;üî>QîA6
îBå	îJÂîJÂïLî‘ïJ9îÈîÈïJ9tïJ9î ³ïJ9rïJ9î!%î%'î'rî+‹î.Ç
î0aî2¬î5†î8?î:Šî?Áî?ÁïJ9tïJ9îGPïJ9rïJ9îGÂîJÂîJÂïJ9î‘ïHfîØîîúïHfî‘ïE‚î{îU
î“îÙî!„î$–ïE‚î	ôïBî
îNîNïBtïBî9ïBrïBî\î\ïBtïBî-£ïBrïBî.Æî.ÆïBtïB
î:ˆïBrïBî;«î;«ïBtïB
îGmïBrïBîH8îJÁîJÁïBî	ôï@>tî<16>ï@>rï@>îîjî÷î!5î#¬
î%©î+Cî0±î3Áî6	î<Ãî?ÿ
îA¯îH<C3AE>îJÁîJÁï@>î	ôï>ktîyï>krï>kî
Rî
Rï>ktï>kî3ï>krï>kî
î
ï>ktï>kîiï>krï>kîCîCï>ktï>kî$ï>krï>kî¥î!Xî!Xï>ktï>kî(ï>krï>kî(‘î,Ïî2®î3/
î4ûî:·î=îB‚îB‚ï>ktï>kîJï>krï>kîJÁîJÁï>kî	ôï<˜î
®îñîîAî”î!	î#Ü
î%Nî+Dî/ìî2Qî2Qï<˜tï<˜î=<ï<˜rï<˜î=ÈîBÖ
îDŠ
îJÂîJÂï<˜î	ôï:Åî
î{
îûî,
îþîû
î"v
î#áî$Þî'Ùï:Åî	ôï69v	î:îÿï69rï69îï69î	ôï2‘	îüîàî%îA	î bî#<23>
î%+î*:î.7î3àî8@î:þî? îAkîD`
îEÿîI7
îJÂîJÂï2‘î	ôï0ÇîLîîî<16>îNî"î%î(c
î*]î.î1I
î3-î6É
î8¸î=î@øîJÂîJÂï0Çî	ôï.ý	îýîêîaî´î'ì
î)˜î*·î0bî5
î6Àî9Ÿ
î;BîA|îCÏîF*îJÁîJÁï.ýî	ôï-3îîî^îÈ
î|î‰î˜î!ëî$Zî'„î+÷î/¥
î1Bî2Qî4<C3AE>î:
î;–î<¥î@îEgîGªîJÁîJÁï-3î	ôï+i
îtîùî]îø
îxîýî #î"j
î#õ
î+mî0Ìî4µ
î;ï+iî	ôï'ø
îîî?	îHîßî!Þ
î#Íî#Íï'øtï'øî')ï'ørï'øî(î*'
î+Óî./î4>î8Öî<Ýî@îB‡îDãîJÁîJÁï'øî	ôï&%îbï&%î	ôï"´tîéîéï"´xï"´îXï"´tï"´î/ï"´rï"´îDL	îJlï"´tï"´îObï"´î‘ïÇrî—
î5îØ
îvîÅî ø
î(Aî*n	î2jî7xî:î>ÁîAîFVîJÁîKîKïÇî‘ïýîLîã
îî¬îåî(î!Ãî%Zî%Zïýtïýî,éïýrïýî-¬î-¬ïýtïý	î6ïýrïýî6Õî6Õïýtïýî>dïýrïýî?&î?&ïýtïýîJïýrïýîJÁîJÁïýî‘ï*t	î÷ï*rï*î;î;ï*tï*î óï*rï*î!àî$¯î(Êî+èî.­î4 î4 ï*tï*î7%ï*rï*î8jî8jï*tï*î;Æï*rï*î=î=ï*tï*îBìï*rï*îD0îD0ï*tï*îJï*rï*îJÁîJÁï*î‘ïWtîIïWrïWîäîäïWtïWîïWrïWî²î²ïWtïWî"ïWrïWî#©î#©ïWtïW	î,ïWrïWî-ªî-ªïWtïW
î6çïWrïWî8‚î8‚ïWtïW	î@èïWrïWîBƒîBƒïWtïWîJïWrïWîJÂîJÂïWî‘ï„tî ï„rï„îÐîÐï„tï„î#»ï„rï„î$î&œî&œï„tï„
î/Ùï„rï„î06ï„î	ôï
îW	îCî[
î<18>îÿ
îƒî#Çî%üî+Þî1@î3=î8|
î:î=sîBÕ
îDdîF)îJÁîJÁï
î	ôï@î}îÃî%
î¥
îsîsï@tï@î#ºï@rï@
î$²ï@î	ôïÆt	î1î1ïÆxïÆîÿïÆtïÆîÖîÖïÆxïÆ	î [ïÆtïÆî!2î!2ïÆxïÆî&lïÆtïÆî'CïÆrïÆî@ºîEˆîJlïÆtïÆîObïÆî‘ïÙrîî¤
î5î5ïÙxïÙîïÙrïÙî`
î æ
î"®î%Ÿî(Mî(MïÙxïÙî-‡ïÙrïÙî.;î.˜î1Gî3õî7î:
î;Gî;GïÙxïÙ	îBÌïÙrïÙîC*îF|îH<C3AE>îJÁîJÁïÙî‘ïîMîx
îî[îxîäîäïxïî#ïrïî#‰
î$Úî(ªî)ºî-ˆ	î4î8)
î9²î9²ïtïîAAïrï
îB~
îDîH
îJÁîJÁï	Ô
êq?€`½
16exactlyonepageisread,oritisalistofsuchbuffers.READPAGESreturnsthetotalnumberofbytesread.Ifthelastpagereadisnotafullpage,READPAGESshouldzeroouttherestofitsbuffer.READPAGEScanassumethatthebuffersarepage-aligned,althoughtheyneednotbeconsecutive.(WRITEPAGESSTREAMFIRSTPAGE#BUFFERS)[Devicemethod]WritesdatafromBUFFERSouttoSTREAM.ThefirstpagewrittenisFIRSTPAGE#.BUFFERSisaswithREADPAGES.NeitherREADPAGESnorWRITEPAGESaffectsSTREAM'sfilepointerorendoffile;thosearemanagedbyhigher-levelpagemappedroutines.WRITEPAGESmight,however,wanttolookatSTREAM'sEPAGEandEOFFSETfieldsifitneedstotakeanyspecialactionaroundtheendofthefile.Itispossible,fornoparticularlygoodreason,forREADPAGEStogetcalledforapagebeyondtheendoffile;infact,thisstandardlyhappenswhenwritinganewfile.TheREADPAGESmethodinthiscaseshouldjustclearthebufferandreturnzero.(TRUNCATEFILESTREAMPAGE#OFFSET)[Devicemethod]TruncatesSTREAMsothatitsendoffileisPAGE#,OFFSET,whichshouldbedefaultedtoSTREAM'sEPAGEandEOFFSET.Canbeusedtoeithershortenorlengthenafile;iflengthening,thefileshouldbepaddedwithnulls.Usedby\PAGED.SETEOFPTRand\PAGED.FORCEOUTPUT.Asofthiswritingtherearestillbugsinthiscodeincertainfunnycases,suchaswhenyouSETFILEPTRbeyondeofandthenBOUT.Thefollowingfieldsofastreamaremeaningfulforapagemappeddevice.Thegenericpagemappedcodesmaintainthemasoperationsonthefileareperformed,buttheyshouldallbeinitializedappropriatelybythedevice'sOPENFILEmethod:CPAGEForpagemappedstreams,thecurrentpagepositioninthestream.TogetherwithCOFFSET,thisconstitutesthestream'sfilepointer.Thedevice'sOPENFILEmethodshouldsetCPAGEandCOFFSETtozero,exceptforfilesopenedwithaccessAPPEND,inwhichcasetheyshouldbesettotheendoffile.EPAGE,EOFFSETForpagemappedfiles,thepageandbyteoffsetoftheendoffile.Notethatthisisthelogicalendofthefile;itneedhavenothingtodowiththephysicalendoffile,exceptthatwhenafileisclosed,thedeviceshouldseetoitthatitslogicalandphysicalEOFsarethesame(normallyseentobytheTRUNCATEFILEinsideof\CLEARMAP,below).Infact,asatypicalfileisbeingwritten,EPAGEtendstostayseveralpagesaheadofthephysicalendoffilebyvirtueofthefactthatpagesarebeingbufferedbeforebeingwrittenout.BUFFSForpagemappedstreams,apointertothestream'sBUFFERchain.InitiallyNIL(nobuffersallocated).Thedeviceusuallyhasnodirectinterestinthisfield.MAXBUFFERSForpagemappedstreams,themaximumnumberofbuffersdesiredinthestream'sBUFFSchain.IfthecodeneedsanotherbufferandtherearealreadyMAXBUFFERSbuffers,itwilltrytorecycletheleastrecentlyreferencedbuffer.Defaultsto\STREAM.DEFAULT.MAXBUFFERS.TheusercanchangethisfieldforanopenstreambycallingSETFILEINFOwithattributeBUFFERS.îJÁïî
êïførî	ôïhsp
îLïhsî‘ïb
rî%îÊî

îpîÜ
î!š
î"ê
î$Pî%uî'«
î)^î,ˆî1Šî2
î2
ïb
tïb
î9™ïb
rïb
î:î>ÄîAîD:îI6
îJÁîJÁïb
î‘ï`.î(îœî&
î­îî“î!Üî$ú
î&jî(âî*î,<2C>î0?î0?ï`.tï`.î7Îï`.rï`.î8Xî<Ôî?ÙîBQîD´îGY
îIîJÁîJÁï`.î‘ï^[î)îÃîÃï^[tï^[îRï^[rï^[îëî Šî%eî(Fî*¹î/~î1æî:[î@&îCIîF¸îHþ
îJÁîJÁï^[î‘ï\ˆîîï\ˆî	ôïYt
îîïYxïYîÖïYtïYî­î­ïYxïY	î!2ïYtïYî"	î"	ïYxïYî'CïYtïYî(ïYrïYî@ºîEˆîJlïYtïYîObïYî‘ïV*rîãî×î,î,ïV*xïV*î fïV*rïV*î Üî#?
î$Ýî$ÝïV*xïV*î)«ïV*rïV*î*wî*ìî-³î0yî3¯î8N
î9ªî9ªïV*xïV*	îA/ïV*rïV*îAûîBpîBpïV*xïV*îGªïV*rïV*îH
îI@
îJÁîJÁïV*î‘ïT`î|î|ïT`tïT`îïT`rïT`îhïT`î	ôïPæî
î
ïPætïPæî<16>ïPærïPæîî¡î¡ïPætïPæ	î"ïPærïPæî"Žî&Ýî&ÝïPæxïPæî+«ïPærïPæ
î-î/wî4<
î6
î8¹
î:sî=Uî@óîCGîHó
îJÁîJÁïPæî	ôïOî‰	î¥îUîìîìïOtïO	î(RïOrïOî(éî-Gî31î6ž
î8]î;„
î=.î=.ïOxïOîAüïOrïO
îCoîCoïOtïOîG¢ïOrïOîH8îJÁîJÁïOî	ôïM@tîÕïM@rïM@î~îS
î×
îPîS
î$î ?î#î'žî+Öî0´î36î6
î7ìî:nî=Pî=ù
î?”
îA#îFÛîHê
îJÂîJÂïM@î	ôïKmî]îôîÌî0î0ïKmtïKmî#¿ïKmrïKmî$m
î&Bî(³î,Îî/3î0…î3òî9
î;‡î>f
î@FîCO
îE$îHOîJÁîJÁïKmî	ôïIš	îsî´î>îÂîÃî!†î$î$vî'"î'"ïIštïIšî.±ïIšrïIšî/î3ê
î5mî7ãî:¦î>óîAiîDŽîFÂîJÁîJÁïIšî	ôïGÇî}î|îUïGÇî	ôïDVtî¶î¶ïDVxïDVî„ïDVtïDVî[î[ïDVxïDVîƒïDVtïDVî Zî ZïDVxïDVî$ÀïDVtïDVî%—ïDVrïDVî@ºîEˆîJlïDVtïDVîObïDVî‘ïAirî¹î¹ïAixïAiî‡ïAirïAiîã
î}î  î!Ðî$]
î%ìî()
î)kî)kïAixïAiî-“ïAirïAiî.Gî.GïAixïAiî2­ïAirïAiî3aî7Bî;<3B>
î=WîC=
îDÀîDÀïAixïAiîIŽïAirïAi
îJÂîJÂïAiî‘ï?ŸtîÄï?Ÿrï?ŸîDîöîöï?Ÿtï?Ÿî×ï?Ÿrï?Ÿî¯î0î"
î$î':
î(âî,Çî1©
î3gî9î:*î=
î>aîF.îH‡îJÁîJÁï?Ÿî‘ï=ÌîÞ
î¥îbîQî!Øî"3î%œ
î'mî'mï=Ìtï=Ìî4Ýï=Ìrï=Ìî59î7Åî7Åï=Ìtï=ÌîFãï=Ìrï=ÌîG–îGñîGñï=Ìsï=Ì
îIs
îJ¯îJ¯ï=Ìî‘ï<6îŸîRîîèîõîˆ
î Ôî"áî%s
î&¿î*Oî-vî0pî2ñ
î4=î7'î9F	î@wîDXîF1îHPîJ¯îJ¯ï<6î‘ï:|îï:|rï:|î
ï:|î	ôï7îÄîÈîr
î$îGî®îû	î'+î)`î*„	î2‡î7î7—î:fî?$	îG'îJÂîJÂï7î	ôï5Aî<0F>îü
î<14>	î
îîLî!™î#Ò	î*Îî-3î0'î4„î6X
î8.
î>`îF°
îH<C3AE>îJÁîJÁï5Aî	ôï3wîäîäï3wtï3wîœï3wrï3wîôîõï3wî	ôï/ýtî'ï/ýrï/ýî/îÿ	î"1î'¢î*(î/î2‚î7å
î9¹î<?îA+îAØîGÖîJÁîJÁï/ýî/ï.*tîï.*rï.*îçî €
î'8î)<29>î.Ôî15î6Jî6Éî9™î>°î>°ï.*tï.*îEhï.*rï.*îEçîJÁîJÁï.*î/ï,Wî‘î™î™ï,Wtï,Wî!Ìï,Wrï,Wî"=î$ßî$ßï,Wtï,Wî*Àï,Wrï,Wî+1
î,Êî0î4Gî6oî9Fî>
îAîEîEï,Wtï,WîJï,Wrï,WîJÁîJÁï,Wî/ï*„
î¯îŒîLî"-î&w
î(:î*)
î+©î-Úî0c
î1îî4-ï*„î	ôï'tîÕî¶ï'rï'î/î½	î!¬î$Ôî'î*Aî,Üî/Ïî3|
î5î7\î9÷
î;”î>7î>¡îAúîD«îG/
îHîHï'ï'îJ°îJ°ï'î/ï%@uîÿï%@rï%@îrî
î¼î"î$Ö
î&î)bî,•î1”
î3/
î5"î8(î:tî?ªîBN
îCôîF¡îJÁîJÁï%@î/ï#cîäî€î“î ã
î"7î&¢î(éî-î1sî3¯
î5E
î6ƒî98î:úî?7îAÖîGîJÁîJÁï#cî/ï!™îdî¤îî%)î($
î)´
î+‘î-Ñî-Ñï!™tï!™î7åï!™rï!™î8Mî<-
î=Çî=Çï!™tï!™îEVï!™rï!™îFîJÁîKîKï!™î/ïÆ
îÜî½
îJîRî"œî$á
î&+î)Ñî.¶î.¶ïÆtïÆî2éïÆrïÆî3Mî6Ó
î8^î;î?uîCîFú
îH<C3AE>îJÁîJÁïÆî/ïóî<1C>îA
î!î#t
î%yî)w
î+9î-¢î0Wî3-î7î9]î=/îBÐîG&îJÁîJÁïóî/ï)î±îüï)î	ôï¸tî'ï¸rï¸î/îÓ	î!Øî'î(Bî-

î.ªî1î6Hî6Hï¸tï¸î;Rï¸rï¸î;Òî?Öî@VîEkîEkï¸tï¸îGðï¸rï¸îHpîJÁîJÁï¸î/ïåî²
î"î"mî%î)*î-«î/ò
î1Êî5{î:)
î;©î>îA ïåî	ôïtt	îZïtrïtî/îô	î"î'‚î)ýî0—î5Ü
î7±î<~îA`
îC*îE¤îJÁîJÁïtî/ï¡tîbï¡rï¡îæîïî s
î!õî$Rî'•î+tî0zî4¦î7[î:âî=4îBîBï¡tï¡	îJiï¡rï¡îJÁîJÁï¡î/ïÎîž
îYî!hî#ö
î&
î+
î-Îî1Xî6ò	î>îCîCîîIA
îJÁîJÁïÎî/ïtî-ïrïî.î.Óî1àî5î7Ðî<«î?<3F>îBåîEX
îG~îJÁîJÁïî/ï1îp
î>î!qî!qï1tï1
î*®ï1rï1î+î-ñî3Oî3Oï1tï1î90ï1rï1î9<C3AE>ï1ÿ

êq?€`½-17MULTIBUFFERHINTFlag.Forpagemappedstreams,isahinttothepagemapcodethatthedevicepreferstotransferdatamorethanonebufferatatime.Ifthisflagistrue,thepagemapcodetriestowriteout(WRITEPAGES)morethanonebufferatatimewhentheopportunityarises.Asimilarimprovementisplanned,butnotimplemented,forreadingmultiplebuffersatatime.Thefollowingfunctionsareofuseforpagemappeddevices:(\PAGED.FORCEOUTPUTSTREAMWAITFORFINISH)[Function]ThisfunctionimplementstheFORCEOUTPUTmethodforpagemappedstreams:itcausesanydirtypagestobewrittenout(usingWRITEPAGES),thencallstheTRUNCATEFILEmethodtosettheendoffile.ThisfunctionisnormallyinstalledastheFORCEOUTPUTmethodbythefunction\MAKE.PMAP.DEVICE.However,thedevicecanoverridethisdefault(bysupplyingitsownfunctioninthatfield),inwhichcaseitmightwanttocallthefunction\PAGED.FORCEOUTPUTexplicitlyaspartofitsmorecomprehensiveFORCEOUTPUTmethod.Thereisanunpleasantnessintheimplementationofpagemappeddevicesthatstemsfromthefactthatoriginallyalldevices(thefewthatexistedinthedistantpast)weremadetosupportthePMAPpackage,ameanswherebyaprogrammercouldgetdirectaccesstothebuffersofafile,muchasonecanwiththePMAPJSYSinTenex.Asaresult,thebuffersusedbypagemappedstreamsaresetupinaspecialmannersothatthegarbagecollectorcantellwhentheusernolongerhasaccesstoaPMAPbuffer.ThePMAPpackageisbeingphasedout.Thisisallexceedinglycrufty,andisoflittleconcerntothedeviceimplementer,exceptforthefactthatitrequiresthatthebuffersbeexplicitlyreleasedwhenastreamisclosed;thebuffersarenotautomaticallycollectedwhenthestreamisdropped.(FORGETPAGESSTREAMFROMPAGETOPAGE)[Function]``Forgets''pagesFROMPAGEthruTOPAGEofSTREAM;i.e.,removesthosepagesfromthesetofpagesbeingcurrentlybuffered,andfreesthebufferstheywereoccupying.IfFROMPAGE=TOPAGE=NIL,forgetsallpages,andreleasesallofSTREAM'sbuffers.(\CLEARMAPSTREAM)[Function]PerformsaFORCEOUTPUT(ifSTREAMisopenforoutput)followedbyaFORGETPAGES.Thisisthestandardactionthatshouldbetakenbyapagemappedstream'sCLOSEFILEmethod.DirectoryEnumerationThissectiondescribeshowdirectoryenumerationworkswhatyouneedtoknowinordertoimplementtheGENERATEFILESdevicemethod,andwhatyouneedtoknowasaprogrammertryingtoenumerateadirectoryviaanythingmoreelaboratethanthefunctionDIRECTORY.Thegeneralideaisthatthedirectoryenumerationcodeisgivenapattern,anditreturnsageneratorthat,eachtimeitispoked,returnsanotherfilenamematchingthepattern.Inaddition,thegeneratorprovidesahandleforgettingfileattributesofeachenumeratedfile.Thissecondhandleisimportantforefficiency:althoughî9<C3AE>ï1î
êïførîIïhsp
îJjïhsî	ôïb
tî<16>ïb
rïb
î/îîÜî\	î%>î*`
î+¢î,¤î/\
î0áî3î8Çî;ãî>†î@¼îDÔîIA
îJÁîJÁïb
î/ï`.îîñî"^î%]î'ãî+ê
î-^î.dî1¹î2
î3wî5òî8ƒ
î9Éî<ßî?îDÍîGìîJÁîJÁï`.î/ï^d
îõî‰îî<1F>ï^dtï^d	î'óï^drï^dî)
î,´î/ñî2´î6ù
î8ªî9íî=)î@õîCk
îJÁîJÁï^dî/ï\‘î7î¯î/î!¤
î*
î+bî0÷î3jî5Ñî>gî@—îE{îJÁîJÁï\‘î/ïZÇî²
îîî!ïZÇî	ôïYDî	úïYDî	ôïUÓî<0C>î{îFîl
î÷î>î M	î(*î,éïUÓî	ôïRbtîÀîÀïRbxïRbîŽïRbtïRbî eî eïRbxïRbî)òïRbtïRbî*ÉïRbrïRbîDL	îJlïRbtïRbîObïRbî‘ïOurî€îÌ	î î"<î"<ïOutïOu
î+yïOurïOuî+Öî0µî2É	î:ªî?í
îAîE)îG îJÂîJÂïOuî‘ïM¢îT
îú
îäîŒîùî#î#ïM¢tïM¢	î+xïM¢rïM¢
î,Èî/åî2ëî5Bî5BïM¢tïM¢î?VïM¢rïM¢î?ÕîDÕ
îF|îH‘îJÂîJÂïM¢î‘ïKÏî
î¥îäïKÏî‘ïHëînî©
îÚî#lî)¥
î,î/>î/>ïHëtïHë
î8{ïHërïHëî9Çî?”
îBVîEzîJÁîJÁïHëî‘ïGtîØïGrïGîËî hî&±î)&î-î0!î5¡î8Xî=î?ŸîEüîGìîJÁîJÁïGî‘ïEEîü
î îcîW
îûî#üî&à
î(,î,î/i
î1
î3Œî5áî;Kî;KïEEtïEEîJiïEErïEEîJÁîJÁïEEî‘ïCr	îD
îÅîz
îî±î!î*Eî*EïCrtïCr
î3‚ïCrrïCrî3Úî8¹ïCrî	ôï?øî
î¥
î¹
î0
î
î‚
î)z
î+V	î3„î8mî;\î?IîBÒîETîH"îJÁîJÁï?øî	ôï>.	îîîåîÉîwîPî#ö
î%±î(î,¢î0
î3gî73
î8íî>î@mî@mï>.tï>.îCÉï>.rï>.îD[îIÄîJÁîJÁï>.î	ôï<[îî‰î–	îVî 
î",î%îî)Ü
î+mî-®î2B
î3Ýî4êî7<C3AE>î;D
î<Öî?cîAÑîDÌîG
îG
ï<[tï<[îJiï<[rï<[îJÁîJÁï<[î	ôï:ˆî
z
îûîQîª
îŽîŒî€î²î!6î$D
î&	î-ñî2·î4Þî6Î
î8³
î:4î;2î?}îDY
îEðîH<C3AE>îJÁîJÁï:ˆî	ôï8¾îõîaîÎî
î£îåî!À
î#¨î'Ìî*#î.
î/¢î0¯î0¯ï8¾tï8¾î4ï8¾rï8¾î4sî8Úî9Bî9Bï8¾sï8¾î;sî>üîC
îD(îGîJ¯îJ¯ï8¾î	ôï6ëîÅï6ërï6ëîËï6ëî	ôï3zî

î<0E>îu
îèîFî
î r
î"0î%bî*<2A>
î,Bî.¦î2ìî;Rî?¥îAæîDJîFúîI™
îJÁîJÁï3zî	ôï1°îPî/îŸîb
îd	î!Wî&²î*xî+µî05
î1³î6hî8Ùî=›î@
îB†îJÂîJÂï1°î	ôï/æî|îî3ît
î²î 
ï/æî	ôï,utîßîßï,uxï,uî­ï,utï,uî„î„ï,uxï,uî!>î%àï,utï,uî&·ï,urï,uîDL	îJlï,utï,uîObï,uî‘ï)ˆr
îñîÊîÊï)ˆxï)ˆî!>ï)ˆrï)ˆî!Óî$çî$çï)ˆxï)ˆî)‰ï)ˆrï)ˆî*
î+æî+æï)ˆxï)ˆî0´ï)ˆrï)ˆî1Âî4dî9ßî=‹îAdîDÙîGGîI6
îJÁîJÁï)ˆî‘ï'¾î<14>îpîoî$†î'cî*Úî-_î26î5lî8ã	î?èî@”
îB=îB=ï'¾xï'¾îH±ï'¾rï'¾îI	îJÁîJÁï'¾î‘ï%ôxî3ï%ôrï%ôî‹îCîCï%ôtï%ôîÈï%ôrï%ôîxîÎî <20>î$ƒî'î+æî-§
î/2î/2ï%ôxï%ôî4ï%ôrï%ô
î54î9¼ï%ôî	ôï"zt	î1î1ï"zxï"zîÿï"ztï"zîÖï"zrï"zîDL	îJlï"ztï"zîObï"zî‘ï<1F>rî\înînï<1F>tï<1F>
î «ï<1F>rï<1F>î!î"Ùî"Ùï<1F>xï<1F>î'§ï<1F>rï<1F>î(
î)gî,¿î.ãî3±î97
î;î<,î<,ï<1F>tï<1F>
îEiï<1F>rï<1F>îF-îFšîI„
îJÂîJÂï<1F>î‘ïºîÂî,îî²î"ü
î$¿î(O
î*î+	î2÷î8î8ïºtïºî?£ïºrïºî?ûîDÚïºî	ôï%vî
î9ï%rï%î?ï%î	ôï}îôîuîAî,îá
î'Ç	î/äî2‚î5Æ
î7\î;

î<—î@2
îAÈîH<C3AE>îJÁîJÁï}î	ôï³tîßï³rï³î<15>î÷î€î"_î%ãî(Âî,F
î.î2
î3Ùî5,	î=3îA[
îC1îIÄîJÁîJÁï³î	ôïàî“î¢î!î…î Eî#<î%mî*´î*´ïàtïàî2Cïàrïàî2 ïàî	ôïfî¢îKî
î]îî8îÝ
î'²î*Î
î,î/œî0Ÿî5Šî8
î9Fî=Îî>ÑîDÃîG¿îJÁîJÁïfî	ôïœîô
î&
înîÍî[î?îƒî#î(õî+0î0î0<C3AE>
î2-î7Ëî:î?ýîEdîFkîJÁîJÁïœî	ôï
Òî)î¯î	î
îÅîí	î%kî(!î(žî+­î04î4¯
î6î<eî>™
îE9îJÂîJÂï
Òÿ	™
êq?€`½þ18onecouldjusttakethefilenamegivenbytheenumeratorandpassittoGETFILEINFO,thedevice,inthecourseofenumeration,usuallyhasitsfingersonthefilecloselyenoughthatitneednotperformtheseconddirectorylookupthataGETFILEINFOoutofthebluewouldrequire.Thecallerofthedirectoryenumerationcodespecifiesaheadoftimewhich,ifany,attributeswillberequired(anecessityformostfileserverimplementations).Informationfordeviceimplementors.AfilegeneratorisanobjectrepresentedasalistdescribedbytherecordFILEGENOBJ,exportedfromFILEIO:(RECORDFILEGENOBJ(NEXTFILEFNFILEINFOFN.GENFILESTATE))NEXTFILEFNandFILEINFOFNarefunctionsofthedevice'schoosingthatwhencalledwillreturnthenextfile,andattributesforthatfile.GENFILESTATEisarbitrarystatemaintainedbythegenerator.Withthatasbackground,herearethepiecesofdirectoryenumeration:(GENERATEFILESDEVICEPATTERNDESIREDPROPSOPTIONS)[Devicemethod]ReturnsageneratorthatenumeratesfilesmatchingPATTERN,whichisastringthathashostanddirectoriessuitablyfilledinfromdefaults,andmaycontainthepatterncharacter``*''tomatchanarbitrarynumberofcharacters.DESIREDPROPSisalistoffileattributesthatmayberequestedduringtheenumeration;theymustbevalidATTRIBUTEargumentstoGETFILEINFO.OPTIONSisalistofoptionstotheenumeration,chosenfromamongthefollowing:SORTThefilesshouldbeenumeratedinsortedorder.Ifthisoptionisnotspecified,thedeviceisfreetoenumeratefilesinanyconvenientorder.Thereissomequestionastowhetherfilesshouldbeenumeratedlowestversionfirst(asIFS'sdo)orhighestversionfirst(asTwenexdoes).Ipreferthelatter,butgivenserversthatdotheformer,wecurrentlymakenorequirementaboutversionorder.RESETLSTInformstheenumeratorthattheenumerationcontextissurroundedbyaRESETLST,sothatitmayperformRESETSAVEstocleanupafteritselfiftheenumerationisaborted.Cleaningupcanbeaverymessybusinesswithoutthisinformationaboutthescopeoftheenumeration,soallcallersof\GENERATEFILESarestronglyencouragedtoprovideit.GENERATEFILESshouldreturnafilegeneratorwithasuitableNEXTFILEFNandFILEINFOFN.Finepointaboutmissingfieldsinthepattern:nullfieldsinPATTERNmatchonlyfilesforwhichthecorrespondingfieldisnull.Anullversionisinterpretedashighest.Thus,DIR*=DIR*.*=DIR*.*;*enumerateseverything.DIR*.=DIR*.;*enumeratesallversionsoffileswithnullextension.DIR*.;enumerateshighestversionoffileswithnullextension.DIR*.*;enumerateshighestversionofeverything.Itisdifficultforsomedevicestoenumerateonlyhighestversionoffiles;thereareseveraldevicesinthesystemthattreatanullversionthesameasversion*.However,everydeviceshouldtryitsbest.Withsomework,anydevicethatcanenumerateallversionscanenumeratejusthighestîJÂï
Òî
êïførî	ôïhsp
îLïhsî	ôïb
rî”îQîåîÒî&îƒî7î!ß
î#Ðî&$	î-sî0î3

î4X
î5ûî5ûïb
tïb

î?8ïb
rïb
î@îB_îFî
îH<C3AE>îJÁîJÁïb
î	ôï`.î/
îÖîî·îî âî%T
î'Hî)•î+ëî0Pî5%î7à
î9$î<nî>ÐîDîF`îJÁîJÁï`.î	ôï^dî“îî¦î£î£ï^dtï^d
î àï^drï^dî!8î#~
î%	î':î*%î."î3î3iî6î9–
î;!î=RîBñ
îJÁîJÁï^dî	ôï\‘î
fî	î8
îîpî!

î"<22>î%¶	î+ôî.Ë
î0éî6£
î8uî>Zî@ÅîDNîFãîJÁîJÁï\‘î	ôïZÇî<14>ïZÇî	ôïWVz
îMîXîSî4ïWVrïWVîêî Jî!°î!°ïWVuïWVî#Üî)UïWVrïWVî)´
î*ú
î,Äî0³
î7ò
î9{î:î<•îB”
îDjîF¢îJÁîJÁïWVî	ôïUkt	îZïUkrïUkî
î”îÌîÌïUktïUkî ÖïUkrïUkî!UïUkîÔïQñtîŒ	î!É
î+Ý	î5î6È
îBŠïQñrïQñîB<EFBFBD>ïQñî	ôïNwt	îZïNwrïNwîÆîcîcïNwtïNw	îÉïNwrïNwî5î oî&N
î'íî*2î/6î4Òî7…î;î>ùîAˆîE›îGàîJÁîJÁïNwî	ôïL¤î–î0	î#îCîòî”îýîýïL¤tïL¤î'ïL¤rïL¤î'z
î(Èî.Mî1`	î8e
î:Cî<…	îBÚîCCîF¡îI@
îJÁîJÁïL¤î	ôïJÑ
î£î<14>îµîæîÎ
îYî#øî+ïïJÑî	ôïG`t
î<16>î<16>ïG`xïG`îüïG`tïG`îÓîÓïG`xïG`î!-ïG`tïG`î"î"ïG`xïG`î*ûïG`tïG`î+Òî+ÒïG`xïG`î1
ïG`tïG`î1ØïG`rïG`î@ºîEˆîJlïG`tïG`îObïG`î‘ïDsrîºîÙîèî©	î&âî)Âî/°î/°ïDsxïDsî5
ïDsrïDsî5Üî9Û
î;;î<Zî@"îBãîELîH8îJÁîJÁïDsî‘ïB©
î!î'îŸ
î!5î$„î)íî,<2C>î/yî4<î6„î;(î@öîCt
îE
îHþ
îJÁîJÁïB©î‘ï@ßî4î_
î
î#Ûî$bî$bï@ßxï@ßî-Yï@ßrï@ßî-á
î/Nî0zî2¸
î4rî6Û	î<íî?»îBÀ
îD²îJÁîJÁï@ßî‘ï?îÚîîfî"Pî%’
î'_î*Ÿî*Ÿï?xï?î16ï?rï?î1—î8
î9¦î9¦ï?tï?
îBãï?rï?îC›îCüîCüï?xï?îI+ï?rï?îIƒ
îJÁîJÁï?î‘ï=BîŽîœ
î'îÓ
îSî„î%¬î*
î-Eî1›î3Ì	î9Ñï=Bîàï:^tî<ï:^rï:^îÌî Øî#úî(¨
î*Î	î2‹
î4nî8Åî=î=À
î?yîBNîFÚ
îH{îJÁîJÁï:^îÌï8‹	î#­î%Þî)ò
î+0î-Ï
î/Oî5âî8 
î: î<“	îC[îFåï8‹îÌï5§î!à
î#aî'î,¦
î.j
î0,î5Œî8Œî=
î?	îF¹îJÁîJÁï5§îÌï3Ýî"pî%'î'/î*¡î,ÿ
î.£î3>î7ãî:šî<¡îAªîE‰îEïîFØîJÁîJÁï3ÝîÌï2î dî$‡î'@î+,î/õî2û
î5:î7Òî<ò
î?SîEeîHê
îJÂîJÂï2îÌï0I
î%fî)î-®î18ï0Iîàï-etî˜ï-erï-eîÌî#î%<25>	î,þî/áî2W
î:lî?T
î@Ö	îG÷
îIÅîJÂîJÂï-eîÌï+’tî$„ï+’rï+’î%X
î'î)×
î+$î.î3jî3jï+’tï+’î:ùï+’rï+’î;ú
î=ŸîA(
îC1îFbîIŽ
îJÁîJÁï+’îÌï)¿î I
î(e
î)ïî/lî0î5ü
î8,î:Õ
î<äî>-îAZîE„îJÁîJÁï)¿îÌï'õî"¦î%
î,oî0!î2Sî5ï
î7{î9­îAÖ
îCmîE/îI7
îJÂîJÂï'õîÌï&+t
î)Žï&+rï&+î)æî,î1	î8=
î9½î>–î?Ãï&+î‘ï#>tî|ï#>rï#>îÔî î$î%î'Tî-Aî0,î1)î6
î6
ï#>tï#>	î>sï#>rï#>î>ËîATîATï#>tï#>	îIºï#>rï#>îJï#>î‘ï Qî¿îOî"î î#­
î%Oî'¢î,Ëî/–î3<
î4Þî4Þï Qxï Qî:8ï Qrï Qî:²î>ÈîAÔîD´îFåîJÂîJÂï Qî‘ï‡îÂîƒîƒ
îÁî"Àî#î$wî'î+¶
î,ô
î3Ó
î5Tî:8î:<3A>î>6î>6ï‡ï‡î><ï‡îàï£tî<îï£rï£îkî#î#ï£tï£îî ï£rï£î \î"î"ï£tï£î%pî)£ï£rï£î)û	î1
î7©ï£îàï¶tî<
îêï¶rï¶îBîúîúï¶tï¶îVî!²ï¶rï¶î"
	î)!î*âî/ý
î1ˆî4Fî71î9Ù	î?Êï¶îàïÉtî<îÁïÉrïÉîÌ	î$ãî)pî.
î/’î2Pî5;î7ã	î=ÔïÉîàïÜtî<î˜ïÜrïÜîÌ	î$ãî)pî.
î/’
î6)ïÜî‘ïï
îï
îAîYî|îôî" 
î$4î*Úî-Øî-Øïïïïî2yî6¸ïïïïî7$
î8Ãî<î?|îA¶îF*îJÂîJÂïïî‘ï%
î#îfîÃîtîˆî—î"Qî&úî)<î,<2C>
î.0î2Ùî2Ùï%tï%î3°ï%rï%î4qî4Úî:ðî>ˆîB®îG
îIîJÁîJÁï%î‘ïRîÚîoîúî›î}î"-î&~î)[î+õî2Åî4Ãî:î<µîC…îF4îJÁîJÁïR	Ý
êq?€`½19versionifitenumeratesinsortedorderandusesperhapsalittlelookaheadtoassurethatanynameitreturnsistheoneofhighestversion.(NEXTFILEFNGENFILESTATENAMEONLY)[FileGeneratorComponent]Generatesthenextfile,returningitsnameasastring,orNILifthegeneratorisexhausted.GENFILESTATEisthestatecomponentofthefilegeneratorreturnedfromGENERATEFILES.NAMEONLYmeansthatthecallerisonlyinterestedinthefile'sName.Extfields,notthefullfilename(andnomorethanoneversionofthefileneedbeenumerated);however,itisalwayspermissibletoreturnthefullfilename.TheNAMEONLYoptionisusedbySPELLFILE.(FILEINFOFNGENFILESTATEATTRIBUTE)[FileGeneratorComponent]ReturnsthevalueoftheATTRIBUTEpropertyofthefilemostrecentlygeneratedbytheNEXTFILEFN,i.e.,effectively(GETFILEINFOlatest-nameATTRIBUTE),buthopefullymuchfaster.ATTRIBUTEmusthavebeenamemberoftheDESIREDPROPSargumenttoGENERATEFILES.Notalldeviceimplementorsareenthusedaboutimplementingapatternmatcherforfilenames.Thefollowingfunctionsareprovidedtohelpout:(DIRECTORY.MATCH.SETUPPATTERN)[Function]AcceptsasPATTERNafilenamestringsuchaspassedtoGENERATEFILES.ReturnsanobjectsuitableasafiltertoDIRECTORY.MATCH.(DIRECTORY.MATCHFILTERTESTNAME)[Function]MatchesTESTNAME,afilename,againstFILTER,theobjectreturnedfromDIRECTORY.MATCH.SETUP.ReturnstrueifTESTNAMEmatchesthepattern,falseifnot.Thematchiscase-insensitive.(\NULLFILEGENERATOR)[Function]Returnsafilegeneratorthatproducesnofiles.(\GENERATENOFILESDEVICEPATTERNDESIREDPROPSOPTIONS)[Function]Returnsa``stupid''filegeneratorfordevicesthatdon'tknowhowtoenumerateingeneral.IfPATTERNcontainsnowildcards,butnamesafilethatisINFILEP,thenthegeneratorproducesexactlythatfile.IfPATTERNcontainsawildcardintheversionfield,itusesGETFILENAMEtolaboriouslygeneratealltheversionsofthefile.Inallothercases,\GENERATENOFILESreturnsanullfilegenerator.Informationforclientsofdeviceenumeration.Thefollowingfunctionsmakeupthe``public''interfacetodirectoryenumeration:(\GENERATEFILESPATTERNDESIREDPROPSOPTIONS)[Function]ReturnsafilegeneratorobjectforenumeratingthefilesmatchingPATTERN.PATTERNisexpandedbyaddingthedefaulthostand/ordirectoryifappropriate.SeedescriptionoftheGENERATEFILESmethodfordescriptionofDESIREDPROPSandOPTIONS.îJÁïRî
êïførîIïhsp
îJjïhsî‘ïb
rî.
îg
î•	î³
î 9î$2î'½î*Mî-î2 î3#î6(î<’
î>îBîD·îG0îJÁîJÁïb
î‘ï`7
î¹î<
îzî«î(
î³î"@î'.î'.ï`7ï`7î'4ï`7î	ôï\Æt
îîï\Æxï\ÆîËï\Ætï\Æî¢î¢ï\Æxï\Æî$^ï\Ætï\Æî%5ï\Ærï\Æî9œî<¥îC	îJlï\Ætï\ÆîObï\Æî‘ïYÙrî4î¶îéîÌî%õî'òî+Õ
î-§î.öî3E
î5-î5-ïYÙtïYÙî7²ïYÙrïYÙî8[
î9àî<bîB¡
îD0	îJÂîKîKïYÙî‘ïXxîTïXrïXîÿ
î<1B>îî!iî(°
î*Žî-î/Ÿî5ßî;œî?'î?'ïXtïXîJïXrïXîJÁîKîKïXî‘ïV3xîMïV3rïV3îÁîñî«î ÷î$—
î%ðî(õ	î/)
î0Åî3î6Bî6BïV3tïV3î<úïV3rïV3î=mîAeîCÆîFîHˆîJÂîJÂïV3î‘ïT`îpîÀ
îæî˜î Ýî#¨î(<28>
î*fî,åî/mî2é
î4úî=“îCŒ
îE
îF<C3AE>îJÂîJÂïT`î‘ïR–
îš
îîîJî!¥î#ßî'Çî(î*Èî*ÈïR–xïR–î1„ïR–rïR–î1Üî6
î7Bî:O
î<î<ïR–tïR–îC¬ïR–rïR–îD	ïR–î	ôïOt
îîïOxïOîËïOtïOî¢î¢ïOxïOî$9ïOtïOî%ïOrïOî9œî<¥îC	îJlïOtïOîObïOî‘ïL/rîîÏîÌ
îÙî!<21>î!<21>ïL/xïL/î($ïL/rïL/î(ÿî.ë
î0ùî3­î6jî:î?£îF@
îH<C3AE>îJÁîJÁïL/î‘ïJet	î÷ïJerïJeîî½
î#zî#zïJetïJeî-ŽïJerïJeî.>
î5­î5­ïJexïJeî<DïJetïJeî=ïJerïJeî>#î@ÍîGîJÂîJÂïJeî‘ïH’îsîÆîÆïH’xïH’î]ïH’rïH’î¯î"ãî&õî+î-î3N
î5Óî8ÿî8ÿïH’xïH’îAöïH’rïH’îCHîIA
îJÁîJÁïH’î‘ïFÈtî|ïFÈrïFÈîÙïFÈî	ôïCNîóîîƒîTî×î$áî(ïî1Öî31î8î=–î@îBšîGcîHîJÁîJÁïCNî	ôïA„îÒî<15>îÃîb
îâî!Íî$:ïA„î	ôï>tîEîEï>xï>î"Ÿï>tï>î#vï>rï>îDL	îJlï>tï>îObï>î‘ï;&rî°
î`î`ï;&xï;&îºï;&rï;&îAîmî ×î$—î(lî+<2B>
î-Mî1³
î3bî3bï;&tï;&î>Mï;&rï;&î?+î?²îDè
îFÚîJÁîJÁï;&î‘ï9Sîu
îöîóî
îŸîŸï9Stï9Sî)8ï9Srï9Sî)•ï9Sî	ôï5Ùtî;î;ï5Ùxï5Ùîlï5Ùtï5ÙîCîCï5Ùxï5Ùî#<23>ï5Ùtï5Ùî$tï5Ùrï5ÙîDL	îJlï5Ùtï5ÙîObï5Ùî‘ï2ìrîRîRï2ìxï2ìî¬ï2ìrï2ìîÕî"Kî%ýî+_î1Dî1Dï2ìxï2ìî5uï2ìrï2ìî7<C3AE>î;Gî@§îG‰îJÁîJÁï2ìî‘ï1"tî"4ï1"rï1"î#î#…î(°î+Š
î,âî,âï1"xï1"î3<ï1"rï1"î3¹î8ûî;Qî@\îC‚
îDÚîGœîHîJÁîJÁï1"î‘ï/Oî…
îÃî#ï/Oî	ôï+ÞtîÀï+Þrï+ÞîDL	îJlï+Þtï+ÞîObï+Þî‘ï(ñrî˜î•îÏî¼î![î'
î(Þî+¡ï(ñî	ôï%€tîîï%€xï%€î<1D>ï%€tï%€îXîXï%€xï%€î#²ï%€tï%€î$‰î$‰ï%€xï%€î-€ï%€tï%€î.Wî.Wï%€xï%€î3†ï%€tï%€î4]ï%€rï%€îDL	îJlï%€tï%€îObï%€î‘ï"“rîÖî	î¬î$î%Nî'›î,qî/Mî2ïî6¼î9Î
î;ŒîB]
îDîIîIl
îJÁîJÁï"“î‘ï Éxîëï Érï ÉîoîË
îÏ	î$?î&½î*þî,'î.Œî1W
î2Áî2Áï Étï Éî8¢ï Érï Éî9~î<¡î>þîEîJÁîJÁï Éî‘ïöî/î
îÅîO
î×î×ïöxïöî"1ïörïöî"¼î(î)Oî.ê
î0œî3î7Êî;T
î<¯î?¬î?¬ïötïö
îHéïörïöîIA
îJÁîJÁïöî‘ï#
îwîÖî¢î Þî&
î'šî)Öî,rî,Õ
î.‚î0Nî3Èî7oî7oï#tï#îDßï#rï#îEBîIÅîJÂîJÂï#î‘ïPî9îs	îeïPî	ôïßz
î<11>î¿î!
îÜî

î%]ïßrïßî&Gî&Ûî)¿î/Øî5Þî9Ÿ
î;¾î>*	îCÍîIA
îJÁîJÁïßî	ôïôî“îŠïôî	ôïƒtîdîdïƒxïƒî¾ïƒtïƒî•î•ïƒxïƒî&Œïƒtïƒî'cî'cïƒxïƒî,’ïƒtïƒî-iïƒrïƒîDL	îJlïƒtïƒîObïƒî‘ï–rî›î›îÙîÉî"³î$Æ
î,<2C>î.Ãî1…î7Tî7Tï–xï–î<®ï–rï–î=`î=¼î=¼ï–xï–îCï–rï–îCq
îD²îJÁîJÁï–î‘ï
Ì
î,îZîXî <20>î$4î)xî/ä
î1äî:4î;Yî>Ž
îF8
îH<C3AE>îJÁîJÁï
Ìî‘ïtî|ïrïîÔî ®î"½
î)š
î+%î+%ïxïî4ïrïî4tî6ýî6ýïxïî<,ïrïî<‰ïg
êq?€`½Ô20(\GENERATENEXTFILEGENERATORNAMEONLY)[Function]Returnsthenextfile,asastring.GENERATORistheobjectreturnedfrom\GENERATEFILES;NAMEONLYindicatescallerdoesnotrequirethatthefullnamebereturned,butthatthenameandextensionaresufficient.(\GENERATEFILEINFOGENERATORATTRIBUTE)[Function]ReturnsthevalueoftheATTRIBUTEpropertyofthefilemostrecentlygeneratedby\GENERATENEXTFILE,i.e.,effectively(GETFILEINFOlatest-nameATTRIBUTE).ATTRIBUTEmusthavebeenamemberoftheDESIREDPROPSargumentto\GENERATEFILES.(DIRECTORY.FILL.PATTERNPATTERNDEFAULTEXTDEFAULTVERS)[Function]ThisfunctionisusedtofillindefaultsinPATTERNbeforepassingitto\GENERATEFILES.IfPATTERNdoesnotincludeanextensionorversion,butthosefieldsarenotexplicitlyomitted(e.g.,``FOO'',butnot``FOO.'';``FOO.BAR'',butnot``FOO.BAR;''),theyarefilledinwithDEFAULTEXTandDEFAULTVERS,whichthemselvesdefaultto``*''.ThisfunctionisusedbytheDIRcommand,andshouldprobablybeusedbyanycodethattakesauser-suppliedpatternandenumeratesfilesfromit.î<‰ïî
êïførî	ôïhsp
îLïhsî	ôïb
tîéîéïb
xïb
î!ïb
tïb
î!Üî!Üïb
xïb
î(˜ïb
tïb
î)oïb
rïb
îDL	îJlïb
tïb
îObïb
î‘ï_rîÉî,î>î

î´î âî%î%šî%šï_xï_î,¶ï_rï_î-?
î.¯î1î5*î:Åî>.î>.ï_tï_
îIðï_rï_îJÁîJÁï_î‘ï]AxîMï]Arï]Aî±î;î Ëî#Øî&*î*Îî-yî/¶î2î5º
î7‰î=Wî?µîB`îD<C3AE>îH9îJÂîJÂï]Aî‘ï[wî}î£
îsï[wî	ôïXtîéîéïXxïXî!ïXtïXî!Üî!ÜïXxïXî(sïXtïXî)JïXrïXîDL	îJlïXtïXîObïXî‘ïUrî`îXîš
îìî"åî"åïUxïUî)|ïUrïUî*›î0Ì
î3î6î9î=
îBÚîHô
îJÂîJÂïUî‘ïSOtîØïSOrïSOîÀî"]
î(úî(úïSOtïSOî3ïSOrïSOî3Ÿ
î:íî:íïSOxïSOîA„ïSOtïSOîB[ïSOrïSOîCBîCÒîCÒïSOxïSOîJiïSOrïSOîJÁîJÁïSOî‘ïQ|îÊîâîî
î K
î!Öî$î$ïQ|xïQ|î,þïQ|rïQ|î-Vî3O
î4Ïî4ÏïQ|tïQ|
î@‘ïQ|rïQ|î@îïQ|î	ôïNtîîïNxïNî#vïNtïNî$Mî$MïNxïN	î+ÿïNtïNî,Öî,ÖïNxïN
î5JïNtïNî6!ïNrïNîDL	îJlïNtïNîObïNî‘ïKrî³î1
î§îë
î£î!Ñ
î#‰î(»
î*sî*sïKxïKî/ÍïKrïKî0\î4³î9<C3AE>
î:í
î<¤î<¤ïKtïK
îHfïKrïKîIîIm
îJÂîJÂïKî‘ïIBxîëïIBrïIBîRîbî·î s
î"Eî(@
î)åî.äî1Eî4Ãî8Vî:‹î<à	îB¢îG•îJÁîJÁïIBî‘ïGx
îAïGxtïGxîÆïGxrïGxî6î˜îí
î<1A>ïGxtïGxîùïGxrïGxîŠ
î :ïGxtïGxî&ïGxrïGxî'‹î)íî,C
î,óïGxtïGxî3«ïGxrïGxî5”î8…î:»î>-
î?½îB·îB·ïGxxïGx	îJiïGxrïGxîJÁîJÁïGxî‘ïE¥î+î+ïE¥xïE¥
îŸïE¥rïE¥î_î M	î'î+¤
î-4î0î0mî3hî8À
î:î=,
î?îAMîAMïE¥tïE¥îCÒïE¥rïE¥îD:îJÁîJÁïE¥î‘ïCÒî3î–îN
î*î"P
î$7î&Ãî)óî,«î0î1(î9Šî>1î@Ó	îHîJÁîJÁïCÒî‘ïBîÉîðïB»
êq?€`½Ü

é
TIMESROMAN

	
é	HELVETICA

é
TIMESROMAN


é	HELVETICA


é
TIMESROMAN

é
TIMESROMAN


~GACHA

é
TIMESROMAN

é
TIMESROMAN



é
TIMESROMAN
~GACHA
j
^
/%å3óA'O_[€g€r”~	‡“NŸ4ª¶
ÒÃ4ÎÙ÷äE
é
Oj/ìê
ÿÿ<C3BF>ןg

ÿÿÿÿÿÿ{DSK3}STREAMS.TEDIT;23VANMELLE30-Nov-84 14:17:38