README.TXT
上传用户:better800
上传日期:2022-06-13
资源大小:1853k
文件大小:28k
源码类别:

TCP/IP协议栈

开发平台:

DOS

  1.                                       WATTCP
  2.                                   Installation Notes
  3.                                    by Erick Engelke
  4.           Introduction          Introduction
  5.                TCP/IP is not a program, it is a set of protocols which have
  6.                been  implemented on many machines.  All machines running an
  7.                implementation  of TCP/IP  and connected  to the  world wide
  8.                Internet are capable of communicating with each other.
  9.                There    are    several   popular    non-commercial   TCP/IP
  10.                implementations for MS-DOS computers.   Each offers  special
  11.                features but with  varied drawbacks.  I  don't believe there
  12.                is a clear choice  of one implementation for all  needs, but
  13.                users  are free to pick the best or most useful applications
  14.                from each offering.
  15.                These  notes  describe  the various  applications  available
  16.                today.    Please remember  that  the  applications are  free
  17.                software, you  may use them and pass  them on to others, but
  18.                there is no warranty  and the support is very  limited.  You
  19.                also may not sell the included programs.
  20.           Installation          Installation
  21.                WATTCP  only works  if you  have  a packet  driver, a
  22.                special program which allows  your network interface card to
  23.                talk with the WATTCP applications.
  24.                Thanks to  some very  generous people,  particularly Russell
  25.                Nelson, you probably will  not have to buy a  packet driver.
  26.                If you are  using Ethernet  hardware you  can probably  find
  27.                free  packet drivers  for  your cards  via anonymous  ftp to
  28.                www.crynwr.com.
  29.                            ____________________        ___________
  30.                WATTCP only  supports  Class 1  drivers.   Officially
  31.                these  are called  Ethernet  class drivers,  but many  other
  32.                types  of  networks have  drivers  which  make them  emulate
  33.                Ethernet hardware.  For example, any Novell system using IPX
  34.                or any IBM compatible Token Ring  network can be made to act
  35.                like Ethernet.  Even serial lines (SLIP) emulate Ethernet if
  36.                you use  Michael Martineau's  ETHERSLIP driver  available by
  37.                anonymous ftp from owl.nstn.ns.ca in in.coming/etherslip.                                  ______________    ___________________
  38.                To start using WATTCP software you will need to get it
  39.                configured.    There  are  two  options,  using BOOTP  or  a
  40.                configuration file.
  41.                If  you think  you may  have a  BOOTP server  on  your local
  42.                subnet, copy  the file  TCPINFO.EXE into a  new subdirectory
  43.                and  run the command  TCPINFO.  It  may take  a few seconds.
  44.                After a maximum of 30 seconds, TCPINFO should tell you if it
  45.                could get configured via  BOOTP.  If it could  not, or BOOTP
  46.                is too slow, you will have to use a configuration file.
  47.                You will  probably want a configuration file  anyways, as it
  48.                allows some  extra things which  are not inherent  in BOOTP.
  49.                WATTCP lets  you use a config file,  and pick up extra
  50.                things from BOOTP.
  51.                If you don't  really know  what you are  doing, continue  on
  52.                with this section and make a config file.
  53.                First  you will  need  some important  information from  you
  54.                local TCP/IP guru.   Do not merely guess, these  values must
  55.                be correct or you may do some damage and get yourself on the
  56.                death threat list from your local network people.
  57.                IP address (eg. 4.1.2.23)
  58.                     my_ip =  ______.______.______.______
  59.                local subnet mask (eg. 255.255.254.0, never 255.255.255.255)
  60.                     netmask = ______.______.______.______
  61.                local gateway (eg. 4.1.2.1)
  62.                     gateway = ______.______.______.______
  63.                primary name server (eg. 129.97.128.1)
  64.                     nameserver = ______.______.______.______
  65.                alternate name servers (up to 9 more if so desired)
  66.                just keep repeating this line with new addresses.
  67.                     nameserver = ______.______.______.______
  68.                name domains list, (eg. UWaterloo.ca  or  edu)
  69.                d   o   m   a   i   n   s   l   i   s   t                  =
  70.                          __________________________________________________
  71.                These  values must be  placed in  a file  called WATTCP.CFG.
  72.                Below is a sample copy, remember, do  not use my values, get
  73.                the correct ones!
  74.                     print="using sample configuration" # sample comment
  75.                     print="contact local network guru for more details"
  76.                     my_ip=129.97.176.99
  77.                     netmask=255.255.254.0              # sample comment
  78.                     nameserver=129.97.128.24           ; sample comment
  79.                     nameserver=129.97.128.196          # alt nameserver
  80.                     nameserver=129.97.128.1            # 3rd nameserver
  81.                     gateway=129.97.176.1
  82.                     domainslist="uwaterloo.ca"
  83.                The rules are simple, directive=value.  
  84.                If quotes are not used in the value field, the value will be
  85.                terminated by  the start of a  comment or by a  newline, and
  86.                all white space (spaces and tabs) are removed.
  87.                If you specify quotes around the value, only a second set of
  88.                quotes  or a newline will  end the value  field and comments
  89.                must  be preceded  by  an end  quote  mark.   Whitespace  is
  90.                preserved inside quotes.
  91.                Place the  WATTCP.CFG file in  the same subdirectory  as the
  92.                TCP  application programs.  If  the file is  not found there
  93.                the programs automatically look for the file in the  current
  94.                subdirectory of the current  disk.  Failing that, a  message
  95.                will  be  displayed but  the  program  will not  necessarily
  96.                abort.
  97.                You may  override the above directory  choices by explicitly
  98.                setting the path in an environment variable.
  99.                eg.  set wattcp.cfg=n:internet
  100.                The environment  variable is  checked first,  and  if it  is
  101.                defined  that   configuration  file   is  used.     This  is
  102.                particularly  useful on installations  where the software is
  103.                located on  a fileserver,  but individual  workstations will
  104.                need separate configuration files.
  105.           Testing          Testing
  106.                First,  to  ensure  that  you  entered  all  the  parameters
  107.                correctly, run  TCPINFO.  It will list all system constants.
  108.                If one or more  of them seem incorrect, check  your spelling
  109.                in the WATTCP.CFG file.
  110.                Next  we will test the  PING command to  see that everything
  111.                works  and asks  another computer  if it is  up.   The first
  112.                argument to  PING is  the name of  the other computer.   The
  113.                second argument is the  number of retries.  Since  your guru
  114.                supplied  the ip  address of  a gateway,  we will  first try
  115.                that.
  116.                     ping  129.97.128.1  5         don't  use  129.97.128.1,
  117.                                                   use  your   gateway's  IP
  118.                                                   address
  119.                This will generate five attempts.  You should have more than
  120.                0  % success.   Otherwise  your gateway is  down or  your ip
  121.                address or gateway is wrong.
  122.                If  you  had success,  try pinging  the  ip address  of your
  123.                nameserver.
  124.                eg.  ping  129.97.128.196  5
  125.                Now check your nameserver by trying to resolve the name of a
  126.                local machine.  Near me is a machine named 'cupid'.
  127.                     ping  cupid  5
  128.                If that did  not work, your  various nameserver entries  are
  129.                incorrect, your  gateway or network mask  is incorrect, your
  130.                nameservers did not want to provide name service, or you did
  131.                not specify a valid name.
  132.                These tests will  help your  guru figure out  what might  be
  133.                wrong.
  134.           Applications          Applications
  135.                TCPINFO               TCPINFO
  136.                     Displays the current Ethernet/TCP configuration.  It is
  137.                     useful for  testing spelling and contents  of files and
  138.                     for determining ethernet addresses.
  139.                PING               PING
  140.                          PING  [-d|/d]  [-s|/s]  hostname  [attempts]
  141.                     You  have already  seen PING  described briefly  in the
  142.                     installation section.  PING will not generate more than
  143.                     one  request  per second,  it  also  attempts to  block
  144.                     broadcast attempts.
  145.                     PING can be used in a debugging mode (-d or /d).
  146.                     eg.  PING  -d  129.97.128.1
  147.                     If  you do  not specify  the number  of attempts  to be
  148.                     made, only one attempt will be made.
  149.                     eg.  PING  129.97.128.196
  150.                     Specifying  /s will  ping  the other  machine once  per
  151.                     second for a very long time.
  152.                     eg.  PING  -s  129.97.128.196
  153.                COOKIE               COOKIE
  154.                          COOKIE [host]
  155.                     eg.  COOKIE
  156.                          COOKIE  conehead.uwaterloo.ca
  157.                     Print a witty saying from one of the cookie servers.
  158.                DAYTIME                DAYTIME
  159.                     Print the time of day using TCP
  160.                          DAYTIME  host
  161.                     eg.  DAYTIME  129.97.128.1
  162.                          DAYTIME  watmath.uwaterloo.ca
  163.                     If the  host supports TCP based  DAYTIME text services,
  164.                     the time of  day will  be displayed as  a text  string.
  165.                     See also NTIME
  166.                FINGER               FINGER
  167.                     Determine user or system information
  168.                          FINGER [user]@host
  169.                     eg.  FINGER  erick@engmail.uwaterloo.ca
  170.                          FINGER  @engmail.uwaterloo.ca
  171.                     Finger returns  the remote computer's information  on a
  172.                     particular user.
  173.                     If no user  is specified, FINGER will return  the names
  174.                     of currently logged users on that machine.
  175.                LPR               LPR
  176.                     Spool print jobs
  177.                LPQ               LPQ
  178.                     Query the print queue
  179.                          Run these commands with no arguments for the exact
  180.                          syntax.   Check to  see that the  appropriate host
  181.                          privileges are extended to the pc.
  182.                          An explanation beyond this  is beyond the scope of
  183.                          this brief document, see your local UNIX guru with
  184.                          HOSTS.LPR   or   whatever   s/he   feels   is     
  185.                          appropriate.
  186.                NTIME               NTIME
  187.                     Set DOS time from the Network.
  188.                     NTIME  host  [addminutes]
  189.                     NTIME contacts the host  and requests the current time.
  190.                     Computers are  supposed to  respond with the  number of
  191.                     seconds  since Jan 1, 1900 GMT.  Many simply return the
  192.                     current time adjusted to  the daylight savings time and
  193.                     time  zone.  I allow  you to specify  addminutes if you
  194.                     need  to add or subtract a certain number of minutes to
  195.                     the returned time.
  196.                     I was considering using  a DST conversion algorithm but
  197.                     have not yet done so.
  198.                TCPPORT                TCPPORT
  199.                     Treat the serial port as a TCP connection
  200.                          TCPPORT host port "program options"
  201.                     Host is the name  or ip address of the  remote computer
  202.                     and port is the TCP port number on that computer.
  203.                     You  may  specify  the  terminal  emulation desired  by
  204.                     setting the environment variable
  205.                          set  tcpterm=termtype
  206.                     eg.  set  tcpterm=vt102
  207.                     See the section on TCPPORT below
  208.                REXEC               REXEC
  209.                     Execute the following command on a remote host
  210.               
  211.                     REXEC  host  [user [pass]] cmd
  212.                     The  "cmd"  command  will  be executed  on  the  remote
  213.                     computer.  If  you fail to specify  either the password
  214.                     or the userid, you will be prompted for them.
  215.                     eg.  rexec  hq.iraq  "ls -l"
  216.                          rexec  hq.iraq  saddam  "ls -l"
  217.                          rexec  hq.iraq saddam white_flag_of_victory "ls"
  218.                     REXEC does not do terminal interpretation, you may wish
  219.                     to  have  NANSI.SYS  loaded  to  provide  the necessary
  220.                     emulation.  WATTCP REXEC is good when you wish to
  221.                     redirect output to a file.
  222.           Other WATTCP Programs          Other WATTCP Programs
  223.                The above  programs are relatively  simple demonstrations of
  224.                the  capabilities of  the  WATTCP TCP/IP  kernal.   Advanced
  225.                programs are usually distributed  separately as they tend to
  226.                be  updated   in  a  different  schedule   from  the  kernal
  227.                libraries.
  228.                MSKERMIT 3.11               MSKERMIT 3.11
  229.                     One  of  the first  popular  uses  for WATTCP  was  its
  230.                     ability to make communication programs such as MSKERMIT
  231.                     act like  TELNET facilities.   So overwhelming  was the
  232.                     number of  requests that  MSKERMIT 3.11 now  includes a
  233.                     derivative  of   the  WATTCP  kernal  and  the  TCPPORT
  234.                     application.
  235.                TELNETD               TELNETD
  236.                     The next  most popular use is easily TELNETD, a program
  237.                     which  allows you to TELNET into your pc and control it
  238.                     using  any  TELNET program  on  any  computer platform.
  239.                     TELNETD   can   be   found   via   anonymous   ftp   to
  240.                     dark.uwaterloo.ca in pub/wattcp/telnetd.zip.
  241.           Using Communications Programs with TCPPORT          Using Communications Programs with TCPPORT
  242.                You may wish to use  a terminal communication program rather
  243.                than TELNET.  WATTCP  makes this very easy to do  with
  244.                its  TCPPORT  program.    Now  that  TCPPORT  is built  into
  245.                MSKermit I don't really have a good example, but here goes:
  246.                Start by creating a configuration  file which tells your com
  247.                program  to use the BIOS  ports rather than  hardware.  Then
  248.                create a batch file which looks like:
  249.                TNCOMM.BAT
  250.                     echo off
  251.                     tcpport %1 23 "c:comm"
  252.                Here I was assuming you kept comm.exe in the root  of C: and
  253.                tcpport could be found somewhere in  the path.  Now you  can
  254.                easily TELNET to any host by typing:
  255.                     TNCOMM  host
  256.                eg.  TNCOMM  129.97.128.1
  257.                or   TNCOMM  watmath.uwaterloo.ca
  258.                After  you  log off,  WATTCP  returns the  characters
  259.                forming  [??Host  closed   connection??]  or  some   similar
  260.                message.  You simply need to exit your com program.  Exiting
  261.                kermit without logging off  will simply close the connection
  262.                and typically log you off.
  263.                You may  select a specific terminal  emulation which TCPPORT
  264.                should  try  to  run  by  setting  the  tcpterm  environment
  265.                variable before running tcpterm:
  266.                eg.  set tcpterm=vt102
  267.           Advanced WATTCP.CFG Options          Advanced WATTCP.CFG Options
  268.                This  section  is  useful  once  you  have  determined  that
  269.                WATTCP actually works for you.
  270.                Including Sub-Config Files
  271.                     You may wish to use a combination of generic WATTCP.CFG
  272.                     file  and  a  smaller  sub-config file  which  will  be
  273.                     located  on  the  user's  private  subdirectory.    Any
  274.                     command which can be placed in the main config file may
  275.                     also be placed (or replaced) in the sub-command file.
  276.                     eg. 
  277.                          include = c:local.cfg
  278.                     After the subcommand file  is parsed, Wattcp returns to
  279.                     the  main config  file.   The depth  of this  system is
  280.                     limited by  the number  of file  handles and  the stack
  281.                     size.
  282.                     If  the  subcommand  file  cannot be  found,  an  error
  283.                     message will  be printed.   To allow for  the possible,
  284.                     but not-essential existance of a file (i.e., include it
  285.                     if  it is there, but don't  complain otherwise) you may
  286.                     simply prepend the filename with a question mark.
  287.                     eg.
  288.                          include = ?c:local.cfg
  289.                IP Addresses
  290.                     Most network  administrators would  prefer to  not have
  291.                     many  copies of  the configuration  file, but  rather a
  292.                     single  file  from   which  everyone   can  be   easily
  293.                     configured.  
  294.                     As  demonstrated above,  WATTCP  normally accepts
  295.                     the ip number from within the WATTCP.CFG file.  
  296.                BOOTP
  297.                     Many  sites prefer  to use  BOOTP, a  standard protocol
  298.                     which  requests  the  user's   ip  address  and   other
  299.                     information from a BOOTP server.
  300.                     To use BOOTP, you must specify the name 'bootp':
  301.                          my_ip = bootp
  302.                     in the config file.  This will broadcast the request on
  303.                     the local subnet.   You  may specify  a specific  BOOTP
  304.                     server which need not be on the same subnet, by using:
  305.                          bootp = host
  306.                     eg.  bootp = 129.97.128.1
  307.                     The  default  timeout value  is  30 seconds.    You may
  308.                     change that by using:
  309.                          bootpto = seconds
  310.                     eg.  bootpto = 50
  311.                     If no  WATTCP.CFG file is found,  WATTCP programs
  312.                     always resort to BOOTP.
  313.                ETHERNET to IP Table
  314.                     Another option currently  exists, I  allow multiple  IP
  315.                     numbers in WATTCP.CFG  with each  one being  tied to  a
  316.                     particular Ethernet address.  If your  Ethernet address
  317.                     is found in list, your IP address will be assigned.
  318.                          ETHIP=ethaddr,ipaddr
  319.                     eg.  ETHIP=00:01:2F:BC:44:33,128.252.35.4
  320.                     In  this   case,  the  machine  with  Ethernet  address
  321.                     00:01:2F:BC:44:33  would  be  assigned  the  ip address
  322.                     128.252.35.4.    Note   that  Ethernet  addresses   are
  323.                     hexadecimal with intermediate  colons, ip addresses are
  324.                     dotted  decimal, and I use a comma to separate the two.
  325.                     Also, since  WATTCP removes white  space, you may
  326.                     place  a space between any  of the fields  if you don't
  327.                     use quotes, and  you may  end the line  with a  comment
  328.                     describing  where  the  station  lives or  to  whom  it
  329.                     belongs.
  330.                     You can quickly find the Ethernet  address of a station
  331.                     by running the TCPINFO command.
  332.                Subnets
  333.                     The Internet is comprised of many, many subnets.  There
  334.                     are several  protocols normally used to  help computers
  335.                     reach computers on other subnets.
  336.                     Most PC based  TCP kernals depend on  routing tables to
  337.                     manage the possible  routes, so I  elected to use  that
  338.                     strategy.
  339.                     A  routing  table  exists  in  memory  with  a  current
  340.                     capacity  for 12  different  routes.   Each route  must
  341.                     specify a gateway, an  optional destination subnet, and
  342.                     then an optional subnet mask.
  343.                          gateway = gate_ip [, subnet [, subnet_mask ]]
  344.                     eg.  gateway = 129.97.176.1        # default
  345.                     eg.  gateway = 129.97.176.2, 129.97.0.0, 255.255,0,0
  346.                     The  first  example  shows  how a  default  gateway  is
  347.                     created.  A default gateway is used if no other choices
  348.                     exist.
  349.                     The second example shows how to specify a gateway for a
  350.                     particular subnet.  In this example, whenever the 'top'
  351.                     16 bits are 129.97, that gateway will be used.
  352.                     Yes,  you need not always  specify the mask,  but it is
  353.                     necessary for class B subnets, so I simply suggest that
  354.                     you always do specify the mask.
  355.                     You  may specify  the same  gateway several  times with
  356.                     different routes.  
  357.                     Non-contiguous subnet bits are supported.
  358.                     To check  your configuration and to  see the precedence
  359.                     of gateways, run TCPINFO.EXE.
  360.                Host Name
  361.                     Some applications will wish  to know your PC's name,  a
  362.                     short  textual  name.    This   may  be  set  with  the
  363.                     WATTCP.CFG line:
  364.                          hostname = name
  365.                     eg.  hostname = mole
  366.                     Notice that  you do  not  specify the  domain, that  is
  367.                     found from the domain string.
  368.                Timeouts
  369.                     Most WATTCP programs  have  a specified  timeout
  370.                     value between activity  before a timeout error  occurs.
  371.                     For  example,  the maximum  response  time  to an  open
  372.                     request  before the  connection is  given up  should be
  373.                     reasonably  long so  that distant  connections will  be
  374.                     usable, but short enough that the user will not believe
  375.                     the computer has hung.
  376.                     Applications may specify  their own timeout value,  but
  377.                     if  they  chose  to  use  the  system  default (all  my
  378.                     applications do), the default value may be set from the
  379.                     WATTCP.CFG file.
  380.                          SOCKDELAY=seconds
  381.                     eg.  SOCKDELAY=40
  382.                     The  default value is 30  seconds.  A  smaller value is
  383.                     unwise,   but  larger  values   may  be  necessary  for
  384.                     particularly bad connections.
  385.                Maximum Segment Size
  386.                     If you understand MSS and know what you would like, you
  387.                     can change it:
  388.                          MSS=bytes
  389.                     eg.  MSS=512
  390.                Cookie Server
  391.                     You may specify a cookie server in the  WATTCP.CFG file
  392.                     with the line:
  393.                          cookie = server
  394.                     eg.  cookie = 129.97.128.1
  395.                     eg.  cookie = sunee.uwaterloo.ca
  396.                     Up to 10 separate cookie servers may be added.  TCPINFO
  397.                     will  list  them  all.    BOOTP will  also  add  cookie
  398.                     servers.
  399.                BOOTP Features and Limitations
  400.                     BOOTP is not the greatest  method of configuration.  In
  401.                     fact  there  is   currently  a  committee   looking  at
  402.                     implementing its successor.
  403.                     WATTCP  programs  will  automatically  get  many
  404.                     configuration parameters from the BOOTP server if those
  405.                     values are returned:
  406.                     IP address
  407.                     subnetmask
  408.                     gateway        (only one will be added)
  409.                     nameservers    (all supplied will be added)
  410.                     cookieservers  (all supplied will be added)
  411.                     hostname
  412.                     The domain name cannot be specified currently.   Of the
  413.                     gateways,  only one is recorded by WATTCP as they
  414.                     do not indicate subnets or anything else useful.
  415.           Notes:          Notes:
  416.                The most up-to-date versions  of these files, their sources,
  417.                and  new programs  are  available  on dark.uwaterloo.ca  by
  418.                anonymous FTP.  Check out pub/wattcp.
  419.                All  executables   there  are  copyrighted  but  are  freely
  420.                available for use and non-commercial distribution.
  421.                The library files which do the actual tcp communications are
  422.                also there.   They too are copyrighted,  but may be used  in
  423.                commercial and non-commercial work.   You are free to  do as
  424.                you choose.   If you intend to program  with this package, I
  425.                would  highly  recommend  the  developers  manual  described
  426.                below.
  427.                The  programmers manual includes  examples, a full reference
  428.                of the approximately 50 functions, notes on conversions from
  429.                UNIX.  The  cost is $50 ($US if you live in USA, $Cdn if you
  430.                live in  Canada.  $50 US  for anywhere else.
  431.                 see: http://www.supro.com
  432.           Erick Engelke
  433.           Erick@development.watstar.uwaterloo.ca
  434.           Waterloo TCP Architect
  435.           July 8, 1992