Differences

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

Link to this comparison view

Next revision
Previous revision
Next revisionBoth sides next revision
config:sbbsecho.ini [2017/10/12 21:58] – created digital manconfig:sbbsecho.ini [2019/12/11 13:40] – [Node Sections] document the BinkpTLS option digital man
Line 1: Line 1:
-====== sbbsecho.ini ======+====== sbbsecho.ini file ======
  
-''[[dir:ctrl]]/sbbsecho.ini'' is the default configuration filename used by [[util:SBBSecho]] version 3. While other configuration filenames may be passed-to and used-by SBBSecho, the format must be the same [[ini_files|.ini format]] and only one configuration file may be used per invocation of SBBSecho or echocfg.+''[[dir:ctrl]]/sbbsecho.ini'' is the default configuration filename used by [[util:SBBSecho]] version 3, [[module:BinkIT]] version 2, and [[module:TickIT]] version 1. While other configuration filenames may be passed-to and used-by SBBSecho, the format must be the same [[ini_files|.ini format]] and only one configuration file may be used per invocation of SBBSecho.
  
-The default ''sbbsecho.ini'' file can be downloaded from CVS [[http://cvs.synchro.net/cgi-bin/viewcvs.cgi/*checkout*/ctrl/sbbsecho.ini|here]].+The current default ''sbbsecho.ini'' file can be downloaded from CVS [[http://cvs.synchro.net/cgi-bin/viewcvs.cgi/*checkout*/ctrl/sbbsecho.ini|here]].
  
 ===== Editing ===== ===== Editing =====
  
-You can edit the ''sbbsecho.ini'' file by hand using any text editor or, preferably, use the [[:util:echocfg]] utility.+You can edit the ''sbbsecho.ini'' file by hand using any text editor or, preferably, using the Synchronet [[:util:EchoCfg]] utility.
  
-**NOTE:** +When editing the ''sbbsecho.ini'' file by hand, it is recommended to first make a backup copy of the file.
-Not all values in the ''sbbsecho.ini'' file may be viewable or modifiable via [[:util:echocfg]].+
  
 ===== Reference ===== ===== Reference =====
Line 34: Line 33:
 | ''LogLevel''            | ''Informational''         | Minimum severity of log messages written to the log file | | ''LogLevel''            | ''Informational''         | Minimum severity of log messages written to the log file |
 | ''StripLineFeeds''        | ''false''               | Strip line-feed (ASCII 10) characters from exported messages | | ''StripLineFeeds''        | ''false''               | Strip line-feed (ASCII 10) characters from exported messages |
-| ''BinkleyStyleOutbound''  | ''true''                | Mail-style is Binkley/FLO style |   +| ''StripSoftCRs''          | ''true''                | Strip soft carriage-return (0x8D) characters from imported messages | 
-| ''BsyTimeout''            | ''12 hours''            | Time-out on ''.bsy'' files |+| ''BinkleyStyleOutbound''  | ''true''                | Mailer is BSO/FLO style (rather than ArcMail/Attach style) |   
 +| ''BsyTimeout''            | ''12 hours''            | Time-out duration when attempting to lock ''.bsy'' files |
 | ''BsoLockAttempts''       | ''60''                  | Number of attempts to lock a BSO for a node | | ''BsoLockAttempts''       | ''60''                  | Number of attempts to lock a BSO for a node |
 | ''BsoLockDelay''          | ''10 seconds''          | Delay between BSO lock attempts | | ''BsoLockDelay''          | ''10 seconds''          | Delay between BSO lock attempts |
-| ''UseFTNDomains''         | ''false''               | Domain->zone mapping defined in ''[[dir:ctrl]]/[[config:ftn_domains.ini]]'' | 
 | ''StrictPacketPasswords'' | ''true''                | Packets with passwords must match the corresponding configured/linked node password | | ''StrictPacketPasswords'' | ''true''                | Packets with passwords must match the corresponding configured/linked node password |
-| ''RelayFilteredMsgs''     | ''false''               | Messages that are filtered (e.g. due to age) will be relayed to downlinks | 
 | ''umask''                 | ''077''                 | File creation mode (for *nix only) | | ''umask''                 | ''077''                 | File creation mode (for *nix only) |
 | ''AreaFileBackups''       | ''100''                 | Number of Area File backups to maintain (for Area Manager modifications) | | ''AreaFileBackups''       | ''100''                 | Number of Area File backups to maintain (for Area Manager modifications) |
 +| ''CfgFileBackups''        | ''100''                 | Number of configuration file backups to maintain (for Area Manager or EchoCfg modifications)|
 +| ''MinFreeDiskSpace''      | ''10M''                 | Minimum amount of available disk space required for SBBSecho to operate |
 +| ''UseOutboxes''           | ''true''                | If a linked-node has an outbox value specified, place outbound files for that node in it |
 +| ''AutoUTF8''              | ''true''                | Automatically detect UTF-8-encoded incoming messages and mark them accordingly |
  
 === EchoMail-related settings === === EchoMail-related settings ===
  
 ^ Key                              ^ Default Value  ^ Description ^ ^ Key                              ^ Default Value  ^ Description ^
-| ''BundleSize''                   | ''250K''       | Outgoing bundles (archive), maximum file size | +| ''BundleSize''                   | ''250K''       | Outgoing bundles (archives), maximum file size | 
-| ''PacketSize''                   | ''250K''       | Outgoing packets, maximum file size |+| ''PacketSize''                   | ''250K''       | Outgoing packets (''*.pkt''), maximum file size |
 | ''CheckPathsForDupes''           | ''true''       | Check PATH kludge lines for circular messages | | ''CheckPathsForDupes''           | ''true''       | Check PATH kludge lines for circular messages |
-| ''SecureEchomail''               | ''false''      | Only imported echomail from linked nodes |+| ''SecureEchomail''               | ''false''      | Only import EchoMail from linked nodes |
 | ''EchomailNotify''               | ''true''       | Send telegrams to BBS users when EchoMail is received for them | | ''EchomailNotify''               | ''true''       | Send telegrams to BBS users when EchoMail is received for them |
 | ''ConvertTearLines''             | ''false''      | Convert any tear lines (''---'') existing in the message text to ''==='' | | ''ConvertTearLines''             | ''false''      | Convert any tear lines (''---'') existing in the message text to ''==='' |
 | ''TruncateBundles''              | ''false''      | Truncate rather than delete outbound bundles after being sent | | ''TruncateBundles''              | ''false''      | Truncate rather than delete outbound bundles after being sent |
-| ''ZoneBlind''                    | ''false''      | Assume that node numbers are not duplicated across zones | +| ''ZoneBlind''                    | ''false''      | Assume that node numbers are not duplicated across zones (set to ''true'' with a Threshold of ''4'' for "FidoWeb" operation) 
-| ''ZoneBlindThreshold''           | ''65535''      | Zone numbers less than this will be considered //blind// |+| ''ZoneBlindThreshold''           | ''65535''      | Zone numbers less than this will be considered //blind// (all part of the same node number "namespace"|
 | ''AreaAddFromEcholistsOnly''     | ''false''      | Allow echoes to be AreaFix-added from Additional EchoLists only (not Area File) | | ''AreaAddFromEcholistsOnly''     | ''false''      | Allow echoes to be AreaFix-added from Additional EchoLists only (not Area File) |
 +| ''AutoAddSubs''                  | ''true''       | Automatically add new Sub-boards within linked Message Groups to the run-time Area List |
 +| ''AutoAddToAreaFile''            | ''true''       | Automatically add new Sub-boards within linked Message Groups to the on-disk Area File |
 | ''MaxEchomailAge''               | ''60 days''    | Age limit (in days) of EchoMail messages that may be imported (0 = no limit) | | ''MaxEchomailAge''               | ''60 days''    | Age limit (in days) of EchoMail messages that may be imported (0 = no limit) |
 +| ''RelayFilteredMsgs''            | ''false''      | Messages that are filtered (e.g. due to age) will be relayed to downlinks |
 | ''AreaManager''                  | ''SYSOP''      | BBS user name or alias to notify (via email) of AreaFix activities and errors | | ''AreaManager''                  | ''SYSOP''      | BBS user name or alias to notify (via email) of AreaFix activities and errors |
 +| ''EchoStats''                    | ''../data/echostats.ini'' | Path/filename of EchoMail Statistics ("EchoStats") database |
  
 === NetMail-related settings === === NetMail-related settings ===
Line 69: Line 74:
 | ''IgnoreNetmailDestAddr''        | ''false''     | Treat all NetMail as though it is destined for one of your systems's FTN addresses | | ''IgnoreNetmailDestAddr''        | ''false''     | Treat all NetMail as though it is destined for one of your systems's FTN addresses |
 | ''IgnoreNetmailSentAttr''        | ''false''     | Export NetMail messages even when their 'Sent' attribute flag is set | | ''IgnoreNetmailSentAttr''        | ''false''     | Export NetMail messages even when their 'Sent' attribute flag is set |
 +| ''IgnoreNetmailKillAttr''        | ''false''     | Do not delete exported NetMail messages even when their 'Kill' attribute flag is set |
 | ''IgnoreNetmailRecvAttr''        | ''false''     | Import NetMail messages even when their 'Received' attribute flag is set | | ''IgnoreNetmailRecvAttr''        | ''false''     | Import NetMail messages even when their 'Received' attribute flag is set |
 | ''IgnoreNetmailLocalAttr''       | ''false''     | Import NetMail messages even when their 'Local' attribute flag is set | | ''IgnoreNetmailLocalAttr''       | ''false''     | Import NetMail messages even when their 'Local' attribute flag is set |
 | ''KillEmptyNetmail''             | ''true''      | Discard (not import or export) NetMail messages without any body | | ''KillEmptyNetmail''             | ''true''      | Discard (not import or export) NetMail messages without any body |
-| ''DeleteNetmail''                | ''true''      | Delete NetMail messages/files after they have been sent or imported |+| ''DeleteNetmail''                | ''true''      | Delete **all** NetMail messages/files after they have been sent or imported |
 | ''DeletePackets''                | ''true''      | Delete packets after they've been imported | | ''DeletePackets''                | ''true''      | Delete packets after they've been imported |
 | ''MaxNetmailAge''                | ''0''         | Age limit (in days) of NetMail messages that may be imported (0 = no limit) | | ''MaxNetmailAge''                | ''0''         | Age limit (in days) of NetMail messages that may be imported (0 = no limit) |
  
 +==== BinkP Section ====
 +
 +The ''[BinkP]'' section is used for BinkP-specific global settings (i.e. used exclusively by [[module:BinkIT]] version 2):
 +
 +^ Key           ^ Default Value ^ Description ^
 +| Capabilities  | <blank>       | If set, changes the text in the ''M_NUL NDL'' line from the default of “115200,TCP,BINKP” |
 +| Sysop         | <blank>       | If set, over-rides the sysop name (''ZYZ'') value (e.g. to send the sysop's real name instead of alias) |
 +| PlainAuthOnly | ''false''     | If set to ''true'', disables CRAM-MD5 authentication and encryption support for all inbound and outbound sessions (e.g. for trouble-shooting purposes) |
 +| PlainTextOnly | ''false''     | If set to ''true'', disables encryption support for all inbound and outbound sessions (when set to ''false'', requires that //PlainAuthOnly// is also set to ''false'') |
 ==== Archive Sections ==== ==== Archive Sections ====
 +
 +Archivers are used to extract packets from received bundles and create bundles of outgoing packets. Archivers are configured in the Archive Sections of the ''sbbsecho.ini'' file (separately from any archivers configured in Synchronet/[[util:SCFG]]).
  
 Each Archive Section has a prefix of "''archive:''" and the name of the archive type (e.g. "ZIP") following the prefix. Each Archive Section has a prefix of "''archive:''" and the name of the archive type (e.g. "ZIP") following the prefix.
Line 102: Line 119:
 | ''PacketType'' | ''2+''        | Type of packets to generate for this node (2+, 2e, 2.2, or 2) | | ''PacketType'' | ''2+''        | Type of packets to generate for this node (2+, 2e, 2.2, or 2) |
 | ''PacketPwd''  |               | Password used in password-protected packets | | ''PacketPwd''  |               | Password used in password-protected packets |
 +| ''SessionPwd'' |               | Password used for BinkP (BinkIT) sessions with this linked node |
 | ''AreaFixPwd'' |               | Password required for AreaFix/AreaMgr operations | | ''AreaFixPwd'' |               | Password required for AreaFix/AreaMgr operations |
-| ''Comment''    |               | Personal comment about this node | +| ''TicFilePwd'' |               | Password required for TIC files (used by ''[[module:tickit]].js'') | 
-| ''Inbox''      |               | Optional filebox for incoming files (correlates with BinkD's ''ibox'' setting) | +| ''Name''                     | Name of this linked-node's operator (e.g. real name or alias), auto-set when receiving Area Manager requests | 
-| ''Outbox''                   | Optional filebox for outgoing files (correlates with BinkD's ''obox'' setting) |+| ''Comment''    |               | Personal comment about this node (any text useful to you) 
 +| ''Inbox''      |               | Optional filebox for incoming files (correlates with BinkD's ''ibox'' setting, [[module:BinkIT]] does **not support** inboxes) | 
 +| ''Outbox''                   | Optional filebox for outgoing files (correlates with BinkD's ''obox'' setting, [[module:BinkIT]] has //experimental support// for outboxes) |
 | ''Keys''                     | List of keys (comma-separated) which enable AreaFix access to one or more Additional EchoLists | | ''Keys''                     | List of keys (comma-separated) which enable AreaFix access to one or more Additional EchoLists |
 | ''Notify''     | ''false''     | Notify via NetMail of node's current AreaFix settings whenever SBBSecho is run with the '`-g`' option | | ''Notify''     | ''false''     | Notify via NetMail of node's current AreaFix settings whenever SBBSecho is run with the '`-g`' option |
Line 112: Line 132:
 | ''Status''     | ''Normal''    | Default mode for sending mail to this node: Normal, Hold (wait for pickup) or Crash (immediate) | | ''Status''     | ''Normal''    | Default mode for sending mail to this node: Normal, Hold (wait for pickup) or Crash (immediate) |
 | ''Archive''    | ''None''      | Name of a configured archive type or "None" | | ''Archive''    | ''None''      | Name of a configured archive type or "None" |
-| ''Route''      |               | FTN address (e.g. of a hub) to route all echomail and netmail destined for this node's address |+| ''Route''      |               | FTN address (e.g. of a hub) to route all EchoMail and NetMail destined for this node's address 
 +| ''GroupHub''                 | List of Message Groups (comma-separated) for which this linked node is your system's uplink (hub) | 
 +| ''BinkpHost''  |               | Host name or IP address of this link's BinkP mailer (optional) | 
 +| ''BinkpPort''  | ''24554''    | TCP port number of this link's BinkP mailer | 
 +| ''BinkpPoll''  | ''false''    | Poll this link (e.g. as part of the ''BINKPOLL'' timed event) for incoming mail | 
 +| ''BinkpAllowPlainAuth'' | ''false''| Allow plain-password (in addition to CRAM-MD5) when authenticating with this linked node | 
 +| ''BinkpPlainAuthOnly''  | ''false''| //Only// support plain-password authentication when connecting (outbound) with this linked node | 
 +| ''BinkpAllowPlainText'' | ''true'' | Allow plain-text (unencrypted) communication with this linked node | 
 +| ''BinkpSourceAddress''  |          | Use an alternative FTN address as the source address when communicating with this node via BinkP | 
 +| ''BinkpTLS''            | ''false''| Use implicit TLS for outbound encrypted connections with this linked node |
  
 **NOTE:** **NOTE:**
 The wildcard ''ALL'' may replace one or more fields of the configured node's FTN address. Configured node's with wildcard addresses cannot have an Inbox our Outbox set. The wildcard ''ALL'' may replace one or more fields of the configured node's FTN address. Configured node's with wildcard addresses cannot have an Inbox our Outbox set.
  
-Example:+=== Example ===
 <file> <file>
 [node:1:218/700] [node:1:218/700]
Line 148: Line 177:
 </file> </file>
  
 +=== BinkP Session-Security ===
 +
 +The evolution of the BinkIT/BinkP session-security related settings has lead to a potentially confusing array of 3 interrelated Boolean options with only 4 valid combinations of values. Here is a table to explain these valid combinations and their impact on the security and interoperability of BinkP sessions with the linked-node:
 +
 +^ Security Level ^ BinkpPlainAuthOnly ^ BinkpAllowPlainAuth ^ BinkpAllowPlainText ^ Notes ^
 +| Minimum        | ''true''           | ''true''            | ''true''            | Passwords and message packets will always be sent as clear-text (maximum interoperability) |
 +| Normal         | ''false''          | ''true''            | ''true''            | Passwords //may// be obscured via CRAM-MD5 authentication |
 +| Enhanced       | ''false''          | ''false''           | ''true''            | Passwords //must// be obscured via CRAM-MD5 authentication |
 +| Maximum        | ''false''          | ''false''           | ''false''           | Passwords and message packets //must// be obscured or encrypted ((using the BinkD method of session encryption)) |
 +
 +In general, the lower the security setting, the higher the level of insured compatibility with other BinkP mailers. When debugging authentication (password) issues, it might be a good idea to use the minimum level of security and increase the security level incrementally once you have the minimum level of secured-session working with the linked-node.
 +
 +Also note: authentication is performed by the //answering// BinkP node (server/service), so while one security level may work okay for outgoing connections to a linked-node, its possible that there could be problems (incompatibilities) with incoming connections from that same linked-node. It's a good idea to test both incoming and outgoing connections with a linked-node before increasing the BinkP session security level.
 +
 +
 +==== Domain Sections ====
 +
 +Each FTN Domain Section has a prefix of "''domain:''" with the name of the domain (e.g. ''fidonet'', ''fsxnet'') following the prefix.
 +
 +^ Key             ^ Description ^
 +| ''Zones''       | List of zone numbers (comma-separated) associated with this domain |
 +| ''DNSSuffix''   | Optional suffix used for DNS-based IP address look-ups of nodes in this domain (e.g. ''f//<node>//.n//<net>//.z//<zone>//.//<suffix>//'') |
 +| ''NodeList''    | Optional nodelist path/filename to use for hostname/IP address look-ups for this domain |
 +| ''OutboundRoot''| Optional alternate outbound root directory to use for this domain |
 +
 +**Note:**\\
 +FTN domains //used// to be configured in the now-deprecated ''[[dir:ctrl]]/ftn_domains.ini'' file.
  
 ==== EchoList Sections ==== ==== EchoList Sections ====
config/sbbsecho.ini.txt · Last modified: 2022/03/14 19:54 by Andre
Back to top
CC Attribution 4.0 International
Driven by DokuWiki Recent changes RSS feed Valid CSS Valid XHTML 1.0