Page Comparison

...

Creates empty disk images of a given standard or custom disk type or a custom disk size
Transfers existing disk images of one type to disk images of another type.

To start the utility open "cmd.exe" in the Start menu and switch to the CHARON executables directory ("C:\Program Files\CHARON\Build_XXX\x86").

Back to Table of Contents

...

Choose the desired disk type (for example "RZ22") , then use the "mkdskcmd" command to create the virtual disk image as shown below:

...> mkdskcmd -disk rz22 -output rz22.vdisk

A disk container "rz22.vdisk" will be created in the current directory.

Info
A file "rz22.avdisk" will also be created. This file helps CHARON to accurately recognize a specific disk image type. It is recommended to put the ".avdisk" file in the same directory as the created disk image.

...

...> mkdskcmd -help

Usage:
   mkdskcmd [Options]

Options:
   -help                 - to see help screen
   -h                    - to see help screen

   -output <full name>   - to specify output file name
   -o <full name>        - to specify output file name

   -disk <disk name>     - to specify the disk name from Disk table
   -d <disk name>        - to specify the disk name from Disk table

   -blsize <number>      - to specify the block size in bytes (custom disk image)
   -z <number>           - to specify the block size in bytes (custom disk image)

   -blcount <number>     - to specify number of the blocks (custom disk image)
   -c <number>           - to specify number of the blocks (custom disk image)

   -avtable <full_name>  - to specify AVDISK table file
   -a <full_name>        - to specify AVDISK table file

   -list <full_name>     - to display AVDISK table
   -l <full_name>        - to display AVDISK table

   -silent               - silent mode running
   -s                    - silent mode running

   -t - please see the '-transform' options description
   -transform <source_disk_name> <source_disk_params> - to transform the the disk image (change actual size)

   <source_disk_name> - the file name of the disk image to be transformed
   <source_disk_params> - the name of the disk from the list of available at the Disk table

   The source disk size will changed accordingly the reach the specified parameters.
   To specify the transform parameters manually, follow the option below:

   -transform <source_disk_name> -blsize <number> -blcount <number>

  -shrink - parameter which needs to be EXPLICITLY provided, if the disk size is to be decreased
  -k - parameter which needs to be EXPLICITLY provided, if the disk size is to be decreased

Return value:
   0        - for Success
   Non zero - in case of failure

Examples:

 mkdskcmd -help
 mkdskcmd -list
 mkdskcmd -avtable \etc\mkdsk.vtable -output "\etc\rk07.vdisk" -disk rk07
 mkdskcmd -output \etc\disks\custom.vdisk -blsize 512 -blcount 16384
 mkdskcmd -t E:\disks\rz22.vdisk rz59 -a "C:\Program Files\CHARON\disks\mkdsk.vtable

The "-avtable" parameter is used to work with an alternative disk specification database (or to point to the standard database ("mkdsk.vtable") if it is in a location other than the current directory).

The "-blcount" (blocks count) and "-blsize" (blocks size) switches are used to create custom disk images.

Back to Table of Contents

...

Info
If a source disk image is larger than the target disk image, the extra data is lost. If the source disk image is smaller, it will be extended and padded with null bytes ('\0').

An example of the syntax follows:

...> mkdskcmd -transfer <source disk file name> <source disk parameters> [-shrink] [-k]

...

<source disk file name> - the file name of the disk image to be transferred
<source disk parameters> - the disk type taken from the list of available disk types displayed by the "mkdskcmd -list" command or the disk geometry specification (see below).
-shrink or -k - used to force the shrink when the target disk size is smaller than the source disk size.

Example:

...> mkdskcmd -transfer "C:\My Disks\rz22.vdisk" rz25

...

...> mkdskcmd -transfer <source disk file name> -blsize <number> -blcount <number>

Example:

...> mkdskcmd -t "C:\My Disks\custom.vdisk" -z 512 -c 262134

...

Versions Compared

Old Version 2

New Version 3

Key