3 pts listowned - Show the Protection Database groups owned by a user or group
10 B<pts listowned> S<<< B<-nameorid> <I<user or group name or id>>+ >>>
11 [-cell <I<cell name>>] [B<-noauth>] [B<-force>] [B<-help>]
13 B<pts listo> S<<< B<-na> <I<user or group name or id>>+ >>>
14 [-c <I<cell name>>] [B<-no>] [B<-f>] [B<-h>]
21 The B<pts listowned> command lists the groups owned by each user or group
22 specified by the B<-nameorid> argument.
24 To list any I<orphaned group>s, whose owners have themselves been deleted
25 from the Protection Database, provide a value of C<0> (zero) for the
26 B<-nameorid> argument. To change the owner to a user or group that still
27 exists, use the B<pts chown> command.
33 =item B<-nameorid> <I<user or group name or id>>+
35 Specifies the name or AFS UID of each user, or the name or AFS GID of each
36 group, for which to display the list of owned groups. It is acceptable to
37 mix users and groups on the same command line, as well as names and
38 IDs. Precede the GID of each group with a hyphen to indicate that it is
41 A value of 0 (zero) lists group entries for groups whose owners no longer
42 have entries in the Protection Database.
44 =item B<-cell> <I<cell name>>
46 Names the cell in which to run the command. For more details, see
51 Assigns the unprivileged identity anonymous to the issuer. For more
52 details, see L<pts(1)>.
56 Enables the command to continue executing as far as possible when errors
57 or other problems occur, rather than halting execution at the first error.
61 Prints the online help for this command. All other valid options are
68 The first line of the output indicates the name and AFS UID or AFS GID of
69 each user or group for which ownership information is requested, in the
72 Groups owned by <name> (id: <ID>) are:
74 A list of groups follows. The list does not include groups owned by groups
75 that the user or group owns, or to which the user or group belongs. If the
76 user or group does not own any groups, only the header line appears.
78 The following error message appears if the issuer is not privileged to
79 view ownership information. By default, for both user and group entries
80 the second privacy flag is the hyphen, which denies permission to anyone
81 other than the user (for a user entry) and the members of the
82 system:administrators group.
84 pts: Permission denied so failed to get owner list for <name> (id: <ID>)
88 The following example lists the groups owned by user terry and shows that
89 the group C<terry:friends> does not own any groups:
91 % pts listowned terry terry:friends
92 Groups owned by terry (id: 1045) are:
96 Groups owned by terry:friends (id: -673) are:
98 =head1 PRIVILEGE REQUIRED
100 The required privilege depends on the setting of the second privacy flag
101 in the Protection Database entry of each user or group indicated by the
102 B<-nameorid> argument (use the B<pts examine> command to display the
109 If it is the hyphen and the B<-nameorid> argument specifies a group, only
110 the members of the system:administrators group and the owner of a group
111 can list the groups it owns.
115 If it is the hyphen and the B<-nameorid> argument specifies a user, only
116 the members of the system:administrators group and the associated user can
117 list the groups he or she owns.
121 If it is uppercase letter C<O>, anyone who can access the cell's database
122 server machines can list the groups owned by this user or group.
135 IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
137 This documentation is covered by the IBM Public License Version 1.0. It was
138 converted from HTML to POD by software written by Chas Williams and Russ
139 Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.