src/WINNT/doc/install/Documentation/en_US/html/CmdRef/auarf213.htm

   1 <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 3//EN">
   2 <HTML><HEAD>
   3 <TITLE>Administration Reference</TITLE>
   4 <!-- Begin Header Records  ========================================== -->
   5 <!-- /tmp/idwt3190/auarf000.scr converted by idb2h R4.2 (359) ID      -->
   6 <!-- Workbench Version (AIX) on 5 Nov 1999 at 13:58:29                -->
   7 <META HTTP-EQUIV="updated" CONTENT="Fri, 05 Nov 1999 13:58:29">
   8 <META HTTP-EQUIV="review" CONTENT="Sun, 05 Nov 2000 13:58:29">
   9 <META HTTP-EQUIV="expires" CONTENT="Mon, 05 Nov 2001 13:58:29">
  10 </HEAD><BODY>
  11 <!-- (C) IBM Corporation 2000. All Rights Reserved    -->
  12 <BODY bgcolor="ffffff">
  13 <!-- End Header Records  ============================================ -->
  14 <A NAME="Top_Of_Page"></A>
  15 <H1>Administration Reference</H1>
  16 <HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auarf002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auarf212.htm"><IMG SRC="../prev.gif" BORDER="0" ALT="[Previous Topic]"></A> <A HREF="#Bot_Of_Page"><IMG SRC="../bot.gif" BORDER="0" ALT="[Bottom of Topic]"></A> <A HREF="auarf214.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auarf284.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P>
  17 <P>
  18 <H2><A NAME="HDRPTS_CHOWN" HREF="auarf002.htm#ToC_227">pts chown</A></H2>
  19 <A NAME="IDX5247"></A>
  20 <A NAME="IDX5248"></A>
  21 <A NAME="IDX5249"></A>
  22 <A NAME="IDX5250"></A>
  23 <A NAME="IDX5251"></A>
  24 <P><STRONG>Purpose</STRONG>
  25 <P>Changes the owner of a Protection Database entry
  26 <P><STRONG>Synopsis</STRONG>
  27 <PRE><B>pts chown -name</B> &lt;<VAR>group&nbsp;name</VAR>>  <B>-owner</B> &lt;<VAR>new&nbsp;owner</VAR>>
  28           [<B>-cell</B> &lt;<VAR>cell&nbsp;name</VAR>>]  [<B>-noauth</B>]  [<B>-force</B>]  [<B>-help</B>]
  29
  30 <B>pts cho -na</B> &lt;<VAR>group&nbsp;name</VAR>>  <B>-o</B> &lt;<VAR>new&nbsp;owner</VAR>>  [<B>-c</B> &lt;<VAR>cell&nbsp;name</VAR>>]  [<B>-no</B>]  [<B>-f</B>]  [<B>-h</B>]
  31 </PRE>
  32 <P><STRONG>Description</STRONG>
  33 <P>The <B>pts chown</B> command designates the user or group named by the
  34 <B>-owner</B> argument as the owner of the group named by the
  35 <B>-name</B> argument, and records the new owner in the owner field of the
  36 group&#39;s Protection Database entry.
  37 <P>In the case of regular groups, this command automatically changes the group
  38 name&#39;s owner prefix (the part of the group name before the colon) to
  39 match the new owner. If the new owner is itself a group, then only its
  40 owner prefix, not its complete name, becomes the owner prefix in the new
  41 name. The change to the owner prefix does not propagate to any groups
  42 owned by the group, however. To make the owner prefix of such
  43 group-owned groups reflect the new owning group, use the <B>pts rename</B>
  44 command.
  45 <P>It is not possible to change a user or machine entry&#39;s owner from the
  46 default set at creation time, the <B>system&#58;administrators</B>
  47 group.
  48 <P><STRONG>Cautions</STRONG>
  49 <P>While designating a machine as a group&#39;s owner does not cause an
  50 error, it is not recommended. The Protection Server does not extend the
  51 usual privileges of group ownership to users logged onto the machine.
  52 <P><STRONG>Options</STRONG>
  53 <DL>
  54 <P><DT><B>-name
  55 </B><DD>Specifies the current name of the group to which to assign a new
  56 owner.
  57 <P><DT><B>-owner
  58 </B><DD>Names the user or group to become the group&#39;s owner.
  59 <P><DT><B>-cell
  60 </B><DD>Names the cell in which to run the command. For more details, see
  61 the introductory <B>pts</B> reference page.
  62 <P><DT><B>-noauth
  63 </B><DD>Assigns the unprivileged identity <B>anonymous</B> to the
  64 issuer. For more details, see the introductory <B>pts</B> reference
  65 page.
  66 <P><DT><B>-force
  67 </B><DD>Enables the command to continue executing as far as possible when errors
  68 or other problems occur, rather than halting execution at the first
  69 error.
  70 <P><DT><B>-help
  71 </B><DD>Prints the online help for this command. All other valid options
  72 are ignored.
  73 </DL>
  74 <P><STRONG>Examples</STRONG>
  75 <P>The following example changes the owner of the group
  76 <B>terry&#58;friends</B> from the user <B>terry</B> to the user
  77 <B>pat</B>. A side effect is that the group name changes to
  78 <B>pat&#58;friends</B>.
  79 <PRE>   % <B>pts chown -name terry&#58;friends -owner pat</B>
  80
  81 </PRE>
  82 <P>The following example changes the owner of the group
  83 <B>terry&#58;friends</B> from the user <B>terry</B> to the group
  84 <B>pat&#58;buddies</B>. A side effect is that the group name
  85 changes to <B>pat&#58;friends</B>.
  86 <PRE>   % <B>pts chown -name terry&#58;friends -owner pat&#58;buddies</B>
  87
  88 </PRE>
  89 <P><STRONG>Privilege Required</STRONG>
  90 <P>The issuer must belong to the <B>system&#58;administrators</B> group
  91 or currently own the group.
  92 <P><STRONG>Related Information</STRONG>
  93 <P><A HREF="auarf210.htm#HDRPTS_INTRO">pts</A>
  94 <P><A HREF="auarf224.htm#HDRPTS_RENAME">pts rename</A>
  95 <P>
  96 <HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auarf002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auarf212.htm"><IMG SRC="../prev.gif" BORDER="0" ALT="[Previous Topic]"></A> <A HREF="#Top_Of_Page"><IMG SRC="../top.gif" BORDER="0" ALT="[Top of Topic]"></A> <A HREF="auarf214.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auarf284.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P>
  97 <!-- Begin Footer Records  ========================================== -->
  98 <P><HR><B>
  99 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved
 100 </B>
 101 <!-- End Footer Records  ============================================ -->
 102 <A NAME="Bot_Of_Page"></A>
 103 </BODY></HTML>