Davex/doc/help/What

71 lines
2.7 KiB
Plaintext

what -- determine what a file is (EXTERNAL) [v2.1]
syntax: what <pathname> [-m] [-c] [-x] [-l] [-s] [-b]
[-a] [-n]
ex: what thatfile
what %=:bin -a
what =:src -n
what .62 -amc
'what' examines a file's type, auxiliary type, and first
512 bytes and prints whatever interesting information it
can about the file.
Wildcards are allowed. Output is, at minimum, the file's
type and name. For many filetypes, additional information
appears.
Options:
-n: no blank lines (prevents 'what' from printing a blank
line before each file's information)
-a: print All information (modification date/time, creation
date/time, auxiliary type, length in bytes, length in
blocks, storage type)
-m: modification date and time
-c: creation date and time
-x: auxiliary type (load address for BIN files, total blocks
for a volume, etc.--meaning depends on filetype)
-l: length in bytes
-s: storage type (seedling, sapling, tree, Pascal area,
subdirectory, or volume)
-b: length in blocks
Note: 'what foo -a' is the same as 'what foo -mcsxlb'. Also, you
can print ALL BUT certain pieces of information by
specifying -a AND the options to omit. For example,
'what foo -ac' prints all information EXCEPT the creation
date/time.
For BIN or $2E files that are external Davex commands, version
information, a one-line summary, and the command's execution address
are displayed.
SYS files created by the 'sysalias' command are identified, and
the pathname of the aliased application is displayed. If
there is a startup buffer, its size is displayed.
SYS files -not- created by 'sysalias' are identified as ProDOS 8
applications. If there is a startup buffer, its length and
default contents will be displayed (for example, BASIC.SYSTEM
normally has a 65-byte startup buffer containing "startup").
BAS files are identified as Applesoft BASIC programs. 'what'
computes the correct Aux-type for the file and prints a warning
message if the file has a different Aux-type. (Use 'filetype'
with -x to correct the problem.) [Some DOS 3.3-to-ProDOS
conversion programs (including Apple's CONVERT utility) always
give BAS files an Aux-type of $0801, which is typically correct.
But if the DOS program had been saved from an address other than
$801, nastiness will result when you try to load or run the
converted program under ProDOS.]
Apple IIgs TOL files (TOOLnnn) are identified as specific system
tools by the last 3 digits of their names.
For all GS/OS Object Module Format files (types $B1 through
$BE), the OMF Version number is displayed. Version 1 is the
first version and will work under all versions of ProDOS 16 and
GS/OS.