hoard(1)

NAME
hoard - hoard database front-end

SYNOPSIS
hoard [ -d ] [ -f source | cmds ]

DESCRIPTION
Hoard is a front-end to the hoard database (HDB) managed by the Coda cache manager, Venus. The HDB provides a means for users to explicitly control Venus caching behavior. HDB entries specify the degree of a users interest in particular file system objects. Venus combines this information with implicit knowledge that it has about file access patterns to try to keep the "best" set of objects in its cache at all times. The HDB is maintained in non-volatile storage, so it survives Venus restarts and client reboots. Users manipulate the HDB by issuing commands to the hoard program. The following hoard commands are currently recognized:

add  filename  <attributes>

clear  <uid>

delete  filename

list  outfile  <uid>

modify  filename  <attributes>
    Hoard distinguishes between children of a directory, which are members of the directory, descendants which are either children or descendants of childres of the directory. Commands may be abbreviated by their first letter. Parameters in angle brackets are optional, and have default values if unspecified. The attributes parameter is specified as a string of options separated by : characters. The currently recognized options are:

1-1000
    assign this object the hoard priority indicated

c   current children of this directory will inherit its hoard status

c+  current and future children of this directory will inherit its hoard status

d   current descendents of this directory will inherit its hoard status

d+  current and future descendents of this directory will inherit its hoard status If the uid in the clear and list commands is unspecified, the entries of all users are cleared or listed respectively. The default hoard priority is 10. An example command file is:

clear

add  /coda/project/coda/src  100:d+

add  /coda/usr/jjk/.login  1000
    Access to the hoard database is restricted in the following ways. All hoard commands fail unless the effective-uid is root--the hoard program should be made setuid to root to ensure this. Special permission is given to commands where the real-uid is root or that of the primary user, i.e., the user at the console. Root and primary users may add entries and access existing entries without restriction. Other users may not add hoard entries, and they may only clear, delete, list, or modify their own entries. The command-line options are:

-d  Enables debugging output.

-f source
    Take commands from file source. -f must be the last argument if specified. An argument of - means use stdin as the source file. Source statements may be given directly on the command line (one per line) by enclosing them in single quotes.

DIAGNOSTICS
Hoard copies command lines that it cannot parse to stderr. If a syntactically correct command is rejected by Venus, the corresponding pioctl, its arguments, and the errno are copied to stderr.

BUGS
Negative priorities should be allowed. A mount point of /coda is assumed by the pioctl library.

SEE ALSO
venus (8)

AUTHOR
Jay Kistler, 1990, Created