=head1 NAME

kas stringtokey - Converts a character string into an octal key

=head1 SYNOPSIS

kas stringtokey B<-string> I<password string>  [B<-cell> I<cell name>]  [B<-help>]

kas str B<-s> I<password string>  [B<-c> I<cell name>]  [B<-h>]

=head1 DESCRIPTION

The C<kas stringtokey> command converts the character string specified
with the B<-string> argument into an octal string suitable for use as an
encryption key.

The C<kas> 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> file). Use the B<-cell> argument to convert a
string into a key appropriate for a cell other than the local one.

=head1 OPTIONS

=over 4

=item B<-string> I<password string>

Specifies the character string to convert into an octal key.

=item B<-cell> I<cell name>

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 C<kas> command interpreter
determines the name of the local cell by consulting:

=over

=item *

First, the value of the environment variable AFSCELL.

=item *

Second, the cellname in the B</usr/vice/etc/ThisCell> file on
the local machine.

=back

=item B<-help>

Prints the online help for this command. All other valid
options are ignored.

=back

=head1 OUTPUT

The output is of the following form:

Converting I<password string> in realm 'I<cell_name>' yields key='I<key>'.

=head1 EXAMPLES

The following example shows the octal key equivalent of the string
B<new_pswd> in the ABC Corporation cell.

B<    kas stringtokey new_pswd>
   Converting new_pswd in realm 'ABC.COM' yields
       key='\346\307\364\320\263\233\342\354'.

=head1 PRIVILEGE REQUIRED

None, and no password is required.

=head1 CAVEATS

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.

=head1 COPYRIGHT

IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.

Converted from html to pod by Alf Wachsmann <alfw@slac.stanford.edu>, 2003,
and Elizabeth Cassell <e_a_c@mailsnare.net>, 2004,
Stanford Linear Accelerator Center, a department of Stanford University.

=head1 SEE ALSO

L<ThisCell_client_version(1)>,
L<kas(1)>

=cut
