pod-man-pages-20051015
[openafs.git] / doc / man-pages / pod / fs_getcellstatus.pod
1 =head1 NAME
2
3 fs getcellstatus - Reports whether the machine can run setuid programs from a specified
4 cell
5
6 =head1 SYNOPSIS
7
8 fs getcellstatus B<-cell> I<cell name> [I<cell name> ...]  [B<-help>]
9
10 fs getce B<-c> I<cell name> [I<cell name> ...]  [B<-h>]
11
12 =head1 DESCRIPTION
13
14 The C<fs getcellstatus> command reports whether the Cache Manager allows
15 programs fetched from each specified cell to run with setuid
16 permission. To set a cell's setuid status, use the C<fs setcell> command;
17 its reference page fully describes how AFS treats setuid programs.
18
19 =head1 OPTIONS
20
21 =over 4
22
23 =item B<-cell> I<cell name> [I<cell name> ...]
24
25 Names each cell for which to report setuid status. Provide the
26 fully qualified domain name, or a shortened form that
27 disambiguates it from the other cells listed in the local
28 B</usr/vice/etc/CellServDB> file.
29
30 =item B<-help>
31
32 Prints the online help for this command. All other valid
33 options are ignored.
34
35 =back
36
37 =head1 OUTPUT
38
39 The output reports one of the following two values as appropriate:
40
41 Cell I<cell> status: setuid allowed
42
43 Cell I<cell> status: no setuid allowed
44
45 =head1 EXAMPLES
46
47 The following example indicates that programs from the cell B<abc.com>
48 are not allowed to run with setuid permission.
49
50     fs getcellstatus abc.com
51    Cell abc.com status: no setuid allowed
52
53 =head1 PRIVILEGE REQUIRED
54
55 None
56
57 =head1 COPYRIGHT
58
59 IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
60
61 Converted from html to pod by Alf Wachsmann <alfw@slac.stanford.edu>, 2003,
62 and Elizabeth Cassell <e_a_c@mailsnare.net>, 2004,
63 Stanford Linear Accelerator Center, a department of Stanford University.
64
65 =head1 SEE ALSO
66
67 L<CellServDB_client_version(1)>,
68 L<fs_setcell(1)>
69
70 =cut