366 lines
11 KiB
C
366 lines
11 KiB
C
/* SPDX-License-Identifier: GPL-2.0+ WITH Linux-syscall-note */
|
|
/*
|
|
* include/asm-s390/zcrypt.h
|
|
*
|
|
* zcrypt 2.1.0 (user-visible header)
|
|
*
|
|
* Copyright IBM Corp. 2001, 2006
|
|
* Author(s): Robert Burroughs
|
|
* Eric Rossman (edrossma@us.ibm.com)
|
|
*
|
|
* Hotplug & misc device support: Jochen Roehrig (roehrig@de.ibm.com)
|
|
*/
|
|
|
|
#ifndef __ASM_S390_ZCRYPT_H
|
|
#define __ASM_S390_ZCRYPT_H
|
|
|
|
#define ZCRYPT_VERSION 2
|
|
#define ZCRYPT_RELEASE 1
|
|
#define ZCRYPT_VARIANT 1
|
|
|
|
#include <linux/ioctl.h>
|
|
#include <linux/compiler.h>
|
|
|
|
/**
|
|
* struct ica_rsa_modexpo
|
|
*
|
|
* Requirements:
|
|
* - outputdatalength is at least as large as inputdatalength.
|
|
* - All key parts are right justified in their fields, padded on
|
|
* the left with zeroes.
|
|
* - length(b_key) = inputdatalength
|
|
* - length(n_modulus) = inputdatalength
|
|
*/
|
|
struct ica_rsa_modexpo {
|
|
char __user * inputdata;
|
|
unsigned int inputdatalength;
|
|
char __user * outputdata;
|
|
unsigned int outputdatalength;
|
|
char __user * b_key;
|
|
char __user * n_modulus;
|
|
};
|
|
|
|
/**
|
|
* struct ica_rsa_modexpo_crt
|
|
*
|
|
* Requirements:
|
|
* - inputdatalength is even.
|
|
* - outputdatalength is at least as large as inputdatalength.
|
|
* - All key parts are right justified in their fields, padded on
|
|
* the left with zeroes.
|
|
* - length(bp_key) = inputdatalength/2 + 8
|
|
* - length(bq_key) = inputdatalength/2
|
|
* - length(np_key) = inputdatalength/2 + 8
|
|
* - length(nq_key) = inputdatalength/2
|
|
* - length(u_mult_inv) = inputdatalength/2 + 8
|
|
*/
|
|
struct ica_rsa_modexpo_crt {
|
|
char __user * inputdata;
|
|
unsigned int inputdatalength;
|
|
char __user * outputdata;
|
|
unsigned int outputdatalength;
|
|
char __user * bp_key;
|
|
char __user * bq_key;
|
|
char __user * np_prime;
|
|
char __user * nq_prime;
|
|
char __user * u_mult_inv;
|
|
};
|
|
|
|
/**
|
|
* CPRBX
|
|
* Note that all shorts and ints are big-endian.
|
|
* All pointer fields are 16 bytes long, and mean nothing.
|
|
*
|
|
* A request CPRB is followed by a request_parameter_block.
|
|
*
|
|
* The request (or reply) parameter block is organized thus:
|
|
* function code
|
|
* VUD block
|
|
* key block
|
|
*/
|
|
struct CPRBX {
|
|
unsigned short cprb_len; /* CPRB length 220 */
|
|
unsigned char cprb_ver_id; /* CPRB version id. 0x02 */
|
|
unsigned char pad_000[3]; /* Alignment pad bytes */
|
|
unsigned char func_id[2]; /* function id 0x5432 */
|
|
unsigned char cprb_flags[4]; /* Flags */
|
|
unsigned int req_parml; /* request parameter buffer len */
|
|
unsigned int req_datal; /* request data buffer */
|
|
unsigned int rpl_msgbl; /* reply message block length */
|
|
unsigned int rpld_parml; /* replied parameter block len */
|
|
unsigned int rpl_datal; /* reply data block len */
|
|
unsigned int rpld_datal; /* replied data block len */
|
|
unsigned int req_extbl; /* request extension block len */
|
|
unsigned char pad_001[4]; /* reserved */
|
|
unsigned int rpld_extbl; /* replied extension block len */
|
|
unsigned char padx000[16 - sizeof (char *)];
|
|
unsigned char * req_parmb; /* request parm block 'address' */
|
|
unsigned char padx001[16 - sizeof (char *)];
|
|
unsigned char * req_datab; /* request data block 'address' */
|
|
unsigned char padx002[16 - sizeof (char *)];
|
|
unsigned char * rpl_parmb; /* reply parm block 'address' */
|
|
unsigned char padx003[16 - sizeof (char *)];
|
|
unsigned char * rpl_datab; /* reply data block 'address' */
|
|
unsigned char padx004[16 - sizeof (char *)];
|
|
unsigned char * req_extb; /* request extension block 'addr'*/
|
|
unsigned char padx005[16 - sizeof (char *)];
|
|
unsigned char * rpl_extb; /* reply extension block 'address'*/
|
|
unsigned short ccp_rtcode; /* server return code */
|
|
unsigned short ccp_rscode; /* server reason code */
|
|
unsigned int mac_data_len; /* Mac Data Length */
|
|
unsigned char logon_id[8]; /* Logon Identifier */
|
|
unsigned char mac_value[8]; /* Mac Value */
|
|
unsigned char mac_content_flgs;/* Mac content flag byte */
|
|
unsigned char pad_002; /* Alignment */
|
|
unsigned short domain; /* Domain */
|
|
unsigned char usage_domain[4];/* Usage domain */
|
|
unsigned char cntrl_domain[4];/* Control domain */
|
|
unsigned char S390enf_mask[4];/* S/390 enforcement mask */
|
|
unsigned char pad_004[36]; /* reserved */
|
|
} __attribute__((packed));
|
|
|
|
/**
|
|
* xcRB
|
|
*/
|
|
struct ica_xcRB {
|
|
unsigned short agent_ID;
|
|
unsigned int user_defined;
|
|
unsigned short request_ID;
|
|
unsigned int request_control_blk_length;
|
|
unsigned char padding1[16 - sizeof (char *)];
|
|
char __user * request_control_blk_addr;
|
|
unsigned int request_data_length;
|
|
char padding2[16 - sizeof (char *)];
|
|
char __user * request_data_address;
|
|
unsigned int reply_control_blk_length;
|
|
char padding3[16 - sizeof (char *)];
|
|
char __user * reply_control_blk_addr;
|
|
unsigned int reply_data_length;
|
|
char padding4[16 - sizeof (char *)];
|
|
char __user * reply_data_addr;
|
|
unsigned short priority_window;
|
|
unsigned int status;
|
|
} __attribute__((packed));
|
|
|
|
/**
|
|
* struct ep11_cprb - EP11 connectivity programming request block
|
|
* @cprb_len: CPRB header length [0x0020]
|
|
* @cprb_ver_id: CPRB version id. [0x04]
|
|
* @pad_000: Alignment pad bytes
|
|
* @flags: Admin cmd [0x80] or functional cmd [0x00]
|
|
* @func_id: Function id / subtype [0x5434]
|
|
* @source_id: Source id [originator id]
|
|
* @target_id: Target id [usage/ctrl domain id]
|
|
* @ret_code: Return code
|
|
* @reserved1: Reserved
|
|
* @reserved2: Reserved
|
|
* @payload_len: Payload length
|
|
*/
|
|
struct ep11_cprb {
|
|
uint16_t cprb_len;
|
|
unsigned char cprb_ver_id;
|
|
unsigned char pad_000[2];
|
|
unsigned char flags;
|
|
unsigned char func_id[2];
|
|
uint32_t source_id;
|
|
uint32_t target_id;
|
|
uint32_t ret_code;
|
|
uint32_t reserved1;
|
|
uint32_t reserved2;
|
|
uint32_t payload_len;
|
|
} __attribute__((packed));
|
|
|
|
/**
|
|
* struct ep11_target_dev - EP11 target device list
|
|
* @ap_id: AP device id
|
|
* @dom_id: Usage domain id
|
|
*/
|
|
struct ep11_target_dev {
|
|
uint16_t ap_id;
|
|
uint16_t dom_id;
|
|
};
|
|
|
|
/**
|
|
* struct ep11_urb - EP11 user request block
|
|
* @targets_num: Number of target adapters
|
|
* @targets: Addr to target adapter list
|
|
* @weight: Level of request priority
|
|
* @req_no: Request id/number
|
|
* @req_len: Request length
|
|
* @req: Addr to request block
|
|
* @resp_len: Response length
|
|
* @resp: Addr to response block
|
|
*/
|
|
struct ep11_urb {
|
|
uint16_t targets_num;
|
|
uint64_t targets;
|
|
uint64_t weight;
|
|
uint64_t req_no;
|
|
uint64_t req_len;
|
|
uint64_t req;
|
|
uint64_t resp_len;
|
|
uint64_t resp;
|
|
} __attribute__((packed));
|
|
|
|
/**
|
|
* struct zcrypt_device_status
|
|
* @hwtype: raw hardware type
|
|
* @qid: 6 bit device index, 8 bit domain
|
|
* @functions: AP device function bit field 'abcdef'
|
|
* a, b, c = reserved
|
|
* d = CCA coprocessor
|
|
* e = Accelerator
|
|
* f = EP11 coprocessor
|
|
* @online online status
|
|
* @reserved reserved
|
|
*/
|
|
struct zcrypt_device_status {
|
|
unsigned int hwtype:8;
|
|
unsigned int qid:14;
|
|
unsigned int online:1;
|
|
unsigned int functions:6;
|
|
unsigned int reserved:3;
|
|
};
|
|
|
|
#define MAX_ZDEV_CARDIDS 64
|
|
#define MAX_ZDEV_DOMAINS 256
|
|
|
|
/**
|
|
* Maximum number of zcrypt devices
|
|
*/
|
|
#define MAX_ZDEV_ENTRIES (MAX_ZDEV_CARDIDS * MAX_ZDEV_DOMAINS)
|
|
|
|
/**
|
|
* zcrypt_device_matrix
|
|
* Device matrix of all zcrypt devices
|
|
*/
|
|
struct zcrypt_device_matrix {
|
|
struct zcrypt_device_status device[MAX_ZDEV_ENTRIES];
|
|
};
|
|
|
|
#define AUTOSELECT ((unsigned int)0xFFFFFFFF)
|
|
|
|
#define ZCRYPT_IOCTL_MAGIC 'z'
|
|
|
|
/**
|
|
* Interface notes:
|
|
*
|
|
* The ioctl()s which are implemented (along with relevant details)
|
|
* are:
|
|
*
|
|
* ICARSAMODEXPO
|
|
* Perform an RSA operation using a Modulus-Exponent pair
|
|
* This takes an ica_rsa_modexpo struct as its arg.
|
|
*
|
|
* NOTE: please refer to the comments preceding this structure
|
|
* for the implementation details for the contents of the
|
|
* block
|
|
*
|
|
* ICARSACRT
|
|
* Perform an RSA operation using a Chinese-Remainder Theorem key
|
|
* This takes an ica_rsa_modexpo_crt struct as its arg.
|
|
*
|
|
* NOTE: please refer to the comments preceding this structure
|
|
* for the implementation details for the contents of the
|
|
* block
|
|
*
|
|
* ZSECSENDCPRB
|
|
* Send an arbitrary CPRB to a crypto card.
|
|
*
|
|
* ZSENDEP11CPRB
|
|
* Send an arbitrary EP11 CPRB to an EP11 coprocessor crypto card.
|
|
*
|
|
* Z90STAT_STATUS_MASK
|
|
* Return an 64 element array of unsigned chars for the status of
|
|
* all devices.
|
|
* 0x01: PCICA
|
|
* 0x02: PCICC
|
|
* 0x03: PCIXCC_MCL2
|
|
* 0x04: PCIXCC_MCL3
|
|
* 0x05: CEX2C
|
|
* 0x06: CEX2A
|
|
* 0x0d: device is disabled via the proc filesystem
|
|
*
|
|
* Z90STAT_QDEPTH_MASK
|
|
* Return an 64 element array of unsigned chars for the queue
|
|
* depth of all devices.
|
|
*
|
|
* Z90STAT_PERDEV_REQCNT
|
|
* Return an 64 element array of unsigned integers for the number
|
|
* of successfully completed requests per device since the device
|
|
* was detected and made available.
|
|
*
|
|
* Z90STAT_REQUESTQ_COUNT
|
|
* Return an integer count of the number of entries waiting to be
|
|
* sent to a device.
|
|
*
|
|
* Z90STAT_PENDINGQ_COUNT
|
|
* Return an integer count of the number of entries sent to all
|
|
* devices awaiting the reply.
|
|
*
|
|
* Z90STAT_TOTALOPEN_COUNT
|
|
* Return an integer count of the number of open file handles.
|
|
*
|
|
* Z90STAT_DOMAIN_INDEX
|
|
* Return the integer value of the Cryptographic Domain.
|
|
*
|
|
* The following ioctls are deprecated and should be no longer used:
|
|
*
|
|
* Z90STAT_TOTALCOUNT
|
|
* Return an integer count of all device types together.
|
|
*
|
|
* Z90STAT_PCICACOUNT
|
|
* Return an integer count of all PCICAs.
|
|
*
|
|
* Z90STAT_PCICCCOUNT
|
|
* Return an integer count of all PCICCs.
|
|
*
|
|
* Z90STAT_PCIXCCMCL2COUNT
|
|
* Return an integer count of all MCL2 PCIXCCs.
|
|
*
|
|
* Z90STAT_PCIXCCMCL3COUNT
|
|
* Return an integer count of all MCL3 PCIXCCs.
|
|
*
|
|
* Z90STAT_CEX2CCOUNT
|
|
* Return an integer count of all CEX2Cs.
|
|
*
|
|
* Z90STAT_CEX2ACOUNT
|
|
* Return an integer count of all CEX2As.
|
|
*
|
|
* ICAZ90STATUS
|
|
* Return some device driver status in a ica_z90_status struct
|
|
* This takes an ica_z90_status struct as its arg.
|
|
*
|
|
* Z90STAT_PCIXCCCOUNT
|
|
* Return an integer count of all PCIXCCs (MCL2 + MCL3).
|
|
* This is DEPRECATED now that MCL3 PCIXCCs are treated differently from
|
|
* MCL2 PCIXCCs.
|
|
*/
|
|
|
|
/**
|
|
* Supported ioctl calls
|
|
*/
|
|
#define ICARSAMODEXPO _IOC(_IOC_READ|_IOC_WRITE, ZCRYPT_IOCTL_MAGIC, 0x05, 0)
|
|
#define ICARSACRT _IOC(_IOC_READ|_IOC_WRITE, ZCRYPT_IOCTL_MAGIC, 0x06, 0)
|
|
#define ZSECSENDCPRB _IOC(_IOC_READ|_IOC_WRITE, ZCRYPT_IOCTL_MAGIC, 0x81, 0)
|
|
#define ZSENDEP11CPRB _IOC(_IOC_READ|_IOC_WRITE, ZCRYPT_IOCTL_MAGIC, 0x04, 0)
|
|
#define ZDEVICESTATUS _IOC(_IOC_READ|_IOC_WRITE, ZCRYPT_IOCTL_MAGIC, 0x4f, 0)
|
|
|
|
/* New status calls */
|
|
#define Z90STAT_TOTALCOUNT _IOR(ZCRYPT_IOCTL_MAGIC, 0x40, int)
|
|
#define Z90STAT_PCICACOUNT _IOR(ZCRYPT_IOCTL_MAGIC, 0x41, int)
|
|
#define Z90STAT_PCICCCOUNT _IOR(ZCRYPT_IOCTL_MAGIC, 0x42, int)
|
|
#define Z90STAT_PCIXCCMCL2COUNT _IOR(ZCRYPT_IOCTL_MAGIC, 0x4b, int)
|
|
#define Z90STAT_PCIXCCMCL3COUNT _IOR(ZCRYPT_IOCTL_MAGIC, 0x4c, int)
|
|
#define Z90STAT_CEX2CCOUNT _IOR(ZCRYPT_IOCTL_MAGIC, 0x4d, int)
|
|
#define Z90STAT_CEX2ACOUNT _IOR(ZCRYPT_IOCTL_MAGIC, 0x4e, int)
|
|
#define Z90STAT_REQUESTQ_COUNT _IOR(ZCRYPT_IOCTL_MAGIC, 0x44, int)
|
|
#define Z90STAT_PENDINGQ_COUNT _IOR(ZCRYPT_IOCTL_MAGIC, 0x45, int)
|
|
#define Z90STAT_TOTALOPEN_COUNT _IOR(ZCRYPT_IOCTL_MAGIC, 0x46, int)
|
|
#define Z90STAT_DOMAIN_INDEX _IOR(ZCRYPT_IOCTL_MAGIC, 0x47, int)
|
|
#define Z90STAT_STATUS_MASK _IOR(ZCRYPT_IOCTL_MAGIC, 0x48, char[64])
|
|
#define Z90STAT_QDEPTH_MASK _IOR(ZCRYPT_IOCTL_MAGIC, 0x49, char[64])
|
|
#define Z90STAT_PERDEV_REQCNT _IOR(ZCRYPT_IOCTL_MAGIC, 0x4a, int[64])
|
|
|
|
#endif /* __ASM_S390_ZCRYPT_H */
|