#set TITLE = "shsql environment
#include top

.LP
In order to successfully access a \fBshsql\fR database, a given process or
session must have access to the required environment variables and must
be owned by an appropriate userid and groupid.

#include space

.SH Environment variable
.LP
\fBSHSQL_DB\fR -
the full pathname of the project directory.  A 
#set FILE = "config.html"
#set TAG = "project config file"
#include link
named \fCconfig\fR should be located there.
If multiple \fBshsql\fR databases are in use, use this environment variable 
to select which database is currently active (only one database can be
currently active at a time, and joins across databases are not supported).

#include space
.SH Config file
A 
#set FILE = "config.html"
#set TAG = "project config file"
#include link
must already exist.
A config file is automatically created when you 
#set FILE = "project_setup.html"
#set TAG = "create a SHSQL database."
#include link

#include space

.SH UserID and GroupID
\fBshsql\fR does not do any user identity authentication.
Access to all database files is enforced by Unix file permissions.
Thus processes that expect to update a database should be owned by a userID that
can write to database files and directories.  The same goes for read access.

#include bottom
