NAME

vos - suite of commands for contacting the AFS Volume Server. 

SYNOPSIS

vos <option>

Each of the the following operation codes is a valid <option> and has its own set of associated arguments.  See the "OPTIONS" section below for syntax definitions. 

addsite - add a replication site
apropos - search by help text
backup - make backup of a volume
backupsys - en masse backups
create - create a new volume
delentry - delete VLDB entry for a volume
dump - dump a volume
examine - everything about the volume
help - get help on commands
listpart - list partitions
listvldb - list volumes in the VLDB
listvol - list volumes on server (bypass VLDB)
lock - lock VLDB entry for a volume
move - move a volume
partinfo - list partition information
release - release a volume
remove - delete a volume
remsite - remove a replication site
rename - rename a volume
restore - restore a volume
status - report on volser status
syncserv - synchronize server with VLDB
syncvldb - synchronize VLDB with server
unlock - release lock on VLDB entry for a volume
unlockvldb - unlock all the locked entries in the VLDB
zap - delete the volume, don’t bother with VLDB

DESCRIPTION

The commands in the vos suite are an interface to the Volume Server, which manipulates volumes as atomic entities, and the Volume Location Server, which maintains information about volumes in the Volume Location Database (VLDB)--most importantly, their location.  There are vos commands that allow system administrators to create, move, delete, replicate and back up volumes. 

OPTIONS

addsite - add a replication site
syntax: vos addsite  -server <machine name for new site>  -partition <partition name for new site>  -id <volume name or ID>  [-cell <cell name>]  [-noauth]  [-localauth]  [-verbose]  [-help]

apropos - search by help text
syntax: vos apropos  -topic <help string>  [-help]

backup - make backup of a volume
syntax: vos backup  -id <volume name or ID>  [-cell <cell name>]  [-noauth]  [-localauth]  [-verbose]  [-help]

backupsys - en masse backups
syntax: vos backupsys  [-prefix <common prefix on volume(s)>]  [-server <machine name>]  [-partition <partition name>]  [-cell <cell name>]  [-noauth]  [-localauth]  [-verbose]  [-help]

create - create  a new volume
syntax: vos create  -server <machine name>  -partition <partition name>  -name <volume name>  [-cell <cell name>]  [-noauth]  [-localauth]  [-verbose]  [-help]

delentry - delete VLDB entry for a volume
syntax: vos delentry   [-id <volume name or ID>]  [-prefix <prefix of the volume whose VLDB entry is to be deleted>]  [-server <machine name>] [-partition <partition name>]  [-cell <cell name>]  [-noauth]  [-localauth]  [-verbose]  [-help]

dump - dump a volume
syntax: vos dump  -id <volume name or ID>  -time <dump from time>  -file <dump file>  [-cell <cell name>]  [-noauth]  [-localauth]  [-verbose]  [-help]

examine - everything about the volume
syntax: vos examine   -id <volume name or ID>  [-cell <cell name>]  [-noauth]  [-localauth]  [-verbose]  [-help]
alias: vos volinfo

help - get help on commands
syntax: vos help  [-topic <help string>+]  [-help]

listpart - list partitions
syntax: vos listpart  -server <machine name>  [-cell <cell name>]  [-noauth]  [-localauth]  [-verbose]  [-help]

listvldb - list volumes in the VLDB
syntax: vos listvldb  [-name <volume name or ID>]  [-server <machine name>]  [-partition <partition name>]  [-locked]  [-cell <cell name>]  [-noauth]  [-localauth]  [-verbose]  [-help]

listvol - list volumes on server (bypass VLDB)
syntax: vos listvol   -server <machine name>  -partition <partition name>  [-fast]  [-long]  [-cell <cell name>]  [-noauth]  [-localauth]  [-verbose]  [-help]

lock - lock VLDB entry for a volume
syntax: vos lock   -id <volume name or ID>  [-cell <cell name>]  [-noauth] [-localauth]  [-verbose]  [-help]

move - move a volume
syntax: vos move   -id <volume name or ID>  -fromserver <machine name on source>  -frompartition <partition name on source>  -toserver <machine name on destination>  -topartition <machine name on destination>  [-cell <cell name>]  [-noauth]  [-localauth]  [-verbose]  [-help]

partinfo - list partition information
syntax: vos partinfo  -server <machine name>  [-partition <partition name>]  [-cell <cell name>]  [-noauth]  [-localauth]  [-verbose]  [-help]

release - release a volume
syntax: vos release  -id <volume name or ID>  [-f]  [-cell <cell name>]  [-noauth]  [-localauth]  [-verbose]  [-help]

remove - delete a volume
syntax: vos remove  -server <machine name>  -partition <partition name>  -id <volume name or ID>  [-cell <cell name>]  [-noauth]  [-localauth]  [-verbose]  [-help]

remsite - remove a replication site
syntax: vos remsite  -server <machine name> -partition <partition name>  -id <volume name or ID>  [-cell <cell name>]  [-noauth]  [-localauth]  [-verbose]  [-help]

rename - rename a volume
syntax: vos rename  -oldname <old volume name> -newname <new volume name>  [-cell <cell name>]  [-noauth]  [-localauth]  [-verbose]  [-help]

restore - restore a volume
syntax: vos restore  -file <dump file>  -server <machine name>  -partition <partition name>  -name <name of volume to be restored>  [-id <volumeID>]  [-cell <cell name>]  [-noauth]  [-localauth]  [-verbose]  [-help]

status - report on volser status
syntax: vos status  -server <machine name>  [-cell <cell name>]  [-noauth]  [-localauth]  [-verbose]  [-help]

syncserv - synchronize server with VLDB
syntax: vos syncserv  -server <machine name> [-partition <partition name>]  [-cell <cell name>]  [-noauth]  [-localauth]  [-verbose]  [-help]

syncvldb - synchronize VLDB with server
syntax: vos syncvldb  -server <machine name>  [-partition <partition name>]  [-cell <cell name>]  [-noauth]  [-localauth]  [-verbose]  [-help]

unlock - release lock on VLDB entry for a volume
syntax: vos unlock   -id <volume name or ID>  [-cell <cell name>]  [-noauth]  [-localauth]  [-verbose]  [-help]

unlockvldb - unlock all the locked entries in the VLDB
syntax: vos unlockvldb  [-server <machine name>] [-partition <partition name>]  [-cell <cell name>]  [-noauth]  [-localauth]  [-verbose]  [-help]

zap - delete the volume, don’t bother with VLDB
syntax: vos zap   -server <machine name> -partition <partition name>  -id <volume ID>  [-cell <cell name>]  [-noauth]  [-localauth]  [-verbose]  [-help]

  —  Last change: 30 April 1990