Versions Compared

Old Version 1

changes.mady.by.user Copy Page Tree

Saved on

compared with

New Version 2

changes.mady.by.user Kirill Nikolaev

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Start is updated

...

To start the utility open "cmd.exe" in the Start menu and switch to the CHARON x86 utilities executables directory (typically "C:\Program Files (x86)\CHARON\Utilities_X.X.XXXXXBuild_XXX\x86" or "C:\Program Files\CHARON\Utilities_X.X.XXXXX\x86").

Back to Table of Contents

...

The first step is to obtain the disk type of the disk that needs to be created:

...> mkdskcmd -list

This command results in a list of all the supported disk types.

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.

...

It is also possible to create custom disk images using the "-blcount" (blocks count) and "-blsize" (blocks size) switches.

Div
classpagebreak

 


For a list of all available parameters use the "–help"switch:

...> mkdskcmd -help

mkdisk for CHARON utility v. 1.14
Copyright: STROMASYS, 2015

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

-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

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

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

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

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).

...

Back to Table of Contents

 
Div
classpagebreak


Transferring disk images

The "MkDskCmd" utility is able to transfer (copy) disk images of one type to a disk image of another type.

...

An example of the syntax follows:

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

where:

  • <source disk file name> - the file name of the disk image to be transferred

  • <source disk parameters> - the name of the disk from the list of available on "mkdskcmd --list" request or the disk geometry specification (see below).

  • -shrink or -k - used in the case when the target disk is transferred to a smaller disk.

Example:

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

It is also possible to specify the disk parameters manually with "-blcount / -c" (blocks count) and "-blsize / -z" (blocks size) switches:

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

Example:

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

There is a certain delay between the moment when the utility reports that a disk image has been transferred and its actual availability to CHARON. This delay can reach up to several minutes in the case of very large disk transfers. This is because the host operating systemsneeds time for the actual allocation of the enlarged file on HDD.

...