pkcs11 0.2.4-x64-mingw32

data/.autotest

@@ -0,0 +1,23 @@
+# -*- ruby -*-
+
+require 'autotest/restart'
+
+# Autotest.add_hook :initialize do |at|
+#   at.extra_files << "../some/external/dependency.rb"
+#
+#   at.libs << ":../some/external"
+#
+#   at.add_exception 'vendor'
+#
+#   at.add_mapping(/dependency.rb/) do |f, _|
+#     at.files_matching(/test_.*rb$/)
+#   end
+#
+#   %w(TestA TestB).each do |klass|
+#     at.extra_class_map[klass] = "test/test_misc.rb"
+#   end
+# end
+
+# Autotest.add_hook :run_command do |at|
+#   system "rake build"
+# end

data/.yardopts

@@ -0,0 +1 @@
+--title "PKCS#11/Ruby Interface" --no-private lib/**/*.rb ext/*.c ext/*.doc

data/History.txt

@@ -0,0 +1,57 @@
+=== 0.2.4 / 2013-04-05
+
+* Build and package binary x64 version for Windows in addition to x86.
+* Allow to use big positive numbers (>0x80000000) in 32bit mode (Anton Fedorov)
+
+=== 0.2.3 / 2012-01-25
+
+* fix C_WaitForSlotEvent to be a Library- instead of a Slot-method
+* allow :sw/:hsm to ProtectServer::Library#load_library in the same way as #initialize
+* allow Hash argument to Library#C_Initialize in the same way as #initialize
+
+=== 0.2.2 / 2011-12-12
+
+* add ability to change PKCS11 base methods in order to use vendor defined attributes, return codes and mechanisms
+* restructured C code to avoid duplicated code in vendor extension gems
+* add gem pkcs11_protect_server to cover many ProtectServer specific extensions
+* update test/helper to find newer libsoftokn3
+* add task for generating combined docs of PKCS11 and PKCS11::ProtectServer
+* changed PKCS11#slots to return all slots of the device by default
+* add ability to set/get multiple attributes with Object#[] and Object#[]=
+
+=== 0.2.1 / 2011-04-21
+
+* add some more CK_ULONG and CK_BOOL attributes
+* add array of structs accessor used in CK_OTP_PARAMS
+* refactured inc-file generation
+* bit more documentation
+* bugfix: print CKR-values as unsigned long
+* bugfix: Slot#mechanism_info didn't work with Symbol
+
+
+=== 0.2.0 / 2011-01-18
+
+* switch API documentation to YARD instead of RDOC
+* add Ruby classes for all PKCS#11 structures
+* add CopyObject
+* add Get/SetOperationState
+* use distinct Exception classes for different error codes
+* PKCS#11 function calls don't block other ruby threads any more (only Ruby 1.9, Rubinius)
+* don't wrap mechanisms any more (GetMechanismList returns plain Integers now)
+* choose structs as mechanism parameter based on the given mechanism
+* autogenerate many constants from C header files
+* finer graded control over library loading
+* several bug fixes
+* more unit tests
+* more documentation
+
+
+=== 0.1.0 / 2010-05-03
+
+* first rubygem version
+* Most functions and operations of PKCS#11 v2.2 are implemented.
+* The library is based on the work of Ryosuke Kutsuna and GOTOU Yuuzou, but extended in the following ways:
+  - running on Unix and Windows OS
+  - downloadable as rubygem in source and win32 binary version
+  - new API, it's more ruby-like and well documented
+  - most functions are unit tested with help of softokn library

data/MIT-LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2008 Ryosuke Kutsuna <ryosuke@deer-n-horse.jp>
+Copyright (c) 2008 GOTOU Yuuzou <gotoyuzo@notwork.org>
+Copyright (c) 2010 Lars Kanis <kanis@comcard.de>
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/Manifest.txt

@@ -0,0 +1,57 @@
+.autotest
+.gemtest
+.yardopts
+History.txt
+MIT-LICENSE
+Manifest.txt
+README.rdoc
+Rakefile
+ext/extconf.rb
+ext/generate_constants.rb
+ext/generate_structs.rb
+ext/generate_thread_funcs.rb
+ext/include/cryptoki.h
+ext/include/ct-kip.h
+ext/include/otp-pkcs11.h
+ext/include/pkcs-11v2-20a3.h
+ext/include/pkcs11.h
+ext/include/pkcs11f.h
+ext/include/pkcs11t.h
+ext/pk11.c
+ext/pk11.h
+ext/pk11_const.c
+ext/pk11_const_macros.h
+ext/pk11_struct_macros.h
+ext/pk11_version.h
+lib/pkcs11.rb
+lib/pkcs11/extensions.rb
+lib/pkcs11/helper.rb
+lib/pkcs11/library.rb
+lib/pkcs11/object.rb
+lib/pkcs11/session.rb
+lib/pkcs11/slot.rb
+pkcs11_protect_server/.gemtest
+pkcs11_protect_server/.yardopts
+pkcs11_protect_server/Manifest.txt
+pkcs11_protect_server/README_PROTECT_SERVER.rdoc
+pkcs11_protect_server/Rakefile
+pkcs11_protect_server/ext/extconf.rb
+pkcs11_protect_server/ext/generate_constants.rb
+pkcs11_protect_server/ext/generate_structs.rb
+pkcs11_protect_server/ext/pk11s.c
+pkcs11_protect_server/lib/pkcs11_protect_server.rb
+pkcs11_protect_server/lib/pkcs11_protect_server/extensions.rb
+pkcs11_protect_server/test/helper.rb
+pkcs11_protect_server/test/test_pkcs11_protect_server.rb
+pkcs11_protect_server/test/test_pkcs11_protect_server_crypt.rb
+test/fixtures/softokn/cert8.db
+test/fixtures/softokn/key3.db
+test/fixtures/softokn/secmod.db
+test/helper.rb
+test/test_pkcs11.rb
+test/test_pkcs11_crypt.rb
+test/test_pkcs11_object.rb
+test/test_pkcs11_session.rb
+test/test_pkcs11_slot.rb
+test/test_pkcs11_structs.rb
+test/test_pkcs11_thread.rb

data/README.rdoc

@@ -0,0 +1,205 @@
+{<img src="https://travis-ci.org/larskanis/pkcs11.png?branch=master" alt="Build Status" />}[https://travis-ci.org/larskanis/pkcs11]
+
+= PKCS #11/Ruby Interface
+
+* Homepage: http://github.com/larskanis/pkcs11
+* API documentation: http://pkcs11.rubyforge.org/pkcs11/frames.html
+
+This module allows Ruby programs to interface with "RSA Security Inc.
+PKCS #11 Cryptographic Token Interface (Cryptoki)".
+PKCS #11 is the de-facto standard to access cryptographic devices.
+You must have a PKCS #11 v2.20 implementation library installed in
+order to use this module. Tested implementations of PKCS#11 librarys
+include:
+* OpenSC[http://www.opensc-project.org] supported Smart Cards
+* Safenet[http://www.safenet-inc.com] - Protect Server HSMs
+* Mozilla_Soft_Token[https://developer.mozilla.org/en/PKCS11] which comes with every firefox installation
+
+This module works on the Unix like operating systems and win32.
+
+== Installation
+
+  gem install pkcs11
+
+This installs the PKCS#11 extension either by compiling (Unix) or by using the precompiled gem for Win32.
+
+== Usage
+Cryptoki has a reputation to be complicated to implement and use.
+While this seems to be true for C, it shouldn't for Ruby.
+
+* {PKCS11.open} opens a PKCS#11 Unix *.so file or Windows-DLL with a suitable PKCS #11 implementation
+  and returns a {PKCS11::Library}.
+* {PKCS11::Library#slots} returns a list of {PKCS11::Slot} for all slots accessable by the library.
+* {PKCS11::Slot#open} opens a {PKCS11::Session} which is used for object handling
+  and cryptographic operations.
+* {PKCS11::Object} represents a key, data or certificate object.
+* all constants defined in PKCS#11 v2.20 are available in the module {PKCS11}
+  and contain the associated Integer value (CKA_KEY_TYPE, CKK_AES, CKM_SHA_1 etc.)
+* also all PKCS#11 v2.20 structs are available in the module {PKCS11} as proper ruby classes
+  ({PKCS11::CK_VERSION}, {PKCS11::CK_OTP_PARAMS} etc.)
+
+=== Example
+  require "rubygems"
+  require "pkcs11"
+  include PKCS11
+
+  pkcs11 = PKCS11.open("/path/to/pkcs11.so")
+  p pkcs11.info  # => #<PKCS11::CK_INFO cryptokiVersion=...>
+  pkcs11.active_slots.first.open do |session|
+    session.login(:USER, "1234")
+    secret_key = session.generate_key(:DES2_KEY_GEN,
+      :ENCRYPT=>true, :DECRYPT=>true, :SENSITIVE=>true, :TOKEN=>true, :LABEL=>'my key')
+    cryptogram = session.encrypt( {:DES3_CBC_PAD=>"\0"*8}, secret_key, "some plaintext")
+    session.logout
+  end
+
+This opens a {PKCS11::Library PKCS#11 library} and prints it's {PKCS11::CK_INFO information block}.
+Then a {PKCS11::Session} to the first {PKCS11::Library#active_slots active slot} of the device is opened and
+a {PKCS11::Session#login login} is done on the user account. Now, a 112 bit DES3 {PKCS11::Object key object} is generated and
+some plaintext is {PKCS11::Session#encrypt encrypted} with it. A 8-byte zero IV is used. In many cases method parameters
+can be Integer (like PKCS11::CKA_LABEL) or, as in the sample, Symbol (:LABEL) which is internally
+converted.
+
+Many more usage examples can be found in the unit tests of the <tt>test</tt>
+directory of the project or gem.
+
+Detail information for the API specification is provided by RSA Security Inc.
+Please refer the URL: http://www.rsa.com/rsalabs/node.asp?id=2133. Browsable HTML
+can be found at http://www.cryptsoft.com/pkcs11doc.
+
+=== Vendor extensions
+Some vendors extend their libraries beyond the standard, in it's own way.
+This can be used by vendor specific packages:
+* Safenet ProtectServer: {file:pkcs11_protect_server/README_PROTECT_SERVER.rdoc}
+
+=== Threading
+
+The pkcs11 binding fully supports native, background Ruby threads.
+This of course only applies to Rubinius and Ruby 1.9.x or higher since
+earlier versions of Ruby do not support native threads.
+
+According to the standard, calling the Cryptoki library from multiple threads simultaneously,
+requires to open it with flag PKCS11::CKF_OS_LOCKING_OK.
+Application-supplied synchronization primitives
+(CreateMutex, DestroyMutex, LockMutex, UnlockMutex) are not supported.
+
+
+== Cross compiling for Windows
+
+Using rake-compiler a cross compiled pkcs11-gem can be build on a linux host for
+the win32 platform. There are no runtime dependencies to any but the standard Windows DLLs.
+
+Install mingw32. On a debian based system this should work:
+
+  apt-get install mingw32
+
+On MacOS X, if you have MacPorts installed:
+
+  port install i386-mingw32-gcc
+
+Install the rake-compiler:
+
+  gem install rake-compiler
+
+Download and cross compile ruby for win32:
+
+  rake-compiler cross-ruby VERSION=1.8.7-p352
+  rake-compiler cross-ruby VERSION=1.9.2-p290
+
+Download and cross compile pkcs11 for win32 (MRI 1.8+1.9 fat gem):
+
+  rake cross native gem RUBY_CC_VERSION=1.8.7:1.9.2
+
+If everything works, there should be pkcs11-VERSION-x86-mingw32.gem in the pkg
+directory.
+
+
+== ToDo
+
+* encoding support for Ruby 1.9
+* support for proprietary extensions of different vendors (done for Safenet-ProtectServer)
+* PKCS#11 v2.3
+
+== Development Status
+
+Any operation that is possible with PKCS#11 in C, should be likewise possible in Ruby.
+Otherwise it is considered as a bug in the binding.
+
+  STATE   FUNCTION               NOTE
+  ------  ---------------------  ----------------------------------------
+  DONE    C_Initialize
+  DONE    C_Finalize
+  DONE    C_GetInfo
+  DONE    C_GetFunctionList
+  DONE    C_GetSlotList
+  DONE    C_GetSlotInfo
+  DONE    C_GetTokenInfo
+  DONE    C_GetMechanismList
+  DONE    C_GetMechanismInfo
+  DONE    C_InitToken
+  DONE    C_InitPIN
+  DONE    C_SetPIN
+  DONE    C_OpenSession
+  DONE    C_CloseSession
+  DONE    C_CloseAllSessions
+  DONE    C_GetSessionInfo
+  DONE    C_GetOperationState
+  DONE    C_SetOperationState
+  DONE    C_Login
+  DONE    C_Logout
+  DONE    C_CreateObject
+  DONE    C_CopyObject
+  DONE    C_DestroyObject
+  DONE    C_GetObjectSize
+  DONE    C_GetAttributeValue
+  DONE    C_SetAttributeValue
+  DONE    C_FindObjectsInit
+  DONE    C_FindObjects
+  DONE    C_FindObjectsFinal
+  DONE    C_EncryptInit
+  DONE    C_Encrypt
+  DONE    C_EncryptUpdate
+  DONE    C_EncryptFinal
+  DONE    C_DecryptInit
+  DONE    C_Decrypt
+  DONE    C_DecryptUpdate
+  DONE    C_DecryptFinal
+  DONE    C_DigestInit
+  DONE    C_Digest
+  DONE    C_DigestUpdate
+  DONE    C_DigestKey
+  DONE    C_DigestFinal
+  DONE    C_SignInit
+  DONE    C_Sign
+  DONE    C_SignUpdate
+  DONE    C_SignFinal
+  DONE    C_SignRecoverInit
+  DONE    C_SignRecover
+  DONE    C_VerifyInit
+  DONE    C_Verify
+  DONE    C_VerifyUpdate
+  DONE    C_VerifyFinal
+  DONE    C_VerifyRecoverInit
+  DONE    C_VerifyRecover
+  DONE    C_DigestEncryptUpdate
+  DONE    C_DecryptDigestUpdate
+  DONE    C_SignEncryptUpdate
+  DONE    C_DecryptVerifyUpdate
+  DONE    C_GenerateKey
+  DONE    C_GenerateKeyPair
+  DONE    C_WrapKey
+  DONE    C_UnwrapKey
+  DONE    C_DeriveKey
+  DONE    C_SeedRandom
+  DONE    C_GenerateRandom
+  N/A     C_GetFunctionStatus    legacy function
+  N/A     C_CancelFunction       legacy function
+  DONE    C_WaitForSlotEvent
+
+== Authors
+* Ryosuke Kutsuna <ryosuke@deer-n-horse.jp>
+* GOTOU Yuuzou <gotoyuzo@notwork.org>
+* Lars Kanis <kanis@comcard.de>
+
+== Copying
+See MIT-LICENSE included in the package.

data/Rakefile

@@ -0,0 +1,111 @@
+# -*- coding: utf-8 -*-
+# -*- ruby -*-
+
+require 'rubygems'
+require 'hoe'
+require 'rake/extensiontask'
+require 'rbconfig'
+
+GENERATED_FILES = [
+  'ext/pk11_struct_impl.inc',
+  'ext/pk11_struct_def.inc',
+  'ext/pk11_const_def.inc',
+  'ext/pk11_struct.doc',
+  'ext/pk11_thread_funcs.h',
+  'ext/pk11_thread_funcs.c',
+]
+
+CLEAN.include GENERATED_FILES
+CLEAN.include 'lib/pkcs11_ext.so'
+CLEAN.include 'tmp'
+
+hoe = Hoe.spec 'pkcs11' do
+  developer('Ryosuke Kutsuna', 'ryosuke@deer-n-horse.jp')
+  developer('GOTOU Yuuzou', 'gotoyuzo@notwork.org')
+  developer('Lars Kanis', 'kanis@comcard.de')
+  extra_dev_deps << ['yard', '>= 0.6']
+  extra_dev_deps << ['rake-compiler', '>= 0.7']
+
+  self.urls = ['http://github.com/larskanis/pkcs11']
+  self.summary = 'PKCS#11 binding for Ruby'
+  self.description = 'This module allows Ruby programs to interface with "RSA Security Inc. PKCS #11 Cryptographic Token Interface (Cryptoki)".'
+
+  self.readme_file = 'README.rdoc'
+  self.extra_rdoc_files << self.readme_file << 'ext/pk11.c'
+  spec_extras[:extensions] = 'ext/extconf.rb'
+  spec_extras[:files] = File.read_utf("Manifest.txt").split(/\r?\n\r?/).reject{|f| f=~/^pkcs11_/ }
+  spec_extras[:files] += GENERATED_FILES
+  spec_extras[:has_rdoc] = 'yard'
+  self.rdoc_locations << "larskanis@rack.rubyforge.org:/var/www/gforge-projects/pkcs11/pkcs11/"
+end
+
+ENV['RUBY_CC_VERSION'] ||= '1.8.7:1.9.3:2.0.0'
+
+Rake::ExtensionTask.new('pkcs11_ext', hoe.spec) do |ext|
+  ext.ext_dir = 'ext'
+  ext.cross_compile = true                # enable cross compilation (requires cross compile toolchain)
+  ext.cross_platform = ['i386-mingw32', 'x64-mingw32']     # forces the Windows platform instead of the default one
+end
+
+file 'ext/extconf.rb' => ['ext/pk11_struct_def.inc', 'ext/pk11_thread_funcs.c']
+file 'ext/pk11_struct_def.inc' => 'ext/generate_structs.rb' do
+  sh "#{RbConfig::CONFIG['ruby_install_name']} ext/generate_structs.rb --def ext/pk11_struct_def.inc --impl ext/pk11_struct_impl.inc --doc ext/pk11_struct.doc ext/include/pkcs11t.h"
+end
+file 'ext/pk11_struct_impl.inc' => 'ext/pk11_struct_def.inc'
+file 'ext/pk11_struct.doc' => 'ext/pk11_struct_def.inc'
+
+file 'ext/pk11_const_def.inc' => 'ext/generate_constants.rb' do
+  sh "#{RbConfig::CONFIG['ruby_install_name']} ext/generate_constants.rb --const ext/pk11_const_def.inc ext/include/pkcs11t.h"
+end
+file 'ext/pk11.c' => ['ext/pk11_struct_def.inc', 'ext/pk11_struct_impl.inc', 'ext/pk11_struct_macros.h']
+file 'ext/pk11_const.c' => ['ext/pk11_const_def.inc', 'ext/pk11_const_macros.h']
+
+file 'ext/pk11_thread_funcs.h' => 'ext/generate_thread_funcs.rb' do
+  sh "#{RbConfig::CONFIG['ruby_install_name']} ext/generate_thread_funcs.rb --impl ext/pk11_thread_funcs.c --decl ext/pk11_thread_funcs.h ext/include/pkcs11f.h"
+end
+file 'ext/pk11_thread_funcs.c' => 'ext/pk11_thread_funcs.h'
+file 'ext/pk11.h' => 'ext/pk11_thread_funcs.h'
+
+task 'copy:pkcs11_ext:i386-mingw32:1.9.3' do |t|
+  sh "i686-w64-mingw32-strip -S tmp/i386-mingw32/stage/lib/1.9/pkcs11_ext.so"
+end
+task 'copy:pkcs11_ext:i386-mingw32:2.0.0' do |t|
+  sh "i686-w64-mingw32-strip -S tmp/i386-mingw32/stage/lib/2.0/pkcs11_ext.so"
+end
+task 'copy:pkcs11_ext:x64-mingw32:2.0.0' do |t|
+  sh "x86_64-w64-mingw32-strip -S tmp/x64-mingw32/stage/lib/2.0/pkcs11_ext.so"
+end
+
+
+task :docs_of_vendor_extensions do
+  Dir['pkcs11_*'].each do |dir|
+    chdir(dir) do
+      sh "rake doc_files"
+    end
+  end
+end
+
+desc "Generate static HTML documentation with YARD"
+task :yardoc=>['ext/pk11_struct.doc', :docs_of_vendor_extensions] do
+  sh "yardoc --title \"PKCS#11/Ruby Interface\" --no-private lib/**/*.rb ext/*.c ext/*.doc pkcs11_protect_server/lib/**/*.rb pkcs11_protect_server/ext/*.c pkcs11_protect_server/ext/*.doc - pkcs11_protect_server/README_PROTECT_SERVER.rdoc"
+end
+
+desc "Publish YARD to wherever you want."
+task :publish_yard => [:yardoc] do
+  rdoc_locations = hoe.rdoc_locations
+  warn "no rdoc_location values" if rdoc_locations.empty?
+  rdoc_locations.each do |dest|
+    sh %{rsync -av --delete doc/ #{dest}}
+  end
+end
+
+# RDoc-upload task for github (currently on rubyforge)
+#
+# require 'grancher/task'
+# Grancher::Task.new do |g|
+#   g.branch = 'gh-pages'         # alternatively, g.refspec = 'ghpages:/refs/heads/ghpages'
+#   g.push_to = 'origin'
+#   g.directory 'doc'
+# end
+
+# vim: syntax=ruby