Directory Command

This command lists the files within a directory or displays the usage statistics for the flash disk.

Directory [-free] [-stats] [path]

Prerequisites

None

Parameters

-free

An optional switch that indicates that the free and total space for the device specified by the path parameter should be displayed. Only the /flash device supports this switch.

-stats

An optional switch that indicates that the free, used, and total space for the device specified by the path parameter should be displayed in verbose format. Only the /flash device supports this switch.

path

An optional file name path that describes the directory whose contents should be listed. If blank, the top-level root directory is listed.

Remarks

Normally this command is used with the flash disk, indicated by "/flash" as the first item in the path parameter. However other devices such as "/ROMDISK" may also be specified.

The -free and -stats switches are supported by the /flash, /flashn (flash sub-partitions), and /NVRAM devices. When these switches are specified, no additional path or file specifications should be used.

-free displays the number of free bytes on the device and the total number of bytes on the device, separated by "/" as:

free_bytes / total_bytes

-stats displays the number of free bytes, the number of used bytes, and the total number of bytes on the device as:

Free: free_bytes, Used: used_bytes, Total: total_bytes

where

free_bytes indicates the number of bytes available for writing additional data.

used_bytes indicates the number of bytes used by user-written data.

total_bytes indicates the total number of bytes on the entire device. If this value is greater than the sum of free_bytes and used_bytes, it due to system data on the device that cannot be accessed by users.

Examples

Directory /flash
config
projects

Directory /flash/config
calib01.pac
controller.pac
diomotion01.pac
robot01.pac
gpl_vars.pac

Directory -free /flash
187392/1090560 ' Indicates 187392 bytes free of a total 1090560

Directory -stats /flash
Free: 458752, Used: 41984, Total: 500736

See Also

Console Commands