doc/man-pages/pod1/pts_listowned.pod.in

   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.