-*- TEXT -*-

  \dots another c_filter trial
  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~

  Copyright 1997, Jose Luis Marquez Regueiro, EB4ECF

  AX25-mail: eb4ecf@ea4po.eaba.esp.eu
  ampr-mail: jose@eb4ecf.ampr.org
     e-mail: jmarreg@etsi.tel.uva.es
             eb4ecf@axis.org

 This script may be distributed or modified only under the terms of
 the GNU General Public License as published by the Free Software
 Foundation, which may be found with this file.

 This perl script is a trial to implement a c_filter bbs password
 system for f6fbb Linux BBS, v7.00. It's still in alpha state. It's
 not a very elegant code but it works. Any error reports, fixes
 or comments, are wellcome. I hope it works for you ;-)
              ~~~~~~~~~~~~

 Features:           (see the configuration file: c_filter.cnf)
 ~~~~~~~~~
  for unknown users, you can configure the system as
   * disconnect
   * fully open bbs
   * held messages mode bbs
   * read only bbs

  for each declared user, you can configure the password as
   * standard 5 letters password
   * the MD2 (c)RSA (*)
   * both the standard 5 letters password and the MD2 (c)RSA
   * simple string validation (silly password)

  for each declared user, at connecting time, also
   * disconnect
   * fully open bbs
   * held messages mode bbs
   * read only bbs

  You can define ports not to be filtered by the script (as a telnet port)
  The console conections will never  be filtered.

 Installation:
 ~~~~~~~~~~~~~
 Into the distribution directory, do (bash):

    export FBBHOME=/usr/local/fbb --> replace it by your fbb soft home
    make install

 ... or, by hand:

 * the c_filter script must be in the fbb/bin directory
 * the configuration file, c_filter.cnf, must be in the fbb/system directory
 * the md2 binary must be in the fbb/bin directory

 Configuration:
 ~~~~~~~~~~~~~~
 The configuration is done by editing the c_filter.cnf file. It's
 self-explanatory.

 Just remember:
        * The password string must have at least, 5 characters
          long, and mustn't contain either the character ':' (colon) or
          tab character.

        * All password entry (lines) must have a valid password string.

        * A valid password string must start with a valid ASCII character.
        * ... should be ended with a valid ASCII character, either.

        * Don't forget that your system can be personalized by
          editing the configurable messages ("strings").

 ------

 External requeriments: F6FBB Linux BBS and MD2(*) generator (RFC 1319)

 The perl version used:

 (RED-HAT perl-5.003-5.rpm)

 >baluba:~/work/fbb_filters/c_filter.perl$ perl -v
 >
 >This is perl, version 5.003 with EMBED
 >      built under linux at Oct 18 1996 10:17:50
 >      + suidperl security patch
 >
 >Copyright 1987-1996, Larry Wall
 >
 > ...

 ------

(*) "RSA Data Security, Inc. MD2 Message Digest Algorithm"


  -----------------------------------------------------
    NOTE: this isn't still a full "released" version.
  -----------------------------------------------------