vos: changeaddr refuse to change mh entries without -force

[openafs.git] / doc / man-pages / pod1 / vos_changeaddr.pod.in

diff --git a/doc/man-pages/pod1/vos_changeaddr.pod.in b/doc/man-pages/pod1/vos_changeaddr.pod.in
index fe69633..4ca68c8 100644 (file)
--- a/doc/man-pages/pod1/vos_changeaddr.pod.in
+++ b/doc/man-pages/pod1/vos_changeaddr.pod.in
@@ -8,14 +8,14 @@ vos_changeaddr - Changes or removes a file server machine's entry in the VLDB
 <div class="synopsis">
 
 B<vos changeaddr> S<<< B<-oldaddr> <I<original IP address>> >>>
-    S<<< [B<-newaddr> <I<new IP address>>] >>> [B<-remove>]
+    S<<< [B<-newaddr> <I<new IP address>>] >>> [B<-remove>] [B<-force>]
     S<<< [B<-cell> <I<cell name>>] >>> [B<-noauth>] [B<-localauth>]
     [B<-verbose>] [B<-encrypt>] [B<-noresolve>]
     S<<< [B<-config> <I<config directory>>] >>>
     [B<-help>]
 
 B<vos changea> S<<< B<-o> <I<original IP address>> >>>
-    S<<< [B<-ne> <I<new IP address>>] >>> [B<-r>]
+    S<<< [B<-ne> <I<new IP address>>] >>> [B<-r>] [B<-f>]
     S<<< [B<-c> <I<cell name>>] >>>
     [B<-noa>] [B<-l>] [B<-v>] [B<-e>] [B<-nor>]
     S<<< [B<-co> <I<config directory>>] >>>
@@ -78,11 +78,21 @@ multihomed machine, use any of them to identify the server entry.
 Specifies the new IP address that replaces all currently registered
 addresses.
 
+Unless the B<-force> option is given, B<vos changeaddr> will refuse to change
+addresses when the address given in B<-oldaddr> is registered with a multihomed
+server entry in the VLDB. See L</CAUTIONS>.
+
 =item B<-remove>
 
 Removes from the VLDB the server entry that includes the address specified
 by the B<-oldaddr> argument.
 
+=item B<-force>
+
+Overrides the multihomed server entry check when the B<-oldaddr> and
+B<-newaddr> options are combined. The B<-force> flag is provided for historical
+compatibility and is not recommended.
+
 =include fragments/vos-common.pod
 
 =back