PrintCacheVal(1)

Name

PrintCacheVal - print the pickled binary values in cache entries to stdout

Synopsis

PrintCacheVal [ -n | -N ] [ -ci num ] [ path ]

Description

PrintCacheVal reads the MultiPKFile(s) named by path in the stable cache, and prints the pickled result values in their cache entries to the standard output. Each pickled value is preceeded by sizeof(int) bytes that represent the length of the subsequent value in bytes.

The path parameter should specify some subtree of the stable cache. All MultiPKFiles in that subtree are processed. If path is a relative path, it is interpreted relative to the stable cache root directory as specified by the user's Vesta configuration file. See the section on Configuration Variables below. If path is omitted, all MultiPKFiles in the stable cache are processed.

Switches

-n
If -n is specified, then no pickled values are written to the standard output. Instead, the number of cache entries in each MultiPKFile whose pickled values would be written to standard output are printed.

-N
Like -n, except that instead of printing the number of cache entries per MultiPKFile, the cache index and pickle size (in bytes) of each pickled value that would be written to standard output are printed.

-ci num
By default, the pickled values of all cache entries in the specified MultiPKFile are printed. If -ci num is specified, then only the pickled value associated with the cache entry with index num is printed. If cache entry num does not appear in the MultiPKFile named by path, nothing is printed.

Configuration Variables

Like most Vesta-2 applications, PrintCacheVal reads site-specific configuration information from a Vesta-2 configuration file named vesta.cfg. It first looks for this file in the current directory; if none is found there, it looks in your home directory.

The configuration file is divided into a number of sections, denoted in the file by [SectionName]. The variables used by PrintCacheVal are in the section denoted by [CacheServer]. Here are the relevant variables and their meanings; the types of the variables are shown in parentheses:

MetaDataRoot (string)
The pathname of the directory in which the Vesta system's metadata is stored. If this variable is undefined, the current directory is used. Other configuration variables are interpreted relative to this path.

MetaDataDir (string)
The directory (relative to the MetaDataRoot) in which the cache server's metadata is stored.

SCacheDir (string)
The directory (relative to the MetaDataRoot/MetaDataDir) in which the cache server stores cache entries.

Bugs

Currently, there is only support for printing the pickled values in a single MPKFile. However, find(1) can be used to walk the entire stable cache and print the pickled values in every cache entry.

See Also

PrintMPKFile(1), ShowCache(1), VCache(1), VCacheStats(1), MultiPKFile(5)

Author

Allan Heydon (caheydon@yahoo.com)

Created on Thu May 29 15:32:26 PDT 1997 by heydon
Last modified on Thu Nov  8 12:48:54 EST 2001 by ken@xorian.net
     modified on Fri May 30 17:29:13 PDT 1997 by heydon
This page was generated automatically by mtex software.