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