vcollapsebase(8)

Name

vcollapsebase - Replace the chain of base directories of a mutable or immutable directory with a collapsed representation for increased efficiency.

Synopsis

vcollapsebase [-c] [-R host[:port]] directory [directory...]

Contents

• Description
• Flags
• Configuration
• Examples
• See Also

Description

vcollapsebase asks the repository to replace the chain of base directories of one or more mutable or immutable directories with a collapsed representation. This can improve efficiency of listing or performing a lookup in such directories.

To determine whether it there would be any benefit to using vcollapsebase on a directory, use vmeasure(8).

Using vcollapsebase on a directory with no base directory or a directory with a base chain of length 1 has no effect.

Flags

-R repos

Collapse in repos instead of the default local repository. The repository is specified by host name and TCP port number in the format host:port. The :port portion may be omitted; it defaults to [Repository]VestaSourceSRPC_port.

-c

Perform a paranoid consistency check to make sure that collapsing the base chain of a directory does not change it. (This option was added for testing purposes and is probably only useful for repository developers.)

Examples

Suppose there's a package with a high number of versions. First, we'll measure it to see how long its base chain is:

% vmeasure /vesta/example.com/builds/big_build/1389 \
           /vesta/example.com/builds/big_build/1389/params
/vesta/example.com/builds/big_build/1389:
        base chain length = 1283
        used entry count  = 9
        total entry count = 1365
        used entry size   = 310
        total entry size  = 24369
/vesta/example.com/builds/big_build/1389/params:
        base chain length = 844
        used entry count  = 9
        total entry count = 921
        used entry size   = 383
        total entry size  = 38571

These would be good candidates for base-chain collapsing. Some users may still be using other recent versions of this package, so we'll collapse a version in the middle of its base chain:

% vcollapsebase /vesta/example.com/builds/big_build/1300 \
                /vesta/example.com/builds/big_build/1300/params

If we measure the highest version again, we'll see that this has affected it as well:

% vmeasure /vesta/example.com/builds/big_build/1389 \
           /vesta/example.com/builds/big_build/1389/params
/vesta/example.com/builds/big_build/1389:
        base chain length = 90
        used entry count  = 9
        total entry count = 106
        used entry size   = 310
        total entry size  = 1845
/vesta/example.com/builds/big_build/1389/params:
        base chain length = 90
        used entry count  = 9
        total entry count = 105
        used entry size   = 383
        total entry size  = 4259

Configuration

The following values are obtained from the [Repository] section of the Vesta configuration file.

VestaSourceSRPC_host

The host name of the default (local) repository.

VestaSourceSRPC_port

The default TCP port number for repositories.

See Also

repository(8), vmeasure(8), vesta.cfg(5)

Author

Ken Schalk (ken@xorian.net) and Tim Mann

Last modified on Wed Feb 23 18:19:21 EST 2005 by ken@xorian.net