001 /* Copyright (c) 2002 Graz University of Technology. All rights reserved.
002 *
003 * Redistribution and use in source and binary forms, with or without
004 * modification, are permitted provided that the following conditions are met:
005 *
006 * 1. Redistributions of source code must retain the above copyright notice,
007 * this list of conditions and the following disclaimer.
008 *
009 * 2. Redistributions in binary form must reproduce the above copyright notice,
010 * this list of conditions and the following disclaimer in the documentation
011 * and/or other materials provided with the distribution.
012 *
013 * 3. The end-user documentation included with the redistribution, if any, must
014 * include the following acknowledgment:
015 *
016 * "This product includes software developed by IAIK of Graz University of
017 * Technology."
018 *
019 * Alternately, this acknowledgment may appear in the software itself, if
020 * and wherever such third-party acknowledgments normally appear.
021 *
022 * 4. The names "Graz University of Technology" and "IAIK of Graz University of
023 * Technology" must not be used to endorse or promote products derived from
024 * this software without prior written permission.
025 *
026 * 5. Products derived from this software may not be called
027 * "IAIK PKCS Wrapper", nor may "IAIK" appear in their name, without prior
028 * written permission of Graz University of Technology.
029 *
030 * THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESSED OR IMPLIED
031 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
032 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
033 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE LICENSOR BE
034 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY,
035 * OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
036 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
037 * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
038 * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
039 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
040 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
041 * POSSIBILITY OF SUCH DAMAGE.
042 */
043
044 package demo.pkcs.pkcs11;
045
046 import java.io.ByteArrayOutputStream;
047 import java.io.FileInputStream;
048 import java.io.IOException;
049 import java.io.InputStream;
050 import java.io.PrintWriter;
051
052 import iaik.pkcs.pkcs11.Info;
053 import iaik.pkcs.pkcs11.InitializeArgs;
054 import iaik.pkcs.pkcs11.Module;
055 import iaik.pkcs.pkcs11.MutexHandler;
056
057
058
059 /**
060 * This demo program tries to call initialize with some arguments.
061 *
062 * @author <a href="mailto:Karl.Scheibelhofer@iaik.at"> Karl Scheibelhofer </a>
063 * @version 0.1
064 * @invariants
065 */
066 public class InitArgs implements InitializeArgs {
067
068 static PrintWriter output_;
069
070 static {
071 try {
072 //output_ = new PrintWriter(new FileWriter("GetInfo_output.txt"), true);
073 output_ = new PrintWriter(System.out, true);
074 } catch (Throwable thr) {
075 thr.printStackTrace();
076 output_ = new PrintWriter(System.out, true);
077 }
078 }
079
080 public static void main(String[] args) {
081 if ((args.length == 1) || (args.length == 2)){
082 try {
083 output_.println("################################################################################");
084 output_.println("load and initialize module \"" + args[0] + "\" using InitializeArgs");
085 output_.flush();
086 Module pkcs11Module = Module.getInstance(args[0]);
087 byte[] reservedParameter = (args.length >= 2) ? readStream(new FileInputStream(args[1])) : null;
088 InitializeArgs initArgs = new InitArgs(reservedParameter);
089 pkcs11Module.initialize(initArgs);
090
091 Info info = pkcs11Module.getInfo();
092 output_.println(info);
093 output_.println("################################################################################");
094 } catch (Throwable ex) {
095 ex.printStackTrace();
096 }
097 } else {
098 printUsage();
099 }
100 System.gc(); // to finalize and disconnect the pkcs11Module
101 }
102
103 protected static void printUsage() {
104 output_.println("InitArgs <PKCS#11 module name> [<file providing reserved parameter>]");
105 output_.println("e.g.: InitArgs slbck.dll");
106 }
107
108 /**
109 * Read the contents of the stream into a byte array. The stream is read
110 * until it returns EOF.
111 */
112 protected static byte[] readStream(InputStream in)
113 throws IOException
114 {
115 ByteArrayOutputStream bufferStream = new ByteArrayOutputStream(256); // initial size
116 int bytesRead;
117 byte[] buffer = new byte[256];
118 while((bytesRead = in.read(buffer)) >= 0) {
119 bufferStream.write(buffer, 0, bytesRead);
120 }
121 return bufferStream.toByteArray() ;
122 }
123
124 protected byte[] reservedParameter_;
125
126 public InitArgs(byte[] reservedParameter) {
127 reservedParameter_ = reservedParameter;
128 }
129
130 /**
131 * Get the handler object that handes mutex objects.
132 *
133 * @return The mutex handler object or null, if there is none set.
134 * @preconditions
135 * @postconditions
136 */
137 public MutexHandler getMutexHandler() {
138 output_.println("getMutexHandler() called");
139 return null ;
140 }
141
142 /**
143 * Checks, if the library is not allowed to create operating system threads.
144 *
145 * @return True, if the library is not allowed to create operating system
146 * threads; false, otherwise.
147 * @preconditions
148 * @postconditions
149 */
150 public boolean isLibraryCantCreateOsThreads() {
151 output_.println("isLibraryCantCreateOsThreads() called");
152 return false ;
153 }
154
155 /**
156 * Checks, if the library is allowed to use locking mechanisms of the
157 * operating system.
158 *
159 * @return True, if the library is allowed to use locking mechanisms of the
160 * operating system.
161 * @preconditions
162 * @postconditions
163 */
164 public boolean isOsLockingOk() {
165 output_.println("isOsLockingOk() called");
166 return true ;
167 }
168
169 /**
170 * Get the reserved parameter. This is always null as of version 2.11 of
171 * PKCS#11.
172 *
173 * @return null as of version 2.11 of PKCS#11.
174 * @preconditions
175 * @postconditions (result == null)
176 */
177 public java.lang.Object getReserved() {
178 output_.println("getReserved() called");
179 return reservedParameter_ ;
180 }
181
182 }