Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
config:sbbsecho.ini [2019/06/16 22:40] digital man [BinkP Section] Added new PlainTextOnly option |
config:sbbsecho.ini [2022/03/14 19:54] (current) Andre [See Also] tags |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| - | ====== sbbsecho.ini file ====== | + | ====== SBBSecho (FidoNet EchoMail Program) Configuration ====== |
| ''[[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. | ''[[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 [[howto:Git]] [[https://gitlab.synchro.net/main/sbbs/-/raw/master/ctrl/sbbsecho.ini?inline=false|here]]. |
| ===== Editing ===== | ===== Editing ===== | ||
| Line 33: | Line 34: | ||
| | ''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 | | ||
| Line 41: | Line 43: | ||
| | ''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 === | ||
| Line 55: | Line 62: | ||
| | ''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 | | ||
| | ''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 | | | ''EchoStats'' | ''../data/echostats.ini'' | Path/filename of EchoMail Statistics ("EchoStats") database | | ||
| + | | ''RequireLinkedNodeCfg'' | ''true'' | Require that area-linked nodes (in the area file) are configured as linked-nodes | | ||
| === NetMail-related settings === | === NetMail-related settings === | ||
| Line 119: | Line 128: | ||
| | ''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 | | ||
| Line 128: | Line 137: | ||
| | ''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) | | ||
| Line 136: | Line 146: | ||
| | ''BinkpAllowPlainText'' | ''true'' | Allow plain-text (unencrypted) communication 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:** | ||
| Line 141: | Line 152: | ||
| === Example === | === Example === | ||
| - | <file> | + | <code ini> |
| [node:1:218/700] | [node:1:218/700] | ||
| Comment = My Hub | Comment = My Hub | ||
| Line 169: | Line 180: | ||
| Status = Normal | Status = Normal | ||
| Route = 1:218/700 | Route = 1:218/700 | ||
| - | </file> | + | </code> |
| === BinkP Session-Security === | === BinkP Session-Security === | ||
| Line 184: | Line 195: | ||
| 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. | 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. | ||
| + | |||
| + | |||
| + | ==== Robot Sections ==== | ||
| + | |||
| + | Each NetMail Robot Section has a prefix of "''robot:''" with the name of the robot (e.g. ''filefix'') following the prefix. Received NetMail addressed to the name of a robot will be stored in your ''[[dir:data]]/mail'' base and expected to be acted-up by a robot that is trigged when its associated semaphore file is touched. [[module:TickFix]] is an example of a NetMail robot. | ||
| + | |||
| + | ^ Key ^ Description ^ | ||
| + | | ''SemFile'' | The path and filename of a semaphore file to be //touched// by SBBSecho when a NetMail is received for the robot | | ||
| + | | ''attr'' | NetMail attribute flags to set (usually specific in hexadecimal notation with a ''0x'' prefix), ''0x20'' (In-Transit) is recommended | | ||
| ==== Domain Sections ==== | ==== Domain Sections ==== | ||
| Line 210: | Line 230: | ||
| ===== 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>configuration echomail fidonet ftn netmail email messaging ini}} |
