X-Git-Url: https://git.openafs.org/?p=openafs.git;a=blobdiff_plain;f=doc%2Fman-pages%2Fpod1%2Fvos_release.pod.in;h=363ee7991b8dca97e73fbaef78bc41fe474f6e2b;hp=9aff1b81fac92acccbf46d75ac10e5867ef40c57;hb=683ea4a983ada3845ecc8589f0362802ed967dc2;hpb=ade56fa2f9ba8217919dbae301639c3ff10027ef
diff --git a/doc/man-pages/pod1/vos_release.pod.in b/doc/man-pages/pod1/vos_release.pod.in
index 9aff1b8..363ee79 100644
--- a/doc/man-pages/pod1/vos_release.pod.in
+++ b/doc/man-pages/pod1/vos_release.pod.in
@@ -7,15 +7,17 @@ vos_release - Updates read-only volumes to match the read/write source volume
=for html
-B
S<<< B<-id> > >>> [B<-force>]
+B S<<< B<-id> > >>>
+ [B<-force>] [B<-force-reclone>]
S<<< [B<-cell> >] >>>
- [B<-noauth>] [B<-localauth>] [B<-stayonline>]
+ [B<-noauth>] [B<-localauth>]
[B<-verbose>] [B<-encrypt>] [B<-noresolve>]
S<<< [B<-config> >] >>>
[B<-help>]
B S<<< B<-i> > >>>
- [B<-f>] S<<< [B<-c> >] >>> [B<-stayon>]
+ [B<-force>] [B<-force-r>]
+ S<<< [B<-c> >] >>>
[B<-noa>] [B<-l>] [B<-v>] [B<-e>] [B<-nor>]
S<<< [B<-co> >] >>>
[B<-h>]
@@ -107,15 +109,19 @@ on site definitions in the VLDB entry, the previous B command
completed successfully and all read-only sites currently have the same
volume. The Volume Server infers that the current B command
was issued because the read/write volume has changed. The Volume Server
-creates a new ReleaseClone and distributes it to all of the read-only
-sites.
+creates a new ReleaseClone volume and distributes a copy of the clone
+volume to all the read-only sites. In order to reduce the amount of data
+transferred during a release, the Volume Server sends incremental changes to
+remote sites during the release. The Volume Server only sends files and
+directories which have been changed in the read/write volume since the
+previous release.
=item *
If any site definition in the VLDB entry is marked with a flag, either the
previous release operation did not complete successfully or a new
read-only site was defined since the last release. The Volume Server does
-not create a new ReleaseClone, instead distributing the existing
+not create a new ReleaseClone, instead distributing the entire existing
ReleaseClone to sites marked with the C or C
flag. As previously noted, the VL Server marks each VLDB site definition
with the C flag as the site receives the ReleaseClone, and
@@ -129,6 +135,10 @@ flag. This is appropriate if, for example, the data at the read/write site
has changed since the existing ReleaseClone was created during the
previous release operation.
+The B<-force-reclone> will force the creation of a new release clone volume,
+but will not force a full volume dump to be distributed to the remote sites.
+Instead, incremental changes will be distributed when possible.
+
=head1 OPTIONS
=over 4
@@ -140,15 +150,15 @@ volume.
=item B<-force>
-Creates a new ReleaseClone and distributes it all read-only sites
-regardless of whether or not any site definitions in the VLDB entry are
-marked with a flag.
+Creates a new ReleaseClone and distributes the entire clone volume to
+all read-only sites, regardless of the C, C, or
+C site flags.
-=item B<-stayonline>
+=item B<-force-reclone>
-Avoids taking replica sites offline by cloning both the source
-and destinations to temporary clones, applying updates, and then
-bringing all clones online as updated readonly volumes.
+Creates a new ReleaseClone and incrementally distributes the clone volume to
+all read-only sites, regardless of the C, C, or
+C site flags.
=include fragments/vos-common.pod