home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / CEREBRUM / NFT130.ZIP / NFT.DOC < prev    next >
Text File  |  1997-03-13  |  23KB  |  495 lines
  1. ==============================================================================
  2.                       ███╗   ██╗     ███████╗     ████████╗
  3.                       ████╗  ██║     ██╔════╝     ╚══██╔══╝
  4.                       ██╔██╗ ██║     █████╗          ██║
  5.                       ██║╚██╗██║     ██╔══╝          ██║
  6.                       ██║ ╚████║     ██║             ██║
  7.                       ╚═╝  ╚═══╝     ╚═╝             ╚═╝
  8. ==============================================================================
  9.                         Network File Transfer Software
  10. ==============================================================================
  11.  
  12.                                       NFT
  13.                              Network File Transfer
  14.  
  15.                                   User Manual
  16.  
  17.  
  18.                Software and Documentation written by Craig Dooley
  19.                        Copyright (c) 1996 by Craig Dooley
  20.                                All Rights Reserved
  21.  
  22.                                A  CEREBRUM Release
  23.  
  24.  
  25. What Is NFT?
  26. ============
  27.         NFT is a utility written solely for use on FILENET, the original
  28.         WWIV-based File Transfer Network.  NFT incorporates the various
  29.         programs used by Filenet to send files, requests, and
  30.         host/subscribe to FDL's.  It puts all of these commands into a
  31.         simple, easy-to-use, menu-driven interface.  It adds additional
  32.         features and commands, such as the ability to view SUBS.LST,
  33.         SUBS.FDL, FILENET.NWS, the Filenet log file, and the ability to
  34.         edit the various configuration files.  The purpose of NFT is to
  35.         make the operation and participation in FILENET as easy and
  36.         painless as possible, for both new and experienced sysops.
  37.  
  38.         In addition to the menu-driven interface, NFT can also be run
  39.         from the command line, enabling some automated functionality.
  40.  
  41.         NFT is ONLY useable on Filenet.  It is designed around the
  42.         proprietary Filenet structures, and can not be used on any other
  43.         network.
  44.  
  45. How Do I Install NFT?
  46. =====================
  47.         Installation of NFT is easy.  Simply put the NFT.EXE in either
  48.         your main WWIV directory, or in your Filenet directory.  It is
  49.         designed to operate from either place.  The file 'SENDIT.EXE' goes
  50.         in the FILENET directory.  Unarchive the file FNDLIST.ZIP into
  51.         your WWIV directory.  Then, type NFT to begin using NFT.
  52.         It couldn't be simpler!
  53.  
  54. NFT - The Menus
  55. ===============
  56.         NFT was written using the Turbo CXL Library, which includes some
  57.         excellent routines for menuing.  Menus can be navigated by the
  58.         arrow keys, HOME, END, PgUp, and PgDn.  Pressing [ENTER] over a
  59.         highlighted selection chooses that selection.  Pressing [ESC]
  60.         backs you up 1 menu level, and quits the program if you are at
  61.         the main menu.  Each selectable entry also has a highlighted
  62.         'Quick Pick' letter, which you can press to go immediately to
  63.         that selection.
  64.  
  65.         When entering Data, pressing [ENTER] accepts the input, [ESC] aborts.
  66.         If you are entering several fields (i.e. editing FDLFTS.CFG),
  67.         you will need to either cycle through ALL of the entries to
  68.         accept the changes, or press CTRL-ENTER to accept the changes.
  69.         If you press [ESC], any changes made will NOT be saved.
  70.  
  71.  
  72. FDL Menu
  73. ========
  74.  
  75.         ADD_FDL
  76.         =======
  77.                 This option allows you to subscribe to FDLs that are
  78.                 availible and listed in SUBS.FDL.  To subscribe, simply
  79.                 enter the FDL type when prompted.  If you're not sure of
  80.                 the type, press [F1] to view the SUBS.FDL file.  Hitting
  81.                 [ENTER] on a blank line will abort the process and
  82.                 return you to the main menu.  Once you've entered the
  83.                 FDL type that you want to subscribe to, NFT will search the
  84.                 FDL data files and get the relevent information on the
  85.                 FDL, and confirm that it found the one that you wanted
  86.                 to subscribe to.  If you agree that it found the right
  87.                 one, NFT will then prompt you for a directory for the
  88.                 files.  You will be requested to enter a directory
  89.                 NUMBER of your WWIV directories.  Pressing 'F1' lists
  90.                 your WWIV directories (a la` DIREDIT) and shows you the
  91.                 number, name, and path.  If you do not enter a directory
  92.                 number, NFT will assume that you want the files to go
  93.                 into the SYSOP directory.  NFT will then send out an ADD
  94.                 request, and will add the appropriate information to
  95.                 your FDLFTS.CFG file.  If you already have an entry in
  96.                 your FDLFTS.CFG, NFT will ask you if you want to replace
  97.                 the existing listing.
  98.  
  99.         DROP_FDL
  100.         ========
  101.                 If, for some reason, you want to un-subscribe to an FDL,
  102.                 this is the selection that you will use.  NFT prompts
  103.                 you for the FDL type to remove.  If you can't remember,
  104.                 pressing 'F1' lists the FDLs that you are currently
  105.                 subscribed to.  If you change your mind, hitting [ENTER]
  106.                 on a blank selection aborts the process.
  107.  
  108.         VIEW_SUBS_FDL
  109.         =============
  110.                 Choosing this selection allows you to view the SUBS.FDL
  111.                 file, which lists all of the availible FDL's on Filenet.
  112.  
  113.         FDL_MAINTENENCE
  114.         ===============
  115.                 The FDL Maintenence Section allows people who host FDL's
  116.                 to perform maintenence on those FDL's, such as process
  117.                 directories, send files, etc.
  118.  
  119.                 UPDATE_FDL_DATE
  120.                 ===============
  121.                         This option goes through and resets the FDL date
  122.                         for either individual or all FDL's that you
  123.                         host.  Once this is run, all files currently in
  124.                         that directory are considered to have been sent
  125.                         to all current subscribers.  You can choose to
  126.                         process 1 FDL or all FDL's.  Files are NOT sent
  127.                         out to subscribers, regardless of whether or not
  128.                         the upload date is later than the FDL mark date.
  129.  
  130.                 PROCESS_FDL
  131.                 ===========
  132.                         This option goes through all FDLs, or individual
  133.                         ones if you desire, and processes them, sending
  134.                         out any new files to all current subscribers,
  135.                         and then updating the file date.
  136.  
  137.                 SEND_FILE_TO_FDL
  138.                 ================
  139.                         This option allows you to manually send ANY file
  140.                         to all subscribers of an FDL.  The file does not
  141.                         have to be in the FDL directory.
  142.  
  143.                 HOST_NEW_FDL
  144.                 ============
  145.                         This option goes through the process of hosting
  146.                         an FDL.  It will set up all necessary
  147.                         configuration files AND will automatically send
  148.                         mail to 1@1 with the required information, so
  149.                         that it can be included in the SUBS.FDL and
  150.                         FDLDATA.FDL.
  151.  
  152.  
  153. REQUEST_MENU
  154. ============
  155.         REQUEST_FILE_LIST
  156.         =================
  157.                 This option gives you a menu to control File List
  158.                 requesting.
  159.  
  160.                 UPDATE_ALL_LISTS
  161.                 ================
  162.                         This allows you to update all of the existing
  163.                         file lists on your system, based on the age.
  164.                         You can select a certain number of days old that
  165.                         a list must be before requesting, or you can
  166.                         update ALL at once.
  167.  
  168.                 UPDATE_ONE_LIST
  169.                 ===============
  170.                         As above, but shows the existing lists and their
  171.                         ages, and allows you to update lists
  172.                         individually.
  173.  
  174.                 REQUEST_ALL_LISTS
  175.                 =================
  176.                         Sends out a file list request to all systems on
  177.                         the network.  Use this sparingly, as it will
  178.                         generate a LOT of traffic.
  179.  
  180.                 REQUEST_FILE_LIST
  181.                 =================
  182.                         Choosing this option allows you to request a file
  183.                         listing from other nodes in Filenet.  NFT will ask you
  184.                         for a BBS Name, Node #, or partial name.  Based on what
  185.                         you input, NFT will search the network listing for a
  186.                         match to your input.  If you entered nothing, NFT aborts
  187.                         the request.  Pressing [F1] will list all of the nodes
  188.                         in Filenet.
  189.                         NFT tries to find the best match for your choice.  It
  190.                         will list each match, or close match, that it finds and
  191.                         ask you if it has the correct one.  Once you tell it
  192.                         that it has, NFT will send out a file list request to
  193.                         that node.
  194.  
  195.                 REQUEST_MISSING
  196.                 ===============
  197.                         This option compares your existing file lists
  198.                         with the network, and requests lists from those
  199.                         systems that you do not have a list already
  200.                         for.
  201.  
  202.         REQUEST_FILE
  203.         ============
  204.                 This option works much the same way as the above, except
  205.                 that once it's found the correct node, it prompts you
  206.                 for a file name to request.  NFT will then search for a
  207.                 file list from that node, and search the listing for the
  208.                 file that you've requested.  If NFT finds the file, it
  209.                 will prompt you to confirm that it's the right one.  If
  210.                 it cannot find the file in the list, you will be asked
  211.                 if you want to send the request anyways.
  212.                 If no file list exists for this node, the request is
  213.                 automatically sent.
  214.                 NFT checks ALLOW.DAT in your data directory to see if the
  215.                 file already exists on your system.  If it does exist,
  216.                 NFT notifies you and prompts you on whether you want
  217.                 to request the file anyway or abort the request.
  218.  
  219.         REQUEST_PGP_KEY
  220.         ===============
  221.                 As with the REQUEST_FILE_LIST option, REQUEST_PGP_KEY
  222.                 simply requests the sysop's Public PGP key, which is found
  223.                 in their FILENET directory as FILENET.KEY.  You will be
  224.                 prompted for a node to request from, and once one is
  225.                 chosen, the PGP key request will be sent out.
  226.  
  227.         VIEW_FILE_LIST
  228.         ==============
  229.                 This option allows you to browse any availible file
  230.                 lists and request files directly.  While browsing the
  231.                 list, pressing [F1] brings up the request menu where you
  232.                 enter the filename that you are interested in.
  233.  
  234.  
  235. SEND_MENU
  236. =========
  237.         SEND_FILE
  238.         =========
  239.                 This option is where you send files to other systems in
  240.                 Filenet.  Remember, unsolicited files are generally NOT
  241.                 liked, so make sure that the sysop doesn't mind you
  242.                 sending them that file.
  243.  
  244.                 When you choose to send a file, you are prompted for the
  245.                 BBS Name/Node Number/Partial Name, the file to send, the
  246.                 description, and the user to send it to.
  247.  
  248.                 As before, NFT will search the Filenet node lists for
  249.                 the correct node, and will confirm it with you.
  250.  
  251.                 Be sure to enter the FULL path and filename of the file
  252.                 that you wish to send.  If you are unsure of what file
  253.                 to send, use ? as the file name.  You will then be
  254.                 prompted for a drive, and will be able to scroll through
  255.                 a picklist for files and directories.
  256.  
  257.                 Enter the appropriate description for the file.  If you
  258.                 leave this entry blank, NFT will fill it in with 'File
  259.                 Uploaded By @<NODENUM>.FILENET'.
  260.  
  261.                 If you are sending this file to any user other than the
  262.                 sysop, put their user number in here.  This will cause
  263.                 the Filenet software to send that user a note when the
  264.                 file arrives, telling them that it was sent.
  265.  
  266.  
  267.         SEND_FILE_TO_FDL
  268.         ================
  269.                 This option will allow people who host FDL's to send
  270.                 files out to that FDL.  See above, under
  271.                 FDL_MAINTENENCE.
  272.  
  273.         SEND_FILE_LIST
  274.         ==============
  275.                 This option allows you to send your current file list to
  276.                 another node.  If there is no list present on your
  277.                 system, NFT will build it before sending it.  If one
  278.                 does exist, NFT shows you the date of the list, and asks
  279.                 if you want to send it 'as-is', or if you want to
  280.                 rebuild it before sending.
  281.  
  282. MAINTENENCE_MENU
  283. ================
  284.         VIEW_SUBS_LIST
  285.         ==============
  286.                 This option lets you view the SUBS.LST file for Filenet.
  287.  
  288.         VIEW_FDL_LIST
  289.         =============
  290.                 This option lets you view the SUBS.FDL file for Filenet
  291.  
  292.         VIEW_LOG
  293.         ========
  294.                 This option lets you view your FILENET.LOG, in your
  295.                 FILENET directory.
  296.  
  297.         VIEW_FILENET_NEWS
  298.         =================
  299.                 This option lets you view the FILENET.NWS news file in
  300.                 the Filenet directory.
  301.  
  302.         LIST_FILENET_NODES
  303.         ==================
  304.                 This option gives you a full list of the nodes currently
  305.                 in Filenet.
  306.  
  307.         VIEW_POLICY
  308.         ===========
  309.                 This option lets you view the POLICY.NWS file in the
  310.                 FILENET directory
  311.  
  312.         VIEW_HALL_OF_FAME
  313.         =================
  314.                 This option lets you view the FAME.NWS file in the
  315.                 FILENET directory
  316.  
  317.         VIEW_REGION_NEWS
  318.         ================
  319.                 This option lets you view the REGION.NWS file in the
  320.                 FILENET directory.
  321.  
  322.         BUILD_FILE_LIST
  323.         ===============
  324.                 This option builds a fresh file list and saves it in
  325.                 your Filenet directory as L<nodenum>.LST.
  326.  
  327.         EDIT_FDLFTS.CFG
  328.         ===============
  329.                 This option will let you edit the various options
  330.                 availible in the FDLFTS.CFG file.
  331.  
  332.         EDIT_DIRLIST.FTS
  333.         ================
  334.                 This option will let you edit your DIRLIST.FTS file,
  335.                 enabling you to make changes to the availible
  336.                 directories that you have defined.
  337.  
  338.                 You can navigate the directory listing by using the
  339.                 arrow keys, PgUp, PgDn, Home, and END.  The current
  340.                 settings are shown in the box to the left of the
  341.                 directory name: '-' if the directory is ignored, 'R' if
  342.                 it has regular access, 'S' if it has Sysop Access, and
  343.                 'M' if it has WWIV Reg access.
  344.  
  345.                 You can toggle the settings for the directories by
  346.                 pressing the appropriate keys: 'R' to set Regular
  347.                 Access, 'S' to set Sysop Access, 'M' to set WWIV Reg.
  348.                 Access, and <SPACEBAR> to ignore the directory.
  349.  
  350.                 Pressing 'Q' quits you out of the DIRLIST.FTS editing
  351.                 section.  You are prompted to save your changes.  If you
  352.                 do NOT save your changes, your original DIRLIST.FTS is
  353.                 left alone.  If you DO save your changes, your old
  354.                 DIRLIST.FTS is saves as DIRLIST.BAK.
  355.  
  356.  
  357.  
  358. ABOUT_NFT
  359. =========
  360.         This option merely tells you what version you are using, when it
  361.         was compiled, and who wrote it.
  362.  
  363. QUIT_PROGRAM
  364. ============
  365.         Choosing this option is the same as pressing [ESC].  It exits
  366.         NFT and takes you back to the DOS prompt.
  367.  
  368. Command Line Options
  369. ====================
  370.         NFT can also be run from the command line to perform some
  371.         functions.  Commands can be stacked to do multiple commands in 1
  372.         pass.  The commands are:
  373.  
  374.         /L<node>                -       Request a file list from NODE
  375.         /K<node>                -       Request a public key from NODE
  376.         /R<filename>@<node>     -       Request FILENAME from NODE
  377.         /S<filepath>@<node>     -       Send FILEPATH to NODE
  378.                                         Note: If node is a filename,
  379.                                         prefaced by a '&', then NFT will
  380.                                         read in a distribution list of
  381.                                         that filename in the FILENET
  382.                                         directory.  The distribution
  383.                                         list is an ASCII text file, with
  384.                                         1 node per line.  i.e.
  385.                                         /SBBS.EXE@&TEST.FTS
  386.                                         sends BBS.EXE to all nodes
  387.                                         listed in TEST.FTS, located in
  388.                                         the FILENET directory.  Files
  389.                                         are stacked to conserve space.
  390.         /A<fdl>                 -       Request add to FDL
  391.         /D<fdl>                 -       Request drop from FDL
  392.         /P<filepath>#<fdl>      -       Post FILEPATH on FDL
  393.         /F<fdl>                 -       Process FDL.  Leave <fdl> blank
  394.                                         to process all fdl's.
  395.         /M<filepath>@<node>     -       Send FILEPATH to NODE as e-mail.
  396.                                         Note: If node is a filename,
  397.                                         prefaced by a '&', then NFT will
  398.                                         read in a distribution list of
  399.                                         that filename in the FILENET
  400.                                         directory.  The distribution
  401.                                         list is an ASCII text file, with
  402.                                         1 node per line.  No user number
  403.                                         or '@'.
  404.                                         /MC:\WWIV\FILENET\TEST.MSG@350
  405.                                         would send a file called
  406.                                         C:\WWIV\FILENET\TEST.MSG to
  407.                                         1@350 on Filenet as an e-mail.
  408.  
  409.         /Q                      -       Suppresses system beeps and bells.
  410.                                         Most useful when running
  411.                                         unattended via command line.
  412.  
  413.         Notice - do not use the <> in the command.  Commands are
  414.         case-insensitive.  The '-' can also be used in place of '/'.
  415.  
  416.  
  417.         Typing NFT /? will also give you this help listing.
  418.  
  419.  
  420.  
  421.  
  422. Registration
  423. ============
  424.  
  425.         Registration of NFT is $10.  Registration does not change the
  426.         functionality of NFT, as it is fully functional unregistered.
  427.         There are no registration numbers or codes.  Registering NFT
  428.         will merely put your name in the REGISTER.LST file so that
  429.         everyone can see what a good, thoughtful person you are.
  430.  
  431.         NFT was designed to make YOUR life easier.  It has taken several
  432.         months to complete, and has involved quite a bit of work.  If
  433.         you use it, and find it helpful, I would appreciate your
  434.         registering it, to ensure future support and to help compensate
  435.         me for my time.  In addition, Deltigar had to fork out a fair
  436.         amount of money to obtain the full rights to the Filenet
  437.         structures from Private Idaho.  Therefore, 20% of all
  438.         registrations for NFT will go to Deltigar to help him offset
  439.         some of his expenses.  By registering NFT, you are saying that
  440.         you like the program, and you will be helping out not only the
  441.         author, but the NC and founder of the network.
  442.  
  443.         You aren't being forced to register, but if you don't, it will
  444.         be on YOUR conscience!
  445.  
  446.  
  447. Support
  448. =======
  449.         There is an NFT Support Sub on Filenet for questions, comments,
  450.         and suggestions about NFT.  The subtype is NFT, and the host is
  451.         @350.  This sub is only availible on FILENET, since NFT is only
  452.         useable on that network.  In addition, I can be reached at the
  453.         following network addresses:
  454.  
  455.                         1@350           FILENet
  456.                         1@6100          WWIVNet
  457.                         1@8315          Icenet, Terranet, Apex, SierraLink
  458.                         1@8315          GlobalNet
  459.                         1@1             Dreamnet
  460.                         1@18315         WWIVLink
  461.                         1@8304          TFALink
  462.                         1@8300          FiitaNet
  463.                         1:376/126       Fidonet
  464.           morgul@worldnet.att.net       Internet
  465.  
  466. Credits
  467. =======
  468.         Thanks go out to the following:
  469.  
  470.         Wayne Bell, for creating WWIV, without which, well, this program
  471.                 would be worthless!
  472.  
  473.         Private Idaho, for writing the original software for Filenet
  474.                 which makes all this possible.
  475.  
  476.         Deltigar, for providing me with the original code, so that I could
  477.                 write the program to be compatible.
  478.  
  479.         The Beta Testers, for testing the software and finding all the
  480.                 bugs.  If you find any, blame them! <G>
  481.  
  482.         My wife, Norma, for being patient while I get involved in yet
  483.                 ANOTHER programming project.  Love is VERY tolerant!
  484.  
  485.  
  486.  
  487.  
  488. ==============================================================================
  489. End of NFT.DOC
  490. Copyright (c) 1996 by Craig Dooley
  491. All Rights Reserved.
  492. No section of this document may be used elsewhere without the express
  493. written permission of Craig Dooley.
  494.  
  495.