vos

Previous: aklog

Up: AFS Commands

Next: Special string @sys


vos

The command vos is primarily of interest to system administrators, but it does have a few functions of interest to general users. Specifically, it is used to query and manipulate volumes. The vos command is in the afsuser locker. To use it, you should first add afsuser.

The command vos examine is used to find out general information about a volume. This information includes the volume identification number of the volume itself, as well as the volume identification number of the backup and read-only volumes associated with it (if they exist). It also tells what server the volume is located on and when the volume has last been released or backed up. In addition, it tells you when the volume was last changed, and what the maximum quota of the volume is. Here is an example:

athena% vos examine user.autumn
user.autumn                       536956932 RW       2077 K  On-line
    CIRCE.MIT.EDU /vicepa
    Parent  536956932 Clone          0 Backup  536956934
    MaxQuota       5000 K
    Creation    Fri May 22 15:52:21 1992
    Last Update Fri Jun 26 15:42:15 1992
    1539 accesses in the past day

        readWriteID 536956932   valid
        readOnlyID  0           invalid
        backUpID    536956934   valid
    number of sites -> 1
    server CIRCE.MIT.EDU partition /vicepa RW Site
Suppose I want to know when my account was last backed up. I can use the same command on user.autumn.backup to find out:
athena% vos examine user.autumn.backup
user.autumn.backup                536956934 BK       2087 K  On-line
    CIRCE.MIT.EDU /vicepa
    Parent  536956932 Clone          0 Backup  536956934
    MaxQuota       5000 K
    Creation    Sun Jun 28 23:03:11 1992
    Last Update Sun Jun 28 23:03:11 1992
    0 accesses in the past day

        readWriteID 536956932   valid
        readOnlyID  0           invalid
        backUpID    536956934   valid
    number of sites -> 1
    server CIRCE.MIT.EDU partition /vicepa RW Site
This tells me that my backup volume was last updated on Sunday, June 28.

Another useful command is vos listvldb. In the form fs listvldb -name volumename (where volumename is the name of the volume in the form given by fs lsm), this command will tell you what server the volume volumename is on (among other things), even if that server is down.

For more information on the command vos, you can type man vos at the athena% prompt.