mirror of
https://github.com/Michaelangel007/apple2_prodos_utils.git
synced 2025-02-19 20:30:29 +00:00
Added status of command that work
This commit is contained in:
parent
7117db14d2
commit
945deeca19
115
README.md
Normal file
115
README.md
Normal file
@ -0,0 +1,115 @@
|
|||||||
|
# Apple 2 Prodos Utils
|
||||||
|
|
||||||
|
**NOTE:** This is still a work-in-progress.
|
||||||
|
|
||||||
|
Commands that work:
|
||||||
|
|
||||||
|
* [x] cat
|
||||||
|
* [x] catalog
|
||||||
|
* [x] cp (Only Seed (file size <= 512 bytes), and Sapling files (file size <= 128 KB) are currently supported)
|
||||||
|
* [x] dir
|
||||||
|
* [ ] get
|
||||||
|
* [x] init
|
||||||
|
* [x] ls
|
||||||
|
* [ ] mkdir
|
||||||
|
* [ ] rm
|
||||||
|
* [ ] rmdir
|
||||||
|
|
||||||
|
|
||||||
|
```
|
||||||
|
Usage: <dsk> <command> [<options>] [<path>]
|
||||||
|
|
||||||
|
cat Catalog (short form)
|
||||||
|
[<path>] Path of virtual sub-directory to view
|
||||||
|
Defaults to: /
|
||||||
|
catalog Catalog (long form)
|
||||||
|
[<path>] Path of virtual sub-directory to view
|
||||||
|
Defaults to: /
|
||||||
|
cp Add file(s) to volume
|
||||||
|
<path> Destination virutal sub-directory to add to
|
||||||
|
There is no default -- it must be specified
|
||||||
|
-access=$## Set access flags
|
||||||
|
$80 Volume/file can be destroyed
|
||||||
|
$40 Volume/file can be renamed
|
||||||
|
$20 Volume/file changed since last backup
|
||||||
|
$04 Volume/file is invisible
|
||||||
|
$02 Volume/file can be read
|
||||||
|
$01 Volume/file can be written
|
||||||
|
-aux=$#### Set the aux address
|
||||||
|
-date=MM/DD/YY Set create date to specified date
|
||||||
|
-date=DD-MON-YY Set create date to specified date
|
||||||
|
MON is one of:
|
||||||
|
JAN, FEB, MAR, APR, MAY, JUN,
|
||||||
|
JUL, AUG, SEP, OCT, NOV, DEC
|
||||||
|
-time=HH:MMa Set create time to specified 12-hour AM
|
||||||
|
-time=HH:MMp Set create time to specified 12-hour PM
|
||||||
|
-time=HH:MM Set create time to specified 24-hour time
|
||||||
|
-type=$## Force file type to one of the 256 types
|
||||||
|
-moddate=MM/DD/YY Set last modified date to specified date
|
||||||
|
-modtime=HH:MM Set last modified date to specified time
|
||||||
|
dir Catalog (long form)
|
||||||
|
This is an alias for 'catalog'
|
||||||
|
get Extract file from volume
|
||||||
|
<path> Path of virtual file to extract
|
||||||
|
NOTES:
|
||||||
|
The file remains on the virtual volume
|
||||||
|
To delete a file see ........: rm
|
||||||
|
To delete a sub-directory see: rmdir
|
||||||
|
init Format disk
|
||||||
|
<path> Name of virtual volume.
|
||||||
|
-size=140 Format 140 KB (5 1/4")
|
||||||
|
-size=800 Format 800 KB (3 1/2")
|
||||||
|
-size=32 Format 32 MB (Hard Disk)
|
||||||
|
ls Catalog (file names only)
|
||||||
|
[<path>] Path to sub-directory to view
|
||||||
|
Defaults to: /
|
||||||
|
mkdir Create a sub-directory
|
||||||
|
<path> Destination virutal sub-directory to create
|
||||||
|
There is no default -- it must be specified
|
||||||
|
rm Delete file from volume
|
||||||
|
<path> Path of virtual file to delete
|
||||||
|
There is no default -- it must be specified
|
||||||
|
rmdir Remove a sub-directory
|
||||||
|
<path> Path of virtual sub-directory to delete
|
||||||
|
There is no default -- it must be specified
|
||||||
|
NOTE:
|
||||||
|
You can not delete
|
||||||
|
the root directory: /
|
||||||
|
-f Force removal of sub-directory
|
||||||
|
(Normally a sub-directory must be empty)
|
||||||
|
|
||||||
|
Where <dsk> is a virtual disk image with an extension of:
|
||||||
|
|
||||||
|
.dsk
|
||||||
|
.do
|
||||||
|
.po
|
||||||
|
|
||||||
|
NOTE: To skip always having to specify the <.dsk> name set the environment variable:
|
||||||
|
|
||||||
|
PRODOS_VOLUME
|
||||||
|
e.g.
|
||||||
|
export PRODOS_VOLUME=path/to/volume.po
|
||||||
|
|
||||||
|
Three different disk sizes are accepted for init
|
||||||
|
|
||||||
|
prodos test.dsk init -size=140 # 5 1/4" (140KB)
|
||||||
|
prodos test.dsk init -size=800 # 3 1/2" (800KB)
|
||||||
|
prodos test.dsk init -size=32 #HardDisk (32 MB)
|
||||||
|
|
||||||
|
Examples:
|
||||||
|
|
||||||
|
prodos test.dsk ls
|
||||||
|
prodos test.dsk cat
|
||||||
|
prodos test.dsk cp foo1 foo2 /
|
||||||
|
prodos test.dsk mkdir bar
|
||||||
|
prodos test.dsk cp foo2 /bar
|
||||||
|
prodos test.dsk get /bar/foo2
|
||||||
|
prodos test.dsk rm /bar/foo2
|
||||||
|
prodos test.dsk rmdir /bar
|
||||||
|
prodos test.dsk init /TEST
|
||||||
|
prodos b140.dsk init -size=140 /BLANK140
|
||||||
|
prodos b800.dsk init -size=800 /BLANK800
|
||||||
|
prodos b032.dsk init -size=32 /BLANK32
|
||||||
|
```
|
||||||
|
|
||||||
|
|
@ -187,6 +187,9 @@ int usage()
|
|||||||
" prodos test.dsk rm /bar/foo2\n"
|
" prodos test.dsk rm /bar/foo2\n"
|
||||||
" prodos test.dsk rmdir /bar\n"
|
" prodos test.dsk rmdir /bar\n"
|
||||||
" prodos test.dsk init /TEST\n"
|
" prodos test.dsk init /TEST\n"
|
||||||
|
" prodos b140.dsk init -size=140 /BLANK140\n"
|
||||||
|
" prodos b800.dsk init -size=800 /BLANK800\n"
|
||||||
|
" prodos b032.dsk init -size=32 /BLANK32\n"
|
||||||
"\n"
|
"\n"
|
||||||
);
|
);
|
||||||
|
|
||||||
|
Loading…
x
Reference in New Issue
Block a user