vfindany(1)

Name

vfindany - Locate a repositrory with a real copy of an object

Synopsis

vfindany [-h hints] path

In the most common usage, only the path argument is given.

Contents

• Description
• Flags
• Configuration
• See Also
• Author

Description

See the vesta-intro man page's Terminology section for definitions of terms, and its Name Interpretation section for an explanation of how names are looked up.

The vfindany command attempts to find a real copy of a prticular object (i.e. one that is not a stub and not a ghost) in some repository. This is simply a command-line interface to the algorithm used by vcheckout and other repository tools.

If the name path is unqualified (does not have "/", ".", or ".." as its first arc), it is interpreted relative to the site's default directory of packages, DefaultPackageParent.

Note that path is required.

In searching for a real copy of the object, the following reopositories will be consulted:

• The local repository
• Any repositories given as hints on the command line
• Any repositories given as hints with the [UserInterface]DefaultHints configuration setting
• Any repositories found in master-repository "hint" attributes on the object or enclosing directories

The output of vfindany is a host name and TCP port number in the format host:port:

% vfindany /vesta/vestasys.org                 
dev.vestasys.org:21776

Note that the output is the authoritative or advertised address for the repository. In other words, it's the host and port which the repository server knows as its own address. The same repository might be reachable with more than one address. In some cases vfindany may have reached the repository using an address other than the one displayed. For example:

• A repository host might have multiple hostnames (e.g. aliases in a local /etc/hosts files, or DNS CNAME records).
• The optional [Repository]master_hint configuration setting can be used to give a repository a particular authoritative address. This is sometimes different from the address used to contact a repository. A repository on a laptop installation might be contacted using localhost but have [Repository]master_hint set to its address when attached to a "home" network.

Flags

-h hints

If vfindany fails to find a real copy of an object in either the local repository or any of those repositories listed in [UserInterface]DefaultHints, you can suggest additional repositories for it to look in using this option. The hints argument is a comma- or space-separated list of repositories, 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.

Configuration

The following values are obtained from the [UserInterface] section of the Vesta configuration file (vesta.cfg).

AppendableRootName

The filename under which the global root directory of Vesta repositories is mounted. Ordinarily set to /vesta.

DefaultPackageParent

The default directory to put new packages in. Ordinarily a subdirectory of the appendable root, named with an Internet domain name belonging to the local site.

realm

Global user names are formed by appending @realm to the local name.

DefaultHints

A comma- or space-separated list of additional repositories to search for a copy of an object. Each 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. This setting is optional.

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.

realm

If [UserInterface]realm is not set, realm from the [Repository] section is used instead.

See Also

vesta-intro(1), repos-ui(1), vcheckout(1), repository(8)

Author

Ken Schalk <ken@xorian.net>