home *** CD-ROM | disk | FTP | other *** search
- $Header: MINDOS.T_V 1.4 91/04/05 15:51:42 SWH Exp $
-
- MINDOS v1.1
- ===========
-
-
- ********************************************************************
- * *
- * COPYRIGHT STATEMENT *
- * =================== *
- * *
- * All the files in this MINDOS package, including, but not *
- * limited to, sources, executables, documentation, are: *
- * *
- * COPYRIGHT 1988,1991 STEVEN W. HARROLD -- ALL RIGHTS RESERVED *
- * *
- * You may use this MINDOS package and its components for any *
- * purpose, except that you are not permitted to sell or *
- * exchange the contents of the package for remuneration. You *
- * may use MINDOS to build other products that you intend to *
- * make a profit from, but this MINDOS package must not itself *
- * exchange hands for financial gain. You may reproduce this *
- * package for someone else and charge only for the cost of *
- * materials expended, not to exceed $10. If you do reproduce *
- * the package, you must do so only in its entirety, and name *
- * the result MINDOS11. *
- * *
- * CAVEATS *
- * ======= *
- * *
- * Although I have attempted to provide an error-free package I *
- * will accept NO LIABILITY for any damages that result from *
- * your use of the software. *
- * *
- ********************************************************************
-
-
- WHAT MINDOS DOES
- ================
-
- This utility package allows you to read any file inside a Minix File
- System (MFS) from MSDOS. The programs offered are:
-
- MBLOCK.EXE Display any block in an MFS, in hex
- MDISK.EXE Tells you the physical attributes of a disk/drive
- MDUMP.EXE Dumps the blocks controlling the content of a MFS
- MLS.EXE Presents an 'ls -l' listing of MFS contents
- MREAD.EXE Reads a file in an MFS and copies to DOS file system
-
-
- CONTENTS OF ARCHIVE
- ===================
-
- The contents of the archive are:
-
- MINDOS.TXT This file (the one you're reading)
- MANIFEST List of source files and revisions used
- MAKEFILE Makefile to recompile
- *.EXE The commands described above
- *.C C sources
- *.H C header files
- *.X C prototype files
-
-
- RUNNING A PROGRAM
- =================
-
- The commands all respond to a "-?" to yield help information, e.g.
-
- MLS -?
-
- If a problem occurs while accessing a floppy, a status byte, as returned
- from the PC BIOS, is displayed. Some of the most probable codes are:
-
- 2 Address mark not found
- 4 Sector not found
- 8 DMA overrun
- 16 Uncorrectable CRC error
- 32 General controller failure (probably disk is unformatted)
- 64 Seek failure
- 128 Device not ready
-
- Only the last one is recoverable by you.
-
-
- DISK DEVICES SUPPORTED
- ======================
-
- This package currently services only floppy disk drives. It determines,
- through trial and error, the geometry of the inserted disk. The actual
- type of DRIVE is not determined (e.g. it cannot distinguish between the
- two 720KB possibilities), but this doesn't matter as only the DISK
- geometry is important.
-
- The possibilites recognized are:
-
- disk heads tracks sectors
- -------------- ----- ------ -------
- 160 KB 5.25" 1 40 8 rare
- 320 KB 5.25" 2 40 8 less rare
- 360 KB 5.25" 2 40 9 DSSD
- 720 KB 5.25" 2 80 9 popular in Europe?
- 1.2 MB 5.25" 2 80 15 DSDD
- 720 KB 3.5" 2 80 9 low density
- 1.4 MB 3.5" 2 80 18 high density
-
-
- RECOMPILING
- ===========
-
- The sources and makefile have been successfully used (under MSDOS) with:
-
- OPUS Make 5.11 (the follow-on to NDMAKE)
- Microsoft C 5.1
- Turbo C 2.0
-
- To recompile, examine the makefile to insure it is suitable for your
- environment. In particular, comment out the group of macro statements
- at the top to select either the Microsoft or Turbo environment.
-
- All the executables are produced by:
-
- MAKE
-
-
- SPECIAL THANKS
- ==============
-
- I want to acknowledge the help, advice and patience of:
-
- Chris G. Sylvain cgs@umd5.umd.edu
-
- He got me off my duff to clean up the package and to encourage me
- to plan for and begin work on a more feature-rich version. He also
- was the guinea pig for working out bugs and usability problems.
-
-
- CONTACT
- =======
-
- Please address all communications to one of the following places:
-
- Steve Harrold,
- 620 Brenda Lee Drive,
- San Jose CA 95123
-
- also: swh@hpesf.cup.hp.com
- also 408/447-5580 (daytime)
-
-
- I hope MINDOS proves useful to all of you, and that you will
- communicate your feedback me, especially ideas for the next version.
-
-
- ---
- swh, 05 apr 91
-