doc/man-pages/pod5/UserList.pod

   1 =head1 NAME
   2
   3 UserList - Defines privileged administrators
   4
   5 =head1 DESCRIPTION
   6
   7 The F<UserList> file lists the AFS usernames of the system administrators
   8 authorized to issue privileged B<bos>, B<vos>, and B<backup> commands that
   9 affect the local server machine or the volumes housed on it. It must
  10 reside in the F</usr/afs/etc> directory on every server machine.
  11
  12 Although the F<UserList> file is in ASCII format, do not use a text editor
  13 to alter it. Instead always use the appropriate commands from the B<bos>
  14 command suite:
  15
  16 =over 4
  17
  18 =item *
  19
  20 The B<bos adduser> command to add a user to the file.
  21
  22 =item *
  23
  24 The B<bos listusers> command to display the contents of the file.
  25
  26 =item *
  27
  28 The B<bos removeuser> command to remove a user from the file.
  29
  30 =back
  31
  32 Although it is theoretically possible to list different administrators in
  33 the F<UserList> files on different server machines, doing so can cause
  34 unanticipated authorization failures and is not recommended. In cells that
  35 use the Update Server to distribute the contents of the F</usr/afs/etc>
  36 directory, it is customary to edit only the copy of the file stored on the
  37 system control machine. Otherwise, edit the file on each server machine
  38 individually.
  39
  40 =head1 SEE ALSO
  41
  42 L<bos_adduser(8)>,
  43 L<bos_listusers(8)>,
  44 L<bos_removeuser(8)>,
  45 L<upclient(8)>,
  46 L<upserver(8)>
  47
  48 =head1 COPYRIGHT
  49
  50 IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
  51
  52 This documentation is covered by the IBM Public License Version 1.0.  It was
  53 converted from HTML to POD by software written by Chas Williams and Russ
  54 Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.