← Back to branch summary

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

« back to all changes in this revision

Viewing changes to src/man/vos_delentry.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/vos_delentry.1
 
1
vos delentry               AFS Commands            vos delentry
 
2
 
 
3
 
 
4
NAME
 
5
 
 
6
   vos delentry -- remove specified entry from VLDB.
 
7
 
 
8
 
 
9
   vos delentry  -id <volume name or ID>
 
10
   [-prefix <prefix of volume whose VLDB entry is to be
 
11
   deleted>]
 
12
   [-server <machine name>]  [-partition <partition name>]
 
13
   [-cell <cell name>]  [-noauth]  [-localauth]  [-verbose]
 
14
   [-help]
 
15
 
 
16
ACCEPTABLE ABBREVIATIONS/ALIASES
 
17
 
 
18
   vos de  -i <volume name or ID>
 
19
   [-pr <prefix of volume whose VLDB entry is to be deleted>]
 
20
         [-s <machine name>]  [-pa <partition name>]  [-c <cell
 
21
   name>]
 
22
   [-n]  [-l]  [-v]  [-h]
 
23
 
 
24
DESCRIPTION
 
25
 
 
26
   Removes  the VLDB entry for the indicated volume(s) from the
 
27
   VLDB.  Each volume may be any of the three types (ReadWrite,
 
28
   ReadOnly  or  Backup),  but  the  entire entry is removed no
 
29
   matter which type is provided.  The command has no effect on
 
30
   the actual volumes on file server machines, if they exist.
 
31
 
 
32
   This  command  is  useful  if  the  system  administrator is
 
33
   certain that a volume removal was not recorded in  the  VLDB
 
34
   (perhaps the vos zap command was used), and does not want to
 
35
   take the  time  to  use  vos syncserv  and  vos syncvldb  to
 
36
   synchronize an entire file server machine.
 
37
 
 
38
   By  using  the -id argument alone, or combining the -prefix,
 
39
   -server and -partition arguments in different  ways,  it  is
 
40
   possible  to  remove  the  VLDB entry for varying numbers of
 
41
   volumes.  To remove the VLDB entry for:
 
42
 
 
43
      - a single volume,  provide  its  complete  name  or
 
44
        volumeID number as -id.
 
45
 
 
46
      - every  volume  whose  name  begins  with a certain
 
47
        character string (for  example,  sys.  or  user.),
 
48
        regardless of site, use -prefix.
 
49
 
 
50
      - every  volume listed as residing on a certain file
 
51
        server machine, specify the file server name  with
 
52
        -server.
 
53
 
 
54
      - every  volume listed as residing on a partition of
 
55
        the same name (for instance,  on  /vicepa  on  any
 
56
        file  server  machine), specify the partition name
 
57
        with -partition.
 
58
 
 
59
      - every volume on a  certain  partition  of  a  file
 
60
        server   machine,   specify   both   -server   and
 
61
        -partition.
 
62
 
 
63
      - every volume with a certain prefix that resides on
 
64
        a   file   server  machine,  combine  -prefix  and
 
65
 
 
66
 
 
67
 
 
68
        -server.    The  -prefix  argument  may  also   be
 
69
        combined  with  -partition,  or  both  -server and
 
70
        -partition, in this way.
 
71
 
 
72
WARNING
 
73
 
 
74
   This command should not be  used  as  the  standard  way  to
 
75
   remove a volume, as it is likely to put the VLDB out of sync
 
76
   with the volumes on servers.  Use vos remove instead.
 
77
 
 
78
ARGUMENTS
 
79
 
 
80
   -id             specifies  either  the  complete   name   or
 
81
                   volumeID  number of the volume, which may be
 
82
                   ReadWrite, ReadOnly or Backup.   The  entire
 
83
                   entry  is  removed,  no matter which type is
 
84
                   provided.  Provide  this  argument  OR  some
 
85
                   combination    of   -prefix,   -server   and
 
86
                   -partition.
 
87
 
 
88
   -prefix         specifies a character string of any  length.
 
89
                   Every  VLDB  listing  a  volume  whose  name
 
90
                   begins  with  this  exact  string  will   be
 
91
                   removed (subject to modulations from -server
 
92
                   and -partition).  Include  field  separators
 
93
                   (such  as  periods)  if  appropriate.   This
 
94
                   argument may be combined with -server and/or
 
95
                   -partition.
 
96
 
 
97
   -server         names  a  file  server machine.  If the VLDB
 
98
                   entry mentions this file server  machine  as
 
99
                   the  site  for  a  volume, the entry will be
 
100
                   removed.  Abbreviated forms of machine names
 
101
                   may  be  allowed  depending  on  the  naming
 
102
                   service available at the time the command is
 
103
                   issued;  see  page  xii  in the introductory
 
104
                   About This Manual chapter.    This  argument
 
105
                   may   be   combined   with   -prefix  and/or
 
106
                   -partition.
 
107
 
 
108
   -partition      names  a  partition.    If  the  VLDB  entry
 
109
                   mentions  this  partition  as the site for a
 
110
                   volume, the  entry  will  be  removed.    In
 
111
                   addition  to  the  full  /vicepx  form  of a
 
112
                   partition  name,  three  shorter  forms  are
 
113
                   acceptable; see page xii in the introductory
 
114
                   About This Manual chapter.    This  argument
 
115
                   may be combined with -prefix and/or -server.
 
116
 
 
117
   -cell           specifies  the  cell  in  which  to  run the
 
118
                   command.  See section 8.3 in  the  Reference
 
119
                   Manual for more details.  -noauth
 
120
                   tells the Volume and Volume Location Servers
 
121
                   to  assign  the  identity  anonymous  to the
 
122
                   issuer.  See section 8.3  in  the  Reference
 
123
                   Manual for more details.  -localauth
 
124
                   constructs a server ticket using a key  from
 
125
                   /usr/afs/etc/KeyFile.    See  section 8.3 in
 
126
                   the  Reference  Manual  for  more   details.
 
127
                   -verbose
 
128
                   tells the Volume and Volume Location Servers
 
129
 
 
130
 
 
131
 
 
132
                   to  report  on  what  they are doing as they
 
133
                   execute the command.  See section 8.3 in the
 
134
                   Reference Manual for more details.  -help
 
135
                   prints the online help for this command.  Do
 
136
                   not  provide  any  other  arguments or flags
 
137
                   with this one.    See  section  8.3  in  the
 
138
                   Reference Manual for more details.
 
139
 
 
140
EXAMPLES
 
141
 
 
142
   The   following  removes  the  VLDB  entry  for  the  volume
 
143
   user.temp.
 
144
 
 
145
   % vos del user.temp
 
146
 
 
147
   The following removes all VLDB entries that describe volumes
 
148
   stored on fs3.transarc.com whose names begin with the string
 
149
   "test".
 
150
 
 
151
   % vos del -pr test -s fs3.transarc.com
 
152
 
 
153
PRIVILEGE REQUIRED
 
154
 
 
155
   Issuer must be listed in /usr/afs/etc/UserList on -server.
 
156
 
 
157
MORE INFORMATION
 
158
 
 
159
   vos remove vos remsite vos syncserv vos syncvldb vos zap