/* SPDX-License-Identifier: GPL-2.0 */
/*
* CAAM Protocol Data Block ( PDB ) definition header file
*
* Copyright 2008 - 2016 Freescale Semiconductor , Inc .
*
*/
#ifndef CAAM_PDB_H
#define CAAM_PDB_H
#include "compat.h"
/*
* PDB - IPSec ESP Header Modification Options
*/
#define PDBHMO_ESP_DECAP_SHIFT 28
#define PDBHMO_ESP_ENCAP_SHIFT 28
/*
* Encap and Decap - Decrement TTL ( Hop Limit ) - Based on the value of the
* Options Byte IP version ( IPvsn ) field :
* if IPv4 , decrement the inner IP header TTL field ( byte 8 ) ;
* if IPv6 decrement the inner IP header Hop Limit field ( byte 7 ) .
*/
#define PDBHMO_ESP_DECAP_DEC_TTL (0 x02 << PDBHMO_ESP_DECAP_SHIFT)
#define PDBHMO_ESP_ENCAP_DEC_TTL (0 x02 << PDBHMO_ESP_ENCAP_SHIFT)
/*
* Decap - DiffServ Copy - Copy the IPv4 TOS or IPv6 Traffic Class byte
* from the outer IP header to the inner IP header .
*/
#define PDBHMO_ESP_DIFFSERV (0 x01 << PDBHMO_ESP_DECAP_SHIFT)
/*
* Encap - Copy DF bit - if an IPv4 tunnel mode outer IP header is coming from
* the PDB , copy the DF bit from the inner IP header to the outer IP header .
*/
#define PDBHMO_ESP_DFBIT (0 x04 << PDBHMO_ESP_ENCAP_SHIFT)
#define PDBNH_ESP_ENCAP_SHIFT 16
#define PDBNH_ESP_ENCAP_MASK (0 xff << PDBNH_ESP_ENCAP_SHIFT)
#define PDBHDRLEN_ESP_DECAP_SHIFT 16
#define PDBHDRLEN_MASK (0 x0fff << PDBHDRLEN_ESP_DECAP_SHIFT)
#define PDB_NH_OFFSET_SHIFT 8
#define PDB_NH_OFFSET_MASK (0 xff << PDB_NH_OFFSET_SHIFT)
/*
* PDB - IPSec ESP Encap / Decap Options
*/
#define PDBOPTS_ESP_ARSNONE 0 x00 /* no antireplay window */
#define PDBOPTS_ESP_ARS32 0 x40 /* 32-entry antireplay window */
#define PDBOPTS_ESP_ARS128 0 x80 /* 128-entry antireplay window */
#define PDBOPTS_ESP_ARS64 0 xc0 /* 64-entry antireplay window */
#define PDBOPTS_ESP_ARS_MASK 0 xc0 /* antireplay window mask */
#define PDBOPTS_ESP_IVSRC 0 x20 /* IV comes from internal random gen */
#define PDBOPTS_ESP_ESN 0 x10 /* extended sequence included */
#define PDBOPTS_ESP_OUTFMT 0 x08 /* output only decapsulation (decap) */
#define PDBOPTS_ESP_IPHDRSRC 0 x08 /* IP header comes from PDB (encap) */
#define PDBOPTS_ESP_INCIPHDR 0 x04 /* Prepend IP header to output frame */
#define PDBOPTS_ESP_IPVSN 0 x02 /* process IPv6 header */
#define PDBOPTS_ESP_AOFL 0 x04 /* adjust out frame len (decap, SEC>=5.3)*/
#define PDBOPTS_ESP_TUNNEL 0 x01 /* tunnel mode next-header byte */
#define PDBOPTS_ESP_IPV6 0 x02 /* ip header version is V6 */
#define PDBOPTS_ESP_DIFFSERV 0 x40 /* copy TOS/TC from inner iphdr */
#define PDBOPTS_ESP_UPDATE_CSUM 0 x80 /* encap-update ip header checksum */
#define PDBOPTS_ESP_VERIFY_CSUM 0 x20 /* decap-validate ip header checksum */
/*
* General IPSec encap / decap PDB definitions
*/
/**
* ipsec_encap_cbc - PDB part for IPsec CBC encapsulation
* @ iv : 16 - byte array initialization vector
*/
struct ipsec_encap_cbc {
u8 iv[16 ];
};
/**
* ipsec_encap_ctr - PDB part for IPsec CTR encapsulation
* @ ctr_nonce : 4 - byte array nonce
* @ ctr_initial : initial count constant
* @ iv : initialization vector
*/
struct ipsec_encap_ctr {
u8 ctr_nonce[4 ];
u32 ctr_initial;
u64 iv;
};
/**
* ipsec_encap_ccm - PDB part for IPsec CCM encapsulation
* @ salt : 3 - byte array salt ( lower 24 bits )
* @ ccm_opt : CCM algorithm options - MSB - LSB description :
* b0_flags ( 8 b ) - CCM B0 ; use 0 x5B for 8 - byte ICV , 0 x6B for 12 - byte ICV ,
* 0 x7B for 16 - byte ICV ( cf . RFC4309 , RFC3610 )
* ctr_flags ( 8 b ) - counter flags ; constant equal to 0 x3
* ctr_initial ( 16 b ) - initial count constant
* @ iv : initialization vector
*/
struct ipsec_encap_ccm {
u8 salt[4 ];
u32 ccm_opt;
u64 iv;
};
/**
* ipsec_encap_gcm - PDB part for IPsec GCM encapsulation
* @ salt : 3 - byte array salt ( lower 24 bits )
* @ rsvd : reserved , do not use
* @ iv : initialization vector
*/
struct ipsec_encap_gcm {
u8 salt[4 ];
u32 rsvd1;
u64 iv;
};
/**
* ipsec_encap_pdb - PDB for IPsec encapsulation
* @ options : MSB - LSB description
* hmo ( header manipulation options ) - 4 b
* reserved - 4 b
* next header - 8 b
* next header offset - 8 b
* option flags ( depend on selected algorithm ) - 8 b
* @ seq_num_ext_hi : ( optional ) IPsec Extended Sequence Number ( ESN )
* @ seq_num : IPsec sequence number
* @ spi : IPsec SPI ( Security Parameters Index )
* @ ip_hdr_len : optional IP Header length ( in bytes )
* reserved - 16 b
* Opt . IP Hdr Len - 16 b
* @ ip_hdr : optional IP Header content
*/
struct ipsec_encap_pdb {
u32 options;
u32 seq_num_ext_hi;
u32 seq_num;
union {
struct ipsec_encap_cbc cbc;
struct ipsec_encap_ctr ctr;
struct ipsec_encap_ccm ccm;
struct ipsec_encap_gcm gcm;
};
u32 spi;
u32 ip_hdr_len;
u32 ip_hdr[];
};
/**
* ipsec_decap_cbc - PDB part for IPsec CBC decapsulation
* @ rsvd : reserved , do not use
*/
struct ipsec_decap_cbc {
u32 rsvd[2 ];
};
/**
* ipsec_decap_ctr - PDB part for IPsec CTR decapsulation
* @ ctr_nonce : 4 - byte array nonce
* @ ctr_initial : initial count constant
*/
struct ipsec_decap_ctr {
u8 ctr_nonce[4 ];
u32 ctr_initial;
};
/**
* ipsec_decap_ccm - PDB part for IPsec CCM decapsulation
* @ salt : 3 - byte salt ( lower 24 bits )
* @ ccm_opt : CCM algorithm options - MSB - LSB description :
* b0_flags ( 8 b ) - CCM B0 ; use 0 x5B for 8 - byte ICV , 0 x6B for 12 - byte ICV ,
* 0 x7B for 16 - byte ICV ( cf . RFC4309 , RFC3610 )
* ctr_flags ( 8 b ) - counter flags ; constant equal to 0 x3
* ctr_initial ( 16 b ) - initial count constant
*/
struct ipsec_decap_ccm {
u8 salt[4 ];
u32 ccm_opt;
};
/**
* ipsec_decap_gcm - PDB part for IPsec GCN decapsulation
* @ salt : 4 - byte salt
* @ rsvd : reserved , do not use
*/
struct ipsec_decap_gcm {
u8 salt[4 ];
u32 resvd;
};
/**
* ipsec_decap_pdb - PDB for IPsec decapsulation
* @ options : MSB - LSB description
* hmo ( header manipulation options ) - 4 b
* IP header length - 12 b
* next header offset - 8 b
* option flags ( depend on selected algorithm ) - 8 b
* @ seq_num_ext_hi : ( optional ) IPsec Extended Sequence Number ( ESN )
* @ seq_num : IPsec sequence number
* @ anti_replay : Anti - replay window ; size depends on ARS ( option flags )
*/
struct ipsec_decap_pdb {
u32 options;
union {
struct ipsec_decap_cbc cbc;
struct ipsec_decap_ctr ctr;
struct ipsec_decap_ccm ccm;
struct ipsec_decap_gcm gcm;
};
u32 seq_num_ext_hi;
u32 seq_num;
__be32 anti_replay[4 ];
};
/*
* IPSec ESP Datapath Protocol Override Register ( DPOVRD )
*/
struct ipsec_deco_dpovrd {
#define IPSEC_ENCAP_DECO_DPOVRD_USE 0 x80
u8 ovrd_ecn;
u8 ip_hdr_len;
u8 nh_offset;
u8 next_header; /* reserved if decap */
};
/*
* IEEE 802 . 11 i WiFi Protocol Data Block
*/
#define WIFI_PDBOPTS_FCS 0 x01
#define WIFI_PDBOPTS_AR 0 x40
struct wifi_encap_pdb {
u16 mac_hdr_len;
u8 rsvd;
u8 options;
u8 iv_flags;
u8 pri;
u16 pn1;
u32 pn2;
u16 frm_ctrl_mask;
u16 seq_ctrl_mask;
u8 rsvd1[2 ];
u8 cnst;
u8 key_id;
u8 ctr_flags;
u8 rsvd2;
u16 ctr_init;
};
struct wifi_decap_pdb {
u16 mac_hdr_len;
u8 rsvd;
u8 options;
u8 iv_flags;
u8 pri;
u16 pn1;
u32 pn2;
u16 frm_ctrl_mask;
u16 seq_ctrl_mask;
u8 rsvd1[4 ];
u8 ctr_flags;
u8 rsvd2;
u16 ctr_init;
};
/*
* IEEE 802 . 16 WiMAX Protocol Data Block
*/
#define WIMAX_PDBOPTS_FCS 0 x01
#define WIMAX_PDBOPTS_AR 0 x40 /* decap only */
struct wimax_encap_pdb {
u8 rsvd[3 ];
u8 options;
u32 nonce;
u8 b0_flags;
u8 ctr_flags;
u16 ctr_init;
/* begin DECO writeback region */
u32 pn;
/* end DECO writeback region */
};
struct wimax_decap_pdb {
u8 rsvd[3 ];
u8 options;
u32 nonce;
u8 iv_flags;
u8 ctr_flags;
u16 ctr_init;
/* begin DECO writeback region */
u32 pn;
u8 rsvd1[2 ];
u16 antireplay_len;
u64 antireplay_scorecard;
/* end DECO writeback region */
};
/*
* IEEE 801 . AE MacSEC Protocol Data Block
*/
#define MACSEC_PDBOPTS_FCS 0 x01
#define MACSEC_PDBOPTS_AR 0 x40 /* used in decap only */
struct macsec_encap_pdb {
u16 aad_len;
u8 rsvd;
u8 options;
u64 sci;
u16 ethertype;
u8 tci_an;
u8 rsvd1;
/* begin DECO writeback region */
u32 pn;
/* end DECO writeback region */
};
struct macsec_decap_pdb {
u16 aad_len;
u8 rsvd;
u8 options;
u64 sci;
u8 rsvd1[3 ];
/* begin DECO writeback region */
u8 antireplay_len;
u32 pn;
u64 antireplay_scorecard;
/* end DECO writeback region */
};
/*
* SSL / TLS / DTLS Protocol Data Blocks
*/
#define TLS_PDBOPTS_ARS32 0 x40
#define TLS_PDBOPTS_ARS64 0 xc0
#define TLS_PDBOPTS_OUTFMT 0 x08
#define TLS_PDBOPTS_IV_WRTBK 0 x02 /* 1.1/1.2/DTLS only */
#define TLS_PDBOPTS_EXP_RND_IV 0 x01 /* 1.1/1.2/DTLS only */
struct tls_block_encap_pdb {
u8 type;
u8 version[2 ];
u8 options;
u64 seq_num;
u32 iv[4 ];
};
struct tls_stream_encap_pdb {
u8 type;
u8 version[2 ];
u8 options;
u64 seq_num;
u8 i;
u8 j;
u8 rsvd1[2 ];
};
struct dtls_block_encap_pdb {
u8 type;
u8 version[2 ];
u8 options;
u16 epoch;
u16 seq_num[3 ];
u32 iv[4 ];
};
struct tls_block_decap_pdb {
u8 rsvd[3 ];
u8 options;
u64 seq_num;
u32 iv[4 ];
};
struct tls_stream_decap_pdb {
u8 rsvd[3 ];
u8 options;
u64 seq_num;
u8 i;
u8 j;
u8 rsvd1[2 ];
};
struct dtls_block_decap_pdb {
u8 rsvd[3 ];
u8 options;
u16 epoch;
u16 seq_num[3 ];
u32 iv[4 ];
u64 antireplay_scorecard;
};
/*
* SRTP Protocol Data Blocks
*/
#define SRTP_PDBOPTS_MKI 0 x08
#define SRTP_PDBOPTS_AR 0 x40
struct srtp_encap_pdb {
u8 x_len;
u8 mki_len;
u8 n_tag;
u8 options;
u32 cnst0;
u8 rsvd[2 ];
u16 cnst1;
u16 salt[7 ];
u16 cnst2;
u32 rsvd1;
u32 roc;
u32 opt_mki;
};
struct srtp_decap_pdb {
u8 x_len;
u8 mki_len;
u8 n_tag;
u8 options;
u32 cnst0;
u8 rsvd[2 ];
u16 cnst1;
u16 salt[7 ];
u16 cnst2;
u16 rsvd1;
u16 seq_num;
u32 roc;
u64 antireplay_scorecard;
};
/*
* DSA / ECDSA Protocol Data Blocks
* Two of these exist : DSA - SIGN , and DSA - VERIFY . They are similar
* except for the treatment of " w " for verify , " s " for sign ,
* and the placement of " a , b " .
*/
#define DSA_PDB_SGF_SHIFT 24
#define DSA_PDB_SGF_MASK (0 xff << DSA_PDB_SGF_SHIFT)
#define DSA_PDB_SGF_Q (0 x80 << DSA_PDB_SGF_SHIFT)
#define DSA_PDB_SGF_R (0 x40 << DSA_PDB_SGF_SHIFT)
#define DSA_PDB_SGF_G (0 x20 << DSA_PDB_SGF_SHIFT)
#define DSA_PDB_SGF_W (0 x10 << DSA_PDB_SGF_SHIFT)
#define DSA_PDB_SGF_S (0 x10 << DSA_PDB_SGF_SHIFT)
#define DSA_PDB_SGF_F (0 x08 << DSA_PDB_SGF_SHIFT)
#define DSA_PDB_SGF_C (0 x04 << DSA_PDB_SGF_SHIFT)
#define DSA_PDB_SGF_D (0 x02 << DSA_PDB_SGF_SHIFT)
#define DSA_PDB_SGF_AB_SIGN (0 x02 << DSA_PDB_SGF_SHIFT)
#define DSA_PDB_SGF_AB_VERIFY (0 x01 << DSA_PDB_SGF_SHIFT)
#define DSA_PDB_L_SHIFT 7
#define DSA_PDB_L_MASK (0 x3ff << DSA_PDB_L_SHIFT)
#define DSA_PDB_N_MASK 0 x7f
struct dsa_sign_pdb {
u32 sgf_ln; /* Use DSA_PDB_ definitions per above */
u8 *q;
u8 *r;
u8 *g; /* or Gx,y */
u8 *s;
u8 *f;
u8 *c;
u8 *d;
u8 *ab; /* ECC only */
u8 *u;
};
struct dsa_verify_pdb {
u32 sgf_ln;
u8 *q;
u8 *r;
u8 *g; /* or Gx,y */
u8 *w; /* or Wx,y */
u8 *f;
u8 *c;
u8 *d;
u8 *tmp; /* temporary data block */
u8 *ab; /* only used if ECC processing */
};
/* RSA Protocol Data Block */
#define RSA_PDB_SGF_SHIFT 28
#define RSA_PDB_E_SHIFT 12
#define RSA_PDB_E_MASK (0 xFFF << RSA_PDB_E_SHIFT)
#define RSA_PDB_D_SHIFT 12
#define RSA_PDB_D_MASK (0 xFFF << RSA_PDB_D_SHIFT)
#define RSA_PDB_Q_SHIFT 12
#define RSA_PDB_Q_MASK (0 xFFF << RSA_PDB_Q_SHIFT)
#define RSA_PDB_SGF_F (0 x8 << RSA_PDB_SGF_SHIFT)
#define RSA_PDB_SGF_G (0 x4 << RSA_PDB_SGF_SHIFT)
#define RSA_PRIV_PDB_SGF_F (0 x4 << RSA_PDB_SGF_SHIFT)
#define RSA_PRIV_PDB_SGF_G (0 x8 << RSA_PDB_SGF_SHIFT)
#define RSA_PRIV_KEY_FRM_1 0
#define RSA_PRIV_KEY_FRM_2 1
#define RSA_PRIV_KEY_FRM_3 2
/**
* RSA Encrypt Protocol Data Block
* @ sgf : scatter - gather field
* @ f_dma : dma address of input data
* @ g_dma : dma address of encrypted output data
* @ n_dma : dma address of RSA modulus
* @ e_dma : dma address of RSA public exponent
* @ f_len : length in octets of the input data
*/
struct rsa_pub_pdb {
u32 sgf;
dma_addr_t f_dma;
dma_addr_t g_dma;
dma_addr_t n_dma;
dma_addr_t e_dma;
u32 f_len;
};
#define SIZEOF_RSA_PUB_PDB (2 * sizeof (u32) + 4 * caam_ptr_sz)
/**
* RSA Decrypt PDB - Private Key Form # 1
* @ sgf : scatter - gather field
* @ g_dma : dma address of encrypted input data
* @ f_dma : dma address of output data
* @ n_dma : dma address of RSA modulus
* @ d_dma : dma address of RSA private exponent
*/
struct rsa_priv_f1_pdb {
u32 sgf;
dma_addr_t g_dma;
dma_addr_t f_dma;
dma_addr_t n_dma;
dma_addr_t d_dma;
};
#define SIZEOF_RSA_PRIV_F1_PDB (sizeof (u32) + 4 * caam_ptr_sz)
/**
* RSA Decrypt PDB - Private Key Form # 2
* @ sgf : scatter - gather field
* @ g_dma : dma address of encrypted input data
* @ f_dma : dma address of output data
* @ d_dma : dma address of RSA private exponent
* @ p_dma : dma address of RSA prime factor p of RSA modulus n
* @ q_dma : dma address of RSA prime factor q of RSA modulus n
* @ tmp1_dma : dma address of temporary buffer . CAAM uses this temporary buffer
* as internal state buffer . It is assumed to be as long as p .
* @ tmp2_dma : dma address of temporary buffer . CAAM uses this temporary buffer
* as internal state buffer . It is assumed to be as long as q .
* @ p_q_len : length in bytes of first two prime factors of the RSA modulus n
*/
struct rsa_priv_f2_pdb {
u32 sgf;
dma_addr_t g_dma;
dma_addr_t f_dma;
dma_addr_t d_dma;
dma_addr_t p_dma;
dma_addr_t q_dma;
dma_addr_t tmp1_dma;
dma_addr_t tmp2_dma;
u32 p_q_len;
};
#define SIZEOF_RSA_PRIV_F2_PDB (2 * sizeof (u32) + 7 * caam_ptr_sz)
/**
* RSA Decrypt PDB - Private Key Form # 3
* This is the RSA Chinese Reminder Theorem ( CRT ) form for two prime factors of
* the RSA modulus .
* @ sgf : scatter - gather field
* @ g_dma : dma address of encrypted input data
* @ f_dma : dma address of output data
* @ c_dma : dma address of RSA CRT coefficient
* @ p_dma : dma address of RSA prime factor p of RSA modulus n
* @ q_dma : dma address of RSA prime factor q of RSA modulus n
* @ dp_dma : dma address of RSA CRT exponent of RSA prime factor p
* @ dp_dma : dma address of RSA CRT exponent of RSA prime factor q
* @ tmp1_dma : dma address of temporary buffer . CAAM uses this temporary buffer
* as internal state buffer . It is assumed to be as long as p .
* @ tmp2_dma : dma address of temporary buffer . CAAM uses this temporary buffer
* as internal state buffer . It is assumed to be as long as q .
* @ p_q_len : length in bytes of first two prime factors of the RSA modulus n
*/
struct rsa_priv_f3_pdb {
u32 sgf;
dma_addr_t g_dma;
dma_addr_t f_dma;
dma_addr_t c_dma;
dma_addr_t p_dma;
dma_addr_t q_dma;
dma_addr_t dp_dma;
dma_addr_t dq_dma;
dma_addr_t tmp1_dma;
dma_addr_t tmp2_dma;
u32 p_q_len;
};
#define SIZEOF_RSA_PRIV_F3_PDB (2 * sizeof (u32) + 9 * caam_ptr_sz)
#endif
Messung V0.5 in Prozent C=95 H=91 G=92
¤ Die Informationen auf dieser Webseite wurden
nach bestem Wissen sorgfältig zusammengestellt. Es wird jedoch weder Vollständigkeit, noch Richtigkeit,
noch Qualität der bereit gestellten Informationen zugesichert.0.21Bemerkung:
(vorverarbeitet am 2026-09-28)
¤
*Bot Zugriff