home *** CD-ROM | disk | FTP | other *** search
/ synchro.net / synchro.net.tar / synchro.net / main / BBS / GWAR30.ZIP / GWIBBS.TXT < prev    next >
Encoding:
Text File  |  1996-12-31  |  8.2 KB  |  203 lines
  1.     Node  Node
  2.       \   /
  3. Node - Hub - Node     Global War InterBBS Technical Documentation
  4.       /   \
  5.     Node  Node
  6.  
  7.  
  8. Global War InterBBS Routing - OVERVIEW
  9. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  10.  
  11. Global War InterBBS networks are arranged with one central Hub connected
  12. to any number of Nodes.
  13.  
  14. All games must be Fixed Turn Order games. This is a new type of game in
  15. Global War 3.0 where players take their turns in sequence.
  16.  
  17. New games created on a Node are MOVED to the Hub. The Hub receives the
  18. new game, assigns it a game number, and adds it to its games area.
  19. Copies of the game are then sent to all Nodes.
  20.  
  21. New games created on the Hub are sent to all Nodes.
  22.  
  23. When any change occurs in a game, the Node sends a copy of the game to
  24. the Hub and the Hub sends copies of the game to all Nodes.
  25.  
  26. When changes to a game on the Hub occur, copies of the game are sent to
  27. all Nodes.
  28.  
  29. Score changes on a Node are saved in a file called updscore.war. When
  30. any scores change, this file is moved to the Hub. The Hub combines the
  31. score changes in updscore.war with those in the master (winners.war)
  32. score file. Copies of the updated winners.war file are then sent to all
  33. Nodes. If the upper limit of the rankings is exceeded (see war.cfg line
  34. 35) the Hall of Fame (HOF) utility is executed. HOF resets the ranks in
  35. winners.war and updates the Bulletin.Ans file. Bulletin.Ans is then sent
  36. to all Nodes.
  37.  
  38.  
  39.  
  40. GWIBBS InterBBS processing program
  41. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  42.  
  43. GWIBBS In File.ZIP  (input games to a node)
  44.  
  45.   Copies specified zip file into inzip directory.
  46.  
  47.   Unzips inzip\zip file into infiles directory.
  48.  
  49.   Checks for valid key (1) within the ZIP file. If invalid, deletes
  50.   inzip and infiles dirs and quits.
  51.  
  52.   If valid key (1) found, proceeds with the following:
  53.  
  54.     Deletes zip file.
  55.  
  56.     Examines the Stage (2) value of all incoming games and compares it
  57.     with the Stage (2) value of the existing game (if there is one). If
  58.     the Stage (2) value of the incoming game is greater or equal, the
  59.     incoming game is imported (3). If there is no existing game the
  60.     incoming game is imported (3). If the Stage (2) value is less, the
  61.     incoming game is not imported.
  62.  
  63.     If a WAR.CFG file is found, lines 3, 4, 7, 10-12, 15, 17-30, 33-35,
  64.     39, 53-61 and 63 of the Node's WAR.CFG file are updated to match
  65.     those of the WAR.CFG file received from the Hub.
  66.  
  67.     If an IBBS.CFG file is found, lines 1 and 4 are updated to match
  68.     those of the IBBS.CFG file received from the Hub.
  69.  
  70.     Any *.TOP, *.WAR, *.ANS or *.EXE files found are moved to the door
  71.     directory. They will replace any files by the same name unless the
  72.     file in the door directory is write protected.
  73.  
  74.     All files in the infiles directory are deleted.
  75.  
  76.  
  77. GWIBBS Out (output games from a node)
  78.  
  79.   Reads GWIBBS.$$$ (a log file created by Global War) to get N:ew,
  80.   U:pdated game numbers and S:corechange indication
  81.  
  82.     New games: moves the warxx.dat, warxx.log, warxx.msg to outfiles dir
  83.     where they are renamed newxx.dat, newxx.log, newxx.msg
  84.  
  85.     Updated games: copies the warxx.dat, warxx.log, warxx.msg files to
  86.     outfiles directory.
  87.  
  88.     Score Updates: moves updscore.war to outfiles where it is renamed
  89.     score##.war (## is a unique id from 1..255 incremented each time).
  90.  
  91.   Zips all files in outfiles dir, adds Key, calls IBBSMOVE to send to
  92.   hub.
  93.  
  94.  
  95. GWIBBS InHub File.Zip   (input games to a Hub)
  96.  
  97.   Copies specified zip file into inzip directory.
  98.  
  99.   Unzips inzip\zip file into infiles directory.
  100.  
  101.   Checks for valid key (1) within the ZIP file. If invalid, deletes
  102.   inzip and infiles dirs and quits.
  103.  
  104.   If valid key (1) found, proceeds with the following:
  105.  
  106.     Deletes ZIP file.
  107.  
  108.     If any new games exist (newxx.*), copies them to current dir & names
  109.     them warnn.* where nn is an unused game number. Moves game to
  110.     outfiles dir to send to all Nodes.
  111.  
  112.     Examines the Stage (2) value of all incoming games and compares it
  113.     with the Stage (2) value of the existing game (if there is one). If
  114.     the Stage (2) value of the incoming game is greater, the incoming
  115.     game is imported (3) and copied to the outfiles directory to send to
  116.     all Nodes. If there is no existing game the incoming game is
  117.     imported (3). If the Stage (2) value is less or equal, the incoming
  118.     game is not imported or sent to Nodes.
  119.  
  120.     If score file updates (score##.war) exists, they are moved to the
  121.     door directory and renamed updscore.war, combined with the scores in
  122.     the master score file winners.war. If the maximum score is exceeded
  123.     then the Hall of Fame utility is run to generate a Bulletin.Ans
  124.     file. Winners.Top is deleted. Bulletin.Ans and winners.war are
  125.     copied to the outfiles dir to be sent to all Nodes.
  126.  
  127.     For every Node listed in Route.Cfg - Zips all files in outfiles dir,
  128.     adds Key (1), calls IBBSMOVE send Zip file to each Node.
  129.  
  130.  
  131. GWIBBS OutHub (output games from a Hub)
  132.  
  133.   Reads GWIBBS.$$$ (log file created by Global War) to get N:ew,
  134.   U:pdated game numbers and S:corechange indication
  135.  
  136.     New and Updated games: copy the *.dat, *.log, *.msg to outfiles dir
  137.  
  138.     Score file updates: copy winners.war to outfiles directory.
  139.  
  140.     Deletes updscore.war, which is not used on the hub.
  141.  
  142.     For every Node listed in Route.Cfg - Zips all files in outfiles dir,
  143.     adds Key (1), calls IBBSMOVE send Zip file to each Node.
  144.  
  145.  
  146. GWIBBS HubInit [NodeAddress]  (initialize a node. If NodeAddress is not
  147.                                specified, reinitializes all nodes)
  148.  
  149.     Copies all games (WAR*.DAT, WAR*.LOG, WAR*.MSG) to outfiles dir.
  150.  
  151.     Copies current score file (WINNERS.WAR) to outfiles dir.
  152.  
  153.     Copies current Hall of Fame (BULLETIN.ANS) to outfiles dir.
  154.  
  155.     Copies WAR.CFG and IBBS.CFG to outfiles dir.
  156.  
  157.     Copies WAR.EXE and GWIBBS.EXE to outfiles dir.
  158.  
  159.     Zips all files in outfiles dir, adds Key (1), calls IBBSMOVE to send
  160.     Zip file. Zip file is sent to NodeAddress if specified on command
  161.     line and matches entry in ROUTE.CFG. If no NodeAddress is specified
  162.     (or if NodeAddress is "ALL" then Zip files are created and sent to
  163.     all Nodes listed in ROUTE.CFG.
  164.  
  165. GWIBBS HubSend [NodeAddress]  (sends all files in outfiles dir to a
  166.                                node. If NodeAddress is not specified,
  167.                                sends to all nodes)
  168.  
  169.     Zips all files in outfiles dir, adds Key (1), calls IBBSMOVE to send
  170.     Zip file. Zip file is sent to NodeAddress if specified on command
  171.     line and matches entry in ROUTE.CFG. If no NodeAddress is specified
  172.     (or if NodeAddress is "ALL" then Zip files are created and sent to
  173.     all Nodes listed in ROUTE.CFG.
  174.  
  175. -------------------------------------------------------------------------
  176. Notes:
  177.  
  178. (1) What is The Key file? It identifies the ZIP file as a valid IBBS
  179.     archive. If no key file is found in the ZIP file, the ZIP file will
  180.     not be accepted for processing. The Sysop may have tried to process
  181.     the wrong ZIP file. The Key file is also for security. The key file
  182.     contains the secret password for the net. If the password is wrong,
  183.     the ZIP file will not be accepted. This prevents a hacker from
  184.     sending us a bogus ZIP file. When the ZIP file is created, it is
  185.     encrypted using PKZIP's -S switch. If the ZIP file should ever fall
  186.     into the wrong hands, the encryption will prevent a hacker from
  187.     unzipping the file and discovering the password stored in the key
  188.     file.
  189.  
  190. (2) Stage value. This is a number that indicates how far the game has
  191.     progressed. It is used when comparing two games to see which one is
  192.     newer and to prevent an older game from replacing a newer game.
  193.     Stage=100 when a game is created. Stage is incremented by 1 every
  194.     time a player takes a turn, changes a vote or password. Stage is
  195.     incremented by 100 every time a player joins or removes their name
  196.     from a game. When a game starts, Stage is set to 10000. The higher
  197.     the stage value, the newer the game.
  198.  
  199. (3) Imported means the WAR*.DAT, WAR*.LOG and WAR*.MSG files are
  200.     accepted by the node. They are copied from the infiles directory to
  201.     the door directory and replace any files with the same name.
  202.  
  203.