VOS(1)                     OpenBSD Reference Manual                     VOS(1)

NAME
     vos - manage AFS volumes and the VLDB

SYNOPSIS
     vos [command] [args]

DESCRIPTION
     The vos utility is used to manage AFS volumes and the volume location
     database (VLDB).

     vos provides several commands:

     addsite      not yet implemented
     apropos      apropos
     backup       not yet implemented
     backupsys    not yet implemented
     changeaddr   not yet implemented
     create       create a volume
     createentry  create a vldb entry
     delentry     not yet implemented
     dump         dump a volume
     endtrans     end a transaction
     examine      print information about a volume
     volinfo      print information about a volume
     help         print help
     ?            print help
     listpart     list partitions on a server
     listvldb     list volumes in volume-location-database
     listvol      list volumes on a server
     lock         not yet implemented
     move         not yet implemented
     partinfo     print partition information on a server
     release      not yet implemented
     remove       not yet implemented
     remsite      not yet implemented
     rename       not yet implemented
     restore      not yet implemented
     status       Show volume server transactions
     syncserv     not yet implemented
     syncvldb     not yet implemented
     syncsite     print the syncsite
     unlock       not yet implemented
     unlockvldb   not yet implemented
     zap          not yet implemented
     quit         exit interactive mode

     Most vos commands accept the following general arguments:

           [-cell cellname] Specifies which AFS cell to use, if the default
           cell is not to be used.

           [-noauth] Specifies that vos should not try to authenticate the
           connection to the server.  This may be useful with shell scripts,
           or if there is a problem with the AFS cell.  Note that the server
           will reject many commands if -noauth is specified.

           [-localauth] Create a ticket using the AFS server key, that is, you
           don't need a token.  This will generally only work on AFS servers,
           and is very useful for performing automatic tasks.

     The syntax of the vos commands:

     vos addsite
           not yet implemented

     vos apropos
           apropos

     vos backup
           not yet implemented

     vos backupsys
           not yet implemented

     vos changeaddr
           not yet implemented

     vos create [-server] fileserver [-part] partition [-volume] volume name
     [-cell cellname] [-noauth] [-localauth] [-verbose]
           Create a new volume named volume name on server fileserver parti-
           tion partition.

     vos createentry [-id] id of volume [-host] host to use [-fsserver]
     fileserver [-rw] volume RW number [-ro] volume RO number [-bk] volume BK
     number [-noauth] [-localauth]
           Create a vldb entry manually.  This command should not be used un-
           less you know exactly what you are doing.

     vos delentry
           not yet implemented

     vos dump [-id] volume [-server fileserver] [-partition partition] [-cell
     cellname] [-file filename] [-noauth] [-localauth] [-verbose]
           Dump a volume to a file.

     vos endtrans [-server] server [-trans] transaction [-cell cellname]
     [-noauth] [-verbose]
           End a transaction.  XXX what is this?

     vos examine [-id] volume [-host] server [-cell cellname] [-noauth]
     [-localauth] [-verbose] [-extended]
           Print information about a volume.

     vos volinfo
           vos volinfo is an alias for the vos examine command.

     vos help
           print help

     vos ?
           vos ? is an alias for the vos help command.

     vos listpart [-server] fileserver [-cell cellname] [-noauth] [-localauth]
     [-verbose]
           List partitions on a fileserver.

     vos listvldb [-server] fileserver [-cell cellname] [-noauth] [-localauth]
     [-verbose]
           List volumes in the volume location database without reading them
           on the fileserver.

     vos listvol [-server] fileserver [-partition] partition [-cell cellname]
     [-noauth] [-localauth] [-verbose]
           List volumes on a fileserver, without consulting the volume loca-
           tion database.

     vos lock
           not yet implemented

     vos move
           not yet implemented

     vos partinfo [-server] fileserver [-partition] partition [-cell cellname]
     [-noauth] [-localauth] [-verbose]
           Print the total and remaining diskspace on a fileserver.

     vos release
           not yet implemented

     vos remove
           not yet implemented

     vos remsite
           not yet implemented

     vos rename
           not yet implemented

     vos restore
           not yet implemented

     vos status [-server] fileserver [-cell cellname] [-noauth] [-verbose]
           Show volume server transactions.

     vos syncserv
           not yet implemented

     vos syncvldb
           not yet implemented

     vos syncsite
           print the syncsite

     vos unlock
           not yet implemented

     vos unlockvldb
           not yet implemented

     vos zap
           not yet implemented

     vos quit
           Exit interactive mode.

SEE ALSO
     afsd(8), pts(1), fs(1)

STANDARDS
     The Arla authors are trying to mimic the behaviour of the original AFS
     utilities.

AUTHORS
     The Arla project <http://www.stacken.kth.se/project/arla/>.

BUGS
     Quite a lot of commands are not implemented yet.

OpenBSD 3.0                     March 26, 2000                               3
