The diskcache command has two primary modes of operation. The first mode is a one pass mode. In this mode, the additional options on the command line represent the task to be performed and the command exits once completed.

The second mode is a daemon mode. In this mode the diskcache starts up and maintains a cache of files based on the options passed on the command line. This cache can be queried and manipulated by input from standard input with the results being sent to standard output.

daemon The daemon sub command is intended to provide a continuous scanning mode.

Option	Description
–concurrency integer	Number of mount points to scan concurrently
–configuration-file filename	Specify a file which contains configuration options.
–excluded-directories list	Comma separated list of directories not to be searched.
–extensions list	Comma seperated list of file extensions
–log filename	Specify where the log messages should be written.
–log-directory directory	Specify the directory to capture logging information.
–mount-points list	Comma seperated list of mount points to scan
–output-ascii filename	Filename for the ascii output; Use '-' to direct to standard out.
–output-binary filename Filename for the binary output.
–version-ascii version	Version of the ascii cache dump format to use. By default, the latest version is used.
–version-binary version	Version of the binary cache dump format to use. By default, the latest version is used.

dump The dump sub command is intended to dump the contents of the memory cache. The quantity of data returned may be limited by the use of the following options.

Option	Description
–ifo pattern	IFO pattern to use for search. (Default: all)
–output-ascii filename	Filename for the ascii output; '-' to direct to standard output
–output-binary filename	Filename for the binary output
–type pattern	Type pattern to use for search. (Default: all)
–version version	Version of the binary diskcache dump format to output

filenames The filenames sub command is intended to query the memory cache. Several search options are available to restrict the set of filename returned.

Option	Description
–extension extension	filename extension to search
–ifo-type-list <ifo>-<type>- list	comma seperated list of <ifo>-<type>- entries to search
–start-time gps_time	GPS start time of interest
–end-time gps_time	GPS end time of interest

filenames-rds The filenames-rds sub command is intended to query the memory cache for filenames that can be used for createRDS command. Several search options are available to restrict the set of filename returned.

Option	Description
–extension extension	filename extension to search
–ifo ifo	IFO
–end-time gps_time	GPS end time of interest
–resample	Specify that resampling will be done
–start-time gps_time	GPS start time of interest
–type type	Type specifier of the the filename.

intervals The intervals sub command is intended to query the memory cache and return time intervals of file data.

Option	Description
–extension extension	filename extension to search
–ifo-type-list <ifo>-<type>- list	comma seperated list of <ifo>-<type>- entries to search
–start-time gps_time	GPS start time of interest
–end-time gps_time	GPS end time of interest

mountPointStats The mount-point-stats sub command is intended to get some statistical information the memory cache grouped by the mount points.

Option	Description
–ifo pattern	IFO pattern to use for search. (Default: all)
–type pattern	Type pattern to use for search. (Default: all)

scan The scan sub command is intended to scan a set of directories for files of interest and generate a memory cache image.

Option	Description
–concurrency <integer>	Number of mount points to scan concurrently.
–extensions <list>	Comma seperated list of file extensions
–mount-points <list>	Comma seperated list of mount points to scan
–output-ascii <filename>	Filename for the ascii output; '-' to direct to standard output
–output-binary <filename>	Filename for the binary output
–type <pattern>	Type pattern to use for search. (Default: all)
–version-ascii <version>	Version of the ascii diskcache dump format to output
–version-binary <version>	Version of the binary diskcache dump format to output

diskcache scan –concurrency=1 –extensions=.gwf –mount-points=${HOME} –output-ascii=cache.txt

The above example shows how one can scan a directory looking for files

with the .gwf extension under their home directory and dump the results in ASCII format to a file named cache.txt in the default dump format. Since there is only one top level directory, the concurrency doesn't need to be any greater than one.

status