Command Line Usage
Hex Workshop allows users the ability to open files, logical drives, and physical drives via the command line.
Usage:
hworks32 [file|drive|fixeddisk|/HEXCODE:file|/SRECORDS:file [/READONLY] [/FILELIST] [/GOTO:address] [/SELECT:count]]
Attribute/Option |
Description |
file |
Opens the specified file. Please place quotes around paths with spaces. |
drive |
Opens a Logical Drive in the form 'X:', where X is the drive letter. A: for Drive A:, C: for Drive C:, etc. |
fixeddisk |
Open a Physical Drive in the form '/F:x', where x is the fixed disk number: /F:80 for the first fixed disk /F:81 for the second fixed disk ... |
/READONLY |
Open the resource in read-only mode. This disables all write operations. |
/FILELIST |
Open the resource as a CrLf delimited text file and then open each individual file specified within it. |
/GOTO:x |
Places the editor caret at the specified offset 'x'. Values are interpreted as decimal values unless prefixed with "0x" when they are interpreted as hexadecimal values. |
/SELECT:x |
Select 'x' bytes from the current editor caret position. If a /GOTO is not specified, Hex Workshop will select data starting from offset 0. |
/SRECORDS:file |
Import the specified file as Motorola S-Records. |
/HEXCODE:file |
Import the specified file as Intel Hex Code. |
Examples:
c:\hexworks\hworks32 foobar1.bin foobar2.bin
The command above will start Hex Workshop with the files "foobar1.bin" and "foobar2.bin" loaded in the editor.
c:\hexworks\hworks32 C:
This will start Hex Workshop with the logical "C:" drive loaded in the sector editor.
c:\hexworks\hworks32 /F:80 /READONLY
The command above will start Hex Workshop with the first physical disk loaded in the sector editor. The sector will be loaded in "read-only" mode so no sectors can be modified.
c:\hexworks\hworks32 foobar3.bin /GOTO:300 /SELECT:0x100
This will start Hex Workshop with foobar3.bin loaded in the editor. The editor caret will be placed at offset 300 (0x012C) and 256 bytes (0x100) will be selected.
c:\hexworks\hworks32 /SRECORDS:mykernel.mot /GOTO:0x1000
This will start Hex Workshop, import mykernel.mot as Motorola S-Records, and place the caret as offset 0x1000.