doc/man-pages/pod1/pts_chown.pod

   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
  13 B<pts cho> S<<< B<-na> <I<group name>> >>> S<<< B<-o> <I<new owner>> >>>
  14     S<<< [B<-c> <I<cell name>>] >>> [B<-no>] [B<-l>] [B<-f>] [B<-h>]
  15
  16 =for html
  17 </div>
  18
  19 =head1 DESCRIPTION
  20
  21 The B<pts chown> command designates the user or group named by the
  22 B<-owner> argument as the owner of the group named by the B<-name>
  23 argument, and records the new owner in the owner field of the group's
  24 Protection Database entry.
  25
  26 In the case of regular groups, this command automatically changes the
  27 group name's owner prefix (the part of the group name before the colon) to
  28 match the new owner. If the new owner is itself a group, then only its
  29 owner prefix, not its complete name, becomes the owner prefix in the new
  30 name. The change to the owner prefix does not propagate to any groups
  31 owned by the group, however. To make the owner prefix of such group-owned
  32 groups reflect the new owning group, use the B<pts rename> command.
  33
  34 It is not possible to change a user or machine entry's owner from the
  35 default set at creation time, the system:administrators group.
  36
  37 =head1 CAUTIONS
  38
  39 While designating a machine as a group's owner does not cause an error, it
  40 is not recommended. The Protection Server does not extend the usual
  41 privileges of group ownership to users logged onto the machine.
  42
  43 =head1 OPTIONS
  44
  45 =over 4
  46
  47 =item B<-name> <I<group name>>
  48
  49 Specifies the current name of the group to which to assign a new owner.
  50
  51 =item B<-owner> <I<new owner>>
  52
  53 Names the user or group to become the group's owner.
  54
  55 =item B<-cell> <I<cell name>>
  56
  57 Names the cell in which to run the command. For more details, see
  58 L<pts(1)>.
  59
  60 =item B<-noauth>
  61
  62 Assigns the unprivileged identity anonymous to the issuer. For more
  63 details, see L<pts(1)>.
  64
  65 =item B<-localauth>
  66
  67 Constructs a server ticket using a key from the local
  68 F</usr/afs/etc/KeyFile> file. Do not combine this flag with the B<-cell>
  69 or B<-noauth> options. For more details, see L<pts(1)>.
  70
  71 =item B<-force>
  72
  73 Enables the command to continue executing as far as possible when errors
  74 or other problems occur, rather than halting execution at the first error.
  75
  76 =item B<-help>
  77
  78 Prints the online help for this command. All other valid options are
  79 ignored.
  80
  81 =back
  82
  83 =head1 EXAMPLES
  84
  85 The following example changes the owner of the group C<terry:friends> from
  86 the user C<terry> to the user C<pat>. A side effect is that the group name
  87 changes to C<pat:friends>.
  88
  89    % pts chown -name terry:friends -owner pat
  90
  91 The following example changes the owner of the group C<terry:friends> from
  92 the user C<terry> to the group C<pat:buddies>. A side effect is that the
  93 group name changes to C<pat:friends>.
  94
  95    % pts chown -name terry:friends -owner pat:buddies
  96
  97 =head1 PRIVILEGE REQUIRED
  98
  99 The issuer must belong to the system:administrators group or currently own
 100 the group.
 101
 102 =head1 SEE ALSO
 103
 104 L<pts(1)>,
 105 L<pts_rename(1)>
 106
 107 =head1 COPYRIGHT
 108
 109 IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
 110
 111 This documentation is covered by the IBM Public License Version 1.0.  It was
 112 converted from HTML to POD by software written by Chas Williams and Russ
 113 Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.