CDU 0.6.059 Mar 12 2001

			CDU COMMAND-LINE

Usage: CDU [<command>|<directive>]...[<command>|<directive>]

WORDS:
	<addword>           ADD
	<allword>           ALL or EVERYTHING
	<archiveword>       ARCHIVE, COMPRESS, COMPACT or GZIP
	<autoendword>       AUTOEND, FINDEND or SEEKEND
	<badscanword>       BADSCAN
	<beepword>          BEEP, SOUND, SOUNDS or NOISE
	<bufsizword>        BUFSIZ
	<byteword>          BYTE, CHAR or VALUE
	<clsword>           CLS or CLEAR
	<compareword>       COMPARE or MATCH
	<confirmword>       CONFIRM
	<copyword>          COPY, BACKUP or RESTORE
	<debugword>         DEBUG
	<defineword>        DEFINE or MACRO
	<delay1word>        DELAY1
	<delay2word>        DELAY2
	<deleteword>        DELETE, DEL, REMOVE or KILL
	<detailword>        DETAIL
	<diskword>          DISK or DRIVE
	<dotword>           DOT or .
	<dumpword>          DUMP, PRINT or LIST
	<endword>           END or FINISH
	<exitword>          EXIT, BYE or QUIT
	<fileword>          FILE
	<flushword>         FLUSH
	<forword>           FOR or STRING
	<fwriteword>        FWRITE
	<helpword>          HELP
	<hwriteword>        HWRITE
	<i13word>           I13, INT13 or INT_13
	<i13exword>         I13EX, INT13EX, INT_13EX or INT_13_EX
	<identifyword>      IDENTIFY
	<ifaceword>         IFACE or INTERFACE
	<includeword>       INCLUDE or GET
	<infoword>          INFO
	<interactiveword>   INTERACTIVE
	<nameword>          NAME or ASSIGN
	<offword>           OFF, DISABLE, INHIBIT, FALSE or NO
	<onword>            ON, ENABLE, TRUE or YES
	<onerrorword>       ONERROR, ON_ERROR, ONERR or ON_ERR
	<probeword>         PROBE or ACQUIRE
	<rangeword>         RANGE or OFFSET
	<remindword>        REMIND or NAG
	<retriesword>       RETRIES or RETRY
	<sayword>           SAY, MESSAGE or TEXT
	<scharword>         SCHAR or SPECIAL
	<searchword>        SEARCH or FIND
	<sizingword>        SIZING
	<sourceword>        SOURCE, FROM, WITH or IN
	<startword>         START or BEGIN
	<statusword>        STATUS or STATE
	<stdkbword>         STDKB or STDIO
	<targetword>        TARGET or TO
	<traceword>         TRACE
	<vcharword>         VCHAR or ENVAR
	<verboseword>       VERBOSE, WAFFLE or BLAH
	<vinfoword>         VINFO
	<volumeword>        VOLUME or VOL
	<writeword>         WRITE

GRAMMAR:
	<diskname>
	  < A string representing a user-given drive name >
	
	<filename>
	  < A file name acceptable to the operating system >
	
	<idstring>
	  < A unique string representing a disk drive's identity >
	
	<messagestring>
	  < A string representing a user-specified message >
	
	<searchstring>
	  < A pattern to search for >
	
	<functionname>
	  < A string representing a (possibly wild-carded) CDU function name >
	
	<macroname>
	  < A string representing a macro name >
	
	<macrostring>
	  < A string representing the text of a macro >
	
	<number>
	  '<printablecharacter>'
	  0x<hexdigit>[<hexdigit>]...[<hexdigit>]
	  <binarydigit>[<binarydigit>]...[<binarydigit>]b
	  <decimaldigit>[<decimaldigit>]...[<decimaldigit>]
	  <hexdigit>[<hexdigit>]...[<hexdigit>]h
	  <octaldigit>[<octaldigit>]...[<octaldigit>]o
	
	<absolutesector>
	  <endword>
	  <number>
	  <startword>
	
	<relativesector>
	  +<number>
	  -<number>
	
	<sectornumber>
	  [<absolutesector>][<relativesector>]
	
	<booleanword>
	  <offword>
	  <onword>
	
	<disknumber>
	  FD<decimaldigit>
	  HD<decimaldigit>
	
	<volume>
	  <letter>:
	
	<rangeclause>
	  <rangeword> [<sectornumber>]:[<sectornumber>]
	
	<device>
	  <byteword>    <number>     [<rangeclause>]
	  <archiveword> <filename>   [<rangeclause>]
	  <diskword>    <diskname>   [<rangeclause>]
	  <diskword>    <disknumber> [<rangeclause>]
	  <fileword>    <filename>   [<rangeclause>]
	  <volumeword>  <volume>     [<rangeclause>]
	
	<copycommand>
	  <copyword> <sourceword> <device> <targetword> <device>
	  <copyword> <targetword> <device> <sourceword> <device>
	
	<comparecommand>
	  <compareword> <sourceword> <device> <sourceword> <device>
	
	<searchcommand>
	  <searchword> <forword> <searchstring> <sourceword> <device>
	  <searchword> <sourceword> <device> <forword> <searchstring>
	
	<dumpcommand>
	  <dumpword> <sourceword> <device>
	
	<badscancommand>
	  <badscanword> <sourceword> <device>
	
	<responsedirective>
	  @<filename>
	  <includeword> <filename>
	
	<simpledirective>
	  <clsword>
	  <dotword>
	  <exitword>
	  <helpword>
	  <infoword>
	  <probeword>
	  <statusword>
	  <vinfoword>
	
	<switchdirective>
	  <confirmword>     [<booleanword>]
	  <debugword>       [<booleanword>]
	  <detailword>      [<booleanword>]
	  <flushword>       [<booleanword>]
	  <fwriteword>      [<booleanword>]
	  <hwriteword>      [<booleanword>]
	  <interactiveword> [<booleanword>]
	  <verboseword>     [<booleanword>]
	  <writeword>       [<booleanword>]
	
	<osdependantdirective>
	  <bufsizword>   <number>
	  <delay1word>   <number>
	  <delay2word>   <number>
	  <identifyword> [<booleanword>]
	  <autoendword>  [<booleanword>]
	  <stdkbword>    [<booleanword>]
	  <retriesword>  <number>
	  <sizingword>   [<booleanword>]
	  <scharword>    <number>
	  <vcharword>    <number>
	
	<miscdirective>
	  <beepword>   [<booleanword>]
	  <beepword>   <onerrorword>
	  <remindword> <number>
	  <sayword>    <messagestring>
	  <traceword>  <functionname>
	  <defineword> <macroname> <macrostring>
	
	<diskdirective>
	  <addword>    <disknumber>
	  <deleteword> <allword>
	  <deleteword> <disknumber>
	  <ifaceword>  <allword>    <i13exword>
	  <ifaceword>  <allword>    <i13word>
	  <ifaceword>  <disknumber> <i13exword>
	  <ifaceword>  <disknumber> <i13word>
	  <nameword>   <diskname>   <idstring>
	
	<command>
	  <comparecommand>
	  <copycommand>
	  <dumpcommand>
	  <badscancommand>
	  <searchcommand>
	
	<directive>
	  <diskdirective>
	  <miscdirective>
	  <osdependantdirective>
	  <responsedirective>
	  <simpledirective>
	  <switchdirective>
	
CONSTANTS:
	The default response file extension is '.cdu'.
	The system console special file name is 'CON'.
	Response files are cited by prepending a '@' to the file name.
	Special characters are embedded by using the character '\'.
	Macros and environment variables should be bracketed by '%'.
	The maximum depth to which you can nest response files is 10.
	The character used to comment a line in a response file is ';'.
	You can have a maximum of 512 characters in a response file line.
	The maximum length of a drive name is 10 characters.
	The standard IBM PC sector length is 512 bytes.
	The byte used as a 'no data' indicator is 0xEE.
	When looking for IDE drives, the range searched is 0/0 to 1/1.
	The maximum number of IDE drives supported is 4.
	The maximum number of floppy drives supported is 2.
	The maximum length of a reserved word is 20 characters.
	The maximum number of word synonyms is 10.
	The name string that means 'all objects' is '*'.

RANGES:
	When entering a range, *one* of the sector numbers can be expressed in
	a manner relative to the *other* sector number.   In this case, the
	sector number is treated as a *length* and, just before the command is
	exeucted, the length is added to the absolute sector number to obtain
	the other absolute sector number.
	
	The fact that the relative item is a *length* is taken into account.
	So, for example, the first ten sectors of a disk can be expressed as:
	
		RANGE START:+10
	
	Note that you do *not* have to take into account the 'minus one'
	effect and use 'START:+9' instead.
	
	So, for example, if one wanted to copy the contents of file 'z.img'
	onto the last *six* sectors of the first floppy drive, one could use:
	
		CDU FWRITE ON COPY FILE Z.IMG TO DISK FD0 RANGE -6:END
	
	Omitted items are consider as if one had cited the corresponding
	extreme end of the stream.  So, for example, ':+100' would refer to
	the first one hundred sectors of a stream and '-100:' would refer to
	the last one hundred sectors.  This mechanism will, therefore, treat a
	single ':' as if the range hadn't been specified at all.
	
EXAMPLES:
	CDU COPY [FROM] DISK HD0 TO FILE BACKUP.IMG
	CDU COMPARE [SOURCE] DISK HD0 WITH FILE BACKUP.IMG
	CDU VERBOSE ON DETAIL ON INFO
	CDU DELETE HD0 @NAMES VINFO
	CDU DELETE ALL ADD HD0 ADD HD1 INFO
	CDU BACKUP [FROM] DRIVE HEX TO GZIP C:\Z\TEMP.GZ
	CDU HWRITE ENABLE COPY [FROM] ARCHIVE C:\Z\TEMP.GZ TO DRIVE HEX
	CDU HWRITE ON RESTORE [TO] DRIVE HEX FROM ARCHIVE C:\Z\TEMP.GZ
	CDU BACKUP [FROM] DISK GLOD TO DISK BIGIRON OFFSET 10000
	CDU RESTORE [TO] VOL D: FROM DRIVE HEX RANGE 1000:+1000
	CDU COMPARE DISK HD0 RANGE 0X200:+0X10 WITH DISK HD1 RANGE 0X100:+0X10
	CDU COMPARE [SOURCE] DISK GLOD WITH DISK BIGIRON
	CDU SEARCH [IN] VOLUME C: FOR "FAT16"
	
NOTES:
	(a) Elements in square brackets may be omitted.  In the above
	    examples, the indicated optional words are *implied* if they
	    are missing.
	
	(b) If the optional Boolean word after a switch key
	    word is missing, the relevant switch is *toggled*.