Update NEWS for 1.8.0pre3
[pkg-k5-afs_openafs.git] / doc / man-pages / pod1 / fs_getcellstatus.pod
blob505df855136a2c2ee80e8d67161dad8e8263e7d0
1 =head1 NAME
3 fs_getcellstatus - Reports whether setuid programs are honored in a cell
5 =head1 SYNOPSIS
7 =for html
8 <div class="synopsis">
10 B<fs getcellstatus> S<<< B<-cell> <I<cell name>>+ >>> [B<-help>]
12 B<fs getce> S<<< B<-c> <I<cell name>>+ >>> [B<-h>]
14 =for html
15 </div>
17 =head1 DESCRIPTION
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.
24 =head1 OPTIONS
26 =over 4
28 =item B<-cell> <I<cell name>>+
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.
34 =item B<-help>
36 Prints the online help for this command. All other valid options are
37 ignored.
39 =back
41 =head1 OUTPUT
43 The output reports one of the following two values as appropriate:
45    Cell <cell> status: setuid allowed
46    Cell <cell> status: no setuid allowed
48 =head1 EXAMPLES
50 The following example indicates that programs from the cell C<example.com> are
51 not allowed to run with setuid permission.
53    % fs getcellstatus example.com
54    Cell example.com status: no setuid allowed
56 =head1 PRIVILEGE REQUIRED
58 None
60 =head1 SEE ALSO
62 L<CellServDB(5)>,
63 L<fs_setcell(1)>
65 =head1 COPYRIGHT
67 IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
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.