src/man/vos_rename.1

   1 vos rename                 AFS Commands              vos rename
   2
   3
   4 NAME
   5
   6    vos rename -- rename a volume.
   7
   8
   9    vos rename  -oldname <old volume name>
  10    -newname <new volume name> [-cell <cell name>]
  11    [-noauth]  [-localauth]  [-verbose]  [-help]
  12
  13 ACCEPTABLE ABBREVIATIONS/ALIASES
  14
  15    vos ren  -o <old volume name>  -ne <new volume name>  [-c
  16    <cell name>]
  17    [-no]  [-l]  [-v]  [-h]
  18
  19 DESCRIPTION
  20
  21    Changes the name of ReadWrite volume specified with -oldname
  22    to the name specified with  -newname.    The  names  of  the
  23    ReadWrite's  ReadOnly copies and Backup copy, if any, change
  24    automatically to match.
  25
  26    After issuing this command, remember to  correct  any  mount
  27    points  that  refer  to the old volume name, by removing the
  28    old mount point with fs rmmount and creating a new one  with
  29    fs mkmount.
  30
  31 ARGUMENTS
  32
  33    -oldname        is the current name of the ReadWrite volume.
  34
  35    -newname        is the desired new name for the volume.
  36
  37    -cell           specifies  the  cell  in  which  to  run the
  38                    command.  See section 8.3 in  the  Reference
  39                    Manual for more details.  -noauth
  40                    tells the Volume and Volume Location Servers
  41                    to  assign  the  identity  anonymous  to the
  42                    issuer.  See section 8.3  in  the  Reference
  43                    Manual for more details.  -localauth
  44                    constructs a server ticket using a key  from
  45                    /usr/afs/etc/KeyFile.    See  section 8.3 in
  46                    the  Reference  Manual  for  more   details.
  47                    -verbose
  48                    tells the Volume and Volume Location Servers
  49                    to  report  on  what  they are doing as they
  50                    execute the command.  See section 8.3 in the
  51                    Reference Manual for more details.  -help
  52                    prints the online help for this command.  Do
  53                    not  provide  any  other  arguments or flags
  54                    with this one.    See  section  8.3  in  the
  55                    Reference Manual for more details.
  56
  57
  58
  59 EXAMPLE
  60
  61    The following changes the mistaken volume name sun3_41.afsws
  62    to the correct alternative sun3_41.usr.afsws.
  63
  64    % vos ren sun3_41.afsws sun3_41.usr.afsws
  65
  66 PRIVILEGE REQUIRED
  67
  68    Issuer must be listed in /usr/afs/etc/UserList on -server.
  69
  70 MORE INFORMATION