Samtools is a public domain collection of programs to allow Sun or Linux
systems to read and write files on a SAMDOS or MasterDOS diskette.  Other
systems may read and write disk image files.

samdir      - display a Sam diskette directory
samdiskread - read a Sam diskette into a file
samdiskwrite- write a Sam diskette from a file
samerase    - erase a Sam disk file
samformat   - format a Sam diskette
samlabel    - label a MasterDOS diskette
samread     - read a file from a Sam diskette
samrename   - rename a file on a Sam diskette
samsnap     - convert .SNA snapshots to and from Sam format
samtype     - display a file from a Sam diskette
samwrite    - write a file on a Sam diskette

The C files may be compiled with the supplied Makefile.  You will first
have to decide whether to define SUN_DKIO: if you are using SunOS, do
it - if not then don't.  I don't know whether it works on Solaris.  The
effect of defining this symbol is to allow the program to configure the
disk drive for 10 sectors per track.  If you don't define it you can still
use samtools to manipulate disk images.  On Linux you can still access an
actual disk because you can create a device /dev/fd0D800 that is already
configured for the correct format (someone who knows says: "It's just an
extra line in MAKEDEV.  Copy the /dev/fd0D720 line (the DD MSDOS disk
device) and change the minor device from 16 to 120 and change the 720 in
the filename to 800").  If users of other systems would like to supply code
to configure the disk interface then that would be gratefully accepted.

The Makefile comes with SUN_DKIO defined: if you do not want it just
delete it from the list of C flags.

If you wish you may also alter the file sam.h to change the default device
name which is usually "/dev/rfd0" (for example to use the above Linux name).
You may also alter the names of the environment variables (but what's the
point?).  Do not change any of the numbers!

After this configuration just type "make" to make the programs.  There
is no install program - just stick the binaries in a bin directory and
the man files in a man directory (under man1/).

The man files are in a format suitable for input to the "man" command.
To view them without using "man", type

nroff -man <manfile> | more

(replacing "more" with the name of your favourite pager, if appropriate).