Import Upstream version 1.8.5
[hcoop/debian/openafs.git] / doc / man-pages / pod1 / fs_getcellstatus.pod
1 =head1 NAME
2
3 fs_getcellstatus - Reports whether setuid programs are honored in a cell
4
5 =head1 SYNOPSIS
6
7 =for html
8 <div class="synopsis">
9
10 B<fs getcellstatus> S<<< B<-cell> <I<cell name>>+ >>> [B<-help>]
11
12 B<fs getce> S<<< B<-c> <I<cell name>>+ >>> [B<-h>]
13
14 =for html
15 </div>
16
17 =head1 DESCRIPTION
18
19 The B<fs getcellstatus> command reports whether the Cache Manager allows
20 programs fetched from each specified cell to run with setuid
21 permission. To set a cell's setuid status, use the B<fs setcell> command;
22 L<fs_setcell(1)> fully describes how AFS treats setuid programs.
23
24 =head1 OPTIONS
25
26 =over 4
27
28 =item B<-cell> <I<cell name>>+
29
30 Names each cell for which to report setuid status. Provide the fully
31 qualified domain name, or a shortened form that disambiguates it from the
32 other cells listed in the local F</usr/vice/etc/CellServDB> file.
33
34 =item B<-help>
35
36 Prints the online help for this command. All other valid options are
37 ignored.
38
39 =back
40
41 =head1 OUTPUT
42
43 The output reports one of the following two values as appropriate:
44
45 Cell <cell> status: setuid allowed
46 Cell <cell> status: no setuid allowed
47
48 =head1 EXAMPLES
49
50 The following example indicates that programs from the cell C<example.com> are
51 not allowed to run with setuid permission.
52
53 % fs getcellstatus example.com
54 Cell example.com status: no setuid allowed
55
56 =head1 PRIVILEGE REQUIRED
57
58 None
59
60 =head1 SEE ALSO
61
62 L<CellServDB(5)>,
63 L<fs_setcell(1)>
64
65 =head1 COPYRIGHT
66
67 IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
68
69 This documentation is covered by the IBM Public License Version 1.0. It was
70 converted from HTML to POD by software written by Chas Williams and Russ
71 Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.