openafs/doc/html/AdminReference/auarf196.htm
Derrick Brashear d7da1acc31 initial-html-documentation-20010606
pull in all documentation from IBM
2001-06-06 19:09:07 +00:00

90 lines
4.7 KiB
HTML

<!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="auarf195.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="auarf197.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="HDRKAS_STRINGTOKEY" HREF="auarf002.htm#ToC_210">kas stringtokey</A></H2>
<A NAME="IDX5161"></A>
<A NAME="IDX5162"></A>
<A NAME="IDX5163"></A>
<A NAME="IDX5164"></A>
<A NAME="IDX5165"></A>
<A NAME="IDX5166"></A>
<P><STRONG>Purpose</STRONG>
<P>Converts a character string into an octal key
<P><STRONG>Synopsis</STRONG>
<PRE><B>kas stringtokey -string</B> &lt;<VAR>password&nbsp;string</VAR>> [<B>-cell</B> &lt;<VAR>cell&nbsp;name</VAR>>] [<B>-help</B>]
<B>kas str -s</B> &lt;<VAR>password&nbsp;string</VAR>> [<B>-c</B> &lt;<VAR>cell&nbsp;name</VAR>>] [<B>-h</B>]
</PRE>
<P><STRONG>Description</STRONG>
<P>The <B>kas stringtokey</B> command converts the character string
specified with the <B>-string</B> argument into an octal string suitable
for use as an encryption key.
<P>The <B>kas</B> command interpreter generates the octal key by using an
encryption algorithm on the combination of the specified string and the name
of the local cell (as recorded in the local <B>/usr/vice/etc/ThisCell</B>
file). Use the <B>-cell</B> argument to convert a string into a key
appropriate for a cell other than the local one.
<P><STRONG>Cautions</STRONG>
<P>This command writes the key to the standard output stream, on which it can
possibly be intercepted by third parties. It is not very secure to use
the key in an actual Authentication Database entry.
<P><STRONG>Options</STRONG>
<DL>
<P><DT><B>-string
</B><DD>Specifies the character string to convert into an octal key.
<P><DT><B>-cell
</B><DD>Specifies the complete Internet domain name of the cell to combine with
the password string while generating the key. If this argument is
omitted, the <B>kas</B> command interpreter determines the name of the
local cell by consulting:
<UL>
<P><LI>First, the value of the environment variable AFSCELL.
<P><LI>Second, the cellname in the <B>/usr/vice/etc/ThisCell</B> file on the
local machine.
</UL>
<P><DT><B>-help
</B><DD>Prints the online help for this command. All other valid options
are ignored.
</DL>
<P><STRONG>Output</STRONG>
<P>The output is of the following form:
<PRE> Converting <VAR>password string</VAR> in realm '<VAR>cell_name</VAR>' yields key='<VAR>key</VAR>'.
</PRE>
<P><STRONG>Examples</STRONG>
<P>The following example shows the octal key equivalent of the string
<B>new_pswd</B> in the ABC Corporation cell.
<PRE> %<B> kas stringtokey new_pswd</B>
Converting new_pswd in realm 'ABC.COM' yields
key='\346\307\364\320\263\233\342\354'.
</PRE>
<P><STRONG>Privilege Required</STRONG>
<P>None, and no password is required.
<P><STRONG>Related Information</STRONG>
<P><A HREF="auarf032.htm#HDRCLI_THISCELL">ThisCell (client version)</A>
<P><A HREF="auarf181.htm#HDRKAS_INTRO">kas</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="auarf195.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="auarf197.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>