1Dies ist fidogate.info, hergestellt von Makeinfo Version 4.7 aus 2fidogate.texi. 3 4 This file documents the installation and usage of FIDOGATE version 54.4 6 7 Copyright (C) 1994-2000, Martin Junius 8 9 Permission is granted to make and distribute verbatim copies of this 10manual provided the copyright notice and this permission notice are 11preserved on all copies. 12 13 Permission is granted to copy and distribute modified versions of 14this manual under the conditions for verbatim copying, provided that the 15entire resulting derived work is distributed under the terms of a 16permission notice identical to this one. 17 18 Permission is granted to copy and distribute translations of this 19manual into other languages, under the above conditions for modified 20versions. 21 22 23File: fidogate.info, Node: Top, Next: Introduction, Up: (DIR) 24 25Introduction 26************ 27 28This manual documents how to install and use FIDOGATE. It is the first 29step toward a concise documentation. Alas, writing documentation is a 30somewhat tedious business, so this manual is far from complete. 31 32* Menu: 33 34* Introduction::Introduction to FIDOGATE 35* Installation::Compiling and installing FIDOGATE 36* Programs:: FIDOGATE programs and scripts 37* Config files::FIDOGATE config files 38* Basic:: Basic configuration 39* Usage:: FIDOGATE usage 40 41* Index:: Index 42 43 --- The Detailed Node Listing --- 44 45Compiling and installing FIDOGATE 46 47* config.h:: The config.h header file 48* config.make:: The config.make Makefile configuration 49* Compiling:: Compiling and installing FIDOGATE 50* Integration:: Integrating FIDOGATE and the mail/news system 51* Testing:: Testing FIDOGATE operation 52* Connecting:: Connecting to FIDONET 53 54Utilities 55 56* ftnaf:: Areafix mail processor 57* ftnafmail:: Areafix mail setuid frontend 58* ftnafpkt:: Areafix packet processor 59* ftnafutil:: Areafix utility 60 61Character set translation table compiler: 62* charsetc:: Character set translation table compiler 63 64FFX programs and scripts: 65* ffx:: Remote execution via Fido mailer 66* ffxmail:: `ffx' frontend for sending mail 67* ffxnews:: `ffx' frontend for sending news 68* ffxqt:: Execute `ffx' requests 69* ffxrmail:: `rmail' command for `ffxqt' 70* runffx:: Script for running FFX programs 71* send-ffx:: Script for processing news via FFX 72 73Gateway programs and scripts: 74* ftn2rfc:: Fido-Internet gateway program 75* ftnin:: Frontend for `ftn2rfc' 76* ftninpost:: `ftnin' post-processing script 77* ftninrecomb:: `ftnin' recombining script 78* ftnmail:: `rfc2ftn' setuid frontend 79* rfc2ftn:: Internet-Fido gateway program 80* rungate:: Script for running gateway programs 81* send-fidogate::Script for processing news via FIDOGATE 82 83Ticker programs: 84* ftnhatch:: Hatch new file into file area 85* ftntick:: Process incoming TIC files 86* ftntickpost:: `ftntick' post-processing script 87 88Tosser programs and scripts: 89* ftn2ftn:: FTN-FTN NetMail gateway 90* ftnexpire:: Utility to expire MSGID history database 91* ftnpack:: Pack (ArcMail) Fido mail packets 92* ftnroute:: Route Fido mail packets 93* ftntoss:: Toss/remap/rewrite Fido mail packets 94* runin:: Script for processing inbound packets 95* runmail:: Script for processing gateway mail output packets 96* runnews:: Script for processing gateway news output packets 97* runout:: Script for processing miscellaneous output packets 98* runtoss:: Script for running the tosser programs 99* rununpack:: Script for unpacking inbound arcmail archives 100 101Utilties: 102* ftnbsy:: Create/delete Binkley busy files 103* ftnconfig:: Retrieve information from FIDOGATE config files 104* ftnfattach:: Binkley outbound file attach utility 105* ftnflo:: Process Binkley outbound FLO files and attachments 106* ftnlock:: Create/delete lock files 107* ftnlog:: Write message to log file 108* ftnoutpkt:: Create output Fido message packets 109* ftnseq:: Access sequencer file 110* pktdebug:: FTN mail packet debugger 111* pktmore:: Pager frontend for `pktdebug' 112* sumcrc:: CRC checksum utility 113 114FIDOGATE Config Files 115 116* Config:: Main configuration file 117* Hosts:: hosts FTN address to host name conversion 118* Aliases:: aliases user aliases 119* Areas:: areas FTN area to newsgroup conversion 120* Bounce:: Bounce messages of `ftn2rfc' 121* Passwd:: passwd password config file 122* Routing:: routing file for `ftntoss' and `ftnroute' 123* Packing:: packing file for `ftnpack' 124* Areas.bbs:: areas.bbs EchoMail distribution 125 126Basic Configuration 127 128* Sendmail:: Sendmail configuration 129* Example Point:: Example point configuration 130* Example Point 2:: Example configuration with 2 point addresses 131* Example Node:: Example leaf node configuration 132 133FIDOGATE Usage 134 135* RFC Headers:: RFC Headers in FTN Messages 136* X Headers:: X Headers in RFC Messages 137 138 139File: fidogate.info, Node: Introduction, Next: Installation, Prev: Top, Up: Top 140 1411 Introduction to FIDOGATE 142************************** 143 144FIDOGATE is a Fido-Internet gateway and a Fido tosser. It is placed 145under the GNU General Public License, see COPYING for details. 146 147 The gateway converts between the worlds of Fido NetMail/EchoMail (or 148FTNs, Fido Technology Networks in general) and the UNIX mail/news 149system. FIDOGATE will convert Fido mail packets to RFC822/1036-style 150messages and vice versa. 151 152 FIDOGATE also includes a complete FIDO mail processor 153(NetMail/EchoMail tosser), an FTN-FTN gateway (NetMail only), a file 154processor (TIC file areas) and an Areafix/Filefix. 155 1561.1 How to Get FIDOGATE 157======================= 158 159The latest version of FIDOGATE is available at the locations. 160 161Internet WWW FIDOGATE home page: 162 http://www.fido.de/fidogate/ 163 164Internet anonymous ftp: 165 ftp://ftp.fido.de/pub/fidogate/ 166 167BBS and FIDO frequest: 168 2:2452/110 111 242:1000/1 2 +49-241-876604 (V.34, ISDN V.110, X.75) 169 Magic name FIDOGATE 170 1711.2 Requirements for FIDOGATE: 172============================== 173 174 * Something that gets you FIDONET mail. If you want a Unix-based Fido 175 mailer, I recommend using ifcico or BinkD. 176 177 * Installed news system (INN prefered) 178 179 * Mail transport agent (sendmail prefered) 180 181 * Perl (version 5 strictly required) 182 183 * M4 for compiling the sendmail config files 184 185 1861.3 FIDOGATE Mailing List 187========================= 188 189There is a NEW mailing list for FIDOGATE discussions and announcements: 190 191 fidogate@fido.de 192 193 To subscribe to this mailing list, send a message to 194 195 majordomo@fido.de 196 197with the command 198 199 subscribe fidogate 200 201in the message body (not subject!). This will not immediately put your 202email address into the mailing list. A confirmation mail with an 203authentication code will be send to you, which must be returned to 204majordomo to finally enable your subscription. 205 206 To unsubscribe from this mailing list, send the command 207 208 unsubscribe fidogate 209 2101.4 Credits 211=========== 212 213Most C code has been solely hacked by me, but there are also some source 214files taken from other free software packages (GNU, INN). See the 215various source files for details. In addition, many FIDOGATE users 216provided bug fixes and patches, which found their way into the 217distribution. 218 219 The ancestor of both FIDOGATE and ifmail was a Usenet posting to 220alt.sources called `rfmail' ages ago. None of this original code 221survived the massive rewrite and new code which makes FIDOGATE. 222 223 224File: fidogate.info, Node: Installation, Next: config.h, Prev: Introduction, Up: Top 225 2262 Compiling and installing FIDOGATE 227*********************************** 228 229* Menu: 230 231* config.h:: The config.h header file 232* config.make:: The config.make Makefile configuration 233* Compiling:: Compiling and installing FIDOGATE 234* Integration:: Integrating FIDOGATE and the mail/news system 235* Testing:: Testing FIDOGATE operation 236* Connecting:: Connecting to FIDONET 237 238This chapter describes the FIDOGATE configuration and installation. You 239must also create and edit the config files to be installed in the 240CONFIGDIR directory, `fidogate.conf', `areas', `hosts', `passwd', 241`routing', `packing', `aliases' according to your setup (see the 242examples subdirectory). 243 244 The chapter on config files describes them in detail. 245 246 247File: fidogate.info, Node: config.h, Next: config.make, Prev: Installation, Up: Installation 248 2492.1 The `config.h' Header File 250============================== 251 252Normally, if you want to compile a standard version of FIDOGATE on one 253of the supported platforms, it is not necessary to change anything in 254this file. Most things can be configured or overridden in `config.make' 255(compile-time) or `fidogate.conf' (run-time). 256 257If you really want to edit `config.h', here are the gory details: 258 259`LOCAL_FTN_ADDRESSES' 260 Generate "local" FTN addresses: User_Name%p.f.n.z@hostname.domain 261 instead of User_name@p.f.n.z.domain. 262 263`DO_BSY_FILES' 264 Create Binkley-style busy files while accessing the Binkley 265 outbound. 266 267`NFS_SAFE_LOCK_FILES' 268 Create lock / bsy files in an NFS-safe way. 269 270`AMIGADOS_4D_OUTBOUND' 271 Use AmigaDOS-style outbound file names. 272 273`MAXMSGSIZE' 274 Maximum size of FIDO messages generated by `rfc2ftn', larger 275 messages will be split. Alas, less than 16K seems to be the only 276 safe setting. This is the default value. 277 278`FTN_INVALID_DOMAIN' 279 Domain address to be used for invalid FTN addresses. 280 281`FACILITY' 282 syslog facility used if `Logfile' is set to "syslog". 283 284`CHARSET_STDFTN' 285 Default charset for Fido messages. 286 287`CHARSET_STD7BIT' 288 Default charset for RFC messages with 7bit encoding. 289 290`ALIASES_ARE_LOCAL' 291 Addresses found in the `aliases' config file are rewritten so that 292 the sender's address is the gateway. 293 294`PASSTHRU_NETMAIL' 295 Passthru operation for NetMail: if the sender of the message is an 296 FTN address, the origin address of the resulting FTN message will 297 be that FTN address. WARNING: enabled only if you really know what 298 you're doing! 299 300`PASSTHRU_ECHOMAIL' 301 Passthru operation for EchoMail: X-FTN-Tearline, X-FTN-Origin, 302 X-FTN-Seen-By, X-FTN-Path headers will be used for tear line, * 303 Origin, SEEN-BY, ^APATH, when gating from Internet to FTN. 304 WARNING: enabled only if you really know what you're doing! 305 306`AI_1' 307 308`AI_3' 309 310`AI_5' 311 312`AI_6' 313 314`AI_8' 315 Configuration for Andy Igoshin's patches, see 316 `contrib/fidogate-4.3a3-ai-pl9.1/README.ai' for details. 317 `AI_2,4,7' are now fully integrated. 318 319 320System dependent configuration: 321 322 This configuration contains several groups of #define/#undef. First, 323the definitions for a standard POSIX UNIX, followed by #ifdef'ed 324definitions for SunOS, Linux, FreeBSD, Interactive UNIX, MSDOS DJGPP, 325NextStep, GNU-WIN32. 326 327 If you want to port FIDOGATE to a new system, please add a #ifdef'ed 328section similar to the already existing ones. 329 330 The gory details: 331 332`HAS_FCNTL_LOCK' 333 Define, if the system support fcntl() file locking. 334 335`HAS_GETTIMEOFDAY' 336 Define, if the system has the gettimeofday() function. 337 338`HAS_TM_GMTOFF' 339 Define, if the system has a tm_gmtoff field in struct tm. 340 341`HAS_SYSEXITS_H' 342 Define, if the system support the `sysexits.h' header file. 343 344`HAS_TM_ZONE' 345 Define, if the system has a tm_zone field in struct tm. 346 347`HAS_STRFTIME' 348 Define, if the system has the Standard-C strftime() function. 349 350`HAS_TZNAME' 351 Define, if the system has `extern char *tzname[2]'. 352 353`HAS_STRCASECMP' 354 Define, if the system has the `strcasecmp()' and `strncasecmp()' 355 functions. 356 357`HAS_STRICMP' 358 Define, if the system has the `stricmp()' and `strnicmp()' 359 functions. 360 361`HAS_STERROR' 362 Define, if the system has the `strerror()' function. 363 364`DO_BINARY' 365 Define, if files must be opened in binary mode. 366 367`DO_DOSIFY' 368 Define, if filenames must be converted to DOS, OS2-style `\'. 369 370`RECEIVED_BY_MAILER' 371 Define, if extra Received lines are inserted by the mail system, 372 currently only used for NeXT. 373 374`HAS_SYSLOG' 375 Define, if syslogd and the library function `syslog()', 376 `vsyslog()' are suppored. 377 378`HAS_SNPRINTF' 379 Define, if `snprintf()' and `vsnprintf()' are supported. 380 381`HAS_HARDLINKS' 382 Define, if the system supports file systems with hard links and the 383 library function `link()'. 384 385`HAS_POSIX_REGEX' 386 Define, if the system supports the POSIX regex functions regcomp(), 387 regexec() etc. 388 389 390 Define only one of `HAS_TM_ZONE', `HAS_STRFTIME', `HAS_TZNAME', and 391also only one of `HAS_STRCASECMP', `HAS_STRICMP'. 392 393THE FOLLOWING DEFINES SHOULD REALLY BE LEFT AS IS!!! 394 395`MSGID_FIDONET_DOMAIN' 396 Default domain for standard FIDO addresses (zone 1-6). Used for 397 Message-IDs only, so DO NOT CHANGE. 398 399`PACKET_MODE' 400 401`BSY_MODE' 402 403`FLO_MODE' 404 405`DATA_MODE' 406 407`DIR_MODE' 408 409`CONF_MODE' 410 Permissions for files processed by FIDOGATE. 411 412`FTN_RFC_HEADERS' 413 RFC headers recognized at the beginning of FTN messages. 414 415`RFC_LVL_1_HEADERS' 416 RFC headers put into FTN messages for RFC level 1. 417 418`R_MODE' 419 420`W_MODE' 421 422`A_MODE' 423 424`RP_MODE' 425 426`WP_MODE' 427 428`AP_MODE' 429 Modes (`fopen()') for opening files. 430 431`DATE_LOG' 432 433`DATE_DEFAULT' 434 435`DATE_NEWS' 436 437`DATE_MAIL' 438 439`DATE_FROM' 440 441`DATE_FTS_0002' 442 443`DATE_TICK_PATH' 444 445`DATE_VIA' 446 447`DATE_SPLIT' 448 Date format strings. 449 450`PRODUCT_CODE' 451 FIDO product code used by `rfc2ftn'. 452 453`MAXADDRESS' 454 Maximum number of `Address' and `Zone' statements in `config' file. 455 456`MAXDOSDRIVE' 457 Maximum number of `DosDrive' statements in `config' file. 458 459`MAXPATH' 460 Maximum length of a pathname in FIDOGATE. 461 462`MAXINETADDR' 463 Maximum length of the address part of an Internet address in 464 FIDOGATE. 465 466`MAXUSERNAME' 467 Maximum length of the user name part of an Internet address in 468 FIDOGATE. 469 470`MAXOPENFILES' 471 Maximum number of packet files concurrently opened by tosser 472 programs. The maximum possible value is operating system and 473 configuration dependent, see UNIX ulimits. 474 475 476 477File: fidogate.info, Node: config.make, Next: Compiling, Prev: config.h, Up: Installation 478 4792.2 The `config.make' Makefile Configuration 480============================================ 481 482This file is included in all FIDOGATE Makefiles. 483 484 A special convention is used for defining FIDOGATE configuration 485macros: macro name starting with `DEFAULT_' are used by the compilation 486process to automatically generate C code. 487 488`DEFAULT_V_option' 489 Creates a Makefile macro definition, substitutes <option> in shell 490 and perl scripts, creates a compile-time C `#define 491 DEFAULT_'option in `paths.h', a run-time configuration option 492 option in `fidogate.conf', and makes FIDOGATE evaluate the 493 environment variable `FIDOGATE_'option. 494 495`DEFAULT_F_option' 496 Creates a Makefile macro definition, substitutes <option> in shell 497 and perl scripts, creates a compile-time C `#define 498 DEFAULT_'option in `paths.h'. No run-time override! 499 500`DEFAULT_A_option' 501 Creates a %X abbreviation (can be used at the start of file names) 502 for option. 503 504 505 Be very carefull not to remove any of the FIDOGATE standard macros 506and don't touch the standard abbreviations in this file!!! 507 508`DEFAULT_V_CONFIGDIR' 509 Directory for config files. 510 511`DEFAULT_V_LIBDIR' 512 Directory for FIDOGATE's internal programs. 513 514`DEFAULT_V_BINDIR' 515 Directory for user programs and scripts. 516 517`DEFAULT_V_LOGDIR' 518 Directory for log files. 519 520`DEFAULT_V_VARDIR' 521 Directory for `areas.bbs', `history'. 522 523`DEFAULT_V_LOCKDIR' 524 Directory for lock files. 525 526`DEFAULT_V_SPOOLDIR' 527 Internal spool directory (temporary files). 528 529`DEFAULT_V_BTBASEDIR' 530 BinkleyTerm-style outbound base directory. This is the base 531 directory, not the actual zone outbound directory. 532 533`DEFAULT_V_INBOUND' 534 BinkleyTerm-style inbound directory. 535 536`DEFAULT_V_PINBOUND' 537 BinkleyTerm-style protected inbound directory. 538 539`DEFAULT_V_UUINBOUND' 540 BinkleyTerm-style inbound directory for the `recvuu' script. 541 542`DEFAULT_V_FTPINBOUND' 543 BinkleyTerm-style FTP inbound directory. 544 545`DEFAULT_V_ACL' 546 Access control list for AI patches (not used for standard FIDOGATE 547 distribution). 548 549`DEFAULT_V_ALIASES' 550 Configuration file for aliases. 551 552`DEFAULT_V_AREAS' 553 Configuration file for areas/newsgroups gateway. 554 555`DEFAULT_V_HOSTS' 556 Configuration file for registered hosts. 557 558`DEFAULT_V_PASSWD' 559 Configuration file for passwords. 560 561`DEFAULT_V_PACKING' 562 Configuration file for ArcMail packer (`ftnpack'). 563 564`DEFAULT_V_ROUTING' 565 Configuration file for NetMail/EchoMail routing (`ftntoss', 566 `ftnroute'). 567 568`DEFAULT_V_HISTORY' 569 MSGID history file for dupe check. 570 571`DEFAULT_V_LOGFILE' 572 Default log file. 573 574`DEFAULT_V_CHARSETMAP' 575 Character set mapping table. 576 577`DEFAULT_F_NEWSETCDIR' 578 INN directory: config files 579 580`DEFAULT_F_NEWSVARDIR' 581 INN directory: active, history files. 582 583`DEFAULT_F_NEWSLIBDIR' 584 INN directory: scripts. 585 586`DEFAULT_F_NEWSSPOOLDIR' 587 INN directory: news spool. 588 589`DEFAULT_F_IFMAILDIR' 590 Ifcico/ifmail directory. 591 592`DEFAULT_F_CONFIG_GATE' 593 594`DEFAULT_F_CONFIG_MAIN' 595 596`DEFAULT_F_CONFIG_FFX' 597 FIDOGATE main configuration file `fidogate.conf'. 598 599`DEFAULT_F_SEQ_MAIL' 600 601`DEFAULT_F_SEQ_NEWS' 602 603`DEFAULT_F_SEQ_MSGID' 604 605`DEFAULT_F_SEQ_PKT' 606 607`DEFAULT_F_SEQ_SPLIT' 608 609`DEFAULT_F_SEQ_FF' 610 611`DEFAULT_F_SEQ_TOSS' 612 613`DEFAULT_F_SEQ_PACK' 614 615`DEFAULT_F_SEQ_TICK' 616 Sequencer files. 617 618`DEFAULT_F_LOCK_HISTORY' 619 Lock file for history access. 620 621`DEFAULT_F_OUTRFC_MAIL' 622 623`DEFAULT_F_OUTRFC_NEWS' 624 625`DEFAULT_F_OUTPKT' 626 627`DEFAULT_F_OUTPKT_MAIL' 628 629`DEFAULT_F_TOSS_TOSS' 630 631`DEFAULT_F_TOSS_ROUTE' 632 633`DEFAULT_F_TOSS_PACK' 634 635`DEFAULT_F_TOSS_BAD' 636 637`DEFAULT_F_OUTPKT_NEWS' 638 Internal spool directories (temporary files). If these 639 directories are different from the default ones, the commands for 640 the `install-dirs' target of `Makefile' must be changed as well. 641 642`DEFAULT_F_TICK_HOLD = %B/tick' 643 Outbound hold directory for TIC files. 644 645`DEFAULT_A_CONFIGDIR' 646 647`DEFAULT_A_LIBDIR' 648 649`DEFAULT_A_BINDIR' 650 651`DEFAULT_A_LOGDIR' 652 653`DEFAULT_A_VARDIR' 654 655`DEFAULT_A_LOCKDIR' 656 657`DEFAULT_A_SPOOLDIR' 658 659`DEFAULT_A_BTBASEDIR' 660 661`DEFAULT_A_INBOUND' 662 663`DEFAULT_A_PINBOUND' 664 665`DEFAULT_A_UUINBOUND' 666 Abbreviations for configured directories. 667 668`PERL' 669 Full path name of perl executable. 670 671`SENDMAIL_CF_DIR' 672 Directory where the sendmail m4 configuration files are installed 673 (`/usr/lib/sendmail-cf' on RedHat Linux systems). 674 675`INFODIR' 676 Directory for installing info documentation files. 677 678`HTMLDIR' 679 Directory for installing HTML documentation files. 680 681`HTMLLOGDIR' 682 Directory for installing CGI files. 683 684 685`M4' 686 m4 macro processor (for compiling sendmail cf files). 687 688`OWNER' 689 Owner of FIDOGATE files. 690 691`GROUP' 692 Group of FIDOGATE files. 693 694`PERM_PROG' 695 Permissions for installing programs. 696 697`PERM_DATA' 698 Permissions for installing data files. 699 700`PERM_SETUID' 701 Permissions for installing setuid `OWNER' programs. 702 703`PERM_DIR' 704 Permissions for installing directories. 705 706`CC' 707 C compiler. 708 709`YACC' 710 `yacc' or a clone like `bison -y'. 711 712`AR' 713 `ar' monkey ... (@!#$%&... ouch!) ... librarian. 714 715`RANLIB' 716 Library utitility, if needed. 717 718`DEBUG' 719 Optimize or debugging flags for compiling. 720 721`INCLUDE' 722 C include (-I) options. 723 724`CFLAGS' 725 Flags for compiling FIDOGATE. 726 727`LFLAGS' 728 Flags for linking FIDOGATE. 729 730`LIBS' 731 Libraries for linking FIDOGATE, including the FIDOGATE library 732 `libfidogate.a'. 733 734`INSTALL' 735 Install program. 736 737`' 738 Set to `.exe' for MSDOS, OS2, Win32. 739 740`INSTALL_PROG' 741 Install command for installing programs. 742 743`INSTALL_DATA' 744 Install command for installing data files. 745 746`INSTALL_SETUID' 747 Install command for installing setuid programs. 748 749`INSTALL_DIR' 750 Install command for installing directories. 751 752`PREFIX' 753 Extra prefix directory for `make install'. 754 755`LIB' 756 Name of the FIDOGATE library. 757 758 759 760File: fidogate.info, Node: Compiling, Next: Integration, Prev: config.make, Up: Installation 761 7622.3 Compiling and Installing FIDOGATE 763===================================== 764 765Compile the beast by entering 766 make depend 767 make 768 769 Alternatively an optimized version can be compiled with 770 make DEBUG=-O2 771 772 If everything works, you must create the necessary directories: 773 make install-dirs 774 Then install all FIDOGATE programs: 775 make install 776 777 Next you must create the configuration files in (default) 778`/etc/fidogate'. Have a look at the various configuration in directory 779`examples/' and use them to build your own configuration. 780 781 782File: fidogate.info, Node: Integration, Next: Testing, Prev: Compiling, Up: Installation 783 7842.4 Integrating FIDOGATE and the Mail/News System 785================================================= 786 787`scripts/inn' 788 Scripts for INN. 789 790`scripts/cnews' 791 Scripts for CNews. 792 793`sendmail/cf' 794 Sendmail V8 configuration files (m4) and example .mc files for 795 FIDOGATE: Fido.DE domain gateway morannon, orodruin, point setup. 796 797 798 Much more concise instructions should be here!!! ;-) 799 800 801File: fidogate.info, Node: Testing, Next: Connecting, Prev: Integration, Up: Installation 802 8032.5 Testing the FIDOGATE Installation 804===================================== 805 8062.5.1 `Tosser' 807-------------- 808 809... 810 8112.5.2 `Gateway' 812--------------- 813 814... 815 816 817File: fidogate.info, Node: Connecting, Next: Programs, Prev: Testing, Up: Installation 818 8192.6 Connecting to FIDONET 820========================= 821 822FIDOGATE does NOT include a FIDO mailer, so you have to transfer FIDO 823mail to and from the UNIX system by some other means. 824 825 If you want everything running on the UNIX system, you need a FIDO 826mailer for UNIX. Currently, this choice is limited to 827 * BinkleyTerm 828 829 * ifcico 830 831 * BinkD 832 833 I don't know what the current state of BinkleyTerm for Unix/Linux is, 834but ifcico and BinkD are working very well for me. See the FIDOGATE home 835page at `http://www.fido.de/fidogate/' for links. 836 837 Another solution is a separate PC running DOS or OS/2 and 838BinkleyTerm as a mailer. The Fido.DE gateway currently comprises a 839LINUX PC for the gateway/tosser and Samba server, and an OS/2 PC 840running BinkleyTerm for the analog phone and ISDN lines. The 841BinkleyTerm outbound is kept on the LINUX server, so the OS/2 PC and 842the gateway have access to it. 843 844 845File: fidogate.info, Node: Programs, Next: ftnaf, Prev: Connecting, Up: Top 846 8473 FIDOGATE Programs 848******************* 849 850* Menu: 851 852Areafix programs and scripts: 853* ftnaf:: Areafix mail processor 854* ftnafmail:: Areafix mail setuid frontend 855* ftnafpkt:: Areafix packet processor 856* ftnafutil:: Areafix utility 857 858Character set translation table compiler: 859* charsetc:: Character set translation table compiler 860 861FFX programs and scripts: 862* ffx:: Remote execution via Fido mailer 863* ffxmail:: `ffx' frontend for sending mail 864* ffxnews:: `ffx' frontend for sending news 865* ffxqt:: Execute `ffx' requests 866* ffxrmail:: `rmail' command for `ffxqt' 867* runffx:: Script for running FFX programs 868* send-ffx:: Script for processing news via FFX 869 870Gateway programs and scripts: 871* ftn2rfc:: Fido-Internet gateway program 872* ftnin:: Frontend for `ftn2rfc' 873* ftninpost:: `ftnin' post-processing script 874* ftninrecomb:: `ftnin' recombining script 875* ftnmail:: `rfc2ftn' setuid frontend 876* rfc2ftn:: Internet-Fido gateway program 877* rungate:: Script for running gateway programs 878* send-fidogate::Script for processing news via FIDOGATE 879 880Ticker programs: 881* ftnhatch:: Hatch new file into file area 882* ftntick:: Process incoming TIC files 883* ftntickpost:: `ftntick' post-processing script 884 885Tosser programs and scripts: 886* ftn2ftn:: FTN-FTN NetMail gateway 887* ftnexpire:: Utility to expire MSGID history database 888* ftnpack:: Pack (ArcMail) Fido mail packets 889* ftnroute:: Route Fido mail packets 890* ftntoss:: Toss/remap/rewrite Fido mail packets 891* runin:: Script for processing inbound packets 892* runmail:: Script for processing gateway mail output packets 893* runnews:: Script for processing gateway news output packets 894* runout:: Script for processing miscellaneous output packets 895* runtoss:: Script for running the tosser programs 896* rununpack:: Script for unpacking inbound arcmail archives 897 898Utilties: 899* ftnbsy:: Create/delete Binkley busy files 900* ftnconfig:: Retrieve information from FIDOGATE config files 901* ftnfattach:: Binkley outbound file attach utility 902* ftnflo:: Process Binkley outbound FLO files and attachments 903* ftnlock:: Create/delete lock files 904* ftnlog:: Write message to log file 905* ftnoutpkt:: Create output Fido message packets 906* ftnseq:: Access sequencer file 907* pktdebug:: FTN mail packet debugger 908* pktmore:: Pager frontend for `pktdebug' 909* sumcrc:: CRC checksum utility 910 911 Almost all FIDOGATE programs support the following standard options, 912which therefore aren't listed in the sections describing the individual 913programs: 914 915`-v --verbose' 916 Increase the verbosity/debug level. 917 918`-h --help' 919 Help on usage and options. 920 921`-c --config name' 922 Read an alternate config file. `""' means none. name may start 923 with %X/, see below. 924 925`-a --addr Z:N/F.P' 926 Set the main address of this program. 927 928`-u --uplink-addr Z:N/F.P' 929 Set the uplink address (boss node) of this program (only useful for 930 gateway programs). 931 932 933 The option `-a' and `-u' also support Internet-style FTN addresses, 934e.g. `p10.f110.n2452.z2'. If any of these options is specified, all 935addresses from the config file are disabled. 936 937 All options and config statements which take file or directory names 938accept the following `%' abbreviations: 939 940`%C' 941 CONFIGDIR 942 943`%L' 944 LIBDIR 945 946`%N' 947 BINDIR 948 949`%G' 950 LOGDIR 951 952`%V' 953 VARDIR 954 955`%K' 956 LOCKDIR 957 958`%S' 959 SPOOLDIR 960 961`%B' 962 BTBASEDIR 963 964`%I' 965 INBOUND 966 967`%P' 968 PINBOUND 969 970`%U' 971 UUINBOUND 972 973 974File: fidogate.info, Node: ftnaf, Next: ftnafmail, Prev: Programs, Up: Programs 975 9763.1 ftnaf -- Areafix 977==================== 978 979Usage: 980 981 ftnaf [-options] [Z:N/F.P command ] 982 983Options: 984 985`-m --mail' 986 Process Areafix mail message (RFC) on stdin. 987 988`-r --no-reply' 989 Don't send reply via mail, write to stdout. 990 991`-n --no-rewrite' 992 Don't rewrite AREAS.BBS. 993 994`-b --areas-bbs NAME' 995 Use alternate AREAS.BBS. 996 997`-F --filefix' 998 Run as Filefix program, using FAREAS.BBS. 999 1000 1001Commands: 1002 1003 listall list all available areas list 1004 list areas available to node query 1005 list subscribed areas unlinked 1006 list unsubscribed areas from Z:N/F.P PASSWORD set address 1007 and password passwd Z:N/F.P PASSWORD password Z:N/F.P PASSWORD 1008 +AREA subscribe to AREA AREA 1009 subscribe AREA sub AREA -AREA 1010 unsubscribe from AREA unsubscribe AREA unsub AREA vacation 1011 AREA set vacation flag for AREA &AREA [-options] 1012 create new AREA new AREA [-options] create AREA 1013 [-options] ~AREA delete AREA delete AREA 1014 comment TEXT arbitrary comment (ignored) help 1015 this help 1016 1017 AREA names are not case-sensitive and support shell-style wildcards 1018 * ? [a-z] [abc], e.g. COMP.OS.*, [A-D]*.GER 1019 1020`listall' 1021 List all areas. 1022 1023`list' 1024 List areas available to node. 1025 1026`query' 1027 List subscribed areas. 1028 1029`unlinked' 1030 List unsubscribed areas available to node. 1031 1032`from Z:N/F.P PASSWORD' 1033 1034`passwd Z:N/F.P PASSWORD' 1035 1036`password Z:N/F.P PASSWORD' 1037 Set address and password. 1038 1039`+AREA' 1040 1041`AREA' 1042 1043`subscribe AREA' 1044 1045`sub AREA' 1046 Subscribe to AREA. 1047 1048`-AREA' 1049 1050`unsubscribe AREA' 1051 1052`unsub AREA' 1053 Unsubscribe from AREA. 1054 1055`vacation AREA' 1056 Set vacation flag for AREA. NOT YET IMPLEMENTED!!! 1057 1058`&AREA [-options ]' 1059 1060`new AREA [-options ]' 1061 1062`create AREA [-options ]' 1063 Create new area. Nodes allowed to create an area must have the `&' 1064 key in their `passwd' entry. Allowed `areas.bbs' options: `-#', 1065 `-p', `-r', `-l 'lvl, `-k 'key, `-d 'desc, and `-z 'zone. 1066 1067`~AREA' 1068 1069`delete AREA' 1070 Delete AREA. Nodes allowed to deleted an area must have the `~' 1071 key in their `passwd' entry. 1072 1073`comment text' 1074 Arbitrary comment, completely ignored. 1075 1076`help' 1077 Help on Areafix commands. 1078 1079 1080 All command keywords may be prefixed by `%'. `ftnaf' also recognizes 1081the `-q' (= query) and `-l' (= list) options following the password in 1082the subject header. 1083 1084 For proper operation `ftnaf' requires the `X-FTN-From' header 1085generated by `ftn2rfc', thus the `X-FTN' configuration must include the 1086`f' flag. 1087 1088 1089File: fidogate.info, Node: ftnafmail, Next: ftnafpkt, Prev: ftnaf, Up: Programs 1090 10913.2 ftnafmail -- Areafix Mail Frontend 1092====================================== 1093 1094Usage: 1095 1096 ftnafmail [-options] 1097 1098Options: 1099 1100`-F --filefix' 1101 Run `ftnaf' as Filefix program. 1102 1103 1104 This is the setuid mail frontend for `ftnaf' to be run from the 1105sendmail aliases. DO NOT use `ftnaf' directly, as this will result in 1106security problems. 1107 1108 # Areafix/Filefix - FIDOGATE ftnaf 1109 areafix: "|/usr/lib/fidogate/ftnafmail" 1110 areamgr: areafix 1111 filefix: "|/usr/lib/fidogate/ftnafmail -F" 1112 filemgr: filefix 1113 1114 1115File: fidogate.info, Node: ftnafpkt, Next: ftnafutil, Prev: ftnafmail, Up: Programs 1116 11173.3 ftnafpkt -- Areafix packet processor 1118======================================== 1119 1120Usage: 1121 1122 ftnafpkt [-options] [packet ... ] 1123 1124Options: 1125 1126`-I --in-dir name' 1127 Set input directory. Default: PINBOUND 1128 1129`-O --out-dir name' 1130 Set output directory. Default: SPOOLDIR/outpkt 1131 1132`-l --lock-file' 1133 Create lock file while processing. 1134 1135`-r --no-reply' 1136 Don't send reply via NetMail. 1137 1138`-n --no-rewrite' 1139 Don't rewrite AREAS.BBS. 1140 1141`-b --areas-bbs NAME' 1142 Use alternate AREAS.BBS. 1143 1144`-F --filefix' 1145 Run as Filefix program, using FAREAS.BBS. 1146 1147 1148 This is the packet processor frontend for the FIDOGATE Areafix, which 1149doesn't require the Unix mail system for Areafix operation. The best way 1150to use `ftnafpkt' is via the tosser. 1151 1152 `routing' example: 1153 Remap 2:2499/999.* 2:2499/999.101 "Area*" 1154 # ^^^^^^^^^^^^ ^^^^^^^^^^^^^^ 1155 # node addr pseudo point 1156 # for Areafix 1157 1158 NetMail 1159 Send hold 2:2499/999.* 1160 1161 `packing' example: 1162 1163 progn areafix "/usr/lib/fidogate/ftnafpkt %s" 1164 pack areaifx 2:2499/999.101 1165 1166 `runout' must be run regularly to process messages generated by 1167`ftnafpkt'. 1168 1169 1170File: fidogate.info, Node: ftnafutil, Next: charsetc, Prev: ftnafpkt, Up: Programs 1171 11723.4 ftnafutil -- Areafix utility 1173================================ 1174 1175Usage: 1176 1177 ftnafutil [-options] [command ... ] 1178 1179Options: 1180 1181`-n --no-rewrite' 1182 Don't rewrite AREAS.BBS. 1183 1184`-b --areas-bbs NAME' 1185 Use alternate AREAS.BBS. 1186 1187`-F --filefix' 1188 Run as Filefix program, using FAREAS.BBS. 1189 1190`-O --out-dir name' 1191 Set output directory. Default: SPOOLDIR/outpkt 1192 1193 1194Commands: 1195 1196`delete' 1197 Delete dead areas from `areas.bbs' (no uplink and no downlinks). 1198 1199`subscribe' 1200 Subscribe to area at uplink, if at least one downlink has 1201 subscribed to this area (uses the `-s S/U' option in `areas.bbs'). 1202 1203`unsubscribe' 1204 Unsubscribe from area at uplink, if no more downlinks are 1205 subscribed to this area (uses the `-s S/U' option in `areas.bbs'). 1206 1207 1208 Auto-subscribe/unsubscribe will only be used for areas marked with 1209the state option. State `-s U' means that the area is not currently 1210subscribed at the uplink, `-s S' means that the are is subscribed at 1211the uplink. 1212 1213 1214File: fidogate.info, Node: charsetc, Next: ffx, Prev: ftnafutil, Up: Programs 1215 12163.5 charsetc -- Character set translation table compiler 1217======================================================== 1218 1219Usage: 1220 1221 charsetc [-options] charset.map charset.bin 1222 1223 1224File: fidogate.info, Node: ffx, Next: ffxmail, Prev: charsetc, Up: Programs 1225 12263.6 ffx -- Remote Execution via Fido Mailer 1227=========================================== 1228 1229Usage: 1230 1231 ffx [-options] Z:N/F.P command 1232 1233Options: 1234 1235`-b --batch-dir dir' 1236 Operate in batch mode, using dir. Control and data files are not 1237 immediately appended to the node's FLO file, but rather written to 1238 a separate batch directory SPOOLDIR/out.ZZZ/dir. Implies `-n'. 1239 1240`-B --binkley name' 1241 Set Binkley outbound directory. 1242 1243`-F --flavor flavor' 1244 Set flavor of outbound FLO file: `Hold', `Normal', `Direct', or 1245 `Crash'. 1246 1247`-g --grade grade' 1248 Set grade of control and data files to grade (single letter 1249 [a-z0-9]). 1250 1251`-n --nocompression' 1252 Don't compress data files. 1253 1254 1255 1256File: fidogate.info, Node: ffxmail, Next: ffxnews, Prev: ffx, Up: Programs 1257 12583.7 ffxmail -- ffx Frontend for Sending Mail 1259============================================ 1260 1261Usage: 1262 1263 ffxmail Z:N/F.P address ... 1264 1265No options. 1266 1267 `ffxmail' calls `ffx' in batch mode (`-b'), selecting the batch 1268directory for the node address. Modify the script 1269(`src/ffx/ffxmail.sh') for other addresses/batch directories. 1270 1271 1272File: fidogate.info, Node: ffxnews, Next: ffxqt, Prev: ffxmail, Up: Programs 1273 12743.8 ffxnews -- ffx Frontend for Sending News 1275============================================ 1276 1277Usage: 1278 1279 ffxnews Z:N/F.P 1280 1281No options. 1282 1283 `ffxnews' calls `ffx' in batch mode (`-b'), selecting the batch 1284directory for the node address. Modify the script 1285(`src/ffx/ffxnews.sh') for other addresses/batch directories. 1286 1287 1288File: fidogate.info, Node: ffxqt, Next: ffxrmail, Prev: ffxnews, Up: Programs 1289 12903.9 ffxqt -- Execute ffx Requests 1291================================= 1292 1293Usage: 1294 1295 ffxqt [-options] 1296 1297Options: 1298 1299`-g --grade grade' 1300 Process ffx jobs with grade only. grade must be a single letter. 1301 1302`-I --inbound name' 1303 Select the input directory where the `f???????.ffx' control files 1304 are read from. Default: PINBOUND 1305 1306`-t --insecure' 1307 Process ffx files without password. Default: ffx file must contain 1308 a password. 1309 1310 1311 1312File: fidogate.info, Node: ffxrmail, Next: runffx, Prev: ffxqt, Up: Programs 1313 13143.10 ffxrmail -- Rmail Command for FFX 1315====================================== 1316 1317Usage: 1318 1319 ffxrmail address ... 1320 1321 Perl script to be called by `ffxqt' for `rmail' commands to receive 1322Internet mail. This replaces `/bin/rmail' (UUCP), calling 1323`/usr/lib/sendmail' directly with appropiate options. 1324 1325 1326File: fidogate.info, Node: runffx, Next: send-ffx, Prev: ffxrmail, Up: Programs 1327 13283.11 runffx -- Script for Running FFX Programs 1329============================================== 1330 1331Usage: 1332 1333 runffx 1334 1335 1336File: fidogate.info, Node: send-ffx, Next: ftn2rfc, Prev: runffx, Up: Programs 1337 13383.12 send-ffx -- Script for Processing News via FFX 1339=================================================== 1340 1341Usage: 1342 1343 ffxqt [hostname] 1344 1345 Processes INN news batch file `/var/spool/news/out.going/'hostname. 1346 1347 1348File: fidogate.info, Node: ftn2rfc, Next: ftnin, Prev: send-ffx, Up: Programs 1349 13503.13 ftn2rfc -- FTN-Internet Gateway Program 1351============================================ 1352 1353Usage: 1354 1355 ftn2rfc [-options] [packet ... ] 1356 1357Options: 1358 1359`-1 --single-articles' 1360 Write single articles to output files (in `tmpnews'), not news 1361 batches containing several articles (batch is default). 1362 1363`-I --inbound-dir NAME' 1364 Set the input directory for FTN packets. Default: PINBOUND 1365 1366`-i --ignore-hosts' 1367 Don't bounce unknown hosts (unknown = not registered in `hosts') 1368 1369`-l --lock-file' 1370 Create lock file while processing. 1371 1372`-n --no-remove' 1373 Don't remove or rename input packet files, return exit code 1 if 1374 processing fails. 1375 1376`-t --insecure' 1377 Operate in insecure mode. All messages containing a To line for 1378 gateway addressing will be bounced. 1379 1380`-x --exec-program SCRIPT' 1381 Run SCRIPT after processing all FTN packets. Typically this is 1382 `%L/ftninpost'. 1383 1384 1385 `ftn2rfc' reads packet files from the input directory or the command 1386line and converts the FTN packets to Internet RFC mail and news, 1387written as mail and news RFC message files to the directories 1388SPOOLDIR/outrfc/mail and SPOOLDIR/outrfc/news, respectively. 1389 1390 1391File: fidogate.info, Node: ftnin, Next: ftninpost, Prev: ftn2rfc, Up: Programs 1392 13933.14 ftnin -- Frontend for `ftn2rfc' 1394==================================== 1395 1396Usage: 1397 1398 ftnin [-options] 1399 1400Options: 1401 1402`-n --no-toss' 1403 Don't call `ftn2rfc' for processing. 1404 1405`-x --exec-program SCRIPT' 1406 Execute SCRIPT after `ftn2rfc' processing, typically 1407 `%L/ftninpost'. 1408 1409 1410 All standard options are passed to the called `ftn2rfc'. 1411 1412 `ftnin' looks for mail packets addressed to the gateway addresses 1413(all `Address'/`GateAddress' statements in `fidogate.conf') and calls 1414`ftn2rfc' for each packet. 1415 1416 1417File: fidogate.info, Node: ftninpost, Next: ftninrecomb, Prev: ftnin, Up: Programs 1418 14193.15 ftninpost -- `ftnin' Post-processing Script 1420================================================ 1421 1422Usage: 1423 1424 ftninpost [-options] 1425 1426 This script is run by `ftn2rfc' or `ftnin', feeding the output in 1427SPOOLDIR/outrfc/mail and SPOOLDIR/outrfc/news to `sendmail' and 1428`rnews', respectively. 1429 1430 1431File: fidogate.info, Node: ftninrecomb, Next: ftnmail, Prev: ftninpost, Up: Programs 1432 14333.16 ftninrecomb -- `ftnin' Recombining Script 1434============================================== 1435 1436Usage: 1437 1438 ftninrecomb [-options] 1439 1440 If `FTNInRecombine' is enabled in `fidogate.conf', this script wil 1441be run by `ftninpost' to recombine split messages. NOT TESTED FOR 1442RELEASE 4.4!!! 1443 1444 1445File: fidogate.info, Node: ftnmail, Next: rfc2ftn, Prev: ftninrecomb, Up: Programs 1446 14473.17 ftnmail -- `rfc2ftn' Setuid Frontend 1448========================================= 1449 1450Usage: 1451 1452 ftnmail [-options] [address ...] 1453 1454 Setuid frontend for `rfc2ftn', passes the options 1455 1456`-a --addr ADDR' 1457 Passed to `rfc2ftn' as `-a ADDR -u ADDR'. 1458 1459`-i --ignore-hosts' 1460 Passed to `rfc2ftn' as `-i'. 1461 1462`-O --out-dir DIR' 1463 Passed to `rfc2ftn' as `-O %S/DIR'. 1464 1465 1466 `ftnmail' should be used for sendmail mailers. DO NOT use `rfc2ftn' 1467directly to avoid security problems. 1468 1469 1470File: fidogate.info, Node: rfc2ftn, Next: rungate, Prev: ftnmail, Up: Programs 1471 14723.18 rfc2ftn -- Internet-Fido Gateway Program 1473============================================= 1474 1475Usage: 1476 1477 rfc2ftn [-options] [address ...] 1478 1479Options: 1480 1481`-b --news-batch' 1482 Process news batch (implies `-n'). 1483 1484`-B --binkley name' 1485 Set Binkley outbound directory. 1486 1487`-i --ignore-registration' 1488 Do not bounce mail to nodes not registered in HOSTS (if 1489 `HostsRestricted' in `fidogate.conf' is enabled). 1490 1491`-m --max-msg n' 1492 Create new output packet after n messages. 1493 1494`-n --news-mode' 1495 Process news message in stdin. Default: mail 1496 1497`-o --out-packet-file name' 1498 Write output to FTN packet file name. 1499 1500`-O --out-packet-dir name' 1501 Set output directory for FTN packets. Default: 1502 SPOOLDIR/outpkt/mail or .../news 1503 1504`-t --to' 1505 Get recipient addresses from To, Cc, Bcc headers instead of 1506 command line. 1507 1508`-w --write-outbound flav' 1509 Write output directly to Binkley .?UT packets in outbound. 1510 1511`-W --write-crash' 1512 Write only crash mail directly to Binkley .CUT file. 1513 1514 1515 1516File: fidogate.info, Node: rungate, Next: send-fidogate, Prev: rfc2ftn, Up: Programs 1517 15183.19 rungate -- Script for Running Gateway Programs 1519=================================================== 1520 1521Usage: 1522 1523 rungate 1524 1525 1526File: fidogate.info, Node: send-fidogate, Next: ftnhatch, Prev: rungate, Up: Programs 1527 15283.20 send-fidogate -- Script for Processing News via FIDOGATE 1529============================================================= 1530 1531Usage: 1532 1533 send-fidogate [hostname] 1534 1535 Processes INN news batch file `/var/spool/news/out.going/'hostname. 1536If hostname is omitted the default `fidogate' is used. 1537 1538 1539File: fidogate.info, Node: ftnhatch, Next: ftntick, Prev: send-fidogate, Up: Programs 1540 15413.21 ftnhatch -- Hatch new file into file area 1542============================================== 1543 1544Usage: 1545 1546 ftnhatch [-options] area file "description" 1547 1548Options: 1549 1550`-b --fareas-bbs NAME' 1551 Use alternate FAREAS.BBS. 1552 1553`-r --replaces FILE' 1554 Adds `Replaces 'FILE header to generated tic file. 1555 1556 1557 Please note that the file must already reside in the directory for 1558the file area. Copying and hatching a new file to a file area is not 1559yet implemented. 1560 1561 1562File: fidogate.info, Node: ftntick, Next: ftntickpost, Prev: ftnhatch, Up: Programs 1563 15643.22 ftntick -- Process incoming TIC files 1565========================================== 1566 1567Usage: 1568 1569 ftntick [-options] 1570 1571Options: 1572 1573`-b --fareas-bbs file' 1574 Use alternate FAREAS.BBS. 1575 1576`-I --inbound dir' 1577 Use alternate inbound directory. 1578 1579`-t --insecure' 1580 Insecure processing, allow TIC files without password. 1581 1582`-x --exec script' 1583 Run script after sucessfully processing the TIC file. The one and 1584 only argument to script is the full path name of the TIC file. 1585 1586 1587 1588File: fidogate.info, Node: ftntickpost, Next: ftn2ftn, Prev: ftntick, Up: Programs 1589 15903.23 ftntickpost -- ftntick Post-processing Script 1591================================================== 1592 1593Usage: 1594 1595 ftntickpost [-options] file.tic 1596 1597Options: 1598 1599 1600 NOT YET COMPLETELY IMPLEMENTED! Currently the script is only a 1601skeleton with features such as announcement postings and mails to be 1602added in the future. 1603 1604 1605File: fidogate.info, Node: ftn2ftn, Next: ftnexpire, Prev: ftntickpost, Up: Programs 1606 16073.24 ftn2ftn -- FTN-FTN NetMail Gateway Program 1608=============================================== 1609 1610Usage: 1611 1612 ftn2ftn [-options] [packet ... ] 1613 1614Options: 1615 1616`-A --address-a Z:N/F.P' 1617 Set FTN address in network A. 1618 1619`-B --address-b Z:N/F.P' 1620 Set FTN address in network B. 1621 1622`-o --out-packet-file NAME' 1623 Set output packet file name. 1624 1625`-O --out-packet-dir NAME' 1626 Set output packet directory. 1627 1628 1629 This program provides a NetMail gateway between different FTNs, using 1630the (somewhat) standard "User Name%Z:N/F.P" addressing in the FTN from 1631and to fields. 1632 1633 If no packet is given on the command line, `ftn2ftn' looks for 1634packets addressed to the gateway addresses (A and B) in the Binkley 1635outbound. Both gateway addresses must be specified with the `-A' and 1636`-B' options. 1637 1638 If a packet name is passed on the command line, `ftn2ftn' will gate 1639this to the other network A. The gateway address (sender of the mails 1640in network A) is set with `-A' option. 1641 1642 1643File: fidogate.info, Node: ftnexpire, Next: ftnpack, Prev: ftn2ftn, Up: Programs 1644 16453.25 ftnexpire -- Utility for expiring MSGID history database 1646============================================================= 1647 1648Usage: 1649 1650 ftnexpire [-options] 1651 1652Options: 1653 1654`-m --maxhistory days' 1655 Set the maximum number of days for entries in the history 1656 database. The days argument supports decimal fractions. 1657 1658`-w --wait' 1659 Wait for history database lock file to be released. Default: exit, 1660 if history database is locked. 1661 1662 1663 This utility expires and rebuilds the MSGID history database, 1664similar to expire for the INN news system. 1665 1666 If the MSGID history database dupe check is used, `ftnexpire' must 1667be run regularly to keep the history database optimized (if not, 1668accessing the history database will become very slow!). A daily cron 1669job is just the right thing. 1670 1671 1672File: fidogate.info, Node: ftnpack, Next: ftnroute, Prev: ftnexpire, Up: Programs 1673 16743.26 ftnpack -- Pack Fido ArcMail Packets 1675========================================= 1676 1677Usage: 1678 1679 ftnpack [-options] [packet ... ] 1680 1681Options: 1682 1683`-B --binkley dir' 1684 Set Binkley outbound directory. 1685 1686`-f --ffx Z:N/F.P' 1687 Pack ffx control and data files for FTN address Z:N/F.P. You must 1688 also set the appropiate input directory with the `-I' option. 1689 1690`-F --file-dir dir' 1691 Set directory where `ftnpack' looks for file attachments. Should 1692 be the appropiate inbound directory, see also the `runtoss' 1693 script. If this option is not specified, no file attachments are 1694 processed. 1695 1696 If `-F /' is specified, `ftnpack' accepts a complete path name in 1697 the subject and doesn't search the directory. Warning: this option 1698 compromises security to some degree, because it allows any user to 1699 send any file readable by the user id running the tosser and 1700 mailer!!! 1701 1702`-g --grade grade' 1703 Only process packets with grade (single letter). 1704 1705`-I --in-dir dir' 1706 Set input directory. Default: %S/toss/route 1707 1708`-O --out-dir dir' 1709 Set directory for temporary packets. Default: %S/toss/pack. This 1710 is the directory, where packets to be put into arcmail archives 1711 will be created. 1712 1713`-l --lock-file' 1714 Create lock file while processing. 1715 1716`-m --maxarc size' 1717 Set maximum size of an archive to size KByte. If an existing 1718 ArcMail archive exceeds this size, `ftnpack' creates a new one. 1719 1720`-p --packing-file name' 1721 Read alternate `packing' config file. Default: %C/packing 1722 1723`-P --pkt' 1724 Process *.pkt files in the input directory. Default: output files 1725 of `ftnroute'. 1726 1727 1728 1729File: fidogate.info, Node: ftnroute, Next: ftntoss, Prev: ftnpack, Up: Programs 1730 17313.27 ftnroute -- Route Fido Mail Packets 1732======================================== 1733 1734Usage: 1735 1736 ftnroute [-options] [packet ... ] 1737 1738Options: 1739 1740`-g --grade grade' 1741 Only process packets with grade (single letter). 1742 1743`-I --in-dir name' 1744 Set input directory. Default: %S/toss/toss 1745 1746`-O --out-dir name' 1747 Set output directory. Default: %S/toss/route 1748 1749`-l --lock-file' 1750 Create lock file while processing. 1751 1752`-r --routing-file name' 1753 Read alternate `routing' config file. Default: %C/routing 1754 1755`-M --maxopen n' 1756 Set maximum number of concurrently open packet filess to n. 1757 Default: `MaxOpenFiles' config 1758 1759 1760 1761File: fidogate.info, Node: ftntoss, Next: runin, Prev: ftnroute, Up: Programs 1762 17633.28 ftntoss -- Toss Fido Mail Packets 1764====================================== 1765 1766Usage: 1767 1768 ftntoss [-options] [packet ... ] 1769 1770Options: 1771 1772`-d --no-dupecheck' 1773 Disabled dupe check (if `DupeCheck' is enabled in `config.main'). 1774 1775`-g --grade grade' 1776 Only process packets with grade (single letter). 1777 1778`-I --in-dir name' 1779 Set input directory. Default: PINBOUND 1780 1781`-O --out-dir name' 1782 Set output directory. Default: %S/toss/toss 1783 1784`-l --lock-file' 1785 Create lock file while processing. 1786 1787`-t --insecure' 1788 Insecure EchoMail tossing, don't check sender against nodes listed 1789 in AREAS.BBS. 1790 1791`-n --toss-all' 1792 Toss all EchoMail, even messages not addressed to one of our own 1793 AKAs (most probably routed EchoMail). 1794 1795`-p --passthru' 1796 Make all areas passthru (see also `#' in areas.bbs). 1797 1798`-r --routing-file name' 1799 Read alternate `routing' config file. Default: %C/routing 1800 1801`-s --strip-attribute' 1802 Strip Hold and Crash attribute from incoming NetMails. 1803 1804`-m --maxmsg n' 1805 Flush/close all output packet files after reading n messages. 1806 1807`-x --maxmsg-exit n' 1808 Flush/close all output packet files after reading n messages and 1809 processing the current input packet, then exit. 1810 1811`-M --maxopen n' 1812 Set maximum number of concurrently open packet filess to n. 1813 Default: `MaxOpenFiles' config 1814 1815`-b --fareas-bbs file' 1816 Use alternate areas.bbs. 1817 1818 1819 1820File: fidogate.info, Node: runin, Next: runmail, Prev: ftntoss, Up: Programs 1821 18223.29 runin -- Script for Processing Inbound Packets 1823=================================================== 1824 1825Usage: 1826 1827 runin 1828 1829No options. 1830 1831 Runs the tosser (unpack, toss, tick) for the inbound directories: 1832 1833 * Insecure inbound 1834 1835 * Secure inbound 1836 1837 * UUEncoded mail inbound 1838 1839 * FTP inbound 1840 1841 1842 All log messages are written to %G/log-in. 1843 1844 Edit the script `src/toss/runin.sh' to meet your local requirements. 1845 1846 1847File: fidogate.info, Node: runmail, Next: runnews, Prev: runin, Up: Programs 1848 18493.30 runmail -- Script for Processing Gateway Mail Output Packets 1850================================================================= 1851 1852Usage: 1853 1854 runmail 1855 1856No options. 1857 1858 Runs the tosser for the gateway mail output directory %S/outpkt/mail, 1859all log messages are written to %G/log-out. 1860 1861 Edit the script `src/toss/runmail.sh' to meet your local 1862requirements. 1863 1864 1865File: fidogate.info, Node: runnews, Next: runout, Prev: runmail, Up: Programs 1866 18673.31 runnews -- Script for Processing Gateway News Output Packets 1868================================================================= 1869 1870Usage: 1871 1872 runnews 1873 1874No options. 1875 1876 Runs the tosser for the gateway news output directory %S/outpkt/news, 1877all log messages are written to %G/log-out. 1878 1879 Edit the script `src/toss/runout.sh' to meet your local requirements. 1880 1881 1882File: fidogate.info, Node: runout, Next: runtoss, Prev: runnews, Up: Programs 1883 18843.32 runout -- Script for Processing Miscellaneous Output Packets 1885================================================================= 1886 1887Usage: 1888 1889 runout 1890 1891No options. 1892 1893 Runs the tosser for the miscellaneous (ftnafpkt, ftnafutil, 1894ftnoutpkt) output directory %S/outpkt, all log messages are written to 1895%G/log-out. 1896 1897 Edit the script `src/toss/runout.sh' to meet your local requirements. 1898 1899 1900File: fidogate.info, Node: runtoss, Next: rununpack, Prev: runout, Up: Programs 1901 19023.33 runtoss -- Script for Running the Tosser Programs 1903====================================================== 1904 1905Usage: 1906 1907 runtoss type 1908 1909No options. 1910 1911Types: 1912 1913 Please the the script source code `src/toss/runtoss.sh' for 1914available type parameters and feel free to adapt it to your 1915requirements. 1916 1917 1918File: fidogate.info, Node: rununpack, Next: ftnbsy, Prev: runtoss, Up: Programs 1919 19203.34 rununpack -- Script for Unpacking Inbound ArcMail Archives 1921=============================================================== 1922 1923Usage: 1924 1925 rununpack type 1926 1927No options. 1928 1929Types: 1930 1931 Please see the script source code `src/toss/rununpack.sh' for 1932available type parameters and feel free to adapt it to your 1933requirements. 1934 1935 Edit the script if necessary to change unpacker program names. The 1936required programs are `unzip', `unarj', `lha', `zoo', `arc', `rar'. 1937 1938 1939File: fidogate.info, Node: ftnbsy, Next: ftnconfig, Prev: rununpack, Up: Programs 1940 19413.35 ftnbsy -- Create/delete Binkley Busy Filess 1942================================================ 1943 1944Usage: 1945 1946 ftnbsy [-options] Z:N/F.P ... 1947 1948Options: 1949 1950`-t --test' 1951 Test for existing busy file. 1952 1953`-l --lock' 1954 Create busy file, fail if it already exists. 1955 1956`-u --unlock' 1957 Remove busy file. 1958 1959`-w --wait' 1960 Wait for busy file to be released (when `-l' option is given). 1961 1962 1963 1964File: fidogate.info, Node: ftnconfig, Next: ftnfattach, Prev: ftnbsy, Up: Programs 1965 19663.36 ftnconfig -- Retrieve information from FIDOGATE config files 1967================================================================= 1968 1969Usage: 1970 1971 ftnconfig [-options] parameter 1972 1973Options: 1974 1975`-l --no-newline' 1976 No output of newline after the parameter value. 1977 1978`-n --no-output' 1979 No output, exit code only. 1980 1981`-t --test-only' 1982 Output `1' if the parameter is present, `0' if not. 1983 1984 1985Special parameters: 1986 1987`=fqdn' 1988 Fully qualified domain name. 1989 1990`=hostname' 1991 Hostname. 1992 1993`=domainname' 1994 Domainname. 1995 1996`=hostsdomain' 1997 Domain for entries in `hosts' config files. 1998 1999 2000 2001File: fidogate.info, Node: ftnfattach, Next: ftnflo, Prev: ftnconfig, Up: Programs 2002 20033.37 ftnfattach -- Outbound file attaches 2004========================================= 2005 2006Usage: 2007 2008 ftnfattach [-options] Z:N/F.P file ... 2009 2010Options: 2011 2012`-B --binkley name' 2013 Set Binkley outbound directory. 2014 2015`-F --flavor name' 2016 Set flavor of outbound FLO file to name: `Hold', `Normal', 2017 `Direct', or `Crash'. 2018 2019 2020 The file name may start with `^' or `#', indicating that the file 2021should be deleted or truncated, respectively, after sending. 2022 2023 2024File: fidogate.info, Node: ftnflo, Next: ftnlock, Prev: ftnfattach, Up: Programs 2025 20263.38 ftnflo -- Process Binkley Outbound FLO Files and Attachments 2027================================================================= 2028 2029Usage: 2030 2031 ftnflo [-options] Z:N/F.P ... 2032 2033Options: 2034 2035`-B --binkley name' 2036 Set Binkley outbound directory. 2037 2038`-l --list' 2039 List entries in FLO file. 2040 2041`-n --no-delete' 2042 Don't delete FLO entries after processing. 2043 2044`-x --exec command' 2045 Execute command for every FLO entry, delete entry after successful 2046 processing. `%s' in command is replaced with the filename of the 2047 FLO entry. 2048 2049 2050 The file name may start with `^' or `#', indicating that the file 2051should be deleted or truncated, respectively, after sending. 2052 2053 2054File: fidogate.info, Node: ftnlock, Next: ftnlog, Prev: ftnflo, Up: Programs 2055 20563.39 ftnlock -- Create/Remove Lock Files 2057======================================== 2058 2059Usage: 2060 2061 ftnlock [-options] [NAME] [ID] 2062 2063Options: 2064 2065`-l --lock' 2066 Create lock file NAME, fail if it already exists (exit code=2). If 2067 NAME is not specified, the default `ftnlock' is used. The optional 2068 parameter ID specifies the contents of the lock file, the default 2069 is `-none-'. 2070 2071`-u --unlock' 2072 Remove lock file NAME. 2073 2074`-w --wait' 2075 Wait while creating lock file. Default: immediately return, if the 2076 lock file can't be created because it already exists. 2077 2078 2079 Lock files are created as %K/NAME. 2080 2081 2082File: fidogate.info, Node: ftnlog, Next: ftnoutpkt, Prev: ftnlock, Up: Programs 2083 20843.40 ftnlog -- Write Message to Log File 2085======================================== 2086 2087Usage: 2088 2089 ftnlog [-options] message text 2090 2091Options: 2092 2093`-p --program NAME' 2094 Set program name for logging. 2095 2096 2097 This program is used to write a log message from a shell script. The 2098log file name may be specified with the `FIDOGATE_LOGFILE' environment 2099variable. 2100 2101 2102File: fidogate.info, Node: ftnoutpkt, Next: ftnseq, Prev: ftnlog, Up: Programs 2103 21043.41 ftnoutpkt -- Create Fido Message Packets 2105============================================= 2106 2107Usage: 2108 2109 ftnoutpkt [-options] "user name @ z:n/f.p" "..." 2110 2111Options: 2112 2113`-f --from "user name @ z:n/f.p"' 2114 Set sender Fido address. 2115 2116`-s --subject "subject"' 2117 Set message subject. 2118 2119`-O --out-dir dir' 2120 Set output directory. Default: %S/outpkt 2121 2122 2123 This utility can be used to create native Fido messages. The message 2124body text is read from stdin. 2125 2126 2127File: fidogate.info, Node: ftnseq, Next: pktdebug, Prev: ftnoutpkt, Up: Programs 2128 21293.42 ftnseq -- Command Line Interface to Sequencer Files 2130======================================================== 2131 2132Usage: 2133 2134 ftnseq [-options] sequencer 2135 2136 This utilitity increments the named sequencer file and prints the 2137resulting value to stdout. Useful for accessing FIDOGATE sequencer files 2138from perl and shell scripts. 2139 2140 2141File: fidogate.info, Node: pktdebug, Next: pktmore, Prev: ftnseq, Up: Programs 2142 21433.43 pktdebug -- FTN mail packet debugger 2144========================================= 2145 2146Usage: 2147 2148 pktdebug [-options] file ... 2149 2150Options (standard options not supported): 2151 2152`-m --msg-header' 2153 Print message header. 2154 2155`-t --msg-text' 2156 Print message text. Implies `-m'. 2157 2158`-s --short' 2159 Print contents in short format: packet from/to address and number 2160 of NetMail and EchoMail messages. 2161 2162`-v --verbose' 2163 Increase verbose/debug level. 2164 2165`-h --help' 2166 Help on `pktdebug' usage. 2167 2168 2169 This utility displays the packet header and optionally the message 2170header and message body contents. 2171 2172 See also the `util/pktmore' utitility, which pipes the output of 2173`pktdebug' to `$PAGER'. 2174 2175 2176File: fidogate.info, Node: pktmore, Next: sumcrc, Prev: pktdebug, Up: Programs 2177 21783.44 pktmore -- Pager frontend for `pktdebug' 2179============================================= 2180 2181Usage: 2182 2183 pktmore file ... 2184 2185 `pktmore' uses the environment variable `PAGER' for the pager 2186program. Default: `more' 2187 2188 2189File: fidogate.info, Node: sumcrc, Next: Config files, Prev: pktmore, Up: Programs 2190 21913.45 sumcrc -- CRC Checksum Utility 2192=================================== 2193 2194Usage: 2195 2196 sumcrc [-options] file ... 2197 2198Options (standard options not supported): 2199 2200`-1 --skip-first-line' 2201 Skip first line in file. Useful for computing nodelist CRC. 2202 2203`-3 --crc32' 2204 Compute 32 bit CRC checksum, using the standard 32 bit polynomial 2205 (same as in ZModem, ZIP). Default: 16 bit CRC CCITT polynomial. 2206 2207`-6 --crc16' 2208 Use alternate 16 bit CRC16 polynomial. 2209 2210`-x --hex' 2211 Output CRC value in hex. Default: decimal 2212 2213`-z --eof-at-ctrl-z' 2214 The Ctrl-Z character (`^Z') indicates end-of-file (MSDOS kludge). 2215 2216`-v --verbose' 2217 Increase verbose/debug level. 2218 2219`-h --help' 2220 Help on `sumcrc' usage. 2221 2222 2223 Use `sumcrc -1z' to compute the checksum for a standard Fido 2224nodelist. See also the nodelist processing scripts in 2225`scripts/nodelist/nl-*'. 2226 2227 2228File: fidogate.info, Node: Config files, Next: Config, Prev: sumcrc, Up: Top 2229 22304 FIDOGATE Config Files 2231*********************** 2232 2233FIDOGATE uses the following config files: 2234 2235* Menu: 2236 2237* Config:: Main configuration file 2238* Hosts:: hosts FTN address to host name conversion 2239* Aliases:: aliases user aliases 2240* Areas:: areas FTN area to newsgroup conversion 2241* Bounce:: Bounce messages of `ftn2rfc' 2242* Passwd:: passwd password config file 2243* Routing:: routing file for `ftntoss' and `ftnroute' 2244* Packing:: packing file for `ftnpack' 2245* Areas.bbs:: areas.bbs EchoMail distribution 2246 2247 For all config files, a line starting with (some white space and) 2248`#' character is a comment and as well as an empty line completely 2249ignored. 2250 2251 All config files (with the execption of `areas.bbs' support an 2252`include' command for reading in other config files. `include' must be 2253the first keyword on the line, the filename is the next argument. 2254 2255 All options and config statements which take file or directory names 2256as arguments accept the following `%' abbreviations: 2257 2258`%C' 2259 CONFIGDIR 2260 2261`%L' 2262 LIBDIR 2263 2264`%N' 2265 BINDIR 2266 2267`%G' 2268 LOGDIR 2269 2270`%V' 2271 VARDIR 2272 2273`%K' 2274 LOCKDIR 2275 2276`%S' 2277 SPOOLDIR 2278 2279`%B' 2280 BTBASEDIR 2281 2282`%I' 2283 INBOUND 2284 2285`%P' 2286 PINBOUND 2287 2288`%U' 2289 UUINBOUND 2290 2291 2292File: fidogate.info, Node: Config, Next: Hosts, Prev: Config files, Up: Config files 2293 22944.1 Main Configuration File 2295=========================== 2296 2297`fidogate.conf' is the main configuration file for all FIDOGATE 2298programs. 2299 2300 NOTE: the new single configuration file replaces the different 2301configuration files `config.*' and `*.conf' of versions prior to 4.3.0. 2302 2303 The format of `fidogate.conf' is: 2304 2305 keyword [ arg ... ] 2306 2307 Keywords and arguments may be quoted in `""', keywords are 2308case-insensitive. 2309 2310 See `examples/orodruin/fidogate.conf' for an up-to-date commented 2311version of the new config file. 2312 2313Common configuration: 2314 2315`include file' 2316 Include another config file, may be nested. 2317 2318`ConfigDir directory' 2319 Directory for configuration files (default specified in 2320 `config.make'). 2321 2322`LibDir directory' 2323 Directory for FIDOGATE-internal binaries and support files (default 2324 specified in `config.make'). 2325 2326`BinDir directory' 2327 Directory for FIDOGATE user binaries and scripts (default 2328 specified in `config.make'). 2329 2330`LogDir directory' 2331 Directory for log files (default specified in `config.make'). 2332 2333`VarDir directory' 2334 Directory for variable state files such as `areas.bbs', 2335 `fareas.bbs', `history' (default specified in `config.make'). 2336 2337`LockDir directory' 2338 Directory for lock files (default specified in `config.make'). 2339 2340`SpoolDir directory' 2341 Internal spool directory for temporary files (default specified in 2342 `config.make'). 2343 2344`BTBaseDir directory' 2345 The BinkleyTerm-style outbound base directory, to be specified 2346 without the actual `out.'nnn zone directories (default specified 2347 in `config.make'). 2348 2349`Inbound directory' 2350 The BinkleyTerm-style unprotected inbound directory (default 2351 specified in `config.make'). 2352 2353`PInbound directory' 2354 The BinkleyTerm-style protected inbound directory (default 2355 specified in `config.make'). 2356 2357`UUInbound directory' 2358 The BinkleyTerm-style inbound directory for UUENCODEd packets 2359 (default specified in `config.make'). 2360 2361`FTPInbound directory' 2362 The BinkleyTerm-style inbound directory for FTP'ed packets (default 2363 specified in `config.make'). 2364 2365`Aliases file' 2366 Aliases configuration file (default specified in `config.make'). 2367 2368`Areas file' 2369 Areas configuration file (default specified in `config.make'). 2370 2371`Hosts file' 2372 Registered hosts configuration file (default specified in 2373 `config.make'). 2374 2375`Passwd file' 2376 Password configuration file (default specified in `config.make'). 2377 2378`Packing file' 2379 Packing configuration file (default specified in `config.make'). 2380 2381`Routing file' 2382 Routing configuration file (default specified in `config.make'). 2383 2384`History file' 2385 Dupe check history database file (default specified in 2386 `config.make'). 2387 2388`Logfile file' 2389 Standard log file (default specified in `config.make'). 2390 2391`CharsetMap file' 2392 Charset mapping table file (default specified in `config.make'). 2393 2394`LogFacility facility' 2395 2396`LogLevel level' 2397 Facility and level when using syslog for logging (`LogFile 2398 syslog'). NOT YET SUPPORTED: C programs use definition from 2399 `config.h', syslog support in Perl scripts (which use these 2400 settings) is currently commented out. 2401 2402`DosDrive drive directory' 2403 OPTIONAL: specify translation of a DOS drive (e.g. `H:') to a 2404 directory. This is useful, if you keep your outbound on a UNIX 2405 server and run BinkleyTerm on a DOS client. If one or more 2406 `DosDrive' statements are specified, FIDOGATE will automatically 2407 translate file attaches to the file names seen by the DOS client. 2408 Up to 16 `DosDrive' entries may be specified (`MAXDOSDRIVE' from 2409 `config.h'). 2410 2411`AreasBBS name' 2412 Specifies the `areas.bbs' EchoMail distribution file. 2413 2414`FAreasBBS name' 2415 Specifies the `fareas.bbs' file echo distribution file. 2416 2417 2418Internet address configuration: 2419 2420`Hostname name' 2421 The host name part of your Internet address. 2422 2423`Domain name' 2424 The domain part of your Internet address. 2425 2426`HostsDomain name' 2427 The domain used for entries in the `hosts' config file. Default is 2428 the same as `Domain'. 2429 2430 2431Fidonet address configuration: 2432 2433`Address node' 2434 The main Fidonet/FTN address (Z:N/F.P). There may be up to 32 2435 `Address' statements (`MAXADDRESS' from `config.h'). 2436 2437`GateAddress node' 2438 OPTIONAL: the Fidonet/FTN address of your gate, must be in the same 2439 order as the corresponding `Address' statements. There may be up to 2440 32 `GateAddress' statements. 2441 2442 If you're operating a Fido node, you may want to use a point 2443 addresse for your gateway to avoid name problems with local users 2444 and the gateway. If you're operating an official gateway in 2445 Fidonet or an Othernet, you normally have a separate node address 2446 for the gateway. 2447 2448`Zone zone domain ftndomain out' 2449 Specifies Internet domain domain, FTN domain ftndomain, and 2450 outbound directory out (relative to `BTBaseDir') for the FTN zone 2451 zone. zone may be `default', then this is the default entry for 2452 not explicitely specified zones. Up to 32 `Zone' entries may be 2453 specified (`MAXADDRESS' from `config.h'). 2454 2455 The gateway will only process mails from/to zones which are 2456 explicitly specified here. 2457 2458 2459Areafix configuration: 2460 2461`AreaFixMailer command' 2462 Mailer program used by `ftnaf' to send replies. 2463 2464`AreaFixCC user@domain' 2465 CC address added to replies sent by `ftnaf'. 2466 2467`AreaFixHelp file' 2468 Help file for Areafix programs (`%help') command. 2469 2470 2471Tosser configuration: 2472 2473`MaxMsg n' 2474 Set maximum number of messages in output files to n, restricting 2475 the maximum size of packets. See also `-m' option. 2476 2477`MaxOpenFiles n' 2478 Set maximum number of concurrently open packet files to n. 2479 Default: 10 (`MAXOPENFILES' from `config.h'), see also `-M' option. 2480 2481`MaxArc Kbyte' 2482 Maximum size of ArcMail archives created by `ftnpack'. See also 2483 `-m' option. 2484 2485`MinDiskFree Kbyte' 2486 Minimum free disk space required by the `runtoss' script. 2487 `runtoss' will terminate if there is less than Kbyte free disk 2488 space in SPOOLDIR. 2489 2490`DiskFreeMethod text' 2491 Method to determine free disk space: `prog' uses program specified 2492 with `DiskFreeProg', `none' doesn't do any disk space checking. 2493 2494`DiskFreeProg command' 2495 Command to determine free disk space, parameter `%p' is replace 2496 with path name of the directory to be checked. 2497 2498`KillEmpty' 2499 2500`KillBlank' 2501 Kill empty (blank) messages addressed to one of our AKAs. These are 2502 typically file attach and file request messages. 2503 2504`KillUnknown' 2505 Kill messages for unknown EchoMail areas (not listed in areas.bbs). 2506 2507`KillRouted' 2508 Kill routed EchoMail messages (not addressed to one of our AKAs). 2509 2510`KillInsecure' 2511 Kill insecure EchoMail messages (sender not listed in `areas.bbs'). 2512 2513`LogNetMail' 2514 2515`Track' 2516 Log all NetMail messages in log file. 2517 2518`CheckPath' 2519 Enable EchoMail circular path check (see `KillCircular'). 2520 2521`KillCircular' 2522 Kill EchoMail with circular path (own address already in `^APATH'). 2523 2524`DupeCheck' 2525 Enable dupe check (using `History' database). 2526 2527`MaxHistory days' 2528 Maximum length of history database. Keep entries for days days 2529 (decimal fraction allowed). 2530 2531`KillOld' 2532 Kill messages with date < now - `MaxHistory', i.e. treat as dupes. 2533 2534`KillDupe' 2535 2536`KillDupes' 2537 Kill duplicate EchoMail messages if `DupeCheck' is enabled. 2538 2539`KillNoMSGID' 2540 Kill EchoMail messages without a `^AMSGID', i.e. treat as dupes. 2541 2542`ZoneGate node seenby' 2543 Zone gate operation: strip SEEN-BYs for EchoMail addressed to node 2544 and replace with listed seenby nodes. seenby must include both the 2545 link's and our address. Example: 2546 2547 ZoneGate 1:105/42 105/42 2452/110 2548 2549`AddToSeenBy area nodes' 2550 Add the listed nodes to the SEEN-BYs for EchoMail tossed in area. 2551 area may be specified using shell-style wildcards `*?[a-z]'. 2552 2553`TossEchoMail4D' 2554 Generate 4D EchoMail control lines, i.e. SEEN-BY and PATH will 2555 include point addresses. 2556 2557`NoEmptyPath' 2558 Do not generate an empty PATH line. 2559 2560 2561Ticker configuration: 2562 2563`TickFlav flavour' 2564 Flavour of file attaches generated by `ftntick'. 2565 2566`FAttachFlav flavour' 2567 Flavour of file attaches generated by `ftnfattach'. 2568 2569`TickReplacedDir directory' 2570 Directory for old files replaced by `ftntick'. 2571 2572`UnknownTickArea area' 2573 File area to be used to TIC files with an unknown area. Incoming 2574 files with an unknown area will be moved to this unknown area's 2575 directory. 2576 2577 2578Gateway configuration: 2579 2580`Origin text' 2581 FTN default EchoMail origin line, the text used for the origins 2582 line generated by `rfc2ftn'. Quote text in `""' if it contains 2583 spaces. Individual origin lines may be specified in the `areas' 2584 file using the `-o' option. 2585 2586`Organization text' 2587 Organization header for mail and news generated by `ftn2rfc'. 2588 Quote text in `""' if it contains spaces. 2589 2590`UseOriginForOrganization' 2591 Put the text from the * Origin line (excluding the (z:n/f.p) 2592 address) into the Organization header. 2593 2594`UseOrganizationForOrigin' 2595 Put the text from the Organization header into the * Origin line. 2596 2597`UseXHeaderForTearline' 2598 Use text from `X-FTN-Tearline', `X-Mailer', `User-Agent', or 2599 `X-Newsreader' for the -- tearline. 2600 2601`UseFTNToAddress' 2602 Use FTN to address for mail addressed to the gateway without a To 2603 line, e.g. mail to 2604 Max Mueller 2:2452/110.2 2605 with a HOSTS entry 2606 2:2452/110.2 orodruin-ftn.fido.de 2607 is converted to 2608 To: Max_Mueller@orodruin-ftn.fido.de 2609 Without this option the standard local HOST.DOMAIN is used, e.g. 2610 To: Max_Mueller@orodruin.fido.de 2611 2612`EchoMail4D' 2613 Generate 4D EchoMail control lines, when the gateway operates at a 2614 point address. This is required when using the gateway and the 2615 tosser for a Fido point! 2616 2617`Gateway node' 2618 Specifies an FTN-Internet gateway for routing Internet mail to. If 2619 enabled, FIDOGATE can be used as the default delivery agent for all 2620 Internet mail. 2621 2622`DotNames' 2623 Generate User.Name@host.do.main instead of User_Name@host.do.main. 2624 `rfc2ftn' recognizes both address types. 2625 2626`KillUnknownMSGIDZone' 2627 Kill messages that contain a `^AMSGID' from an unknown zone (not 2628 listed in `Zone' statements). 2629 2630`KillNoMSGID' 2631 Kill messages that don't contain a `^AMSGID' kludge. 2632 2633`KillSplit' 2634 Kill messages that contain a `^ASPLIT' kludge. 2635 2636`X-FTN header' 2637 Include the various X-FTN header in the output of `ftn2rfc': 2638 `f' 2639 `X-FTN-From' 2640 2641 `t' 2642 `X-FTN-To' 2643 2644 `T' 2645 `X-FTN-Tearline' 2646 2647 `O' 2648 `X-FTN-Origin' 2649 2650 `V' 2651 `X-FTN-Via' 2652 2653 `D' 2654 `X-FTN-Domain' 2655 2656 `S' 2657 `X-FTN-Seen-By' 2658 2659 `P' 2660 `X-FTN-Path' 2661 `X-FTN-From' is required for the proper operation of `ftnaf'. 2662 2663`MaxMsgSize bytes' 2664 Maximum size of FTN messages (default value), larger messages will 2665 be split. 2666 2667`LimitMsgSize bytes' 2668 Maximum limit for messages (default value), larger messages will be 2669 bounced (mail) and simply not gated (news). 2670 2671`NoAddressInToField' 2672 Do not allow `@ ! %' chars in the FTN to field, thus preventing 2673 users from putting Internet addresses in the to field. 2674 2675`BounceCCMail user@do.main' 2676 Send CC of bounced messages to this address. 2677 2678`TrackerMail user@do.main' 2679 Forward mail from message trackers to this address. 2680 2681`HostsRestricted' 2682 Restrict usage of the gateway to FTN addresses listed in `hosts'. 2683 2684`FTNJunkGroup name' 2685 name of the FTN junk newsgroup (newsgroup for unknown FTN areas). 2686 2687`ErrorsTo user@do.main' 2688 Insert additional Errors-To header into Internet mails, sending 2689 bounced mails from gateway users to user@do.main. 2690 2691`AreasXlate area-chars newsgroup-chars' 2692 Automatic translation (-H option in `areas' file) of characters for 2693 Fido area <-> Internet newsgroup name conversion. 2694 2695`RFCLevel n' 2696 Set the default RFC level. See also `-R' option in `areas'. 2697 2698`NoFromLine' 2699 Don't generate `From:' header and FSC-0035 kludges. Must be set for 2700 a non-gateway, point FIDOGATE configuration. 2701 2702`NoFSC0035' 2703 Don't generate FSC-0035 `^AREPLYADDR', `^AREPLYTO'. 2704 2705`NoFSC0047' 2706 Don't generate FSC-0047 `^ASPLIT', use old ` * Large message split 2707 by ' ... text line. 2708 2709`FTNInSendmail command ...' 2710 Sendmail program to be run by `ftninpost' with options. The option 2711 `-fsender' will be automatically added by `ftninpost'. For 2712 compatibility with old FIDOGATE configurations, any `-f%s' option 2713 will be removed. 2714 2715`FTNInRnews command ...' 2716 Rnews program to be run by `ftninpost'. 2717 2718`FTNInRecombine' 2719 Automatically run `ftninrecomb' to recombine split messages. 2720 2721`NetMail8bit' 2722 Use the ISO-8859-1 MIME 8BIT character set when gating Fido 2723 NetMail. 2724 2725`NetMailQuotedPrintable' 2726 2727`NetMailQP' 2728 Use the ISO-8859-1 MIME QUOTED-PRINTABLE character set when gating 2729 Fido NetMail. `NetMailQuotedPrintable' overrides `NetMail8bit' if 2730 both are specified. 2731 2732`XFlagsPolicy' 2733 Controls policy for X-Flags processing (default is 0, no 2734 processing): 2735 `n N 0' 2736 No X-Flags processing at all. 2737 2738 `s S 1' 2739 X-Flags processing for local sender (check From and Received 2740 headers). This is not really secure!!! If your system is 2741 directly connected to the Internet and runs an SMTP daemon 2742 such as sendmail, mail can easily be faked to look like 2743 local!!! 2744 2745 `a A 2' 2746 X-Flags processing for all. Totally open, totally insecure!!! 2747 2748`DontUseReplyTo' 2749 Don't try to get real name from Reply-To header. Particularly 2750 useful for mailing lists which set the Reply-To header to the 2751 mailing list. 2752 2753`RFCAddrMode mode' 2754 Mode for RFC address generated by FIDOGATE: 2755 `() p 0' 2756 user@do.main (Real Name)-type addresses 2757 2758 `<> a 1' 2759 Real Name <user@do.main>-type addresses 2760 2761`ReplyAddrIfMailTX' 2762 Force `^AREPLYADDR' (if `FSC0035' is enabled) to only contains 2763 `^AREPLYADDR <user@do.main>' for compatibility with ifmail-TX. 2764 2765`CheckAreasBBS' 2766 Check `areas.bbs' when gating newsgroups, message for areas without 2767 downlinks will be skipped. 2768 2769`DefaultCharset default:ftn:rfc' 2770 Default character set mapping for the gateway: default is the 2771 charset assumed for FTN messages, if no `^ACHRS' kludge is present 2772 in the message. ftn is the charset to be used in the FTN messages 2773 when gating from RFC to FTN (use FSC-0054 names here), rfc likewise 2774 when gating from FTN to RFC (use RFC 2045 names here). See also the 2775 `-C' option in the `areas' config file. 2776 2777`NetMailCharset default:ftn:rfc' 2778 Like `DefaultCharset', but only for NetMail (mail) messages. 2779 2780`NetMailCharsetUse1st' 2781 If set and no matching in/out character set is found, `ftn2rfc' 2782 will use the first character set translation pair from 2783 `charset.map' with in charset = Fido `^ACHRS' and set the output 2784 character set accordingly. NOT YET IMPLEMENTED. 2785 2786`NewsPathTail string' 2787 String added to news Path header generated by `ftn2rfc', the 2788 de-facto standard is `not-for-mail'. Alternatively you can set this 2789 to `fidogate!not-for-mail' making the INN `newsfeeds' much easier 2790 and less error-prone, particularly for point systems. 2791 2792`SingleArticles' 2793 Write single articles to output RFC files generated by `ftn2rfc', 2794 not news batches containing several articles (batch is default). 2795 2796`Regex1stLine pattern' 2797 Regular expression patterns for finding addresses in the first 2798 line of the messages body. The first (...) sub-expression will be 2799 used for the address (like \1 in sed, $1 in perl). POSIX 2800 *extended* regular expressions are used. The OS must support 2801 `HAS_POSIX_REGEX' in `config.h'! 2802 2803 As of FIDOGATE 4.3.4, the compiled-in pattern matching code is no 2804 longer availabe. See `examples/orodruin/fidogate.conf' for a 2805 suitable list of regular expressions. 2806 2807`MessageLineLength number' 2808 Line length for formatting long paragraphs (no explicit line 2809 break) from Fido messages. This replaces the old `MAX_LINELEN' from 2810 `config.h'. The default value is 72. 2811 2812`DontIgnore0x8d' 2813 2814`DontIgnoreSoftCR' 2815 Normally, soft CR characters (hex 0x8d) in FTN messages are 2816 ignored. When this option is turned on, they are treated as normal 2817 characters. Useful e.g. for the cyrillic cp866 charset. 2818 2819`RegisteredHostsOnly' 2820 The opposite of the -i -ignore-hosts command line option, always 2821 requiring that a node is registered in the `hosts' list. NOT YET 2822 IMPLEMENTED. 2823 2824`RegisteredAliasesOnly' 2825 Allow only those addresses listed in `aliases', either 2826 alias@host.do.main or Full_Name@host.do.main, as valid recipients 2827 (also including postmaster) for `rfc2ftn'. 2828 2829 With this option, the gateway can be restricted to registered 2830 users, which is also very useful for fighting Spam. 2831 2832`SilentBounces' 2833 Causes EX_NOHOST, EX_NOUSER errors to return OK without any 2834 message. Useful in the never ending fight against spam, when your 2835 gateway is flooded with messages to unknown adresses, such as 2836 Fido.DE :-( 2837 2838 2839FFX configuration: 2840 2841 (FFX is a part of FIDOGATE, an uux-like mechanism for remote 2842execution, using a Fido mailer instead of UUCP for transport. This is a 2843special hack for my own purposes, most likely you don't want to know 2844anything about it. Simply ignore or remove this section from the config 2845file.) 2846 2847`FFXDataFlav flavour' 2848 Flavour to be used for file attachments created by the `ffx' 2849 program. 2850 2851`FFXDataCompr command ...' 2852 Program to be used for creating compressed `ffx' data files. 2853 2854`FFXDataExt parameter' 2855 File name extension to be used for compressed `ffx' data files. 2856 2857`FFXDataDecompr parameter' 2858 Uncompressor name for compressed `ffx' data files (will be run by 2859 `ffxqt'). 2860 2861`FFXDataComprN parameter' 2862 Program to be used for creating uncompress `ffx' data files (option 2863 `-n'). 2864 2865`FFXDataExtN parameter' 2866 File name extension to be used for uncompressed `ffx' data files 2867 (option `-n'). 2868 2869`FFXDataDecomprN parameter' 2870 Uncompressor name for uncompressed `ffx' data files (option `-n', 2871 will be run by `ffxqt'). 2872 2873`FFXCommand name command ...' 2874 List of command names and corresponding commands to be used by 2875 `ffxqt'. Only the commands listed can be executed. This replaces 2876 the old LIBDIR/ffxqt-dir/name structure of previous FIDOGATE 2877 versions. 2878 2879`FFXUncompress name command ...' 2880 List of uncompressor names and corresponding commands to be used by 2881 `ffxqt'. 2882 2883 2884 2885File: fidogate.info, Node: Hosts, Next: Aliases, Prev: Config, Up: Config files 2886 28874.2 `hosts' FTN Address to Host Name Conversion 2888=============================================== 2889 2890This file contains the FTN addresses and host names for registered FTN 2891nodes. If `HostsRestricted' is defined in `config.gate', this file 2892controls the access to the gateway. 2893 2894The format of this file is 2895 2896 node hostname [ options ] 2897 2898Fields: 2899 2900node 2901 FTN address. An address for a node will match all points of this 2902 node, see example below. 2903 2904hostname 2905 Host name, one of 2906 2907 local host name 2908 A name without a trailing `.' is a hostname in the local 2909 domain (specified by `HostsDomain' or default `Domain' in 2910 `config'). 2911 2912 fully qualified domain name 2913 A name with a trailing `.' is a fully qualified domain name 2914 for this node. 2915 2916 `-' 2917 A `-' specifies a listed node, but without a host name 2918 translation, using the standard p.f.n.z address. 2919 2920options 2921 2922 `-p' 2923 Generate addresses with point part, e.g. `p99.hippo.fido.de'. 2924 Default is omitting the point part. 2925 2926 `-d' 2927 Mark the node as down, mail to this address will be bounced 2928 with an appropiate error message. 2929 2930 2931 The `hosts' file is read into memory during startup of FIDOGATE. 2932The first entry found matches, so a host name for a point must be 2933specified before the boss node, if there are entries for both. 2934 2935 Example: 2936 2937`config': 2938 2939 HostsDomain .Fido.DE 2940 2941`hosts': 2942 2943 2:2452/110 hippo 2944 2:2452/990 test -p 2945 2:2452/991 test.wusel.org. 2946 2:2452/999 - 2947 2948Resulting data base read into memory: 2949 2950 Node: 2:2452/110.0 2951 Hostname: hippo.Fido.DE 2952 Flags: 2953 2954 Node: 2:2452/990.0 2955 Hostname: test.Fido.DE 2956 Flags: POINT 2957 2958 Node: 2:2452/991.0 2959 Hostname: test.wusel.org 2960 Flags: 2961 2962 Node: 2:2452/999.0 2963 Hostname: 2964 Flags: 2965 2966This results in the following conversion of addresses from FTN to 2967Internet: 2968 2969 2:2452/110 -> hippo.Fido.DE 2970 2:2452/110.99 -> hippo.Fido.DE 2971 2:2452/990.99 -> p99.test.Fido.DE 2972 2:2452/991.1 -> test.wusel.org 2973 2:2452/999.2 -> p2.f999.n2452.z2.Fido.DE 2974 2975 2976File: fidogate.info, Node: Aliases, Next: Areas, Prev: Hosts, Up: Config files 2977 29784.3 `aliases' User Aliases 2979========================== 2980 2981This file contains user aliases, the FTN address, and the full name of 2982the user. 2983 2984The format of this file is 2985 2986 alias node "full name" 2987 2988Fields: 2989 2990alias 2991 Alias for the user, can be a local `user' or a complete Internet 2992 address `user@do.main'. 2993 2994node 2995 FTN address of the user. 2996 2997full name 2998 Full name of the user. 2999 3000 3001 The FTN address node may be a point address. In this case mail 3002addressed to the user at the boss node address will be readdressed to 3003this point, see example below. 3004 3005 Example: 3006 3007`aliases': 3008 3009 mvr 2:2452/110.6 "Marc van.Rey" 3010 3011 Using the definitions from the section on `hosts', this results in 3012the following address conversion: 3013 3014 Marc van.Rey @ 2:2452/110.6 <-> mvr@hippo.Fido.DE 3015 3016 3017File: fidogate.info, Node: Areas, Next: Bounce, Prev: Aliases, Up: Config files 3018 30194.4 `areas' FTN Area to Newsgroup Conversion 3020============================================ 3021 3022This file contains FTN areas with corresponding newsgroups and options. 3023 3024The format of this file is 3025 3026 area newsgroup [ options ] 3027 3028Fields: 3029 3030area 3031 FTN area. 3032 3033newsgroup 3034 Usenet newsgroup. 3035 3036options 3037 IMPORTANT: there must be spaces between the option and its 3038 argument! 3039 3040 `-a address' 3041 Select alternate FTN address for this area/newsgroup. 3042 3043 `-z zone' 3044 Select zone AKA zone for this area/newsgroup. 3045 3046 `-d distribution' 3047 Use Usenet `distribution' for this newsgroup when gating from 3048 FTN to Internet. 3049 3050 `-o "origin"' 3051 Use an alternate origin line for this area when gating from 3052 Internet to FTN. (Default specified in `config'.) 3053 3054 `-g' 3055 Don't send messages from another SomeNet-FTN gateway across 3056 the gateway. 3057 3058 `-l' 3059 Only local crosspostings are allowed in this newsgroup/area. 3060 3061 `-x' 3062 No crosspostings are allowed in this newsgroup/area. 3063 3064 `-8' 3065 Use the ISO-8859-1 MIME 8BIT character set when gating to this 3066 newsgroup. 3067 3068 `-Q' 3069 Use the ISO-8859-1 MIME quoted-printable character set when 3070 gating to this newsgroup. 3071 3072 `-H' 3073 Area/newsgroup matches entire hierarchy. Names are converted 3074 automatically, using upper case for area names and lower case 3075 for newsgroups. 3076 3077 Example: 3078 GNU. gnu. -z 242 -H 3079 `gnu.announce' will be converted to `GNU.ANNOUNCE', 3080 `gnu.bug.gcc' to `GNU.BUG.GCC', similar for all other. 3081 3082 `-!' 3083 Don't gate this area/newsgroup or hierarchy (if combined with 3084 `-H'). Usefull to exclude certain newsgroups from a hierarchy 3085 for gating. 3086 3087 Example: 3088 ALT.BINARIES. alt.binaries. -z 242 -H -! 3089 ALT. alt. -z 242 -H 3090 This is roughly equivalent to INN's `alt.*,!alt.binaries.*'. 3091 Please note that the first `areas' entry matches, so any `-!' 3092 must be placed before the `-H' hierarchy definition. 3093 3094 `-R level' 3095 Select level of `^ARFC-'Header put into FIDO messages for this 3096 area. Level: 3097 0 3098 No `^ARFC-'header at all. 3099 3100 1 3101 Only important `^ARFC-'header. 3102 3103 2 3104 All `^ARFC-'header. 3105 3106 `-m bytes' 3107 Sets `MaxMsgSize' for this area (0 = no limit). 3108 3109 `-M bytes' 3110 Sets `LimitMsgSize' for this area (0 = no limit). 3111 3112 `-X "RFC-Header: text"' 3113 Add extra RFC header to output of `ftn2rfc'. Multiple `-X' 3114 options are possible. 3115 3116 `-C default:ftn:rfc' 3117 Set character set mapping table for this area, see 3118 `DefaultCharset' config option for details. 3119 3120 3121 3122 Only newsgroups listed in this file will be gated from Internet to 3123FTN. FTN area not listed in this file will be gated into the 3124`FTNJunkGroup' newsgroup specified in `fidogate.conf'. 3125 3126 3127File: fidogate.info, Node: Bounce, Next: Passwd, Prev: Areas, Up: Config files 3128 31294.5 Bounce Messages of `ftn2rfc' 3130================================ 3131 3132`ftn2rfc' uses the following files for messages sent to the FTN user 3133when bouncing mail for some reason: 3134 3135`bounce.noto' 3136 Message addressed to user `UUCP' or `GATEWAY' without a `To' line 3137 at the very beginning of the message. 3138 3139`bounce.down' 3140 Message addressed from/to node currently marked as down in `hosts' 3141 (`-d' flag). 3142 3143`bounce.restricted' 3144 Messages from nodes not listed in `hosts', gateway running in 3145 restricted mode. 3146 3147`bounce.insecure' 3148 Messages came via an insecure (i.e. not password protected) link 3149 and contain a `To' line. This requires the `-t' option to 3150 `ftn2rfc'. 3151 3152 3153 Within a bounce message, the following substitutions can be used: 3154 3155`%F' 3156 FTN address of message sender. 3157 3158`%T' 3159 FTN address of message recipient (the gateway, that is). 3160 3161`%O' 3162 FTN address of message origin. 3163 3164`%d' 3165 Date/time of message. 3166 3167`%t' 3168 Name of message recipient. 3169 3170`%f' 3171 Name of message sender. 3172 3173`%s' 3174 Message subject. 3175 3176`%R' 3177 `To' line, Internet address. 3178 3179`%M' 3180 The entire message body. 3181 3182 3183 3184File: fidogate.info, Node: Passwd, Next: Routing, Prev: Bounce, Up: Config files 3185 31864.6 `passwd' Password Config File 3187================================= 3188 3189This file contains passwords used by `ftnaf', `ffx', and the tosser 3190programs. 3191 3192The format of this file is: 3193 3194 context node password options 3195 3196Contexts: 3197 3198`packet' 3199 FTN packet passwords, checked by `ftntoss', inserted by all 3200 FIDOGATE programs which create FTN packets. Password checking for 3201 incoming packets is NOT YET IMPLEMENTED. 3202 3203`af' 3204 Areafix passwords for requests. 3205 3206`ff' 3207 Filefix passwords for requests and password for sending/receiving 3208 TIC files. 3209 3210`ffx' 3211 `ffx' command passwords, checked by `ffxqt', inserted by `ffx' 3212 into the `.ffx' command files. 3213 3214`uplink' 3215 Passwords for forwarding areafix/filefix request to uplink. 3216 3217 3218 Optional stuff (options) is used for `af' and `ff' permission 3219settings: 3220 3221 lvl key "Sysop Name" 3222 3223 lvl is the access level, which must be greater or equal than the one 3224in `areas.bbs'. key is the access key, which must be a super set of the 3225one in `areas.bbs'. 3226 3227 Optional stuff (options) is used for `uplink': 3228 3229 "name" 3230 3231 name is the user name (normally `Areafix' or `Areamgr') at node 3232address, where areafix requests must be forwarded to. Used by 3233`ftnafutil'. 3234 3235 Example: 3236 3237 uplink 2:2499/99 XXXXXXXX AreaMgr 3238 packet 2:1234/5678 WUERG 3239 ffx 242:1111/99 BLAHBLUB 3240 af 2:1234/5678 WUSEL 1 F "Test Sysop" 3241 ff 242:1234/5678 WUSEL 4 UQ "Yet Another Sysop" 3242 3243 3244File: fidogate.info, Node: Routing, Next: Packing, Prev: Passwd, Up: Config files 3245 32464.7 `routing' Config File 3247========================= 3248 3249This file contains the routing commands performed by `ftntoss' 3250(commands `remap' and `rewrite') and `ftnroute' (everything else). The 3251first routing command found matches. 3252 3253 The syntax of the `routing' commands is very similar to the routing 3254file used by the well-known FIDO tossers QMail and SQUISH. 3255 3256The format of this file is: 3257 3258 remap src-node dest-node name 3259 remapto src-node dest-node name 3260 remapx src-node prog name 3261 remapfrom src-node dest-node name 3262 rewrite src-node dest-node 3263 3264 echomail 3265 netmail 3266 3267 send flavor nodes 3268 route flavor dest-node nodes 3269 hostroute flavor nodes 3270 hubroute flavor nodes 3271 xroute flavor dest-node from-node to-node 3272 bossroute flavor nodes 3273 3274 change old-flavor new-flavor nodes 3275 3276 sendmove flavor nodes 3277 3278Commands: 3279 3280`remap' 3281 3282`remapto' 3283 Remaps NetMail addressed to name at src-node to the new address 3284 dest-node. Most useful for remapping to points based on their name. 3285 name supports shell-style wildcard patterns. Remapping to 0:0/0.0 3286 means killing the message. 3287 3288`remapx' 3289 Remaps NetMail addressed to name at src-node to special processing 3290 with prog (actually writing it to a packet in `%S/remapx/'prog. 3291 Most useful for processing areafix messages. name supports 3292 shell-style wildcard patterns. NOT YET IMPLEMENTED. 3293 3294`remapfrom' 3295 Remaps NetMail from name at src-node to the new address dest-node. 3296 name supports shell-style wildcard patterns. Remapping to 0:0/0.0 3297 means killing the message. 3298 3299`rewrite' 3300 Rewrites NetMail from and to addresses. A node address matching 3301 src-node will be changed to dest-node. 3302 3303`echomail' 3304 Starts routing commands for EchoMail. 3305 3306`netmail' 3307 Starts routing commands for NetMail. 3308 3309`allmail' 3310 Starts routing commands for both EchoMail and NetMail. NOT YET 3311 IMPLEMENTED. 3312 3313`send' 3314 Send normal mail addressed to nodes with flavor. 3315 3316 WARNING: e.g. `send hold 2:2452/110' actually is the same as 3317 `route hold 2:2452/110.0 2452/110.*'. So `send hold 2:2452/110 3318 110.*' will not have the desired effect, use `send hold 3319 2:2452/110.*' only instead!!! 3320 3321`route' 3322 Route normal mail addressed to nodes via dest-node, using flavor. 3323 3324`hostroute' 3325 Route normal mail addressed to nodes via their host (i.e. Z:N/0), 3326 using flavor. 3327 3328`hubroute' 3329 Route normal mail addressed to nodes via their hub, using flavor. 3330 NOT YET IMPLEMENTED. 3331 3332`xroute' 3333 Route normal mail from from-node to to-node via dest-node, using 3334 flavor. NOT YET IMPLEMENTED. 3335 3336`bossroute' 3337 Route flavor mail addressed to nodes via their boss node, not 3338 changing the flavor. 3339 3340`change' 3341 Change flavor of mail packet from old-flavor to new-flavor. 3342 3343`sendmove' 3344 Like `send', but `ftnroute' doesn't copy the mail packets, they 3345 are moved instead. This requires that SPOOLDIR/toss/tmp and 3346 SPOOLDIR/toss/out are on the same file system/disk drive. 3347 3348 3349 Node addresses nodes, src-node, dest-node support wildcards using 3350`*' and `all', which can be used for the zone, net, node, and point 3351component of an address. `*' alone matches all addresses. `rewrite' 3352wildcards in the destination address are replaced with the 3353corresponding component of the source address. 3354 3355The outbound flavor string flavor can be any of `normal', `hold', 3356`crash', `direct', `out', `hut', `cut', `dut'. 3357 3358 Example: 3359 3360 Remap 2:2452/110.0 2:2452/110.7 "Martin Koser" 3361 Rewrite 242:241/* 2:241/* 3362 3363 NetMail 3364 send hold 242:1000/1.all 3365 change crash hold 242:1000/1.all 2.all 3366 send hold 242:1000/3 3367 route hold 242:1000/50 51 52 53 54 55 56 57 58 59 3368 3369 3370File: fidogate.info, Node: Packing, Next: Areas.bbs, Prev: Routing, Up: Config files 3371 33724.8 `packing' Config File 3373========================= 3374 3375This file contains the packer (archiver) definitions and packing 3376commands for `ftnpack'. 3377 3378The format of this file is: 3379 3380 arc name `"'archiver`"' 3381 prog name `"'program`"' 3382 progn name `"'program`"' 3383 3384 pack name nodes 3385 rpack name dest-node nodes 3386 fpack name dest-node nodes 3387 dirpack dir name nodes 3388 3389Packer/program definitions: 3390 3391`arc' 3392 Defines the archiver name as program archiver. The archiver string 3393 must contain two `%s', the first one is replaced with the archive 3394 name, the second one with the packet name. 3395 3396`prog' 3397 3398`progn' 3399 Defines the program name as program. The program string must 3400 contain a `%s', which is replaced with the name of the packet to be 3401 processed. `prog' deletes the packet after successfully running 3402 `program', `progn' doesn't. 3403 3404 3405Packing definitions: 3406 3407`pack' 3408 Pack all mail addressed to nodes using the archiver defined as 3409 name. The archiver name `noarc' indicates that the mail packet 3410 should not be packed, but copied to the OUT file of the node. 3411 3412`rpack' 3413 Same as `pack', but pack all mail addressed to nodes to the 3414 archive for dest-node. 3415 3416`fpack' 3417 Similar to `rpack', but the packet is archived for the normal 3418 arcmail packet for each node. This archive is then attached to the 3419 FLO file of dest-node. 3420 3421`dirpack' 3422 Archive packets for nodes in special directory dir, not the 3423 standard outbound. 3424 3425 3426 Example: 3427 3428 arc zip "/usr/local/bin/zip -gkj %s %s" 3429 progn gate "/usr/lib/fidogate/ftn2rfc %s" 3430 progn areafix "/usr/lib/fidogate/ftnafpkt %s" 3431 3432 rpack zip 2:242/41 2:242/42 242:2000/* 254:*/* 3433 pack noarc 2:2452/110.1 242:4900/99 254:2410/6.1 3434 pack zip * 3435 3436 3437File: fidogate.info, Node: Areas.bbs, Next: Basic, Prev: Packing, Up: Config files 3438 34394.9 `areas.bbs' EchoMail Distribution 3440===================================== 3441 3442This file contains the EchoMail areas and linked nodes. The file 3443`fareas.bbs' is used for file echos. 3444 3445 The format of this file is as follows, the first line being ignored 3446for compatibility with the standard DOS AREAS.BBS. Individual fields 3447can be enclosed in "..." to allow spaces, in particular for the area 3448description. 3449 3450 [#]directory area [options] nodes 3451 3452# 3453 Marks area as pass-through, i.e. no packets for the own address 3454 (zone AKA or set by `-a') will be created. 3455 3456directory 3457 The directory where the message base/file base for this area is 3458 located. Currently FIDOGATE uses the directory for file areas 3459 only. 3460 3461area 3462 The area name. 3463 3464options 3465 Options for this area: 3466 `-a address' 3467 Set alternate FTN AKA for this area. 3468 3469 `-z zone' 3470 Set alternate zone AKA for this area. If not set, the zone 3471 information is taken from the first node in the nodes list. 3472 `ftnaf' will automatically rewrite `areas.bbs', inserting 3473 the `-z' option. 3474 3475 `-l lvl' 3476 Set Areafix/Filefix access level for this area. 3477 3478 `-k key' 3479 Set Areafix/Filefix access key for this area. 3480 3481 `-d "description"' 3482 Description for this area. Enclose in `"..."' to allow spaces 3483 in description text. 3484 3485 `-#' 3486 Set pass-through flag for this area (same as directory 3487 starting with `#'). 3488 3489 `-r' 3490 Set read-only flag for this area. New downlink will have a 3491 read-only status. NOT YET IMPLEMENTED. 3492 3493nodes 3494 The list of downlink nodes. This is a sorted short list of nodes 3495 as in FIDO EchoMail SEEN-BYs and PATH. The first node in nodes is 3496 the uplink and stays at this place, though. Do not put your own 3497 main address into the nodes list. (If the gateway has a different 3498 address, then it must be included in `nodes'!) 3499 3500 3501 3502File: fidogate.info, Node: Basic, Next: Sendmail, Prev: Areas.bbs, Up: Top 3503 35045 Basic Configuration 3505********************* 3506 3507There seems to be some confusion about the basic configuration of the 3508mail/news system, the gateway, and the tosser, so I added this chapter. 3509Hopefully this will help ... 3510 3511* Menu: 3512 3513* Sendmail:: Sendmail configuration 3514* Example Point:: Example point configuration 3515* Example Point 2:: Example configuration with 2 point addresses 3516* Example Node:: Example leaf node configuration 3517 3518 3519File: fidogate.info, Node: Sendmail, Next: Example Point, Prev: Basic, Up: Basic 3520 35215.1 Sendmail Configuration 3522========================== 3523 3524This section describes the FIDOGATE additions to the sendmail V8 m4 3525configuration. 3526 3527 FIDOGATE adds two new mailer files, `ftn.m4' and `ffx.m4'. Use 3528`MAILER(ftn)' and/or `Mailer(ffx)' to include these mailer definitions. 3529(See the comment above for what ffx is good for. Most likely you won't 3530need it.) 3531 3532 Please note that the new FIDOGATE mailers are based on the SMTP 3533mailer sender/recipient rewrite rules, so including `MAILER(smtp)' is 3534mandatory! 3535 3536FIDOGATE ftn mailers (using the `ftnmail' wrapper for `rfc2ftn'): 3537 3538`ftn' 3539 Mailer for sending to systems registered in the `hosts' config 3540 file. `ftn' will bounce mails if the receiving host is not 3541 registered or marked as down. 3542 3543`ftni' 3544 Mailer for sending to a typical p.f.n.z domain, e.g. 3545 `.fidonet.org'. `ftni' will send the mail to any system, 3546 regardless of the registration in `hosts'. 3547 3548`ftna' 3549 Like `ftni', but the `ftna' mailer also sets the address and 3550 uplink of the gateway to the relay host passed to this mailer. 3551 3552`ftno' 3553 Like `ftna'. In addition, this mailer sets the directory for 3554 packets created by `rfc2ftn' to SPOOLDIR/outpkt/relayhost. 3555 3556 3557FIDOGATE ffx mailer (using the `ffxmail' utitility): 3558 3559`ffx' 3560 Mailer for sending via the FIDOGATE ffx sub-system. 3561 3562 3563 3564File: fidogate.info, Node: Example Point, Next: Example Point 2, Prev: Sendmail, Up: Basic 3565 35665.2 Example Point Configuration 3567=============================== 3568 3569Please note that this point configuration uses the FIDOGATE tosser. 3570Thus, it's different from the point configuration described in Roland 3571Rosenfeld's old Point HOWTO!!! The Point HOWTO configuration will 3572definitely NOT work with FIDOGATE version 4!!! 3573 3574 Actually, this point configuration is very similar to the node 3575configuration described in the next section. 3576 3577 Let's assume the following addresses: 3578 3579 Fido point address 2:2499/999.9 3580 3581 Boss node (NetMail and EchoMail) 2:2499/999 3582 3583Address configuration `fidogate.conf' (gateway and point address are 3584the same!), gateway configuration `EchoMail4D' is stricly reqired: 3585 3586 ... 3587 Address 2:2499/999.9 3588 ... 3589 EchoMail4D 3590 ... 3591 3592Routing configuration `routing': mail for the local address on hold, 3593everything else is send to the boss node. 3594 3595 NetMail 3596 route hold 2:2499/999.9 3597 route normal 2:2499/999 1:* 2:* 3:* 4:* 5:* 6:* 3598 3599 EchoMail 3600 sendmove hold 2:2499/999.9 3601 sendmove normal * 3602 3603Packer configuration `packing': no packing (noarc, this is very 3604important) for own address, `zip' is the default archiver for 3605everything else. 3606 3607 arc zip "/usr/bin/zip -9gkjq %s %s" 3608 3609 pack noarc 2:2499/999.9 3610 pack zip * 3611 3612Next, the EchoMail areas must be listed in the `areas.bbs' file. Do not 3613put your point address into `areas.bbs'! Example with two areas (the 3614directory `X' is not used for EchoMail areas), which must be 3615non-passthrough: 3616 3617 Example Point!User Name 3618 X LINUX.GER 2:2499/999 3619 X UNIX.GER 2:2499/999 3620 3621 In the gateway configuration, these areas must be listed in the 3622`areas' config file: 3623 3624 LINUX.GER fido.ger.linux -8 3625 UNIX.GER fido.ger.unix -8 3626 3627 The example configuration files for this configuration can be found 3628in `examples/point/'. See also `scripts/run/runpoll' for a suitable 3629poll script, which does everything necessary for a FIDOGATE point. 3630 3631 3632File: fidogate.info, Node: Example Point 2, Next: Example Node, Prev: Example Point, Up: Basic 3633 36345.3 Example Configuration with 2 Point Addresses 3635================================================ 3636 3637This section describes a point setup with 2 different point addresses 3638and 2 different boss nodes. Thanks to Stephan Zellerhoff 3639<stephan@poi.westfalen.de> for contributing some stuff. 3640 3641 Let's assume the following addresses: 3642 3643 Primary point address 2:2499/999.9, boss node 2:2499/999 3644 3645 Secondary point address 2:2498/888.8, boss node 2:2498/888 3646 3647Setup with FIDOGATE: 3648 3649Addresses 3650 Put the following address statements in `fidogate.conf' 3651 Address 2:2499/999.9 3652 Address 2:2498/888.8 3653 Please note that the primary point address must be the first entry! 3654 3655Sendmail 3656 Use the sendmail `mailertable' feature and create the following 3657 entries for routing Fidonet mail: 3658 # Mail to 2:2498/*, secondary address 3659 .n2498.z2.fidonet.org ftna:p8.f888.n2498.z2.fidonet.org 3660 # Everything else 2:*/*, primary address 3661 .z2.fidonet.org ftna:p9.f999.n2499.z2.fidonet.org 3662 Please note that in this setup, the relay host specified with the 3663 `ftna' mailer is your own address, not your boss node!!! 3664 3665Areas 3666 Areas send to the primary boss don't require anything special in 3667 the `areas' config file, areas send to the secondary boss must 3668 have the `-a 2:2498/888.8' option, e.g. 3669 LINUX.GER fido.ger.linux -a 2:2498/888.8 -8 3670 3671Areas.BBS 3672 Likewise, areas send to the secondary boss must have the `-a 3673 2:2498/888.8' option in `areas.bbs' and the secondary boss as the 3674 uplink, e.g. 3675 X LINUX.GER -a 2:2498/888.8 2:2498/888 3676 3677Routing 3678 The netmail routing must be adapted to send mail to the secondary 3679 boss, e.g. everything for net 2498: 3680 NetMail 3681 route hold 2:2499/999.9 3682 route hold 2:2498/888.8 3683 3684 route normal 2:2498/888 2:2498/*.* 3685 route normal 2:2499/999 2:* 3686 3687 EchoMail 3688 sendmove hold 2:2499/999.9 2498/888.8 3689 sendmove normal * 3690 3691Packing 3692 Packer configuration `packing': no packing (noarc, this is very 3693 important) for all of our own addressess, `zip' is the default 3694 archiver for everything else. 3695 3696 arc zip "/usr/bin/zip -9gkjq %s %s" 3697 3698 pack noarc 2:2499/999.9 2498/888.8 3699 pack zip * 3700 3701 3702 Otherwise see the standard point configuration with a single address. 3703 3704 3705File: fidogate.info, Node: Example Node, Next: Usage, Prev: Example Point 2, Up: Basic 3706 37075.4 Example Leaf Node configuration 3708=================================== 3709 3710Let's assume the following addresses: 3711 3712 Fido main address 2:2499/999 3713 3714 Uplink (NetMail and EchoMail) 2:2499/900 3715 3716 Gateway point address 2:2499/999.1 3717 3718 Two points, Max Mueller @ 2:2499/999.10, Sabine Meier @ 2:2499/999.11 3719 3720Address configuration `fidogate.conf': 3721 3722 Address 2:2499/999 3723 GateAddress 2:2499/999.1 3724 3725Routing configuration `routing': NetMail for the two points will be 3726remapped to their point addresses, everything else to the gateway (where 3727you will be reading your mail). NetMail for all points is `send' onto 3728hold, everything else `route'd to your uplink. EchoMail is alway put 3729onto hold. 3730 3731 remap 2:2499/999.0 2:2499/999.10 "Max Mueller" 3732 remap 2:2499/999.0 2:2499/999.11 "Sabine Meier" 3733 remap 2:2499/999.0 2:2499/999.1 "*" 3734 3735 NetMail 3736 send hold 2:2499/999.* 3737 route normal 2:2499/900 1:* 2:* 3:* 4:* 5:* 6:* 3738 3739 EchoMail 3740 sendmove hold 2:2499/999.* 3741 sendmove normal * 3742 3743Packer configuration `packing': `noarc' packing for the gateway 3744address, `zip' is the default archiver for everything else. 3745 3746 arc zip "/usr/bin/zip -9gkjq %s %s" 3747 3748 pack noarc 2:2499/999.1 3749 pack zip * 3750 3751Next, the EchoMail areas must be listed in the `areas.bbs' file. Do not 3752put your node address into `areas.bbs'! Example with two areas, both 3753subscribed by the gateway and your points (the directory `X' is not 3754used for EchoMail areas): 3755 3756 Your system name!sysop name 3757 #X LINUX.GER 2:2499/900 999.1 .10 .11 3758 #X UNIX.GER 2:2499/900 999.1 .11 3759 3760 `#' denotes a passthrough area, i.e. no packets for the own address 3761(2:2499/999) are created. All EchoMail will be send to the gateway (.1). 3762 3763 In the gateway configuration, these areas must be listed in the 3764`areas' config file: 3765 3766 LINUX.GER fido.ger.linux -8 3767 UNIX.GER fido.ger.unix -8 3768 3769 For regular processing, the following scripts should be run from cron 3770every 20 min or so: 3771`rungate' 3772 Inbound gateway (Fido -> Internet and FTN -> FTN) processing 3773 3774`runin' 3775 Inbound tosser and ticker processing 3776 3777`runmail' 3778 Outbound gateway for mail (Internet -> Fido) processing. 3779 3780`runnews' 3781 Outbound gateway for news (Internet -> Fido) processing. 3782 3783`runout' 3784 Outbound packet processing (various sources). 3785 3786 3787 To use the areafix, the gateway and the mail system must be working. 3788You can then install suitable aliases in `/etc/aliases': 3789 3790 # Areafix/Filefix - FIDOGATE ftnaf 3791 areafix: "|/usr/lib/fidogate/ftnafmail" 3792 areamgr: areafix 3793 filefix: "|/usr/lib/fidogate/ftnafmail -F" 3794 filemgr: filefix 3795 3796 That's it. I hope that this short chapter on basic configuration 3797clarifies some of the darker point of the FIDOGATE configuration. 3798Anyway, please help to improve the FIDOGATE documentation. 3799 3800 3801File: fidogate.info, Node: Usage, Next: RFC Headers, Prev: Example Node, Up: Top 3802 38036 FIDOGATE Usage 3804**************** 3805 3806* Menu: 3807 3808* RFC Headers:: RFC Headers in FTN Messages 3809* X Headers:: X Headers in RFC Messages 3810 3811 3812File: fidogate.info, Node: RFC Headers, Next: X Headers, Prev: Usage, Up: Usage 3813 38146.1 RFC Headers in FTN Messages 3815=============================== 3816 3817FIDOGATE's `ftn2rfc' supports the following RFC headers at the start of 3818an FTN message. RFC headers must be the first text lines, max. 3 empty 3819lines before the RFC headers are allowed. Only one header line of each 3820type is allowed. 3821 3822`From: address' 3823 Sets From header line. If set and the `areas' flag `-g' is on, 3824 messages will not be gated, because they are considered comming 3825 from another FTN-RFC gateway. 3826 3827`Reply-To: address' 3828 Sets Reply-To header line. 3829 3830`To: address' 3831 Sets To header line. 3832 3833`Cc: address' 3834 Sets Cc header line. 3835 3836`Bcc: address' 3837 Sets Bcc header line. 3838 3839`Newsgroups: groups' 3840 Sets Newsgroups header line. NOT YET IMPLEMENTED. 3841 3842`Sender: address' 3843 Sets Sender header line. NOT YET IMPLEMENTED. 3844 3845`Content-Transfer-Encoding: 7bit | 8bit | quoted-printable' 3846 Sets content encoding type, overriding the default configured in 3847 `fidogate.conf' (`NetMail8bit', `NetMailQuotedPrintable') or 3848 `areas' (`-8', `-Q'). 3849 3850 3851 `ftn2rfc' sends mail to all addresses listed in To, Cc, and Bcc. It 3852support the RFC1036 standard address formats: 3853 3854 user@do.main 3855 user@do.main (Real Name) 3856 Real Name <user@do.main> 3857 3858 Multiple addresses can be separated by a `,'. 3859 3860 3861File: fidogate.info, Node: X Headers, Next: Index, Prev: RFC Headers, Up: Usage 3862 38636.2 X Headers in RFC Messages 3864============================= 3865 3866FIDOGATE's `rfc2ftn' supports the following X headers in RFC messages: 3867 3868`X-Comment-To: name' 3869 Use for the recipient's name in news articles. 3870 3871`X-Flags: flags' 3872 3873 `c' 3874 Message is crash. 3875 3876 `p' 3877 Message is private (default for mail). 3878 3879 `h' 3880 Message is hold. 3881 3882 `f' 3883 Subject contains file attachment name. 3884 3885 `r' 3886 Sets return receipt request. 3887 3888 `m' 3889 Generates a FTN style `^MSGID', i.e. `^AMSGID: 'Z:N/F.P 3890 1234abcd. In addition, no `^AREPLY' kludge is generated. THIS 3891 FLAG IS NOT RECOMMENDED FOR NORMAL OPERATION!!! 3892 3893 `n' 3894 Do not generate a From line, and the `^AREPLYADDR', `REPLYTO' 3895 kludges. 3896 3897 3898 3899File: fidogate.info, Node: Index, Prev: X Headers, Up: Top 3900 3901Index 3902***** 3903 3904[index] 3905* Menu: 3906 3907* Aliases: Aliases. (line 6) 3908* ArcMail: ftnpack. (line 6) 3909* Areafix <1>: ftnafmail. (line 6) 3910* Areafix: ftnaf. (line 6) 3911* Areas: Areas. (line 6) 3912* areas.bbs: Areas.bbs. (line 6) 3913* Bounce messages: Bounce. (line 6) 3914* Busy files: ftnbsy. (line 6) 3915* Checksum: sumcrc. (line 6) 3916* Compiling: Compiling. (line 6) 3917* Config <1>: Config. (line 6) 3918* Config: ftnconfig. (line 6) 3919* Config files: Config files. (line 6) 3920* Configuration <1>: Example Node. (line 6) 3921* Configuration <2>: Example Point 2. (line 6) 3922* Configuration <3>: Example Point. (line 6) 3923* Configuration <4>: Sendmail. (line 6) 3924* Configuration: Basic. (line 6) 3925* Connecting: Connecting. (line 6) 3926* CRC: sumcrc. (line 6) 3927* EchoMail: Areas.bbs. (line 6) 3928* Example <1>: Example Node. (line 6) 3929* Example <2>: Example Point 2. (line 6) 3930* Example: Example Point. (line 6) 3931* ffx: ffx. (line 6) 3932* ffxmail <1>: ffxnews. (line 6) 3933* ffxmail: ffxmail. (line 6) 3934* ffxqt <1>: runffx. (line 6) 3935* ffxqt <2>: ffxrmail. (line 6) 3936* ffxqt: ffxqt. (line 6) 3937* ffxrmail: ffxrmail. (line 6) 3938* fidogate.conf: Config. (line 6) 3939* FIDONET: Connecting. (line 6) 3940* File attach: ftnfattach. (line 6) 3941* ftn2ftn: ftn2ftn. (line 6) 3942* ftn2rfc <1>: ftnin. (line 6) 3943* ftn2rfc: ftn2rfc. (line 6) 3944* ftnaf <1>: ftnafmail. (line 6) 3945* ftnaf: ftnaf. (line 6) 3946* ftnafpkt: ftnafpkt. (line 6) 3947* ftnafutil: ftnafutil. (line 6) 3948* ftnbsy: ftnbsy. (line 6) 3949* ftnconfig: ftnconfig. (line 6) 3950* ftnexpire: ftnexpire. (line 6) 3951* ftnfattach: ftnfattach. (line 6) 3952* ftnflo: ftnflo. (line 6) 3953* ftnhatch: ftnhatch. (line 6) 3954* ftnin: ftnin. (line 6) 3955* ftninpost: ftninpost. (line 6) 3956* ftninrecomb: ftninrecomb. (line 6) 3957* ftnlock: ftnlock. (line 6) 3958* ftnlog: ftnlog. (line 6) 3959* ftnmail: ftnmail. (line 6) 3960* ftnoutpkt: ftnoutpkt. (line 6) 3961* ftnpack: ftnpack. (line 6) 3962* ftnroute: ftnroute. (line 6) 3963* ftnseq: ftnseq. (line 6) 3964* ftntick: ftntick. (line 6) 3965* ftntickpost: ftntickpost. (line 6) 3966* ftntoss: ftntoss. (line 6) 3967* Gateway <1>: ftn2ftn. (line 6) 3968* Gateway <2>: rfc2ftn. (line 6) 3969* Gateway: ftn2rfc. (line 6) 3970* Header <1>: X Headers. (line 6) 3971* Header: RFC Headers. (line 6) 3972* Hosts: Hosts. (line 6) 3973* Installation <1>: Compiling. (line 6) 3974* Installation: Installation. (line 6) 3975* Integration: Integration. (line 6) 3976* Introduction <1>: Introduction. (line 6) 3977* Introduction: Top. (line 6) 3978* Lock files: ftnlock. (line 6) 3979* Log file: ftnlog. (line 6) 3980* Logging: ftnlog. (line 6) 3981* Mail <1>: ffxnews. (line 6) 3982* Mail: ffxmail. (line 6) 3983* Node: Example Node. (line 6) 3984* Packing: Packing. (line 6) 3985* Password: Passwd. (line 6) 3986* pktdebug: pktdebug. (line 6) 3987* pktmore: pktmore. (line 6) 3988* Point <1>: Example Point 2. (line 6) 3989* Point: Example Point. (line 6) 3990* Programs: Programs. (line 6) 3991* Remote Execution: ffxqt. (line 6) 3992* Remote execution: ffx. (line 6) 3993* RFC header: RFC Headers. (line 6) 3994* rfc2ftn: rfc2ftn. (line 6) 3995* Routing <1>: Routing. (line 6) 3996* Routing: ftnroute. (line 6) 3997* runffx: runffx. (line 6) 3998* rungate: rungate. (line 6) 3999* runin: runin. (line 6) 4000* runmail: runmail. (line 6) 4001* runnews: runnews. (line 6) 4002* runout: runout. (line 6) 4003* runtoss: runtoss. (line 6) 4004* rununpack: rununpack. (line 6) 4005* send-ffx: send-ffx. (line 6) 4006* send-fidogate: send-fidogate. (line 6) 4007* sendmail: Sendmail. (line 6) 4008* sumcrc: sumcrc. (line 6) 4009* Testing: Testing. (line 6) 4010* Tossing <1>: rununpack. (line 6) 4011* Tossing <2>: runtoss. (line 6) 4012* Tossing <3>: runout. (line 6) 4013* Tossing <4>: runnews. (line 6) 4014* Tossing <5>: runmail. (line 6) 4015* Tossing <6>: runin. (line 6) 4016* Tossing: ftntoss. (line 6) 4017* Usage: Usage. (line 6) 4018* X header: X Headers. (line 6) 4019 4020 4021 4022Tag Table: 4023Node: Top764 4024Node: Introduction4856 4025Node: Installation7393 4026Node: config.h8210 4027Node: config.make13868 4028Node: Compiling19772 4029Node: Integration20426 4030Node: Testing20913 4031Node: Connecting21161 4032Node: Programs22152 4033Node: ftnaf25737 4034Node: ftnafmail28483 4035Node: ftnafpkt29084 4036Node: ftnafutil30343 4037Node: charsetc31411 4038Node: ffx31672 4039Node: ffxmail32453 4040Node: ffxnews32863 4041Node: ffxqt33262 4042Node: ffxrmail33786 4043Node: runffx34169 4044Node: send-ffx34372 4045Node: ftn2rfc34667 4046Node: ftnin35910 4047Node: ftninpost36507 4048Node: ftninrecomb36889 4049Node: ftnmail37266 4050Node: rfc2ftn37835 4051Node: rungate38928 4052Node: send-fidogate39147 4053Node: ftnhatch39532 4054Node: ftntick40083 4055Node: ftntickpost40655 4056Node: ftn2ftn41064 4057Node: ftnexpire42119 4058Node: ftnpack42991 4059Node: ftnroute44707 4060Node: ftntoss45417 4061Node: runin46887 4062Node: runmail47391 4063Node: runnews47836 4064Node: runout48281 4065Node: runtoss48754 4066Node: rununpack49139 4067Node: ftnbsy49685 4068Node: ftnconfig50159 4069Node: ftnfattach50827 4070Node: ftnflo51369 4071Node: ftnlock52126 4072Node: ftnlog52824 4073Node: ftnoutpkt53262 4074Node: ftnseq53804 4075Node: pktdebug54223 4076Node: pktmore55002 4077Node: sumcrc55304 4078Node: Config files56244 4079Node: Config57547 4080Node: Hosts76215 4081Node: Aliases78455 4082Node: Areas79333 4083Node: Bounce82474 4084Node: Passwd83679 4085Node: Routing85277 4086Node: Packing89190 4087Node: Areas.bbs91115 4088Node: Basic93153 4089Node: Sendmail93679 4090Node: Example Point95092 4091Node: Example Point 297149 4092Node: Example Node99683 4093Node: Usage102621 4094Node: RFC Headers102840 4095Node: X Headers104210 4096Node: Index105065 4097 4098End Tag Table 4099