[deliverable/linux.git] / drivers / s390 / crypto / zcrypt_api.h

/*
 *  zcrypt 2.1.0
 *
 *  Copyright IBM Corp. 2001, 2012
 *  Author(s): Robert Burroughs
 *	       Eric Rossman (edrossma@us.ibm.com)
 *	       Cornelia Huck <cornelia.huck@de.ibm.com>
 *
 *  Hotplug & misc device support: Jochen Roehrig (roehrig@de.ibm.com)
 *  Major cleanup & driver split: Martin Schwidefsky <schwidefsky@de.ibm.com>
 *				  Ralph Wuerthner <rwuerthn@de.ibm.com>
 *  MSGTYPE restruct:		  Holger Dengler <hd@linux.vnet.ibm.com>
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2, or (at your option)
 * any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
 */

#ifndef _ZCRYPT_API_H_
#define _ZCRYPT_API_H_

#include <linux/atomic.h>
#include <asm/debug.h>
#include <asm/zcrypt.h>
#include "ap_bus.h"

/* deprecated status calls */
#define ICAZ90STATUS		_IOR(ZCRYPT_IOCTL_MAGIC, 0x10, struct ica_z90_status)
#define Z90STAT_PCIXCCCOUNT	_IOR(ZCRYPT_IOCTL_MAGIC, 0x43, int)

/**
 * This structure is deprecated and the corresponding ioctl() has been
 * replaced with individual ioctl()s for each piece of data!
 */
struct ica_z90_status {
	int totalcount;
	int leedslitecount; // PCICA
	int leeds2count;    // PCICC
	// int PCIXCCCount; is not in struct for backward compatibility
	int requestqWaitCount;
	int pendingqWaitCount;
	int totalOpenCount;
	int cryptoDomain;
	// status: 0=not there, 1=PCICA, 2=PCICC, 3=PCIXCC_MCL2, 4=PCIXCC_MCL3,
	//	   5=CEX2C
	unsigned char status[64];
	// qdepth: # work elements waiting for each device
	unsigned char qdepth[64];
};

/**
 * device type for an actual device is either PCICA, PCICC, PCIXCC_MCL2,
 * PCIXCC_MCL3, CEX2C, or CEX2A
 *
 * NOTE: PCIXCC_MCL3 refers to a PCIXCC with May 2004 version of Licensed
 *	 Internal Code (LIC) (EC J12220 level 29).
 *	 PCIXCC_MCL2 refers to any LIC before this level.
 */
#define ZCRYPT_PCICA		1
#define ZCRYPT_PCICC		2
#define ZCRYPT_PCIXCC_MCL2	3
#define ZCRYPT_PCIXCC_MCL3	4
#define ZCRYPT_CEX2C		5
#define ZCRYPT_CEX2A		6
#define ZCRYPT_CEX3C		7
#define ZCRYPT_CEX3A		8

/**
 * Large random numbers are pulled in 4096 byte chunks from the crypto cards
 * and stored in a page. Be careful when increasing this buffer due to size
 * limitations for AP requests.
 */
#define ZCRYPT_RNG_BUFFER_SIZE	4096

struct zcrypt_device;

struct zcrypt_ops {
	long (*rsa_modexpo)(struct zcrypt_device *, struct ica_rsa_modexpo *);
	long (*rsa_modexpo_crt)(struct zcrypt_device *,
				struct ica_rsa_modexpo_crt *);
	long (*send_cprb)(struct zcrypt_device *, struct ica_xcRB *);
	long (*rng)(struct zcrypt_device *, char *);
	struct list_head list;		/* zcrypt ops list. */
	struct module *owner;
	int variant;
};

struct zcrypt_device {
	struct list_head list;		/* Device list. */
	spinlock_t lock;		/* Per device lock. */
	struct kref refcount;		/* device refcounting */
	struct ap_device *ap_dev;	/* The "real" ap device. */
	struct zcrypt_ops *ops;		/* Crypto operations. */
	int online;			/* User online/offline */

	int user_space_type;		/* User space device id. */
	char *type_string;		/* User space device name. */
	int min_mod_size;		/* Min number of bits. */
	int max_mod_size;		/* Max number of bits. */
	int short_crt;			/* Card has crt length restriction. */
	int speed_rating;		/* Speed of the crypto device. */

	int request_count;		/* # current requests. */

	struct ap_message reply;	/* Per-device reply structure. */
	int max_exp_bit_length;

	debug_info_t *dbf_area;		/* debugging */
};

/* transport layer rescanning */
extern atomic_t zcrypt_rescan_req;

struct zcrypt_device *zcrypt_device_alloc(size_t);
void zcrypt_device_free(struct zcrypt_device *);
void zcrypt_device_get(struct zcrypt_device *);
int zcrypt_device_put(struct zcrypt_device *);
int zcrypt_device_register(struct zcrypt_device *);
void zcrypt_device_unregister(struct zcrypt_device *);
void zcrypt_msgtype_register(struct zcrypt_ops *);
void zcrypt_msgtype_unregister(struct zcrypt_ops *);
struct zcrypt_ops *zcrypt_msgtype_request(unsigned char *, int);
void zcrypt_msgtype_release(struct zcrypt_ops *);
int zcrypt_api_init(void);
void zcrypt_api_exit(void);

#endif /* _ZCRYPT_API_H_ */
Commit	Line	Data
2dbc2418	1	/*
5432114b	2	* zcrypt 2.1.0
2dbc2418	3	*
5e55a488	4	* Copyright IBM Corp. 2001, 2012
2dbc2418 MS	5	* Author(s): Robert Burroughs
	6	* Eric Rossman (edrossma@us.ibm.com)
	7	* Cornelia Huck <cornelia.huck@de.ibm.com>
	8	*
	9	* Hotplug & misc device support: Jochen Roehrig (roehrig@de.ibm.com)
	10	* Major cleanup & driver split: Martin Schwidefsky <schwidefsky@de.ibm.com>
	11	* Ralph Wuerthner <rwuerthn@de.ibm.com>
5e55a488	12	* MSGTYPE restruct: Holger Dengler <hd@linux.vnet.ibm.com>
2dbc2418 MS	13	*
	14	* This program is free software; you can redistribute it and/or modify
	15	* it under the terms of the GNU General Public License as published by
	16	* the Free Software Foundation; either version 2, or (at your option)
	17	* any later version.
	18	*
	19	* This program is distributed in the hope that it will be useful,
	20	* but WITHOUT ANY WARRANTY; without even the implied warranty of
	21	* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
	22	* GNU General Public License for more details.
	23	*
	24	* You should have received a copy of the GNU General Public License
	25	* along with this program; if not, write to the Free Software
	26	* Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
	27	*/
	28
	29	#ifndef _ZCRYPT_API_H_
	30	#define _ZCRYPT_API_H_
	31
dabecb29 HD	32	#include <linux/atomic.h>
dabecb29 HD	33	#include <asm/debug.h>
2dbc2418	34	#include <asm/zcrypt.h>
dabecb29	35	#include "ap_bus.h"
2dbc2418 MS	36
	37	/* deprecated status calls */
	38	#define ICAZ90STATUS _IOR(ZCRYPT_IOCTL_MAGIC, 0x10, struct ica_z90_status)
	39	#define Z90STAT_PCIXCCCOUNT _IOR(ZCRYPT_IOCTL_MAGIC, 0x43, int)
	40
	41	/**
	42	* This structure is deprecated and the corresponding ioctl() has been
	43	* replaced with individual ioctl()s for each piece of data!
	44	*/
	45	struct ica_z90_status {
	46	int totalcount;
	47	int leedslitecount; // PCICA
	48	int leeds2count; // PCICC
	49	// int PCIXCCCount; is not in struct for backward compatibility
	50	int requestqWaitCount;
	51	int pendingqWaitCount;
	52	int totalOpenCount;
	53	int cryptoDomain;
	54	// status: 0=not there, 1=PCICA, 2=PCICC, 3=PCIXCC_MCL2, 4=PCIXCC_MCL3,
	55	// 5=CEX2C
	56	unsigned char status[64];
	57	// qdepth: # work elements waiting for each device
	58	unsigned char qdepth[64];
	59	};
	60
	61	/**
	62	* device type for an actual device is either PCICA, PCICC, PCIXCC_MCL2,
	63	* PCIXCC_MCL3, CEX2C, or CEX2A
	64	*
	65	* NOTE: PCIXCC_MCL3 refers to a PCIXCC with May 2004 version of Licensed
	66	* Internal Code (LIC) (EC J12220 level 29).
	67	* PCIXCC_MCL2 refers to any LIC before this level.
	68	*/
	69	#define ZCRYPT_PCICA 1
	70	#define ZCRYPT_PCICC 2
	71	#define ZCRYPT_PCIXCC_MCL2 3
	72	#define ZCRYPT_PCIXCC_MCL3 4
	73	#define ZCRYPT_CEX2C 5
	74	#define ZCRYPT_CEX2A 6
8e89b6be FB	75	#define ZCRYPT_CEX3C 7
8e89b6be FB	76	#define ZCRYPT_CEX3A 8
2dbc2418	77
2f7c8bd6 RW	78	/**
2f7c8bd6 RW	79	* Large random numbers are pulled in 4096 byte chunks from the crypto cards
25985edc	80	* and stored in a page. Be careful when increasing this buffer due to size
2f7c8bd6 RW	81	* limitations for AP requests.
	82	*/
	83	#define ZCRYPT_RNG_BUFFER_SIZE 4096
	84
2dbc2418 MS	85	struct zcrypt_device;
	86
	87	struct zcrypt_ops {
	88	long (rsa_modexpo)(struct zcrypt_device , struct ica_rsa_modexpo *);
	89	long (rsa_modexpo_crt)(struct zcrypt_device ,
	90	struct ica_rsa_modexpo_crt *);
5432114b	91	long (send_cprb)(struct zcrypt_device , struct ica_xcRB *);
2f7c8bd6	92	long (rng)(struct zcrypt_device , char *);
5e55a488 HD	93	struct list_head list; /* zcrypt ops list. */
	94	struct module *owner;
	95	int variant;
2dbc2418 MS	96	};
	97
	98	struct zcrypt_device {
	99	struct list_head list; /* Device list. */
	100	spinlock_t lock; /* Per device lock. */
	101	struct kref refcount; /* device refcounting */
	102	struct ap_device ap_dev; / The "real" ap device. */
	103	struct zcrypt_ops ops; / Crypto operations. */
	104	int online; /* User online/offline */
	105
	106	int user_space_type; /* User space device id. */
	107	char type_string; / User space device name. */
	108	int min_mod_size; /* Min number of bits. */
	109	int max_mod_size; /* Max number of bits. */
	110	int short_crt; /* Card has crt length restriction. */
	111	int speed_rating; /* Speed of the crypto device. */
	112
	113	int request_count; /* # current requests. */
	114
	115	struct ap_message reply; /* Per-device reply structure. */
c2567f8f	116	int max_exp_bit_length;
dabecb29 HD	117
dabecb29 HD	118	debug_info_t dbf_area; / debugging */
2dbc2418 MS	119	};
2dbc2418 MS	120
dabecb29 HD	121	/* transport layer rescanning */
	122	extern atomic_t zcrypt_rescan_req;
	123
2dbc2418 MS	124	struct zcrypt_device *zcrypt_device_alloc(size_t);
	125	void zcrypt_device_free(struct zcrypt_device *);
	126	void zcrypt_device_get(struct zcrypt_device *);
	127	int zcrypt_device_put(struct zcrypt_device *);
	128	int zcrypt_device_register(struct zcrypt_device *);
	129	void zcrypt_device_unregister(struct zcrypt_device *);
5e55a488 HD	130	void zcrypt_msgtype_register(struct zcrypt_ops *);
	131	void zcrypt_msgtype_unregister(struct zcrypt_ops *);
	132	struct zcrypt_ops zcrypt_msgtype_request(unsigned char , int);
	133	void zcrypt_msgtype_release(struct zcrypt_ops *);
2dbc2418 MS	134	int zcrypt_api_init(void);
	135	void zcrypt_api_exit(void);
	136
	137	#endif /* _ZCRYPT_API_H_ */