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

   1 =head1 NAME
   2
   3 pts_chown - Changes the owner of a Protection Database entry
   4
   5 =head1 SYNOPSIS
   6
   7 =for html
   8 <div class="synopsis">
   9
  10 B<pts chown> S<<< B<-name> <I<group name>> >>> S<<< B<-owner> <I<new owner>> >>>
  11     S<<< [B<-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 cho> S<<< B<-na> <I<group name>> >>> S<<< B<-o> <I<new owner>> >>>
  15     S<<< [B<-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 chown> command designates the user or group named by the
  24 B<-owner> argument as the owner of the group named by the B<-name>
  25 argument, and records the new owner in the owner field of the group's
  26 Protection Database entry.
  27
  28 In the case of regular groups, this command automatically changes the
  29 group name's owner prefix (the part of the group name before the colon) to
  30 match the new owner. If the new owner is itself a group, then only its
  31 owner prefix, not its complete name, becomes the owner prefix in the new
  32 name. The change to the owner prefix does not propagate to any groups
  33 owned by the group, however. To make the owner prefix of such group-owned
  34 groups reflect the new owning group, use the B<pts rename> command.
  35
  36 It is not possible to change a user or machine entry's owner from the
  37 default set at creation time, the system:administrators group.
  38
  39 =head1 CAUTIONS
  40
  41 While designating a machine as a group's owner does not cause an error, it
  42 is not recommended. The Protection Server does not extend the usual
  43 privileges of group ownership to users logged onto the machine.
  44
  45 =head1 OPTIONS
  46
  47 =over 4
  48
  49 =item B<-name> <I<group name>>
  50
  51 Specifies the current name of the group to which to assign a new owner.
  52
  53 =item B<-owner> <I<new owner>>
  54
  55 Names the user or group to become the group's owner.
  56
  57 =include fragments/pts-common.pod
  58
  59 =back
  60
  61 =head1 EXAMPLES
  62
  63 The following example changes the owner of the group C<terry:friends> from
  64 the user C<terry> to the user C<pat>. A side effect is that the group name
  65 changes to C<pat:friends>.
  66
  67    % pts chown -name terry:friends -owner pat
  68
  69 The following example changes the owner of the group C<terry:friends> from
  70 the user C<terry> to the group C<pat:buddies>. A side effect is that the
  71 group name changes to C<pat:friends>.
  72
  73    % pts chown -name terry:friends -owner pat:buddies
  74
  75 =head1 PRIVILEGE REQUIRED
  76
  77 The issuer must belong to the system:administrators group or currently own
  78 the group.
  79
  80 =head1 SEE ALSO
  81
  82 L<pts(1)>,
  83 L<pts_rename(1)>
  84
  85 =head1 COPYRIGHT
  86
  87 IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
  88
  89 This documentation is covered by the IBM Public License Version 1.0.  It was
  90 converted from HTML to POD by software written by Chas Williams and Russ
  91 Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.