STARTVENUS(8) —
NAME
startvenus − start venus (8V) from parameters in /etc/vstab (AFS only)
SYNOPSIS
startvenus [ -V venusfile ] [ -m mountprogram ]
DESCRIPTION
Startvenus reads the file /etc/vstab and starts the venus program with the parameters specified therein. It also mounts the Andrew file system kernel intercept device at the appropriate spot in the local file system.
The default location for the venus program is /etc/venus2.
The /etc/vstab file consists of 6 fields, separated by ":" characters. The first is the location in the local file system where the remote file system should be mounted. The second is the device. The startvenus should mount with the -m mountprogram. The third is a comma-separated list of file server host names to be used for getting volume location information. In general, one need not list more than 3 machines in this list; alternatives are only used when one is down. The fourth element is the directory which venus should use for its cache directory. Anything that does not look like a venus file from a previous run of venus will be deleted from this directory. The fifth element is the space to be used by venus, in units of 1024 bytes. The final element is the number, in decimal, to be passed to venus using the -i flag. These are generally option flags to venus.
NOTES
The default mount program is /bin/true. The use of startvenus to mount the vice file system is obsolete. Venus now does the mount itself.
The /etc/vstab file is built by /viced(8) from information in rc.config(5).
EXAMPLES
The command line
startvenus -V /usr/etc/venus2
with an /etc/vstab file containing
/ibm:vice2,vice6,vice5:/usr/vice/cache:13000:16
will start the program /usr/etc/venus2 using /ibm for the file system mount point. It will contact the hosts vice2, vice6 and vice5 for volume location information, not necessarily in that order. The venus cache directory will be /usr/vice/cache, and then venus will be allowed to use up to 13000 1024-byte blocks. The venus "-i" flags are 16, meaning that the venus can assume the kernel supports "read while fetching."
FILES
/etc/vstab
SEE ALSO
DIAGNOSTICS
Startvenus complains if it cannot exec either the venus or mount programs. This page intentionally left blank.
PRPQs 5799-WZQ/5799-PFF: IBM/4.3 — Sept 1988