Print this page
11628 typos detected by mandoc style
| Split |
Close |
| Expand all |
| Collapse all |
--- old/usr/src/man/man3ext/SUNW_C_GetMechSession.3ext.man.txt
+++ new/usr/src/man/man3ext/SUNW_C_GetMechSession.3ext.man.txt
1 1 SUNW_C_GETMECHSESSION(3EXT) Extended Library Functions
2 2
3 3
4 4
5 5 NAME
6 6 SUNW_C_GetMechSession, SUNW_C_KeyToObject - PKCS#11 Cryptographic
7 7 Framework functions
8 8
9 9 SYNOPSIS
10 10 cc [ flag ... ] file... -lpkcs11 [ library... ]
11 11 #include <security/cryptoki.h>
12 12 #include <security/pkcs11.h>
13 13
14 14 CK_RV SUNW_C_GetMechSession(CK_MECHANISM_TYPE mech,
15 15 CK_SESSION_HANDLE_PTR hSession);
16 16
17 17
18 18 CK_RV SUNW_C_KeyToObject(CK_SESSION_HANDLE hSession,
19 19 CK_MECHANISM_TYPE mech, const void *rawkey, size_t rawkey_len,
20 20 CK_OBJECT_HANDLE_PTR obj);
21 21
|
↓ open down ↓ |
21 lines elided |
↑ open up ↑ |
22 22
23 23 DESCRIPTION
24 24 These functions implement the RSA PKCS#11 v2.20 specification by using
25 25 plug-ins to provide the slots.
26 26
27 27
28 28 The SUNW_C_GetMechSession() function initializes the PKCS#11
29 29 cryptographic framework and performs all necessary calls to Standard
30 30 PKCS#11 functions (see libpkcs11(3LIB)) to create a session capable of
31 31 providing operations on the requested mechanism. It is not necessary to
32 - call C_Initalize() or C_GetSlotList() before the first call to
32 + call C_Initialize() or C_GetSlotList() before the first call to
33 33 SUNW_C_GetMechSession().
34 34
35 35
36 36 If the SUNW_C_GetMechSession() function is called multiple times, it
37 - will return a new session each time without re-initalizing the
37 + will return a new session each time without re-initializing the
38 38 framework. If it is unable to return a new session, CKR_SESSION_COUNT
39 39 is returned.
40 40
41 41
42 42 The C_CloseSession() function should be called to release the session
43 43 when it is no longer required.
44 44
45 45
46 46 The SUNW_C_KeyToObject() function creates a key object for the
47 47 specified mechanism from the rawkey data. The object should be
48 48 destroyed with C_DestroyObject() when it is no longer required.
49 49
50 50 RETURN VALUES
51 51 The SUNW_C_GetMechSession() function returns the following values:
52 52
53 53 CKR_OK
54 54 The function completed successfully.
55 55
56 56
57 57 CKR_SESSION_COUNT
58 58 No sessions are available.
59 59
60 60
61 61 CKR_ARGUMENTS_BAD
62 62 A null pointer was passed for the return
63 63 session handle.
64 64
65 65
66 66 CKR_MECHANISM_INVALID
67 67 The requested mechanism is invalid or no
68 68 available plug-in provider supports it.
69 69
70 70
71 71 CKR_FUNCTION_FAILED
72 72 The function failed.
73 73
74 74
75 75 CKR_GENERAL_ERROR
76 76 A general error occurred.
77 77
78 78
79 79
80 80 The SUNW_C_KeyToObject() function returns the following values:
81 81
82 82 CKR_OK
83 83 The function completed successfully.
84 84
85 85
86 86 CKR_ARGUMENTS_BAD
87 87 A null pointer was passed for the session
88 88 handle or the key material.
89 89
90 90
91 91 CKR_MECHANISM_INVALID
92 92 The requested mechanism is invalid or no
93 93 available plug-in provider supports it.
94 94
95 95
96 96 CKR_FUNCTION_FAILED
97 97 The function failed.
98 98
99 99
100 100 CKR_GENERAL_ERROR
101 101 A general error occurred.
102 102
103 103
104 104
105 105 The return values of each of the implemented functions are defined and
106 106 listed in the RSA PKCS#11 v2.20 specification. See
107 107 http://www.rsasecurity.com.
108 108
109 109 USAGE
110 110 These functions are not part of the RSA PKCS#11 v2.20 specification.
111 111 They are not likely to exist on non-Solaris systems. They are provided
112 112 as a convenience to application programmers. Use of these functions
113 113 will make the application non-portable to other systems.
114 114
115 115 ATTRIBUTES
116 116 See attributes(5) for descriptions of the following attributes:
117 117
118 118
119 119
120 120
121 121 +--------------------+-----------------+
122 122 | ATTRIBUTE TYPE | ATTRIBUTE VALUE |
123 123 +--------------------+-----------------+
124 124 |Interface Stability | Evolving |
125 125 +--------------------+-----------------+
126 126 |MT-Level | MT-Safe |
|
↓ open down ↓ |
79 lines elided |
↑ open up ↑ |
127 127 +--------------------+-----------------+
128 128
129 129 SEE ALSO
130 130 libpkcs11(3LIB), attributes(5)
131 131
132 132
133 133 http://www.rsasecurity.com
134 134
135 135
136 136
137 - April 9, 2016 SUNW_C_GETMECHSESSION(3EXT)
137 + August 27, 2019 SUNW_C_GETMECHSESSION(3EXT)
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX