This is an old revision of the document!


Synchronet Inter-BBS Instant Message Module

The purpose of this module is to provide a real-time inter-BBS instant message feature for participating systems.

History

History of this module/feature:

Original (2001)

  • Queried systems using Finger (TCP port 79)
  • Sent message using SMTP-SOML (TCP port 25)

Rev 1.11 (2002)

  • Queried system using both TCP and UDP-Finger (port 79)
  • Still sent messages using SMTP-SOML

Rev 1.22 (2007)

  • Queried using SYSTAT/ActiveUser protocol (TCP & UDP port 11) in addition to Finger (TCP and UDP port 79)
  • If send via SMTP failed, used MSP protocol (TCP port 18)

Rev 1.25 (2009)

  • Removed Finger (both TCP and UDP support), SYSTAT-TCP and SMTP support, so it now *only*:
  • Queries using SYSTAT/ActiveUser protocol over UDP port 11
  • Sends messages using MSP (TCP port 18)

So, while originally the requirements for systems to participate in the instant-message network were:

  • Synchronet SMTP Server listening on TCP port 25
  • fingerservice.js listing on TCP port 79

Now, the requirements are:

  • activeuserservice.js (or fingerservice.js) listening on UDP port 11
  • mspservice.js listening on TCP port 18

List File

The heart of the instant message module is the ctrl/sbbsimsg.lst file.

This file is generated daily on Vertrauen and distributed via FTP as ftp://vert.synchro.net/sbbsimsg.lst.

The event module exec/getimsglst is normally run as a timed event (configured in SCFG->External Programs->Timed Events) and used to pull the list file from Vertrauen via FTP, usually daily.

The List File is generated daily on Vertrauen through the use of the sbbslist.js module's imsglist command-line option. This sbbslist option parses the Synchronet BBS List and finds listed-systems that meet the minimum requirements to be included in the instant-message list and re-generates the sbbsimsg.lst file.

Requirements

Since Vertrauen uses its Synchronet BBS List as the source of BBSes which may be instant-message capable, the first requirement is that a system is listed in this database.

To have your system listed, either:

  1. login to Vertrauen and create your BBS entry or,
  2. preferably, run the sbbslist module on your own BBS and have it synchronized with Vertrauen and the rest of DOVE-Net or FidoNet via the SYNCDATA networked message area

The following services must also be reachable via the public-Internet for a system to be listed in the Instant Message module List File (sbbsimsg.lst):

  1. SYSTAT/ActiveUser service (using the Finger service) on UDP port 11
  2. MSP service (using the MSP service) on TCP port 18

This is normally accomplished by adding the following services to a BBS's ctrl/services.ini file:

[ActiveUser-UDP]
Port=11
MaxClients=10
Options=UDP | NO_HOST_LOOKUP
Command=fingerservice.js -u
[MSP]
Port=18
MaxClients=10
Command=mspservice.js

You can use this page to help determine if the required services are publicly-reachable on your system.

Once a system is listed in the Synchronet BBS List on Vertrauen and the required services are confirmed publicly-reachable on the Internet, that system should appear in the shared sbbsimsg.lst file within 24 hours.

See Also

module/sbbsimsg.1519935668.txt · Last modified: 2018/03/01 12:21 by digital man
Back to top
CC Attribution 4.0 International
Driven by DokuWiki Recent changes RSS feed Valid CSS Valid XHTML 1.0