*dir

Description

Retrieve name and other information for all files and subdirectories in a given directory and return in a sequence of reply messages.

Syntax

*dir <directory>

Parameters

directory

Fully qualified name of the directory from which the information is to be retrieved

Return values

0 Directory information successfully retrieved. Data has been returned in a sequence of reply messages. Each reply message contains information about a single file or directory (see below).

1 Parameter error. No directory has been specified

2 Unable to retrieve directory information

3 Directory does not exist

Reply Message

The reply message consists of a number of fields that all contain character data.

• Textual(n) data has length n, is left-aligned and filled out with spaces.
• Flags contain a single character: either '1' or '0'.
• Decimal(n) data has length n and contains a decimal number that is right-aligned, and filled out with leading zeroes.
• Date/Time fields use the format 'YYYY-MM-DD-hh.mm.ss.xxxxxx' (26 characters). Each letter stands for a decimal digit. 'Y' stands for year, 'M' for month, 'D' for day, 'h' for hour, 'm' for minute, 's' for seconds and 'x' for milliseconds. Every number is right-aligned and filled out with leading zeroes.

character offset	type	contents
0	text(255)	long file name
255	text(12)	8.3 file name
267	decimal(20)	file size in bytes
287	date/time	file creation
313	date/time	file last access
339	date/time	file modification
365	flag	archive
366	flag	read-only
367	flag	hidden
368	flag	system
369	flag	directory