zcrypt_api.h 4.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125
  1. /*
  2. * linux/drivers/s390/crypto/zcrypt_api.h
  3. *
  4. * zcrypt 2.1.0
  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. #ifndef _ZCRYPT_API_H_
  30. #define _ZCRYPT_API_H_
  31. #include "ap_bus.h"
  32. #include <asm/zcrypt.h>
  33. /* deprecated status calls */
  34. #define ICAZ90STATUS _IOR(ZCRYPT_IOCTL_MAGIC, 0x10, struct ica_z90_status)
  35. #define Z90STAT_PCIXCCCOUNT _IOR(ZCRYPT_IOCTL_MAGIC, 0x43, int)
  36. /**
  37. * This structure is deprecated and the corresponding ioctl() has been
  38. * replaced with individual ioctl()s for each piece of data!
  39. */
  40. struct ica_z90_status {
  41. int totalcount;
  42. int leedslitecount; // PCICA
  43. int leeds2count; // PCICC
  44. // int PCIXCCCount; is not in struct for backward compatibility
  45. int requestqWaitCount;
  46. int pendingqWaitCount;
  47. int totalOpenCount;
  48. int cryptoDomain;
  49. // status: 0=not there, 1=PCICA, 2=PCICC, 3=PCIXCC_MCL2, 4=PCIXCC_MCL3,
  50. // 5=CEX2C
  51. unsigned char status[64];
  52. // qdepth: # work elements waiting for each device
  53. unsigned char qdepth[64];
  54. };
  55. /**
  56. * device type for an actual device is either PCICA, PCICC, PCIXCC_MCL2,
  57. * PCIXCC_MCL3, CEX2C, or CEX2A
  58. *
  59. * NOTE: PCIXCC_MCL3 refers to a PCIXCC with May 2004 version of Licensed
  60. * Internal Code (LIC) (EC J12220 level 29).
  61. * PCIXCC_MCL2 refers to any LIC before this level.
  62. */
  63. #define ZCRYPT_PCICA 1
  64. #define ZCRYPT_PCICC 2
  65. #define ZCRYPT_PCIXCC_MCL2 3
  66. #define ZCRYPT_PCIXCC_MCL3 4
  67. #define ZCRYPT_CEX2C 5
  68. #define ZCRYPT_CEX2A 6
  69. #define ZCRYPT_CEX3C 7
  70. #define ZCRYPT_CEX3A 8
  71. /**
  72. * Large random numbers are pulled in 4096 byte chunks from the crypto cards
  73. * and stored in a page. Be careful when increasing this buffer due to size
  74. * limitations for AP requests.
  75. */
  76. #define ZCRYPT_RNG_BUFFER_SIZE 4096
  77. struct zcrypt_device;
  78. struct zcrypt_ops {
  79. long (*rsa_modexpo)(struct zcrypt_device *, struct ica_rsa_modexpo *);
  80. long (*rsa_modexpo_crt)(struct zcrypt_device *,
  81. struct ica_rsa_modexpo_crt *);
  82. long (*send_cprb)(struct zcrypt_device *, struct ica_xcRB *);
  83. long (*rng)(struct zcrypt_device *, char *);
  84. };
  85. struct zcrypt_device {
  86. struct list_head list; /* Device list. */
  87. spinlock_t lock; /* Per device lock. */
  88. struct kref refcount; /* device refcounting */
  89. struct ap_device *ap_dev; /* The "real" ap device. */
  90. struct zcrypt_ops *ops; /* Crypto operations. */
  91. int online; /* User online/offline */
  92. int user_space_type; /* User space device id. */
  93. char *type_string; /* User space device name. */
  94. int min_mod_size; /* Min number of bits. */
  95. int max_mod_size; /* Max number of bits. */
  96. int short_crt; /* Card has crt length restriction. */
  97. int speed_rating; /* Speed of the crypto device. */
  98. int request_count; /* # current requests. */
  99. struct ap_message reply; /* Per-device reply structure. */
  100. int max_exp_bit_length;
  101. };
  102. struct zcrypt_device *zcrypt_device_alloc(size_t);
  103. void zcrypt_device_free(struct zcrypt_device *);
  104. void zcrypt_device_get(struct zcrypt_device *);
  105. int zcrypt_device_put(struct zcrypt_device *);
  106. int zcrypt_device_register(struct zcrypt_device *);
  107. void zcrypt_device_unregister(struct zcrypt_device *);
  108. int zcrypt_api_init(void);
  109. void zcrypt_api_exit(void);
  110. #endif /* _ZCRYPT_API_H_ */