drivers/s390/crypto/zcrypt_api.h

   1 /*
   2  *  zcrypt 2.1.0
   3  *
   4  *  Copyright IBM Corp. 2001, 2012
   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>
  12  *  MSGTYPE restruct:             Holger Dengler <hd@linux.vnet.ibm.com>
  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
  32 #include <linux/atomic.h>
  33 #include <asm/debug.h>
  34 #include <asm/zcrypt.h>
  35 #include "ap_bus.h"
  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
  75 #define ZCRYPT_CEX3C            7
  76 #define ZCRYPT_CEX3A            8
  77 #define ZCRYPT_CEX4            10
  78 #define ZCRYPT_CEX5            11
  79 #define ZCRYPT_CEX6            12
  80
  81 /**
  82  * Large random numbers are pulled in 4096 byte chunks from the crypto cards
  83  * and stored in a page. Be careful when increasing this buffer due to size
  84  * limitations for AP requests.
  85  */
  86 #define ZCRYPT_RNG_BUFFER_SIZE  4096
  87
  88 /*
  89  * Identifier for Crypto Request Performance Index
  90  */
  91 enum crypto_ops {
  92         MEX_1K,
  93         MEX_2K,
  94         MEX_4K,
  95         CRT_1K,
  96         CRT_2K,
  97         CRT_4K,
  98         HWRNG,
  99         SECKEY,
 100         NUM_OPS
 101 };
 102
 103 struct zcrypt_queue;
 104
 105 struct zcrypt_ops {
 106         long (*rsa_modexpo)(struct zcrypt_queue *, struct ica_rsa_modexpo *);
 107         long (*rsa_modexpo_crt)(struct zcrypt_queue *,
 108                                 struct ica_rsa_modexpo_crt *);
 109         long (*send_cprb)(struct zcrypt_queue *, struct ica_xcRB *,
 110                           struct ap_message *);
 111         long (*send_ep11_cprb)(struct zcrypt_queue *, struct ep11_urb *,
 112                                struct ap_message *);
 113         long (*rng)(struct zcrypt_queue *, char *, struct ap_message *);
 114         struct list_head list;          /* zcrypt ops list. */
 115         struct module *owner;
 116         int variant;
 117         char name[128];
 118 };
 119
 120 struct zcrypt_card {
 121         struct list_head list;          /* Device list. */
 122         struct list_head zqueues;       /* List of zcrypt queues */
 123         struct kref refcount;           /* device refcounting */
 124         struct ap_card *card;           /* The "real" ap card device. */
 125         int online;                     /* User online/offline */
 126
 127         int user_space_type;            /* User space device id. */
 128         char *type_string;              /* User space device name. */
 129         int min_mod_size;               /* Min number of bits. */
 130         int max_mod_size;               /* Max number of bits. */
 131         int max_exp_bit_length;
 132         int speed_rating[NUM_OPS];      /* Speed idx of crypto ops. */
 133         atomic_t load;                  /* Utilization of the crypto device */
 134
 135         int request_count;              /* # current requests. */
 136 };
 137
 138 struct zcrypt_queue {
 139         struct list_head list;          /* Device list. */
 140         struct kref refcount;           /* device refcounting */
 141         struct zcrypt_card *zcard;
 142         struct zcrypt_ops *ops;         /* Crypto operations. */
 143         struct ap_queue *queue;         /* The "real" ap queue device. */
 144         int online;                     /* User online/offline */
 145
 146         atomic_t load;                  /* Utilization of the crypto device */
 147
 148         int request_count;              /* # current requests. */
 149
 150         struct ap_message reply;        /* Per-device reply structure. */
 151 };
 152
 153 /* transport layer rescanning */
 154 extern atomic_t zcrypt_rescan_req;
 155
 156 extern spinlock_t zcrypt_list_lock;
 157 extern int zcrypt_device_count;
 158 extern struct list_head zcrypt_card_list;
 159
 160 #define for_each_zcrypt_card(_zc) \
 161         list_for_each_entry(_zc, &zcrypt_card_list, list)
 162
 163 #define for_each_zcrypt_queue(_zq, _zc) \
 164         list_for_each_entry(_zq, &(_zc)->zqueues, list)
 165
 166 struct zcrypt_card *zcrypt_card_alloc(void);
 167 void zcrypt_card_free(struct zcrypt_card *);
 168 void zcrypt_card_get(struct zcrypt_card *);
 169 int zcrypt_card_put(struct zcrypt_card *);
 170 int zcrypt_card_register(struct zcrypt_card *);
 171 void zcrypt_card_unregister(struct zcrypt_card *);
 172 struct zcrypt_card *zcrypt_card_get_best(unsigned int *,
 173                                          unsigned int, unsigned int);
 174 void zcrypt_card_put_best(struct zcrypt_card *, unsigned int);
 175
 176 struct zcrypt_queue *zcrypt_queue_alloc(size_t);
 177 void zcrypt_queue_free(struct zcrypt_queue *);
 178 void zcrypt_queue_get(struct zcrypt_queue *);
 179 int zcrypt_queue_put(struct zcrypt_queue *);
 180 int zcrypt_queue_register(struct zcrypt_queue *);
 181 void zcrypt_queue_unregister(struct zcrypt_queue *);
 182 void zcrypt_queue_force_online(struct zcrypt_queue *, int);
 183 struct zcrypt_queue *zcrypt_queue_get_best(unsigned int, unsigned int);
 184 void  zcrypt_queue_put_best(struct zcrypt_queue *, unsigned int);
 185
 186 int zcrypt_rng_device_add(void);
 187 void zcrypt_rng_device_remove(void);
 188
 189 void zcrypt_msgtype_register(struct zcrypt_ops *);
 190 void zcrypt_msgtype_unregister(struct zcrypt_ops *);
 191 struct zcrypt_ops *zcrypt_msgtype(unsigned char *, int);
 192 int zcrypt_api_init(void);
 193 void zcrypt_api_exit(void);
 194 long zcrypt_send_cprb(struct ica_xcRB *xcRB);
 195 void zcrypt_device_status_mask(struct zcrypt_device_matrix *devstatus);
 196
 197 #endif /* _ZCRYPT_API_H_ */