openafs/doc/html/AdminReference/auarf213.htm

104 lines
5.5 KiB
HTML
Raw Normal View History

<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 4//EN">
<HTML><HEAD>
<TITLE>Administration Reference</TITLE>
<!-- Begin Header Records ========================================== -->
<!-- /tmp/idwt3672/auarf000.scr converted by idb2h R4.2 (359) ID -->
<!-- Workbench Version (AIX) on 3 Oct 2000 at 16:18:30 -->
<META HTTP-EQUIV="updated" CONTENT="Tue, 03 Oct 2000 16:18:29">
<META HTTP-EQUIV="review" CONTENT="Wed, 03 Oct 2001 16:18:29">
<META HTTP-EQUIV="expires" CONTENT="Thu, 03 Oct 2002 16:18:29">
</HEAD><BODY>
<!-- (C) IBM Corporation 2000. All Rights Reserved -->
<BODY bgcolor="ffffff">
<!-- End Header Records ============================================ -->
<A NAME="Top_Of_Page"></A>
<H1>Administration Reference</H1>
<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>
<P>
<H2><A NAME="HDRPTS_CHOWN" HREF="auarf002.htm#ToC_227">pts chown</A></H2>
<A NAME="IDX5247"></A>
<A NAME="IDX5248"></A>
<A NAME="IDX5249"></A>
<A NAME="IDX5250"></A>
<A NAME="IDX5251"></A>
<P><STRONG>Purpose</STRONG>
<P>Changes the owner of a Protection Database entry
<P><STRONG>Synopsis</STRONG>
<PRE><B>pts chown -name</B> &lt;<VAR>group&nbsp;name</VAR>> <B>-owner</B> &lt;<VAR>new&nbsp;owner</VAR>>
[<B>-cell</B> &lt;<VAR>cell&nbsp;name</VAR>>] [<B>-noauth</B>] [<B>-force</B>] [<B>-help</B>]
<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>]
</PRE>
<P><STRONG>Description</STRONG>
<P>The <B>pts chown</B> command designates the user or group named by the
<B>-owner</B> argument as the owner of the group named by the
<B>-name</B> argument, and records the new owner in the owner field of the
group's Protection Database entry.
<P>In the case of regular groups, this command automatically changes the group
name's owner prefix (the part of the group name before the colon) to
match the new owner. If the new owner is itself a group, then only its
owner prefix, not its complete name, becomes the owner prefix in the new
name. The change to the owner prefix does not propagate to any groups
owned by the group, however. To make the owner prefix of such
group-owned groups reflect the new owning group, use the <B>pts rename</B>
command.
<P>It is not possible to change a user or machine entry's owner from the
default set at creation time, the <B>system:administrators</B>
group.
<P><STRONG>Cautions</STRONG>
<P>While designating a machine as a group's owner does not cause an
error, it is not recommended. The Protection Server does not extend the
usual privileges of group ownership to users logged onto the machine.
<P><STRONG>Options</STRONG>
<DL>
<P><DT><B>-name
</B><DD>Specifies the current name of the group to which to assign a new
owner.
<P><DT><B>-owner
</B><DD>Names the user or group to become the group's owner.
<P><DT><B>-cell
</B><DD>Names the cell in which to run the command. For more details, see
the introductory <B>pts</B> reference page.
<P><DT><B>-noauth
</B><DD>Assigns the unprivileged identity <B>anonymous</B> to the
issuer. For more details, see the introductory <B>pts</B> reference
page.
<P><DT><B>-force
</B><DD>Enables the command to continue executing as far as possible when errors
or other problems occur, rather than halting execution at the first
error.
<P><DT><B>-help
</B><DD>Prints the online help for this command. All other valid options
are ignored.
</DL>
<P><STRONG>Examples</STRONG>
<P>The following example changes the owner of the group
<B>terry:friends</B> from the user <B>terry</B> to the user
<B>pat</B>. A side effect is that the group name changes to
<B>pat:friends</B>.
<PRE> % <B>pts chown -name terry:friends -owner pat</B>
</PRE>
<P>The following example changes the owner of the group
<B>terry:friends</B> from the user <B>terry</B> to the group
<B>pat:buddies</B>. A side effect is that the group name
changes to <B>pat:friends</B>.
<PRE> % <B>pts chown -name terry:friends -owner pat:buddies</B>
</PRE>
<P><STRONG>Privilege Required</STRONG>
<P>The issuer must belong to the <B>system:administrators</B> group
or currently own the group.
<P><STRONG>Related Information</STRONG>
<P><A HREF="auarf210.htm#HDRPTS_INTRO">pts</A>
<P><A HREF="auarf224.htm#HDRPTS_RENAME">pts rename</A>
<P>
<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>
<!-- Begin Footer Records ========================================== -->
<P><HR><B>
<br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A> All Rights Reserved
</B>
<!-- End Footer Records ============================================ -->
<A NAME="Bot_Of_Page"></A>
</BODY></HTML>