OpenBSD manual page server

Manual Page Search Parameters
VOS(8) System Manager's Manual VOS(8)

vos — manage AFS volumes and the VLDB

vos [command] [args]

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

vos provides several commands:

not yet implemented
apropos
make a backup copy of a volume
make backup copies of a number of volumes
not yet implemented
create a volume
create a vldb entry
not yet implemented
dump a volume
end a transaction
print information about a volume
print information about a volume
print help
print help
list registered addresses in vldb
list partitions on a server
list volumes in volume-location-database
list volumes on a server
not yet implemented
not yet implemented
print partition information on a server
not yet implemented
not yet implemented
not yet implemented
not yet implemented
not yet implemented
show volume server transactions
not yet implemented
not yet implemented
print the syncsite
not yet implemented
not yet implemented
not yet implemented
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 be used unless you know 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.

fs(1), pts(1), afsd(8), bos(8)

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

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

Quite a lot of commands are not implemented yet.

March 26, 2000 The Arla Project