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    }