From 9f9ffb7822bf85fc24d29b63c09c124b1e9875af Mon Sep 17 00:00:00 2001 From: Russ Allbery Date: Wed, 26 May 2010 11:33:29 -0500 Subject: [PATCH 1/1] Remove references to AFS Product Support in -oktozap salvager and salvageserver's documentation of -oktozap says to not use without consultation with AFS Development or Product Support, left over from the IBM product. Remove those references and add a caution more in line with open source. Change-Id: I136dc145caf3e8e3a992c239e1a46d86f96580ed Reviewed-on: http://gerrit.openafs.org/2030 Reviewed-by: Derrick Brashear Tested-by: Derrick Brashear Reviewed-by: Jeffrey Altman --- doc/man-pages/README | 6 ++---- doc/man-pages/pod8/salvager.pod | 6 ++++-- doc/man-pages/pod8/salvageserver.pod | 6 ++++-- 3 files changed, 10 insertions(+), 8 deletions(-) diff --git a/doc/man-pages/README b/doc/man-pages/README index 00577de..fb1f017 100644 --- a/doc/man-pages/README +++ b/doc/man-pages/README @@ -230,10 +230,8 @@ Known Problems don't just report the deficiency again, but any contributions towards fixing it are greatly appreciated. - * There are lingering references to AFS Development or AFS Product - Support in descriptions of options that one should generally not - use. Also, all of the manual references refer to the "IBM" manual. - We should decide how to handle this terminology-wise. + * All of the manual references refer to the "IBM" manual. We should + decide how to handle this terminology-wise. * The salvager actually creates a bunch of SalvageLog files and then combines them, but the SalvageLog man page doesn't reflect this. diff --git a/doc/man-pages/pod8/salvager.pod b/doc/man-pages/pod8/salvager.pod index f7009c6..093483e 100644 --- a/doc/man-pages/pod8/salvager.pod +++ b/doc/man-pages/pod8/salvager.pod @@ -178,9 +178,11 @@ having been active when a crash occurred. =item B<-oktozap> Removes a volume that is so damaged that even issuing the B -command with the B<-force> flag is ineffective. Use this argument only in -consultation with AFS Development or Product Support. Combine it with the +command with the B<-force> flag is ineffective. Combine it with the B<-partition> and B<-volumeid> arguments to identify the volume to remove. +Using this flag will destroy data that cannot be read, so use only with +caution and when you're certain that nothing in that volume is still +needed. =item B<-rootinodes> diff --git a/doc/man-pages/pod8/salvageserver.pod b/doc/man-pages/pod8/salvageserver.pod index 26a1ee6..b48a491 100644 --- a/doc/man-pages/pod8/salvageserver.pod +++ b/doc/man-pages/pod8/salvageserver.pod @@ -163,9 +163,11 @@ having been active when a crash occurred. =item B<-oktozap> Removes a volume that is so damaged that even issuing the B -command with the B<-force> flag is ineffective. Use this argument only in -consultation with AFS Development or Product Support. Combine it with the +command with the B<-force> flag is ineffective. Combine it with the B<-partition> and B<-volumeid> arguments to identify the volume to remove. +Using this flag will destroy data that cannot be read, so use only with +caution and when you're certain that nothing in that volume is still +needed. =item B<-rootinodes> -- 1.9.4