Commit | Line | Data |
---|---|---|
805e021f CE |
1 | =head1 NAME |
2 | ||
3 | pts_listowned - Show the Protection Database groups owned by a user or group | |
4 | ||
5 | =head1 SYNOPSIS | |
6 | ||
7 | =for html | |
8 | <div class="synopsis"> | |
9 | ||
10 | B<pts listowned> S<<< B<-nameorid> <I<user or group name or id>>+ >>> | |
11 | [-cell <I<cell name>>] [B<-noauth>] [B<-localauth>] [B<-force>] [B<-help>] | |
12 | [B<-auth>] [B<-encrypt>] S<<< [B<-config> <I<config directory>>] >>> | |
13 | ||
14 | B<pts listo> S<<< B<-na> <I<user or group name or id>>+ >>> | |
15 | [-c <I<cell name>>] [B<-no>] [B<-l>] [B<-f>] [B<-h>] | |
16 | [B<-a>] [B<-e>] S<<< [B<-co> <I<config directory>>] >>> | |
17 | ||
18 | =for html | |
19 | </div> | |
20 | ||
21 | =head1 DESCRIPTION | |
22 | ||
23 | The B<pts listowned> command lists the groups owned by each user or group | |
24 | specified by the B<-nameorid> argument. | |
25 | ||
26 | To list any I<orphaned group>s, whose owners have themselves been deleted | |
27 | from the Protection Database, provide a value of C<0> (zero) for the | |
28 | B<-nameorid> argument. To change the owner to a user or group that still | |
29 | exists, use the B<pts chown> command. | |
30 | ||
31 | =head1 OPTIONS | |
32 | ||
33 | =over 4 | |
34 | ||
35 | =item B<-nameorid> <I<user or group name or id>>+ | |
36 | ||
37 | Specifies the name or AFS UID of each user, or the name or AFS GID of each | |
38 | group, for which to display the list of owned groups. It is acceptable to | |
39 | mix users and groups on the same command line, as well as names and | |
40 | IDs. Precede the GID of each group with a hyphen to indicate that it is | |
41 | negative. | |
42 | ||
43 | A value of 0 (zero) lists group entries for groups whose owners no longer | |
44 | have entries in the Protection Database. | |
45 | ||
46 | =include fragments/pts-common.pod | |
47 | ||
48 | =back | |
49 | ||
50 | =head1 OUTPUT | |
51 | ||
52 | The first line of the output indicates the name and AFS UID or AFS GID of | |
53 | each user or group for which ownership information is requested, in the | |
54 | following format: | |
55 | ||
56 | Groups owned by <name> (id: <ID>) are: | |
57 | ||
58 | A list of groups follows. The list does not include groups owned by groups | |
59 | that the user or group owns, or to which the user or group belongs. If the | |
60 | user or group does not own any groups, only the header line appears. | |
61 | ||
62 | The following error message appears if the issuer is not privileged to | |
63 | view ownership information. By default, for both user and group entries | |
64 | the second privacy flag is the hyphen, which denies permission to anyone | |
65 | other than the user (for a user entry) and the members of the | |
66 | system:administrators group. | |
67 | ||
68 | pts: Permission denied so failed to get owner list for <name> (id: <ID>) | |
69 | ||
70 | =head1 EXAMPLES | |
71 | ||
72 | The following example lists the groups owned by user terry and shows that | |
73 | the group C<terry:friends> does not own any groups: | |
74 | ||
75 | % pts listowned terry terry:friends | |
76 | Groups owned by terry (id: 1045) are: | |
77 | terry:friends | |
78 | terry:project1 | |
79 | terry:project2 | |
80 | Groups owned by terry:friends (id: -673) are: | |
81 | ||
82 | =head1 PRIVILEGE REQUIRED | |
83 | ||
84 | The required privilege depends on the setting of the second privacy flag | |
85 | in the Protection Database entry of each user or group indicated by the | |
86 | B<-nameorid> argument (use the B<pts examine> command to display the | |
87 | flags): | |
88 | ||
89 | =over 4 | |
90 | ||
91 | =item * | |
92 | ||
93 | If it is the hyphen and the B<-nameorid> argument specifies a group, only | |
94 | the members of the system:administrators group and the owner of a group | |
95 | can list the groups it owns. | |
96 | ||
97 | =item * | |
98 | ||
99 | If it is the hyphen and the B<-nameorid> argument specifies a user, only | |
100 | the members of the system:administrators group and the associated user can | |
101 | list the groups he or she owns. | |
102 | ||
103 | =item * | |
104 | ||
105 | If it is uppercase letter C<O>, anyone who can access the cell's database | |
106 | server machines can list the groups owned by this user or group. | |
107 | ||
108 | =back | |
109 | ||
110 | =head1 SEE ALSO | |
111 | ||
112 | L<pts(1)>, | |
113 | L<pts_chown(1)>, | |
114 | L<pts_examine(1)>, | |
115 | L<pts_setfields(1)> | |
116 | ||
117 | =head1 COPYRIGHT | |
118 | ||
119 | IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved. | |
120 | ||
121 | This documentation is covered by the IBM Public License Version 1.0. It was | |
122 | converted from HTML to POD by software written by Chas Williams and Russ | |
123 | Allbery, based on work by Alf Wachsmann and Elizabeth Cassell. |