Table of Contents
BinkIT is a simple BinkP-only BSO mailer. It can be used instead of binkd, but does not have as many features and is still experimental.
- BinkP 1.1 support (except for the undocumented No Dupes mode)
- Supports BinkD compatible encryption
- Supports secure CRAM-MD5 authentication
- Full 5D support
- Creates semaphore files for TIC (tickit.now) and Fido (fidoin.now) events automatically
- FREQIT integration for file requests from subs
- Nodelist support, can read the hostname and port number from a nodelist
BinkIT should be configured both as a service and as a timed event.
[BinkIT] Port=24554 Command=binkit.js
Internal Code BINKIT Start-up Directory Command Line ?binkit.js Enabled Yes Execution Node 1 Execution Months Any Execution Days of Month Any Execution Days of Week All Execution Frequency 288 times a day Requires Exclusive Execution No Force Users Off-line For Event No Native Executable No Use Shell to Execute No Background Execution No Always Run After Init/Re-init Yes
The execution frequency is how often the outbound will be scanned. Inbound is handled by the service.
The following options may be specified on the command-line:
-ppoll any links with the
Poll=Yesoption after running a normal outbound scan.
-Ppoll any links with the
Poll=Yesoption and *do not* run a normal outbound scan.
-l[node] poll the specified node and *do not* run a normal outbound scan. Cannot be used with
-loptions may be specified on the same command-line.
The ctrl/binkit.ini file holds the main configuration for BinkIT.
Capabilitiesif set, changes the text in the M_NUL NDL line from the default of “115200,TCP,BINKP”. This field is not well documented.
Each link should be a section with the full 5D address (ie: “1:103/17@fidonet”) as the section name. If you are using an ftn_domains.ini file, the domain should be listed there.
The following are all optional and allowed per section:
Passwordsets the BinkP password for the link (Usually the only required option)
AllowPlainPasswordallows this link to insecurely send the password on the connection. Defaults to
No. Not recommended
AllowUnencryptedallows this link not to encrypt the session. Defaults to
No. Not recommended
SourceAddressthe outbound FTN address to use for this link. Not normally needed, but can be used if multiple addresses are used in the same net with different passwords. Defaults to the “closest” FTN address to the link address.
PortTCP port to connect to when making an outbound connection on this link. Defaults to the port specified in the nodlist if configured, or the defualt binkp port of 24554.
HostInternet host (IP address or hostname) to connect to when making an outbound connection on this link. If not specified, will first attemt to read from the nodelist if configured in ftn_domains.ini, then will use the domain suffix specified in ftn_domains.ini uses DNS using the “p.f.n.z.domain” style (ie: binkp.net). If there is not ftn_domains.ini, will use binkp.net to look up fidonet addresses.
PollThis link will be polled any time
-Pis specified on the command-line. Defaults to
[1:218/700@fidonet] Password=TopSecret Poll=yes [1:2320/100@fidonet] Host=livewirebbs.com [10:1/1@othernet] Host=coolbbs.example.com Port=24556 Password=MaxSecret Poll=yes OutboundRoot=/sbbs/fido/outbound
In the above example 1:218/700 is be a node you want to poll. If you create a second binkit event and add the -p (small p) option it will scan the outbound directories, send outbound mail and poll nodes that have Poll=yes option set. In this case 1:218/700@fidonet and 10:1/1@othernet will be polled and any new inbound mail will be picked up and outbound mail will be delivered. 1:2320/100@fidonet will not be polled, though if there is pending outbound, it will be sent.
In the case of 1:2320/100 let's say you have a need to route netmail to this node. In this case there is no automated polling to this node and anything that needs to be sent to this node via crash will be sent to livewirebbs.com with no password. If there is a nodelist, the port number will be used from the nodelist. In this example, the hostname is being overridden, so it won't use the nodelist or DNS to connect.
The network “othernet” will also be polled. In this case it will call out on port 24556 and the outbound root has been specified in the config. You can specify a domain wide outbound root in your ftn_domains.ini. It should be noted that othernet should be defined in ftn_domains.ini with either a NodeList or DNSSuffix value since it's not part of the default ftn_domains configuration used when the ftn_doamsin.ini file is not present.
If you check your outbound directory do not be surprised if you see other outbound directories with extensions after them. For instance outbound.zyx… binkit will create additional outbound directories if you use the same outbound as your fidonet.
The first listed FTN address is used as the default address, and it's zone is used as the default zone. All addresses configured in SCFG are used for the M_ADR command to the remote.
ctrl/sbbsecho.cfg or ctrl/sbbsecho.cfg
BinkIT reads the ctrl/sbbsecho.cfg file, possibly using the following pieces of information:
- Outbound path (
OUTBOUNDin sbbsecho.cfg or
Outboundkey in sbbsecho.ini)
- Secure Inbound path (
SECURE_INBOUNDin sbbsecho.cfg or
SecureInboundkey in sbbsecho.ini)
- Insecure Inbound path (
INBOUNDin sbbsecho.cfg or
Inboundkey in sbbsecho.ini)
- Mailer type (
FLO_MAILERin sbbsecho.cfg, or
BinkleyStyleOutboundin sbbsecho.ini). BinkIT will exit with an error if this is not set.
- Packer configuration (
Unpackkeys in a
archive:*section in sbbsecho.ini).
BinkIT integrates util:freqit functionality, so the freqit.ini file is used.
This file is used for 5D support in BinkIT. Each section name is the FTN domain. If this file doesn't exist, zones 1-6 are set to 'fidonet' with a DNSSuffix of 'binkp.net'.
Each domain can have the following keys:
Zonesa comma-separated list of zones present in this domain. When only a single domain lists a specific zone, that domain is used as the “default domain” for that zone.
DNSSuffixused for DNS nodelist lookups. If this file doesn't exist,
binkp.netfor the fidonet domain.
OutboundRootthe root path for this domain, used for constructing outbound directories for this domain.
NodeListFull path to a nodelist file to use for this domain.
[fidonet] Zones=1,2,3,4,5,6 OutboundRoot=/sbbs/fido/outbound/ NodeList=/sbbs/fido/nodelist/nodelist.123 [othernet] Zones=10 NodeList=/sbbs/fido/OTHERNET.234