AgeStore Command-Line Options

The AgeStore command line uses the following syntax. The parameters can be included in any order.

agestore [PathSpec] -date=Month-Day-Year Options 

agestore [PathSpec] -days=NumberOfDays Options 

agestore [PathSpec] -size=SizeRemaining Options 

agestore [PathSpec] -size Options 

agestore -? 

Parameters

PathSpec

Specifies the target directory in which files are to be deleted. If the -s option is used, PathSpec specifies the root directory of the target tree in which files are to be deleted. PathSpec may be the absolute or relative path of a directory on the local computer, or a UNC path. If PathSpec contains spaces, it must be enclosed in quotation marks. If PathSpec is omitted, AgeStore uses the current working directory.

-date=Month-Day-Year

Specifies the cutoff date for deleting files. All files that were last accessed prior to the specified date will be deleted. The date must be specified in the format Month-Day-Year, with hyphens between the month and day and between the day and the year. Leading zeros in Month and Day are optional. The year can be specifed with two digits or four. Thus you can indicate the date of January 5, 2008 as 01-05-2008 or 1-5-08.

-days=NumberOfDays

Specifies the cutoff date and time for deleting files. All files that were last accessed prior to the specified number of days ago will be deleted. NumberOfDays specifies an integer number of 24-hour days. For example, if the specifier -days=3 is used at 6:00 PM on February 17, 2008, all files last accessed prior to 6:00 PM on February 14, 2008 will be deleted.

-size=SizeRemaining

Specifies the total size of the files that should remain after the deletion, in bytes. When this switch is used, AgeStore deletes files in the target directory or target tree, beginning with the files accessed least recently, until the total size of the remaining files is less than or equal to SizeRemaining. When the -s option is used, AgeStore targets an entire directory tree, and SizeRemaining specifies the total size of files that should remain in this entire directory tree after deletion.

-size

Causes AgeStore to list the total size of all files in the target directory or target tree. No files are deleted.

Options

Any combination of the following options.

-l

Causes AgeStore not to delete any files, but merely to list all the files that would be deleted if this same command were run without the -l option.

-s

Causes AgeStore to treat the entire directory tree subordinate to PathSpec as the target. When the -s option is not used, the directory specified by PathSpec becomes the target directory in which files will be deleted. When the -s option is used, the directory specified by PathSpec and all subdirectories under it become the target tree in which files will be deleted.

-k

Causes AgeStore to keep any empty subdirectories. If this option is not used, AgeStore deletes the target directory if it is completely empty after the command runs. If the -s option is used without the -k option, all empty directories in the target directory tree will be deleted after AgeStore has completed its file deletion -- even the root directory itself, if it becomes empty. If there are directories in this tree that happen to be already empty before AgeStore runs, AgeStore deletes these directories as well. However, if the AgeStore command results in no file deletion (for example, if the -size=SizeRemaining parameter specifies a size larger than the total size of all files in the target tree), empty directories are not deleted. If the -s option is not used, empty directories are never deleted, and the -k option is ignored.

-q

Quiet mode. If this option is not included, AgeStore lists all files as they are deleted.

-y

Suppresses the (y/n) prompt. If this option is not used, AgeStore prompts you with an "Are you sure?" prompt before deleting any files.

-?

Displays help text for the AgeStore command line.

Additional Information

For more information about the AgeStore tool, see Using AgeStore.