doc/html/AdminReference/auarf224.htm

   1 <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 4//EN">
   2 <HTML><HEAD>
   3 <TITLE>Administration Reference</TITLE>
   4 <!-- Begin Header Records  ========================================== -->
   5 <!-- /tmp/idwt3672/auarf000.scr converted by idb2h R4.2 (359) ID      -->
   6 <!-- Workbench Version (AIX) on 3 Oct 2000 at 16:18:30                -->
   7 <META HTTP-EQUIV="updated" CONTENT="Tue, 03 Oct 2000 16:18:29">
   8 <META HTTP-EQUIV="review" CONTENT="Wed, 03 Oct 2001 16:18:29">
   9 <META HTTP-EQUIV="expires" CONTENT="Thu, 03 Oct 2002 16:18: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="auarf223.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="auarf225.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_RENAME" HREF="auarf002.htm#ToC_238">pts rename</A></H2>
  19 <A NAME="IDX5390"></A>
  20 <A NAME="IDX5391"></A>
  21 <A NAME="IDX5392"></A>
  22 <A NAME="IDX5393"></A>
  23 <A NAME="IDX5394"></A>
  24 <A NAME="IDX5395"></A>
  25 <P><STRONG>Purpose</STRONG>
  26 <P>Changes the name of a Protection Database entry
  27 <P><STRONG>Synopsis</STRONG>
  28 <PRE><B>pts rename -oldname</B> &lt;<VAR>old&nbsp;name</VAR>>  <B>-newname</B> &lt;<VAR>new&nbsp;name</VAR>>
  29            [<B>-cell</B> &lt;<VAR>cell&nbsp;name</VAR>>]  [<B>-noauth</B>]  [<B>-force</B>]  [<B>-help</B>]
  30
  31 <B>pts ren -o</B> &lt;<VAR>old&nbsp;name</VAR>>  <B>-ne</B> &lt;<VAR>new&nbsp;name</VAR>>  [<B>-c</B> &lt;<VAR>cell&nbsp;name</VAR>>]  [<B>-no</B>]  [<B>-f</B>]  [<B>-h</B>]
  32 </PRE>
  33 <P><STRONG>Description</STRONG>
  34 <P>The <B>pts rename</B> command changes the name of the user, machine, or
  35 group entry specified by the <B>-oldname</B> argument to the name
  36 specified by the <B>-newname</B> argument. It is not possible to
  37 change a user or machine entry's name to look like a regular group
  38 entry's name (have a colon in it).
  39 <P>Members of the <B>system:administrators</B> group can change a
  40 regular group name into a prefix-less name and vice versa. When
  41 changing a prefix-less group name into a regular group name or a regular group
  42 name to another regular group name, the owner field of the new name (the part
  43 before the colon) must correctly reflect the group's owner.
  44 <P>Changing a regular group's owner with the <B>pts chown</B> command
  45 automatically changes the owner field (the part before the colon) of the
  46 group's name, but does not change the owner field of any groups owned by
  47 the group. Use this command to rename those groups to a form that
  48 accurately reflects their ownership.
  49 <P><STRONG>Cautions</STRONG>
  50 <P>By convention, many aspects of an AFS user account have the same name as
  51 the user's Protection Database entry, including the Authentication
  52 Database entry, volume, and mount point. When using this command to
  53 change a user name, also change the names of all related entities to maintain
  54 consistency. For instructions, see the chapter on user accounts in the
  55 <I>IBM AFS Administration Guide</I>.
  56 <P><STRONG>Options</STRONG>
  57 <DL>
  58 <P><DT><B>-oldname
  59 </B><DD>Specifies the current full name of the entry.
  60 <P><DT><B>-newname
  61 </B><DD>Specifies the new full name for the entry. For regular groups, the
  62 owner field (the part before the colon) of the new name must reflect the
  63 actual ownership of the group.
  64 <P><DT><B>-cell
  65 </B><DD>Names the cell in which to run the command. For more details, see
  66 the introductory <B>pts</B> reference page.
  67 <P><DT><B>-noauth
  68 </B><DD>Assigns the unprivileged identity <B>anonymous</B> to the
  69 issuer. For more details, see the introductory <B>pts</B> reference
  70 page.
  71 <P><DT><B>-force
  72 </B><DD>Enables the command to continue executing as far as possible when errors
  73 or other problems occur, rather than halting execution at the first
  74 error.
  75 <P><DT><B>-help
  76 </B><DD>Prints the online help for this command. All other valid options
  77 are ignored.
  78 </DL>
  79 <P><STRONG>Examples</STRONG>
  80 <P>The following example changes the name of the group <B>staff</B>, owned
  81 by the privileged user <B>admin</B>, to
  82 <B>admin:staff</B>:
  83 <PRE>   % <B>pts rename -oldname staff -newname admin:staff</B>
  84
  85 </PRE>
  86 <P>The following example changes the name of the group
  87 <B>admin:finance</B> to the group <B>finance</B>. The
  88 issuer must belong to the <B>system:administrators</B> group.
  89 <PRE>   % <B>pts rename -oldname admin:finance -newname finance</B>
  90
  91 </PRE>
  92 <P><STRONG>Privilege Required</STRONG>
  93 <P>To change a regular group name to a prefix-less name or vice versa, or to
  94 change a user or machine entry's name, the issuer must belong to the
  95 <B>system:administrators</B> group.
  96 <P>To change a group name to a new name of the same type (regular or
  97 prefix-less), the issuer must own the group or belong to the
  98 <B>system:administrators</B> group.
  99 <P><STRONG>Related Information</STRONG>
 100 <P><A HREF="auarf210.htm#HDRPTS_INTRO">pts</A>
 101 <P><A HREF="auarf213.htm#HDRPTS_CHOWN">pts chown</A>
 102 <P>
 103 <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="auarf223.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="auarf225.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>
 104 <!-- Begin Footer Records  ========================================== -->
 105 <P><HR><B>
 106 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved
 107 </B>
 108 <!-- End Footer Records  ============================================ -->
 109 <A NAME="Bot_Of_Page"></A>
 110 </BODY></HTML>