4. FIDOGATE Config Files

FIDOGATE uses the following config files:

4.1 Main Configuration File		Main configuration file
4.2 hosts FTN Address to Host Name Conversion		hosts FTN address to host name conversion
4.3 aliases User Aliases		aliases user aliases
4.4 areas FTN Area to Newsgroup Conversion		areas FTN area to newsgroup conversion
4.5 Bounce Messages of ftn2rfc		Bounce messages of ftn2rfc
4.6 passwd Password Config File		passwd password config file
4.7 routing Config File		routing file for ftntoss and ftnroute
4.8 packing Config File		packing file for ftnpack
4.9 areas.bbs EchoMail Distribution		areas.bbs EchoMail distribution

For all config files, a line starting with (some white space and) # character is a comment and as well as an empty line completely ignored.

All config files (with the execption of areas.bbs support an include command for reading in other config files. include must be the first keyword on the line, the filename is the next argument.

All options and config statements which take file or directory names as arguments accept the following % abbreviations:

%C

CONFIGDIR

%L

LIBDIR

%N

BINDIR

%G

LOGDIR

%V

VARDIR

%K

LOCKDIR

%S

SPOOLDIR

%B

BTBASEDIR

%I

INBOUND

%P

PINBOUND

%U

UUINBOUND

4.1 Main Configuration File

fidogate.conf is the main configuration file for all FIDOGATE programs.

NOTE: the new single configuration file replaces the different configuration files config.* and *.conf of versions prior to 4.3.0.

The format of fidogate.conf is:

keyword [ arg ... ]

Keywords and arguments may be quoted in "", keywords are case-insensitive.

See examples/orodruin/fidogate.conf for an up-to-date commented version of the new config file.

Common configuration:

include file

Include another config file, may be nested.

ConfigDir directory

Directory for configuration files (default specified in config.make).

LibDir directory

Directory for FIDOGATE-internal binaries and support files (default specified in config.make).

BinDir directory

Directory for FIDOGATE user binaries and scripts (default specified in config.make).

LogDir directory

Directory for log files (default specified in config.make).

VarDir directory

Directory for variable state files such as areas.bbs, fareas.bbs, history (default specified in config.make).

LockDir directory

Directory for lock files (default specified in config.make).

SpoolDir directory

Internal spool directory for temporary files (default specified in config.make).

BTBaseDir directory

The BinkleyTerm-style outbound base directory, to be specified without the actual out.nnn zone directories (default specified in config.make).

Inbound directory

The BinkleyTerm-style unprotected inbound directory (default specified in config.make).

PInbound directory

The BinkleyTerm-style protected inbound directory (default specified in config.make).

UUInbound directory

The BinkleyTerm-style inbound directory for UUENCODEd packets (default specified in config.make).

FTPInbound directory

The BinkleyTerm-style inbound directory for FTP'ed packets (default specified in config.make).

Aliases file

Aliases configuration file (default specified in config.make).

Areas file

Areas configuration file (default specified in config.make).

Hosts file

Registered hosts configuration file (default specified in config.make).

Passwd file

Password configuration file (default specified in config.make).

Packing file

Packing configuration file (default specified in config.make).

Routing file

Routing configuration file (default specified in config.make).

History file

Dupe check history database file (default specified in config.make).

Logfile file

Standard log file (default specified in config.make).

CharsetMap file

Charset mapping table file (default specified in config.make).

LogFacility facility

LogLevel level

Facility and level when using syslog for logging (LogFile syslog). NOT YET SUPPORTED: C programs use definition from config.h, syslog support in Perl scripts (which use these settings) is currently commented out.

DosDrive drive directory

OPTIONAL: specify translation of a DOS drive (e.g. H:) to a directory. This is useful, if you keep your outbound on a UNIX server and run BinkleyTerm on a DOS client. If one or more DosDrive statements are specified, FIDOGATE will automatically translate file attaches to the file names seen by the DOS client. Up to 16 DosDrive entries may be specified (MAXDOSDRIVE from config.h).

AreasBBS name

Specifies the areas.bbs EchoMail distribution file.

FAreasBBS name

Specifies the fareas.bbs file echo distribution file.

Internet address configuration:

Hostname name

The host name part of your Internet address.

Domain name

The domain part of your Internet address.

HostsDomain name

The domain used for entries in the hosts config file. Default is the same as Domain.

Fidonet address configuration:

Address node

The main Fidonet/FTN address (Z:N/F.P). There may be up to 32 Address statements (MAXADDRESS from config.h).

GateAddress node

OPTIONAL: the Fidonet/FTN address of your gate, must be in the same order as the corresponding Address statements. There may be up to 32 GateAddress statements.

If you're operating a Fido node, you may want to use a point addresse for your gateway to avoid name problems with local users and the gateway. If you're operating an official gateway in Fidonet or an Othernet, you normally have a separate node address for the gateway.

Zone zone domain ftndomain out

Specifies Internet domain domain, FTN domain ftndomain, and outbound directory out (relative to BTBaseDir) for the FTN zone zone. zone may be default, then this is the default entry for not explicitely specified zones. Up to 32 Zone entries may be specified (MAXADDRESS from config.h).

The gateway will only process mails from/to zones which are explicitly specified here.

Areafix configuration:

AreaFixMailer command

Mailer program used by ftnaf to send replies.

AreaFixCC user@domain

CC address added to replies sent by ftnaf.

AreaFixHelp file

Help file for Areafix programs (%help) command.

Tosser configuration:

MaxMsg n

Set maximum number of messages in output files to n, restricting the maximum size of packets. See also -m option.

MaxOpenFiles n

Set maximum number of concurrently open packet files to n. Default: 10 (MAXOPENFILES from config.h), see also -M option.

MaxArc Kbyte

Maximum size of ArcMail archives created by ftnpack. See also -m option.

MinDiskFree Kbyte

Minimum free disk space required by the runtoss script. runtoss will terminate if there is less than Kbyte free disk space in SPOOLDIR.

DiskFreeMethod text

Method to determine free disk space: prog uses program specified with DiskFreeProg, none doesn't do any disk space checking.

DiskFreeProg command

Command to determine free disk space, parameter %p is replace with path name of the directory to be checked.

KillEmpty

KillBlank

Kill empty (blank) messages addressed to one of our AKAs. These are typically file attach and file request messages.

KillUnknown

Kill messages for unknown EchoMail areas (not listed in areas.bbs).

KillRouted

Kill routed EchoMail messages (not addressed to one of our AKAs).

KillInsecure

Kill insecure EchoMail messages (sender not listed in areas.bbs).

LogNetMail

Track

Log all NetMail messages in log file.

CheckPath

Enable EchoMail circular path check (see KillCircular).

KillCircular

Kill EchoMail with circular path (own address already in ^APATH).

DupeCheck

Enable dupe check (using History database).

MaxHistory days

Maximum length of history database. Keep entries for days days (decimal fraction allowed).

KillOld

Kill messages with date < now - MaxHistory, i.e. treat as dupes.

KillDupe

KillDupes

Kill duplicate EchoMail messages if DupeCheck is enabled.

KillNoMSGID

Kill EchoMail messages without a ^AMSGID, i.e. treat as dupes.

ZoneGate node seenby

Zone gate operation: strip SEEN-BYs for EchoMail addressed to node and replace with listed seenby nodes. seenby must include both the link's and our address. Example:

ZoneGate 1:105/42 105/42 2452/110

AddToSeenBy area nodes

Add the listed nodes to the SEEN-BYs for EchoMail tossed in area. area may be specified using shell-style wildcards *?[a-z].

TossEchoMail4D

Generate 4D EchoMail control lines, i.e. SEEN-BY and PATH will include point addresses.

NoEmptyPath

Do not generate an empty PATH line.

Ticker configuration:

TickFlav flavour

Flavour of file attaches generated by ftntick.

FAttachFlav flavour

Flavour of file attaches generated by ftnfattach.

TickReplacedDir directory

Directory for old files replaced by ftntick.

UnknownTickArea area

File area to be used to TIC files with an unknown area. Incoming files with an unknown area will be moved to this unknown area's directory.

Gateway configuration:

Origin text

FTN default EchoMail origin line, the text used for the origins line generated by rfc2ftn. Quote text in "" if it contains spaces. Individual origin lines may be specified in the areas file using the -o option.

Organization text

Organization header for mail and news generated by ftn2rfc. Quote text in "" if it contains spaces.

UseOriginForOrganization

Put the text from the * Origin line (excluding the (z:n/f.p) address) into the Organization header.

UseOrganizationForOrigin

Put the text from the Organization header into the * Origin line.

UseXHeaderForTearline

Use text from X-FTN-Tearline, X-Mailer, User-Agent, or X-Newsreader for the -- tearline.

UseFTNToAddress

Use FTN to address for mail addressed to the gateway without a To line, e.g. mail to

Max Mueller 2:2452/110.2

with a HOSTS entry

2:2452/110.2 orodruin-ftn.fido.de

is converted to

To: Max_Mueller@orodruin-ftn.fido.de

Without this option the standard local HOST.DOMAIN is used, e.g.

To: Max_Mueller@orodruin.fido.de

EchoMail4D

Generate 4D EchoMail control lines, when the gateway operates at a point address. This is required when using the gateway and the tosser for a Fido point!

Gateway node

Specifies an FTN-Internet gateway for routing Internet mail to. If enabled, FIDOGATE can be used as the default delivery agent for all Internet mail.

DotNames

Generate User.Name@host.do.main instead of User_Name@host.do.main. rfc2ftn recognizes both address types.

KillUnknownMSGIDZone

Kill messages that contain a ^AMSGID from an unknown zone (not listed in Zone statements).

KillNoMSGID

Kill messages that don't contain a ^AMSGID kludge.

KillSplit

Kill messages that contain a ^ASPLIT kludge.

X-FTN header

Include the various X-FTN header in the output of ftn2rfc:

f

X-FTN-From

t

X-FTN-To

T

X-FTN-Tearline

O

X-FTN-Origin

V

X-FTN-Via

D

X-FTN-Domain

S

X-FTN-Seen-By

P

X-FTN-Path

X-FTN-From is required for the proper operation of ftnaf.

MaxMsgSize bytes

Maximum size of FTN messages (default value), larger messages will be split.

LimitMsgSize bytes

Maximum limit for messages (default value), larger messages will be bounced (mail) and simply not gated (news).

NoAddressInToField

Do not allow @ ! % chars in the FTN to field, thus preventing users from putting Internet addresses in the to field.

BounceCCMail user@do.main

Send CC of bounced messages to this address.

TrackerMail user@do.main

Forward mail from message trackers to this address.

HostsRestricted

Restrict usage of the gateway to FTN addresses listed in hosts.

FTNJunkGroup name

name of the FTN junk newsgroup (newsgroup for unknown FTN areas).

ErrorsTo user@do.main

Insert additional Errors-To header into Internet mails, sending bounced mails from gateway users to user@do.main.

AreasXlate area-chars newsgroup-chars

Automatic translation (-H option in areas file) of characters for Fido area <-> Internet newsgroup name conversion.

RFCLevel n

Set the default RFC level. See also -R option in areas.

NoFromLine

Don't generate From: header and FSC-0035 kludges. Must be set for a non-gateway, point FIDOGATE configuration.

NoFSC0035

Don't generate FSC-0035 ^AREPLYADDR, ^AREPLYTO.

NoFSC0047

Don't generate FSC-0047 ^ASPLIT, use old * Large message split by ... text line.

FTNInSendmail command ...

Sendmail program to be run by ftninpost with options. The option -fsender will be automatically added by ftninpost. For compatibility with old FIDOGATE configurations, any -f%s option will be removed.

FTNInRnews command ...

Rnews program to be run by ftninpost.

FTNInRecombine

Automatically run ftninrecomb to recombine split messages.

NetMail8bit

Use the ISO-8859-1 MIME 8BIT character set when gating Fido NetMail.

NetMailQuotedPrintable

NetMailQP

Use the ISO-8859-1 MIME QUOTED-PRINTABLE character set when gating Fido NetMail. NetMailQuotedPrintable overrides NetMail8bit if both are specified.

XFlagsPolicy

Controls policy for X-Flags processing (default is 0, no processing):

n N 0

No X-Flags processing at all.

s S 1

X-Flags processing for local sender (check From and Received headers). This is not really secure!!! If your system is directly connected to the Internet and runs an SMTP daemon such as sendmail, mail can easily be faked to look like local!!!

a A 2

X-Flags processing for all. Totally open, totally insecure!!!

DontUseReplyTo

Don't try to get real name from Reply-To header. Particularly useful for mailing lists which set the Reply-To header to the mailing list.

RFCAddrMode mode

Mode for RFC address generated by FIDOGATE:

() p 0

user@do.main (Real Name)-type addresses

<> a 1

Real Name <user@do.main>-type addresses

ReplyAddrIfMailTX

Force ^AREPLYADDR (if FSC0035 is enabled) to only contains ^AREPLYADDR <user@do.main> for compatibility with ifmail-TX.

CheckAreasBBS

Check areas.bbs when gating newsgroups, message for areas without downlinks will be skipped.

DefaultCharset default:ftn:rfc

Default character set mapping for the gateway: default is the charset assumed for FTN messages, if no ^ACHRS kludge is present in the message. ftn is the charset to be used in the FTN messages when gating from RFC to FTN (use FSC-0054 names here), rfc likewise when gating from FTN to RFC (use RFC 2045 names here). See also the -C option in the areas config file.

NetMailCharset default:ftn:rfc

Like DefaultCharset, but only for NetMail (mail) messages.

NetMailCharsetUse1st

If set and no matching in/out character set is found, ftn2rfc will use the first character set translation pair from charset.map with in charset = Fido ^ACHRS and set the output character set accordingly. NOT YET IMPLEMENTED.

NewsPathTail string

String added to news Path header generated by ftn2rfc, the de-facto standard is not-for-mail. Alternatively you can set this to fidogate!not-for-mail making the INN newsfeeds much easier and less error-prone, particularly for point systems.

SingleArticles

Write single articles to output RFC files generated by ftn2rfc, not news batches containing several articles (batch is default).

Regex1stLine pattern

Regular expression patterns for finding addresses in the first line of the messages body. The first (...) sub-expression will be used for the address (like \1 in sed, $1 in perl). POSIX *extended* regular expressions are used. The OS must support HAS_POSIX_REGEX in config.h!

As of FIDOGATE 4.3.4, the compiled-in pattern matching code is no longer availabe. See examples/orodruin/fidogate.conf for a suitable list of regular expressions.

MessageLineLength number

Line length for formatting long paragraphs (no explicit line break) from Fido messages. This replaces the old MAX_LINELEN from config.h. The default value is 72.

DontIgnore0x8d

DontIgnoreSoftCR

Normally, soft CR characters (hex 0x8d) in FTN messages are ignored. When this option is turned on, they are treated as normal characters. Useful e.g. for the cyrillic cp866 charset.

RegisteredHostsOnly

The opposite of the -i --ignore-hosts command line option, always requiring that a node is registered in the hosts list. NOT YET IMPLEMENTED.

RegisteredAliasesOnly

Allow only those addresses listed in aliases, either alias@host.do.main or Full_Name@host.do.main, as valid recipients (also including postmaster) for rfc2ftn.

With this option, the gateway can be restricted to registered users, which is also very useful for fighting Spam.

SilentBounces

Causes EX_NOHOST, EX_NOUSER errors to return OK without any message. Useful in the never ending fight against spam, when your gateway is flooded with messages to unknown adresses, such as Fido.DE :-(

FFX configuration:

(FFX is a part of FIDOGATE, an uux-like mechanism for remote execution, using a Fido mailer instead of UUCP for transport. This is a special hack for my own purposes, most likely you don't want to know anything about it. Simply ignore or remove this section from the config file.)

FFXDataFlav flavour

Flavour to be used for file attachments created by the ffx program.

FFXDataCompr command ...

Program to be used for creating compressed ffx data files.

FFXDataExt parameter

File name extension to be used for compressed ffx data files.

FFXDataDecompr parameter

Uncompressor name for compressed ffx data files (will be run by ffxqt).

FFXDataComprN parameter

Program to be used for creating uncompress ffx data files (option -n).

FFXDataExtN parameter

File name extension to be used for uncompressed ffx data files (option -n).

FFXDataDecomprN parameter

Uncompressor name for uncompressed ffx data files (option -n, will be run by ffxqt).

FFXCommand name command ...

List of command names and corresponding commands to be used by ffxqt. Only the commands listed can be executed. This replaces the old LIBDIR/ffxqt-dir/name structure of previous FIDOGATE versions.

FFXUncompress name command ...

List of uncompressor names and corresponding commands to be used by ffxqt.

4.2 hosts FTN Address to Host Name Conversion

This file contains the FTN addresses and host names for registered FTN nodes. If HostsRestricted is defined in config.gate, this file controls the access to the gateway.

The format of this file is

node hostname [ options ]

Fields:

node

FTN address. An address for a node will match all points of this node, see example below.

hostname

Host name, one of

local host name

A name without a trailing . is a hostname in the local domain (specified by HostsDomain or default Domain in config).

fully qualified domain name

A name with a trailing . is a fully qualified domain name for this node.

-

A - specifies a listed node, but without a host name translation, using the standard p.f.n.z address.

options

-p

Generate addresses with point part, e.g. p99.hippo.fido.de. Default is omitting the point part.

-d

Mark the node as down, mail to this address will be bounced with an appropiate error message.

The hosts file is read into memory during startup of FIDOGATE. The first entry found matches, so a host name for a point must be specified before the boss node, if there are entries for both.

Example:

config:

HostsDomain .Fido.DE

hosts:

2:2452/110 hippo 2:2452/990 test -p 2:2452/991 test.wusel.org. 2:2452/999 -

Resulting data base read into memory:

Node: 2:2452/110.0 Hostname: hippo.Fido.DE Flags: Node: 2:2452/990.0 Hostname: test.Fido.DE Flags: POINT Node: 2:2452/991.0 Hostname: test.wusel.org Flags: Node: 2:2452/999.0 Hostname: Flags:

This results in the following conversion of addresses from FTN to Internet:

2:2452/110 -> hippo.Fido.DE 2:2452/110.99 -> hippo.Fido.DE 2:2452/990.99 -> p99.test.Fido.DE 2:2452/991.1 -> test.wusel.org 2:2452/999.2 -> p2.f999.n2452.z2.Fido.DE

4.3 aliases User Aliases

This file contains user aliases, the FTN address, and the full name of the user.

The format of this file is

alias node "full name"

Fields:

alias

Alias for the user, can be a local user or a complete Internet address user@do.main.

node

FTN address of the user.

full name

Full name of the user.

The FTN address node may be a point address. In this case mail addressed to the user at the boss node address will be readdressed to this point, see example below.

Example:

aliases:

mvr 2:2452/110.6 "Marc van.Rey"

Using the definitions from the section on hosts, this results in the following address conversion:

Marc van.Rey @ 2:2452/110.6 <-> mvr@hippo.Fido.DE

4.4 areas FTN Area to Newsgroup Conversion

This file contains FTN areas with corresponding newsgroups and options.

The format of this file is

area newsgroup [ options ]

Fields:

area

FTN area.

newsgroup

Usenet newsgroup.

options

IMPORTANT: there must be spaces between the option and its argument!

-a address

Select alternate FTN address for this area/newsgroup.

-z zone

Select zone AKA zone for this area/newsgroup.

-d distribution

Use Usenet distribution for this newsgroup when gating from FTN to Internet.

-o "origin"

Use an alternate origin line for this area when gating from Internet to FTN. (Default specified in config.)

-g

Don't send messages from another SomeNet-FTN gateway across the gateway.

-l

Only local crosspostings are allowed in this newsgroup/area.

-x

No crosspostings are allowed in this newsgroup/area.

-8

Use the ISO-8859-1 MIME 8BIT character set when gating to this newsgroup.

-Q

Use the ISO-8859-1 MIME quoted-printable character set when gating to this newsgroup.

-H

Area/newsgroup matches entire hierarchy. Names are converted automatically, using upper case for area names and lower case for newsgroups.

Example:

GNU. gnu. -z 242 -H

gnu.announce will be converted to GNU.ANNOUNCE, gnu.bug.gcc to GNU.BUG.GCC, similar for all other.

-!

Don't gate this area/newsgroup or hierarchy (if combined with -H). Usefull to exclude certain newsgroups from a hierarchy for gating.

Example:

ALT.BINARIES. alt.binaries. -z 242 -H -! ALT. alt. -z 242 -H

This is roughly equivalent to INN's alt.*,!alt.binaries.*. Please note that the first areas entry matches, so any -! must be placed before the -H hierarchy definition.

-R level

Select level of ^ARFC-Header put into FIDO messages for this area. Level:

0

No ^ARFC-header at all.

1

Only important ^ARFC-header.

2

All ^ARFC-header.

-m bytes

Sets MaxMsgSize for this area (0 = no limit).

-M bytes

Sets LimitMsgSize for this area (0 = no limit).

-X "RFC-Header: text"

Add extra RFC header to output of ftn2rfc. Multiple -X options are possible.

-C default:ftn:rfc

Set character set mapping table for this area, see DefaultCharset config option for details.

Only newsgroups listed in this file will be gated from Internet to FTN. FTN area not listed in this file will be gated into the FTNJunkGroup newsgroup specified in fidogate.conf.

4.5 Bounce Messages of ftn2rfc

ftn2rfc uses the following files for messages sent to the FTN user when bouncing mail for some reason:

bounce.noto

Message addressed to user UUCP or GATEWAY without a To line at the very beginning of the message.

bounce.down

Message addressed from/to node currently marked as down in hosts (-d flag).

bounce.restricted

Messages from nodes not listed in hosts, gateway running in restricted mode.

bounce.insecure

Messages came via an insecure (i.e. not password protected) link and contain a To line. This requires the -t option to ftn2rfc.

Within a bounce message, the following substitutions can be used:

%F

FTN address of message sender.

%T

FTN address of message recipient (the gateway, that is).

%O

FTN address of message origin.

%d

Date/time of message.

%t

Name of message recipient.

%f

Name of message sender.

%s

Message subject.

%R

To line, Internet address.

%M

The entire message body.

4.6 passwd Password Config File

This file contains passwords used by ftnaf, ffx, and the tosser programs.

The format of this file is:

context node password options

Contexts:

packet

FTN packet passwords, checked by ftntoss, inserted by all FIDOGATE programs which create FTN packets. Password checking for incoming packets is NOT YET IMPLEMENTED.

af

Areafix passwords for requests.

ff

Filefix passwords for requests and password for sending/receiving TIC files.

ffx

ffx command passwords, checked by ffxqt, inserted by ffx into the .ffx command files.

uplink

Passwords for forwarding areafix/filefix request to uplink.

Optional stuff (options) is used for af and ff permission settings:

lvl key "Sysop Name"

lvl is the access level, which must be greater or equal than the one in areas.bbs. key is the access key, which must be a super set of the one in areas.bbs.

Optional stuff (options) is used for uplink:

"name"

name is the user name (normally Areafix or Areamgr) at node address, where areafix requests must be forwarded to. Used by ftnafutil.

Example:

uplink 2:2499/99 XXXXXXXX AreaMgr packet 2:1234/5678 WUERG ffx 242:1111/99 BLAHBLUB af 2:1234/5678 WUSEL 1 F "Test Sysop" ff 242:1234/5678 WUSEL 4 UQ "Yet Another Sysop"

4.7 routing Config File

This file contains the routing commands performed by ftntoss (commands remap and rewrite) and ftnroute (everything else). The first routing command found matches.

The syntax of the routing commands is very similar to the routing file used by the well-known FIDO tossers QMail and SQUISH.

The format of this file is:

remap src-node dest-node name remapto src-node dest-node name remapx src-node prog name remapfrom src-node dest-node name rewrite src-node dest-node echomail netmail send flavor nodes route flavor dest-node nodes hostroute flavor nodes hubroute flavor nodes xroute flavor dest-node from-node to-node bossroute flavor nodes change old-flavor new-flavor nodes sendmove flavor nodes

Commands:

remap

remapto

Remaps NetMail addressed to name at src-node to the new address dest-node. Most useful for remapping to points based on their name. name supports shell-style wildcard patterns. Remapping to 0:0/0.0 means killing the message.

remapx

Remaps NetMail addressed to name at src-node to special processing with prog (actually writing it to a packet in %S/remapx/prog. Most useful for processing areafix messages. name supports shell-style wildcard patterns. NOT YET IMPLEMENTED.

remapfrom

Remaps NetMail from name at src-node to the new address dest-node. name supports shell-style wildcard patterns. Remapping to 0:0/0.0 means killing the message.

rewrite

Rewrites NetMail from and to addresses. A node address matching src-node will be changed to dest-node.

echomail

Starts routing commands for EchoMail.

netmail

Starts routing commands for NetMail.

allmail

Starts routing commands for both EchoMail and NetMail. NOT YET IMPLEMENTED.

send

Send normal mail addressed to nodes with flavor.

WARNING: e.g. send hold 2:2452/110 actually is the same as route hold 2:2452/110.0 2452/110.*. So send hold 2:2452/110 110.* will not have the desired effect, use send hold 2:2452/110.* only instead!!!

route

Route normal mail addressed to nodes via dest-node, using flavor.

hostroute

Route normal mail addressed to nodes via their host (i.e. Z:N/0), using flavor.

hubroute

Route normal mail addressed to nodes via their hub, using flavor. NOT YET IMPLEMENTED.

xroute

Route normal mail from from-node to to-node via dest-node, using flavor. NOT YET IMPLEMENTED.

bossroute

Route flavor mail addressed to nodes via their boss node, not changing the flavor.

change

Change flavor of mail packet from old-flavor to new-flavor.

sendmove

Like send, but ftnroute doesn't copy the mail packets, they are moved instead. This requires that SPOOLDIR/toss/tmp and SPOOLDIR/toss/out are on the same file system/disk drive.

Node addresses nodes, src-node, dest-node support wildcards using * and all, which can be used for the zone, net, node, and point component of an address. * alone matches all addresses. rewrite wildcards in the destination address are replaced with the corresponding component of the source address.

The outbound flavor string flavor can be any of normal, hold, crash, direct, out, hut, cut, dut.

Example:

Remap 2:2452/110.0 2:2452/110.7 "Martin Koser" Rewrite 242:241/* 2:241/* NetMail send hold 242:1000/1.all change crash hold 242:1000/1.all 2.all send hold 242:1000/3 route hold 242:1000/50 51 52 53 54 55 56 57 58 59

4.8 packing Config File

This file contains the packer (archiver) definitions and packing commands for ftnpack.

The format of this file is:

arc name "archiver" prog name "program" progn name "program" pack name nodes rpack name dest-node nodes fpack name dest-node nodes dirpack dir name nodes

Packer/program definitions:

arc

Defines the archiver name as program archiver. The archiver string must contain two %s, the first one is replaced with the archive name, the second one with the packet name.

prog

progn

Defines the program name as program. The program string must contain a %s, which is replaced with the name of the packet to be processed. prog deletes the packet after successfully running program, progn doesn't.

Packing definitions:

pack

Pack all mail addressed to nodes using the archiver defined as name. The archiver name noarc indicates that the mail packet should not be packed, but copied to the OUT file of the node.

rpack

Same as pack, but pack all mail addressed to nodes to the archive for dest-node.

fpack

Similar to rpack, but the packet is archived for the normal arcmail packet for each node. This archive is then attached to the FLO file of dest-node.

dirpack

Archive packets for nodes in special directory dir, not the standard outbound.

Example:

arc zip "/usr/local/bin/zip -gkj %s %s" progn gate "/usr/lib/fidogate/ftn2rfc %s" progn areafix "/usr/lib/fidogate/ftnafpkt %s" rpack zip 2:242/41 2:242/42 242:2000/* 254:*/* pack noarc 2:2452/110.1 242:4900/99 254:2410/6.1 pack zip *

4.9 areas.bbs EchoMail Distribution

This file contains the EchoMail areas and linked nodes. The file fareas.bbs is used for file echos.

The format of this file is as follows, the first line being ignored for compatibility with the standard DOS AREAS.BBS. Individual fields can be enclosed in "..." to allow spaces, in particular for the area description.

[#]directory area [options] nodes

#

Marks area as pass-through, i.e. no packets for the own address (zone AKA or set by -a) will be created.

directory

The directory where the message base/file base for this area is located. Currently FIDOGATE uses the directory for file areas only.

area

The area name.

options

Options for this area:

-a address

Set alternate FTN AKA for this area.

-z zone

Set alternate zone AKA for this area. If not set, the zone information is taken from the first node in the nodes list. ftnaf will automatically rewrite areas.bbs, inserting the -z option.

-l lvl

Set Areafix/Filefix access level for this area.

-k key

Set Areafix/Filefix access key for this area.

-d "description"

Description for this area. Enclose in "..." to allow spaces in description text.

-#

Set pass-through flag for this area (same as directory starting with #).

-r

Set read-only flag for this area. New downlink will have a read-only status. NOT YET IMPLEMENTED.

nodes

The list of downlink nodes. This is a sorted short list of nodes as in FIDO EchoMail SEEN-BYs and PATH. The first node in nodes is the uplink and stays at this place, though. Do not put your own main address into the nodes list. (If the gateway has a different address, then it must be included in nodes!)