man1-editing-pass-20051209
[openafs.git] / doc / man-pages / pod1 / fs_whichcell.pod
1 =head1 NAME
2
3 fs whichcell - Returns the cell to which a file or directory belongs
4
5 =head1 SYNOPSIS
6
7 B<fs whichcell> [B<-path> <I<dir/file path>>+] [B<-help>]
8
9 B<fs whi > [B<-p> <I<dir/file path>>+] [B<-h>]
10
11 =head1 DESCRIPTION
12
13 The B<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 directory
17 or file resides, use the B<fs whichcell> command. To display the cell
18 membership of the local machine, use the B<fs wscell> command.
19
20 =head1 OPTIONS
21
22 =over 4
23
24 =item B<-path> I<Idir/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 current
28 working directory, which is also the default value if this argument is
29 omitted.
30
31 =item B<-help>
32
33 Prints the online help for this command. All other valid options are
34 ignored.
35
36 =back
37
38 =head1 OUTPUT
39
40 The output includes a line for each directory or file, naming the cell to
41 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 in
46 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 SEE ALSO
56
57 L<fs_wscell(1)>,
58 L<fs_whereis(1)>
59
60 =head1 COPYRIGHT
61
62 IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
63
64 This documentation is covered by the IBM Public License Version 1.0.  It was
65 converted from HTML to POD by software written by Chas Williams and Russ
66 Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.