1n2cp(7d)                            Devices                           n2cp(7d)
2
3
4

NAME

6       n2cp - Ultra-SPARC T2 crypto provider device driver
7

DESCRIPTION

9       The  n2cp  device  driver is a multi-threaded, loadable hardware driver
10       supporting hardware-assisted  acceleration  of  the  following  crypto‐
11       graphic operations, which are built into the Ultra-SPARC T2 CMT proces‐
12       sor:
13
14         DES:    CKM_DES_CBC, CKM_DES_ECB
15         DES3:   CKM_DES3_CBC, CKM_DES3_ECB,
16         AES:    CKM_AES_CBC, CKM_AES_ECB, CKM_AES_CTR, CKM_AES_CCM, CKM_AES_GCM,
17                 CKM_AES_GMAC
18         RC4:    CKM_RC4
19         MD5:    KM_MD5, CKM_MD5_HMAC, CKM_MD5_HMAC_GENERAL,
20                     CKM_SSL3_MD5_MAC
21         SHA-1:  CKM_SHA_1, CKM_SHA_1_HMAC,
22                 CKM_SHA_1_HMAC_GENERAL, CKM_SSL3_SHA1_MAC
23         SHA-256:CKM_SHA256, CKM_SHA256_HMAC,
24                 CKM_SHA256_HMAC_GENERAL
25
26

CONFIGURATION

28       You configure the n2cp driver by  defining  properties  in  the  /plat‐
29       form/sun4v/kernel/drv/n2cp.conf  which  override  the default settings.
30       The following property is supported:
31
32       nostats                     Disables the generation of statistics.  The
33                                   nostats  property  may be used to help pre‐
34                                   vent traffic analysis,  however,  this  may
35                                   inhibit support personnel.
36
37

CRYPTO STATISTICS

39       Solaris  crypto  drivers  must implement statistics variables. The n2cp
40       driver maintains the following statistics:
41
42       cwqXstate                   State (online, offline, error)  of  respec‐
43                                   tive cryptographic engine, CWQ X.
44
45
46       cwqXsubmit                  Number of jobs submitted to CWQ X.
47
48
49       cwqXqfull                   Number  of times when submitting a job that
50                                   the queue for CWQ X was full.
51
52
53       cwqXqupdate_failure         Number of submit job failures on CWQ X.
54
55
56       des                         Total number of jobs  submitted  to  device
57                                   for DES operations.
58
59
60       des3                        Total  number  of  jobs submitted to device
61                                   for DES3 operations.
62
63
64       aes                         Total number of jobs  submitted  to  device
65                                   for AES operations.
66
67
68       md5                         Total  number  of  jobs submitted to device
69                                   for MD5 operations.
70
71
72       sha1                        Total number of jobs  submitted  to  device
73                                   for SHA-1 operations.
74
75
76       sha256                      Total  number  of  jobs submitted to device
77                                   for SHA-256 operations.
78
79
80       md5hmac                     Total number of jobs  submitted  to  device
81                                   for HMAC_MD5 operations.
82
83
84       sha1hmac                    Total  number  of  jobs submitted to device
85                                   for HMAC_SHA-1 operations.
86
87
88       sha256hmac                  Total number of jobs  submitted  to  device
89                                   for HMAC_SHA-256 operations.
90
91
92       ssl3md5mac                  Total  number  of  jobs submitted to device
93                                   for SSL3_MAC_MD5 operations.
94
95
96       ssl3sha1mac                 Total number of jobs  submitted  to  device
97                                   for SSL3_MAC_SHA-1 operations.
98
99
100       ssl3sha256mac               Total  number  of  jobs submitted to device
101                                   for SSL3_MAC_SHA-256 operations.
102
103
104       Note -
105
106         Additional statistics targeted for Sun support personnel are not doc‐
107         umented in this manpage.
108

FILES

110       /platform/sun4v/kernel/drv/sparcv9/n2cp
111
112           64-bit ELF kernel driver.
113
114
115       /platform/sun4v/kernel/drv/n2cp.conf
116
117           Configuration file.
118
119

ATTRIBUTES

121       See attributes(5) for descriptions of the following attributes:
122
123
124
125
126       ┌─────────────────────────────┬─────────────────────────────┐
127       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
128       ├─────────────────────────────┼─────────────────────────────┤
129       │Architecture                 │SPARC                        │
130       ├─────────────────────────────┼─────────────────────────────┤
131       │Availability                 │SUNWn2cp.v                   │
132       ├─────────────────────────────┼─────────────────────────────┤
133       │Interface Stability          │Uncommitted                  │
134       └─────────────────────────────┴─────────────────────────────┘
135

SEE ALSO

137       elfsign(1),    cryptoadm(1M),    kstat(1M),   libpkcs11(3LIB),   print‐
138       ers.conf(4), pkcs11_kernel(5), attributes(5)
139
140
141       Solaris Cryptographic Framework - Solaris Software Developer Collection
142
143
144       Solaris Security for Developer's Guide  -  Solaris  Software  Developer
145       Collection
146
147
148
149SunOS 5.11                        15 Apr 2009                         n2cp(7d)