vlatest - Find the latest versions of Vesta packages
vlatest [-n | -p | -b | -c] [-m] [-t] [-v] [-R repos] [directory...]
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 vlatest command prints the latest checked-in version name for the given packages, or for the packages in the given directory trees. By default, it considers both the given directories and (recursively) any of their subdirectories that are not branches, and it prints the absolute pathname of each latest version found.
In more detail, vlatest walks the directory tree rooted at each of the given package arguments, with the extent of the walk controlled by the flags documented below. For each package found, it prints out the version pathname whose last arc is entirely composed of decimal digits with no extra leading zeros and whose numeric value is highest. A package argument can be either a package, or an appendable directory that might have packages in the subtree below it.
If the name package is unqualified (does not have "/", ".", or ".." as its first arc), it is interpreted relative to the site's default directory of packages, DefaultPackageParent. If package is omitted, it defaults to /vesta.
vlatest returns status 0 for success, 1 for parameter syntax errors, or 2 for more serious errors.
- -n
- No recursion. Only the specified directories are searched for package versions, not any branches or other subdirectories. Each directory must be a package.
- -p
- Recurse to the package level. All the specified directories are searched, and (recursively) any subdirectories that are not branches or checkout sessions. This is the default.
- -b
- Recurse into branches. All the specified directories are searched, and (recursively) any subdirectories that are not checkout sessions.
- -c
- Recurse into checkout sessions. The specified directories and all subdirectories are searched, including branches and checkout sessions.
- -m
- Try to get more complete and authoritative information by accessing the master copy of each object. Without this flag, packages and versions that are not replicated in the local repository are missed.
- -t
- Print only the tail of each package version name, that is, only the portion following what was given on the command line. If you specify this flag, you may give at most one package argument.
- -v
- Print change history message for latest versions.
- -R repos
- Look 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.
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.
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.
If a package is mastered at one repository but has been checked out at another, it can be checked back in without the master repository's knowledge. If this happens, "vwhohas -m" will not know about the new version. This occurrence should be rare, however, since by default vcheckin replicates the new version back to the package's master repository.
Last modified on Fri Jan 21 10:53:58 EST 2005 by irina.furman@intel.com
modified on Tue Apr 29 23:57:11 PDT 2003 by mann
modified on Tue Nov 13 11:49:37 EST 2001 by ken@xorian.net
This page was generated automatically by
mtex software.