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.