SUNDUMP

 

The SUNDUMP utility provides a means for examining and modifying the contents of physical disk sectors. The utility displays the data contained within the sector in two formats: ASCII and the ASCII character's Octal or Hex value. No editing is done during the initial read and display, allowing you to see the exact contents of all 256 bytes. The top line of the display is called the primary control line. File displays always begin with the first byte of the file unless modified with the 'S' command line option.

 

 

SUNDUMP [{filename}] [-{options}]

Parameters:
filename
The optional file name to be dumped.
options
The options that alter the behavior of the utility as described below.

Note the following:

  1. {options}, if given, must be one of the following:

    2. G

    Use graphics characters in dump display for characters between 80 and FF hex.

    H

    Start dump in HEX mode. Default mode is OCTAL.

    M

    Attempt shared open if exclusive open fails.

    O

    Start dump in OCTAL mode.

    S{nn}

    Starting sector to dump is {nn}.

     

  2. The primary control line has three displays, of which the first two also act as operator prompts.

  3. The file to be read is displayed at the FILE: portion of the primary control line. If a file was not specified in {filename},one must be specified here. Once in this position, a valid filename must be given or an asterisk (*) may be entered to terminate the utility.

  4. Once a file has been located, the first 256 bytes are read and displayed on the screen in both ASCII and Octal values. The cursor is at the LRN: position of the primary control line. The manner in which the file is read and displayed is controlled by operator entries at this position of the primary control line.

  5. At the LRN: control level, the following commands apply:

    6. ?

    Display the available options.

    *

    Backup to the FILE: control level

    H

    Display the ASCII characters and their Hex equivalents in a Hex sector format

    O

    Display the ASCII characters and their Octal equivalents in an Octal sector format

    D

    Decrement the sector position within the file

    D{nn}

    Decrement the sector position {nn} times

    I

    Increment the sector position within the file

    I{nn}

    Increment the sector position {nn} times

    nn

    Retrieve specific sector number nn

    E

    End-Of-File modification. You are prompted for the sector number and tab specifying the End-Of-File. Each number may be Decimal, Octal or Hex. The file may be extended or truncated. If the file is being truncated, the character preceding the End-Of-File location blinks on the screen and a prompt is issued to verify the truncation of the file to that location.

    S

    Search for the following string. An ASCII search string may then be entered. Once a match has been found, entering another 'S' at the LRN: control level followed by a null entry searches for the next occurrence of the same string. Hex or octal numbers may also be searched for by using the '\' forcing character. A hex character is specified by '\Xnn' where nn is the hex value. An octal character is specified by '\nnn' where nnn is the octal value. To search for a sting of three binary zeros, the following command would be used: \000\000\000.

    M

    Modify the sector. The cursor is positioned over the ASCII character in the first byte of the sector. The cursor may be moved about the sector by pressing the appropriate keyboard arrow (direction) keys. Once over the character desired, a new ASCII character may be entered or the F2 key (Function Key 2) may be pressed to position the cursor over the Hex or Octal equivalent value. At this time, a new valid Hex or Octal (depending on the display manner chosen) may be entered. Upon entry of a new value, the appropriate ASCII character (if any) is displayed beneath the new value. To return to the ASCII character line, simply press the F2 key again. Once the necessary changes for a sector have been made, the F1 key returns the cursor to the LRN: control level where the sector may then be written. (Note: Failing to write the new sector before moving to the next sector causes any changes made to be lost.

    W

    Write the sector. The modified sector is written to disk with the new changes intact.

    G

    Toggle graphic display mode. When graphic display mode is set, all characters between 80 and FF hex are displayed as graphic characters. When graphic display mode is not set, all characters between 80 and FF hex are displayed as the corresponding characters 00 to 7F hex.

    !

    Shell out to the operating systems to perform some other task. Control is returned to SUNDUMP via the EXIT command.

    Q

    Immediately exit the SUNDUMP utility.

     

  6. The final position on the primary control line is the MAX LRN that displays the last sector number for the file being modified. It is not a prompt field and typically does not change during the use of the SUNDUMP utility

 

 

See Also: SUNDUMP Examples, Utilities

 


System Utilities SUNAAMDX SUNEDIT