man-page-misc-updates-20071225
[openafs.git] / doc / man-pages / pod1 / vos_move.pod
index 5c3c308..7ca03ce 100644 (file)
@@ -1,23 +1,29 @@
 =head1 NAME
 
-vos move - Moves a read/write volume to another site
+vos_move - Moves a read/write volume to another site
 
 =head1 SYNOPSIS
 
-B<vos move> B<-id> <I<volume name or ID>>
-    B<-fromserver> <I<machine name on source>>
-    B<-frompartition> <I<partition name on source>> 
-    B<-toserver> <I<machine name on destination>>  
-    B<-topartition> <I<partition name on destination>> 
-    [B<-cell> <I<cell name>>] [B<-noauth>] [B<-localauth>] [B<-verbose>]
-    [B<-help>]
-
-B<vos m -i> <I<volume name or ID>>
-    B<-froms> <I<machine name on source>> 
-    B<-fromp> <I<partition name on source>>
-    B<-tos> <I<machine name on destination>> 
-    B<-top> <I<partition name on destination>>
-    [-c <I<cell name>>] [B<-n>] [B<-l>] [B<-v>] [B<-h>]
+=for html
+<div class="synopsis">
+
+B<vos move> S<<< B<-id> <I<volume name or ID>> >>>
+    S<<< B<-fromserver> <I<machine name on source>> >>>
+    S<<< B<-frompartition> <I<partition name on source>> >>>
+    S<<< B<-toserver> <I<machine name on destination>> >>>
+    S<<< B<-topartition> <I<partition name on destination>> >>>
+    [B<-live>] S<<< [B<-cell> <I<cell name>>] >>> [B<-noauth>]
+    [B<-localauth>] [B<-verbose>] [B<-help>]
+
+B<vos m> S<<< B<-i> <I<volume name or ID>> >>>
+    S<<< B<-froms> <I<machine name on source>> >>>
+    S<<< B<-fromp> <I<partition name on source>> >>>
+    S<<< B<-tos> <I<machine name on destination>> >>>
+    S<<< B<-top> <I<partition name on destination>> >>> [B<-li>]
+    S<<< [B<-c> <I<cell name>>] >>> [B<-n>] [B<-l>] [B<-v>] [B<-h>]
+
+=for html
+</div>
 
 =head1 DESCRIPTION
 
@@ -114,6 +120,14 @@ Names the partition to which to move the volume. Provide the full
 partition name (for, example, B</vicepa>) or one of the abbreviated forms
 described in L<vos(1)>.
 
+=item B<-live>
+
+Avoids making a temporary copy of the volume during the move. This is
+useful if the partition is full, but the administrator needs to move
+volumes to a another partition or server to free up disk space. The
+caveat is that the volume is locked during the entire operation
+instead of the short time that is needed to make the temporary clone.
+
 =item B<-cell> <I<cell name>>
 
 Names the cell in which to run the command. Do not combine this argument
@@ -168,6 +182,7 @@ superuser C<root>.
 L<vos(1)>,
 L<vos_addsite(1)>,
 L<vos_backup(1)>,
+L<vos_copy(1)>,
 L<vos_release(1)>,
 L<vos_listvol(1)>,
 L<vos_remove(1)>