mirror of
https://github.com/mozilla/gecko-dev.git
synced 2024-11-06 00:55:37 +00:00
324 lines
9.7 KiB
C
324 lines
9.7 KiB
C
/* ***** BEGIN LICENSE BLOCK *****
|
|
* Version: MPL 1.1/GPL 2.0/LGPL 2.1
|
|
*
|
|
* The contents of this file are subject to the Mozilla Public License Version
|
|
* 1.1 (the "License"); you may not use this file except in compliance with
|
|
* the License. You may obtain a copy of the License at
|
|
* http://www.mozilla.org/MPL/
|
|
*
|
|
* Software distributed under the License is distributed on an "AS IS" basis,
|
|
* WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
|
|
* for the specific language governing rights and limitations under the
|
|
* License.
|
|
*
|
|
* The Original Code is the Netscape security libraries.
|
|
*
|
|
* The Initial Developer of the Original Code is
|
|
* Netscape Communications Corporation.
|
|
* Portions created by the Initial Developer are Copyright (C) 1994-2000
|
|
* the Initial Developer. All Rights Reserved.
|
|
*
|
|
* Contributor(s):
|
|
* RSA Labs
|
|
*
|
|
* Alternatively, the contents of this file may be used under the terms of
|
|
* either the GNU General Public License Version 2 or later (the "GPL"), or
|
|
* the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
|
|
* in which case the provisions of the GPL or the LGPL are applicable instead
|
|
* of those above. If you wish to allow use of your version of this file only
|
|
* under the terms of either the GPL or the LGPL, and not to allow others to
|
|
* use your version of this file under the terms of the MPL, indicate your
|
|
* decision by deleting the provisions above and replace them with the notice
|
|
* and other provisions required by the GPL or the LGPL. If you do not delete
|
|
* the provisions above, a recipient may use your version of this file under
|
|
* the terms of any one of the MPL, the GPL or the LGPL.
|
|
*
|
|
* ***** END LICENSE BLOCK ***** */
|
|
/*
|
|
* Copyright (C) 1994-1999 RSA Security Inc. Licence to copy this document
|
|
* is granted provided that it is identified as "RSA Security In.c Public-Key
|
|
* Cryptography Standards (PKCS)" in all material mentioning or referencing
|
|
* this document.
|
|
*
|
|
* The latest version of this header can be found at:
|
|
* http://www.rsalabs.com/pkcs/pkcs-11/index.html
|
|
*/
|
|
#ifndef _PKCS11_H_
|
|
#define _PKCS11_H_ 1
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/* Before including this file (pkcs11.h) (or pkcs11t.h by
|
|
* itself), 6 platform-specific macros must be defined. These
|
|
* macros are described below, and typical definitions for them
|
|
* are also given. Be advised that these definitions can depend
|
|
* on both the platform and the compiler used (and possibly also
|
|
* on whether a PKCS #11 library is linked statically or
|
|
* dynamically).
|
|
*
|
|
* In addition to defining these 6 macros, the packing convention
|
|
* for PKCS #11 structures should be set. The PKCS #11
|
|
* convention on packing is that structures should be 1-byte
|
|
* aligned.
|
|
*
|
|
* In a Win32 environment, this might be done by using the
|
|
* following preprocessor directive before including pkcs11.h
|
|
* or pkcs11t.h:
|
|
*
|
|
* #pragma pack(push, cryptoki, 1)
|
|
*
|
|
* and using the following preprocessor directive after including
|
|
* pkcs11.h or pkcs11t.h:
|
|
*
|
|
* #pragma pack(pop, cryptoki)
|
|
*
|
|
* In a Win16 environment, this might be done by using the
|
|
* following preprocessor directive before including pkcs11.h
|
|
* or pkcs11t.h:
|
|
*
|
|
* #pragma pack(1)
|
|
*
|
|
* In a UNIX environment, you're on your own here. You might
|
|
* not need to do anything.
|
|
*
|
|
*
|
|
* Now for the macros:
|
|
*
|
|
*
|
|
* 1. CK_PTR: The indirection string for making a pointer to an
|
|
* object. It can be used like this:
|
|
*
|
|
* typedef CK_BYTE CK_PTR CK_BYTE_PTR;
|
|
*
|
|
* In a Win32 environment, it might be defined by
|
|
*
|
|
* #define CK_PTR *
|
|
*
|
|
* In a Win16 environment, it might be defined by
|
|
*
|
|
* #define CK_PTR far *
|
|
*
|
|
* In a UNIX environment, it might be defined by
|
|
*
|
|
* #define CK_PTR *
|
|
*
|
|
*
|
|
* 2. CK_DEFINE_FUNCTION(returnType, name): A macro which makes
|
|
* an exportable PKCS #11 library function definition out of a
|
|
* return type and a function name. It should be used in the
|
|
* following fashion to define the exposed PKCS #11 functions in
|
|
* a PKCS #11 library:
|
|
*
|
|
* CK_DEFINE_FUNCTION(CK_RV, C_Initialize)(
|
|
* CK_VOID_PTR pReserved
|
|
* )
|
|
* {
|
|
* ...
|
|
* }
|
|
*
|
|
* For defining a function in a Win32 PKCS #11 .dll, it might be
|
|
* defined by
|
|
*
|
|
* #define CK_DEFINE_FUNCTION(returnType, name) \
|
|
* returnType __declspec(dllexport) name
|
|
*
|
|
* For defining a function in a Win16 PKCS #11 .dll, it might be
|
|
* defined by
|
|
*
|
|
* #define CK_DEFINE_FUNCTION(returnType, name) \
|
|
* returnType __export _far _pascal name
|
|
*
|
|
* In a UNIX environment, it might be defined by
|
|
*
|
|
* #define CK_DEFINE_FUNCTION(returnType, name) \
|
|
* returnType name
|
|
*
|
|
*
|
|
* 3. CK_DECLARE_FUNCTION(returnType, name): A macro which makes
|
|
* an importable PKCS #11 library function declaration out of a
|
|
* return type and a function name. It should be used in the
|
|
* following fashion:
|
|
*
|
|
* extern CK_DECLARE_FUNCTION(CK_RV, C_Initialize)(
|
|
* CK_VOID_PTR pReserved
|
|
* );
|
|
*
|
|
* For declaring a function in a Win32 PKCS #11 .dll, it might
|
|
* be defined by
|
|
*
|
|
* #define CK_DECLARE_FUNCTION(returnType, name) \
|
|
* returnType __declspec(dllimport) name
|
|
*
|
|
* For declaring a function in a Win16 PKCS #11 .dll, it might
|
|
* be defined by
|
|
*
|
|
* #define CK_DECLARE_FUNCTION(returnType, name) \
|
|
* returnType __export _far _pascal name
|
|
*
|
|
* In a UNIX environment, it might be defined by
|
|
*
|
|
* #define CK_DECLARE_FUNCTION(returnType, name) \
|
|
* returnType name
|
|
*
|
|
*
|
|
* 4. CK_DECLARE_FUNCTION_POINTER(returnType, name): A macro
|
|
* which makes a PKCS #11 API function pointer declaration or
|
|
* function pointer type declaration out of a return type and a
|
|
* function name. It should be used in the following fashion:
|
|
*
|
|
* // Define funcPtr to be a pointer to a PKCS #11 API function
|
|
* // taking arguments args and returning CK_RV.
|
|
* CK_DECLARE_FUNCTION_POINTER(CK_RV, funcPtr)(args);
|
|
*
|
|
* or
|
|
*
|
|
* // Define funcPtrType to be the type of a pointer to a
|
|
* // PKCS #11 API function taking arguments args and returning
|
|
* // CK_RV, and then define funcPtr to be a variable of type
|
|
* // funcPtrType.
|
|
* typedef CK_DECLARE_FUNCTION_POINTER(CK_RV, funcPtrType)(args);
|
|
* funcPtrType funcPtr;
|
|
*
|
|
* For accessing functions in a Win32 PKCS #11 .dll, in might be
|
|
* defined by
|
|
*
|
|
* #define CK_DECLARE_FUNCTION_POINTER(returnType, name) \
|
|
* returnType __declspec(dllimport) (* name)
|
|
*
|
|
* For accessing functions in a Win16 PKCS #11 .dll, it might be
|
|
* defined by
|
|
*
|
|
* #define CK_DECLARE_FUNCTION_POINTER(returnType, name) \
|
|
* returnType __export _far _pascal (* name)
|
|
*
|
|
* In a UNIX environment, it might be defined by
|
|
*
|
|
* #define CK_DECLARE_FUNCTION_POINTER(returnType, name) \
|
|
* returnType (* name)
|
|
*
|
|
*
|
|
* 5. CK_CALLBACK_FUNCTION(returnType, name): A macro which makes
|
|
* a function pointer type for an application callback out of
|
|
* a return type for the callback and a name for the callback.
|
|
* It should be used in the following fashion:
|
|
*
|
|
* CK_CALLBACK_FUNCTION(CK_RV, myCallback)(args);
|
|
*
|
|
* to declare a function pointer, myCallback, to a callback
|
|
* which takes arguments args and returns a CK_RV. It can also
|
|
* be used like this:
|
|
*
|
|
* typedef CK_CALLBACK_FUNCTION(CK_RV, myCallbackType)(args);
|
|
* myCallbackType myCallback;
|
|
*
|
|
* In a Win32 environment, it might be defined by
|
|
*
|
|
* #define CK_CALLBACK_FUNCTION(returnType, name) \
|
|
* returnType (* name)
|
|
*
|
|
* In a Win16 environment, it might be defined by
|
|
*
|
|
* #define CK_CALLBACK_FUNCTION(returnType, name) \
|
|
* returnType _far _pascal (* name)
|
|
*
|
|
* In a UNIX environment, it might be defined by
|
|
*
|
|
* #define CK_CALLBACK_FUNCTION(returnType, name) \
|
|
* returnType (* name)
|
|
*
|
|
*
|
|
* 6. NULL_PTR: This macro is the value of a NULL pointer.
|
|
*
|
|
* In any ANSI/ISO C environment (and in many others as well),
|
|
* this should be defined by
|
|
*
|
|
* #ifndef NULL_PTR
|
|
* #define NULL_PTR 0
|
|
* #endif
|
|
*/
|
|
|
|
|
|
/* All the various PKCS #11 types and #define'd values are in the
|
|
* file pkcs11t.h. */
|
|
#include "pkcs11t.h"
|
|
|
|
#define __PASTE(x,y) x##y
|
|
|
|
|
|
/* packing defines */
|
|
#include "pkcs11p.h"
|
|
/* ==============================================================
|
|
* Define the "extern" form of all the entry points.
|
|
* ==============================================================
|
|
*/
|
|
|
|
#define CK_NEED_ARG_LIST 1
|
|
#define CK_PKCS11_FUNCTION_INFO(name) \
|
|
CK_DECLARE_FUNCTION(CK_RV, name)
|
|
|
|
/* pkcs11f.h has all the information about the PKCS #11
|
|
* function prototypes. */
|
|
#include "pkcs11f.h"
|
|
|
|
#undef CK_NEED_ARG_LIST
|
|
#undef CK_PKCS11_FUNCTION_INFO
|
|
|
|
|
|
/* ==============================================================
|
|
* Define the typedef form of all the entry points. That is, for
|
|
* each PKCS #11 function C_XXX, define a type CK_C_XXX which is
|
|
* a pointer to that kind of function.
|
|
* ==============================================================
|
|
*/
|
|
|
|
#define CK_NEED_ARG_LIST 1
|
|
#define CK_PKCS11_FUNCTION_INFO(name) \
|
|
typedef CK_DECLARE_FUNCTION_POINTER(CK_RV, __PASTE(CK_,name))
|
|
|
|
/* pkcs11f.h has all the information about the PKCS #11
|
|
* function prototypes. */
|
|
#include "pkcs11f.h"
|
|
|
|
#undef CK_NEED_ARG_LIST
|
|
#undef CK_PKCS11_FUNCTION_INFO
|
|
|
|
|
|
/* ==============================================================
|
|
* Define structed vector of entry points. A CK_FUNCTION_LIST
|
|
* contains a CK_VERSION indicating a library's PKCS #11 version
|
|
* and then a whole slew of function pointers to the routines in
|
|
* the library. This type was declared, but not defined, in
|
|
* pkcs11t.h.
|
|
* ==============================================================
|
|
*/
|
|
|
|
#define CK_PKCS11_FUNCTION_INFO(name) \
|
|
__PASTE(CK_,name) name;
|
|
|
|
struct CK_FUNCTION_LIST {
|
|
|
|
CK_VERSION version; /* PKCS #11 version */
|
|
|
|
/* Pile all the function pointers into the CK_FUNCTION_LIST. */
|
|
/* pkcs11f.h has all the information about the PKCS #11
|
|
* function prototypes. */
|
|
#include "pkcs11f.h"
|
|
|
|
};
|
|
|
|
#undef CK_PKCS11_FUNCTION_INFO
|
|
|
|
|
|
#undef __PASTE
|
|
|
|
/* unpack */
|
|
#include "pkcs11u.h"
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif
|