Remove bless-related options from vos manpages
authorAndrew Deason <adeason@sinenomine.net>
Thu, 29 Jul 2010 17:43:25 +0000 (12:43 -0500)
committerDerrick Brashear <shadow@dementia.org>
Thu, 29 Jul 2010 18:30:14 +0000 (11:30 -0700)
'vos online' and 'vos offline' were documented as taking -bless and
-unbless options, respectively. They do not actually take these
options, and since adding that functionality, while useful, will
require protocol changes, they are likely to take some time to appear.

Change-Id: I91800e9637162e24873beac5d41f3ad456f25af8
Reviewed-on: http://gerrit.openafs.org/2481
Reviewed-by: Derrick Brashear <shadow@dementia.org>
Tested-by: Derrick Brashear <shadow@dementia.org>

doc/man-pages/README
doc/man-pages/pod1/vos_offline.pod
doc/man-pages/pod1/vos_online.pod

index d001355..3a25ee8 100644 (file)
@@ -265,13 +265,6 @@ Known Problems
 
    * Document vos offline -busy / -sleep
 
-   * Do vos online/offline support -bless/-unbless? By looking at the
-     source they dont, and according to Git log that goes back to 2000
-     they never did.
-     According to Derrick, there was a patch to support them that vanished.
-     Either the patch should be found, or bless/unbless removed from
-     vos online/offline.
-
    * Document vos create -minquota which is available since 1.5.61
 
    * Document vos restore -creation/-lastupdate and -nodelete
index 84b7b97..301e218 100644 (file)
@@ -60,14 +60,6 @@ L<vos(1)>.
 
 Specifies either the complete name or volume ID number of the volume.
 
-=item B<-unbless>
-
-If the volume resides on a fileserver running as a I<dafs> (Demand
-Attach File Server), then the volume may be marked as I<blessed> or
-I<unblessed>.  A I<dafs> server will not bring I<unblessed> volumes
-online unless the B<-bless> option to L<vos_online> is specified.
-See L<vos_online(1)> for setting a volume to be I<blessed>.
-
 =item B<-cell> <I<cell name>>
 
 Names the cell in which to run the command. Do not combine this argument
@@ -118,12 +110,6 @@ The following example takes an online volume offline:
 
    % vos offline -server sv7.stateu.edu -partition /vicepb -id root.afs
 
-The following example takes an online volume offline and marks it
-so that a B<vos online> without B<-bless> will not bring it online:
-
-   % vos offline -server sv7.stateu.edu -partition /vicepb -id root.afs \
-  -unbless
-
 =head1 PRIVILEGE REQUIRED
 
 The issuer must be listed in the F</usr/afs/etc/UserList> file on the
index 2f9b0cf..3285492 100644 (file)
@@ -10,14 +10,14 @@ vos_online - Brings a volume online
 B<vos online> S<<< B<-server> <I<machine name>> >>>
     S<<< B<-partition> <I<partition name>> >>> 
     S<<< B<-id> <I<volume name or ID>> >>>
-    [B<-bless>] S<<< [B<-cell> <I<cell name>>] >>> 
+    S<<< [B<-cell> <I<cell name>>] >>>
     [B<-noauth>] B<-localauth>]
     [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>]
 
 B<vos on> S<<< B<-s> <I<machine name>> >>>
     S<<< B<-p> <I<partition name>> >>> 
     S<<< B<-i> <I<volume name or ID>> >>>
-    [B<-b>] S<<< [B<-c> <I<cell name>>] >>> 
+    S<<< [B<-c> <I<cell name>>] >>>
     [B<-noa>] B<-l>] [B<-v>] [B<-e>] [B<-nor>] [B<-h>]
 
 =for html
@@ -55,14 +55,6 @@ L<vos(1)>.
 
 Specifies either the complete name or volume ID number of the volume.
 
-=item B<-bless>
-
-If the volume resides on a fileserver running as a I<dafs> (Demand
-Attach File Server), then the volume may be marked as I<blessed> or
-I<unblessed>.  A I<dafs> server will not bring I<unblessed> volumes
-online unless the B<-bless> option to L<vos_online> is specified.
-See L<vos_offline(1)> for setting a volume to be I<unblessed>.
-
 =item B<-cell> <I<cell name>>
 
 Names the cell in which to run the command. Do not combine this argument
@@ -113,10 +105,6 @@ The following example brings an offline volume online:
 
    % vos online -server sv7.stateu.edu -partition /vicepb -id root.afs
 
-The following example brings an offline, unblessed volume online:
-
-   % vos online -server sv7.stateu.edu -partition /vicepb -id root.afs -bless
-
 =head1 PRIVILEGE REQUIRED
 
 The issuer must be listed in the F</usr/afs/etc/UserList> file on the