home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / bbs / bnp_v762.zip / BNP.DOC next >
Text File  |  1994-02-19  |  16KB  |  381 lines
  1.  
  2.         Black-Hole Netmail Masher/Packer
  3.         Version 6.72 - Release Version.  No Key Required
  4.  
  5.         Written by Nathan Moschkin
  6.         Copyright (C) 1994 by Nathan Moschkin
  7.         Copyright is for program and documentation
  8.  
  9.         Thanks to my small widdle beta team (John Hulley-Miller, Rick
  10.         Giguere, Andrew Leary and Ryan Murray)
  11.  
  12.  
  13.         Disclaimer and Copyright
  14.         ------------------------
  15.  
  16.           This program has no garantees, no warentees, no nothing.  Use it
  17.           as is, and that's that.  Do not copy this program in anything
  18.           other than the original ARJ archive created by Nathan Moschkin.
  19.  
  20.           This material is Copyright (C) 1994 by Nathan Moschkin.
  21.           Thank you very much for you attention.
  22.  
  23.  
  24.         What is BNP?
  25.         ------------
  26.  
  27.           BinkleyTerm netmail packer is a medium sized netmail handler.
  28.           Squish can get the job done, but it's 200k, oMMM is 80k but
  29.           doesn't do what this does, handle 4D point numbers.  BNP will
  30.           automatically create and remove point directories.  Other
  31.           features include:
  32.  
  33.              .BSY flags supported.
  34.              Squish message base.
  35.              Removal of unused .PNT directories.
  36.              Enhanced routing commands.
  37.              Suppressed screen writes for external archivers.
  38.              Removal of NULL or SEMI-NULL messages.
  39.              Support for INTL and FMPT/TOPT kludge lines.
  40.              InTransit message options.
  41.  
  42.              ...and more stuff I can't name off the top of my head.
  43.  
  44.         Shareware vs. Freeware
  45.         ----------------------
  46.  
  47.           BinkleyTerm Netmail Packer (henceforth referred to as BNP) does
  48.           not REQUIRE registration.  If you still wish to register by
  49.           donating money, just send it to:
  50.  
  51.                    Nathan Moschkin
  52.                    10300 Brunswick Ave
  53.                    Wheaton, MD  20902-4808
  54.  
  55.                    Make Check Payable To: Nathan Moschkin
  56.  
  57.           If you are a user running this on a commercial site or for a
  58.           purpose intended to make a profit, you MUST call me voice and
  59.           discuss the commercial registration.  You must register
  60.           commercially if you are going to run this software on a commercial
  61.           site!  Commercial registration provides for added security in
  62.           BNP.
  63.  
  64.           BinkleyTerm Netmail Packer is NOT PUBLIC DOMAIN.  It is FREEWARE,
  65.           meaning product support, updates, and product itself is provided
  66.           free of charge upon request.
  67.  
  68.         System Requirements
  69.         -------------------
  70.  
  71.           BNP will run on a 80286, 80386 or 80486 machine with at least
  72.           256k of free memory.  A mailer and hard drive would be nice too.
  73.  
  74.           BNP works with BinkleyTerm, OPUS-CBCS or Portal of Power.
  75.           Because of the nature of FrontDoor and D'Bridge, BNP will not
  76.           work with them, it's not in the design.  BNP was compiled using
  77.           Microsoft C++ 7.00 (BNPMSC.EXE) or Borland C++ 3.1 (BNPBC.EXE)
  78.           and will work on any PC using IBM or Microsoft DOS 3.30 or
  79.           later.
  80.  
  81.           BNP's maximum message size is 32k.
  82.  
  83.        Documentation
  84.        -------------
  85.  
  86.           Everything is documented in the appropriate file, this is a
  87.           fairly self explanitory program.
  88.  
  89.           BNP will automatically reroute/repack .FLO and .OUT files.
  90.  
  91.    Inside the BNP ARJ you will find CONFIG.BNP which is your configuration
  92.    file.  Here is a description of every configuration command.
  93.  
  94.         ADDRESS zone:net/node[.point][@domain]
  95.  
  96.                 Your fidonet technology address.  You must specify zone,
  97.                 net and node.  Point is optional.  You may specify 100
  98.                 logical/sensable addresses.  No wildcard addresses allowed.
  99.  
  100.         NETMAIL {FTSC} {Squish} {JAM} d:\path\filename
  101.  
  102.                 You must specify a path to netmail.  Just insert the drive
  103.                 and path statements in the NETMAIL line:
  104.  
  105.                      NETMAIL FTSC d:\mail\netmail\
  106.  
  107.                 If you are using a Squish message base, insert the word
  108.                 "Squish" without quotes, a space, and then the path and
  109.                 filename to the Squish message directory
  110.  
  111.                      NETMAIL Squish d:\max\msg\net
  112.  
  113.                 Similarly, you can specify a message base to be JAM
  114.                 compatible, you would add the word "JAM" without quotes:
  115.  
  116.                      NETMAIL JAM c:\ra\msg\netmail
  117.  
  118.                 NOTE: AS OF v6.72, JAM HAS NOT BEEN IMPLEMENTED
  119.  
  120.                 You may specify up to 10 individual netmail areas.
  121.                 Any area can be of any type.
  122.  
  123.         OUTBOUND d:\path
  124.  
  125.                 Specifies path where outbound packets are stored.  In the
  126.                 case of zone and point differentiations, new outbound areas
  127.                 may automatically be created.
  128.  
  129.         SYSOP name
  130.  
  131.                 Specifies your name.  This is used in conjunction with the
  132.                 "RegistrationKey" parameter, which is case-sensative.
  133.  
  134.         REGISTRATIONKEY nnnnn
  135.  
  136.                 Specifies the registration key for your copy of BNP.  The
  137.                 registration key is either a beta-test unlock key or a
  138.                 COMMERCIAL SITE key.  This means that if you purchase
  139.                 the commercial version of BNP, you must use the COMMERCIAL
  140.                 KEY to activate it.  The commercial key and the beta key
  141.                 are two different and distinct keys.  BNP and BNP-
  142.                 COMMERCIAL have two entirely different unlock keys built
  143.                 into them.
  144.  
  145.         MAXARCSIZE nnnn
  146.  
  147.                 Specifies the size, in kilobytes, for the maximum archive
  148.                 size, BNP will not add to bundles exceeding this limit.
  149.  
  150.         LOGFILE [d:\path\]filename.ext
  151.  
  152.                 Specifies what file to write log entries to.  If this
  153.                 parameter is omitted, BNP will make no attempts to write
  154.                 to any sort of log file.
  155.  
  156.         VLOGFILE [d:\path\]filename.ext
  157.  
  158.                 Specifies what file BNP will write verbose log entries
  159.                 to.  This gives extended information like message date/time
  160.                 and exact routing information.
  161.  
  162.         ROUTEFILE [d:\path\]filename.ext
  163.  
  164.                 Specifies where to look for a routing file.  You must have
  165.                 one, this is not an option.  ROUTE.BNP is included as an
  166.                 example.
  167.  
  168.         KILLOLD nnnn
  169.  
  170.                 This directs BNP to kill mail older than [nnnn] days.  This
  171.                 is a very destructive feature and should only be used in
  172.                 areas where space is limited.
  173.  
  174.         GRUNGY {ignore} {delete} {exclude}
  175.  
  176.                 This parameter activates GRUNGY, the grunged message
  177.                 processor.  GRUNGY will produce a GRUNGY.RPT file notifying
  178.                 you of the messages that were grunged.
  179.                 This has three options.
  180.  
  181.                 delete:  kills all grunded messages.
  182.                 ignore:  will keep all grunged messages in place, but will
  183.                          still produce a GRUNGY.RPT
  184.                 exclude: do not include grunged messages in the packet,
  185.                          but do not delete from the message area.
  186.  
  187.         QUIET
  188.                 Specifies operations in supressed screen writes mode.
  189.  
  190.         PKTTYPE {TYPE2} {TYPE2} {TYPE2.2 [DOMAIN]}
  191.  
  192.                 Specifies in which FTSC packet format to pack mail.
  193.                 FTSC-0001 (type 2).
  194.                 FTSC-0039 (type 2+).
  195.                 FTSC-0045 (type 2.2) & Optional domain support.
  196.  
  197.                 If you want to use BNP's domain support, then first of all
  198.                 you must be running under the FTSC-0045 format.  Second,
  199.                 add the option DOMAIN to the end of that line.
  200.  
  201.                 e.g: PKTTYPE TYPE2.2 DOMAIN
  202.  
  203.                 FTSC-0001 is, for all intents and purposes, STONEAGED.
  204.  
  205.         PACKER_DEF # commands
  206.  
  207.                 You must specify at least one archiver.  Where '#' is any
  208.                 character of the IBM ASCII character set.  This can be only
  209.                 ONE character in length, though, or BNP will report ERROR.
  210.  
  211.         PACKUP # node1 [node2] [node3] [node4]
  212.  
  213.                 Specifies to pack mail to the specified nodes using the
  214.                 specifies compressor.
  215.  
  216.         BINKLEY
  217.  
  218.                 Specifies that the mailer you are using is BinkleyTerm or
  219.                 Opus
  220.  
  221.         PORTAL
  222.  
  223.                 Specifies that yhe mailer you are using is Portal of Power.
  224.                 This only applies with IMMEDIATE packets.
  225.  
  226.         KILL    {NONE} {ALL} {NORMAL} {INTRANSIT}
  227.  
  228.                 Specifies whether BNP should kill all sent messages or
  229.                 not to kill any sent message, regardless of attribute
  230.                 setting.  If this option is omitted, killing is done
  231.                 only when killsent status is enabled on the message.
  232.  
  233.                 If you specify kill intransit, then BNP will kill the
  234.                 message only if the destination and origination addresses
  235.                 do not match any of your addresses defined in BNP.
  236.  
  237.         BSY_FLAG
  238.  
  239.                 This will instruct BNP to create .BSY flags so that
  240.                 BinkleyTerm will not process mail for that node.
  241.  
  242.         PKT_PASS zone:net/node[.point] password
  243.  
  244.                 This specifies that all nodes that are found under this
  245.                 search specification will be password-protected with
  246.                 this password.  Wildcard addresses allowed.
  247.  
  248.         SEMAPHORE d:\path
  249.  
  250.                 Specifies what directory semaphore files are created
  251.                 and searched for.
  252.  
  253.         KILLNULL [DwarZ]
  254.  
  255.                 Specifies that no matter what status the "KILL" is set to
  256.                 that all messages without a text body will be killed.
  257.  
  258.                 If the "DwarZ" option is activated, messages that are made
  259.                 by DwarZ (C) are deleted.
  260.  
  261.         MAXSIZE nnnnn
  262.  
  263.                 This command specifies the maximum size of the text of a
  264.                 message.  Valid values are 256 - 65535.  Default: 32767 
  265.  
  266.         NOROUTEFLO
  267.  
  268.                 This option will make it so that BNP will not attempt to
  269.                 route .FLO files according to the routing file.
  270.  
  271.         SUPPRESS
  272.  
  273.                 Will force BNP to suppress screen writes when calling
  274.                 and external archive shell.
  275.  
  276.  
  277.    You will also find ROUTE.BNP.  Here is a run down of every routing
  278.    command.
  279.  
  280.         SCHED # HH:MM HH:MM [Day1|Day2|Day3 etc...] or [All]
  281.  
  282.                 Specifies a schedule with a start and end time in military
  283.                 24 time.  The day specifiers can be any combination of the
  284.                 abbreviated seven days of the week seperated by a PIPE, but
  285.                 no spaces at all!  Or, for all days of the week, use the
  286.                 keyword ALL.
  287.  
  288.                 Ex: Sched A 16:00 22:19 Tue|Wed|Fri|Sun
  289.  
  290.         POLLxxxx node1 [node2] etc...
  291.  
  292.                 Forces BinkleyTerm or OPUS-CBCS to call a system regardless
  293.                 of whether there is mail waiting or not.  Where 'xxxx' are
  294.                 the following keywords:
  295.  
  296.                       CRASH - Send immediately or as soon as possible
  297.                       DIRECT - Send as soon as non-CM nodes are processed.
  298.                       NORM - Same as direct, but no garantees that the
  299.                              bundle will end up going where it's supposed
  300.                              to.
  301.                       IMM -  Makes packed mail IMMEDIATE (Portal Only).
  302.                       HOLD - Make other system pickup mail.  This is
  303.                              useless for POLLxxxx but is good for SEND and
  304.                              ROUTE commands.
  305.  
  306.         NOBUNDLE node1 [node2] etc...
  307.  
  308.                 This tells BNP NOT to bundle mail for the specified nodes,
  309.                 instead mail is kept unbundled and is sent as .xUT packets.
  310.                 If there is more mail, more is added to the packet.
  311.                 Routing commands will work normally.
  312.  
  313.         SENDxxxx node1 [node2] etc...
  314.  
  315.                 Sends mail directly to the specified nodes directly using
  316.                 one of the above keywords.
  317.  
  318.                 NOTE: an '*' anywhere in place of a number in the fidonet
  319.                       address specifies that BNP will treat it as GLOBAL.
  320.  
  321.                 NOTE: an '!' anywhere in front of a full or partial fidonet
  322.                       address specifies that any global addresses on that
  323.                       line that pertain to this system will be ignored.
  324.                       This is the equivelant to a logical NOT.
  325.  
  326.                 Ex: SendCM 1:109/40 400 1:261/* !1024 !952
  327.  
  328.                 Sends direct Crash to 1:109/40, 1:109/400 and ALL of 261,
  329.                 EXCEPT for nodes 1:261/1024 and 952.
  330.  
  331.         ROUTExxxx finalnode destnode1 [destnode2] etc...
  332.  
  333.                 Routes mail addressed to [destnode] through [finalnode].
  334.                 You must specify at least two entries, a destination
  335.                 and a final destination.
  336.  
  337.                 e.g: RouteDIRECT 1:109/40 1:* 2:* 3:* 4:* 5:* 6:* !6:844/11
  338.  
  339.                 Routes all mail for ALL nodes in zones 1 through 6 via
  340.                 1:109/40 except 6:844/11.
  341.  
  342.                 NOTE:  BNP analyzes in decending order.  This means that
  343.                 overrides and ruled exceptions go BEFORE other entries.
  344.                 The logical NOTS may go anywhere on a line, but they are
  345.                 overridden if they come on a line AFTER the global
  346.                 application is set.  (e.g.  if !1:109/50 comes on line 5,
  347.                 and SendCM 1:109/* is on line 4, this one will be taken
  348.                 instead.
  349.  
  350.                 ex:
  351.                     SendCM 1:109/40 400 50 500 60 600 70 700 10 100 20 200
  352.                     RouteCM 1:109/400 1:109/*
  353.                     RouteIMM 1:109/500 1:261/*.*
  354.  
  355.    I hope this explains most of your questions.  If you have other
  356.    questions, feel free to contact me at +1-301-649-3207 between 4PM and
  357.    10PM GMT -5 (EST5EDT), or netmail me at 1:109/427.  Or uucp me at
  358.    nmoschkin.bnpsupport@cascades.permanet.org                    
  359.  
  360.  
  361.        Acknowledgments
  362.        ---------------
  363.  
  364.           BinkleyTerm is by Vince Perriello, Bob Hartman and Bit Bucket
  365.           Software.
  366.           D'Bridge is written by Chris Irwin.
  367.           FrontDoor is written by Joaquim Homrighausen.
  368.           IBM is a trademark of International Business Machines
  369.           Borland C++ 3.1 is copyrighted by Borland International Inc.
  370.           Microsoft C++ 7.00 is copyrighted by Microsoft Inc.
  371.           Microsoft MS-DOS is copyrighted by Microsoft Inc.
  372.           Opus-CBCS was originally written by Wynn Wagner III
  373.           ARJ is by Robert K. Jung
  374.           Portal of Power is copyrighted by the Portal Team.
  375.           Squish and Maximus written and owned by Scott J. Dudley
  376.           Hudson Message Base (HMB) originally constructed by Adam Hudson.
  377.           JAM Message Base is by J. Homrighausen, A. Milner, M. Birch and
  378.           M. Wallen.
  379.  
  380.  
  381.