1. Forum
  2. DOVE-Net
  3. Synchronet Programming

  • docs/dropfile_ini.md

    From Rob Swindell (on Debian Linux)@VERT to Git commit to main/sbbs/master on Fri Sep 25 22:20:36 2026
    https://gitlab.synchro.net/main/sbbs/-/commit/8afe199205d8d5a0e49866e3
    Added Files:
    docs/dropfile_ini.md
    Log Message:
    docs: add DROPFILE.INI draft specification

    A draft of a new door drop file: named KEY=value lines in INI sections, readable by a DOS door in a dozen lines of C, Turbo Pascal or QBasic and
    by the Win32 and Python INI APIs. It carries what doors commonly read
    from DOOR.SYS, DOOR32.SYS and DORINFO1.DEF, plus user preferences (sound
    muted, screen pause, mouse hot-spots) and detected terminal capabilities (Sixel, JPEG XL, CTerm features, kitty and evdev key reports, color
    depth), so a door needs no other drop file and no terminal probing of its
    own.

    The draft also specifies what the older formats leave unsaid: how the
    path reaches the door (DROPFILE_INI or the command line), per-node file placement, the rules for an inherited socket or serial handle (blocking
    mode, socket options, no shutdown()), text encoding, and vendor-prefixed extension keys.

    Non-normative notes describe how Synchronet would write the file,
    including X_SBBS_* keys for doors that use MODUSER.DAT, and list the
    Synchronet work needed first. Open questions and a list of reviewers
    close the document.

    Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

    ---
    ■ Synchronet ■ Vertrauen ■ Home of Synchronet ■ [vert/cvs/bbs].synchro.net
  • From Rob Swindell (on Debian Linux)@VERT to Git commit to main/sbbs/master on Sat Sep 26 12:37:53 2026
    https://gitlab.synchro.net/main/sbbs/-/commit/7022cd5556eef105dd30b836
    Modified Files:
    docs/dropfile_ini.md
    Log Message:
    docs: DROPFILE.INI draft 0.2

    Changes since draft 0.1 (8afe199205, schools-20-cars, 2026-09-25):

    - The file may be written by a BBS or any other system that runs doors,
    so the spec now calls the writer the "host", defined once in the
    introduction.
    - The [bbs] section is now [system], with its keys renamed to match:
    SYS_SOFTWARE, SYS_NAME, SYS_OP, SYS_NODE_NUM, SYS_NODE_COUNT,
    SYS_QWKID, SYS_VENDOR and SYS_VERSION. SYS_NODE_NUM and
    SYS_NODE_COUNT replace the one-letter-apart BBS_NODE and BBS_NODES,
    and SYS_QWKID says plainly what the ID is.

    Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

    ---
    ■ Synchronet ■ Vertrauen ■ Home of Synchronet ■ [vert/cvs/bbs].synchro.net
  • From Rob Swindell (on Debian Linux)@VERT to Git commit to main/sbbs/master on Sat Sep 26 16:08:29 2026
    https://gitlab.synchro.net/main/sbbs/-/commit/e7a825704ef5329c7ef84087
    Modified Files:
    docs/dropfile_ini.md
    Log Message:
    docs: DROPFILE.INI draft 0.3

    Changes since draft 0.2 (7022cd5556, suppliers-28-info, 2026-09-26):

    - New host keys in [system]: SYS_HOSTNAME (public Internet host name),
    SYS_FTN_ADDR (primary FidoNet address, for inter-BBS games),
    SYS_LOCATION, SYS_OP_AVAILABLE (whether the sysop can be paged) and
    SYS_DATE_FORMAT (mdy, dmy or ymd). SYS_OP now allows any name the
    sysop is configured with, not only an alias.
    - New user keys in [user]: USER_EMAIL (the user's address on the host),
    USER_NETMAIL (the user's forwarding address, Internet or FidoNet) and
    USER_PROTOCOL (how the caller connected: telnet, rlogin, ssh, raw,
    websocket or serial). USER_ROLE gains guest, so doors can avoid
    saving progress for a shared account. USER_HANDLE may be an amateur
    radio call sign.
    - TERM_BACKSPACE (8 or 127, the byte the Backspace key sends) replaces
    TERM_SWAP_DELETE, which door authors had to decode.
    - Phenom Dropfile, a JSON drop file for Mystic BBS, is cited as related
    prior art, and its author added to the reviewers.

    Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

    ---
    ■ Synchronet ■ Vertrauen ■ Home of Synchronet ■ [vert/cvs/bbs].synchro.net