DEVEL15-afsd-shutdown-doc-improvement-20061105

Change the CAUTIONS about afsd -shutdown to be less dire and more accurate,
as this now mostly works on Linux.


(cherry picked from commit f82012552166a51edf6931b05abd0380c429d6b6)
This commit is contained in:
Russ Allbery 2006-11-09 23:58:43 +00:00 committed by Derrick Brashear
parent 00363f6fff
commit 774c543275

View File

@ -344,11 +344,16 @@ suites. Provide the command name and all option names in full.
=head1 CAUTIONS
Do not use the B<-shutdown> parameter. It does not shutdown the Cache
Manager effectively. Instead, halt Cache Manager activity by using the
standard UNIX B<umount> command to unmount the AFS root directory (by
convention, F</afs>). The machine must then be rebooted to reinitialize
the Cache Manager.
Before using the B<-shutdown> parameter, use the standard UNIX B<umount>
command to unmount the AFS root directory (by convention, F</afs>). On
Linux, unloading the AFS kernel module and then loading it again before
restarting AFS after B<-shutdown> is recommended.
AFS has for years had difficulties with being stopped and restarted
without an intervening reboot. While most of these issues have been
ironed out, stopping and restarting AFS is not recommended unless
necessary and rebooting before restarting AFS is still the safest course
of action.
=head1 OPTIONS