<?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 concept
  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<concept id="GUID-88EC0D74-5595-5FA8-B7BA-B914CC8022FB" xml:lang="en"><title>Listing
Contents of Certificate Stores</title><prolog><metadata><keywords/></metadata></prolog><conbody>
<p>The list command is used to display the content of the certificate store.
It can be used to display the overall content of all certstore implementations,
to display the content of a specific certstore implementation, or to display
details about a specific certificate if its label is known. </p>
<p><b>Listing the content of all certstore implementations </b> </p>
<p>To see all the certificates available on the device, use the command: </p>
<p><userinput>certtool -list</userinput> </p>
<p>The output, depending on the actual certificates present on the device
will look similar to: </p>
<codeblock id="GUID-BB1AB0FA-AE85-50B4-9A9B-2E3EB8A5BAA5" xml:space="preserve">Store Label: Software certificate store
Root5CA is a X509 format which is a Root (CA) type 

Store Label: Software certificate store
SymbianDSACA is a X509 format which is a Root (CA) type 

Store Label: Software certificate store
SymbianRSACA is a X509 format which is a Root (CA) type</codeblock>
<p><b>Listing the content of a specific certstore implementation </b> </p>
<p>If only the content of a specific certstore implementation is to be retrieved,
you can restrict the list command to that implementation using the –store
option. Suppose the content of the certstore implementation with index 0 (see
the section <xref href="GUID-F6C20181-0F03-5B8A-B548-C81FF8824503.dita">Working
with multiple certstore implementations</xref> for details on how to list
the available certstore implementations) is to be retrieved, issue the command: </p>
<p><userinput>certtool –store 0 –list</userinput> </p>
<p>Depending on the content of the certstore implementation with index 0,
output similar to the following is displayed: </p>
<codeblock id="GUID-B8A8F3E9-AC86-537A-AD96-76B8298BCB13" xml:space="preserve">Symbian OS CertStore Manipulation Tool
Copyright (c) 2004-2009 Nokia Corporation and/or its subsidiary(-ies).  All rights reserved.
Label: TOCSP-Root5-RSA            Format: X509     Owner Type: Root (CA)
Issuer Name: TOCSP-Root5-RSA        Subject Name: TOCSP-Root5-RSA
Valid From: 13:52:28 Sun 26th Apr 2009 Valid Until: 13:52:28 Wed 25th Apr 2012
Trusted for Applications: SWInstall </codeblock>
<p>If you try to specify a non-existing certstore implementation an error
will occur, as shown: </p>
<codeblock id="GUID-433CCFEE-2AB6-5237-941E-9A8542E3892B" xml:space="preserve">Symbian OS CertStore Manipulation Tool
Copyright (c) 2004-2009 Nokia Corporation and/or its subsidiary(-ies).  All rights reserved.
The specified certstore implementation does not exist.
Error during list!
Error code KErrArgument.</codeblock>
<p><b>Providing certstore list based on owner type </b> </p>
<p>It is possible to display a list of certificates according to an owner
type. To do so, use the following command: </p>
<p><userinput>certtool -owner ca -list</userinput> </p>
<p>The output, depending on the actual certificates present on the device,
will look similar to: </p>
<codeblock id="GUID-E87CF5AA-F53B-586A-AAD0-FBB78CC97A2E" xml:space="preserve">Store Label: Software certificate store
Version: 1.00      Serial Number: 0      Manufacturer: Nokia Corporation  Store Type: Read only
    Label: Root5CA        Format: X509    Owner Type: Root (CA)
    Issuer Name: Root5-RSA        Subject Name: Root5-RSA
    Valid From  16:34:42 Wed  3rd Mar 2004    Valid Until 16:34:42 Sat  1st Mar 2014
    Trusted for Applications: SWInstall  

Store Label: Software certificate store
Version: 1.00      Serial Number: 0      Manufacturer: Nokia Corporation  Store Type: Read only
    Label: SymbianTestDSACA        Format: X509    Owner Type: Root (CA)
    Issuer Name: Nokia - DSA        Subject Name: Nokia - DSA
    Valid From  14:37:11 Sun  18th Apr 2004    Valid Until 14:37:11 Mon  21st Sep 2020
    Trusted for Applications: SWInstall  SWInstallOCSP  

Store Label: Software certificate store
Version: 1.00      Serial Number: 0      Manufacturer: Nokia Corporation  Store Type: Read only
    Label: SymbianTestRSACA        Format: X509    Owner Type: Root (CA)
    Issuer Name: Nokia - RSA        Subject Name: Nokia - RSA
    Valid From  14:36:14 Sun  18th Apr 2004    Valid Until 14:36:14 Mon  21st Sep 2020
    Trusted for Applications: SWInstall  SWInstallOCSP  </codeblock>
<p><b>Displaying information about a certificate </b> </p>
<p>It is possible to display information about a specific certificate of which
the label is known. To display information about a certificate with label
“…”, issue the command: </p>
<p><userinput>certtool –list “Limited Liability”</userinput> </p>
<p>Remember that labels are case sensitive. The output should be similar to: </p>
<codeblock id="GUID-29C4953A-F015-5EA6-B65A-95739D58525D" xml:space="preserve">Symbian OS CertStore Manipulation Tool
Copyright (c) 2004-2009 Nokia Corporation and/or its subsidiary(-ies).  All rights reserved.
Label: Limited Liability        Format: WTLS     Owner Type: Root (CA) 
Issuer Name: Limited Liability    Subject Name: Limited Liability
Valid From: 15:13:18 Tue 29th Feb 2000 Valid Until: 15:43:18 Sat 29th Feb 2020
Trusted for Applications: </codeblock>
<p>If no certificate in the certstore corresponds to the given label, the
following error will occur: </p>
<codeblock id="GUID-33005CEE-8A77-5188-A95C-B9BF95D2E2CB" xml:space="preserve">Symbian OS CertStore Manipulation Tool
Copyright (c) 2004-2009 Nokia Corporation and/or its subsidiary(-ies).  All rights reserved.
Cannot find the specified certificate.</codeblock>
<p><b>Providing detailed output of a certificate </b> </p>
<p>It is possible to display detailed information about a specific certificate
of which the label is known. To do so, use the command: </p>
<p><userinput>certtool –list -d</userinput> </p>
<p>The output, depending on the actual certificates present on the device,
will look similar to: </p>
<codeblock id="GUID-D6A9AB62-6452-51EA-8C3A-F239FF85711C" xml:space="preserve">Store Label: Software certificate store
Version: 1.00      Serial Number: 0      Manufacturer: Nokia Corporation  Store Type: Read only
    Label: Root5CA        Format: X509    Owner Type: Root (CA)
    Issuer Name: Root5-RSA        Subject Name: Root5-RSA
    Valid From  16:34:42 Wed  3rd Mar 2004    Valid Until 16:34:42 Sat  1st Mar 2014
    Trusted for Applications: SWInstall  

Store Label: Software certificate store
Version: 1.00      Serial Number: 0      Manufacturer: Nokia Corporation  Store Type: Read only
    Label: SymbianTestDSACA        Format: X509    Owner Type: Root (CA)
    Issuer Name: Symbian Test - DSA        Subject Name: Symbian Test - DSA
    Valid From  14:37:11 Sun  18th Apr 2004    Valid Until 14:37:11 Mon  21st Sep 2020
    Trusted for Applications: SWInstall  SWInstallOCSP  </codeblock>
</conbody><related-links>
<link href="GUID-B946BDF0-C5D8-57E2-9D05-7BE134AD032E.dita#GUID-B946BDF0-C5D8-57E2-9D05-7BE134AD032E/GUID-DD7D5D55-A2F1-54FB-AA38-B4A7C920B6A6">
<linktext>Manipulating Applicability and Trust Settings for a Certificate</linktext>
</link>
<link href="GUID-DCC2060B-BFEC-5ECF-8154-5AE9C8513F75.dita"><linktext>Removing
Certificates</linktext></link>
<link href="GUID-6CDB86E4-89BB-5266-8CEC-7353B664D638.dita"><linktext>Importing
Certificates</linktext></link>
</related-links></concept>