home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / comm / ninf402.zip / NETINFO.DOC < prev    next >
Text File  |  1993-03-29  |  9KB  |  181 lines
  1.  
  2.                                March 28, 1993
  3.                   NetInfo.exe Copyright (c) 1992 G. K. Pace
  4.                             All Rights Reserved!
  5.                                 Version 4.02
  6.  
  7.  
  8.      NetInfo is a database/reporting utility for FidoNet Nets. It will scan 
  9.  a message base for messages addressed to it and act upon the "controls" 
  10.  placed in the body of the message.  It will then generate a message report 
  11.  to be sent back to the requestor.  It is designed for the purpose of 
  12.  creating maintaining, and distributing in a secure fashion, a Sysops' 
  13.  Information list, containing the "personal" information often needed and 
  14.  typically known as the "voice-list".
  15.  
  16.       When run, it will scan the specified message path for messages 
  17.  addressed to it. If it finds one it will record what ever input data was 
  18.  sent in a datafile. It will then create a message reply to the sender with 
  19.  their data, requesting their review of it. If the sender requested a list 
  20.  the return message will be setup for file-attaching the text file to the 
  21.  requester.
  22.  
  23.      Atho NetInfo was primarily designed for use within a Net, it supports 
  24.  full INTL addressing, so it is not limited to use within a Net, 
  25.  participants in a particular NetInfo Host system can be from different 
  26.  Nets, Zones, and even Networks.  The only requirement is that they be 
  27.  capable of sending/recieving FidoNet "style" mail.
  28.  
  29.      The Netinfo System consists of a "Host" and participants. The Host sets 
  30.  up NetInfo for scanning of NetMail and sending of replies to the 
  31.  participants.  The participants maintain the data in their file by sending 
  32.  NetMail addressed to NetInfo at the Host address.  Any participant may at 
  33.  any time send a message to NetInfo for the purposes of updating or deleting 
  34.  their record in the database, or to retrieve an updated listing containing 
  35.  the information from all who participate.  Once a participant deletes their 
  36.  record, they are denied access to retrieve an updated list, unless they 
  37.  reinstate their information.
  38.  
  39.      The participant is the "owner" of their information.  Their information 
  40.  cannot be modified (other than deleted) by the Host, or anyone else.  The 
  41.  information supplied is optional - there are not any requirements as to how 
  42.  much information or its accuracy placed upon the participants by NetInfo.  
  43.  The input of data is protected by password, and tests verifying that the 
  44.  Name matches the message originating address.  A participant who plans to 
  45.  change addresses should delete their record, and input a new record with 
  46.  the new address.  The Host can delete records, for this purpose as well.
  47.  
  48.      The control of who can particpate is maintained by the NetInfo Host.  
  49.  NetInfo requires a control file containing an INTL address and pass-phrase 
  50.  for each particpant who is/will be using NetInfo from that host.  If a 
  51.  message to "NetInfo" is recieved and scanned, it will not be processed if 
  52.  it is a "pass-thru" or In-Transient message.  NetInfo only reads mail 
  53.  addressed to it.  Netinfo tests the message for the proper "From:" Name, 
  54.  and pass-phrase - a violation is reported to the Host, and to the Owner of 
  55.  the record for which access was attempted.  Note that such errors are not 
  56.  returned to "Sender" but rather to the Owner of the record.  This can serve 
  57.  as a warning that someone is attempting to access the Netinfo data using a 
  58.  forged origin address.  If the attempt was a genuine mistake, the reply 
  59.  serves as evidence of the problem so that it can be corrected.
  60.  
  61.      The output lists NetInfo will produce and return upon request come in 
  62.  two flavors... an abreviated list, and a list containing more information 
  63.  for each particpant.
  64.  
  65.      SETUP:
  66.  
  67.         NetInfo requires a configuration file with the same name as the 
  68.  executable filename, but with and an extention of .INI. (i/e Netinfo.ini) 
  69.  NetInfo also requires a control file containing the INTL addresses of those 
  70.  who are authorized use of NetInfo, along with a pass-phrase for each. The 
  71.  pass-phrase is not case-sensitive, and may contain spaces... the length of 
  72.  this ascii string must not exceed 71 characters.
  73.  
  74.         NetInfo will only accept messages addressed to it, at the Node
  75.  address setup in the configuration file.  Due to this, any "passthru" 
  76.  messages destined for a NetInfo at another Node address will not be 
  77.  intercepted.  If you desire to operate NetInfo as a Host for more than one 
  78.  group, (say for instance a FidoNet Net, and another Net...) you can setup 
  79.  another NetInfo system by copying NetInfo.exe to another name, and setting 
  80.  it up with a differently configured configuration file. (i/e copy 
  81.  Netinfo.exe to Netinf.exe with a config file of Netinf.ini)  The limit to 
  82.  this is that you cannot have the same user "INTL" addresses for each, as 
  83.  the first to process an enabled INTL address will mark the message as 
  84.  recieved.
  85.  
  86.         The setup of the configuration and control files are explained in 
  87.  the accompanying NetInfo.ini and Netinfo.ctl files.  You must modify these 
  88.  to suit your needs.
  89.  
  90.         NetInfo can be setup to be run as an event following the reciept
  91.  of mail, or as an event occuring at a specified time (just prior to
  92.  sending mail?).  It will scan the specified mail directory for messages
  93.  addressed to it, creating replys to the sender of the messages as
  94.  appropiate.
  95.  
  96.         NetInfo will not return a message to a Node that is not listed in
  97.  the control file!
  98.  
  99.         NetInfo REQUIRES the password to be in the Subject field of the
  100.  message addressed to it. If the message is addressed from a node listed
  101.  in the control file and the password is correct and (except for new
  102.  entries) if the message is from the Sysop listed in the database for the
  103.  node, it will scan the message body for directive "keys" which instruct
  104.  it where to insert the information into the database or to return a
  105.  report of what is there.
  106.  
  107.         If the message does not contain any directives, NetInfo will
  108.  return the information contained in the database for the node, so that
  109.  the Sysop can review it for accuracy.  The directives that NetInfo
  110.  recognizes are:
  111.  
  112. -C    Co sysop name Max. 35 Characters.
  113. -A    Sysop Mail Address Max. 70 Characters.
  114. -P    Voice Phone number Max. 14 Characters.
  115. -D    BBS Phone Number Max. 14 Characters.
  116. -O    AKA i/e 1:374/600.0 Max. 23 Characters.
  117. -N    BBS Name Max. 35 Characters.
  118. -T    BBS Type Max. 35 Characters.
  119. -B    BBS Baud & Type Max. 26 Characters.
  120. -F    Features Max. 70 Characters.
  121. -L    Return Public type list.
  122. -X    Return Private type list (overrides -L).
  123. -?    Return this List of Directives.
  124. -Z    Delete Your Record!
  125.  
  126. To delete a field use the directive space CR.
  127. Example:
  128. -A 1369 Tropical Bush, Hidden Valley Florida, 32718
  129. -P
  130.   (the above field will be deleted)
  131.  
  132.         The difference between the -L and -X reports, is that the -L
  133.  report will not contain the BBS information, address and misc. fields.
  134.  
  135.         NetInfo will report errors that occur when processing messages. If
  136.  an error occurs NetInfo will return a message to the Sysop of the node
  137.  informing them of the error and will report the pertinent info concerning
  138.  the error to the Host running NetInfo. To record this information NetInfo
  139.  can be configured to produce a logfile.
  140.  
  141.      NetInfo returns zero (0) as normal - no database changes made, one (1) 
  142.  as normal - database changes and new files written.
  143.  
  144.         To provide further security of this Net Information system, you
  145.  can setup a batch file to password archive them using PKZIP or another 
  146.  archiving utility that supports this feature. The password used being given 
  147.  to those who will legitimately recieve the files.
  148.  
  149.         This Utility has been developed with the assistance of Christopher
  150.  Baker Sysop @ 1:374/14, and Dennis Wren @ 1:374/73.  Many of the features
  151.  and functions of NetInfo were originated by Chris... and Dennis was
  152.  exceptionally proficient at the "torture testing" to verify it's usability
  153.  and security...  NetInfo wouldn't be what it is with out their input!
  154.  
  155.         About Licensing... NetInfo is copyrighted material, and all rights
  156.  to it are reserved.  You can use it for a limited time to try it out...
  157.  but must REGISTER it for continued use.  License fees are reasonable, and
  158.  FidoNet Sysops operating a Public accessible, non-fee, Bulletin Board
  159.  System, or FidoNet Sysops operating a "Host" mail-only system which is
  160.  operated on a non-fee basis serving others in the FidoNet, will find the
  161.  registration fee to be VERY reasonable... commercial users, Government
  162.  users, and anyone who charges Users a fee will pay a little more for the
  163.  use of NetInfo. <This is my policy on all of my FidoNet utilities>
  164.  
  165.         For further information, comments, criticism, or to register the use
  166.  of NetInfo, please contact me at:
  167.  
  168.                             G. K. Pace
  169.                             3935 Baker Ave.
  170.                             Titusville, Fl. 32796
  171.                             (407)269-3088 (voice)
  172.                             (407)269-9844 (BBS)
  173.                             FidoNet @ 1:374/26
  174.  
  175.  
  176.         Freq the Latest from 1:374/26 using the magic name NetInfo.
  177.  
  178.  
  179.  PS: Have a good day!
  180.  
  181.