|
1 <?xml version="1.0" encoding="utf-8"?> |
|
2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. --> |
|
3 <!-- This component and the accompanying materials are made available under the terms of the License |
|
4 "Eclipse Public License v1.0" which accompanies this distribution, |
|
5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". --> |
|
6 <!-- Initial Contributors: |
|
7 Nokia Corporation - initial contribution. |
|
8 Contributors: |
|
9 --> |
|
10 <!DOCTYPE reference |
|
11 PUBLIC "-//OASIS//DTD DITA Reference//EN" "reference.dtd"> |
|
12 <reference id="GUID-4462E8C8-CF27-5F3B-ACE3-4213DA6C377C" xml:lang="en"><title>certtool |
|
13 Reference</title><prolog><metadata><keywords/></metadata></prolog><refbody> |
|
14 <section><p>Type <codeph>certtool</codeph> at the command prompt to get a |
|
15 list of commands that you can use with the tool. </p> <p>To access more information |
|
16 about a specific command, the <codeph>list</codeph> command for example, type: </p> <p><userinput>certtool |
|
17 –h list</userinput> </p> </section> |
|
18 <refsyn><title>Syntax</title> <p><userinput>certtool<parmname>[OPTIONS]</parmname> </userinput> </p> <p>The |
|
19 following is a summary of commands available to use with certool. </p> <table id="GUID-4A334325-33FD-5CEE-80FB-29242F6CCC31"> |
|
20 <tgroup cols="3"><colspec colname="col0"/><colspec colname="col1"/><colspec colname="col2"/> |
|
21 <thead> |
|
22 <row> |
|
23 <entry>Full command</entry> |
|
24 <entry>Shortened command</entry> |
|
25 <entry>Description</entry> |
|
26 </row> |
|
27 </thead> |
|
28 <tbody> |
|
29 <row> |
|
30 <entry><p> <codeph>-liststores </codeph> </p> </entry> |
|
31 <entry><p> <codeph>-ls</codeph> </p> </entry> |
|
32 <entry><p>Lists the available certstore implementations. </p> </entry> |
|
33 </row> |
|
34 <row> |
|
35 <entry><p> <codeph>-list</codeph> </p> </entry> |
|
36 <entry><p> <codeph> -l</codeph> </p> </entry> |
|
37 <entry><p>Lists the content of the certstore. </p> </entry> |
|
38 </row> |
|
39 <row> |
|
40 <entry><p> <codeph>-import </codeph> </p> </entry> |
|
41 <entry><p> <codeph>-i</codeph> </p> </entry> |
|
42 <entry><p>Imports certificates in the certstore. </p> </entry> |
|
43 </row> |
|
44 <row> |
|
45 <entry><p> <codeph>-remove </codeph> </p> </entry> |
|
46 <entry><p> <codeph>-r</codeph> </p> </entry> |
|
47 <entry><p>Removes a certificate from the certstore. </p> </entry> |
|
48 </row> |
|
49 <row> |
|
50 <entry><p> <codeph>-addapps </codeph> </p> </entry> |
|
51 <entry><p> <codeph>-a</codeph> </p> </entry> |
|
52 <entry><p>Adds applications to those a certificate is trusted for. </p> </entry> |
|
53 </row> |
|
54 <row> |
|
55 <entry><p> <codeph>-setapps</codeph> </p> </entry> |
|
56 <entry><p><codeph>-s </codeph></p> </entry> |
|
57 <entry><p>Sets the applications for which a certificate is trusted, for example, |
|
58 software install, TLS and so on.</p> </entry> |
|
59 </row> |
|
60 <row> |
|
61 <entry><p> <codeph>-removeapps</codeph> </p> </entry> |
|
62 <entry><p> <codeph>n/a</codeph> </p> </entry> |
|
63 <entry><p>Removes applications from those a certificate is trusted for. </p> </entry> |
|
64 </row> |
|
65 </tbody> |
|
66 </tgroup> |
|
67 </table> </refsyn> |
|
68 <section><note>Long commands, for example <codeph>liststores</codeph>, <codeph>list</codeph>, <codeph>addapps</codeph>, <codeph>setapps</codeph> and <codeph>removeapps</codeph> are not case-sensitive but short commands, for example <codeph>-ls</codeph>, <codeph>-l</codeph>, <codeph>-a</codeph>,<codeph>-s</codeph> and <codeph>-rk</codeph> are case sensitive.</note> <p>If the |
|
69 commands are given incorrectly or in the wrong sequence, for example <codeph>certtool |
|
70 -store -l</codeph> or <codeph>certtool -i -l</codeph>, the tool displays the |
|
71 default general help command. </p> <p>In interactive mode, any command called |
|
72 with the <codeph>-p</codeph> option, displays screen full of details and waits |
|
73 for key input. In non-interactive mode, the option is omitted. </p> </section> |
|
74 <example id="GUID-6E87B789-3F2D-5306-987E-195ECA603DFF"><title>certtool example</title> <p>To |
|
75 read commands from an “inputfile” and give the output in “outputfile”, use |
|
76 the following command: </p> <p><userinput>Certool <inputfile> <outputfile></userinput> </p> <p>The |
|
77 file name should be mentioned with the path. If the tool cannot open the “inputfile” |
|
78 or cannot create the output file, it will turn to interactive mode and display |
|
79 the general help command. The input file can contain multiple commands but |
|
80 each command should be separated by a new line character. </p> </example> |
|
81 </refbody><related-links> |
|
82 <link href="GUID-9F1EF48F-8AA7-5235-B96C-4A02CAC0422F.dita"><linktext>certtool |
|
83 Overview</linktext></link> |
|
84 <link href="GUID-8A80DD04-075D-5CF2-9A70-F6DDDD7D54BC.dita"><linktext>certtool |
|
85 Tutorials</linktext></link> |
|
86 </related-links></reference> |