source: trunk/packs/maint/reactivate.8 @ 15992

Revision 15992, 3.1 KB checked in by rbasch, 24 years ago (diff)
Changes to run reactivate out of cron instead of from xlogin: - Check whether the machine is in use by looking at both utmp entries (via "who" output) and session records. - Create a pid file so only one instance runs at a time, and to flag when reactivate is running. - Maintain a count file, so that we only detach all filesystems on every tenth invocation. - Set "quiet" based on whether standard input is a tty, instead of whether $USER is set. - Quit if the machine is in the middle of an update. Also: - Create /etc/nologin during full reactivates. - Only nuke /tmp for PUBLIC=true machines. - Use syncupdate to restore /etc/group.local.
Line 
1.TH REACTIVATE 8 "25 May 1994"
2.FM mit
3.SH NAME
4reactivate \- reset the state of an idle workstation
5.SH SYNOPSIS
6.B /etc/athena/reactivate
7[
8.B \-detach | \-prelogin
9]
10.SH DESCRIPTION
11The
12.I reactivate
13script initializes an idle workstation and resets the state after a
14user has logged out.  It is invoked regularly from
15.I cron
16and exits immediately if anyone is logged in, unless the
17.B \-prelogin
18option is specified.  It also exits if another
19.I reactivate
20process is found to be running.
21
22When the workstation is idle,
23.I reactivate
24performs several tasks:
25.TP
26+ It disables logins for the duration of its execution.
27.TP
28* It flushes all filesystem authentication from the workstation.
29.TP
30* It resets the zephyr hostmanager (\fIzhm\fR).
31.TP
32* It destroys any ticket files remaining in /tmp.
33.TP
34+ It cleans out /tmp.
35.TP
36* It resets the password and group files to their default
37contents.
38.TP
39+ It reconfigures some AFS state (including running config_afs).
40.TP
41* It runs cleanup.
42.TP
43+ It detaches all attached filesystems.
44.TP
45+ It attaches the appropriate system packs.
46.TP
47+ It invokes an automatic software update if available.
48.TP
49* It turns off remote network access to the workstation,
50preventing unexpected and possibly hostile remote connections.
51After logging in, you can use the
52.I access_on
53command to allow remote access.
54.TP
55+ It executes the local customizations in the file
56.I /etc/athena/reactivate.local,
57if it exists.
58.PP
59.SH OPTIONS
60.TP
61.B \-detach
62causes
63.I reactivate
64to detach all attached filesystems.  This is not
65done on every invocation to cut down on the network traffic from idle
66workstations.  Without this option,
67.I reactivate
68will still detach all attached filesystems periodically, by keeping a
69count of how many times it has been invoked.
70.TP
71.B \-prelogin
72causes
73.I reactivate
74to perform only the *'d tasks listed above, and only
75if PUBLIC is set to true on the workstation. If PUBLIC is false,
76.I reactivate
77will simply exit. The purpose of this option is to provide
78.I xlogin
79a facility for making sure a PUBLIC workstation is as clean as it
80ought to be before a new user logs in. Specifically, this means making
81sure that no other users are logged on or have running processes, and
82that remote access is turned off. A full invocation of the script
83isn't used for this purpose in order to minimize time a user has to
84wait to log in after the previous user has logged out.
85
86In the absence of this option,
87.I reactivate
88performs all listed tasks.
89.B \-prelogin
90and
91.B \-detach
92may not be specified simultaneously.
93
94.SH FILES
95.DT
96.nf
97/var/athena/clusterinfo         These files contain the information
98/var/athena/clusterinfo.bsh     received from the nameserver.
99/etc/athena/rc.conf                     Contains configuration variables
100/etc/passwd.local                       Default contents of password file
101/etc/group.local                        Default contents of group file
102/etc/athena/reactivate.local    Optional local additions
103/etc/nologin                            Disables logins
104/var/athena/reactivate.pid      Contains reactivate process ID
105/var/athena/reactivate.count    Contains reactivate invocation count
106.fi
107.SH SEE ALSO
108dm(8), xlogin(8), save_cluster_info(8), access_on(1) and access_off(1),
109attach(1) and detach(1), fsid(1), hesiod(3), zhm(8)
Note: See TracBrowser for help on using the repository browser.