3 pts removeuser - Removes a user from a Protection Database group
7 pts removeuser B<-user> I<user name> [I<user name> ...]
8 B<-group> I<group name> [I<group name> ...]
9 [B<-cell> I<cell name>] [B<-noauth>] [B<-force>] [B<-help>]
11 pts rem B<-u> I<user name> [I<user name> ...]
12 B<-g> I<group name> [I<group name> ...]
14 [B<-n>] [B<-f>] [B<-h>]
18 The C<pts removeuser> command removes each user or machine named by the
19 B<-user> argument from each group named by the B<-group> argument.
20 To add users to a group, use the pts adduser command. To list group
21 membership, use the C<pts membership> command. To remove users from a
22 group and delete the group's entry completely in a single step, use
23 the C<pts delete> command.
29 =item B<-name> I<user name> [I<user name> ...]
31 Specifies the name of each user entry or the IP address
32 (complete or wildcard-style) of each machine entry to remove.
34 =item B<-group> I<group name> [I<group name> ...]
36 Names each group from which to remove members.
40 Names the cell in which to run the command. For more details,
41 see the introductory L<pts(1)> reference page.
45 Assigns the unprivileged identity anonymous to the issuer. For
46 more details, see the introductory L<pts(1)> reference page.
50 Enables the command to continue executing as far as possible
51 when errors or other problems occur, rather than halting
52 execution at the first error.
56 Prints the online help for this command. All other valid
63 The following example removes user smith from the groups staff and
64 staff:finance. Note that no switch names are necessary because only a
65 single instance is provided for the first argument (the username).
67 pts removeuser smith staff staff:finance
69 The following example removes three machine entries, which represent
70 all machines in the ABC Corporation network, from the group bin-prot:
72 pts removeuser -user 138.255.0.0 192.12.105.0 192.12.106.0 -group bin-prot
74 =head1 PRIVILEGE REQUIRED
76 The required privilege depends on the setting of the fifth privacy
77 flag in the Protection Database for the group named by the B<-group>
78 argument (use the pts examine command to display the flags):
84 If it is the hyphen, only the group's owner and members of the
85 system:administrators group can remove members.
89 If it is lowercase r, members of the group can also remove other
91 (It is not possible to set the fifth flag to uppercase R.)
97 AFS compiles each user's group membership as he or she authenticates.
98 Any users who have valid tokens when they are removed from a group
99 retain the privileges extended to that group's members until they
100 discard their tokens or reauthenticate.
104 IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
106 Converted from html to pod by Alf Wachsmann <alfw@slac.stanford.edu>, 2003,
107 Stanford Linear Accelerator Center, a department of Stanford University.
114 L<pts_membership(1)>,