Both sides previous revisionPrevious revision | Next revisionBoth sides next revision |
util:sbbsecho [2018/03/01 12:11] – Links to util:binkit changed to module:binkit digital man | util:sbbsecho [2018/03/01 12:20] – old revision restored digital man |
---|
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. | 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. |
| |
[[module:binkit]] can also export a group of message areas (sub-boards) to an SBBSecho-compatible Area File. | [[util:SCFG]] can also export a group of message areas (sub-boards) to an SBBSecho-compatible Area File. |
You may want to first import a network's EchoList (e.g. FidoNet's ''BACKBONE.NA'') into a message group (using [[module:binkit]]) and then export the networked message group(s) from [[module:binkit]] to the SBBSecho-compatible Area File once you're linked successfully with your network hub. | 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. |
| |
===== Area File Format ===== | ===== Area File Format ===== |
| |
=== 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 ''[[module:binkit]]''->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 ==== |
| |
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 [[module:binkit]] | - Configure your fundamental FTN settings (e.g. system address) in [[util:SCFG]] |
- Use the ''[[module:binkit]]'' 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 ==== |
| |
The fundamental FTN-related system settings are configured via [[module:binkit]]->Networks->FidoNet EchoMail and NetMail: | The fundamental FTN-related system settings are configured via [[SCFG]]->Networks->FidoNet EchoMail and NetMail: |
<file> | <file> |
╔══════════════════════════════════════════════════════════╗ | ╔══════════════════════════════════════════════════════════╗ |
SBBSecho will create ''*.msg'' files in this directory when creating NetMail messages (e.g. auto-responding to ''PING'' or ''AreaFix'' requests, notices to the //Area Manager//, or exporting NetMail from the "mail" msgbase) or exporting NetMail from inbound [[ref:fidonet_files#packet|Packets]]. SBBSecho will discover ''*.msg'' files in this directory when Packing outbound NetMail, importing into the "mail" msgbase, or handling AreaFix and PING requests. | SBBSecho will create ''*.msg'' files in this directory when creating NetMail messages (e.g. auto-responding to ''PING'' or ''AreaFix'' requests, notices to the //Area Manager//, or exporting NetMail from the "mail" msgbase) or exporting NetMail from inbound [[ref:fidonet_files#packet|Packets]]. SBBSecho will discover ''*.msg'' files in this directory when Packing outbound NetMail, importing into the "mail" msgbase, or handling AreaFix and PING requests. |
| |
The other NetMail-related settings on this [[module:binkit]] menu affect only FidoNet NetMail messages created by the Synchronet [[:server:Terminal]] Server; they are not used by SBBSecho. | The other NetMail-related settings on this [[util:SCFG]] menu affect only FidoNet NetMail messages created by the Synchronet [[:server:Terminal]] Server; they are not used by SBBSecho. |
| |
=== Default Origin Line === | === Default Origin Line === |
| |
=== 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 [[module:binkit]]. | 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]]. |
| |
| |
| |
| |
Upon running ''[[module:binkit]]'' you will be brought to the main menu of the configuration | Upon running ''[[util:echocfg]]'' you will be brought to the main menu of the configuration |
program. The path and filename of the configuration file being modified will | program. The path and filename of the configuration file being modified will |
appear at the top of the menu. Following are screen captures of available menus | appear at the top of the menu. Following are screen captures of available menus |
| |
==== Command Line ==== | ==== Command Line ==== |
Although you //can// just run SBBSecho (e.g. ''sbbsecho.exe'') with no command-line options, each and every time, and it'll probably do what you need it to do... for optimal performance, we suggest you use the following command lines (e.g. configured in [[module:binkit]]->External Programs->Timed Events) to limit SBBSecho to performing only the tasks it needs to do based on the type of //event// that has been triggered: | Although you //can// just run SBBSecho (e.g. ''sbbsecho.exe'') with no command-line options, each and every time, and it'll probably do what you need it to do... for optimal performance, we suggest you use the following command lines (e.g. configured in [[util:SCFG]]->External Programs->Timed Events) to limit SBBSecho to performing only the tasks it needs to do based on the type of //event// that has been triggered: |
For importing netmail and echomail (e.g. ''FIDOIN'' timed event): | For importing netmail and echomail (e.g. ''FIDOIN'' timed event): |
sbbsecho -ce | sbbsecho -ce |
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 ''[[module:binkit]]'' program: | the ''[[util:echocfg]]'' program: |
<file> | <file> |
Address all requests to 'SBBSecho' or 'AreaFix' (without quotes). | Address all requests to 'SBBSecho' or 'AreaFix' (without quotes). |
- New configuration file format (''sbbsecho.cfg'' replaced with ''[[config:sbbsecho.ini]]'') | - New configuration file format (''sbbsecho.cfg'' replaced with ''[[config:sbbsecho.ini]]'') |
- Support for FileBoxes (BinkD-style inbox and outbox, configured per linked-node) | - Support for FileBoxes (BinkD-style inbox and outbox, configured per linked-node) |
- Much better organized and user-friendly ''[[module:binkit]]'' (e.g. lots of context-sensitive help available) | - Much better organized and user-friendly ''[[util:echocfg]]'' (e.g. lots of context-sensitive help available) |
- Attach/ArcMail style mailer support has been deprecated (untested, unlikely to work) in favor of Binkley/FLO type mailers | - Attach/ArcMail style mailer support has been deprecated (untested, unlikely to work) in favor of Binkley/FLO type mailers |
- "Additional EchoList" 4-char "flags" are now 25-char "keys" and much easier to deal with | - "Additional EchoList" 4-char "flags" are now 25-char "keys" and much easier to deal with |
| |
**Note**: | **Note**: |
In SBBSecho v2, if you did not have an ''INBOUND'' directory specified in your ''sbbsecho.cfg'' file (specifying a location for non-secured inbound files), SBBSecho v2 would use the path specified in [[module:binkit]]->Networks->FidoNet->Inbound File Directory. That configuration setting (stored in the file ''[[dir:ctrl]]/msgs.cnf'') was not used by Synchronet for any other purpose and has now been removed from SCFG (v3.17). When ''sbbsecho_upgrade.js'' converts your ''sbbsecho.cfg'' file to ''sbbsecho.ini'', if you don't have an ''INBOUND'' directory specified, it will need to make a //best guess// as to the proper //non-secure// inbound directory and that's what will be saved in your new ''[[dir:ctrl]]/[[config:sbbsecho.ini]]'' file. You may want to double-check that this setting is correct. | In SBBSecho v2, if you did not have an ''INBOUND'' directory specified in your ''sbbsecho.cfg'' file (specifying a location for non-secured inbound files), SBBSecho v2 would use the path specified in [[util:SCFG]]->Networks->FidoNet->Inbound File Directory. That configuration setting (stored in the file ''[[dir:ctrl]]/msgs.cnf'') was not used by Synchronet for any other purpose and has now been removed from SCFG (v3.17). When ''sbbsecho_upgrade.js'' converts your ''sbbsecho.cfg'' file to ''sbbsecho.ini'', if you don't have an ''INBOUND'' directory specified, it will need to make a //best guess// as to the proper //non-secure// inbound directory and that's what will be saved in your new ''[[dir:ctrl]]/[[config:sbbsecho.ini]]'' file. You may want to double-check that this setting is correct. |
| |
**Note**: | **Note**: |
==== Migrating Command-lines to Version 3 ==== | ==== Migrating Command-lines to Version 3 ==== |
| |
Although the old import and export SBBSecho command-lines (e.g. pre-configured for the ''FIDOIN'' and ''FIDOOUT'' timed events in [[module:binkit]]->External Programs->Timed Events) will continue to work, some of the old command-line options are now ignored or serve a different purpose in version 3: | Although the old import and export SBBSecho command-lines (e.g. pre-configured for the ''FIDOIN'' and ''FIDOOUT'' timed events in [[util:SCFG]]->External Programs->Timed Events) will continue to work, some of the old command-line options are now ignored or serve a different purpose in version 3: |
| |
^ Option ^ Version 2 ^ Version 3 ^ | ^ Option ^ Version 2 ^ Version 3 ^ |
|''-f'' | packetize netmail | default behavior; use the new ''-q'' option to disable | | |''-f'' | packetize netmail | default behavior; use the new ''-q'' option to disable | |
|''-j'' | ignore received bit on netmail | enabled via ''[[config:sbbsecho.ini]]'' -> ''IgnoreNetmailRecvAttr'' | | |''-j'' | ignore received bit on netmail | enabled via ''[[config:sbbsecho.ini]]'' -> ''IgnoreNetmailRecvAttr'' | |
|''-a'' | export ASCII characters only | use the sub-board toggle option in [[module:binkit]] | | |''-a'' | export ASCII characters only | use the sub-board toggle option in [[util:SCFG]] | |
|''-y'' | import netmail for unknown users to sysop | configured via ''[[config:sbbsecho.ini]]'' -> ''DefaultRecipient'' | | |''-y'' | import netmail for unknown users to sysop | configured via ''[[config:sbbsecho.ini]]'' -> ''DefaultRecipient'' | |
|''-o'' | import netmail regardless of destination address | configured via ''[[config:sbbsecho.ini]]'' -> ''IgnoreNetmailDestAddr'' | | |''-o'' | import netmail regardless of destination address | configured via ''[[config:sbbsecho.ini]]'' -> ''IgnoreNetmailDestAddr'' | |
* [[:network:fidonet|What is FidoNet?]] | * [[:network:fidonet|What is FidoNet?]] |
* [[:howto:fidonet|Join FidoNet]] | * [[:howto:fidonet|Join FidoNet]] |
* [[module:binkit|Utilities]] | * [[:util:|Utilities]] |
| |