From f9dcbdd176785dfc9d49f3113ec6110199e9a246 Mon Sep 17 00:00:00 2001 From: "B. Watson" Date: Fri, 10 May 2024 17:24:40 -0400 Subject: import ken siders atr utilities. --- ksiders/sortatr.1 | 80 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 80 insertions(+) create mode 100644 ksiders/sortatr.1 (limited to 'ksiders/sortatr.1') diff --git a/ksiders/sortatr.1 b/ksiders/sortatr.1 new file mode 100644 index 0000000..98301b3 --- /dev/null +++ b/ksiders/sortatr.1 @@ -0,0 +1,80 @@ +.TH SORTATR "1" "April 2007" "sortatr" "Ken Siders' Atari 8-bit Tools" +.SH NAME +\fBsortatr\fR \- sort Atari DOS directory in an ATR image + +.SH SYNOPSIS +\fBsortatr\fR \fIimagefile.atr\fR + +.SH DESCRIPTION +\fBsortatr\fR sorts the directory entries in an Atari DOS 2.0S or MyDOS +compatible ATR images. The sort is alphabetical, and the disk image +is modified in place. +.PP +\fBatrextr\fR does not take any options. +.SH WARNINGS +\fBDO NOT USE\fR this utility with DOS 2.5 disk images! +.PP +\fBDO NOT USE\fR this utility with MyDOS images containing subdirectories! +.PP +\fBDATA LOSS\fR will occur if these warnings are not heeded! The modified +directory in the image will not contain any references to DOS 2.5 files +using sectors above 720, or to MyDOS subdirectories. This effectively +\fBdeletes\fR these files from the image. +.PP +If in doubt, list the image's directory with \fBatrdir\fR. If you see +files marked with a \fI:\fR (colon) or \fI<\fR (less-than), then +\fBsortatr\fR should not be used on the image. Even if your purpose +is actually to delete these files/dirs, you should use some other +utility (or DOS on a real or emulated Atari) to delete them, because +\fBsortatr\fR doesn't free the sectors occupied by the files/dirs. +.PP +If you ignore these warnings and manage to delete files or directories +from your disk image, it should be possible to recover them with a good +Atari undelete or disk\-repair utility. Although the affected files/dirs +have been removed from the disk directory, the data sectors have not +been overwritten nor marked as free (meaning they won't be overwritten +by later write operations, unlike most "undelete" situations). +First, you have to +find the starting sector of the missing file/dir and +create a directory entry for it in the directory at sectors 36-368. You +will probably also have to change the file number in the sector link +bytes, or else delete the file in the new directory that's using the +file number of the old (deleted) file. +.PP +Further warnings: +.PP +\fBDO NOT USE\fR this utility with any non-standard (non\-AtariDOS, +non-MyDOS compatible) disk image. +.PP +Boot disks with no directory, +SpartaDOS, Atari DOS 3/4, DOS XE, or other non\-standard DOS formatted +disks might (if you're lucky) just cause an error message. If +you're not lucky, they may be corrupted. There is no easy way to +recover an image that gets damaged in this way. +.PP +\fBDO NOT USE\fR this utility with \fIany\fR image without creating a +backup first! +.PP +Any image you use with \fBsortatr\fR is modified in-place, +and no backup is made by \fBsortatr\fR. \fBAlways\fR make a backup +copy of an ATR image before you use \fBsortatr\fR on it. \fIYou have +been warned\fI. +.SH NOTES +XFD format images are not supported. +.PP +Exit status is zero if the sort was successful, or +non-zero if any errors occurred. In case of a non-zero return, +the disk image may be truncated, or its directory sectors may be +damaged. Hope you had a backup of that image! +.SH AUTHOR +Ken Siders <\fBatari8bit@columbus.rr.com\fR> +.PP +Man page by B. Watson <\fBurchlay@urchlay.com\fR> + +.SH SEE ALSO +\&\fIatrdir\fR\|(1), \&\fIatrextr\fR\|(1), \&\fImakeatr\fR\|(1), +\&\fIunmakatr\fR\|(1). +.PP +Ken Siders Atari 8-bit page: +.br +http://atari.ksiders.tzo.com/a8emulators.html -- cgit v1.2.3