|
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-B20EE8A3-D7B2-5872-AF43-001A88C1A46E" xml:lang="en"><title>SignSIS</title><abstract><p>The <codeph>SignSIS</codeph> tool digitally signs Software Installation |
|
13 (SIS) files using a certificate and private key. </p></abstract><prolog><metadata><keywords/></metadata></prolog><refbody> |
|
14 <refsyn><title>Syntax</title> <p><userinput>signsis <parmname>[OPTIONS]</parmname> <cmdname><ARGS></cmdname> </userinput> </p> <p>The |
|
15 following table lists the options supported by the <codeph>SignSIS</codeph> tool. </p> <table id="GUID-CDA62104-777D-5874-AF0D-BF2B2085B689"> |
|
16 <tgroup cols="3"><colspec colname="col0"/><colspec colname="col1"/><colspec colname="col2"/> |
|
17 <thead> |
|
18 <row> |
|
19 <entry>Options</entry> |
|
20 <entry>Description</entry> |
|
21 <entry>Usage</entry> |
|
22 </row> |
|
23 </thead> |
|
24 <tbody> |
|
25 <row> |
|
26 <entry><p> <varname>-?</varname> </p> </entry> |
|
27 <entry><p>Displays help message. </p> </entry> |
|
28 <entry><p><userinput>signsis [-? | -h]</userinput> </p> </entry> |
|
29 </row> |
|
30 <row> |
|
31 <entry><p> <varname>-cd</varname> </p> </entry> |
|
32 <entry><p>Signs using a DSA algorithm </p> </entry> |
|
33 <entry><p><userinput>signsis [-cd] [-s] input [output [certificate key [passphrase] |
|
34 ] ]</userinput> </p> </entry> |
|
35 </row> |
|
36 <row> |
|
37 <entry><p> <varname>-cr</varname> </p> </entry> |
|
38 <entry><p>Signs using the RSA algorithm </p> </entry> |
|
39 <entry><p><userinput>signsis [-cr] [-s] input [output [certificate key [passphrase] |
|
40 ] ]</userinput> </p> </entry> |
|
41 </row> |
|
42 <row> |
|
43 <entry><p> <varname>-i</varname> </p> </entry> |
|
44 <entry><p>Displays the Open SSL licence. </p> </entry> |
|
45 <entry><p><userinput>signsis [-i]</userinput> </p> </entry> |
|
46 </row> |
|
47 <row> |
|
48 <entry><p> <varname>-o</varname> </p> </entry> |
|
49 <entry><p>Extracts the signing information from a SIS file. </p> </entry> |
|
50 <entry><p><userinput>signsis [-o] input </userinput> </p> </entry> |
|
51 </row> |
|
52 <row> |
|
53 <entry><p> <varname>-p</varname> </p> </entry> |
|
54 <entry><p>Extracts the certificates from the SIS file. This option must be |
|
55 specified along with <varname>-o</varname> option. </p> </entry> |
|
56 <entry><p><userinput>signsis [-o[-p]] input </userinput> </p> </entry> |
|
57 </row> |
|
58 <row> |
|
59 <entry><p> <varname>-s</varname> </p> </entry> |
|
60 <entry><p>Signs SIS file (requires SIS file, certificate, key and passphrase) </p> </entry> |
|
61 <entry><p><userinput>signsis [-s] input [output [certificate key [passphrase] |
|
62 ] ]</userinput> </p> </entry> |
|
63 </row> |
|
64 <row> |
|
65 <entry><p> <varname>-u</varname> </p> </entry> |
|
66 <entry><p>Removes most recent signature from SIS file. </p> </entry> |
|
67 <entry><p><userinput>signsis [-u] input [output [certificate key [passphrase] |
|
68 ] ]</userinput> </p> </entry> |
|
69 </row> |
|
70 <row> |
|
71 <entry><p> <varname>-v</varname> </p> </entry> |
|
72 <entry><p>Displays verbose output. </p> </entry> |
|
73 <entry><p><userinput>signsis [-v]</userinput> </p> </entry> |
|
74 </row> |
|
75 </tbody> |
|
76 </tgroup> |
|
77 </table> <p>The following table lists the arguments to be specified with the <codeph>SignSIS</codeph> tool. </p> <table id="GUID-6036A656-B714-57A8-97A7-602831FEFE62"> |
|
78 <tgroup cols="2"><colspec colname="col0"/><colspec colname="col1"/> |
|
79 <thead> |
|
80 <row> |
|
81 <entry>Arguments</entry> |
|
82 <entry>Description</entry> |
|
83 </row> |
|
84 </thead> |
|
85 <tbody> |
|
86 <row> |
|
87 <entry><p> <varname>input</varname> </p> </entry> |
|
88 <entry><p>Specifies the SIS file to be signed, unsigned or investigated. </p> </entry> |
|
89 </row> |
|
90 <row> |
|
91 <entry><p> <varname>output</varname> </p> </entry> |
|
92 <entry><p>Specifies the SIS file generated by signing or unsigning. </p> </entry> |
|
93 </row> |
|
94 <row> |
|
95 <entry><p> <varname>certificate</varname> </p> </entry> |
|
96 <entry><p>Specifies the certificate file used for signing. </p> </entry> |
|
97 </row> |
|
98 <row> |
|
99 <entry><p> <varname>key</varname> </p> </entry> |
|
100 <entry><p>Specifies private key file of the certificate. </p> </entry> |
|
101 </row> |
|
102 <row> |
|
103 <entry><p> <varname>passphrase</varname> </p> </entry> |
|
104 <entry><p>Specifies passphrase of the private key file. </p> </entry> |
|
105 </row> |
|
106 </tbody> |
|
107 </tgroup> |
|
108 </table> <note>Before digitally signing a SIS file, <codeph>SignSIS</codeph> prompts |
|
109 for a password to access the private key file if required.</note></refsyn> |
|
110 </refbody><related-links> |
|
111 <link href="GUID-43B4B4E7-413E-5D18-811C-4B9E38CDEB69.dita"><linktext>PKG Format</linktext> |
|
112 </link> |
|
113 <link href="GUID-4BDC9F63-83A1-53A5-91A0-B092AA821755.dita"><linktext>MakeSIS</linktext> |
|
114 </link> |
|
115 <link href="GUID-AA555CC1-5CFF-5609-9191-8970F32BA255.dita"><linktext>CreateSIS</linktext> |
|
116 </link> |
|
117 <link href="GUID-03BBEA31-3266-5B1C-9017-4EE7EA4AF1A8.dita"><linktext>Creating |
|
118 and Signing an Installation File</linktext></link> |
|
119 </related-links></reference> |