home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / OSK / CMDS / mtools_3.6.src.lzh / Readme.OSK
Text File  |  1997-11-17  |  4KB  |  98 lines
  1.                             GNU Mtools ver. 3.6 for OSK
  2.  
  3.  
  4.   This is an OS-9 port of the GNU utilities Mtools version 3.6.  It can be
  5. used for basic operations on MS DOS diskettes (and probably also hard
  6. disks).  It uses VFAT, so it can handle long file names and preserve upper
  7. and lower case of letters in file names.
  8.  
  9.   The archive consists of three files:
  10.  
  11. mtools_3.6.cmds.lzh
  12. mtools_3.6.docs.lzh
  13. mtools_3.6.src.lzh
  14.  
  15.    The names of the utilities have been changed by adding 's' as the second
  16. letter to avoid the conflict with the standard OS-9 utility "mdir".  So
  17. "mdir" became "msdir" and "mcopy" became "mscopy".  In the "*cmds*" archive
  18. I have also added one of the scripts, "mcheck" renamed to "mscheck", which
  19. checks if all the files on a diskette are readable.  I configured it for use
  20. with the PD Korn shell.
  21.  
  22.    The "*docs*" archive contains the original GNU documentation in nroff and
  23. texi format.  For your convenience, I have added the translations into
  24. PostScript, ready to be printed on a PS printer.
  25.  
  26.    The "*src*" archive contains the sources and my Makefile.  I used gcc2
  27. compiler ver. 2.7.2 with some Ultra C utilities.  All my changes are marked
  28. with the _OSK macro.
  29.  
  30.    You will need descriptors properly set up to handle the MS DOS diskettes.
  31. It is not important which file manager do you use, provided it can handle
  32. raw reads/writes.  The standard RBF is OK. Here are the descriptors that 
  33. I use on a VME147:
  34.  
  35. for 3.5" HD diskettes:
  36.  
  37. name=pc0  port=$FFFE4000
  38.  vector = 29  irq level = 5  priority = 1  mode = $A7
  39.  manager = pcf  driver = rb5400  devcon = scsi147
  40.  drv=5 stp=3 typ=$21 dns=$03 cyl=80 sid=2 vfy=1 (off) sct=15 t0s=15
  41.  sas=2 ilv=5 tfm=0 toffs=0 soffs=1 ssize=512 cntl=$0000 trys=1 lun=2
  42.  wpc=0 rwr=0 park=0 lsnoffs=0 totcyls=80 ctrlrid=6 rates=$00
  43.  scsiopt=$0000
  44.  
  45. for 5.25" HD diskettes:
  46.  
  47. name=pc1  port=$FFFE4000
  48.  vector = 29  irq level = 5  priority = 1  mode = $A7
  49.  manager = pcf  driver = rb5400  devcon = scsi147
  50.  drv=5 stp=3 typ=$24 dns=$03 cyl=80 sid=2 vfy=1 (off) sct=9 t0s=9
  51.  sas=2 ilv=5 tfm=0 toffs=0 soffs=1 ssize=512 cntl=$0000 trys=1 lun=0
  52.  wpc=0 rwr=0 park=0 lsnoffs=0 totcyls=80 ctrlrid=6 rates=$10
  53.  scsiopt=$0000
  54.  
  55. and similarly for DD diskettes.  As you can see, I use the Microware PCF
  56. file manager, but you can use as well the standard RBF manager.  There is a
  57. utility called "dmode", written by Carl Kreider, which enables one to change
  58. the parameters in the device descriptors on the fly.  It is available from
  59. os9archive.rtsi.com.  Type "dmode" and then "dmode -?" for explanations.
  60. To check if your descriptor is ready for reading or writing MS DOS
  61. diskettes, login as superuser, insert a diskette in the drive, and type
  62. "dump /pc0@" (I assume that the name of your descriptor is "pc0").
  63.  
  64.    Unfortunately I cannot set up the path to the driver by setting options
  65. from within my program.  Only the first 14 bytes of the option section can
  66. be changed by _ss_opt, so you cannot set for instance _sgr_ssize (the sector
  67. size).  This feature is hard coded in RBF and taken over by other file
  68. managers.  This is why you have to modify the device descriptors yourself.
  69.  
  70.    By default, the drives in OS-9 version of Mtools are configured as
  71. follows:
  72.  
  73.   pc1 is drive a: for HD 5.25"
  74.   pc0 is drive b: for HD 3.5"
  75.  
  76.    You may change this by using a global configuration file located at
  77. /dd/sys/mtools.conf or by using a local configuration file .mtoolsrc in your
  78. home directory (defined by the environment variable HOME).  See the GNU
  79. manual for details.
  80.  
  81.   In the original Unix version most of the utilities are implemented as
  82. links to one common program called "mtools".  I preferred to supply separate
  83. main programs using one common library.  The original "mtools" program is
  84. also compiled: if you rename it, say, to "msdir", it will have the full
  85. functionality of "mdir" (although it will be slightly larger in size).  The
  86. following utilities are left not implemented: mmount, mpartition and mzip.
  87.  
  88.    Mtools can be easily configured for Unix systems.  I find it useful for
  89. transferring files between my Alpha station at work and my OS-9 MM/1a
  90. computer at home, while preserving the exact file names.  I have tested this
  91. port on a VME147 with an OMTI 5400 controller and on my MM/1a at home.
  92.  
  93.   
  94.     Andrzej Kotanski
  95.  
  96.   (kotanski@desy.de  or  kotanski@if.uj.edu.pl)
  97.                                                        Hamburg, November 1997.
  98.