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 cryptographic operations, which are built into
     the Ultra-SPARC T2 CMT processor:

       DES:   CKMDESCBC, CKMDESECB
       DES3:  CKMDES3CBC, CKMDES3ECB,
       AES:   CKMAESCBC, CKMAESECB, CKMAESCTR, CKMAESCM, CKMAESGCM
       RC4:   CKMRC4
       MD5:   KMD5, CKMD5HMAC, CKMD5HMACGENERAL,
                CKMSL3MD5MAC
       SHA-1: CKMSHA1, CKMSHA1HMAC,
               CKMSHA1HMACGENERAL, CKMSL3SHA1MAC
       SHA-256:CKMSHA256, CKMSHA256HMAC,
               CKMSHA256HMACGENERAL


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

     nostats                     Disables   the   generation   of
                                 statistics.   The  nostats  pro-
                                 perty  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.





SunOS 5.11          Last change: 13 Jan 2009                    1






Devices                                                  n2cp(7d)



     cwqXqupdatefailure         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  opera-
                                 tions.


     md5hmac                     Total number of  jobs  submitted
                                 to  device  for  HMACMD5 opera-
                                 tions.


     sha1hmac                    Total number of  jobs  submitted
                                 to  device for HMACSHA-1 opera-
                                 tions.


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


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


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



SunOS 5.11          Last change: 13 Jan 2009                    2






Devices                                                  n2cp(7d)



     ssl3sha256mac               Total number of  jobs  submitted
                                 to  device  for SL3MACSHA-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.


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Architecture                 SPARC                       
    
     Availability                 SUNWn2cp.v                  
    
     Interface stability          Unstable                    
    


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


     Solaris Cryptographic Framework - Solaris Software Developer
     Collection


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






SunOS 5.11          Last change: 13 Jan 2009                    3