
**************************** System Overview ****************************

User Interface
==============
This is the interface that the user sees; it is provided by
the RSVCS ``applications''.

Shell
-----
The shell provides an interactive interface to RSVCS.

   rsvcs sh

the RSVCS shell acts somewhat like the normal shell (ksh), but provides
virtual direct access to the versioned filesystems of RSVCS as well
as the user's regular file system.

If so configured, a virtual-FS-only form of the rsvcs shell is available 
by telneting to the database host.

CLI
---
The command-line interface is structured somewhat like the SCCS CLI.
A single function dispatches multiple commands.

   export RSVCS_DATABASE=database[@host[%port]] 
   export RSVCS_FILESYSTEM=filesystem
   rsvcs ci file...
   rsvcs co [-l] file...
   ...

VFS
---
RSVCS also provides a native filesystem interface on systems that
have extensible filesystems, such as AIX.  This capability allows
the database owner to mount RSVCS filesystems and snapshots directly
into the host's file system.

   mount -o 1.6 -t rsvcs rscheme-0.6 /mnt/rs-0.6-1.6

Application Program Interface
=============================
This is the interface that the RSVCS library provides to it's
applications.


Kernel Call Interface
=====================
This is the interface that the kernel presents to the API library.


Kernel Services
===============
These are the functions available within the kernel, specifically
documented as well understood control points.

Service Areas:

Access Control
--------------
This area manages domains.  A domain is a subset of {object X action}


Data Module
-----------
This module provides the class definitions of objects stored persistently,
and basic methods on them.  This includes the general-purpose collection
classes imported from the Collection module.

Collection Module
-----------------
This module provides basic collection classes.
