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.
ftn2rfc
Usage:
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
.
pktdebug
Usage:
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.