Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
howto:door:index [2020/12/01 13:52] – [Installation] mention install-xtrn mlonghowto:door:index [2023/06/14 17:29] (current) – [See Also] Add link to TW2002 article digital man
Line 6: Line 6:
  
 BBS "doors" are external online programs, often games, that may be installed on a BBS system for its remote terminal users to use interactively. Doors are usually 16-bit DOS programs from "back in the day" and can be challenging to get working on the computers and operating systems of today. A little patience and the use of pages like this one can usually get them working however. BBS "doors" are external online programs, often games, that may be installed on a BBS system for its remote terminal users to use interactively. Doors are usually 16-bit DOS programs from "back in the day" and can be challenging to get working on the computers and operating systems of today. A little patience and the use of pages like this one can usually get them working however.
 +
 +
  
 ==== Supported External Program Types ==== ==== Supported External Program Types ====
Line 12: Line 14:
  
 ^ I/O Method         ^ Description                                           ^ Examples                                               ^ Typical Drop File Types   ^ OS ^ ^ I/O Method         ^ Description                                           ^ Examples                                               ^ Typical Drop File Types   ^ OS ^
-| [[ref:FOSSIL]]     | 16-bit DOS BBS doors and external editors             | TradeWars 2002, GlobalWar, LORD, FDSZ                  | DOOR.SYS and DORINFO#.DEF | Windows |+| [[ref:FOSSIL]]     | 16-bit DOS BBS doors and external editors             | TradeWars 2002, GlobalWar, LORD, FDSZ                  | DOOR.SYS and DORINFO#.DEF | Windows and [[howto:dosemu|Linux]]|
 | COM/UART           | 16-bit DOS BBS doors and external editors             | DSZ, NukeWars                                          | DOOR.SYS and DORINFO#.DEF | Windows | | COM/UART           | 16-bit DOS BBS doors and external editors             | DSZ, NukeWars                                          | DOOR.SYS and DORINFO#.DEF | Windows |
-| DOS Console        | 16-bit Synchronet and WWIV doors and external editors | Food Fight! Rigor Mortis, Dragon's Hoard, SBJ/SBL v2.x | CHAIN.TXT and XTRN.DAT    | Windows |+| DOS Console        | 16-bit Synchronet and WWIV doors and external editors | Food Fight! by Rigor Mortis, Dragon's Hoard, SBJ/SBL v2.x | CHAIN.TXT and XTRN.DAT    | Windows |
 | TCP/IP Socket      | Native TCP/IP BBS doors and external editors          | DoorMUD, PimpWars/Win32, Darkness/Win32, SBJ/SBL v3.x  | DOOR32.SYS and XTRN.DAT   | Windows and *nix | | TCP/IP Socket      | Native TCP/IP BBS doors and external editors          | DoorMUD, PimpWars/Win32, Darkness/Win32, SBJ/SBL v3.x  | DOOR32.SYS and XTRN.DAT   | Windows and *nix |
 | Standard           | Native stdio/console programs (traditionally, UNIX)         | PimpWars/Linux, Lord/X, "scfg -d", cmd.exe, bash, pico | DOOR32.SYS | Windows and *nix | | Standard           | Native stdio/console programs (traditionally, UNIX)         | PimpWars/Linux, Lord/X, "scfg -d", cmd.exe, bash, pico | DOOR32.SYS | Windows and *nix |
 +
 +==== Supported Drop File Types ====
 +Synchronet can create and read-back a variety of drop file types based on the requirements of the door program:
 +
 +^ Software ^ Write File(s)                 ^ Read File(s)     ^
 +| Mystic        | ''DOOR32.SYS''                        |                  |
 +| GAP | ''DOOR.SYS''                 | ''DOOR.SYS'': Flags, SecLevel, ExpireDate, FileDLed, KBsDLed, MinuteCredits |
 +| WWIV | ''CHAIN.TXT''                                          |
 +| PCBoard 15.x | ''PCBOARD.SYS'' and ''USERS.SYS''     | ''USERS.SYS'': SecLevel and ExpireDate |
 +| QuickBBS | ''DORINFO#.DEF'' and ''EXITINFO.BBS'' | ''EXITINFO.BBS'': Flags and SecLevel |
 +| Wildcat! 2.x | ''CALLINFO.BBS''                      |                  |
 +| SpitFire | ''SFDOORS.DAT''                                        |
 +| TriBBS | ''TRIBBS.SYS''                        |                  |
 +| MegaMail | ''UTIDOOR.TXT''                                        |
 +| Solar Realms | ''DOORFILE.SR''                                        |
 +| Synchronet  | ''XTRN.DAT''         | ''MODUSER.DAT'': Credits, SecLevel, Flags, ExpireDate, MinuteCredits  |
  
 === CIOXTRN === === CIOXTRN ===
Line 39: Line 57:
  
 Run ''[[dir:exec]]/jsexec install-xtrn.js'' Run ''[[dir:exec]]/jsexec install-xtrn.js''
 +
 +For more information, see [[module:install-xtrn|Install Xtrn]]
  
 ==== Manual Install ==== ==== Manual Install ====
Line 67: Line 87:
  
 === DOSXTRN.EXE === === DOSXTRN.EXE ===
-This 16-bit DOS component of the Synchronet FOSSIL driver for Windows (all flavors) is called ''DOSXTRN.EXE'' and it is located in the Synchronet ''[[dir:exec]]'' directory. This program [[:faq:win#win64|will not work]] with 64-bit versions of Windows since Microsoft does not include a DOS virtual machine (NTVDM) with those versions of Windows.+The 16-bit DOS component of the Synchronet FOSSIL driver for Windows (all flavors) is called ''DOSXTRN.EXE'' and it is located in the Synchronet ''[[dir:exec]]'' directory. This program [[:faq:win#win64|will not work]] with 64-bit versions of Windows since Microsoft does not include a DOS virtual machine (NTVDM) with those versions of Windows.
  
 === Windows 9x === === Windows 9x ===
Line 81: Line 101:
 ===== Configuration ===== ===== Configuration =====
  
-Add the program in SCFG [[util:SCFG:external programs:Online Programs]] under ''%%Available Online Programs...%%'' in a new or existing Online Program Section.+Add the program in SCFG [[util:SCFG:external programs:Online Programs]] under ''%%Online Programs...%%'' in a new or existing Online Program Section.
  
 The most critical [[util:SCFG]] configuration options for successful installation of an online program (door) are: The most critical [[util:SCFG]] configuration options for successful installation of an online program (door) are:
Line 87: Line 107:
   - [[#Start-up Directory]]   - [[#Start-up Directory]]
   - [[#Command Line]]   - [[#Command Line]]
-  - [[#Intercept I/O]] +  - [[#I/Method]] 
-  - [[#Native Executable]]+  - [[#Native Executable/Script]]
   - [[#BBS Drop File Type]]     - [[#BBS Drop File Type]]  
    
Line 155: Line 175:
 The ''Clean-up Command Line'' may contain Command Line [[config:cmdline#Specifiers]]. The ''Clean-up Command Line'' may contain Command Line [[config:cmdline#Specifiers]].
  
-The [[#Native]], [[#Intercept I/O]], and [[#Use Shell To Execute]] options affect the execution of the ''Clean-up Command Line'' (if non-blank).+The [[#Native]], [[#I/Method]], and [[#Use Shell or New Context]] options affect the execution of the ''Clean-up Command Line'' (if non-blank).
  
 Most external programs do not require a ''Clean-up Command Line'' to be specified. Most external programs do not require a ''Clean-up Command Line'' to be specified.
Line 179: Line 199:
 Note: for multiple-user programs, it is highly recommended that the BBS drop file be created in the ''[[dir:node]]'' directory. Note: for multiple-user programs, it is highly recommended that the BBS drop file be created in the ''[[dir:node]]'' directory.
  
-==== Intercept I/O ==== +==== I/O Method ====
- +
-If this program requires the BBS to intercept standard console input and output operations, then this option should be set to ''Standard''.+
  
-  * Most BBS doors will require this option be set to ''No''+If the program requires the BBS to intercept standard console input and output operations, then this option should be set to ''Standard''.
-  * BBS Doors that use FOSSIL I/O must have this option set to ''No''+
-  * BBS Doors that use COM/UART I/O must have this option set to ''No''+
-  * BBS Doors that use Socket I/O must have this option set to ''No''.+
  
-When executing an in-process module (Baja or JavaScript), the ''Intercept I/O'' option is not used.+  * Most 16-bit (DOS) BBS doors will require this option be set to ''FOSSIL or UART'' (only available for 16-bit DOS programs). 
 +  * Most //native// (Win32 or *nix) BBS doors will require this option be set to ''Socket'' (only available for native programs). 
 +  * When executing an in-process module (Baja or JavaScript), the ''I/Method'' option is not applicable.
  
-==== Native Executable ====+==== Native Executable/Script ====
  
 If this program is native to the host operating system (e.g is **not** a 16-bit DOS program), then this option should be set to ''Yes''. If this program is native to the host operating system (e.g is **not** a 16-bit DOS program), then this option should be set to ''Yes''.
Line 198: Line 215:
   * BBS Doors that use Socket I/O are native (32-bit or 64-bit) programs and must have this option set to ''Yes''.   * BBS Doors that use Socket I/O are native (32-bit or 64-bit) programs and must have this option set to ''Yes''.
  
-When executing an in-process module (Baja or JavaScript), the ''Native Executable'' option is not used (all modules are native).+When executing an in-process module (Baja or JavaScript), the ''Native Executable/Script'' option is not used (all //modules// are native).
  
-==== Use Shell to Execute ====+==== Use Shell or New Context ====
  
-If this program requires command shell (e.g. it's a *nix shell script, ''.sh'' file, or Windows ''.bat'' or ''.cmd'' file), then this option should be set to ''Yes''.+If this program requires an OS command shell (e.g. it's a *nix shell script, ''.sh'' file, or Windows ''.bat'' or ''.cmd'' file), then this option should be set to ''Yes''.
  
-When executing an in-process module (Baja or JavaScript), this option is not used.+When executing JavaScript moduleenabling this option forces a new JS engine context (i.e. sandbox) to be created and used to execute the script.
  
 ==== Modify User Data ==== ==== Modify User Data ====
Line 223: Line 240:
   * File Uploaded     * File Uploaded  
   * File Downloaded    * File Downloaded 
 +  * Local/Sysop Chat
  
 If an event is selected, you may also specify that the program may be executed **only** on that event and not purposely selected by the user from a menu for manual execution. If an event is selected, you may also specify that the program may be executed **only** on that event and not purposely selected by the user from a menu for manual execution.
Line 288: Line 306:
   * [[:howto:|How-To Pages]]   * [[:howto:|How-To Pages]]
   * [[:howto:cioxtrn]]   * [[:howto:cioxtrn]]
 +  * [[https://www.youtube.com/channel/UCcHJZZmXcXRtJjqCr9_W4eA|Door Game Review Videos]]
 +  * [[https://if50.substack.com/p/1991-trade-wars-2002|Trade Wars 2002]]
  
 {{tag>door fossil uart}} {{tag>door fossil uart}}
  
howto/door/index.1606859537.txt · Last modified: 2020/12/01 13:52 by mlong
Back to top
CC Attribution 4.0 International
Driven by DokuWiki Recent changes RSS feed Valid CSS Valid XHTML 1.0