Miroirs/mame
1
0
Fork 0
mirror of https://github.com/mamedev/mame.git synced 2024-11-16 07:48:32 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions
mame/docs/source/tools/imgtool.rst
Firehawke b2e11d00e0 More docs work: escapes, debugger update (nw) (#3168) 
* Missed a couple escape sequences. (nw)

* A little more escaping, acronym fixes, fix oddity in symlist (nw)

* Update debugger internal help to match docs (nw)

* Lowercasing for CPU in command parameters, fix casing on ASCII. (nw)
2018-02-05 20:27:02 +11:00

1676 lines
61 KiB
ReStructuredText
Raw Blame History

Imgtool - *A generic image manipulation tool for MAME*
======================================================
Imgtool is a tool for the maintenance and manipulation of disk and other types of images that MAME users need to deal with. Functions include retrieving and storing files and CRC checking/validation.
Imgtool is part of the MAME project. It shares large portions of code with MAME, and its existence would not be if it were not for MAME. As such, the distribution terms are the same as MAME. Please read the MAME license thoroughly.
**Some portions of Imgtool are Copyright (c) 1989, 1993 The Regents of the University of California. All rights reserved.**
Using Imgtool
=============
Imgtool is a command line program that contains several "subcommands" that actually do all of the work. Most commands are invoked in a manner along the lines of this:
**imgtool <subcommand> <format> <image> ...**
* **<subcommand>** is the name of the subcommand
* **<format>** is the format of the image
* **<image>** is the filename of the image
Example usage:
imgtool dir coco_jvc_rsdos myimageinazip.zip
imgtool get coco_jvc_rsdos myimage.dsk myfile.bin mynewfile.txt
imgtool getall coco_jvc_rsdos myimage.dsk
Further details vary with each subcommand. Also note that not all subcommands are applicable or supported for different image formats.
Imgtool Subcommands
===================
**create**
**imgtool create <format> <imagename> [--(createoption)=value]**
* <format> is the image format, e.g. coco_jvc_rsdos
* <imagename> is the image filename; can specify a ZIP file for image name
Creates an image
**dir**
**imgtool dir <format> <imagename> [path]**
* <format> is the image format, e.g. coco_jvc_rsdos
* <imagename> is the image filename; can specify a ZIP file for image name
Lists the contents of an image
**get**
**imgtool get <format> <imagename> <filename> [newname] [--filter=filter] [--fork=fork]**
* <format> is the image format, e.g. coco_jvc_rsdos
* <imagename> is the image filename; can specify a ZIP file for image name
Gets a single file from an image
**put**
**imgtool put <format> <imagename> <filename>... <destname> [--(fileoption)==value] [--filter=filter] [--fork=fork]**
* <format> is the image format, e.g. coco_jvc_rsdos
* <imagename> is the image filename; can specify a ZIP file for image name
Puts a single file on an image (wildcards supported)
**getall**
**imgtool getall <format> <imagename> [path] [--filter=filter]**
* <format> is the image format, e.g. coco_jvc_rsdos
* <imagename> is the image filename; can specify a ZIP file for image name
Gets all files off an image
**del**
**imgtool del <format> <imagename> <filename>...**
* <format> is the image format, e.g. coco_jvc_rsdos
* <imagename> is the image filename; can specify a ZIP file for image name
Deletes a file on an image
**mkdir**
**imgtool mkdir <format> <imagename> <dirname>**
* <format> is the image format, e.g. coco_jvc_rsdos
* <imagename> is the image filename; can specify a ZIP file for image name
Creates a subdirectory on an image
**rmdir**
**imgtool rmdir <format> <imagename> <dirname>...**
* <format> is the image format, e.g. coco_jvc_rsdos
* <imagename> is the image filename; can specify a ZIP file for image name
Deletes a subdirectory on an image
**readsector**
**imgtool readsector <format> <imagename> <track> <head> <sector> <filename>**
* <format> is the image format, e.g. coco_jvc_rsdos
* <imagename> is the image filename; can specify a ZIP file for image name
Read a sector on an image and output it to specified <filename>
**writesector**
**imgtool writesector <format> <imagename> <track> <head> <sector> <filename>**
* <format> is the image format, e.g. coco_jvc_rsdos
* <imagename> is the image filename; can specify a ZIP file for image name
Write a sector to an image from specified <filename>
**identify**
* <format> is the image format, e.g. coco_jvc_rsdos
* <imagename> is the image filename; can specify a ZIP file for image name
**imgtool identify <imagename>**
**listformats**
Lists all image file formats supported by imgtool
**listfilters**
Lists all filters supported by imgtool
**listdriveroptions**
**imgtool listdriveroptions <format>**
* <format> is the image format, e.g. coco_jvc_rsdos
Lists all format-specific options for the 'put' and 'create' commands
Imgtool Filters
===============
Filters are a means to process data being written into or read out of an image in a certain way. Filters can be specified on the get, put, and getall commands by specifying --filter=xxxx on the command line. Currently, the following filters are supported:
**ascii**
Translates end-of-lines to the appropriate format
**cocobas**
Processes tokenized TRS-80 Color Computer (CoCo) BASIC programs
**dragonbas**
Processes tokenized Tano/Dragon Data Dragon 32/64 BASIC programs
**macbinary**
Processes Apple MacBinary-formatted (merged forks) files
**vzsnapshot**
[todo: VZ Snapshot? Find out what this is....]
**vzbas**
Processes Laser/VZ Tokenized Basic Files
**thombas5**
Thomson MO5 w/ BASIC 1.0, Tokenized Files (read-only, auto-decrypt)
**thombas7**
Thomson TO7 w/ BASIC 1.0, Tokenized Files (read-only, auto-decrypt)
**thombas128**
Thomson w/ BASIC 128/512, Tokenized Files (read-only, auto-decrypt)
**thomcrypt**
Thomson BASIC, Protected file encryption (no tokenization)
**bm13bas**
Basic Master Level 3 Tokenized Basic Files
Imgtool Format Info
===================
Amiga floppy disk image (OFS/FFS format) - (*amiga_floppy*)
------------------------------------------------------------
Driver specific options for module 'amiga_floppy':
No image specific file options
Image specific creation options (usable on the 'create' command):
================ ============================== =============================================================
Option Allowed values Description
---------------- ------------------------------ -------------------------------------------------------------
--density dd/hd Density
--filesystem ofs/ffs File system
--mode none/intl/dirc File system options
================ ============================== =============================================================
Apple ][ DOS order disk image (ProDOS format) - (*apple2_do_prodos_525*)
-------------------------------------------------------------------------
Driver specific options for module 'apple2_do_prodos_525':
No image specific file options
Image specific creation options (usable on the 'create' command):
================ ============================== =============================================================
Option Allowed values Description
---------------- ------------------------------ -------------------------------------------------------------
--heads 1 Heads
--tracks 35 Tracks
--sectors 16 Sectors
--sectorlength 256 Sector Bytes
--firstsectorid 0 First Sector
================ ============================== =============================================================
Apple ][ Nibble order disk image (ProDOS format) - (*apple2_nib_prodos_525*)
-----------------------------------------------------------------------------
Driver specific options for module 'apple2_nib_prodos_525':
No image specific file options
Image specific creation options (usable on the 'create' command):
================ ============================== =============================================================
Option Allowed values Description
---------------- ------------------------------ -------------------------------------------------------------
--heads 1 Heads
--tracks 35 Tracks
--sectors 16 Sectors
--sectorlength 256 Sector Bytes
--firstsectorid 0 First Sector
================ ============================== =============================================================
Apple ][ ProDOS order disk image (ProDOS format) - (*apple2_po_prodos_525*)
----------------------------------------------------------------------------
Driver specific options for module 'apple2_po_prodos_525':
No image specific file options
Image specific creation options (usable on the 'create' command):
================ ============================== =============================================================
Option Allowed values Description
---------------- ------------------------------ -------------------------------------------------------------
--heads 1 Heads
--tracks 35 Tracks
--sectors 16 Sectors
--sectorlength 256 Sector Bytes
--firstsectorid 0 First Sector
================ ============================== =============================================================
Apple ][gs 2IMG disk image (ProDOS format) - (*apple35_2img_prodos_35*)
------------------------------------------------------------------------
Driver specific options for module 'apple35_2img_prodos_35':
No image specific file options
Image specific creation options (usable on the 'create' command):
================ ============================== =============================================================
Option Allowed values Description
---------------- ------------------------------ -------------------------------------------------------------
--heads 1-2 Heads
--tracks 80 Tracks
--sectorlength 512 Sector Bytes
--firstsectorid 0 First Sector
================ ============================== =============================================================
Apple DiskCopy disk image (Mac HFS Floppy) - (*apple35_dc_mac_hfs*)
--------------------------------------------------------------------
Driver specific options for module 'apple35_dc_mac_hfs':
No image specific file options
Image specific creation options (usable on the 'create' command):
================ ============================== =============================================================
Option Allowed values Description
---------------- ------------------------------ -------------------------------------------------------------
--heads 1-2 Heads
--tracks 80 Tracks
--sectorlength 512 Sector Bytes
--firstsectorid 0 First Sector
================ ============================== =============================================================
Apple DiskCopy disk image (Mac MFS Floppy) - (*apple35_dc_mac_mfs*)
--------------------------------------------------------------------
Driver specific options for module 'apple35_dc_mac_mfs':
No image specific file options
Image specific creation options (usable on the 'create' command):
================ ============================== =============================================================
Option Allowed values Description
---------------- ------------------------------ -------------------------------------------------------------
--heads 1-2 Heads
--tracks 80 Tracks
--sectorlength 512 Sector Bytes
--firstsectorid 0 First Sector
================ ============================== =============================================================
Apple DiskCopy disk image (ProDOS format) - (*apple35_dc_prodos_35*)
---------------------------------------------------------------------
Driver specific options for module 'apple35_dc_prodos_35':
No image specific file options
Image specific creation options (usable on the 'create' command):
================ ============================== =============================================================
Option Allowed values Description
---------------- ------------------------------ -------------------------------------------------------------
--heads 1-2 Heads
--tracks 80 Tracks
--sectorlength 512 Sector Bytes
--firstsectorid 0 First Sector
================ ============================== =============================================================
Apple raw 3.5" disk image (Mac HFS Floppy) - (*apple35_raw_mac_hfs*)
---------------------------------------------------------------------
Driver specific options for module 'apple35_raw_mac_hfs':
No image specific file options
Image specific creation options (usable on the 'create' command):
================ ============================== =============================================================
Option Allowed values Description
---------------- ------------------------------ -------------------------------------------------------------
--heads 1-2 Heads
--tracks 80 Tracks
--sectorlength 512 Sector Bytes
--firstsectorid 0 First Sector
================ ============================== =============================================================
Apple raw 3.5" disk image (Mac MFS Floppy) - (*apple35_raw_mac_mfs*)
---------------------------------------------------------------------
Driver specific options for module 'apple35_raw_mac_mfs':
No image specific file options
Image specific creation options (usable on the 'create' command):
================ ============================== =============================================================
Option Allowed values Description
---------------- ------------------------------ -------------------------------------------------------------
--heads 1-2 Heads
--tracks 80 Tracks
--sectorlength 512 Sector Bytes
--firstsectorid 0 First Sector
================ ============================== =============================================================
Apple raw 3.5" disk image (ProDOS format) - (*apple35_raw_prodos_35*)
---------------------------------------------------------------------
Driver specific options for module 'apple35_raw_prodos_35':
No image specific file options
Image specific creation options (usable on the 'create' command):
================ ============================== =============================================================
Option Allowed values Description
---------------- ------------------------------ -------------------------------------------------------------
--heads 1-2 Heads
--tracks 80 Tracks
--sectorlength 512 Sector Bytes
--firstsectorid 0 First Sector
================ ============================== =============================================================
CoCo DMK disk image (OS-9 format) - (*coco_dmk_os9*)
-----------------------------------------------------
Driver specific options for module 'coco_dmk_os9':
No image specific file options
Image specific creation options (usable on the 'create' command):
================ =============================== =============================================================
Option Allowed values Description
---------------- ------------------------------- -------------------------------------------------------------
--heads 1-2 Heads
--tracks 35-255 Tracks
--sectors 1-18 Sectors
--sectorlength 128/256/512/1024/2048/4096/8192 Sector Bytes
--interleave 0-17 Interleave
--firstsectorid 0-1 First Sector
================ =============================== =============================================================
CoCo DMK disk image (RS-DOS format) - (*coco_dmk_rsdos*)
---------------------------------------------------------
Driver specific options for module 'coco_dmk_rsdos':
Image specific file options (usable on the 'put' command):
================ ============================== =============================================================
Option Allowed values Description
---------------- ------------------------------ -------------------------------------------------------------
--ftype basic/data/binary/assembler File type
--ascii ascii/binary ASCII flag
================ ============================== =============================================================
Image specific creation options (usable on the 'create' command):
================ =============================== =============================================================
Option Allowed values Description
---------------- ------------------------------- -------------------------------------------------------------
--heads 1-2 Heads
--tracks 35-255 Tracks
--sectors 1-18 Sectors
--sectorlength 128/256/512/1024/2048/4096/8192 Sector Bytes
--interleave 0-17 Interleave
--firstsectorid 0-1 First Sector
================ =============================== =============================================================
CoCo JVC disk image (OS-9 format) - (*coco_jvc_os9*)
-----------------------------------------------------
Driver specific options for module 'coco_jvc_os9':
No image specific file options
Image specific creation options (usable on the 'create' command):
================ ============================== =============================================================
Option Allowed values Description
---------------- ------------------------------ -------------------------------------------------------------
--heads 1-2 Heads
--tracks 35-255 Tracks
--sectors 1-255 Sectors
--sectorlength 128/256/512/1024 Sector Bytes
--firstsectorid 0-1 First Sector
================ ============================== =============================================================
CoCo JVC disk image (RS-DOS format) - (*coco_jvc_rsdos*)
---------------------------------------------------------
Driver specific options for module 'coco_jvc_rsdos':
Image specific file options (usable on the 'put' command):
================ ============================== =============================================================
Option Allowed values Description
---------------- ------------------------------ -------------------------------------------------------------
--ftype basic/data/binary/assembler File type
--ascii ascii/binary ASCII flag
================ ============================== =============================================================
Image specific creation options (usable on the 'create' command):
================ ============================== =============================================================
Option Allowed values Description
---------------- ------------------------------ -------------------------------------------------------------
--heads 1-2 Heads
--tracks 35-255 Tracks
--sectors 1-255 Sectors
--sectorlength 128/256/512/1024 Sector Bytes
--firstsectorid 0-1 First Sector
================ ============================== =============================================================
CoCo OS-9 disk image (OS-9 format) - (*coco_os9_os9*)
------------------------------------------------------
Driver specific options for module 'coco_os9_os9':
No image specific file options
Image specific creation options (usable on the 'create' command):
================ ============================== =============================================================
Option Allowed values Description
---------------- ------------------------------ -------------------------------------------------------------
--heads 1-2 Heads
--tracks 35-255 Tracks
--sectors 1-255 Sectors
--sectorlength 128/256/512/1024 Sector Bytes
--firstsectorid 1 First Sector
================ ============================== =============================================================
CoCo VDK disk image (OS-9 format) - (*coco_vdk_os9*)
-----------------------------------------------------
Driver specific options for module 'coco_vdk_os9':
No image specific file options
Image specific creation options (usable on the 'create' command):
================ ============================== =============================================================
Option Allowed values Description
---------------- ------------------------------ -------------------------------------------------------------
--heads 1-2 Heads
--tracks 35-255 Tracks
--sectors 18 Sectors
--sectorlength 256 Sector Bytes
--firstsectorid 1 First Sector
================ ============================== =============================================================
CoCo VDK disk image (RS-DOS format) - (*coco_vdk_rsdos*)
---------------------------------------------------------
Driver specific options for module 'coco_vdk_rsdos':
Image specific file options (usable on the 'put' command):
================ ============================== =============================================================
Option Allowed values Description
---------------- ------------------------------ -------------------------------------------------------------
--ftype basic/data/binary/assembler File type
--ascii ascii/binary ASCII flag
================ ============================== =============================================================
Image specific creation options (usable on the 'create' command):
================ ============================== =============================================================
Option Allowed values Description
---------------- ------------------------------ -------------------------------------------------------------
--heads 1-2 Heads
--tracks 35-255 Tracks
--sectors 18 Sectors
--sectorlength 256 Sector Bytes
--firstsectorid 1 First Sector
================ ============================== =============================================================
Concept floppy disk image - (*concept*)
----------------------------------------
Driver specific options for module 'concept':
No image specific file options
No image specific creation options
CopyQM floppy disk image (Basic Master Level 3 format) - (*cqm_bml3*)
----------------------------------------------------------------------
Driver specific options for module 'cqm_bml3':
Image specific file options (usable on the 'put' command):
================ ============================== =============================================================
Option Allowed values Description
---------------- ------------------------------ -------------------------------------------------------------
--ftype basic/data/binary/assembler File type
--ascii ascii/binary ASCII flag
================ ============================== =============================================================
No image specific creation options
CopyQM floppy disk image (FAT format) - (*cqm_fat*)
----------------------------------------------------
Driver specific options for module 'cqm_fat':
No image specific file options
No image specific creation options
CopyQM floppy disk image (Mac HFS Floppy) - (*cqm_mac_hfs*)
------------------------------------------------------------
Driver specific options for module 'cqm_mac_hfs':
No image specific file options
No image specific creation options
CopyQM floppy disk image (Mac MFS Floppy) - (*cqm_mac_mfs*)
------------------------------------------------------------
Driver specific options for module 'cqm_mac_mfs':
No image specific file options
No image specific creation options
CopyQM floppy disk image (OS-9 format) - (*cqm_os9*)
-----------------------------------------------------
Driver specific options for module 'cqm_os9':
No image specific file options
No image specific creation options
CopyQM floppy disk image (ProDOS format) - (*cqm_prodos_35*)
-------------------------------------------------------------
Driver specific options for module 'cqm_prodos_35':
No image specific file options
No image specific creation options
CopyQM floppy disk image (ProDOS format) - (*cqm_prodos_525*)
--------------------------------------------------------------
Driver specific options for module 'cqm_prodos_525':
No image specific file options
No image specific creation options
CopyQM floppy disk image (RS-DOS format) - (*cqm_rsdos*)
---------------------------------------------------------
Driver specific options for module 'cqm_rsdos':
Image specific file options (usable on the 'put' command):
================ ============================== =============================================================
Option Allowed values Description
---------------- ------------------------------ -------------------------------------------------------------
--ftype basic/data/binary/assembler File type
--ascii ascii/binary ASCII flag
================ ============================== =============================================================
No image specific creation options
CopyQM floppy disk image (VZ-DOS format) - (*cqm_vzdos*)
---------------------------------------------------------
Driver specific options for module 'cqm_vzdos':
Image specific file options (usable on the 'put' command):
================ ============================== =============================================================
Option Allowed values Description
---------------- ------------------------------ -------------------------------------------------------------
--ftype basic/binary/data File type
--fname intern/extern Filename
================ ============================== =============================================================
No image specific creation options
Cybiko Classic File System - (*cybiko*)
----------------------------------------
Driver specific options for module 'cybiko':
No image specific file options
Image specific creation options (usable on the 'create' command):
================ ============================== =============================================================
Option Allowed values Description
---------------- ------------------------------ -------------------------------------------------------------
--flash AT45DB041/AT45DB081/AT45DB161 Flash Type
================ ============================== =============================================================
Cybiko Xtreme File System - (*cybikoxt*)
-----------------------------------------
Driver specific options for module 'cybikoxt':
No image specific file options
No image specific creation options
D88 Floppy Disk image (Basic Master Level 3 format) - (*d88_bml3*)
-------------------------------------------------------------------
Driver specific options for module 'd88_bml3':
Image specific file options (usable on the 'put' command):
================ ============================== =============================================================
Option Allowed values Description
---------------- ------------------------------ -------------------------------------------------------------
--ftype basic/data/binary/assembler File type
--ascii ascii/binary ASCII flag
================ ============================== =============================================================
No image specific creation options
D88 Floppy Disk image (FAT format) - (*d88_fat*)
-------------------------------------------------
Driver specific options for module 'd88_fat':
No image specific file options
No image specific creation options
D88 Floppy Disk image (Mac HFS Floppy) - (*d88_mac_hfs*)
---------------------------------------------------------
Driver specific options for module 'd88_mac_hfs':
No image specific file options
No image specific creation options
D88 Floppy Disk image (Mac MFS Floppy) - (*d88_mac_mfs*)
---------------------------------------------------------
Driver specific options for module 'd88_mac_mfs':
No image specific file options
No image specific creation options
D88 Floppy Disk image (OS-9 format) - (*d88_os9*)
--------------------------------------------------
Driver specific options for module 'd88_os9':
No image specific file options
No image specific creation options
D88 Floppy Disk image (OS-9 format) - (*d88_os9*)
--------------------------------------------------
Driver specific options for module 'd88_prodos_35':
No image specific file options
No image specific creation options
D88 Floppy Disk image (ProDOS format) - (*d88_prodos_525*)
-----------------------------------------------------------
Driver specific options for module 'd88_prodos_525':
No image specific file options
No image specific creation options
D88 Floppy Disk image (RS-DOS format) - (*d88_rsdos*)
------------------------------------------------------
Driver specific options for module 'd88_rsdos':
Image specific file options (usable on the 'put' command):
================ ============================== =============================================================
Option Allowed values Description
---------------- ------------------------------ -------------------------------------------------------------
--ftype basic/data/binary/assembler File type
--ascii ascii/binary ASCII flag
================ ============================== =============================================================
No image specific creation options
D88 Floppy Disk image (VZ-DOS format) - (*d88_vzdos*)
------------------------------------------------------
Driver specific options for module 'd88_vzdos':
Image specific file options (usable on the 'put' command):
================ ============================== =============================================================
Option Allowed values Description
---------------- ------------------------------ -------------------------------------------------------------
--ftype basic/binary/data File type
--fname intern/extern Filename
================ ============================== =============================================================
No image specific creation options
DSK floppy disk image (Basic Master Level 3 format) - (*dsk_bml3*)
-------------------------------------------------------------------
Driver specific options for module 'dsk_bml3':
Image specific file options (usable on the 'put' command):
================ ============================== =============================================================
Option Allowed values Description
---------------- ------------------------------ -------------------------------------------------------------
--ftype basic/data/binary/assembler File type
--ascii ascii/binary ASCII flag
================ ============================== =============================================================
No image specific creation options
DSK floppy disk image (FAT format) - (*dsk_fat*)
-------------------------------------------------
Driver specific options for module 'dsk_fat':
No image specific file options
No image specific creation options
DSK floppy disk image (Mac HFS Floppy) - (*dsk_mac_hfs*)
---------------------------------------------------------
Driver specific options for module 'dsk_mac_hfs':
No image specific file options
No image specific creation options
DSK floppy disk image (Mac MFS Floppy) - (*dsk_mac_mfs*)
---------------------------------------------------------
Driver specific options for module 'dsk_mac_mfs':
No image specific file options
No image specific creation options
DSK floppy disk image (OS-9 format) - (*dsk_os9*)
--------------------------------------------------
Driver specific options for module 'dsk_os9':
No image specific file options
No image specific creation options
DSK floppy disk image (ProDOS format) - (*dsk_prodos_35*)
----------------------------------------------------------
Driver specific options for module 'dsk_prodos_35':
No image specific file options
No image specific creation options
DSK floppy disk image (ProDOS format) - (*dsk_prodos_525*)
-----------------------------------------------------------
Driver specific options for module 'dsk_prodos_525':
No image specific file options
No image specific creation options
DSK floppy disk image (RS-DOS format) - (*dsk_rsdos*)
------------------------------------------------------
Driver specific options for module 'dsk_rsdos':
Image specific file options (usable on the 'put' command):
================ ============================== =============================================================
Option Allowed values Description
---------------- ------------------------------ -------------------------------------------------------------
--ftype basic/data/binary/assembler File type
--ascii ascii/binary ASCII flag
================ ============================== =============================================================
No image specific creation options
DSK floppy disk image (VZ-DOS format) - (*dsk_vzdos*)
------------------------------------------------------
Driver specific options for module 'dsk_vzdos':
Image specific file options (usable on the 'put' command):
================ ============================== =============================================================
Option Allowed values Description
---------------- ------------------------------ -------------------------------------------------------------
--ftype basic/binary/data File type
--fname intern/extern Filename
================ ============================== =============================================================
No image specific creation options
Formatted Disk Image (Basic Master Level 3 format) - (*fdi_bml3*)
------------------------------------------------------------------
Driver specific options for module 'fdi_bml3':
Image specific file options (usable on the 'put' command):
================ ============================== =============================================================
Option Allowed values Description
---------------- ------------------------------ -------------------------------------------------------------
--ftype basic/data/binary/assembler File type
--ascii ascii/binary ASCII flag
================ ============================== =============================================================
No image specific creation options
Formatted Disk Image (FAT format) - (*fdi_fat*)
------------------------------------------------
Driver specific options for module 'fdi_fat':
No image specific file options
No image specific creation options
Formatted Disk Image (Mac HFS Floppy) - (*fdi_mac_hfs*)
--------------------------------------------------------
Driver specific options for module 'fdi_mac_hfs':
No image specific file options
No image specific creation options
Formatted Disk Image (Mac MFS Floppy) - (*fdi_mac_mfs*)
--------------------------------------------------------
Driver specific options for module 'fdi_mac_mfs':
No image specific file options
No image specific creation options
Formatted Disk Image (OS-9 format) - (*fdi_os9*)
-------------------------------------------------
Driver specific options for module 'fdi_os9':
No image specific file options
No image specific creation options
Formatted Disk Image (ProDOS format) - (*fdi_prodos_35*)
---------------------------------------------------------
Driver specific options for module 'fdi_prodos_35':
No image specific file options
No image specific creation options
Formatted Disk Image (ProDOS format) - (*fdi_prodos_525*)
----------------------------------------------------------
Driver specific options for module 'fdi_prodos_525':
No image specific file options
No image specific creation options
Formatted Disk Image (RS-DOS format) - (*fdi_rsdos*)
-----------------------------------------------------
Driver specific options for module 'fdi_rsdos':
Image specific file options (usable on the 'put' command):
================ ============================== =============================================================
Option Allowed values Description
---------------- ------------------------------ -------------------------------------------------------------
--ftype basic/data/binary/assembler File type
--ascii ascii/binary ASCII flag
================ ============================== =============================================================
No image specific creation options
Formatted Disk Image (VZ-DOS format) - (*fdi_vzdos*)
-----------------------------------------------------
Driver specific options for module 'fdi_vzdos':
Image specific file options (usable on the 'put' command):
================ ============================== =============================================================
Option Allowed values Description
---------------- ------------------------------ -------------------------------------------------------------
--ftype basic/binary/data File type
--fname intern/extern Filename
================ ============================== =============================================================
No image specific creation options
HP48 SX/GX memory card - (*hp48*)
----------------------------------
Driver specific options for module 'hp48':
No image specific file options
Image specific creation options (usable on the 'create' command):
================ ================================ =============================================================
Option Allowed values Description
---------------- -------------------------------- -------------------------------------------------------------
--size 32/64/128/256/512/1024/2048/4096 Size in KB
================ ================================ =============================================================
IMD floppy disk image (Basic Master Level 3 format) - (*imd_bml3*)
-------------------------------------------------------------------
Driver specific options for module 'imd_bml3':
Image specific file options (usable on the 'put' command):
================ ============================== =============================================================
Option Allowed values Description
---------------- ------------------------------ -------------------------------------------------------------
--ftype basic/data/binary/assembler File type
--ascii ascii/binary ASCII flag
================ ============================== =============================================================
No image specific creation options
IMD floppy disk image (FAT format) - (*imd_fat*)
-------------------------------------------------
Driver specific options for module 'imd_fat':
No image specific file options
No image specific creation options
IMD floppy disk image (Mac HFS Floppy) - (*imd_mac_hfs*)
---------------------------------------------------------
Driver specific options for module 'imd_mac_hfs':
No image specific file options
No image specific creation options
IMD floppy disk image (Mac MFS Floppy) - (*imd_mac_mfs*)
---------------------------------------------------------
Driver specific options for module 'imd_mac_mfs':
No image specific file options
No image specific creation options
IMD floppy disk image (OS-9 format) - (*imd_os9*)
--------------------------------------------------
Driver specific options for module 'imd_os9':
No image specific file options
No image specific creation options
IMD floppy disk image (ProDOS format) - (*imd_prodos_35*)
----------------------------------------------------------
Driver specific options for module 'imd_prodos_35':
No image specific file options
No image specific creation options
IMD floppy disk image (ProDOS format) - (*imd_prodos_525*)
-----------------------------------------------------------
Driver specific options for module 'imd_prodos_525':
No image specific file options
No image specific creation options
IMD floppy disk image (RS-DOS format) - (*imd_rsdos*)
------------------------------------------------------
Driver specific options for module 'imd_rsdos':
Image specific file options (usable on the 'put' command):
================ ============================== =============================================================
Option Allowed values Description
---------------- ------------------------------ -------------------------------------------------------------
--ftype basic/data/binary/assembler File type
--ascii ascii/binary ASCII flag
================ ============================== =============================================================
No image specific creation options
IMD floppy disk image (VZ-DOS format) - (*imd_vzdos*)
------------------------------------------------------
Driver specific options for module 'imd_vzdos':
Image specific file options (usable on the 'put' command):
================ ============================== =============================================================
Option Allowed values Description
---------------- ------------------------------ -------------------------------------------------------------
--ftype basic/binary/data File type
--fname intern/extern Filename
================ ============================== =============================================================
No image specific creation options
MESS hard disk image - (*mess_hd*)
-----------------------------------
Driver specific options for module 'mess_hd':
No image specific file options
Image specific creation options (usable on the 'create' command):
================ ================================================= =============================================================
Option Allowed values Description
---------------- ------------------------------------------------- -------------------------------------------------------------
--blocksize 1-2048 Sectors Per Block
--cylinders 1-65536 Cylinders
--heads 1-64 Heads
--sectors 1-4096 Total Sectors
--seclen 128/256/512/1024/2048/4096/8192/16384/32768/65536 Sector Bytes
================ ================================================= =============================================================
TI99 Diskette (PC99 FM format) - (*pc99fm*)
--------------------------------------------
Driver specific options for module 'pc99fm':
No image specific file options
No image specific creation options
TI99 Diskette (PC99 MFM format) - (*pc99mfm*)
----------------------------------------------
Driver specific options for module 'pc99mfm':
No image specific file options
No image specific creation options
PC CHD disk image - (*pc_chd*)
-------------------------------
Driver specific options for module 'pc_chd':
No image specific file options
Image specific creation options (usable on the 'create' command):
================ ====================================================================== =============================================================
Option Allowed values Description
---------------- ---------------------------------------------------------------------- -------------------------------------------------------------
--cylinders 10/20/30/40/50/60/70/80/90/100/110/120/130/140/150/160/170/180/190/200 Cylinders
--heads 1-16 Heads
--sectors 1-63 Sectors
================ ====================================================================== =============================================================
PC floppy disk image (FAT format) - (*pc_dsk_fat*)
---------------------------------------------------
Driver specific options for module 'pc_dsk_fat':
No image specific file options
Image specific creation options (usable on the 'create' command):
================ ============================== =============================================================
Option Allowed values Description
---------------- ------------------------------ -------------------------------------------------------------
--heads 1-2 Heads
--tracks 40/80 Tracks
--sectors 8/9/10/15/18/36 Sectors
================ ============================== =============================================================
Psion Organiser II Datapack - (*psionpack*)
--------------------------------------------
Driver specific options for module 'psionpack':
Image specific file options (usable on the 'put' command):
================ ============================== =============================================================
Option Allowed values Description
---------------- ------------------------------ -------------------------------------------------------------
--type OB3/OPL/ODB file type
--id 0/145-255 File ID
================ ============================== =============================================================
Image specific creation options (usable on the 'create' command):
================ ============================== =============================================================
Option Allowed values Description
---------------- ------------------------------ -------------------------------------------------------------
--size 8k/16k/32k/64k/128k datapack size
--ram 0/1 EPROM/RAM datapack
--paged 0/1 linear/paged datapack
--protect 0/1 write-protected datapack
--boot 0/1 bootable datapack
--copy 0/1 copyable datapack
================ ============================== =============================================================
Teledisk floppy disk image (Basic Master Level 3 format) - (*td0_bml3*)
------------------------------------------------------------------------
Driver specific options for module 'td0_bml3':
Image specific file options (usable on the 'put' command):
================ ============================== =============================================================
Option Allowed values Description
---------------- ------------------------------ -------------------------------------------------------------
--ftype basic/data/binary/assembler File type
--ascii ascii/binary ASCII flag
================ ============================== =============================================================
No image specific creation options
Teledisk floppy disk image (FAT format) - (*td0_fat*)
------------------------------------------------------
Driver specific options for module 'td0_fat':
No image specific file options
No image specific creation options
Teledisk floppy disk image (Mac HFS Floppy) - (*td0_mac_hfs*)
--------------------------------------------------------------
Driver specific options for module 'td0_mac_hfs':
No image specific file options
No image specific creation options
Teledisk floppy disk image (Mac MFS Floppy) - (*td0_mac_mfs*)
--------------------------------------------------------------
Driver specific options for module 'td0_mac_mfs':
No image specific file options
No image specific creation options
Teledisk floppy disk image (OS-9 format) - (*td0_os9*)
-------------------------------------------------------
Driver specific options for module 'td0_os9':
No image specific file options
No image specific creation options
Teledisk floppy disk image (ProDOS format) - (*td0_prodos_35*)
---------------------------------------------------------------
Driver specific options for module 'td0_prodos_35':
No image specific file options
No image specific creation options
Teledisk floppy disk image (ProDOS format) - (*td0_prodos_525*)
----------------------------------------------------------------
Driver specific options for module 'td0_prodos_525':
No image specific file options
No image specific creation options
Teledisk floppy disk image (RS-DOS format) - (*td0_rsdos*)
-----------------------------------------------------------
Driver specific options for module 'td0_rsdos':
Image specific file options (usable on the 'put' command):
================ ============================== =============================================================
Option Allowed values Description
---------------- ------------------------------ -------------------------------------------------------------
--ftype basic/data/binary/assembler File type
--ascii ascii/binary ASCII flag
================ ============================== =============================================================
No image specific creation options
Teledisk floppy disk image (VZ-DOS format) - (*td0_vzdos*)
-----------------------------------------------------------
Driver specific options for module 'td0_vzdos':
Image specific file options (usable on the 'put' command):
================ ============================== =============================================================
Option Allowed values Description
---------------- ------------------------------ -------------------------------------------------------------
--ftype basic/binary/data File type
--fname intern/extern Filename
================ ============================== =============================================================
No image specific creation options
Thomson .fd disk image, BASIC format - (*thom_fd*)
---------------------------------------------------
Driver specific options for module 'thom_fd':
Image specific file options (usable on the 'put' command):
================ ============================== =============================================================
Option Allowed values Description
---------------- ------------------------------ -------------------------------------------------------------
--ftype auto/B/D/M/A File type
--format auto/B/A Format flag
--comment (string) Comment
================ ============================== =============================================================
Image specific creation options (usable on the 'create' command):
================ ============================== =============================================================
Option Allowed values Description
---------------- ------------------------------ -------------------------------------------------------------
--heads 1-2 Heads
--tracks 40/80 Tracks
--density SD/DD Density
--name (string) Floppy name
================ ============================== =============================================================
Thomson .qd disk image, BASIC format - (*thom_qd*)
---------------------------------------------------
Driver specific options for module 'thom_qd':
Image specific file options (usable on the 'put' command):
================ ============================== =============================================================
Option Allowed values Description
---------------- ------------------------------ -------------------------------------------------------------
--ftype auto/B/D/M/A File type
--format auto/B/A Format flag
--comment (string) Comment
================ ============================== =============================================================
Image specific creation options (usable on the 'create' command):
================ ============================== =============================================================
Option Allowed values Description
---------------- ------------------------------ -------------------------------------------------------------
--heads 1-2 Heads
--tracks 25 Tracks
--density SD/DD Density
--name (string) Floppy name
================ ============================== =============================================================
Thomson .sap disk image, BASIC format - (*thom_sap*)
-----------------------------------------------------
Driver specific options for module 'thom_sap':
Image specific file options (usable on the 'put' command):
================ ============================== =============================================================
Option Allowed values Description
---------------- ------------------------------ -------------------------------------------------------------
--ftype auto/B/D/M/A File type
--format auto/B/A Format flag
--comment (string) Comment
================ ============================== =============================================================
Image specific creation options (usable on the 'create' command):
================ ============================== =============================================================
Option Allowed values Description
---------------- ------------------------------ -------------------------------------------------------------
--heads 1 Heads
--tracks 40/80 Tracks
--density SD/DD Density
--name (string) Floppy name
================ ============================== =============================================================
TI990 Hard Disk - (*ti990hd*)
------------------------------
Driver specific options for module 'ti990hd':
No image specific file options
Image specific creation options (usable on the 'create' command):
================== ============================== =============================================================
Option Allowed values Description
------------------ ------------------------------ -------------------------------------------------------------
--cylinders 1-2047 Cylinders
--heads 1-31 Heads
--sectors 1-256 Sectors
--bytes per sector (typically 25256-512 256-512 Bytes Per Sector [Todo: This section is glitched in imgtool]
================== ============================== =============================================================
TI99 Diskette (old MESS format) - (*ti99_old*)
-----------------------------------------------
Driver specific options for module 'ti99_old':
No image specific file options
Image specific creation options (usable on the 'create' command):
================ ============================== =============================================================
Option Allowed values Description
---------------- ------------------------------ -------------------------------------------------------------
--sides 1-2 Sides
--tracks 1-80 Tracks
--sectors 1-36 Sectors (1->9 for SD, 1->18 for DD, 1->36 for HD)
--protection 0-1 Protection (0 for normal, 1 for protected)
--density Auto/SD/DD/HD Density
================ ============================== =============================================================
TI99 Harddisk - (*ti99hd*)
---------------------------
Driver specific options for module 'ti99hd':
No image specific file options
No image specific creation options
TI99 Diskette (V9T9 format) - (*v9t9*)
---------------------------------------
Driver specific options for module 'v9t9':
No image specific file options
Image specific creation options (usable on the 'create' command):
================ ============================== =============================================================
Option Allowed values Description
---------------- ------------------------------ -------------------------------------------------------------
--sides 1-2 Sides
--tracks 1-80 Tracks
--sectors 1-36 Sectors (1->9 for SD, 1->18 for DD, 1->36 for HD)
--protection 0-1 Protection (0 for normal, 1 for protected)
--density Auto/SD/DD/HD Density
================ ============================== =============================================================
Laser/VZ disk image (VZ-DOS format) - (*vtech1_vzdos*)
-------------------------------------------------------
Driver specific options for module 'vtech1_vzdos':
Image specific file options (usable on the 'put' command):
================ ============================== =============================================================
Option Allowed values Description
---------------- ------------------------------ -------------------------------------------------------------
--ftype basic/binary/data File type
--fname intern/extern Filename
================ ============================== =============================================================
Image specific creation options (usable on the 'create' command):
================ ============================== =============================================================
Option Allowed values Description
---------------- ------------------------------ -------------------------------------------------------------
--heads 1 Heads
--tracks 40 Tracks
--sectors 16 Sectors
--sectorlength 154 Sector Bytes
--firstsectorid 0 First Sector
================ ============================== =============================================================
[todo: fill out the command structures, describe commands better. These descriptions came from the imgtool.txt file and are barebones]
Reference in a new issue View git blame Copy permalink