doc/xml/AdminReference/sect1/pts_chown.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <refentry id="pts_chown1">
   3   <refmeta>
   4     <refentrytitle>pts chown</refentrytitle>
   5     <manvolnum>1</manvolnum>
   6   </refmeta>
   7   <refnamediv>
   8     <refname>pts chown</refname>
   9     <refpurpose>Changes the owner of a Protection Database entry</refpurpose>
  10   </refnamediv>
  11   <refsect1>
  12     <title>Synopsis</title>
  13     <para><emphasis role="bold">pts chown</emphasis> <emphasis role="bold">-name</emphasis> &lt;<emphasis>group name</emphasis>&gt; <emphasis role="bold">-owner</emphasis> &lt;<emphasis>new owner</emphasis>&gt;
  14         [<emphasis role="bold">-cell</emphasis> &lt;<emphasis>cell name</emphasis>&gt;] [<emphasis role="bold">-noauth</emphasis>] [<emphasis role="bold">-force</emphasis>] [<emphasis role="bold">-help</emphasis>]</para>
  15
  16     <para><emphasis role="bold">pts cho</emphasis> <emphasis role="bold">-na</emphasis> &lt;<emphasis>group name</emphasis>&gt; <emphasis role="bold">-o</emphasis> &lt;<emphasis>new owner</emphasis>&gt;
  17         [<emphasis role="bold">-c</emphasis> &lt;<emphasis>cell name</emphasis>&gt;] [<emphasis role="bold">-no</emphasis>] [<emphasis role="bold">-f</emphasis>] [<emphasis role="bold">-h</emphasis>]</para>
  18
  19   </refsect1>
  20   <refsect1>
  21     <title>Description</title>
  22     <para>The <emphasis role="bold">pts chown</emphasis> command designates the user or group named by the
  23     <emphasis role="bold">-owner</emphasis> argument as the owner of the group named by the <emphasis role="bold">-name</emphasis>
  24     argument, and records the new owner in the owner field of the group's
  25     Protection Database entry.</para>
  26
  27     <para>In the case of regular groups, this command automatically changes the
  28     group name's owner prefix (the part of the group name before the colon) to
  29     match the new owner. If the new owner is itself a group, then only its
  30     owner prefix, not its complete name, becomes the owner prefix in the new
  31     name. The change to the owner prefix does not propagate to any groups
  32     owned by the group, however. To make the owner prefix of such group-owned
  33     groups reflect the new owning group, use the <emphasis role="bold">pts rename</emphasis> command.</para>
  34
  35     <para>It is not possible to change a user or machine entry's owner from the
  36     default set at creation time, the system:administrators group.</para>
  37
  38   </refsect1>
  39   <refsect1>
  40     <title>Cautions</title>
  41     <para>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.</para>
  44
  45   </refsect1>
  46   <refsect1>
  47     <title>Options</title>
  48     <variablelist>
  49       <varlistentry>
  50         <term><emphasis role="bold">-name</emphasis> &lt;<emphasis>group name</emphasis>&gt;</term>
  51         <listitem>
  52           <para>Specifies the current name of the group to which to assign a new owner.</para>
  53
  54         </listitem>
  55       </varlistentry>
  56       <varlistentry>
  57         <term><emphasis role="bold">-owner</emphasis> &lt;<emphasis>new owner</emphasis>&gt;</term>
  58         <listitem>
  59           <para>Names the user or group to become the group's owner.</para>
  60
  61         </listitem>
  62       </varlistentry>
  63       <varlistentry>
  64         <term><emphasis role="bold">-cell</emphasis> &lt;<emphasis>cell name</emphasis>&gt;</term>
  65         <listitem>
  66           <para>Names the cell in which to run the command. For more details, see
  67           <link linkend="pts1">pts(1)</link>.</para>
  68
  69         </listitem>
  70       </varlistentry>
  71       <varlistentry>
  72         <term><emphasis role="bold">-noauth</emphasis></term>
  73         <listitem>
  74           <para>Assigns the unprivileged identity anonymous to the issuer. For more
  75           details, see <link linkend="pts1">pts(1)</link>.</para>
  76
  77         </listitem>
  78       </varlistentry>
  79       <varlistentry>
  80         <term><emphasis role="bold">-force</emphasis></term>
  81         <listitem>
  82           <para>Enables the command to continue executing as far as possible when errors
  83           or other problems occur, rather than halting execution at the first error.</para>
  84
  85         </listitem>
  86       </varlistentry>
  87       <varlistentry>
  88         <term><emphasis role="bold">-help</emphasis></term>
  89         <listitem>
  90           <para>Prints the online help for this command. All other valid options are
  91           ignored.</para>
  92
  93         </listitem>
  94       </varlistentry>
  95     </variablelist>
  96   </refsect1>
  97   <refsect1>
  98     <title>Examples</title>
  99     <para>The following example changes the owner of the group <computeroutput>terry:friends</computeroutput> from
 100     the user <computeroutput>terry</computeroutput> to the user <computeroutput>pat</computeroutput>. A side effect is that the group name
 101     changes to <computeroutput>pat:friends</computeroutput>.</para>
 102
 103 <programlisting>
 104    % pts chown -name terry:friends -owner pat
 105
 106 </programlisting>
 107       <para>The following example changes the owner of the group <computeroutput>terry:friends</computeroutput> from
 108       the user <computeroutput>terry</computeroutput> to the group <computeroutput>pat:buddies</computeroutput>. A side effect is that the
 109       group name changes to <computeroutput>pat:friends</computeroutput>.</para>
 110
 111 <programlisting>
 112    % pts chown -name terry:friends -owner pat:buddies
 113
 114 </programlisting>
 115       </refsect1>
 116       <refsect1>
 117         <title>Privilege Required</title>
 118         <para>The issuer must belong to the system:administrators group or currently own
 119         the group.</para>
 120
 121       </refsect1>
 122       <refsect1>
 123         <title>See Also</title>
 124         <para><link linkend="pts1">pts(1)</link>,
 125         <link linkend="pts_rename1">pts_rename(1)</link></para>
 126
 127       </refsect1>
 128       <refsect1>
 129         <title>Copyright</title>
 130         <para>IBM Corporation 2000. &lt;http://www.ibm.com/&gt; All Rights Reserved.</para>
 131
 132         <para>This documentation is covered by the IBM Public License Version 1.0.  It was
 133         converted from HTML to POD by software written by Chas Williams and Russ
 134         Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.</para>
 135
 136       </refsect1>
 137     </refentry>