Tutorial

• This document walks you through an example use of Vesta. The tutorial covers the main commands you'll need to know as a Vesta user.

Command Summary

• This document summarizes the most common Vesta commands.

Language Reference

• This is a reference guide to the Vesta System Description Language, which is how builds are described under Vesta. (It still needs some work in a few places.) There is also the more precise technical specification of the SDL, but it's not terribly useful until you have a basic grasp of the language.

Language Specification

• This is a complete and precise specification of the Vesta SDL. Also appears as Appendix A of the book-length research report. (Note: this is not a guide for new users. For that, see the language reference.)

• Re-exporting the repository with Samba. A simple method that allows Windows clients to read and write files in the Vesta repository.

• Replicating Over SSH Port-Forwarding. When firewalls get in the way of replicating, securely tunnel your replication with SSH.

• vcheckout dissection. A detailed look at the implementation of vcheckout.

• Introduction and glossary: vesta-intro(1)

• Standard Construction Environment

  • Writing standard user models: vmodels(5)

  • Organization of libraries in Vesta: vlibraries(5)

  • Building with overrides: voverrides(5)

  • Standard types: vtypes(5)

• Evaluator

  • Delete junk, advance to the next version, and run the evaluator: vmake(1)

  • Just run the evaluator: vesta(1)

  • Determine model imports: vimports(1)

  • Update model imports: vupdate(1)

  • Start a RunToolServer for running external tools: RunToolServer(1)

• Repository user interface

  • Overview: repos-ui(1)

  • Create a directory: vmkdir(1)

  • Delete a file or directory: vrm(1)

  • Create a package: vcreate(1)

  • Check out a package: vcheckout(1)

  • Advance a checkout session: vadvance(1)

  • Check in a package: vcheckin(1)

  • Create a branch: vbranch(1)

  • Who has packages checked out: vwhohas(1)

  • Find latest package versions: vlatest(1)

  • Show the history of a package: vhistory(1)

  • Manipulate mutable attributes: vattrib(1)

  • Replicate sources from one repository to another: vrepl(1)

  • Transfer mastership between repositories: vmaster(1)

  • Expand a pattern using the same syntax as vrepl: vglob(1)

• Repository server

  • Main program: repository(8)

  • Ancillary shell scripts: mountrepos(8), umountrepos(8)

  • Access control utilities: vid(1), vaccessrefresh(8)

  • Test programs: TestShortId(8), TestVDirSurrogate(8)

• Cache server

  • Main program: VCache(1)

  • Identify the cache: WhichCache(1)

  • List/erase stable cache files: CleanCache(1), EraseCache(1), ShowCache(1)

  • Monitor a running cache: VCacheMonitor(1)

  • Configure the cache: CreateCacheDirs(1)

  • Flush volatile cache entries to stable cache: FlushCache(1)

  • Print statistics about the contents of the stable cache: VCacheStats(1)

  • Examine cache files: PrintCacheLog(1), PrintGraphLog(1), PrintMPKFile(1)

  • Manually checkpoint the cache: ChkptCache(1)

  • Test programs: TestCache(1), TestCacheRandom(1)

• Weeder

  • Real weeder: VestaWeed(1)

  • Conservative weeder: QuickWeed(1)

• Miscellaneous

  • The Vesta config file: vesta.cfg(5)

  • Read the Vesta config file: vgetconfig(1)

  • Vesta mount program: vmount(8)

  • Simple tools for VestaLog atomically appendable logs: vdumplog(8), vappendlog(8)