← Back to branch summary

~ubuntu-branches/ubuntu/warty/openafs/warty

« back to all changes in this revision

Viewing changes to src/man/salvager.1

  • Committer: Bazaar Package Importer
  • Author(s): Sam Hartman
  • Date: 2004-01-10 16:37:33 UTC
  • Revision ID: james.westby@ubuntu.com-20040110163733-jvr0n1uahshlb1uu
Tags: upstream-1.2.11
Import upstream version 1.2.11

Show diffs side-by-side

added added

removed removed

Lines of Context:
src/man/salvager.1
 
1
salvager                   AFS Commands                salvager
 
2
 
 
3
 
 
4
NAME
 
5
 
 
6
   salvager -- initialize Salvager in BosConfig or manually.
 
7
 
 
8
 
 
9
   /usr/afs/bin/salvager  [-f] [-o] [<partition name>
 
10
   [<volumeID>]]
 
11
 
 
12
DESCRIPTION
 
13
 
 
14
   Initializes  the Salvager component of the fs process, which
 
15
   corrects corruption in  ReadWrite  volumes  where  possible.
 
16
   Unlike  most  other  AFS file server processes, this process
 
17
   can also be started from the command line.   It  produces  a
 
18
   trace of its actions in /usr/afs/logs/SalvageLog.
 
19
 
 
20
   If  the  Salvager  detects  corruption in ReadOnly or Backup
 
21
   volumes, it removes them rather than attempting  to  correct
 
22
   the  corruption;  it  records the removal in SalvageLog.  If
 
23
   desired, the issuer can  recreate  the  ReadOnly  or  Backup
 
24
   version by issuing vos release or vos backup, respectively.
 
25
 
 
26
   The  Salvager normally salvages only those ReadWrite volumes
 
27
   that are marked as having been active when a crash occurred.
 
28
   To  have  it salvage all relevant ReadWrite volumes, add the
 
29
   -f flag.
 
30
 
 
31
   The number of  volumes  the  Salvager  attempts  to  salvage
 
32
   depends  on the combination of arguments and flags used.  To
 
33
   salvage:
 
34
 
 
35
      - volumes on all /vicepx partitions on a file server
 
36
        machine, provide no arguments
 
37
 
 
38
      - volumes   on  a  certain  partition,  specify  the
 
39
        partition's full (/vicepx-style) name as partition
 
40
        name
 
41
 
 
42
      - one   particular  ReadWrite  volume,  specify  its
 
43
        partition  as  partition  name  and  its  volumeID
 
44
        number as volumeID
 
45
 
 
46
WARNING
 
47
 
 
48
   This  command does not use the syntax conventions of the AFS
 
49
   command suites, so the command  and  switch  names  must  be
 
50
   typed in full.
 
51
 
 
52
ARGUMENTS
 
53
 
 
54
   -f           inspects  all  volumes for corruption, not just
 
55
                those that are marked  as  having  been  active
 
56
                when a crash occurred.
 
57
 
 
58
   -o           enables the Salvager to remove volumes that are
 
59
                too damaged to be removed in the normal manner.
 
60
                Do not Use this argument unless a member of the
 
61
                AFS Product Support staff has directed its use.
 
62
                In  normal  cases,  use  the -force flag on the
 
63
                vos zap command  instead.    If  this  flag  is
 
64
                provided,  it should be combined with partition
 
65
 
 
66
 
 
67
 
 
68
                name and volumeID.
 
69
 
 
70
   partition name
 
71
                specifies  which  partition the Salvager should
 
72
                inspect for corruption.    If  it  is  omitted,
 
73
                every  /vicepx  partition  on  the  file server
 
74
                machine is inspected.
 
75
 
 
76
   volumeID number
 
77
                specifies the volumeID number of the Read Write
 
78
                volume to salvage.
 
79
 
 
80
EXAMPLES
 
81
 
 
82
   The following command instructs the Salvager to  attempt  to
 
83
   salvage  the  volume  with volume ID 258347486 on /vicepg on
 
84
   the local machine.
 
85
 
 
86
   % /usr/afs/bin/salvager /vicepg 258347486
 
87
 
 
88
PRIVILEGE REQUIRED
 
89
 
 
90
   Issuer must be logged into the local  UNIX  file  system  as
 
91
   "root" to issue this command to the shell.
 
92
 
 
93
   Issuer must be listed in /usr/afs/etc/UserList to place this
 
94
   command in /usr/afs/local/BosConfig,  because  that  is  the
 
95
   privilege required to issue bos create.
 
96
 
 
97
MORE INFORMATION
 
98
 
 
99
   bos create
 
100
 
 
101
   bos salvage