Synchronet v3.19b-Win32 (install) has been released (Jan-2022).

You can donate to the Synchronet project using PayPal.

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
util:sbbsecho [2018/03/31 20:32] – Numerous updates to track the latest echocfg menus/options and BinkIT v2 integration digital manutil:sbbsecho [2024/11/08 23:33] (current) – [Area Manager Commands] update help to reflect SBBSecho v3.21 AreaMgr request format digital man
Line 1: Line 1:
-====== SBBSecho ======+====== SBBSecho - FidoNet Tosser ======
    
 Synchronet's FidoNet EchoMail Program Synchronet's FidoNet EchoMail Program
Line 16: Line 16:
 The terminology used with FidoNet networking technology can be as confusing as it is particular. In our [[ref:FidoNet Glossary]] we attempt to define some terms we will be using through-out this article to describe the features and functions of SBBSecho. If you come across a term you aren't familiar with, please check the [[ref:FidoNet Glossary]]. The terminology used with FidoNet networking technology can be as confusing as it is particular. In our [[ref:FidoNet Glossary]] we attempt to define some terms we will be using through-out this article to describe the features and functions of SBBSecho. If you come across a term you aren't familiar with, please check the [[ref:FidoNet Glossary]].
    
-===== Installation =====+===== Install =====
  
-SBBSecho and its configuration program, EchoCfg, come with Synchronet BBS software (i.e. their executables can be found in your Synchronet ''[[dir:exec]]'' directory. So it usually requires no special installation steps of its own.+SBBSecho and its configuration program, EchoCfg, come with Synchronet BBS software (i.e. their executables can be found in your Synchronet ''[[dir:exec]]'' directory). So the program itself usually requires no special installation steps of its own.
  
-SBBSecho expects to find an area file (e.g. ''areas.bbs'') in your Synchronet ''[[dir:data]]'' +Things you should have before you proceed: 
-directory. You will need to create the Area File in order for SBBSecho to do anything with EchoMail messages. Importing and exporting //NetMail// does not require an area file.+  - Your hub/uplink's FidoNet address 
 +  - Your hub/uplink's Internet hostname or IP address 
 +  - Your own FidoNet address (use ''<//zone//>:<//net//>/9999'' if you have not yet been assigned a FidoNet address) 
 +  - Your hub-agreed-upon BinkP session password 
 +  - Your hub-agreed-upon packet password (optional) 
 +  - Your hub-agreed-upon AreaFix password (optional) 
 +  - An //EchoList// file for the network (e.g. ''BACKBONE.NA'')
  
-[[util:SCFG]] can also export a group of message areas (sub-boards) to an SBBSecho-compatible Area File. +==== Message Group ====  
-You may want to first import a network's EchoList (e.g. FidoNet's ''BACKBONE.NA'') into a message group (using [[util:SCFG]]) and then export the networked message group(s) from [[util:SCFG]] to the SBBSecho-compatible Area File once you're linked successfully with your network hub.+ 
 +Create a message group called "FidoNet" (or whatever is most appropriate for the network) in [[util:SCFG]]->Message Areas: 
 +<file> 
 +╔══════════════════════════════════════════════════════════╗ 
 +║                       FidoNet Group                      ║ 
 +╠══════════════════════════════════════════════════════════╣ 
 +║ │Long Name                  FidoNet                      ║ 
 +║ │Short Name                 FidoNet                      ║ 
 +║ │Internal Code Prefix       FIDONET_                     ║ 
 +║ │Access Requirements                                     ║ 
 +║ │Sort Group by Sub-board    Index Position               ║ 
 +║ │Clone Options                                           ║ 
 +║ │Export Areas...                                         ║ 
 +║ │Import Areas...                                         ║ 
 +║ │Message Sub-boards...                                   ║ 
 +╚══════════════════════════════════════════════════════════╝ 
 + 
 +</file> 
 + 
 +==== EchoList ==== 
 + 
 +Now, import a list of the public message areas ("echoes") from the network's standard EchoList (e.g. FidoNet's ''BACKBONE.NA'' file) into your new message group using the Message Group "Import Areas..." option in [[util:SCFG]]: 
 +<file> 
 +╔═════════════════════════════════════════╗ 
 +║         Import Area File Format         ║ 
 +╠═════════════════════════════════════════╣ 
 +║ │subs.txt        Synchronet Sub-boards  ║ 
 +║ │control.dat     QWK Conference List    ║ 
 +║ │areas.bbs       Generic Area File      ║ 
 +║ │areas.bbs       SBBSecho Area File     ║ 
 +->│backbone.na     FidoNet EchoList      <- 
 +║ │badareas.lst    SBBSecho Bad Area List ║ 
 +╚═════════════════════════════════════════╝ 
 +</file> 
 + 
 +An alternative method is to instead subscribe/link to the echoes (on your hub/uplink) you wish to carry on your BBS (e.g. via AreaFix request netmail message) and then as SBBSecho attempts to import received packets, it will add unknown areas to your ''[[dir:data]]/badareas.lst'' file. Import that file (''badareas.lst'') into SCFG->Message Areas->FidoNet. SBBSecho will automatically remove "known" areas from the ''badareas.lst'' file after they've been added to SCFG. You will lose some EchoMail messages using this scheme. 
 +===== Area File ===== 
 + 
 +By default, SBBSecho will try to open an //Area File// (by default, ''[[dir:data]]/areas.bbs''). The Area File can be used to associate FidoNet EchoTags with sub-boards configured in [[util:SCFG]]->Message Areas. You can also specify downlinks and pass-through areas in an Area File, if need be. The Area File is optional, not strictly needed, when you have the "Automatically Add New Subs to Area List" option enabled and set to "List Only" in [[util:EchoCfg]]->EchoMail Settings. 
 + 
 +To successfully operate without an Area File, you must have your hub configured in [[util:EchoCfg]]->Linked Nodes with its "Uplink for Message Groups" setting set to the //short name// of the message group you created for this network in [[util:SCFG]]->Message Areas. 
 + 
 +You will need an Area File if you are to have any downlinks (nodes for which you are //their// hub to the network). 
 + 
 +[[util:SCFG]] can also export a group of message areas (sub-boards) to an SBBSecho-compatible Area File using the Message Group "Export Areas..." option: 
 +<file> 
 +╔═══════════════════════════════════════╗ 
 +║        Export Area File Format        ║ 
 +╠═══════════════════════════════════════╣ 
 +║ │subs.txt       Synchronet Sub-boards ║ 
 +->│areas.bbs      SBBSecho Area File   <- 
 +║ │backbone.na    FidoNet EchoList      ║ 
 +╚═══════════════════════════════════════╝ 
 +</file>
  
 If the ''AutoAddSubs'' feature is enabled, sub-boards configured in SCFG->Message Areas may be //automatically// added to your Area File when the network hub (your uplink) has be configured in EchoCfg->Linked Nodes and the "Group Hub" setting for that link set to the name of the corresponding message group in SCFG->Message Areas. This Auto-Add procedure happens during SBBSecho initialization and is not dependent upon receiving any echomail messages for the configured message areas. If the ''AutoAddSubs'' feature is enabled, sub-boards configured in SCFG->Message Areas may be //automatically// added to your Area File when the network hub (your uplink) has be configured in EchoCfg->Linked Nodes and the "Group Hub" setting for that link set to the name of the corresponding message group in SCFG->Message Areas. This Auto-Add procedure happens during SBBSecho initialization and is not dependent upon receiving any echomail messages for the configured message areas.
  
-===== Area File Format =====+==== Format ====
  
 Each line of the SBBSecho Area File (e.g. ''areas.bbs'') represents an EchoMail message //area// in the following format: Each line of the SBBSecho Area File (e.g. ''areas.bbs'') represents an EchoMail message //area// in the following format:
Line 34: Line 93:
 Where each field is separated by white-space (space or tab characters) and the fields are: Where each field is separated by white-space (space or tab characters) and the fields are:
  
-==== CODE ====+=== CODE ===
 The ''CODE'' field is the internal code of the sub-board. The ''CODE'' field is the internal code of the sub-board.
  
 Internal codes consist of a combination of the Message Group's "code prefix" and the Sub-board's "code suffix". The full internal code may be as long as 16 characters and may not contain white-space or any invalid filename characters. Internal codes consist of a combination of the Message Group's "code prefix" and the Sub-board's "code suffix". The full internal code may be as long as 16 characters and may not contain white-space or any invalid filename characters.
  
-=== Pass-through Areas ===+== Pass-through Areas ==
 Any unrecognized internal codes are considered //pass-through// (not imported into your BBS's message areas). Using "''P''" for the internal code of pass-through areas will prevent warnings from being logged about the internal code not being found in your BBS's message base configuration (i.e. in ''[[util:SCFG]]''->Message Areas). Any unrecognized internal codes are considered //pass-through// (not imported into your BBS's message areas). Using "''P''" for the internal code of pass-through areas will prevent warnings from being logged about the internal code not being found in your BBS's message base configuration (i.e. in ''[[util:SCFG]]''->Message Areas).
  
-==== TAG ====+=== TAG ===
 The ''TAG'' field is the FTN area tag (or echo tag) as shown in your FTN network's agreed upon echo list file (e.g. ''BACKBONE.NA'' for the FidoNet North American backbone). Area tags may not contain white-space characters. The ''TAG'' field is the FTN area tag (or echo tag) as shown in your FTN network's agreed upon echo list file (e.g. ''BACKBONE.NA'' for the FidoNet North American backbone). Area tags may not contain white-space characters.
  
-=== Long Tags === +== Long Tags == 
-Although standard FidoNet echo tags may be as long as 35 characters, Synchronet's Sub-board //short names// are limited to 25 characters. When importing and exporting FTN areas (e.g. to/from ''areas.bbs'' or EchoList files), usually the echo tag is copied to or derived from the associated Sub-board's short name. For this reason, echo tags longer than 25 characters in length may present a problem for some import/export or auto-create scenarios.+Although standard FidoNet echo tags (AKA "area tag") may be as long as 35 characters, Synchronet's Sub-board //short names// are limited to a length of 25 characters. As of July 28, 2018, Synchronet v3.17a will import (e.g. from a ''BACKBONE.NA'' file) echo tags longer than 25 characters into the "Newsgroup" name of the sub-board. Each sub-board's "Newsgroup" name can accommodate a length of up to 63 characters (no spaces). Likewise, when exporting message areas from SCFG or SBBSecho (e.g. to an ''areas.bbs'' file), if a "Newsgroup" name is defined for a message area, it will be used for the exported echo tag of that exported area.
  
-=== Bad Echo Area ===+== Bad Echo Area ==
  
 If an area's ''TAG'' field value is a ''*'' (asterisk), then the area will be considered a "bad echo" area and will receive all messages for areas not otherwise specified in this file (sort of a 'catch-all' bin for 'unknown' areas). You can have **only one** "bad echo" area configured in your Area File. To //re-toss// (move) messages from the "bad echo" area into newly added or linked sub-boards, run SBBSecho with the ''-r'' command-line option.  If an area's ''TAG'' field value is a ''*'' (asterisk), then the area will be considered a "bad echo" area and will receive all messages for areas not otherwise specified in this file (sort of a 'catch-all' bin for 'unknown' areas). You can have **only one** "bad echo" area configured in your Area File. To //re-toss// (move) messages from the "bad echo" area into newly added or linked sub-boards, run SBBSecho with the ''-r'' command-line option. 
  
-==== LINK ====+=== LINK ===
 Each ''LINK'' field is an FTN address which you wish to import mail from and export mail to. At the very least, your uplink's (hub's) address should be listed here. Your address should **NOT** be listed here. If multiple link fields are specified, you should specify the full 3D or 4D address for each. Links can be remotely added or removed from the Area File by authenticated Nodes using AreaFix. Each ''LINK'' field is an FTN address which you wish to import mail from and export mail to. At the very least, your uplink's (hub's) address should be listed here. Your address should **NOT** be listed here. If multiple link fields are specified, you should specify the full 3D or 4D address for each. Links can be remotely added or removed from the Area File by authenticated Nodes using AreaFix.
  
 Lines beginning with a semicolon (;) are considered comments, and are ignored. Lines beginning with a semicolon (;) are considered comments, and are ignored.
-==== Area File Example ====+==== Example ====
  
 <file> <file>
Line 66: Line 125:
 The amount of spacing (white-space characters including horizontal tabs and spaces) between each element in the line is not important. Each line may be up to 1024 characters in length. The amount of spacing (white-space characters including horizontal tabs and spaces) between each element in the line is not important. Each line may be up to 1024 characters in length.
  
-===== Configuration =====+===== Configure =====
    
 In order to set up SBBSecho for your system you must: In order to set up SBBSecho for your system you must:
-  - Configure your fundamental FTN settings (e.g. system address) in [[util:SCFG]] +  - Configure your fundamental FTN settings (e.g. system address) in [[util:SCFG]]->Networks->FidoNet. 
-  - Use the ''[[util:echocfg]]'' utility (highly recommended) or edit your ''[[dir:ctrl]]/sbbsecho.ini'' configuration (text) file by hand+  - Use the ''[[util:EchoCfg]]'' utility (highly recommended) or edit your ''[[dir:ctrl]]/sbbsecho.ini'' configuration (text) file by hand
  
 ==== SCFG ==== ==== SCFG ====
Line 123: Line 182:
  
 === Inbound File Directory === === Inbound File Directory ===
-Older versions of SCFG (e.g. v3.16) contained this FidoNet setting which was used to specify the directory where non-secure inbound FidoNet files would be received by your FTN mailer. SBBSecho v2 used this setting, however Synchronet itself did not, so it was deprecated with SBBSecho v3  (replaced with the ''Non-secure Inbound Directory'' setting in EchoCfg/''[[config:sbbsecho.ini]]'' and removed from future versions of [[SCFG]].+Older versions of SCFG (e.g. v3.16) contained this FidoNet setting which was used to specify the directory where non-secure inbound FidoNet files would be received by your FTN mailer. SBBSecho v2 used this setting, however Synchronet itself did not, so it was deprecated with SBBSecho v3  (replaced with the ''Non-secure Inbound Directory'' setting in EchoCfg/''[[config:sbbsecho.ini]]'' and removed from future versions of [[SCFG]]).
  
  
Line 200: Line 259:
 === Global Settings === === Global Settings ===
 <code> <code>
-╔══════════════════════════════════════════════╗ +╔═══════════════════════════════════════════════════╗ 
-║                Global Settings               ║ +║                  Global Settings                  ║ 
-╠══════════════════════════════════════════════╣ +╠═══════════════════════════════════════════════════╣ 
-║ │Mailer Type               Binkley/FLO       ║ +║ │Mailer Type                    Binkley/FLO       ║ 
-║ │Log Level                 Debugging         ║ +║ │Log Level                      Debugging         ║ 
-║ │Log Timestamp Format      %m/%d/%y %H:%M:%S ║ +║ │Log Timestamp Format           %m/%d/%y %H:%M:%S ║ 
-║ │Strict Packet Passwords   Enabled           ║ +║ │Strict Packet Passwords        Enabled           ║ 
-║ │BSY Mutex File Timeout    12 hours          ║ +║ │Config File Backups            10                ║ 
-║ │BSO Lock Attempt Delay    10 seconds        ║ +║ │Minimum Free Disk Space        10G bytes         ║ 
-║ │BSO Lock Attempt Limit    60                ║ +║ │Strip Incoming Soft CRs        No                ║ 
-║ │Config File Backups       100               ║ +║ │Strip Outgoing Line Feeds      No                ║ 
-║ │BinkP Capabilities                          ║ +║ │Use Outboxes for Mail Files    Yes               ║ 
-║ │BinkP Sysop Name                            ║ +║ │BSY Mutex File Timeout         12 hours          ║ 
-╚══════════════════════════════════════════════╝+║ │BSO Lock Attempt Delay         10 seconds        ║ 
 +║ │BSO Lock Attempt Limit         60                ║ 
 +║ │BinkP Capabilities                               ║ 
 +║ │BinkP Sysop Name               Your Name         ║ 
 +║ │BinkP Authentication           Plain or CRAM-MD5 ║ 
 +║ │BinkP Encryption               Supported         ║ 
 +╚═══════════════════════════════════════════════════╝
 </code> </code>
 === Mailer Type === === Mailer Type ===
Line 253: Line 318:
 Log Timestmap Format defines the format of the date/time-stamps added   Log Timestmap Format defines the format of the date/time-stamps added  
 along with each log message to the log file (e.g. ''sbbsecho.log'').    along with each log message to the log file (e.g. ''sbbsecho.log'').   
-The timestamp format is defined using standard C ''strftime'' notation.+The timestamp format is defined using standard C ''[[custom:strftime]]'' notation.
 The default format is: ''%Y-%m-%d %H:%M:%S''.            The default format is: ''%Y-%m-%d %H:%M:%S''.           
 For SBBSecho v2 timestamp format, use ''%m/%d/%y %H:%M:%S''.             For SBBSecho v2 timestamp format, use ''%m/%d/%y %H:%M:%S''.            
Line 360: Line 425:
 ║ │Send Notify List               No          ║ ║ │Send Notify List               No          ║
 ║ │Uplink for Message Groups      FidoNet     ║ ║ │Uplink for Message Groups      FidoNet     ║
 +║ │Local Address (AKA)            Best Match  ║
 ║ │Route To                       Disabled    ║ ║ │Route To                       Disabled    ║
 ║ │Inbox Directory                            ║ ║ │Inbox Directory                            ║
Line 455: Line 521:
  
 == AreaFix Password == == AreaFix Password ==
-AreaFix passwords are required to be included in the //Subject// line of received AreaFix requests (NetMail messages). +AreaFix passwords (AKA AreaManager passwords) are required to be included in the //Subject// line of received AreaFix/AreaManager requests (NetMail messages). 
-AreaFix Passwords are case insensitive.                         +AreaFix Passwords are case insensitive and cannot contain spaces.                         
 This setting may be managed by the node using AreaFix requests.  This setting may be managed by the node using AreaFix requests. 
  
Line 502: Line 568:
 == Inbox Directory == == Inbox Directory ==
 Inbox Directory is only used in BSO operating mode and is an optional Inbox Directory is only used in BSO operating mode and is an optional
-alternate directory to search for incoming files from this node   +alternate directory to search for incoming files from this node 
-(e.g. used in combination with BinkD's ibox setting).            +(e.g. used in combination with BinkD's ''ibox'' setting). 
 + 
 +Note: [[module:BinkIT]] does **not support** inboxes at this time.
  
 == Outbox Directory == == Outbox Directory ==
-Outbox Directory is only used in BSO operating mode and is an optional  +Outbox Directory is only used in BSO operating mode and is an optional
 alternate directory to place outbound files for this node (e.g. used alternate directory to place outbound files for this node (e.g. used
-in combination with BinkD's obox setting).                          +in combination with BinkD's ''obox'' setting). 
 + 
 +Note: [[module:BinkIT]] has //experimental support// for outboxes at this time.
  
 == BinkP Settings == == BinkP Settings ==
Line 515: Line 585:
  
 <file> <file>
-╔═════════════════════════════╗ +╔═════════════════════════════════════╗ 
-║   1:218/700 BinkP Settings  ║ +║       1:218/700 BinkP Settings      ║ 
-╠═════════════════════════════╣ +╠═════════════════════════════════════╣ 
-║ │Host                       ║ +║ │Host                               ║ 
-║ │Port                 24554 ║ +║ │Port                 24554         ║ 
-║ │Poll                 Yes   ║ +║ │Poll                 Yes           ║ 
-║ │Allow Plain Auth     No    ║ +║ │Authentication       CRAM-MD5 Only ║ 
-║ │Allow Plain Text     No    ║ +║ │Encryption           Supported     ║ 
-║ │Source Address             ║ +║ │Source Address                     ║ 
-╚═════════════════════════════╝+╚═════════════════════════════════════╝
 </file> </file>
 +
 +**Host** defines the TCP/IP address or host name with which to connect for sessions with this linked node.  If the host is not set, then a DNS-based look-up will be attempted (e.g. the IP address for 1:103/705 would be looked-up via host name f705.n103.z1.binkp.net). Nodelist-based look-ups are also supported.                         
 +                                                                        
 +**Port** defines the TCP port used by this linked node for BinkP sessions. The default BinkP TCP port is 24554.                                
 +                                                                        
 +**Poll** defines whether or not to periodically poll this linked node.
 +
 +**Authentication** determines what types of authentication will be supported during both inbound and outbound sessions with this linked node. The supported BinkP-auth methods are //Plain-Password// and //CRAM-MD5//.
 +                                                                        
 +**Encryption** determines whether unencrypted data transfers will be supported or required when communicating with this linked node. With this setting set to ''Required'', only BinkD-style-encrypted BinkP sessions will be supported. //CRAM-MD5// authentication must be used when encrypting BinkP sessions.
 +                                                                        
 +**Source** Address allows you to override the source FTN address used with outgoing BinkP mailer sessions with this linked node. Normally, this setting is left blank (not set).                     
  
 === Archive Types === === Archive Types ===
Line 628: Line 710:
 ║ │Ignore NetMail Destination Address      No    ║ ║ │Ignore NetMail Destination Address      No    ║
 ║ │Ignore NetMail 'Sent' Attribute         No    ║ ║ │Ignore NetMail 'Sent' Attribute         No    ║
 +║ │Ignore NetMail 'KillSent' Attribute     No    ║
 ║ │Ignore NetMail 'Received' Attribute     No    ║ ║ │Ignore NetMail 'Received' Attribute     No    ║
 ║ │Ignore NetMail 'Local' Attribute        No    ║ ║ │Ignore NetMail 'Local' Attribute        No    ║
Line 654: Line 737:
 ║ │Notify Users of Received EchoMail            Yes       ║ ║ │Notify Users of Received EchoMail            Yes       ║
 ║ │Convert Existing Tear Lines                  No        ║ ║ │Convert Existing Tear Lines                  No        ║
-║ │Strip Line Feeds from Outgoing Messages      No        ║ +║ │Automatically Add New Subs to Area List      List/File ║
-║ │Automatically Add New Subs to Area File      Yes       ║+
 ║ │Allow Nodes to Add Areas from Area File      Yes       ║ ║ │Allow Nodes to Add Areas from Area File      Yes       ║
 ║ │Maximum Backups to Maintain of Area File     100       ║ ║ │Maximum Backups to Maintain of Area File     100       ║
Line 682: Line 764:
  
 == Secure Operation == == Secure Operation ==
-When set to ''Yes'', SBBSecho will compare the origin of any +Secure Operation tells SBBSecho to check the Area File (e.g. ''areas.bbs'') to insure that the packet origin (FTN //address//) of each inbound EchoMail message is already linked to the EchoMail //area// where the message was posted. Messages denied import due to this setting are logged as a ''Security violation''. This setting defaults to ''No''.                                        
-incoming mail packets to the nodes in the Area File +
-as messages are imported.  If a packet password has been +
-defined for that node, it will also be compared to the +
-password contained in the mail packet. Packets and messages +
-failing this security will not be imported. +
  
 == Allow Nodes to Add Areas from Area File == == Allow Nodes to Add Areas from Area File ==
Line 696: Line 772:
 from any additionally configured EchoLists which they have from any additionally configured EchoLists which they have
 access to. access to.
 +
 +== Zone Blind SEEN-BY and PATH Lines ==
 +Zone Blind SEEN-BY and PATH Lines when Enabled will cause SBBSecho to assume that node numbers are not duplicated across zones and that a net/node combination in either of these Kludge lines should be used to identify a spcific node regardless of which zone that node is located in (thus breaking the rules of FidoNet 3D addressing).
 +
 +If you are having trouble with FidoNet echomail crossing Zone boundaries which does not add all the SEEN-BY and PATH nodes, then enable this option with the limit of "4".
  
 === Paths and Filenames === === Paths and Filenames ===
Line 869: Line 950:
 == AreaFix Keys == == AreaFix Keys ==
 These are the keys required for a node to be able to gain These are the keys required for a node to be able to gain
-access to this particular echo list.  These flags are defined +access to this particular echo list.  These keys are then given 
-for each node from the 'Linked Nodes...' sub-menu.+to chosen nodes in the 'Linked Nodes...' sub-menu.
 Selecting this option will bring you to a sub-menu where you Selecting this option will bring you to a sub-menu where you
 may add and remove keys for this EchoList. may add and remove keys for this EchoList.
Line 882: Line 963:
 ==== Instances ==== ==== Instances ====
  
-SBBSecho is designed to run only one instance at a time. A mutual-exclusion file (''[[dir:ctrl]]/sbbsecho.bsy'') is used to insure that multiple instances of SBBSecho are not allowed to execute concurrently. If SBBSecho crashes or is externally-killed without being able clean up after itself, it's possible this mutex file will be left behind and prevent SBBSecho from running normally for quite some time (depending on the configuration value of ''BSY Mutex File Timeout'').+SBBSecho is designed to run only one instance at a time. A mutual-exclusion file (''[[dir:ctrl]]/sbbsecho.bsy'') is used to insure that multiple instances of SBBSecho are not allowed to execute concurrently. If SBBSecho crashes or is externally-killed without being able to clean up after itself, it's possible this mutex file will be left behind and prevent SBBSecho from running normally for quite some time (depending on the configuration value of ''BSY Mutex File Timeout'').
  
 If you get the following error message (on the console and/or the log file) and you can confirm that SBBSecho is not actually running, you can safely delete the mutex file to allow SBBSecho to again run normally: If you get the following error message (on the console and/or the log file) and you can confirm that SBBSecho is not actually running, you can safely delete the mutex file to allow SBBSecho to again run normally:
Line 947: Line 1028:
 Remote area manager, or AreaFix, commands are used by linked nodes in order to Remote area manager, or AreaFix, commands are used by linked nodes in order to
 turn echo areas off and on, list currently connected areas, and more. turn echo areas off and on, list currently connected areas, and more.
-The following text is from the file ''[[http://cvs.synchro.net/cgi-bin/viewcvs.cgi/exec/areamgr.hlp|areangr.hlp]]'' which, after installation of+The following text is from the file ''[[https://gitlab.synchro.net/main/sbbs/-/raw/master/exec/areamgr.hlp|areamgr.hlp]]'' which, after installation of
 SBBSecho, should be located in your Synchronet ''[[dir:exec]]'' directory. This file lists the SBBSecho, should be located in your Synchronet ''[[dir:exec]]'' directory. This file lists the
 area manager commands available to the linked nodes which have been configured using area manager commands available to the linked nodes which have been configured using
 the ''[[util:echocfg]]'' program: the ''[[util:echocfg]]'' program:
 <file> <file>
-Address all requests to 'SBBSecho' or 'AreaFix' (without quotes). +Address all Area Management requests to 'AreaFix' (without quotes). 
-Your Area Manager password goes on the subject line.+Your Area Manager password goes in the message subject followed optionally 
 +by -R, -L, or -Q for Rescan, List, or Query functions, respectively.
  
-In the body of the message to Area Manager:+In the body of the message, one or more:
  
-[+]<areaname>         Connect an area +<areatag>             Connect a message area (echo) 
--<areaname>           Disconnect an area+-<areatag>            Disconnect an area
 %HELP                 Request this message %HELP                 Request this message
-%LIST                 Request a list of areas available to you+%LIST                 Request a list of areas (tags) available to you
 %QUERY                Request a list of areas to which you are connected %QUERY                Request a list of areas to which you are connected
 %UNLINKED             Request a list of areas to which you are not connected %UNLINKED             Request a list of areas to which you are not connected
-%COMPRESSION <type>   Change the compression type (e.g. ARC/ARJ/LZH/PAK/SQZ/ZIP/ZOO)+%COMPRESSION <type>   Change the compression type (e.g. ARC, ARJ, LZH, ZIP)
 %PASSWORD <password>  Change your Area Manager password %PASSWORD <password>  Change your Area Manager password
 %PKTPWD <password>    Set or change your Packet password %PKTPWD <password>    Set or change your Packet password
 %TICPWD <password>    Set or change your TIC File password %TICPWD <password>    Set or change your TIC File password
 %RESCAN               Request a rescan of all connected areas %RESCAN               Request a rescan of all connected areas
-%RESCAN <areaname>    Request a rescan of a single connected area+%RESCAN <areatag>     Request a rescan of a single connected area 
 +%ECHOSTATS <areatag>  Request statistics (import/export details) of an area
 %ACTIVE               Reconnect (resume) all temporarily disconnected areas %ACTIVE               Reconnect (resume) all temporarily disconnected areas
 %PASSIVE              Temporarily disconnect (pause) all connected areas %PASSIVE              Temporarily disconnect (pause) all connected areas
 +%NOTIFY <ON | OFF>    Turn periodic Notification Messages ON or OFF
 %FROM <address>       Remote/proxy Area Management, must be the first command %FROM <address>       Remote/proxy Area Management, must be the first command
 %+ALL                 Connect all available areas %+ALL                 Connect all available areas
Line 984: Line 1068:
  
 ==== Changes in Version 3 ==== ==== Changes in Version 3 ====
- 
-For a detailed list of changes and code differences introduced in v3.0, see [[http://cvs.synchro.net/cgi-bin/viewcvs.cgi/src/sbbs3/sbbsecho.c?revision=3.0&view=markup|This page in CVS]]. 
  
 The most major changes introduced in v3.0 are: The most major changes introduced in v3.0 are:

Trace: