home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / unix / volume11 / mtools / part01 / Readme < prev   
Encoding:
Text File  |  1987-08-27  |  5.3 KB  |  123 lines
  1.                 MTOOLS v1.2
  2.  
  3. This is a collection of MSDOS tools to allow you to read and write to
  4. MSDOS formatted diskettes from a Unix based system.
  5.  
  6. The following MSDOS commands are emulated:
  7.  
  8. Mtool         MSDOS
  9. name        equivalent    Description
  10. -----        ----        -----------
  11. mdel        DEL/ERASE    delete a MSDOS file
  12. mdir        DIR        display a MSDOS directory
  13. mmd        MD/MKDIR    make a MSDOS sub directory
  14. mrd        RD/RMDIR    remove a MSDOS sub directory
  15. mread        COPY        read (copy) a MSDOS file to Unix
  16. mren        REN/RENAME    rename an existing MSDOS file
  17. mtype        TYPE        display contents of a MSDOS file
  18. mwrite        COPY        write (copy) a Unix file to MSDOS
  19. *        CD        change working directory
  20.  
  21.     * by use of the environmental variable MCWD
  22.  
  23. The formats of IBM PC floppy disk drives are:
  24.  
  25.    bytes per  sectors per  tracks    number    total     disk   introduced
  26.     sector      track     per side  of sides  capacity   size    in MSDOS
  27.      512         8          40        1        160k      5.25      1.0
  28.      512         9          40        1        180k      5.25      1.1
  29.      512         8          40        2        320k      5.25      2.0
  30.      512         9          40        2        360k      5.25      2.0
  31.      512        15          80        2        1.2M      5.25      3.0
  32.      512         9          80        2        720k       3.5      3.2
  33.  
  34.  
  35. The following are typical Unix device names for the IBM formats:
  36.  
  37.     /dev/rflp        'generic' used first to test the media
  38.     /dev/rflp40t8s1s    40 track 8 sector single sided
  39.     /dev/rflp40t8s2s    40 track 8 sector double sided
  40.     /dev/rflp40t9s1s    40 track 9 sector single sided
  41.     /dev/rflp40t9s2s    40 track 9 sector double sided
  42.     /dev/rflp80t15s2s    80 track 15 sector double sided
  43.     /dev/rflp80t9s2s    3.5 inch 80 track 9 sector double sided
  44.  
  45. These device names are in the msdos.h file as #defines and must be edited
  46. to match the device names on your system.  If your device driver does not
  47. handle all of the formats shown, then you should leave those particular
  48. devices undefined in the msdos.h file.
  49.  
  50. This program can be easily customized to accept non-standard disk formats.
  51. For example, a popular disk format for Unix machines seems to be 80 track,
  52. double sided, 8 sector.  This doesn't conform to any of the IBM standard
  53. formats, but MSDOS 3.30 can be made to format virtually anything using the
  54. DRIVER.SYS parameters in the CONFIG.SYS file.  Let's take a hypothetical
  55. case of a brand X Unix machine with a 80 track, double sided, 8 sector
  56. disk drive.  You could purchase an external 80 track drive for your IBM
  57. compatible computer and format the drive D: under MSDOS 3.30 with the
  58. following DRIVER.SYS parameters:
  59.  
  60.     DEVICE=DRIVER.SYS /D:2 /T:80 /S:8 /H:2 /F:2
  61.  
  62. Then, you would edit the init.c file to include the new non-standard
  63. parameters.  You might need Norton Utilities, or some other program,
  64. to determine the statistics of the format.  Using our example, the
  65. format would have the following parameters:
  66.  
  67.     FAT#1    sectors 1 - 3        fat_len = 3
  68.     FAT#2    sectors 4 - 6        dir_start = 4
  69.     DIR    sectors 7 - 13        dir_len = 7
  70.     cluster size is 2 sectors    clus_size = 2
  71.     there are 633 clusters        num_clus = 633
  72.  
  73. Now, the diskette formated on your PC's external drive can be used in
  74. both your PC and your Unix machine.  Obviously, that diskette could not
  75. be used in other IBM compatibles, unless they too had an external 80
  76. track drive.  That means that you'd need to copy your data from a normal
  77. 40 track diskette to the 80 track diskette prior to moving it to your
  78. Unix machine.  Likewise, you'd need to copy the 80 track diskette to a
  79. 40 track diskette to be able to move data from the Unix machine to
  80. another PC.
  81.  
  82. The manuals are very terse... it's assumed that the reader is already
  83. familiar with MSDOS.
  84.  
  85. The use of the environmental variable MCWD to keep track of the current
  86. working directory is a little awkward, especially since there is no
  87. 'change directory' command.  Bourne shell users will have to type two
  88. commands to set their working directory, ie:
  89.  
  90.     MCWD=/TMP
  91.     export MCWD
  92.  
  93. Wildcards are only applied to filenames and not to directory names.
  94. For example '/usr/local/*.c' is appropriate, but '/usr/l*/main.c' is not.
  95.  
  96. I really wanted to avoid the use of a 'text' mode and a 'data' mode
  97. when transferring files, but I couldn't find a better way.  It gets rather
  98. confusing and it's quite possible to mess up a file if you apply the
  99. text mode when it is not appropriate (ie: to a COM or EXE file).  Likewise,
  100. if you forget to apply the text mode (to a Unix text file) then if the
  101. file is used under MSDOS, it will be missing carriage returns.  However,
  102. if you aren't going to use the files on your Unix system (you just
  103. intend to hold the files and then transfer them back to MSDOS later) then
  104. you shouldn't use the text mode during either mread or mwrite.  This is
  105. because, the text mode is only useful if the files are gonna be used
  106. under Unix.
  107.  
  108. Mwrite adds an EOF marker to every file (not just text files).  Mread
  109. ignores all EOF markers.
  110.  
  111. The MSDOS 'copy' command had to be broken down into two separate Unix
  112. commands since the MSDOS device designations (A: or C:) would be
  113. clumsy to implement.
  114.  
  115. Mtools is also available in versions especially written for Masscomp
  116. computers and the AT&T Unix PC 7300.
  117.  
  118. Emmet P. Gray                US Army, HQ III Corps & Fort Hood
  119. ...!ihnp4!uiucuxc!fthood!egray        Attn: AFZF-DE-ENV
  120.                     Directorate of Engineering & Housing
  121.                     Environmental Management Office
  122.                     Fort Hood, TX 76544-5057
  123.