[hcoop/debian/openafs.git] / doc / man-pages / pod5 / UserList.pod

=head1 NAME

UserList - Defines privileged administrators

=head1 DESCRIPTION

The F<UserList> file lists the AFS usernames of the system administrators
authorized to issue privileged B<bos>, B<vos>, and B<backup> commands that
affect the local server machine or the volumes housed on it. It must
reside in the F</usr/afs/etc> directory on every server machine.

Although the F<UserList> file is in ASCII format, do not use a text editor
to alter it. Instead always use the appropriate commands from the B<bos>
command suite:

=over 4

=item *

The B<bos adduser> command to add a user to the file.

=item *

The B<bos listusers> command to display the contents of the file.

=item *

The B<bos removeuser> command to remove a user from the file.

=back

Although it is theoretically possible to list different administrators in
the F<UserList> files on different server machines, doing so can cause
unanticipated authorization failures and is not recommended. In cells that
use the Update Server to distribute the contents of the F</usr/afs/etc>
directory, it is customary to edit only the copy of the file stored on the
system control machine. Otherwise, edit the file on each server machine
individually.

=head1 SEE ALSO

L<bos_adduser(8)>,
L<bos_listusers(8)>,
L<bos_removeuser(8)>,
L<upclient(8)>,
L<upserver(8)>

=head1 COPYRIGHT

IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.

This documentation is covered by the IBM Public License Version 1.0.  It was
converted from HTML to POD by software written by Chas Williams and Russ
Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.
Commit	Line	Data
805e021f CE	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.