home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_disks / 200-299 / ff294.lzh / DNet / amiga / doc / dnet.doc < prev    next >
Text File  |  1989-12-11  |  11KB  |  309 lines
  1.  
  2.                 AMIGA-DNET V2.10
  3.  
  4.     New this release:    7 bit support.    In fact, it is the default... see
  5.             options list for 8 bit support.  Also flow control
  6.             may be selected. (refer to -m0 ,-P, and -Z options).
  7.  
  8.                 AMIGA CONFIGURATION
  9.  
  10.     ENV:        must be assigned and writable.
  11.     S:DNET.CONFIG   contains configuration info for DNet
  12.     S:DNET.SERVERS  contains the server list for dnet (and paths to
  13.             the server executables)
  14.  
  15.     Any DNet clients you wish to run or have DNet run must be in your path.
  16.     (i.e. FTERM, PUTFILES, GETFILES ...)
  17.  
  18.     Other files will be required if you intend to run DNet *as* a BBS.
  19.  
  20.  
  21.  
  22.  
  23.                   DNET OPTIONS
  24.  
  25.     (please refer to S:DNET.CONFIG while reading this)
  26.  
  27.     DNet runs in three basic modes:  AutoAnswer (-a), DialOut (default),
  28.     and Manual (-X).  Each mode has its own default set of security
  29.     parameters.  The shipped defaults assume a hostile enviroment.
  30.     Generally,    AutoAnswer is assumed to be the most hostile since you
  31.     do not know who is calling you up.    DialOut is less so since you know
  32.     who you are dialing, and Manual assumes a non-hostile enviroment.
  33.  
  34.     These three modes also cause DNet to work differently.
  35.  
  36.  
  37. AMIGA/DNET
  38.  
  39.     DialOutMode:    The default mode is DialOutMode (neither -X or -a
  40.         given).  DNet will look for a CONNECT message on carrier
  41.         detect and modify the baud rate according to the AUTA
  42.         resources.
  43.  
  44.         DNet will set the security modes to the ENVO (originate)
  45.         resources in s:dnet.config
  46.  
  47.         NOTE:  response through the initial window will be slow due
  48.         to DNet's scanning of the resource file s:dnet.config.
  49.  
  50.     -X        Manual mode.  DNet will look for a CONNECT message on
  51.         carrier detect and modify the baud rate on connect
  52.         appropriately.
  53.  
  54.         DNet will set the security modes to the ENVM resources
  55.         which assumes a friendly connection.
  56.  
  57.     -a        Auto Answer mode.  DNet will send the RESM resources at
  58.         the originally specified baud rate to reset the modem
  59.         whenever carrier is lost.
  60.  
  61.         The security modes are set the the ENVA resources, which
  62.         normally assume a hostile enviroment.
  63.  
  64.     -8        Use 8 bits no parity for the initial window rather than
  65.         7 bits even parity.  NOTE!  This only effects the initial
  66.         login window.  The Protocol, when running, always uses
  67.         8 bits no parity.
  68.  
  69.     -bbaud    Set Initial Baud rate (otherwise uses preferences baud
  70.         rate)
  71.  
  72.     -Bbaud    Set Baud used to determine timeouts.  If not set, the
  73.         current baud rate, whatever that is, is used.  If set,
  74.         this value is used to calculate timeouts forever after
  75.         no matter what the actual line baud rate is.
  76.  
  77.         For example, setting this value lower than whatever baud
  78.         rate you normally use will allow for longer line delays
  79.         (such as when dialing through networks and things)
  80.  
  81.     -sclient    Run the specified client program on protocol start.  If
  82.         running a BBS you want to specify the BBS client program
  83.         here.
  84.  
  85.         NOTE:  If the DNET_NORUNCLIENT enviroment variable is set,
  86.         no client program will be run even if this option is
  87.         specified.  This is used by DBBS to ensure that DNet does
  88.         not start it several times.  This enviroment variable is
  89.         automatically deleted when DNET is first run.
  90.  
  91.         The default is to run the FTERM client.
  92.  
  93.  
  94.     -nhostname    Set the hostname (not used)
  95.  
  96.     -h1     Enable Carrier checking.  Default is to not check the CD
  97.         line (reversed from earlier versions).  Note that carrier
  98.         checking is forced if you use -a (auto answer) mode.
  99.  
  100.     -U#     Set the unit number for the low level serial-like device
  101.         to talk over.
  102.  
  103.     -Ddevice    Set the device name for the low level serial-like device
  104.         to talk over (i.e. "serial.device").
  105.  
  106.     -N#     Set the network ID for local client/server rendezvous
  107.  
  108.     -p        Packet Debug mode
  109.  
  110.     -d        Debug mode on
  111.  
  112.     -m0     Select 8 bit packet mode (default is -m1 which selects
  113.         7 bit packet mode)
  114.  
  115.         Note that packets containing binary data will be aproximately
  116.         25% larger in 7 bit mode.  Packets containing ascii data will
  117.         be normal-sized.
  118.  
  119.         In 8 bit mode, simple compression may actually occur... packets
  120.         containing all ascii data 0x00-0x7F will be compressed to make
  121.         use of the 8th bit which would normally be 0, giving an
  122.         aproximately 1/8 speed increase.
  123.  
  124.     -Pn     n = 0    none
  125.             1    xon-xoff
  126.             2    7wire
  127.  
  128.         if -P not specified then the preferences protocol is used.
  129.  
  130.     -Zn     n = 0    8-no parity
  131.             1    7-odd
  132.             2    7-even
  133.             3    7-mark
  134.             4    7-space
  135.  
  136.         if no -Z option is specified the preferences parity and
  137.         wordlength is used.
  138.  
  139.         WARNING:  You CANNOT combine xon/xoff *and* -m0.
  140.  
  141.  
  142.          ---------------------------------------------------
  143.                 SECURITY
  144.  
  145.     The following enviroment variables should exist:
  146.  
  147.     DNET_LEVEL, DNET_READ, DNET_WRITE, DNET_GROUP, DNET_USERID
  148.  
  149.     These are setup automatically by the S:dnet.config file depending on
  150.     the mode (Manual, DialOut (-X), AutoAnswer (-a)) and are read by local
  151.     servers to determine what the remote machine is allowed to do.  These
  152.     variables each hold a single value, normally 0-9 (except for DNET_GROUP
  153.     which can be any number 0-32767).
  154.  
  155.     SGCOPY (server for getfiles):
  156.  
  157.     This is a new server.
  158.  
  159.     DNET_READ and DNET_GROUP  determine which files the remote machine may download
  160.     (read).  In order for the remote to be able to download a file,
  161.     that file and all its parent directories are scanned.  At least
  162.     one comment field must have an AC entry (AC=n) less than or
  163.     equal to the current DNET_READ enviroment variable or sgcopy will
  164.     disallow the download.    If NO comment fields have an AC entry
  165.     the download is disallowed.  If any comment field has an AC
  166.     entry > DNET_READ, the download is disallowed unless a GP entry
  167.     was found (GR=n).
  168.  
  169.     A comment field may have multiple GR entries (GR=n GR=n ...).  If
  170.     any matches DNET_GROUP and all (if any) AC fields are <= DNET_READ,
  171.     the download is allowed.
  172.  
  173.     After that point a download will begin and files/dirs need not have
  174.     AC entries.  However, if any do, it will be checked again DNET_READ
  175.     and the download (for that file or directory) disallowed.
  176.  
  177.     SCOPY (server for putfiles)
  178.  
  179.     This server allows remote machines to upload a file.  That is,
  180.     transfer from the remote machine to the local machine.    DNET_WRITE
  181.     must be 9 or higher or the upload will be disallowed.  Currently,
  182.     the remote machine may upload anywhere so it is suggested that you
  183.     either NOT have the SCOPY server installed or do not set DNET_WRITE
  184.     to 9 or beyond when talking to possibly hostile remote machines.
  185.  
  186.     SPRINT (printer server)
  187.  
  188.     This server copies a stream to PRT:  DNET_WRITE must be at least
  189.     6 or the remote machine will not be allowed to use this server.
  190.  
  191.     SCLI (CLI server)
  192.  
  193.     This server is currently a big hack and requires a special pipe
  194.     device to work (The 1.3 pipe: will not work).
  195.  
  196.     DNET_LEVEL must be at least 9 for a remote machine to be able to
  197.     start a remote cli
  198.  
  199.     STERM  (terminal window server)
  200.  
  201.     This server requires no permissions to operate and allows the
  202.     remote machine to bring up a 'terminal window' to talk you
  203.     through.
  204.  
  205.     AUTOMATIC ENVIROMENT VARIABLE CONFIGURATION CAN BE DONE FROM
  206.     S:DNET.CONFIG
  207.  
  208.          ---------------------------------------------------
  209.  
  210.                 TALKING TO A DBBS
  211.  
  212.     Amiga users wishing to connect to DBBS hosts should use the following
  213.     command line:
  214.  
  215.     Run dnet -8 -sbbsterm
  216.  
  217.     The -8 is required only if you have a stupid 'smart' modem which
  218.     figures out the parity and then stays with it forever after.  Since
  219.     neither -a or -X have been given, you are in the medium-security
  220.     'dial-out' mode.
  221.  
  222.     Then, dial up the BBS in question.    If the other end is indeed a
  223.     DNET-BBS running under automatic operation, the protocol should start
  224.     up almost immediately.  On protocol startup, your side will
  225.     automatically attempt to run the BBSTERM program (which connects to the
  226.     BBS server on the other end).  NOTE that the BBSTERM executable and
  227.     FTERM executable are one and the same.  The naming 'BBSTERM' causes
  228.     it to use the BBS's port (8200) instead of the STERM port (8195)
  229.  
  230.     Currently the BBS server will allow only one connection at a time and
  231.     return other attempts with an error.  However, you can still download,
  232.     upload, readmail, and talk to the sysop all at the same time.
  233.  
  234.             Downloading files from the DBBS
  235.  
  236.     The getfiles client program is used to retrieve files from the DBBS.
  237.     The DBBS will set security options and such to allow you to download
  238.     files.
  239.  
  240.             Allowing the DBBS to upload files from you
  241.  
  242.     At least one of the directories in the path leading to the eventual
  243.     file/dir that you want to upload to the BBS must have a comment
  244.     field containing the string AC=<n>    (e.g. AC=1) where <n> is at least
  245.     whatever read security level you have set (the DNET_READ enviroment
  246.     variable, for example:  setenv DNET_READ 1), or the DBBS will be unable
  247.     to retrieve the file(s)/dir(s) and will tell you so.
  248.  
  249.  
  250.          ---------------------------------------------------
  251.                    EMAIL NETWORK
  252.  
  253.     Has not been implemented yet, but will eventually be just another
  254.     server.  This is one of the reasons why the connect-to-BBS is done
  255.     by the caller rather than have the BBS automatically startup an STERM
  256.     on protocol startup ... this way, future enhancements such as an
  257.     automated email network can be added without the burden of automatically
  258.     starting up a BBS everytime.
  259.  
  260.     I also plan to implement a CRON based auto-dialer for email transfer.
  261.  
  262.         ----------------------------------------------
  263.  
  264.                    RUNNING AS A DBBS
  265.  
  266.     The DBBS server program is a BBS system for the Amiga which runs under
  267.     DNet.  The following is an example command line for automatic
  268.     operation.    Your modem must implement the CD (carrier detect) line and
  269.     must disconnect when DTR is dropped.
  270.  
  271.     Run dnet -8 -a -bmaxbaud -sdbbs     (other options may apply)
  272.  
  273.     That is, 8 bits no parity for the initial window (doesn't matter unless
  274.     you have one of those stupid-smart modems), answer mode (automatic
  275.     protocol startup on carrier detect), the maximum baud rate your modem
  276.     can handle, and to run the DBBS client on protocol startup.
  277.  
  278.     The DBBS program is the BBS program itself.  It is a client in that you
  279.     RUN it (or allow DNET to run it via the -s option).  It is a server in
  280.     that it passively waits for connections from the remote end.  This
  281.     program also handles disconnecting users when their time runs out or
  282.     they are idle too long.
  283.  
  284.     REFER to DBBS.DOC FOR FURTHER INFORMATION
  285.  
  286.     Since PUTFILES is a security hole right now, rather than have users
  287.     of the BBS PUTFILES to upload, they will request the BBS to GETFILES
  288.     the files to upload.
  289.  
  290.     *NEVER SET YOUR DNET_LEVEL or DNET_WRITE TO 9 OR ABOVE!  Doing so gives
  291.      remote users sysop level access to DNet.
  292.  
  293.     NOTE:   I intend to implement a mail network at some point.  Remember
  294.     that in the future, users will dial up and connect to your machine to
  295.     do things other than just use the DBBS (i.e. they'll connect to the
  296.     EMAIL server in many cases for an automated mail transfer).
  297.  
  298.  
  299. VERSION 2.04
  300.     Added -m option
  301.     Added -P option, now supports use of XON-XOFF or 7WIRE modes
  302.     Now supports 7 bit lines (only 0x20-0x7F is ever sent)
  303.  
  304. VERSION 2.00
  305.  
  306. VERSION 1.00
  307.  
  308.  
  309.