DOS33(1)

NAME
dos33 - tool for accessing files inside an Apple DOS 3.3 disk image

SYNOPSIS
dos33 [-h] [-y] <disk_image> <command> [arguments]

DESCRIPTION
dos33 operates on Apple DOS 3.3 .dsk images, and allows copying files to/from the image as well as common DOS operations.

OPTIONS

-h  Show built-in help message

-y  Answer "yes" to all confirmation prompts

COMMANDS
All commands are case-insensitive. Filenames within the image are case-sensitive. No globbing/wildcarding is done on files in the image.

CATALOG
    Same as the DOS 3.3 CATALOG command. Lists the directory of the disk, with file name, type, lock status, and size in sectors.

    In case of duplicate filenames in the image, the first file listed in CATALOG output will be the one operated on by the LOAD, DELETE, LOCK, and UNLOCK commands.

LOAD apple_file [local_file]
    Copies a file out of the image, to the local filesystem. If local_file is given, it will be used as the name of the output file, otherwise the file will be named the same as apple_file.

    File contents are always copied verbatim. Text files will be in Apple II encoding, and can be converted to UNIX style text files with the dos33_text2ascii(1) utility. BLOADable files (object code or binary data) will begin with a 4-byte header, giving the load address and length (minus the header) of the file in standard 6502 LSB/MSB format.

SAVE type local_file [apple_file]
    Copies a file into the image. If apple_file is given, it will be used as the name, otherwise the file will be named the same as local_file. No checking is done on the filename, so it's possible to create files with illegal names, as far as DOS 3.3 is concerned.

    If the file already exists in the image, you will be prompted whether to overwrite it. Use the -y option to suppress the prompt and always overwrite.

    type is one of the standard DOS 3.3 filetype characters:

    I   Integer BASIC program

    A   Applesoft BASIC program

    B   Binary file (possibly BLOADable)

    T   Text file (including EXEC batch files)

    S   Source? Sequential? Rarely used.

    R   Relocatable object module. Rarely used.

    N   dos33 uses this character as a replacement for the "new A", aka 0x20. In DOS 3.3's CATALOG command, these files show up as A. Rarely used.

    L   dos33 uses this character as a replacement for the "new B", aka 0x40. In DOS 3.3's CATALOG command, these files show up as B. Rarely used.

    Filetype characters are case-insensitive in dos33.

    File contents are always copied verbatim, so e.g. text files need to already be in Apple II encoding (bit 7 set on each character, and 0x8d used for end-of-line). A UNIX style text file can be converted with tr(1), with a command like:

    tr '\n\040-\177' '\215\240-\377' < unix.txt > apple.txt

    To make an Apple BLOAD/BRUN object file from a raw binary, use the make_b(1) utility.

    No checking is done on the file contents to see whether they make sense for the filetype given, so it's possible to e.g. store a text file with type A, or an Applesoft file with type B (binary). This isn't really a very useful thing to do, so try to avoid it.

DELETE apple_file
    Deletes a file inside the image. The file must exist and not be locked. =item LOCK apple_file

    Locks (write-protects) a file inside the image. Locked files have a * in the first column of CATALOG output. Locked files may not be written to, deleted, or renamed.

UNLOCK apple_file
    Unlocks a file inside the image.

RENAME apple_file_old apple_file_new
    Renames a file inside the image. No checking is done whether the new name already exists, so it's possible to create multiple files with the same name.

UNDELETE apple_file
    Undoes a DELETE. This is only possible if the file's data sectors haven't already been overwritten with data from newer files. You will need to know the filename of the deleted file, which can be found in DUMP's output.

DUMP
    Shows detailed information on the filesystem and files on the disk. Displays the VTOC, free sector bitmap, directory entries (including the ones for deleted files), and a hex dump of each sector marked "used" in the bitmap.

SEE ALSO

dos33fsprogs(1)
a2tools(1)

WEBSITE
http://www.deater.net/weave/vmwprod/apple/

AUTHORS
dos33fstools written by Vince Weaver <vince _at_ deater.net>.

This manual page written by B. Watson for the SlackBuilds.org project, but it may be used by anyone.