source: trunk/packs/maint/save_cluster_info.8 @ 15086

.TH SAVE_CLUSTER_INFO 8 "9 July 1987"
.FM mit
.SH NAME
save_cluster_info \- get a workstation's cluster information
.SH SYNOPSIS
.B /etc/athena/save_cluster_info
.SH DESCRIPTION
This shell script, as part of the reactivation process,
retrieves the workstation's network
environment information from the
.I hesiod
nameserver,
and writes that information into two files:
.I /var/athena/clusterinfo,
and
.I /var/athena/clusterinfo.bsh.
The first of these files is used
to set C shell environment variables,
while the second file sets Bourne shell variables.

Currently
.I save_cluster_info
sets the
.I LPR,
.I SYSLIB,
.I SYSPREFIX,
and
.I SYSCONTROL
shell variables.
The
.I LPR
variable specifies the workstation's default printer, and the
.I SYSLIB
variable specifies the name of its remote
.I system
filesystem.
The workstation's
.I reactivation
process uses the
.I SYSLIB
information to
.I attach
the workstation's default filesystem.  On platforms that do not use remote
filesystems for system software, the
.I SYSPREFIX
and
.I SYSCONTROL
variables are used to determine where to look for system software updates.

.I save_cluster_info
retrieves its information by calling the
.I hesiod
program
.I /etc/athena/getcluster.
If the call to
.I getcluster
fails,
.I save_cluster_info
will not change the workstation's current
.I /var/athena/clusterinfo
and
.I /var/athena/clusterinfo.bsh
files.
.SH FILES
/var/athena/clusterinfo
/var/athena/clusterinfo.bsh
.SH SEE ALSO
getcluster(8), reactivate(8), hesiod(3)