VOS(8)

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
    make a backup copy of a volume
backupsys
    make backup copies of a number of volumes
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
listaddrs
    list registered addresses in vldb
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 string
Search for a command matching string.

vos backup [-id] volumeid [-cell cellname] [-noauth] [-localauth] [-verbose]
Make a backup copy of a single volume. This command clones the volume given as argument into a backup volume with the postfix .backup.

vos backupsys [-cell cellname] [-noauth] [-localauth] [-verbose]
Makes backup copies of all the volumes in a cell. The volumes are cloned into backup volumes with the postfix .backup.

vos changeaddr
Not yet implemented.

vos create [-server] servername [-part] partition [-volume] volumename [-cell cellname] [-noauth] [-localauth] [-verbose]
Create a new volume named volumename on server servername partition partition. Note that volumename can be no longer than 22 characters.

vos createentry [-id] volumeid [-host] host [-fsserver] fileserver [-rw] rwvolumeid [-ro] rovolumeid [-bk] bkvolumeid [-noauth] [-localauth]
Create a vldb entry manually. This command should not be used unless 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 volume on fileserver to a filename.

vos endtrans [-server] server [-trans] transaction [-cell cellname] [-noauth] [-verbose]
End a transaction.

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

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

vos help
Print help.

vos?
vos? Shorthand for help.

vos listaddrs [-cell cellname] [-noauth] [-localauth] [-noresolve] [-printuuid]
Lists all addresses registered in the vldb

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

vos listvldb [-fileserver fileserver] [-cell cellname] [-noauth] [-localauth] [-verbose]
List volumes in the volume location database without reading them on the fileserver, optionally restricting the list to the volumes located on a specific fileserver.

vos listvol [-server] fileserver [-partition] partition [-cell cellname] [-noauth] [-localauth] [-verbose]
List volumes on fileserver, without consulting the volume location database, optionally restricting the list to the volumes located on a specific fileserver.

vos lock
Not yet implemented.

vos move
Not yet implemented.

vos partinfo [-server] fileserver [-partition] partition [-cell cellname] [-noauth] [-localauth] [-verbose]
List the total and remaining diskspace on fileserver, optionally restricting the list to a specific partition.

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
fs(1), pts(1), afsd(8), bos(8)

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.