þz"}cœZ0Portable UPDNODES Installation and User's Guide) ²ô¨x_”UPDNODES % Contents Tables  * Index}"''+”©©TABLESTABLESW”\) =@1²@Tested Environments1 Tested EnvironmentsL”l=@1-1ÿ ComponentFiles1- 1 Component FilesS”\##=@2-1ÿFileNameDefaults2- 1 File Name Defaults<Û Û /”© ªCONTENTSCONTENTS8”ˆ E[TitlePageTitle Page@”ˆE\ CopyrightPageCopyright Page1”xE\PrefacePreface b”w++$L1¾ InstallingPortableUPDNODES1 Installing Portable UPDNODESD”w$K1.1˜ Requirements1.1 RequirementsO”g""$K1.2˜FilesintheKit1.2 Files in the Kitw”À%:)$K1.3˜ Installation Procedure-&£VAX/VMS1.3 Installation Procedure - VAX/VMSy”À&;-$K1.4˜Pre-Installation Procedure-&¤Unix1.4 Pre-Installation Procedure - UnixM”l  $A1.4.1²Definingoldcc1.4.1 Defining oldccY”l&&$A1.4.2²Defining SHORT_NAMES1.4.2 Defining SHORT_NAMESa”l**$@1.4.3²DefiningWEIRD_BIT_ORDER1.4.3 Defining WEIRD_BIT_ORDERh”l!//$A1.4.4²SettingtheTypeofint16u1.4.4 Setting the Type of int16u m”l$11$A1.4.5² SelectingtheProperMakefile1.4.5 Selecting the Proper Makefile!i”g"//$L1.5˜ Installation Procedure-Unix1.5 Installation Procedure - Unix"w”À%:,$K1.6˜Post-InstallationTesting-&¤Unix1.6 Post-Installation Testing - Unix$U”\$$$A1.6.1² PerformanceIssues1.6.1 Performance Issues%u”À$9)$L1.7˜ Installation Procedure-&¤MS-DOS1.7 Installation Procedure - MS-DOS&u”À$9)$K1.8˜ Installation Procedure-&£RSTS/E1.8 Installation Procedure - RSTS/E(X”w&&$K2¾UsingPortableUPDNODES2 Using Portable UPDNODES+‹”À.E'$K2.1˜ ObtainingYourInitial&£BITEARNNODESFile2.1 Obtaining Your Initial BITEARN NODES File,f”l ..$A2.1.1²FromaNearbyBITNETsite2.1.1 From a Nearby BITNET site-e”\ --$A2.1.2²FromYourNearestNETSERV2.1.2 From Your Nearest NETSERV.`”w**$L2.2˜ ObtainingMonthlyUpdates2.2 Obtaining Monthly Updates0W”g%%$K2.3˜LISTSERV-PunchFormat2.3 LISTSERV-Punch Format4b”w++$K2.4˜InvokingPortableUPDNODES2.4 Invoking Portable UPDNODES6>”l$@2.4.1²Options2.4.1 Options7G”l$@2.4.1.1É-vOption2.4.1.1 -v Option8I”l$A2.4.1.2É-l#Option2.4.1.2 -l# Option9G”l$A2.4.1.3É-?'Option2.4.1.3 -? Option:O”\!!$@2.4.2²File Parameters2.4.2 File Parameters;I”w$K2.5˜ErrorMessages2.5 Error Messages>ˆ”Ð-C'$L2.6˜ ReportingProblemsand&¤ ObtainingUpdates2.6 Reporting Problems and Obtaining Updatesw+”©©TABLESTABLESW”\) =@1²@Tested Environments1 Tested EnvironmentsL”l=@1-1ÿ ComponentFiles1- 1 Component FilesS”\##=@2-1ÿFileNameDefaults2- 1 File Name Defaults<``zÚ½P0_* Copyright©1991TerenceM.Kennedy ~¤AllRights Reserved.pÚSFOËPortableUPDNODES*O: InstallationandUser'sGuide@ÚÞOÅMarch,1991m CTO{Thisdocumentprovides installationandusage instructionsforthePOÉportableUPDNODESprogram.+UPDNODESisautilitywhichappliesXOmonthlyupdatestothemasternodesdatabaseusedonBITNETandthe Oc cooperating networks.'Oþ"Doityourselfandsave"xÚÞN'OÅRevision/Update Information:'^ÅThisisarevisedmanual.ÖÚǬ*OÅ OperatingSystemandVersion:#^ÅVAX/VMSV4.4orlater,"^MS-DOSV3.2orlater,^`Unix (various),#^®RSTS/EV10.0orlater.aÚÞ7OÅSoftwareVersion:^ÅUPDNODESV1.3-04àà Æ† Ùœ)OãTable1:7Tested Environments Oþù OKHost Processor ;/13K OperatingSystemKCCompiler Ofù O®VAX86503®VMSV5.4-1®VAXCV3.2O(IBMPC3(MS-DOSV3.31( MicrosoftCV6.0AO¢Sun43¢SunOS4.1¢UnixC ø† 2O PDP-11/7032.11BSDUnixUnixC ø 2O• PDP-11/703•RSTS/EV10.0•PDP-11CV1.1 Oàù  O 1Nm: Shouldalsoworkonothermodelsinthesameproductline. O† 2Gm¢ Usingthecompilersuppliedwiththe operatingsystem. OÓù ÆÆ ‚ ŸX O•  OÚ¢O March,1991jO» Permissionisgrantedtocopyand redistributethisdocumentprovidedthecopiesare/Oýmadeforno commercial advantage.eO˜The informationinthisdocumentissubjecttochangewithoutnoticeandshouldfOÚnotbe construedasa commitmentbySaintPeter'sCollege.)SaintPeter'sCollege_Oassumesnoresponsibilityforanyerrorsthatmayappearinthis document.O¸ DISCLAIMER:HÕ¸Thesoftware describedinthisdocumentisprovided```¸asisì¸''.*NofOú guaranteeismadebytheauthorortheauthor'semployerastothe suitability,TO= reliability, security, usefulness,or performanceofthis software.WOØRSTS/E,VAX,andVMSare trademarksofDigital Equipment Corporation:Os PostScriptisa trademarkofAdobeSystems>OMS-DOSisa trademarkof Microsoft Corporation*O©Unixisa trademarkofAT&T OA�0O† Copyright©1991TerenceM.Kennedy* ZZ  £ ÚyOàPrefaceLO§Thismanual describeshowtoinstallandusetheportableOUPDNODESprogram.± öa‡DOƒTheBITEARNNODESfileisthemaster repositoryofKOÜ informationaboutallnodesonBITNETandthe cooperatingMO5 networks.)Assuch,various applicationprogramsrefertoitRO�for information.+Thisfileisquitelarge(asofthiswriting,VOæitisover3.5 megabytes).*Thus,itistoolargetoshiptoallPO>nodeseverymonth.)Instead,aspecialupdatefileisshipped,JO—givingonlythechangesmadeinthepreviousmonth.+TheJOïUPDNODESutilityappliesthisupdateand generatesanewOHBITEARNNODESfile.?  BOƒUntilnow, there wereonly twoimplementations of?OÜUPDNODES-theoriginalimplementationbyPeterHO5 SylvesterandBertholdPasch,inIBMVSPascal,andaPO�partialversioninportablePascalbyEd Skochinski.'WiththeLOæadventofnon-IBMnodesonBITNETandthe availabilityofMO>toolswhichusethenodesfile(suchasPAROUTE)fornon-KO—IBMsystems,theneedforaportableversionofUPDNODESOïbecameclear.Ê ! W DOƒThismanual describesaversionofUPDNODESwrittenNOÜinportableANSIC.Cwaschosenbecauseofthe widespreadNO5 availabilityofgoodC compilers.'Infact,portableUPDNODESOO�performsquitewellonsystemssuchastheIBMPC,soevenSOæifyourBITNEThostcannotrunit,youmaybeabletouseitO>onanothersystem.¹ÚN�FOƒPortableUPDNODEShasbeentestedinvariousenviron-7OÜments,asshowninthe followingtable:O5Table1*Oø'?ËË  ±ú£‡O£IntendedAudienceKO(Thismanualisintendedforsystemmanagersand operatorsIO€withsystem privileges.-YoushouldbefamiliarwiththeKOÙ operatingsystemonyourmachineaswellasthesoftwareMO1linkingyoursystemtoBITNET.Youshouldalsobefamiliar?OŠwithvariousaspectsofBITNETnode management.BB  }ÚnSOÐDocument Structure6OUThisdocumentconsistsoftwo chapters.«Úv�FOãChapter1â Describeshowtoinstallportable UPDNODES.;O]Chapter2â Describesusingportable UPDNODES.vv  äÚºOÐRelated DocumentsEOUYoucanfind additional informationinthe following@O­ documents, availablefromLISTSERV@BITNICoryourOlocalNETSERV:x rN `¡ ·=Ô¡UPDATEPROCEDUR- Procedureforupdatingyour4Ôúhost information(BITNETmembersonly) `y ·>ÔyNETSERVHELPFILE- Procedureforupdatingyour.ÔÒhost information(other networks) `Q ·?ÔQUPDNODESDESCRIPT- DescriptionoftheoriginalÔªUPDNODESprogram `) ·CÔ)NODESFMTDESCRIPT- Descriptionofthecontentsof+Ô�BITEARNNODES(currentformat) ` ·BÔNEWTAGSDESCRIPT- Descriptionofthecontentsof0ÔYBITEARNNODES (forthcomingversion)·· �ÿ s,O 1.2 Installing!Portable"UPDNODESMO‘Thischapter describesthe procedurefor installingportableHOê UPDNODES.Sincevarious operatingsystemshave differentGOBmethodsfor compilingand installing programs,youmayJO›havetorefertoyour operatingsystem documentationfor!Oódetailed instructions.>ww]‰ s 3'OãTable1-1:7 ComponentFiles Oþù OFFilename3F Description Obù Oª CHECKSUM.ASM53ªAssemblychecksumroutineforIBMPC'sO$CHKSUM.C%3$Checksum computationcodeOž COMPILE.PC43žScriptfiletocompileonanIBMPCO COMPILE.RSTS/3ScriptfiletocompileonRSTS/EO‘ COMPILE.VMS03‘ScriptfiletocompileonVAX/VMSO IO.C3 I/OroutinesO…LOG.C3…LoggingroutinesOþ MAKEFILE.2BSD&3þMakefilefor2.11BSDUnixOx MAKEFILE.PC 3xMakefileforIBMPCOò MAKEFILE.SUN#3òMakefileforSunOS4.1Ol MAKEFILE.VMS 3lMakefileforVAX/VMSOåMERGE.C+3åMergesupdatesintonodefileO_PARSE.C3_TagparsingcodeOÙ UPDNODES.C3ÙMainprogramOS UPDNODES.H3SCommon definitionsOÌ UPDNODES.PS,3ÌThisfile- PostScriptversionOF  UPDNODES.TXT'3F Thisfile-ASCIIversion Om ù GG-! ìOÐ1.1B Requirements `{ ·KÔ{ThesourcefilesforportableUPDNODES(seesection1.2). `û ·ÔûAC compiler. `z ·FÔz SufficientfreediskspacetostoreUPDNODESandtheÔÓnodes database(s).__ wñ"OÐ1.2BFilesintheKitPOUTheportableUPDNODESkitconsistsofthe followingfiles.'IfGO­youreceivedtheUPDNODESPACKAGEyoushouldhaveall$Oofthesefilesalready.O^Table1-1*O!q?xGG"Ú6ø2O£1.3B Installation Procedure-VAX/VMSRO(Placealloftheabovefilesina directoryby themselvesand#O€issuetheDCLcommand:O $& @COMPILE.VMS �Ì  �ÎM¦ RETURN šÎM �   äßFO·YoushouldnotreceiveanyerrorsorwarningsduringBO compilation.2Youmay now copy the executable fileFOi UPDNODES.EXEtoa convenientlocationonyoursystem.LOÁYoushouldprobablycopythe documentationtowhereveryouSOstoresuchfiles.'IfspaceisatapremiumyoumaydeletetheNOrsourcefilesaswellasthe temporaryfilesproducedduring$OËthe compilationprocess. œØIOƒYoushouldnowdefineasymboltoinvoke UPDNODES.YouPOÜmayeitherplacethe definitioninoneofyourinitializationOO5files,suchas LOGIN.COM,oryoumaytypeitineverytimeGO�youwishtorun UPDNODES.DefinethesymbolasshownOæbelow:Ok $&UPDNODES&:==%$¤k disk :k :[„k directoryÔk ]UPDNODES.EXE ð1  ð3Mh RETURN ú3M ð�   ½ñГ3OÐ1.4BPre-Installation Procedure-UnixSOUPlacealloftheabovefilesina directoryby themselves.)YouOO­willmostlikelyhavetoeditthe UPDNODES.HfiletodefineMOyourUnixvariant.,Searchforthefirstinstanceof"unix"TO^inthefile.*Youwillneedtosetthe followingitemsforyourO· particularsystem:ï! ¥Å OÐ1.4.1BDefiningoldcc O4If£4oldccK’4isdefined,"classicC"stylefunction prototypeswillbe?OŒused.' Additionally, SHORT_NAMESwillbedefined.… V[&OÐ1.4.2BDefining SHORT_NAMES O4If¤4 SHORT_NAMES9M4isdefined,variablenameswillbeuniqueHOŒwithinthefirst6 characters,inorderto accommodateEOåsystemswherethelinkercannot differentiatebetweenNO=symbolswhicharenotuniquewithinthefirst6 characters.J! ` *OÐ1.4.3BDefiningWEIRD_BIT_ORDERLO4TheANSIstandardstatesthattheorderofbitswithinaIOŒ structureelementisimplementation-specific.'ThechecksumROåroutinesusebitfieldsandneedtoknowhowbitsarepacked.MO=ThemostcommoncasehasthehighbitfirstandthentheKO–lowbits.*AllsystemsthatI'vetriedUPDNODESonexceptSOîtheSunsuse"normal"bitorder.'Ifyoursystemdoesn't,defineOGWEIRD_BIT_ORDER ŸG.Å ! V›/OÐ1.4.4BSettingtheTypeofint16uEO4Sincevarioussystemshave differentwordlengths,a²4typedef º4isSOŒusedtodefinetheproperformatofa16bitunsignedinteger.2OåFormostsystemsitwillbeeither åunsignedintøå(for16bitO= processors)orX=unsignedshort%†=(for32bit processors).«!ï¯�1OÐ1.4.5B SelectingtheProperMakefilewellasthe temporaryfilesproducedduringthe compilationO—process.rrë$! 2Á2OÐ1.6BPost-InstallationTesting-UnixKOUYoushouldnowperformatestupdateruntoverifythatFO­portableUPDNODESisworkingproperlyonyoursystem.MOAlmostallincompatibilityproblemsmanifestinthechecksumRO^ routines,foundinthefile CHKSUM.C.ThebestthingtodoifOO·youdiscoverchecksumproblemsistoplace debuggingprintf'sLOinthecodeandusethesampledatagivenintheCHKSUMEOhASSEMBLEfile (availablefromLISTSERV@BITNIC)toseeMOÁwherethingsaregoingwrong.'Usuallytheproblemsaredue2Otobyteorderingorsimilarissues.m%èÂC$OÐ1.6.1B PerformanceIssuesKO4Atleast35%oftheCPUtimeisspentinthewrotl( )EOŒ function..Anythingyoucandotoimprove performanceMOåthereiswellworthit..TheeasiestwayoutistorecodeIO=thefunctioninassemblylanguage(aswasdonefortheFO–MS-DOSimplementation).+Therearetwoversionsofthe+Oîwrotl( ) function,ifdef'don-îSIMPLE"rî.ThedefaultistheJOGcomplexversion,whichrunsfasteronCISCmachinessuchMOŸastheVAX.FormostRISCarchitectures,the differenceinKOø executiontimewithSIMPLEisnotenoughtomakeittheNOQdefault.*Itisprovidedmainlyasanexampleofwhatyou'd&O©needtodoin assembler.ppM&ö¼#1OÐ1.7B Installation Procedure-MS-DOSNOUPlacealloftheabovefilesina directoryby themselves.DO­Renamethefile COMPILE.PCto COMPILE.BATandissueOthecommand:O‹ COMPILE ŠQ  ŠSM¡ˆ RETURN •SM Š¡  ' °ßFOƒYoushouldnotreceiveanyerrorsorwarningsduringBOÜ compilation.2Youmay now copy the executable fileFO5 UPDNODES.EXEtoa convenientlocationonyoursystem.LO�Youshouldprobablycopythe documentationtowhereveryouSOæstoresuchfiles.'IfspaceisatapremiumyoumaydeletetheNO>sourcefilesaswellasthe temporaryfilesproducedduring$O—the compilationprocess.¶¶ú( mÐ1OÐ1.8B Installation Procedure-RSTS/ETOUPlacealloftheabovefilesina directoryby themselves.'NoteIO­thatRSTS/Ewilltruncate filenamesto6 charactersandKO filetypesto3 characters.(AlloftheUPDNODES componentsPO^willstillhaveuniquenamesaftersuch truncation.(IssuetheO·DCLcommand:O< $& @COMPIL.RST j  jM�: RETURN uM jR  ) °ßFOƒYoushouldnotreceiveanyerrorsorwarningsduringBOÜ compilation.2Youmay now copy the executable fileFO5 UPDNODES.TSKtoa convenientlocationonyoursystem.LO�Youshouldprobablycopythe documentationtowhereveryouSOæstoresuchfiles.'IfspaceisatapremiumyoumaydeletetheNO>sourcefilesaswellasthe temporaryfilesproducedduring$O—the compilationprocess.™*ì êoAOƒYoushouldnowdefineaCCLtoinvoke UPDNODES.JOÜYoushouldplacethe definitionyourinitializationfile,AO5[0,1]START.COM.Definethesymbolasshownbelow:-O¹ $&DEFINE/COMMAND/SYSTEM% UPDNODES-D¹ disk Ú¹ :[ $¹ ppn”¹ ]UPDNODES.TSK °€  °‚MÆ· RETURN º ‚M °Ï SS9+! ['O 2.2Using!Portable!UPDNODESRO‘Togenerateanewmasternodesfile,youwillneedapreviousKOêversionofthemasternodesfile(BITEARNNODES)andoneKOBormoreupdatefiles,alongwiththeUPDNODES executable.tZZ�, ws=OÐ2.1B ObtainingYourInitialBITEARNNODESFileMOU Obviously,beforeyoucanapplymonthlyupdatesyou'llhaveWO­tohaveafiletoapplytheupdatesto.(Thus,you'llhavetogetKOacopyofthecurrentBITEARNNODESfile.(TherearetwoGO^possibleplacestogetthisfile,as discussedbelow.’-èVh.OÐ2.1.1BFromaNearbyBITNETsiteLO4IfyouknowthatoneofyournearbyBITNETsiteshasanNOŒ up-to-datecopyofthefile,youcanrequestitfromthem.WOåSincethefileisquitelarge,gettingitfromanearbysitewillIO=reducenetworkload,andyou'llgetitfasteraswell.ê.! 4À-OÐ2.1.2BFromYourNearestNETSERVSO4Ifnoneofyour neighboringsiteshasacopyofthefile,youKOŒcanrequestacopyfromyournearestNETSERV.YoushouldJOåeitheralreadyknow,orfindoutnow,wherethenearestHO=NETSERVis.'Usingwhatevermethodyour operatingsystemFO–usesfor interactiveSEND commands,sendthecommand:O GET%BITEARN%NODES'/! ¦ýIOƒtoyournearestNETSERV.TheNETSERVwillthentransmitVOÜthelatestversionofthefiletoyou.*PleasebepatientasthisNO5processmaytakeseveraldays(butyouonlyhavetodoitO�once).òòõ0ýUË*OÐ2.2B ObtainingMonthlyUpdatesIOUUpdatesareissued approximatelyonceamonth, generallyQO­onthefirstfullweekend.*Thebestwaytoensureyou'llgetJOtheupdatesisto subscribetothemusing NETSERV'sAFDLO^ (AutomaticFile Distribution) mechanism.(Toaddyourselfto:O·thelistof subscribers,sendthecommand:O< AFD%ADDz< passwordÊ< *%NODUPDO1Úœ%%OƒtoyournearestNETSERV.2 ÒØTOƒIfyourcopyofthemasternodesfileisoutofdate,youmayNOÜrequest"backissues"oftheupdatefilesfromNETSERVwithO5thecommand:O¹ GET%VERSyynn%NODUPD’3èõhLOƒNotethatNETSERVwillnothaveupdatefilesmorethanaOÜyearorsoold.ºº <Ú~v+OãTable2-1:7FileNameDefaults Oþù OKFileName …/13K Description Ofù O® UPDATE.NODUPD3®UpdatefilenameO( BITEARN.NODES3(InputfilenameO¢ BITEARN.NEW3¢Outputfilename Oìù  O+ 1NmG UppercaseonallsystemsexceptUnix,lowercaseonUnix. Oxù ººã4Ú­¹%OÐ2.3BLISTSERV-PunchFormatKOUItisquitelikelythattheNODESandNODUPDfileswillDO­beshippedinaformatknownasLISTSERV-Punch(orOLPUNCHA´).AnLPUNCH converteristrivialtowrite,andGO^oneis availableforVAX/VMSsystemsfromtheVMSSERV>O·fileserveratVMSSERV@FHCRCVAXbysendingtheOcommand:O” GET%BITNET.PACKAGE½5þõ“VOƒNotethatthereisaperiodinthis filename,notaspaceasin=OÜtheother filenamesyourequestfromservers.ù ù â6 ó¸+OÐ2.4BInvokingPortableUPDNODESDOUThegeneralformforinvokingportableUPDNODESis:IOÚ updnodes% [options]%[[[update_file]& input_file]& output_file]ì7 þÂOÐ2.4.1BOptionsRO4Variousoptionsare availabletotunethe operationofportableFOŒ UPDNODES.NormallyyouwouldnotneedtospecifyanyOåoptions.û8ÚýÑOÅ2.4.1.1C-vOption O)The ú)-v:j)option provides verbose messages while pro-HO�cessingthe updatefile.1AmessageisloggedforeachDOÚADD/REPLACE/DELETEaction,aswellasforthefinalEO3checksum validations.*An"a"maybeappended(asin ö3-va v3)LO‹toprovideevenmoreoutputfor debugging purposes,orto,Oäsatisfythe terminallycurious.u9è®KOÅ2.4.1.2C-l#Option O)The ö)-l#I‚)optionlimitsthelinelengthoftheoutputfileto#JO� characters.,Thedefaultis240,whichproducesanoutputDOÚfile identicaltothatoftheEARNUPDNODESPASCALPO3program.)Sincesuchafileishard(forhumans)toread,anKO‹optionsuchas-l80maybegiventoproducea terminal-HOäwidthoutput file.1Such outputfiles shouldbetreatedFO< identicallybyanyprogramwhich manipulatesthenodeO• database.Z:ÚL0OÅ2.4.1.3C-?!Option O)The ö)-?Dq)optiondisplaysashorthelpandusagemessage.+ItGO�alsogivestheversionoftheUPDNODESprogram.,SinceJOÚquestionmarksarenormallyglobbedonUnixsystems,you%O3mayspecify-haswell.7; V !OÐ2.4.2BFile ParametersRO4Youmayspecifythefilenamestobeusedintheupdaterun.KOŒIfyoudonotspecifyafilename,UPDNODESwillusea;Oådefaultname,asshowninthetablebelow:O=Table2-1*;O|?<æ=ñ·¼IOŠFromthis, itcanbeseenthatifyouinvokeportable@OãUPDNODESwithasinglecommandlineargumentofAO<VERSyynn.NODUPD,UPDNODESwillapplythoseupdates@O”tothefileBITEARN.NODES, producing BITEARN.NEW.IOíOnceyouare satisfiedthattheoutputiscorrect, you@OEmaydeletetheoriginal BITEARN.NODESandrename)Ož BITEARN.NEWtoBITEARN.NODES.]])”©ªINDEXINDEX!”i  ÓiAA)”S  Ê9AFDAFD0!”i  ÓiCC)”S  Ê9CCLCCL)!”i  ÓiEE@”SÊ8ErrormessagesError messages>!”i  ÓiII/”SÊ8int16uint16u !”i  ÓiLL?”SÊ8LISTSERV-PunchLISTSERV-Punch4/”SÊ9LpunchLpunch4!”i  ÓiMM<”S Ê8MailinglistMailing listz3”S Ê8makefilemakefile!/”S Ê9MessagesMessages-”SN8ErrorError>/”SÊ8MS-DOSMS-DOS&!”i  ÓiOO-”SÊ9oldccoldcc1”SÊ8OptionsOptions6!”i  ÓiPP9”S Ê8 PerformancePerformance%/”S Ê8ProblemsProblems5”S N9 ReportingReportingw!”i  ÓjRRH”SÊ8 ReportingproblemsReporting problemsw;”S Ê8 RequirementsRequirements/”SÊ9RSTS/ERSTS/E(!”i  ÓjSS9”S Ê8 SHORT_NAMESSHORT_NAMES!”i  ÓiTT1”SÊ8TestingTesting$1”SÊ8typedeftypedef !”i  ÓiUU+”SÊ9UnixUnix1”SÊ8UpdatesUpdatesw!”i  ÓiVV)”S  Ê8VAXVAX)”S  Ê9VMSVMS!”i  ÓiWWA”SÊ9WEIRD_BIT_ORDERWEIRD_BIT_ORDERA A 9\>üw2OÐ2.5BErrorMessagesDOUPortableUPDNODEScanreturnseveralerror messages.>O­Allsucherrormessagesbeginwiththeprefix ȹ***B­Error: E­andLOthenhaveadetailedmessagetext.)TheerrormessagesandO^ explanationsare:¶?ÚiŒO ADD%forz node4 without%DEL%forŠ node  .OP Doing%auto&DEL%forP node ªP .Œ@ÚõbHOƒTheupdatefilehadanADD statementforanodethatOÜalreadyexists.wAÚ!M*O Attempt&to&ADD%existing%nodeŠ nodeD -%ignored.ŒBÚõbHOƒTheupdatefilehadanADD statementforanodethatOÜalreadyexists.zCÚ!P-O Attempt&to&DEL% nonexistent%nodeú node´ -%ignored.‹D! õaQOƒTheupdatefilehadanDEL statementforanodethatdoesn'tOÜexist.zEÚ!P-O Attempt&to&REP% nonexistent%nodeú node´ -%ignored.‹F! õaQOƒTheupdatefilehadanREP statementforanodethatdoesn'tOÜexist.“GÚ!i!O Base&file%version%is_ versiond ,%delta%is%for” version š .ÅH õ›UOƒThisisnottheproperupdatefileforthebasefile.'MakesureFOÜyouhaveappliedall interveningupdatesin sequence.ÎIÚi¤O Checksum%for%entry node'Ï invalid&for%original%base.OP Verification:ZP dec/hex_P ,& Calculated:jP dec/hex¹J õ�VOƒThedatafoundintheoriginalfilewasnotcorrect,orthereis9OÜaproblemintheUPDNODESchecksumlogic.ÓKÚi©O Checksum%for%entry node,Ï invalid&for%output% information.OP Verification:ZP dec/hex_P ,& Calculated:jP dec/hex©LìõROƒThecreatedoutputdataisnotcorrect,orthereisaproblem-OÜintheUPDNODESchecksumlogic.MÚ!UO DEL%forz node ,&butï nodeª non-existent.‹N! õaQOƒTheupdatefilehadanDEL statementforanodethatdoesn'tOÜexist.TOÚ!**O Error(s)%detected%during%run.‹PÚõaHOƒSummarymessagegivenatendofrunwhenothererrorsOÜwere detected.ZQÚ!0O ftell(base)%returns: positionJRÚœ  OƒProgramlogicerror.cSÚ!9'O fgetpos(base,&&cur)&returnsd positionJTÚœ  OƒProgramlogicerror.wU !MMO get_base_tag:&Ooops!%Base&line%shorter%than&major&tag%name.JVÚœ  OƒProgramlogicerror.¿WÚi•DO Input%:totcks.%tag%doesn't%match% calculated&:totcks.OP Verification:ZP dec/hex_P ,& Calculated:jP dec/hex³Xóõ‰QOƒTheoverallchecksumfortheinputfileis incorrect.(Possible8OÜ corruptedfileorUPDNODESprogramerror.yYÚ!OO Invalid&action action „ for node ¯ .©Z! õSOƒTheactionfieldintheupdatefilewasnotADD,DEL,orREP.,OÜPossible corruptedupdatefile.h[Ú!>"O Invalid&line%length&"_ length ? ".�\ õfUOƒTheuser requestedalinelengththatwaslessthan1ornotaOÜnumber.„]ÚiZ2O Line&found&without%tag...&Line%was: OP >>>¿P text TP <<<®^Úõ„LOƒAlinewasreadwhichdidnotcontainanytags.,Possible8OÜ corruptedfileorUPDNODESprogramerror.T_Ú!**O Major-level%tag%is%too&long.™`ÚõoLOƒAnodenametagwastoolong.,Possible corruptedfileor#OÜUPDNODESprogramerror.ZaÚ!00O min_find:%NULL%maj%pointer%passed.JbÚœ  OƒProgramlogicerror.pcÚ!F%O No%:totcks.%tag%in%baseÏ versionú entry.íd NÃPOƒAnattemptwasmadetoprocessaversionentrythatdidnotOOÜhavetherequiredtotalchecksumtag.'Possible corruptedfile$O5orprogramlogicerror.qeÚ!G&O No%:totcks&tag%in%outputô version entry.ëf NÁNOƒAnattemptwasmadetowriteaversionentrythatdidnotOOÜhavetherequiredtotalchecksumtag.'Possible corruptedfile$O5orprogramlogicerror.ZgÚ!00O No% major-level%tag%in%Nodes%file.´hÚõŠHOƒUPDNODEScouldnotlocateanytagsintheinputfile.BOÜPossible corruptedfileorUPDNODESprogramerror.SiÚ!))O No% resulting%VERSnnnn%entry. j! õvLOƒTheVERSnnnnentrywasdeletedandnonewonewasadded.*OÜPossiblecorruptupdatefile.¿kÚi•O This&version%(Z version$_ )&is&not%smart%enough.*OP You%require%at%least%versionŠP version �P .ƒlÚõYFOƒThe update file said it requires a newer release ofOÜ UPDNODES.PmÚ!&&O Too%many%files% specified.‡nÚõ]EOƒTheuserenteredmorethanthreefilenamesontheOÜcommandline.xoÚ!N)O Unable%to%add&new%tags&for? nodeú -%all&used.ÔpÚNªKOƒThereweremorethan75tagsinanodeentry.* Recompile?OÜtheprogramwiththe TAGS_IN_NODE definitionin O5 UPDNODES.H increased.}qÚ!SO Unable%to%open type: file%" name ¯ ".lrÚœBBOƒUPDNODESwasnotabletoopenoneofthefiles.jsÚ!@@O Update%file%does&not%contain&any%known%actions.èt N¾TOƒTheupdatefileyou submittedisnotanupdatefile,orisnotQOÜintheproperformat.'Possiblyithasnotbeen convertedfromO5LPUNCHformat.Éuf iŸNO Updated&:totcks.&tag%doesn't&match& calculated%output&:totcks.OP Verification:ZP dec/hex_P ,& Calculated:jP dec/hex´v õŠROƒTheoverallchecksumfortheoutputfileis incorrect.'Possible8OÜ corruptedfileorUPDNODESprogramerror.££ÊwÚР;OÐ2.6B ReportingProblemsand ObtainingUpdatesDOUWhileportableUPDNODEShasbeen extensivelytested,IO­problemscanarisedueto unforeseenconfigurations,newMOversionsofrelated software,or oversights.-IfyoufindaHO^probleminportable UPDNODES,pleasecontacttheauthorCO·andreportitusingoneofthe followingmethods:ÒxÚ±¨OƒNetworkmail:O terry@spcvxa.spc.eduD (Internet)OP terry@spcvxa.bitnetDP (BITNET)/O˜ ...!rutgers!njin!spcvxb!terryº(UUCP)ëyÚAÁOƒRegularmail:!O Saint%Peter's&College$OP Academic%Computer%CenterO˜ 2641&Kennedy%Blvd.'Oà Jersey%City,%NJ%07306%USAO( Attn:%Terry%Kennedy^zÚ!4OƒBy telephone:O +1%201%435&0252º{ W�FOƒPortableUPDNODESandothertoolsfornode managementDOÜare discussedontheNODMGT-Lnetworkmailinglist.IO5 Announcementsofnew versions,bugfixes,etc.-arealsoQO�madeviathismailinglist.(To subscribe,sendanetworkmailBOæmessagetoLISTSERV@BITNICwiththetext SUBSCRIBEO>NODMGT-LN>your-real-nameÀ|ÚN–BOƒNewversionsofportableUPDNODESandothertools@OÜare availablefromLISTSERV@BITNIC(intheTOOLSO5 FILELIST).*}aþþ Ù Ù PrefacePrefacePrefacePrefacePreface#Table 1: Tested EnvironmentsIntended AudienceDocument StructureDocument StructureRelated DocumentsRelated Documents&1. Installing Portable UPDNODES1.1 Requirements1.2 Files in the Kit"Table 1- 1: Component Files+1.3 Installation Procedure - VAX/VMS+1.3 Installation Procedure - VAX/VMS+1.3 Installation Procedure - VAX/VMS,1.4 Pre-Installation Procedure - Unix1.4.1 Defining oldcc!1.4.2 Defining SHORT_NAMES%1.4.3 Defining WEIRD_BIT_ORDER'1.4.4 Setting the Type of int16u*1.4.5 Selecting the Proper Makefile(1.5 Installation Procedure - Unix(1.5 Installation Procedure - Unix+1.6 Post-Installation Testing - Unix1.6.1 Performance Issues*1.7 Installation Procedure - MS-DOS*1.7 Installation Procedure - MS-DOS*1.8 Installation Procedure - RSTS/E*1.8 Installation Procedure - RSTS/E*1.8 Installation Procedure - RSTS/E!2. Using Portable UPDNODES42.1 Obtaining Your Initial BITEARN NODES File&2.1.1 From a Nearby BITNET site&2.1.2 From Your Nearest NETSERV&2.1.2 From Your Nearest NETSERV$2.2 Obtaining Monthly Updates$2.2 Obtaining Monthly Updates$2.2 Obtaining Monthly Updates$2.2 Obtaining Monthly Updates 2.3 LISTSERV-Punch Format 2.3 LISTSERV-Punch Format%2.4 Invoking Portable UPDNODES2.4.1 Options2.4.1.1 -v Option2.4.1.2 -l# Option2.4.1.3 -? Option2.4.2 File Parameters%Table 2- 1: File Name Defaults2.4.2 File Parameters2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages2.5 Error Messages32.6 Reporting Problems and Obtaining Updates32.6 Reporting Problems and Obtaining Updates32.6 Reporting Problems and Obtaining Updates32.6 Reporting Problems and Obtaining Updates32.6 Reporting Problems and Obtaining Updates32.6 Reporting Problems and Obtaining Updates32.6 Reporting Problems and Obtaining Updates¦ ¦123456789UPDNODES_211121314UPDNODES_3UPDNODES_4UPDNODES_518UPDNODES_620UPDNODES_7UPDNODES_8UPDNODES_9UPDNODES_10UPDNODES_112627UPDNODES_12UPDNODES_13UPDNODES_14UPDNODES_15UPDNODES_16UPDNODES_17UPDNODES_1835UPDNODES_19UPDNODES_20UPDNODES_2139UPDNODES_224142UPDNODES_23UPDNODES_24UPDNODES_25UPDNODES_2647UPDNODES_27495051UPDNODES_2853UPDNODES_29UPDNODES_30UPDNODES_31UPDNODES_32UPDNODES_33UPDNODES_34UPDNODES_3561UPDNODES_3663646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118UPDNODES_37120121122123124125 B-ADOBE-Helvetica-Medium-R-Normal--*-120-*-*-P-*-ISO8859-1@-ADOBE-Helvetica-Bold-R-Normal--*-180-*-*-P-*-ISO8859-1@-ADOBE-Helvetica-Bold-R-Normal--*-120-*-*-P-*-ISO8859-1@-ADOBE-Helvetica-Bold-R-Normal--*-100-*-*-P-*-ISO8859-1B-ADOBE-Helvetica-Medium-R-Normal--*-100-*-*-P-*-ISO8859-1@-ADOBE-Helvetica-Bold-R-Normal--*-140-*-*-P-*-ISO8859-1O-ADOBE-New Century Schoolbook-Medium-R-Normal--*-140-*-*-P-*-ISO8859-1M-ADOBE-New Century Schoolbook-Bold-R-Normal--*-140-*-*-P-*-ISO8859-1O-ADOBE-New Century Schoolbook-Medium-R-Normal--*-120-*-*-P-*-ISO8859-1O -ADOBE-New Century Schoolbook-Medium-R-Normal--*-100-*-*-P-*-ISO8859-1/ -ADOBE-Symbol-*-R-*--*-140-*-*-P-*-*-*@ -ADOBE-Courier-Medium-R-Normal--*-120-*-*-M-*-ISO8859-1> -ADOBE-Courier-Bold-R-Normal--*-120-*-*-M-*-ISO8859-1@ -ADOBE-Courier-Medium-O-Normal--*-120-*-*-M-*-ISO8859-1O-ADOBE-New Century Schoolbook-Medium-I-Normal--*-140-*-*-P-*-ISO8859-1ZúþQþRÙ Yò¦aš ` LÆ*Û 'Z jàpË>B‚vú·.Gx_´wÚG$ #,æ%r(ˆp)ú¶,²S-Z0dò3º4Ðù 2Xº>,A Np£:Ì]