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