[OpenAFS-Doc] patch to add copy date to vos_examine

[Russ Allbery]

Michael Meffie <mmeffie@sinenomine.net> writes:

>  =item *
>  
> +The date and time this copy of this volume was created, in the C<Copy> field.
> +For read-only volumes this is the last release date and time. The copy
> +date is not stored in volume dumps.

This appears to not be correct.

users.r.r.readonly               2003263359 RO         79 K  On-line
    afssvr44.Stanford.EDU /vicepj 
    RWrite 2003263358 ROnly          0 Backup          0 
    MaxQuota       5000 K 
    Creation    Wed Jan 21 15:21:11 2009
    Copy        Tue Aug 26 05:33:06 2008
    Backup      Wed Jan 21 02:07:02 2009
    Last Update Wed Jan 21 15:21:10 2009
    0 accesses in the past day (i.e., vnode references)

Note that the Creation date, which does appear to be the last release
time, significantly postdates the Copy date.  I believe the Copy date is
the date at which that volume was created on that server and partition,
making the following patch correct:

--- vos_examine.pod     13 Jul 2008 23:33:39 -0000      1.7
+++ vos_examine.pod     2 Feb 2009 01:06:28 -0000
@@ -170,7 +170,15 @@ expressed in kilobyte blocks in the C<Ma
 
 The date and time the volume was created, in the C<Creation> field. If the
 volume has been restored with the B<backup diskrestore>, B<backup
-volrestore>, or B<vos restore> command, this is the restore time.
+volrestore>, or B<vos restore> command, this is the restore time. For a
+read-only volume, this is the last release time.
+
+=item *
+
+The date and time this copy of this volume was created, in the C<Copy>
+field.  This is the time when the volume was created on this server and
+partition.  For read-only volumes, it is not updated by a release (unlike
+the Creation date).  The copy date is not stored in volume dumps.
 
 =item *
 
@@ -305,6 +313,7 @@ shows the volume as locked.
         RWrite 5360870981   ROnly 536870982   Backup 536870983
         MaxQuota      40000 K
         Creation    Mon Jun 12 15:22:06 1989
+        Copy        Mon Jun 12 15:22:06 1989
         Last Update Fri Jun 16 09:34:35 1989
         5719 accesses in the past day (i.e., vnode references)
         RWrite: 5360870981   ROnly: 536870982   Backup: 536870983
@@ -323,6 +332,7 @@ the B<-extended> flag. The volume has no
        RWrite 354287190 ROnly          0 Backup 354287192
        MaxQuota       5000 K
        Creation    Wed Nov 25 17:38:57 1992
+       Copy        Wed Nov 25 17:38:57 1992
        Last Update Tue Dec 15 10:46:20 1992
        598 accesses in the past day (i.e., vnode references)
                          Raw Read/Write Stats

-- 
Russ Allbery (rra@stanford.edu)             <http://www.eyrie.org/~eagle/>