Apple-2-SW/ProDOS-Utils
1
0
Fork 0
mirror of https://github.com/bobbimanners/ProDOS-Utils.git synced 2024-06-08 04:29:31 +00:00
Code Issues Projects Releases Wiki Activity
File management utilities for the ProDOS operating system on the Apple II
4 Commits 1 Branch 0 Tags 1.4 MiB
Assembly 49.7%
C 42.3%
Python 7.2%
Makefile 0.8%
8c3d91ee36
Go to file
Bobbi Webber-Manners 8c3d91ee36 Added some meat to the README
2020-05-22 18:51:26 -04:00
apple2enh-system.cfg Initial version of sortdir for ProDOS-8 (port from GNO/ME on the GS) 2020-05-22 17:01:18 -04:00
LICENSE Initial commit 2020-05-22 16:14:13 -04:00
Makefile Added support for building a test diskette image. 2020-05-22 17:10:27 -04:00
README.md Added some meat to the README 2020-05-22 18:51:26 -04:00
sortdir.c Initial version of sortdir for ProDOS-8 (port from GNO/ME on the GS) 2020-05-22 17:01:18 -04:00
sortdir.po Added support for building a test diskette image. 2020-05-22 17:10:27 -04:00

README.md

ProDOS-Utils

File management utilities for the ProDOS operating system on the Apple II

Sortdir

Sortdir is a powerful utility for managing ProDOS directories. It provides a number of functions, all of which may be applied to an individual directory, a directory tree or an entire volume:

  • Checking directory integrity and making repairs
  • Multi-level directory sort
  • Manipulating the case of filenames *
  • Manipulating the format of time and date information *
  • Zeroing free blocks

Sortdir is intended to help users migrate to the new ProDOS 2.5 release, which is currently in alpha. The code has been testing with ProDOS 2.5a8, but should run on older versions of ProDOS. The features marked with an asterix (*) above allow directory entries to be converted from the legacy format to the new ProDOS 2.5 format, and vice versa.

ProDOS 2.5 releases may be obtained here

System Requirements

Sortdir requires an enhanced Apple //e, //c or IIgs with 128KB of memory. It should run on all versions of ProDOS, but is intended for use with ProDOS 2.5.

Quickstart - Test Disk Image

Download the disk image sortdir.po. This is a bootable 143KB (Disk ][) ProDOS 2.5 disk image which includes SORTDIR.SYSTEM, ready-to-run.

Build Instructions

If you want to build Sortdir (and perhaps contribute to the code!), you will require the cc65 C cross compiler for 6502. cc65 can be found here.

I also use Cadius for copying sortdir.system#ff0000 to an Apple II disk image.

On a Linux system, you should be able to build by simply invoking make.

User Interface

TODO

Command Line Options

TODO

Directory Check and Repair

TODO

Directory Sort

TODO

Filename Case Change

TODO

Date and Time Format

This allows the format of the modification time and creation time fields in ProDOS directories to be converted from the legacy ProDOS format (ProDOS <2.5) to the new date and time formats introduced in ProDOS 2.5. These new formats extend the range of dates that may be represented, in a backwards-compatible manner. Sortdir also allows conversion from the new ProDOS 2.5 date and time format back to the legacy format.

Zeroing Free Blocks

Not yet implemented in ProDOS-8 version.