doc/man-pages/pod1/pts_listowned.pod

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