From: hin Date: Wed, 29 Mar 2000 21:38:46 +0000 (+0000) Subject: vos.1 -> vos.8 X-Git-Url: http://artulab.com/gitweb/?a=commitdiff_plain;h=957c4e5abba2f5aaf9b78df2f01bc10f10a9d065;p=openbsd vos.1 -> vos.8 --- diff --git a/usr.sbin/afs/fs/fs.1 b/usr.sbin/afs/fs/fs.1 index dbd5cc6514e..879ab731751 100644 --- a/usr.sbin/afs/fs/fs.1 +++ b/usr.sbin/afs/fs/fs.1 @@ -634,7 +634,7 @@ Make xfs print debug info. .Ed .Sh SEE ALSO .Xr pts 1 , -.Xr vos 1 +.Xr vos 8 .Sh STANDARDS The Arla authors are trying to mimic the behaviour of the original AFS utilities. diff --git a/usr.sbin/afs/pts/pts.1 b/usr.sbin/afs/pts/pts.1 index d1e03007075..3021cccf3f5 100644 --- a/usr.sbin/afs/pts/pts.1 +++ b/usr.sbin/afs/pts/pts.1 @@ -243,7 +243,7 @@ This command has not been implemented yet. .Pp .Sh SEE ALSO .Xr fs 1 , -.Xr vos 1 +.Xr vos 8 .Sh STANDARDS The Arla authors are trying to mimic the behaviour of the original AFS utilities. diff --git a/usr.sbin/afs/vos/Makefile b/usr.sbin/afs/vos/Makefile index 88be6e0d1f4..ea38ea9dbea 100644 --- a/usr.sbin/afs/vos/Makefile +++ b/usr.sbin/afs/vos/Makefile @@ -1,4 +1,5 @@ PROG = vos +MAN = vos.8 BINDIR = /usr/sbin SRCS = vos.c arlalib.c fs_lib.c vos_common.c vos_createentry.c \ vos_createvolume.c vos_dump.c vos_endtrans.c vos_examine.c \ diff --git a/usr.sbin/afs/vos/vos.1 b/usr.sbin/afs/vos/vos.1 deleted file mode 100644 index 8db07e694d8..00000000000 --- a/usr.sbin/afs/vos/vos.1 +++ /dev/null @@ -1,386 +0,0 @@ -.Dd March 26, 2000 -.Dt VOS 1 -.Os -.Sh NAME -.Nm vos -.Nd Manage AFS volumes and the VLDB. -.Sh SYNOPSIS -.Nm vos -.Op Ar command -.Op Ar args -.Sh DESCRIPTION -The -.Nm -utility is used to manage AFS volumes and the volume location database (VLDB). -.Pp -.Nm -provides several commands: -.Pp -.Bl -tag -width Fl -compact -.It Cm addsite -not yet implemented -.It Cm apropos -apropos -.It Cm backup -not yet implemented -.It Cm backupsys -not yet implemented -.It Cm changeaddr -not yet implemented -.It Cm create -create a volume -.It Cm createentry -create a vldb entry -.It Cm delentry -not yet implemented -.It Cm dump -dump a volume -.It Cm endtrans -end a transaction -.It Cm examine -print information about a volume -.It Cm volinfo -print information about a volume -.It Cm help -print help -.It Cm ? -print help -.It Cm listpart -list partitions on a server -.It Cm listvldb -list volumes in volume-location-database -.It Cm listvol -list volumes on a server -.It Cm lock -not yet implemented -.It Cm move -not yet implemented -.It Cm partinfo -print partition information on a server -.It Cm release -not yet implemented -.It Cm remove -not yet implemented -.It Cm remsite -not yet implemented -.It Cm rename -not yet implemented -.It Cm restore -not yet implemented -.It Cm status -Show volume server transactions -.It Cm syncserv -not yet implemented -.It Cm syncvldb -not yet implemented -.It Cm syncsite -print the syncsite -.It Cm unlock -not yet implemented -.It Cm unlockvldb -not yet implemented -.It Cm zap -not yet implemented -.It Cm quit -exit interactive mode -.El -.Pp -Most -.Nm -commands accept the following general arguments: -.Pp -.Bd -filled -offset indent -compact -.Op Fl cell Ar cellname -Specifies which AFS cell to use, if the default cell is not to be used. -.Pp -.Op Fl noauth -Specifies that -.Nm -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 -.Fl noauth -is specified. -.Pp -.Op Fl 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. -.Ed -.Pp -The syntax of the -.Nm -commands: -.Pp -.Nm vos addsite -.Bd -filled -offset indent -compact -not yet implemented -.Ed -.Pp -.Nm vos apropos -.Bd -filled -offset indent -compact -apropos -.Ed -.Pp -.Nm vos backup -.Bd -filled -offset indent -compact -not yet implemented -.Ed -.Pp -.Nm vos backupsys -.Bd -filled -offset indent -compact -not yet implemented -.Ed -.Pp -.Nm vos changeaddr -.Bd -filled -offset indent -compact -not yet implemented -.Ed -.Pp -.Nm vos create -.Op Fl server -.Ar fileserver -.Op Fl part -.Ar partition -.Op Fl volume -.Ar "volume name" -.Op Fl cell Ar cellname -.Op Fl noauth -.Op Fl localauth -.Op Fl verbose -.Bd -filled -offset indent -compact -Create a new volume named -.Ar "volume name" -on server -.Ar fileserver -partition -.Ar partition. -.Ed -.Pp -.Nm vos createentry -.Op Fl id -.Ar "id of volume" -.Op Fl host -.Ar "host to use" -.Op Fl fsserver -.Ar fileserver -.Op Fl rw -.Ar "volume RW number" -.Op Fl ro -.Ar "volume RO number" -.Op Fl bk -.Ar "volume BK number" -.Op Fl noauth -.Op Fl localauth -.Bd -filled -offset indent -compact -Create a vldb entry manually. This command should -.Em not -be used unless you know -.Em exactly -what you are doing. -.Ed -.Pp -.Nm vos delentry -.Bd -filled -offset indent -compact -not yet implemented -.Ed -.Pp -.Nm vos dump -.Op Fl id -.Ar volume -.Op Fl server Ar fileserver -.Op Fl partition Ar partition -.Op Fl cell Ar cellname -.Op Fl file Ar filename -.Op Fl noauth -.Op Fl localauth -.Op Fl verbose -.Bd -filled -offset indent -compact -Dump a volume to a file. -.Ed -.Pp -.Nm vos endtrans -.Op Fl server -.Ar server -.Op Fl trans -.Ar transaction -.Op Fl cell Ar cellname -.Op Fl noauth -.Op Fl verbose -.Bd -filled -offset indent -compact -End a transaction. XXX what is this? -.Ed -.Pp -.Nm vos examine -.Op Fl id -.Ar volume -.Op Fl host -.Ar server -.Op Fl cell Ar cellname -.Op Fl noauth -.Op Fl localauth -.Op Fl verbose -.Op Fl extended -.Bd -filled -offset indent -compact -Print information about a volume. -.Ed -.Pp -.Nm vos volinfo -.Bd -filled -offset indent -compact -.Nm vos volinfo -is an alias for the -.Nm vos examine -command. -.Ed -.Pp -.Nm vos help -.Bd -filled -offset indent -compact -print help -.Ed -.Pp -.Nm vos ? -.Bd -filled -offset indent -compact -.Nm vos ? -is an alias for the -.Nm vos help -command. -.Ed -.Pp -.Nm vos listpart -.Op Fl server -.Ar fileserver -.Op Fl cell Ar cellname -.Op Fl noauth -.Op Fl localauth -.Op Fl verbose -.Bd -filled -offset indent -compact -List partitions on a fileserver. -.Ed -.Pp -.Nm vos listvldb -.Op Fl server -.Ar fileserver -.Op Fl cell Ar cellname -.Op Fl noauth -.Op Fl localauth -.Op Fl verbose -.Bd -filled -offset indent -compact -List volumes in the volume location database without reading them on the -fileserver. -.Ed -.Pp -.Nm vos listvol -.Op Fl server -.Ar fileserver -.Op Fl partition -.Ar partition -.Op Fl cell Ar cellname -.Op Fl noauth -.Op Fl localauth -.Op Fl verbose -.Bd -filled -offset indent -compact -List volumes on a fileserver, without consulting the volume location database. -.Ed -.Pp -.Nm vos lock -.Bd -filled -offset indent -compact -not yet implemented -.Ed -.Pp -.Nm vos move -.Bd -filled -offset indent -compact -not yet implemented -.Ed -.Pp -.Nm vos partinfo -.Op Fl server -.Ar fileserver -.Op Fl partition -.Ar partition -.Op Fl cell Ar cellname -.Op Fl noauth -.Op Fl localauth -.Op Fl verbose -.Bd -filled -offset indent -compact -Print the total and remaining diskspace on a fileserver. -.Ed -.Pp -.Nm vos release -.Bd -filled -offset indent -compact -not yet implemented -.Ed -.Pp -.Nm vos remove -.Bd -filled -offset indent -compact -not yet implemented -.Ed -.Pp -.Nm vos remsite -.Bd -filled -offset indent -compact -not yet implemented -.Ed -.Pp -.Nm vos rename -.Bd -filled -offset indent -compact -not yet implemented -.Ed -.Pp -.Nm vos restore -.Bd -filled -offset indent -compact -not yet implemented -.Ed -.Pp -.Nm vos status -.Op Fl server -.Ar fileserver -.Op Fl cell Ar cellname -.Op Fl noauth -.Op Fl verbose -.Bd -filled -offset indent -compact -Show volume server transactions. -.Ed -.Pp -.Nm vos syncserv -.Bd -filled -offset indent -compact -not yet implemented -.Ed -.Pp -.Nm vos syncvldb -.Bd -filled -offset indent -compact -not yet implemented -.Ed -.Pp -.Nm vos syncsite -.Bd -filled -offset indent -compact -print the syncsite -.Ed -.Pp -.Nm vos unlock -.Bd -filled -offset indent -compact -not yet implemented -.Ed -.Pp -.Nm vos unlockvldb -.Bd -filled -offset indent -compact -not yet implemented -.Ed -.Pp -.Nm vos zap -.Bd -filled -offset indent -compact -not yet implemented -.Ed -.Pp -.Nm vos quit -.Bd -filled -offset indent -compact -Exit interactive mode. -.Ed -.Sh SEE ALSO -.Xr pts 1 , -.Xr vos 1 -.Sh STANDARDS -The Arla authors are trying to mimic the behaviour of the original AFS -utilities. -.Sh AUTHORS -The Arla project . -.Sh BUGS -Quite a lot of commands are not implemented yet. diff --git a/usr.sbin/afs/vos/vos.8 b/usr.sbin/afs/vos/vos.8 new file mode 100644 index 00000000000..22ac2f62009 --- /dev/null +++ b/usr.sbin/afs/vos/vos.8 @@ -0,0 +1,386 @@ +.Dd March 26, 2000 +.Dt VOS 1 +.Os +.Sh NAME +.Nm vos +.Nd Manage AFS volumes and the VLDB. +.Sh SYNOPSIS +.Nm vos +.Op Ar command +.Op Ar args +.Sh DESCRIPTION +The +.Nm +utility is used to manage AFS volumes and the volume location database (VLDB). +.Pp +.Nm +provides several commands: +.Pp +.Bl -tag -width Fl -compact +.It Cm addsite +not yet implemented +.It Cm apropos +apropos +.It Cm backup +not yet implemented +.It Cm backupsys +not yet implemented +.It Cm changeaddr +not yet implemented +.It Cm create +create a volume +.It Cm createentry +create a vldb entry +.It Cm delentry +not yet implemented +.It Cm dump +dump a volume +.It Cm endtrans +end a transaction +.It Cm examine +print information about a volume +.It Cm volinfo +print information about a volume +.It Cm help +print help +.It Cm ? +print help +.It Cm listpart +list partitions on a server +.It Cm listvldb +list volumes in volume-location-database +.It Cm listvol +list volumes on a server +.It Cm lock +not yet implemented +.It Cm move +not yet implemented +.It Cm partinfo +print partition information on a server +.It Cm release +not yet implemented +.It Cm remove +not yet implemented +.It Cm remsite +not yet implemented +.It Cm rename +not yet implemented +.It Cm restore +not yet implemented +.It Cm status +Show volume server transactions +.It Cm syncserv +not yet implemented +.It Cm syncvldb +not yet implemented +.It Cm syncsite +print the syncsite +.It Cm unlock +not yet implemented +.It Cm unlockvldb +not yet implemented +.It Cm zap +not yet implemented +.It Cm quit +exit interactive mode +.El +.Pp +Most +.Nm +commands accept the following general arguments: +.Pp +.Bd -filled -offset indent -compact +.Op Fl cell Ar cellname +Specifies which AFS cell to use, if the default cell is not to be used. +.Pp +.Op Fl noauth +Specifies that +.Nm +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 +.Fl noauth +is specified. +.Pp +.Op Fl 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. +.Ed +.Pp +The syntax of the +.Nm +commands: +.Pp +.Nm vos addsite +.Bd -filled -offset indent -compact +not yet implemented +.Ed +.Pp +.Nm vos apropos +.Bd -filled -offset indent -compact +apropos +.Ed +.Pp +.Nm vos backup +.Bd -filled -offset indent -compact +not yet implemented +.Ed +.Pp +.Nm vos backupsys +.Bd -filled -offset indent -compact +not yet implemented +.Ed +.Pp +.Nm vos changeaddr +.Bd -filled -offset indent -compact +not yet implemented +.Ed +.Pp +.Nm vos create +.Op Fl server +.Ar fileserver +.Op Fl part +.Ar partition +.Op Fl volume +.Ar "volume name" +.Op Fl cell Ar cellname +.Op Fl noauth +.Op Fl localauth +.Op Fl verbose +.Bd -filled -offset indent -compact +Create a new volume named +.Ar "volume name" +on server +.Ar fileserver +partition +.Ar partition. +.Ed +.Pp +.Nm vos createentry +.Op Fl id +.Ar "id of volume" +.Op Fl host +.Ar "host to use" +.Op Fl fsserver +.Ar fileserver +.Op Fl rw +.Ar "volume RW number" +.Op Fl ro +.Ar "volume RO number" +.Op Fl bk +.Ar "volume BK number" +.Op Fl noauth +.Op Fl localauth +.Bd -filled -offset indent -compact +Create a vldb entry manually. This command should +.Em not +be used unless you know +.Em exactly +what you are doing. +.Ed +.Pp +.Nm vos delentry +.Bd -filled -offset indent -compact +not yet implemented +.Ed +.Pp +.Nm vos dump +.Op Fl id +.Ar volume +.Op Fl server Ar fileserver +.Op Fl partition Ar partition +.Op Fl cell Ar cellname +.Op Fl file Ar filename +.Op Fl noauth +.Op Fl localauth +.Op Fl verbose +.Bd -filled -offset indent -compact +Dump a volume to a file. +.Ed +.Pp +.Nm vos endtrans +.Op Fl server +.Ar server +.Op Fl trans +.Ar transaction +.Op Fl cell Ar cellname +.Op Fl noauth +.Op Fl verbose +.Bd -filled -offset indent -compact +End a transaction. XXX what is this? +.Ed +.Pp +.Nm vos examine +.Op Fl id +.Ar volume +.Op Fl host +.Ar server +.Op Fl cell Ar cellname +.Op Fl noauth +.Op Fl localauth +.Op Fl verbose +.Op Fl extended +.Bd -filled -offset indent -compact +Print information about a volume. +.Ed +.Pp +.Nm vos volinfo +.Bd -filled -offset indent -compact +.Nm vos volinfo +is an alias for the +.Nm vos examine +command. +.Ed +.Pp +.Nm vos help +.Bd -filled -offset indent -compact +print help +.Ed +.Pp +.Nm vos ? +.Bd -filled -offset indent -compact +.Nm vos ? +is an alias for the +.Nm vos help +command. +.Ed +.Pp +.Nm vos listpart +.Op Fl server +.Ar fileserver +.Op Fl cell Ar cellname +.Op Fl noauth +.Op Fl localauth +.Op Fl verbose +.Bd -filled -offset indent -compact +List partitions on a fileserver. +.Ed +.Pp +.Nm vos listvldb +.Op Fl server +.Ar fileserver +.Op Fl cell Ar cellname +.Op Fl noauth +.Op Fl localauth +.Op Fl verbose +.Bd -filled -offset indent -compact +List volumes in the volume location database without reading them on the +fileserver. +.Ed +.Pp +.Nm vos listvol +.Op Fl server +.Ar fileserver +.Op Fl partition +.Ar partition +.Op Fl cell Ar cellname +.Op Fl noauth +.Op Fl localauth +.Op Fl verbose +.Bd -filled -offset indent -compact +List volumes on a fileserver, without consulting the volume location database. +.Ed +.Pp +.Nm vos lock +.Bd -filled -offset indent -compact +not yet implemented +.Ed +.Pp +.Nm vos move +.Bd -filled -offset indent -compact +not yet implemented +.Ed +.Pp +.Nm vos partinfo +.Op Fl server +.Ar fileserver +.Op Fl partition +.Ar partition +.Op Fl cell Ar cellname +.Op Fl noauth +.Op Fl localauth +.Op Fl verbose +.Bd -filled -offset indent -compact +Print the total and remaining diskspace on a fileserver. +.Ed +.Pp +.Nm vos release +.Bd -filled -offset indent -compact +not yet implemented +.Ed +.Pp +.Nm vos remove +.Bd -filled -offset indent -compact +not yet implemented +.Ed +.Pp +.Nm vos remsite +.Bd -filled -offset indent -compact +not yet implemented +.Ed +.Pp +.Nm vos rename +.Bd -filled -offset indent -compact +not yet implemented +.Ed +.Pp +.Nm vos restore +.Bd -filled -offset indent -compact +not yet implemented +.Ed +.Pp +.Nm vos status +.Op Fl server +.Ar fileserver +.Op Fl cell Ar cellname +.Op Fl noauth +.Op Fl verbose +.Bd -filled -offset indent -compact +Show volume server transactions. +.Ed +.Pp +.Nm vos syncserv +.Bd -filled -offset indent -compact +not yet implemented +.Ed +.Pp +.Nm vos syncvldb +.Bd -filled -offset indent -compact +not yet implemented +.Ed +.Pp +.Nm vos syncsite +.Bd -filled -offset indent -compact +print the syncsite +.Ed +.Pp +.Nm vos unlock +.Bd -filled -offset indent -compact +not yet implemented +.Ed +.Pp +.Nm vos unlockvldb +.Bd -filled -offset indent -compact +not yet implemented +.Ed +.Pp +.Nm vos zap +.Bd -filled -offset indent -compact +not yet implemented +.Ed +.Pp +.Nm vos quit +.Bd -filled -offset indent -compact +Exit interactive mode. +.Ed +.Sh SEE ALSO +.Xr pts 1 , +.Xr fs 1 +.Sh STANDARDS +The Arla authors are trying to mimic the behaviour of the original AFS +utilities. +.Sh AUTHORS +The Arla project . +.Sh BUGS +Quite a lot of commands are not implemented yet.