vfindmaster(1)

Name

vfindmaster - Locate the repositrory with the master copy of an object

Synopsis

vfindmaster [-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 vfindmaster command attempts to find the repository with the master copy of a prticular object. (That, is, the repository where that object's master flag is set.) This is simply a command-line interface to the algorithm used by vcheckout and other repository tools.

If omitted, path defaults to the current directory. 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.

In searching for the master copy, the following reopositories will be consulted:

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

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

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

Note that the output is the authoritative or advertised address for the master 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 vfindmaster 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 vfindmaster fails to find the master copy of an object 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 the master 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>