doc/html/AdminReference/auarf128.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="auarf127.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="auarf129.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="HDRDPASS" HREF="auarf002.htm#ToC_142">dpass</A></H2>
  19 <A NAME="IDX4699"></A>
  20 <A NAME="IDX4700"></A>
  21 <P><STRONG>Purpose</STRONG>
  22 <P>Returns the DCE password for a new DCE account
  23 <P><STRONG>Synopsis</STRONG>
  24 <PRE><B>dpass</B> [<B>-cell</B> &lt;<VAR>original&nbsp;AFS&nbsp;cell&nbsp;name</VAR>>]  [<B>-help</B>]
  25
  26 <B>dpass</B> [<B>-c</B> &lt;<VAR>original&nbsp;AFS&nbsp;cell&nbsp;name</VAR>>]  [<B>-h</B>]
  27 </PRE>
  28 <P><STRONG>Description</STRONG>
  29 <P>The <B>dpass</B> command returns the DCE password that an administrator
  30 assigned to the issuer when using the <B>dm pass</B> command to migrate
  31 AFS user accounts into a DCE cell.
  32 <P>The <B>dpass</B> command, issued on an AFS client, requests the
  33 issuer's new DCE password from the AFS cell specified with the
  34 <B>-cell</B> argument.
  35 <P>The issuer must be authenticated as the AFS user whose AFS account was
  36 moved into DCE, and be able to provide the user's AFS password when
  37 prompted by the <B>dpass</B> command.
  38 <P><STRONG>Options</STRONG>
  39 <DL>
  40 <P><DT><B>-cell
  41 </B><DD>Specifies the name of the AFS cell from which the AFS account was moved
  42 into DCE and from which to fetch the new DCE password.
  43 <P><DT><B>-help
  44 </B><DD>Prints the online help for this command. All other valid options
  45 are ignored.
  46 </DL>
  47 <P><STRONG>Output</STRONG>
  48 <P>By default, the <B>dpass</B> command writes a message similar to the
  49 following to the standard output stream.
  50 <PRE>   Please read the following message before entering your password.
  51
  52    This program will display your new, temporary DCE password on your
  53    terminal, and you should change the assigned password as soon as
  54    possible (from a DCE client).  The program assumes that the AFS cell
  55    uses the AFS Authentication Server and that an administrator used the
  56    utilities in the AFS/DFS Migration Toolkit to migrate the account from
  57    AFS to DCE. The password you enter should be the AFS password that was
  58    in effect when your DCE account was created; this is not necessarily
  59    the same password you have at the moment.  The cell name (which you
  60    may override with a command line option), must be the name of the AFS
  61    cell from which the authentication information was taken.
  62
  63 </PRE>
  64 <P>To suppress this message, set the DPASS_NO_MESSAGE environment
  65 variable. It is then possible to substitute a customized message if
  66 desired by using a script similar to the following example:
  67 <PRE>   #! /bin/csh
  68    echo "<VAR>Start of customized message</VAR>"
  69    echo "<VAR>Continuation of customized message</VAR>"
  70      .
  71      .
  72      .
  73    echo "<VAR>Conclusion of customized message</VAR>"
  74    setenv DPASS_NO_MESSAGE
  75    dpass $*
  76
  77 </PRE>
  78 <P>After the standard or customized message, if any, the <B>dpass</B>
  79 command generates the following prompt for the original AFS password:
  80 <PRE>   Original password for AFS cell <VAR>cell</VAR>:
  81    Re-enter password to verify:
  82
  83 </PRE>
  84 <P>If the AFS passwords match and are correct, the command reports the
  85 temporary DCE password in the following message.
  86 <PRE>   The new DCE password is: <VAR>Issuer's_temporary_DCE_password</VAR>
  87
  88 </PRE>
  89 <P><STRONG>Examples</STRONG>
  90 <P>The following example returns the DCE password of the issuer, whose AFS
  91 account is in the <B>abc.com</B> cell. The DPASS_NO_MESSAGE
  92 variable has been set to suppress the standard message.
  93 <PRE>   % <B>dpass</B>
  94    Original password for AFS cell abc.com: <VAR>Issuer's_AFS_password</VAR>
  95    Re-enter password to verify: <VAR>Issuer's_AFS_password</VAR>
  96    The new DCE password is: 8655--eg8e-dcdc-8157
  97
  98 </PRE>
  99 <P><STRONG>Privilege Required</STRONG>
 100 <P>The issuer must be authenticated as the AFS user for whom to display the
 101 corresponding DCE password.
 102 <P><STRONG>Related Information</STRONG>
 103 <P><A HREF="auarf127.htm#HDRDLOG">dlog</A>
 104 <P><B>dm pass</B> reference page in <I>IBM AFS/DFS Migration Toolkit
 105 Administration Guide and Reference</I>
 106 <P>
 107 <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="auarf127.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="auarf129.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>
 108 <!-- Begin Footer Records  ========================================== -->
 109 <P><HR><B>
 110 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved
 111 </B>
 112 <!-- End Footer Records  ============================================ -->
 113 <A NAME="Bot_Of_Page"></A>
 114 </BODY></HTML>