n2cp(7d)							      Devices								  n2cp(7d)

NAME

       n2cp - Ultra-SPARC T2 crypto provider device driver

DESCRIPTION

       The  n2cp  device  driver  is a multi-threaded, loadable hardware driver supporting hardware-assisted acceleration of the following crypto-
       graphic operations, which are built into the Ultra-SPARC T2 CMT processor:

	 DES:	CKM_DES_CBC, CKM_DES_ECB
	 DES3:	CKM_DES3_CBC, CKM_DES3_ECB,
	 AES:	CKM_AES_CBC, CKM_AES_ECB, CKM_AES_CTR, CKM_AES_CCM, CKM_AES_GCM
	 RC4:	CKM_RC4
	 MD5:	KM_MD5, CKM_MD5_HMAC, CKM_MD5_HMAC_GENERAL,
		  CKM_SSL3_MD5_MAC
	 SHA-1: CKM_SHA_1, CKM_SHA_1_HMAC,
		 CKM_SHA_1_HMAC_GENERAL, CKM_SSL3_SHA1_MAC
	 SHA-256:CKM_SHA256, CKM_SHA256_HMAC,
		 CKM_SHA256_HMAC_GENERAL

CONFIGURATION

       You configure the n2cp driver by defining properties in the /kernel/drv/n2cp.conf which override the default settings. The following  prop-
       erty is supported:

       nostats			   Disables the generation of statistics.  The nostats property may be used to help prevent traffic analysis, how-
				   ever, this may inhibit support personnel.

CRYPTO STATISTICS

       Solaris crypto drivers must implement statistics variables. The n2cp driver maintains the following statistics:

       cwqXstate		   State (online, offline, error) of respective cryptographic engine, CWQ X.

       cwqXsubmit		   Number of jobs submitted to CWQ X.

       cwqXqfull		   Number of times when submitting a job that the queue for CWQ X was full.

       cwqXqupdate_failure	   Number of submit job failures on CWQ X.

       des			   Total number of jobs submitted to device for DES operations.

       des3			   Total number of jobs submitted to device for DES3 operations.

       aes			   Total number of jobs submitted to device for AES operations.

       md5			   Total number of jobs submitted to device for MD5 operations.

       sha1			   Total number of jobs submitted to device for SHA-1 operations.

       sha256			   Total number of jobs submitted to device for SHA-256 operations.

       md5hmac			   Total number of jobs submitted to device for HMAC_MD5 operations.

       sha1hmac 		   Total number of jobs submitted to device for HMAC_SHA-1 operations.

       sha256hmac		   Total number of jobs submitted to device for HMAC_SHA-256 operations.

       ssl3md5mac		   Total number of jobs submitted to device for SSL3_MAC_MD5 operations.

       ssl3sha1mac		   Total number of jobs submitted to device for SSL3_MAC_SHA-1 operations.

       ssl3sha256mac		   Total number of jobs submitted to device for SSL3_MAC_SHA-256 operations.

       Note -

	 Additional statistics targeted for Sun support personnel are not documented in this manpage.

FILES

       /kernel/drv/sparcv9/n2cp

	   64-bit ELF kernel driver.

       /platform/sun4v/kernel/drv/n2cp.conf

	   Configuration file.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Architecture		     |SPARC			   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWn2cp.v		   |
       +-----------------------------+-----------------------------+
       |Interface stability	     |Unstable			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       elfsign(1), cryptoadm(1M), kstat(1M), libpkcs11(3LIB), printers.conf(4), pkcs11_kernel(5), attributes(5)

       Solaris Cryptographic Framework - Solaris Software Developer Collection

       Solaris Security for Developer's Guide - Solaris Software Developer Collection

SunOS 5.11							    13 Jan 2009 							  n2cp(7d)