jurjen.ladeniusandClaude Opus 4.8
f3340e86c6
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
191 lines
6.0 KiB
Plaintext
191 lines
6.0 KiB
Plaintext
|
|
DSKTOOL v1.3 by Ricardo Bittencourt
|
|
Updated by Tony Cruise 2010
|
|
Updated by Natalia Pujol 2017
|
|
|
|
---------------------------------------------------------------------------
|
|
|
|
Index
|
|
|
|
1. Introduction
|
|
2. Syntax
|
|
3. Examples
|
|
4. Suggestions
|
|
5. What's new
|
|
6. Greetings
|
|
7. The author
|
|
|
|
---------------------------------------------------------------------------
|
|
|
|
1. Introduction
|
|
|
|
Hello, world.
|
|
|
|
Most of the MSX emulator users know the .DSK file format. It's
|
|
a single file containing all the information from an entire floppy disk.
|
|
These files are also used by real MSX users to trade programs not in
|
|
MSX-DOS format, like most of the Compile games.
|
|
|
|
The usual way to make a .DSK archive is by using a program called
|
|
"DCOPY". This program copy the contents of floppy disk to a .DSK archive.
|
|
But, what if you want to add files to your .DSK archive?
|
|
|
|
Until now, the only way would be copy the entire .DSK to a floppy,
|
|
then copy the files to the floppy, and then copy the floppy back to .DSK
|
|
format. This is a slow method and requires a temporary floppy disk.
|
|
|
|
To make things easy, I made the "DSKTOOL" program. With DSKTOOL,
|
|
you can add files to your .DSK archive, without all the slow steps required
|
|
in the previous method. With DSKTOOL you can also list the contents of a
|
|
.DSK archive and extract or delete files from an archive.
|
|
|
|
The current version is compiled to the Win32 platform, compiled
|
|
using Visual Studio 2010.
|
|
|
|
The executable and source code are under GNU GPL (support free
|
|
software!!)
|
|
|
|
---------------------------------------------------------------------------
|
|
|
|
2. Syntax
|
|
|
|
The syntax of DSKTOOL is very similar to the ARJ compressor:
|
|
|
|
DSKTOOL command archive [files]
|
|
|
|
"command" is one of the four supported commands:
|
|
|
|
C n create a new disk (where 'n' is 360, 720, 1440, 2880)
|
|
I show floppy boot sector info
|
|
L[H] list the contents of the archive
|
|
E[H] extract files from the archive
|
|
A[H] add files to the archive
|
|
D delete files from the archive
|
|
F show file clusters list
|
|
O[H] get file info for a raw disk offsett
|
|
|
|
Some commands can use H suffix to change to ADVH Filesystem mode.
|
|
|
|
[files] is a list of files. The "*" wildcard is supported.
|
|
|
|
If you try to add files to a non-existent archive, DSKTOOL will
|
|
create a new archive and initialize the .DSK with a MSX-DOS 1 boot.
|
|
|
|
The only type of .DSK supported is the 720kb one (80 tracks,
|
|
9 sectors per track, 2 sides).
|
|
|
|
---------------------------------------------------------------------------
|
|
|
|
3. Examples
|
|
|
|
3.1. List the contents of TALKING.DSK:
|
|
|
|
DSKTOOL L TALKING.DSK
|
|
|
|
3.2. Extract all the .TXT files from AMDTOOLS.DSK:
|
|
|
|
DSKTOOL E AMDTOOLS.DSK *.TXT
|
|
|
|
3.3. Add the game ZANAC to GAMEPACK.DSK
|
|
|
|
DSKTOOL A GAMEPACK.DSK ZANAC.BAS ZANAC*.BIN
|
|
|
|
3.4. Delete all the .BIN files from ZORAX.DSK
|
|
|
|
DSKTOOL D ZORAX.DSK *.BIN
|
|
|
|
3.5. Show floppy info
|
|
|
|
DSKTOOL I BACKUP.DSK
|
|
|
|
3.6. Show file clusters list
|
|
|
|
DSKTOOL F BACKUP.DSK FAIL.TXT
|
|
|
|
3.7. Get file info for a raw disk offset
|
|
|
|
DSKTOOL O BACKUP.DSK 307712
|
|
|
|
3.8. Create a new disk
|
|
|
|
DSKTOOL C 720 NEWDISK.DSK
|
|
|
|
---------------------------------------------------------------------------
|
|
|
|
4. Suggestions
|
|
|
|
This program does everything I wanted it to do. This means I will
|
|
not make any extension to this version (unless I find some bug).
|
|
But, with the source code, you can make improvements to the program.
|
|
Some suggestions are:
|
|
|
|
4.1. A GUI, maybe like the Norton Commander, or a full Win95 GUI.
|
|
4.2. Support to directories and MSX-DOS 2 disks.
|
|
4.3. Include other types of archives, like DDI or IMG.
|
|
4.4. Port to other platforms (Mac, Amiga, MSX-SCSI, etc.)
|
|
|
|
It would be nice if you tell me of any new version.
|
|
|
|
---------------------------------------------------------------------------
|
|
|
|
5. What's new
|
|
|
|
[1.4]
|
|
- Added support to create/read 360Kb, 720Kb, 1440Kb and 2880Kb disks.
|
|
- Bug fixes
|
|
[1.3]
|
|
- ported to GCC Linux/MinGW
|
|
- support to 180Kb and 360Kb (new images 720Kb only)
|
|
- read of ADVH propietary filesystem
|
|
- added option to show floppy boot sector info (I)
|
|
- added option to show file clusters list (F)
|
|
- added option to get file info for a raw disk offset (O)
|
|
- set date/time when added new files
|
|
- show file attribs in file list
|
|
- improved some functions
|
|
- makefile created
|
|
[1.2]
|
|
- ported to Win32
|
|
- fixed memory leak in add_single_file
|
|
[1.1]
|
|
- fixed a bug with files greater than 64kb
|
|
|
|
---------------------------------------------------------------------------
|
|
|
|
6. Greetings
|
|
|
|
All the information needed to make this program was obtained from
|
|
the books:
|
|
|
|
"Guia do Programador MSX" - by Eduardo A. Barbosa
|
|
"MSX Top Secret" - by Edison A. Pires de Moraes
|
|
|
|
Many thanks to the authors!!
|
|
I also want to thanks DJ Delorie, Charles Sandmann and all the
|
|
people behind the DJGPP project. Of course, many thanks to Richard Stallman
|
|
and all the GNU people!! I couldn't forget the people from msxbr-l mailing
|
|
list, and remember: MSX still alive!!!
|
|
|
|
---------------------------------------------------------------------------
|
|
|
|
7. The author
|
|
|
|
If you find any bug, want to make any comment, or have problems
|
|
to understand the source code, send a e-mail to:
|
|
|
|
tony.cruise@cruiseresearch.net
|
|
|
|
You can also reach me through my home page:
|
|
|
|
http://www.electricadventures.net
|
|
|
|
Hope you find this program useful.
|
|
|
|
|
|
Tony Cruise
|
|
|
|
Github for latest version:
|
|
https://github.com/nataliapc/MSX_devs
|
|
|
|
NataliaPC (@ishwin74)
|