Symbian3/PDK/Source/GUID-EA864824-91E3-5A08-A316-1CE50273EF50.dita
author Dominic Pinkman <Dominic.Pinkman@Nokia.com>
Tue, 30 Mar 2010 11:56:28 +0100
changeset 5 f345bda72bc4
parent 3 46218c8b8afa
child 14 578be2adaf3e
permissions -rw-r--r--
Week 12 contribution of PDK documentation_content. See release notes for details. Fixes Bug 2054, Bug 1583, Bug 381, Bug 390, Bug 463, Bug 1897, Bug 344, Bug 1319, Bug 394, Bug 1520, Bug 1522, Bug 1892"

<?xml version="1.0" encoding="utf-8"?>
<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
<!-- This component and the accompanying materials are made available under the terms of the License 
"Eclipse Public License v1.0" which accompanies this distribution, 
and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->
<!-- Initial Contributors:
    Nokia Corporation - initial contribution.
Contributors: 
-->
<!DOCTYPE reference
  PUBLIC "-//OASIS//DTD DITA Reference//EN" "reference.dtd">
<reference id="GUID-EA864824-91E3-5A08-A316-1CE50273EF50" xml:lang="en"><title>Keytool
Reference</title><prolog><metadata><keywords/></metadata></prolog><refbody>
<section><p>Type <codeph>keytool</codeph> at the command prompt to get a list
of the commands that you can use with the tool. </p> <p>To access more information
about a specific command, the <codeph>list</codeph> command for instance,
just type: </p> <p><userinput>keytool –h list</userinput> </p> </section>
<refsyn><title>Syntax</title> <p><userinput>keytool <parmname>[OPTIONS]</parmname> </userinput> </p> <p>The
following is a summary of commands available to use with <codeph>keytool</codeph>. </p> <table id="GUID-A4E69FEC-74FD-5F2B-8C0B-CE523E252ADD">
<tgroup cols="3"><colspec colname="col0"/><colspec colname="col1"/><colspec colname="col2"/>
<thead>
<row>
<entry>Full command</entry>
<entry>Shortened command</entry>
<entry>Description</entry>
</row>
</thead>
<tbody>
<row>
<entry><p> <codeph>-liststores</codeph>  </p> </entry>
<entry><p> <codeph>-ls</codeph>  </p> </entry>
<entry><p>Lists the available key store implementations. </p> </entry>
</row>
<row>
<entry><p> <codeph>-list</codeph>  </p> </entry>
<entry><p> <codeph>-l</codeph>  </p> </entry>
<entry><p>Displays the contents of the key store. </p> </entry>
</row>
<row>
<entry><p> <codeph>-import</codeph>  </p> </entry>
<entry><p> <codeph>-i</codeph>  </p> </entry>
<entry><p>Imports private keys in the store. </p> </entry>
</row>
<row>
<entry><p> <codeph>-remove</codeph>  </p> </entry>
<entry><p> <codeph>-r</codeph>  </p> </entry>
<entry><p>Removes a key from the key store. </p> </entry>
</row>
<row>
<entry><p> <codeph>-setuser</codeph>  </p> </entry>
<entry><p> <codeph>-s</codeph>  </p> </entry>
<entry><p>Set a user. </p> </entry>
</row>
<row>
<entry><p> <codeph>-setallusers</codeph>  </p> </entry>
<entry><p> <codeph>-a</codeph>  </p> </entry>
<entry><p>Set multiple users. </p> </entry>
</row>
<row>
<entry><p> <codeph>-setmanager</codeph>  </p> </entry>
<entry><p> <codeph>-m</codeph>  </p> </entry>
<entry><p>Set a manager. </p> </entry>
</row>
<row>
<entry><p> <codeph>-removeuser</codeph>  </p> </entry>
<entry><p> <codeph>-ru</codeph>  </p> </entry>
<entry><p>Remove a user. </p> </entry>
</row>
</tbody>
</tgroup>
</table> <note><p> Long commands, for example, <codeph>liststores</codeph>, <codeph>list</codeph> and <codeph>setuser</codeph> are
not case-sensitive but short commands, for example <codeph>-ls</codeph>, <codeph>-l</codeph>, <codeph>-a</codeph>,<codeph>-s</codeph> and <codeph>-m</codeph> are case sensitive. </p></note> <p>If the commands are given
incorrectly or in the wrong sequence, for example <codeph>keytool -store -l</codeph> or <codeph>keytool
-i -l</codeph>, the tool displays the default general help command. </p> <p>In
interactive mode, any command called with the <codeph>-p</codeph> option displays
full details and waits for key input. In non-interactive mode, the option
is omitted. </p> </refsyn>
<example id="GUID-51271CD7-F45F-5D28-82A0-20E94C00C3D2"><title>Example</title> <p>To
read commands from an “inputfile” and give the output in “outputfile”, use
the following command: </p> <p><userinput>keytool &lt;inputfile&gt; &lt;outputfile&gt;</userinput> </p> <p>The
file name should be mentioned with the path. If the tool cannot open the “inputfile”
or cannot create the output file, it will turn to interactive mode and display
the general help command. The input file can contain multiple commands but
each command should be separated by a new line character. </p> </example>
</refbody><related-links>
<link href="GUID-AC2520A3-EB24-5BED-88D0-0D7D1C4D1C11.dita"><linktext>keytool Overview</linktext>
</link>
<link href="GUID-B1FE58B4-58CC-57CB-8BB2-43CD781BF41A.dita"><linktext>keytool Tutorials</linktext>
</link>
</related-links></reference>