The dcachelist program

dcachelist - list the records of a cache file.

SYNOPSIS

dcachelist [options] <DCACHE

DESCRIPTION

dcachelist lists the record in DCACHE to the standard output.

OPTIONS

-i, --ignore-expire: ignore expiration date The default is to honor the expiration date and therefore to not list expired records.
-m, --machine: machine readable output format. This dumps the hash table.
--output-format-help: A description of the output format.
--caveats: Caveats you might want to know about.
--see-also: Where to find related information.
--examples: Usage examples.
--version: Show version: dcachelist (dcache) 0.6.1-beta2.
--help: Show a list of options or the long help on one. The use with an argument shows the long help text of that option, without an argument it will list all options.
--longhelp: Show longer help texts for all or one option.

EXAMPLES

dcachelist <dcache

  lists the content of dcache.

dcachelist -m <dcache

  lists the content in a different format.

dcachelist -i <dcache

  also shows expired records.

OUTPUT FORMAT

By default the following information is printed, with one line per record:

  An index number.
  The expiration time, if not empty, as tai64n label.
  The data length.
  The key.

Control characters, white space and the backslash character will be backslash-escaped (\\20 stands for a space, \\5c for a backslash).

Machine readable output format is printed as one information per line. The first character on each line is a tag.

  # The index number.
  S The slot where the record should be (it may be somewhere else in
    case of collisions).
  I The key, followed by a newline. The key is encoded as describe above.
  P The position of the record in the file.
  H The hash of the key.
  @ The expiration time - if any.
  L The data length.

CAVEATS

This command is meant to print an overview of what is in the cache. Use dcachedump(1) instead if the keys might contain non-printable characters.

COPYRIGHT

The software comes with NO WARRANTY, to the extent permitted by law.

This package is published under the terms of the GNU General Public License version 2. Later versions of the GPL may or may not apply, see http://www.ohse.de/uwe/licenses/

AUTHOR

Uwe Ohse, <uwe@ohse.de>.

MORE INFORMATION

Please report bugs to <dcache@lists.ohse.de>