home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format 51 / af051sub.adf / PARBN31G.DMS / PARBN31G.adf / Extras / netpat.lha / NetPatch / NetPatch.doc < prev    next >
Encoding:
Text File  |  1992-10-13  |  2.6 KB  |  84 lines
  1.         NetPatch V1.1 - Manual
  2.  
  3.  
  4. NAME
  5.     C:NetPatch
  6.  
  7. SYNOPSIS
  8.     NetPatch DEVICE:
  9.  
  10. DESCRIPTION
  11.     NetPatch is a patch for ParNet and SerNet (both (c) 1988-1990 by
  12.     The Software Distillery). Because neither the source codes of ParNet
  13.     nor the ones of SerNet are freely avaible external patches like this
  14.     one are the only way to fix some of the bugs.
  15.  
  16. USAGE
  17.     To activate NetPatch first mount ParNet (or SerNet) e.g. with
  18.     "Mount NET:" and then start NetPatch with "NetPatch NET:". If
  19.     everything works fine "NetPatch installed" will be printed out.
  20.  
  21. THEORY
  22.     What does NetPatch fix ?
  23.      Try the following (with ParNet or SerNet mounted as "NET:"):
  24.  
  25.      CD NET:WhatEverYouWant
  26.      Dir
  27.  
  28.     It will fail with an "Object not found" message. The reason for that
  29.     is a bug in ParNet's ACTION_LOCATE_OBJECT function - it's  used by
  30.     dos.library/Lock() - and NOT the missing support of
  31.     ACTION_NAME_FROM_LOCK as many people believe.
  32.  
  33.     The second bug can be found with any program that uses the new OS 2.0
  34.     function for fast directory reading: dos.library/ExAll(). Probably the
  35.     authors of Paret (and SerNet) forgot to remove a debugging requester
  36.     so that every time ExAll() is used a ugly system requester appears.
  37.  
  38.     How does NetPatch fix that bugs ?
  39.  
  40.      The first bugs is fixed by changing calls like Lock("",...) to calls
  41.      to dos.library/DupLock().
  42.      The second one is fixed by replying the ExAll() call with an
  43.      ERROR_ACTION_NOT_KNOWN code so that the OS 2.0 dos.library emulates
  44.      ExAll() by Examine()/ExNext() calls.
  45.  
  46.      The only working way I found to do that fixes was to patch the
  47.      exec.library/PutMsg() function and change the packets before they
  48.      are sent to the ParNet (or SerNet) handler. This is no very smart
  49.      but it works ...
  50.  
  51.  
  52. HISTORY
  53.     V0.9:    internal release, tested for more than 6 month :-)
  54.     V1.0:    first public release
  55.     V1.1:    fixed 040 bug
  56.  
  57. SOURCE
  58.     The source code in Assembler is included. It may be assembled with
  59.     Ralph "laire" Schmidt's fantastic assembler "Barfly" or with any
  60.     other assembler which uses standard motorol syntax.
  61.  
  62. FUTURUE
  63.     If somebody sends me a working, multitasking friendly and well
  64.     documented parallel network device I'll try to write a better
  65.     network filesystem.
  66.  
  67. CREDITS
  68.     Thanks to Katja Pfeiffer for giving me her A500 for over a half year
  69.     so I could develope this patch.
  70.  
  71. COPYRIGHT
  72.     NetPatch is free to be spread on public-domain and shareware disks as
  73.     long as they are sold for a reasonable charge that is less than $6.
  74.     This applies not to Fred Fish, he and ONLY he can take more money.
  75.     For use in commercial products the permission of the author is
  76.     required.
  77.  
  78. AUTHOR
  79.     Matthias Scheler
  80.     Schützenstraße 18
  81.     D-4799 Borchen
  82.  
  83.     INTERNET: tron@uni-paderborn.de
  84.