% DIS68K(1) | Human68k disk utility

NAME

dis68k - utility for packing various X68000 disk image files

SYNOPSIS

dis68k l file \ \ \ \ \ # list the contents of file
dis68k x file \ \ # extract the contents of file

DESCRIPTION

dis68k is a utility that can list the contents of, and unpack DIM and XDF image files, which are readable by the Human68k operating system for Sharp X68000 personal computers.

OPTIONS

l file

Prints the full directory structure of file to the terminal.

p file

Extracts the full structure of file to the local disk.

The files insile file are written to a directory that is named according to file without its file extension. This directory is created if it does not exist.

BUILDING

The dis68k source comes bundled with a modified version of FatFs, a framework for writing libraries that can interact with the FAT filesystem. There are no external dependencies.

To build dis68k from source, run

make

To build an alternate dis68k binary with verbose logging and debug symbols included, run

make DEBUG=true

The manual page for dis68k is built from this Markdown document using the pandoc utility, which is not included. To build the manual page, run

make doc

TODO

dis68k should have the ability to write to (pack) image files in the future.

dis68k should support packing and unpacking HDS (SCSI hard disk) image files, and (in the farther future) HDF (SxSI hard disk) image files as well.

SEE ALSO

FatFs library: http://elm-chan.org/fsw/ff/00index_e.html

fathuman utility, from which this codebase was forked: https://github.com/vampirefrog/fathuman

LICENSE

Please see the LICENSE file for more information.