Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision |
config:sbbsecho.ini [2018/06/28 15:48] – Updated with a lot of missing info/keys digital man | config:sbbsecho.ini [2021/03/20 18:41] – [Root Section] Document MaxLogSize and MaxLogsKept digital man |
---|
====== sbbsecho.ini ====== | ====== SBBSecho (FidoNet EchoMail Program) Configuration ====== |
| |
''[[dir:ctrl]]/sbbsecho.ini'' is the default configuration filename used by [[util:SBBSecho]] version 3 and [[module:BinkIT]] version 2. 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. | ''[[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 current 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 ===== |
| ''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 | |
| | ''StripSoftCRs'' | ''true'' | Strip soft carriage-return (0x8D) characters from imported messages | |
| ''BinkleyStyleOutbound'' | ''true'' | Mailer is BSO/FLO style (rather than ArcMail/Attach style) | | | ''BinkleyStyleOutbound'' | ''true'' | Mailer is BSO/FLO style (rather than ArcMail/Attach style) | |
| ''BsyTimeout'' | ''12 hours'' | Time-out duration when attempting to lock ''.bsy'' files | | | ''BsyTimeout'' | ''12 hours'' | Time-out duration when attempting to lock ''.bsy'' files | |
| ''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)| | | ''CfgFileBackups'' | ''100'' | Number of configuration file backups to maintain (for Area Manager or EchoCfg modifications)| |
| | ''MaxLogSize'' | ''10M'' | Maximum size (in bytes) of each SBBSecho log file (0 = no limit) | |
| | ''MaxLogsKept'' | ''10'' | Maximum number of SBBSecho log files to keep | |
| | ''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 === |
| ''ZoneBlindThreshold'' | ''65535'' | Zone numbers less than this will be considered //blind// (all part of the same node number "namespace") | | | ''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 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 | | | ''RelayFilteredMsgs'' | ''false'' | Messages that are filtered (e.g. due to age) will be relayed to downlinks | |
The ''[BinkP]'' section is used for BinkP-specific global settings (i.e. used exclusively by [[module:BinkIT]] version 2): | The ''[BinkP]'' section is used for BinkP-specific global settings (i.e. used exclusively by [[module:BinkIT]] version 2): |
| |
^ Key ^ Default Value ^ Description ^ | ^ Key ^ Default Value ^ Description ^ |
| Capabilities | <blank> | If set, changes the text in the ''M_NUL NDL'' line from the default of “115200,TCP,BINKP” | | | 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) | | | 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 ==== |
| |
| ''Name'' | | Name of this linked-node's operator (e.g. real name or alias), auto-set when receiving Area Manager requests | | | ''Name'' | | Name of this linked-node's operator (e.g. real name or alias), auto-set when receiving Area Manager requests | |
| ''Comment'' | | Personal comment about this node (any text useful to you) | | | ''Comment'' | | Personal comment about this node (any text useful to you) | |
| ''Inbox'' | | Optional filebox for incoming files (correlates with BinkD's ''ibox'' setting) | | | ''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) | | | ''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 | |
| ''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 | |
| | ''LocalAddress'' | | Optional local system address (AKA) to use when sending packets to this node | |
| ''GroupHub'' | | List of Message Groups (comma-separated) for which this linked node is your system's uplink (hub) | | | ''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) | | | ''BinkpHost'' | | Host name or IP address of this link's BinkP mailer (optional) | |
| ''BinkpPort'' | ''24554'' | TCP port number of this link's BinkP mailer | | | ''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 | | | ''BinkpPoll'' | ''false'' | Poll this link (e.g. as part of the ''BINKPOLL'' timed event) for incoming mail | |
| ''BinkpAllowPlainAuth'' | ''false''| Allow plain-password authentication for this linked node | | | ''BinkpAllowPlainAuth'' | ''false''| Allow plain-password (in addition to CRAM-MD5) when authenticating with this linked node | |
| ''BinkpAllowPlainText'' | ''false''| Allow plain-text (unencrypted) communication 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 | | | ''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] |
Route = 1:218/700 | Route = 1:218/700 |
</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 ==== | ==== Domain Sections ==== |
===== See Also ===== | ===== See Also ===== |
* [[:config:|config index]] | * [[:config:|config index]] |
* [[:util:SBBSecho]] | * [[:util:SBBSecho]] FidoNet EchoMail program (tosser/scanner) |
* [[:util:echocfg]] | * [[:util:echocfg]] SBBSecho Configuration utility |
| * [[:module:BinkIT]] FidoNet/BINKP mailer |
| |
{{tag>}} | {{tag>fidonet}} |
| |