ftnaf
ftnafmail
ftnafpkt
ftnafutil
charsetc
ffx
ffxmail
ffx frontend for sending mail
ffxnews
ffx frontend for sending news
ffxqt
ffx requests
ffxrmail
rmail command for ffxqt
runffx
send-ffx
ftn2rfc
ftnin
ftn2rfc
ftninpost
ftnin post-processing script
ftninrecomb
ftnin recombining script
ftnmail
rfc2ftn setuid frontend
rfc2ftn
rungate
send-fidogate
ftnhatch
ftntick
ftn2ftn
ftnexpire
ftnpack
ftnroute
ftntoss
runin
runmail
runnews
runout
runtoss
rununpack
ftnbsy
ftnconfig
ftnfattach
ftnflo
ftnlock
ftnlog
ftnoutpkt
ftnseq
pktdebug
pktmore
pktdebug
sumcrc
ffx frontend for sending mail
ffx frontend for sending news
ffx requests
rmail command for ffxqt
ftn2rfc
ftnin post-processing script
ftnin recombining script
rfc2ftn setuid frontend
ftntick post-processing script
Tosser programs and scripts:
pktdebug
Almost all FIDOGATE programs support the following standard options, which therefore aren't listed in the sections describing the individual programs:
-v --verbose
-h --help
-c --config name
"" means none. name may
start with %X/, see below.
-a --addr Z:N/F.P
-u --uplink-addr Z:N/F.P
The option -a and -u also support Internet-style FTN
addresses, e.g. p10.f110.n2452.z2. If any of these options is
specified, all addresses from the config file are disabled.
All options and config statements which take file or directory names
accept the following % abbreviations:
%C
%L
%N
%G
%V
%K
%S
%B
%I
%P
%U
Usage:
ftnaf [-options] [Z:N/F.P command ]
Options:
-m --mail
-r --no-reply
-n --no-rewrite
-b --areas-bbs NAME
-F --filefix
Commands:
listall
list
query
unlinked
from Z:N/F.P PASSWORD
passwd Z:N/F.P PASSWORD
password Z:N/F.P PASSWORD
+AREA
AREA
subscribe AREA
sub AREA
-AREA
unsubscribe AREA
unsub AREA
vacation AREA
&AREA [-options ]
new AREA [-options ]
create AREA [-options ]
&
key in their passwd entry. Allowed areas.bbs options:
-#, -p, -r, -l lvl, -k key,
-d desc, and -z zone.
~AREA
delete AREA
~
key in their passwd entry.
comment text
help
All command keywords may be prefixed by %. ftnaf also
recognizes the -q (= query) and -l (= list) options
following the password in the subject header.
For proper operation ftnaf requires the X-FTN-From header
generated by ftn2rfc, thus the X-FTN configuration must
include the f flag.
Usage:
ftnafmail [-options]
Options:
-F --filefix
ftnaf as Filefix program.
This is the setuid mail frontend for ftnaf to be run from the
sendmail aliases. DO NOT use ftnaf directly, as this will result
in security problems.
# Areafix/Filefix - FIDOGATE ftnaf areafix: "|/usr/lib/fidogate/ftnafmail" areamgr: areafix filefix: "|/usr/lib/fidogate/ftnafmail -F" filemgr: filefix
Usage:
ftnafpkt [-options] [packet ... ]
Options:
-I --in-dir name
-O --out-dir name
-l --lock-file
-r --no-reply
-n --no-rewrite
-b --areas-bbs NAME
-F --filefix
This is the packet processor frontend for the FIDOGATE Areafix, which
doesn't require the Unix mail system for Areafix operation. The best way
to use ftnafpkt is via the tosser.
routing example:
Remap 2:2499/999.* 2:2499/999.101 "Area*" # ^^^^^^^^^^^^ ^^^^^^^^^^^^^^ # node addr pseudo point # for Areafix NetMail Send hold 2:2499/999.*
packing example:
progn areafix "/usr/lib/fidogate/ftnafpkt %s" pack areaifx 2:2499/999.101
runout must be run regularly to process messages generated by
ftnafpkt.
Usage:
ftnafutil [-options] [command ... ]
Options:
-n --no-rewrite
-b --areas-bbs NAME
-F --filefix
-O --out-dir name
Commands:
delete
areas.bbs (no uplink and no downlinks).
subscribe
-s S/U option in areas.bbs).
unsubscribe
-s S/U option in areas.bbs).
Auto-subscribe/unsubscribe will only be used for areas marked with the
state option. State -s U means that the area is not currently
subscribed at the uplink, -s S means that the are is subscribed
at the uplink.
Usage:
charsetc [-options] charset.map charset.bin
Usage:
ffx [-options] Z:N/F.P command
Options:
-b --batch-dir dir
-n.
-B --binkley name
-F --flavor flavor
Hold, Normal,
Direct, or Crash.
-g --grade grade
-n --nocompression
Usage:
ffxmail Z:N/F.P address ...
No options.
ffxmail calls ffx in batch mode (-b), selecting the
batch directory for the node address. Modify the script
(src/ffx/ffxmail.sh) for other addresses/batch directories.
Usage:
ffxnews Z:N/F.P
No options.
ffxnews calls ffx in batch mode (-b), selecting the
batch directory for the node address. Modify the script
(src/ffx/ffxnews.sh) for other addresses/batch directories.
Usage:
ffxqt [-options]
Options:
-g --grade grade
-I --inbound name
f???????.ffx control files
are read from. Default: PINBOUND
-t --insecure
Usage:
ffxrmail address ...
Perl script to be called by ffxqt for rmail commands to
receive Internet mail. This replaces /bin/rmail (UUCP), calling
/usr/lib/sendmail directly with appropiate options.
Usage:
runffx
Usage:
ffxqt [hostname]
Processes INN news batch file
/var/spool/news/out.going/hostname.
Usage:
ftn2rfc [-options] [packet ... ]
Options:
-1 --single-articles
tmpnews), not news
batches containing several articles (batch is default).
-I --inbound-dir NAME
-i --ignore-hosts
hosts)
-l --lock-file
-n --no-remove
-t --insecure
-x --exec-program SCRIPT
%L/ftninpost.
ftn2rfc reads packet files from the input directory or the
command line and converts the FTN packets to Internet RFC mail and news,
written as mail and news RFC message files to the directories
SPOOLDIR/outrfc/mail and SPOOLDIR/outrfc/news, respectively.
ftn2rfcUsage:
ftnin [-options]
Options:
-n --no-toss
ftn2rfc for processing.
-x --exec-program SCRIPT
ftn2rfc processing, typically
%L/ftninpost.
All standard options are passed to the called ftn2rfc.
ftnin looks for mail packets addressed to the gateway addresses
(all Address/GateAddress statements in
fidogate.conf) and calls ftn2rfc for each packet.
ftnin Post-processing ScriptUsage:
ftninpost [-options]
This script is run by ftn2rfc or ftnin, feeding the output
in SPOOLDIR/outrfc/mail and SPOOLDIR/outrfc/news to sendmail and
rnews, respectively.
ftnin Recombining ScriptUsage:
ftninrecomb [-options]
If FTNInRecombine is enabled in fidogate.conf, this script
wil be run by ftninpost to recombine split messages. NOT TESTED
FOR RELEASE 4.3!!!
rfc2ftn Setuid FrontendUsage:
ftnmail [-options] [address ...]
Setuid frontend for rfc2ftn, passes the options
-a --addr ADDR
rfc2ftn as -a ADDR -u ADDR.
-i --ignore-hosts
rfc2ftn as -i.
-O --out-dir DIR
rfc2ftn as -O %S/DIR.
ftnmail should be used for sendmail mailers. DO NOT use
rfc2ftn directly to avoid security problems.
Usage:
rfc2ftn [-options] [address ...]
Options:
-b --news-batch
-n).
-B --binkley name
-i --ignore-registration
HostsRestricted in fidogate.conf is enabled).
-m --max-msg n
-n --news-mode
-o --out-packet-file name
-O --out-packet-dir name
-t --to
-w --write-outbound flav
-W --write-crash
Usage:
rungate
Usage:
send-fidogate [hostname]
Processes INN news batch file
/var/spool/news/out.going/hostname. If hostname is
omitted the default fidogate is used.
Usage:
ftnhatch [-options] area file "description"
Options:
-b --fareas-bbs NAME
Please note that the file must already reside in the directory for the file area. Copying and hatching a new file to a file area is not yet implemented.
Usage:
ftntick [-options]
Options:
-b --fareas-bbs file
-I --inbound dir
-t --insecure
-x --exec script
Usage:
ftntickpost [-options] file.tic
Options:
NOT YET COMPLETELY IMPLEMENTED! Currently the script is only a skeleton with features such as announcement postings and mails to be added in the future.
Usage:
ftn2ftn [-options] [packet ... ]
Options:
-A --address-a Z:N/F.P
-B --address-b Z:N/F.P
-o --out-packet-file NAME
-O --out-packet-dir NAME
This program provides a NetMail gateway between different FTNs, using the (somewhat) standard "User Name%Z:N/F.P" addressing in the FTN from and to fields.
If no packet is given on the command line, ftn2ftn looks for
packets addressed to the gateway addresses (A and B) in the Binkley
outbound. Both gateway addresses must be specified with the -A and
-B options.
If a packet name is passed on the command line, ftn2ftn will
gate this to the other network A. The gateway address (sender of the mails
in network A) is set with -A option.
Usage:
ftnexpire [-options]
Options:
-m --maxhistory days
-w --wait
This utility expires and rebuilds the MSGID history database, similar to expire for the INN news system.
If the MSGID history database dupe check is used, ftnexpire must
be run regularly to keep the history database optimized (if not,
accessing the history database will become very slow!). A daily cron
job is just the right thing.
Usage:
ftnpack [-options] [packet ... ]
Options:
-B --binkley dir
-f --ffx Z:N/F.P
-I option.
-F --file-dir dir
ftnpack looks for file attachments. Should
be the appropiate inbound directory, see also the runtoss
script. If this option is not specified, no file attachments are
processed.
If -F / is specified, ftnpack accepts a complete path name
in the subject and doesn't search the directory. Warning: this option
compromises security to some degree, because it allows any user to
send any file readable by the user id running the tosser and
mailer!!!
-g --grade grade
-I --in-dir dir
-O --out-dir dir
-l --lock-file
-m --maxarc size
ftnpack creates a new one.
-p --packing-file name
packing config file. Default: %C/packing
-P --pkt
ftnroute.
Usage:
ftnroute [-options] [packet ... ]
Options:
-g --grade grade
-I --in-dir name
-O --out-dir name
-l --lock-file
-r --routing-file name
routing config file. Default: %C/routing
-M --maxopen n
MaxOpenFiles config
Usage:
ftntoss [-options] [packet ... ]
Options:
-d --no-dupecheck
DupeCheck is enabled in
config.main).
-g --grade grade
-I --in-dir name
-O --out-dir name
-l --lock-file
-t --insecure
-n --toss-all
-p --passthru
# in areas.bbs).
-r --routing-file name
routing config file. Default: %C/routing
-s --strip-attribute
-m --maxmsg n
-x --maxmsg-exit n
-M --maxopen n
MaxOpenFiles config
-b --fareas-bbs file
Usage:
runin
No options.
Runs the tosser (unpack, toss, tick) for the inbound directories:
All log messages are written to %G/log-in.
Edit the script src/toss/runin.sh to meet your local
requirements.
Usage:
runmail
No options.
Runs the tosser for the gateway mail output directory %S/outpkt/mail, all log messages are written to %G/log-out.
Edit the script src/toss/runmail.sh to meet your local
requirements.
Usage:
runnews
No options.
Runs the tosser for the gateway news output directory %S/outpkt/news, all log messages are written to %G/log-out.
Edit the script src/toss/runout.sh to meet your local
requirements.
Usage:
runout
No options.
Runs the tosser for the miscellaneous (ftnafpkt, ftnafutil, ftnoutpkt) output directory %S/outpkt, all log messages are written to %G/log-out.
Edit the script src/toss/runout.sh to meet your local
requirements.
Usage:
runtoss type
No options.
Types:
Please the the script source code src/toss/runtoss.sh for
available type parameters and feel free to adapt it to your
requirements.
Usage:
rununpack type
No options.
Types:
Please see the script source code src/toss/rununpack.sh for
available type parameters and feel free to adapt it to your
requirements.
Edit the script if necessary to change unpacker program names. The
required programs are unzip, unarj, lha,
zoo, arc, rar.
Usage:
ftnbsy [-options] Z:N/F.P ...
Options:
-t --test
-l --lock
-u --unlock
-w --wait
-l option is given).
Usage:
ftnconfig [-options] parameter
Options:
-l --no-newline
-n --no-output
-t --test-only
1 if the parameter is present, 0 if not.
Special parameters:
=fqdn
=hostname
=domainname
=hostsdomain
hosts config files.
Usage:
ftnfattach [-options] Z:N/F.P file ...
Options:
-B --binkley name
-F --flavor name
Hold,
Normal, Direct, or Crash.
The file name may start with ^ or #, indicating that
the file should be deleted or truncated, respectively, after sending.
Usage:
ftnflo [-options] Z:N/F.P ...
Options:
-B --binkley name
-l --list
-n --no-delete
-x --exec command
%s in command is replaced with the filename of
the FLO entry.
The file name may start with ^ or #, indicating that
the file should be deleted or truncated, respectively, after sending.
Usage:
ftnlock [-options] [NAME] [ID]
Options:
-l --lock
ftnlock is used. The
optional parameter ID specifies the contents of the lock file, the
default is -none-.
-u --unlock
-w --wait
Lock files are created as %K/NAME.
Usage:
ftnlog [-options] message text
Options:
-p --program NAME
This program is used to write a log message from a shell script. The log
file name may be specified with the FIDOGATE_LOGFILE environment
variable.
Usage:
ftnoutpkt [-options] "user name @ z:n/f.p" "..."
Options:
-f --from "user name @ z:n/f.p"
-s --subject "subject"
-O --out-dir dir
This utility can be used to create native Fido messages. The message body text is read from stdin.
Usage:
ftnseq [-options] sequencer
This utilitity increments the named sequencer file and prints the resulting value to stdout. Useful for accessing FIDOGATE sequencer files from perl and shell scripts.
Usage:
pktdebug [-options] file ...
Options (standard options not supported):
-m --msg-header
-t --msg-text
-m.
-s --short
-v --verbose
-h --help
pktdebug usage.
This utility displays the packet header and optionally the message header and message body contents.
See also the util/pktmore utitility, which pipes the output of
pktdebug to $PAGER.
pktdebugUsage:
pktmore file ...
pktmore uses the environment variable PAGER for the pager
program. Default: more
Usage:
sumcrc [-options] file ...
Options (standard options not supported):
-1 --skip-first-line
-3 --crc32
-6 --crc16
-x --hex
-z --eof-at-ctrl-z
^Z) indicates end-of-file (MSDOS kludge).
-v --verbose
-h --help
sumcrc usage.
Use sumcrc -1z to compute the checksum for a standard Fido
nodelist. See also the nodelist processing scripts in
scripts/nodelist/nl-*.
Go to the first, previous, next, last section, table of contents.