home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / cpm / zmodem / rzmp13.lbr / RZMP.DZC / RZMP.DOC
Text File  |  1988-12-17  |  5KB  |  104 lines
  1.                        RZMP Documentation
  2.  
  3.      RZMP allows remote access systems (RCP/Ms etc.) running CP/M 
  4. or  its  Z80-based derivatives (Z80DOS,  ZRDOS and so  forth)  to 
  5. perform Zmodem transfers to and from remote users.  Derived  from 
  6. ZMP,  it  does all of its modem I/O through BYE and thus does not 
  7. need  to  be  installed for  different  systems.  An  overlay  is 
  8. provided,  however,  to allow the sysop to configure RZMP for his 
  9. or  her  own requirements.  A Z80 processor is necessary  to  run 
  10. RZMP.
  11.  
  12.      Security  in RZMP is provided by accessing a wheel byte,  as 
  13. is  common in such programs.  The address of this byte is set  in 
  14. the  overlay.  If  your  system doesn't have  such  a  byte,  set 
  15. 'whladd'  to point to a location which is permanently zero.  This 
  16. means  that  all users will have the  same  privileges,  but  the 
  17. system  will remain secure.  To a non-wheel user,  RZMP restricts 
  18. the  drive/user areas from which files can be  sent,  forces  all 
  19. uploads to be either the standard upload area or a private  area, 
  20. and restricts filenames and filetypes which can be downloaded and 
  21. uploaded.  Wheels  may upload and download anything anywhere.  In 
  22. addition, RZMP checks the transfer time of transmitted files, and 
  23. refuses to permit the transfer if the user has insufficient  time 
  24. remaining (unless he's a wheel!).  If a user attempts to upload a 
  25. file  which  already exists on the target  drive/user  area,  the 
  26. action  taken depends on whether he's a wheel or not.  If he  is, 
  27. the  old file is renamed to .BAK and the transfer begins.  If the 
  28. user is not a wheel, the transfer is aborted.
  29.  
  30.      RZMP  is tailored to the sysop's requirements by an overlay, 
  31. which is installed in the same way as ZMP's is. The difference is 
  32. that  no  modem i/o need be written,  as all modem  i/o  is  done 
  33. through  BYE.  There  are  some terminal functions which  may  be 
  34. changed,  in  the same way as those for ZMP,  but these  are  not 
  35. necessary as nobody is watching the screen on most remote systems 
  36. anyway. The overlay allows the following:
  37.  
  38.      1) Setting the addresses of the wheel and mspeed bytes;
  39.      2) Setting of  the addresses which point to the user's upload 
  40.      and download counts in the current session;
  41.      3) Setting  the upload drive/user area for  non-wheels,  and 
  42.      the private download and upload areas, also for non-wheels;
  43.      4) Setting the processor clock speed; and
  44.      5) Setting  a  list of bad  filetypes which  RZMP  will  not 
  45.      permit non-wheels to upload or download, such as .COM files, 
  46.      ZCPR3  .ENV files etc.  On upload,  they will be changed  to 
  47.      .OBJ; they may not be downloaded at all.
  48.  
  49.      Instructions  for  setting these variables are contained  in 
  50. the  file RZMPOVL.MAC,  contained in this library.  There is also 
  51. provision  in  the overlay for setting the drive/user area for  a 
  52. ZMP.LOG file,  to log all uploads and downloads to disk.  This is 
  53. not yet operational: ignore it for now.
  54.  
  55.      Information as to remaining time,  maximum du:  etc. are all 
  56. obtained from BYE.  Perhaps eventually a non-BYE version will  be 
  57. produced,  but for now RZMP will abort if BYE is not running.  It 
  58. is  also  necessary to modify BYE to allow RZMP to properly  send 
  59. files:  details on these modifications are contained in the  file 
  60. BYEMODS.DOC,  also in this library. Note that, although the modem 
  61. routines  are  contained in the .MAC file,  RZMP itself uses  BYE 
  62. extensively for many functions.  Do not try to put separate modem 
  63. routines in here: the results are unpredictable.
  64.  
  65. Operation.
  66. ----------
  67.  
  68.      RZMP is command line driven.  Typing RZMP on its own gives a 
  69. short help message. RZMP R receives files, RZMP S <filename list> 
  70. sends files.  The suffix P following R or S (e.g.  RZMP RP) sends 
  71. or receives files from/to the private areas for non-wheels. ZCPR-
  72. style  drive/user  areas may be specified for the send  function. 
  73. Filenames to be sent should be separated by spaces:
  74.  
  75. A>RZMP S C3:BORING.PRG A7:BETTER.NOW
  76.  
  77. and  so  on.  Transfers may be aborted locally  by  pressing  the 
  78. escape  key,  or remotely by sending CAN characters  (control-X). 
  79. Usually five will suffice.
  80.  
  81.  
  82. Finally:
  83. --------
  84.  
  85.      RZMP  was  developed from ZMP,  which in turn was  developed 
  86. from  Hal Maney's HMODEM II.  Again,  thanks are due to  Hal  for 
  87. providing the basis for a viable set of CP/M Zmodem programs.
  88.      The files contained in this library are hereby placed in the 
  89. public  domain.  This  means I'm not responsible for anything  it 
  90. does.  If  you drop the disk containing RZMP on  your  foot,  for 
  91. example,  don't sue me.  And please don't claim you wrote it,  or 
  92. sell  it  for profit,  or any one of the other four deadly  sins. 
  93. Comments, bug reports etc. are welcome. Destructive comments will 
  94. be placed in the round filing cabinet. Send comments to:
  95.  
  96.      Z-Node 62
  97.      Perth, Western Australia
  98.      (61+) 09-450-0200
  99.  
  100.           -- Ron Murray
  101.              12/10/88
  102. :
  103.  
  104. A>RZMP S C3:BORING.PRG A7:BET