doc/man-pages/pod/fs_whichcell.pod

   1 =head1 NAME
   2
   3 fs whichcell - Returns the name of the cell to which a file or directory belongs
   4
   5 =head1 SYNOPSIS
   6
   7 fs whichcell [B<-path> I<dir/file path> [I<dir/file path> ...]]  [B<-help>]
   8
   9 fs whi  [B<-p> I<dir/file path> [I<dir/file path> ...]]  [B<-h>]
  10
  11 =head1 DESCRIPTION
  12
  13 The C<fs whichcell> command returns the name of the cell in which the
  14 volume that houses each indicated directory or file resides.
  15
  16 To display the file server machine on which the volume housing a
  17 directory or file resides, use the C<fs whichcell> command. To display
  18 the cell membership of the local machine, use the C<fs wscell> command.
  19
  20 =head1 OPTIONS
  21
  22 =over 4
  23
  24 =item B<-path> I<dir/file path> [I<dir/file path> ...]
  25
  26 Names each AFS file or directory for which to return the cell
  27 membership. Partial pathnames are interpreted relative to the
  28 current working directory, which is also the default value if
  29 this argument is omitted.
  30
  31 =item B<-help>
  32
  33 Prints the online help for this command. All other valid
  34 options are ignored.
  35
  36 =back
  37
  38 =head1 OUTPUT
  39
  40 The output includes a line for each directory or file, naming the cell
  41 to which the volume that houses the directory or file resides.
  42
  43 =head1 EXAMPLES
  44
  45 The following example shows that the current working directory resides
  46 in a volume in the ABC Corporation cell:
  47
  48     fs whichcell
  49    File . lives in cell 'abc.com'
  50
  51 =head1 PRIVILEGE REQUIRED
  52
  53 None
  54
  55 =head1 COPYRIGHT
  56
  57 IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
  58
  59 Converted from html to pod by Alf Wachsmann <alfw@slac.stanford.edu>, 2003,
  60 and Elizabeth Cassell <e_a_c@mailsnare.net>, 2004,
  61 Stanford Linear Accelerator Center, a department of Stanford University.
  62
  63 =head1 SEE ALSO
  64
  65 L<fs_wscell(1)>,
  66 L<fs_whereis(1)>
  67
  68 =cut