2005-12-08 12:14:33 +00:00
|
|
|
=head1 NAME
|
|
|
|
|
2007-11-11 22:54:56 +00:00
|
|
|
pts_removeuser - Removes a user from a Protection Database group
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
|
2006-03-01 05:02:29 +00:00
|
|
|
=for html
|
|
|
|
<div class="synopsis">
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2006-03-01 05:02:29 +00:00
|
|
|
B<pts removeuser> S<<< B<-user> <I<user name>>+ >>> S<<< B<-group> <I<group name>>+ >>>
|
2008-02-04 19:41:49 +00:00
|
|
|
S<<< [B<-cell> <I<cell name>>] >>> [B<-noauth>] [B<-localauth>] [B<-force>]
|
2013-06-13 00:22:27 +01:00
|
|
|
[B<-help>] [B<-auth>] [B<-encrypt>] S<<< [B<-config> <I<config directory>>] >>>
|
2006-03-01 05:02:29 +00:00
|
|
|
|
|
|
|
B<pts rem> S<<< B<-u> <I<user name>>+ >>> S<<< B<-g> <I<group name>>+ >>>
|
2008-02-04 19:41:49 +00:00
|
|
|
S<<< [B<-c> <I<cell name>>] >>> [B<-n>] [B<-l>] [B<-f>] [B<-h>]
|
2013-06-13 00:22:27 +01:00
|
|
|
[B<-a>] [B<-e>] S<<< [B<-co> <I<config directory>>] >>>
|
2006-03-01 05:02:29 +00:00
|
|
|
|
|
|
|
=for html
|
|
|
|
</div>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
|
2005-12-09 14:48:56 +00:00
|
|
|
The B<pts removeuser> command removes each user or machine named by the
|
|
|
|
B<-user> argument from each group named by the B<-group> argument.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-09 14:48:56 +00:00
|
|
|
To add users to a group, use the B<pts adduser> command. To list group
|
|
|
|
membership, use the B<pts membership> command. To remove users from a
|
|
|
|
group and delete the group's entry completely in a single step, use the
|
|
|
|
B<pts delete> command.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-09 14:48:56 +00:00
|
|
|
=head1 CAUTIONS
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-09 14:48:56 +00:00
|
|
|
AFS compiles each user's group membership as he or she authenticates. Any
|
|
|
|
users who have valid tokens when they are removed from a group retain the
|
|
|
|
privileges extended to that group's members until they discard their
|
|
|
|
tokens or reauthenticate.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=head1 OPTIONS
|
|
|
|
|
|
|
|
=over 4
|
|
|
|
|
2013-06-13 00:22:27 +01:00
|
|
|
=item B<-user> <I<user name>>+
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
Specifies the name of each user entry or the IP address (complete or
|
|
|
|
wildcard-style) of each machine entry to remove.
|
|
|
|
|
2005-12-09 14:48:56 +00:00
|
|
|
=item B<-group> <I<group name>>+
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
Names each group from which to remove members.
|
|
|
|
|
2010-07-16 01:21:26 +01:00
|
|
|
=include fragments/pts-common.pod
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=back
|
|
|
|
|
|
|
|
=head1 EXAMPLES
|
|
|
|
|
2005-12-09 14:48:56 +00:00
|
|
|
The following example removes user smith from the groups C<staff> and
|
|
|
|
C<staff:finance>. Note that no switch names are necessary because only a
|
|
|
|
single instance is provided for the first argument (the username).
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
% pts removeuser smith staff staff:finance
|
|
|
|
|
|
|
|
The following example removes three machine entries, which represent all
|
doc: replace hostnames with IETF example hostnames
There were several different real and made-up hostnames and company names used
throughout our documentation examples.
The IETF has reserved "example.com" and other "example" TLDs for use in
examples (RFC 2606). Replace almost all references to ABC Corporation, DEF
Corporation, and State University, as well as "abc.com", "bigcell.com",
"def.com", "def.gov", "ghi.com", "ghi.gov", "jkl.com", "mit.edu",
"stanford.edu", "state.edu", "stateu.edu", "uncc.edu", and "xyz.com".
Standardize on "Example Corporation", "Example Network", "Example
Organization" (example.com, example.net, and example.org).
The Scout documentation in the Admin Guide contains PNG images that contain
the old cell names, so I left those references until the images can be
replaced.
Change-Id: I4e44815b2d2ffe204810b7fd850842248f67c367
Reviewed-on: http://gerrit.openafs.org/6697
Reviewed-by: Jeffrey Altman <jaltman@secure-endpoints.com>
Tested-by: Jeffrey Altman <jaltman@secure-endpoints.com>
2012-02-11 16:43:30 +00:00
|
|
|
machines in the Example Corporation network, from the group C<bin-prot>:
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
% pts removeuser -user 138.255.0.0 192.12.105.0 192.12.106.0 -group bin-prot
|
|
|
|
|
|
|
|
=head1 PRIVILEGE REQUIRED
|
|
|
|
|
|
|
|
The required privilege depends on the setting of the fifth privacy flag in
|
2005-12-09 14:48:56 +00:00
|
|
|
the Protection Database for the group named by the B<-group> argument (use
|
|
|
|
the B<pts examine> command to display the flags):
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=over 4
|
|
|
|
|
|
|
|
=item *
|
|
|
|
|
|
|
|
If it is the hyphen, only the group's owner and members of the
|
2005-12-09 14:48:56 +00:00
|
|
|
system:administrators group can remove members.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=item *
|
|
|
|
|
2005-12-09 14:48:56 +00:00
|
|
|
If it is lowercase C<r>, members of the group can also remove other
|
|
|
|
members.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=back
|
|
|
|
|
2005-12-09 14:48:56 +00:00
|
|
|
(It is not possible to set the fifth flag to uppercase C<R>.)
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=head1 SEE ALSO
|
|
|
|
|
|
|
|
L<pts(1)>,
|
|
|
|
L<pts_adduser(1)>,
|
|
|
|
L<pts_examine(1)>,
|
|
|
|
L<pts_membership(1)>,
|
|
|
|
L<pts_setfields(1)>
|
|
|
|
|
|
|
|
=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.
|