Jim Battle
August 2011

Version 1.3 of wvdutil was developed using python 2.7 under Windows 7.
It should run on other platforms, but it hasn't been tested. wvdutil_1.3.zip
contains the main program, wvdutil.py, and some library routines in wvdlib.py
and wvfilelist.py.

New features in version 1.3:

    - added the ability to process disk images that have been zip'd.

    - added the command "listd".  It is identical to list, except it
      prettyprints BASIC program listings, ala the BASIC-2 LISTD command.

To operate on "disk.wvd", launch it like this:

    python wvdutil.py disk.wvd

The first command to learn is "help".  Here it is

Usage:
    wvdutil.py <filename> [<command>[/<platter>] [<args>]] [<redirection>]

With no command, enter into command line mode, where each subsequent line
contains one of the commands, as described below.  The output can be optionally
redirected to the named logfile, either overwriting, ">" or appending, ">>".
The output can also be piped through a pager by ending with "| more".
Arguments containing spaces can be surrounded by double quote characters.

For multiplatter disks, the platter can be specified by following the command
name with a slash and the decimal platter number.  For commands where it makes
sense, "/all" can be specified to operate on all platters.

<redirection> is optional, and takes one of three forms:
   ... >   <logfile>  -- write command output to a logfile
   ... >>  <logfile>  -- append command output to a logfile
   ... | more         -- send command output through a pager

Type "help <command>" to get more detailed help on a particular command.

   cat       - display all or selected files on the disk
   check     - check the disk data structures for consistency
   compare   - Compare two disks or selected files on two disks
   dump      - show contents of file or sectors in hex and ascii
   exit      - quit program
   help      - print list of commands more details of one command
   index     - display or change the catalog index type
   list      - show program or data file as text
   listd     - show program or data file as text; programs are prettyprinted
   meta      - report virtual disk metadata
   platter   - supply the default if a platter number isn't specified
   protect   - set program file to be saved in protected mode
   save      - write the in-memory disk image back to disk
   unprotect - set program file to be saved in normal mode
   wp        - set or clear the write protect status of the virtual disk

