user_defined.c 4.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222
  1. /* user_defined.c: user defined key type
  2. *
  3. * Copyright (C) 2004 Red Hat, Inc. All Rights Reserved.
  4. * Written by David Howells (dhowells@redhat.com)
  5. *
  6. * This program is free software; you can redistribute it and/or
  7. * modify it under the terms of the GNU General Public License
  8. * as published by the Free Software Foundation; either version
  9. * 2 of the License, or (at your option) any later version.
  10. */
  11. #include <linux/module.h>
  12. #include <linux/init.h>
  13. #include <linux/slab.h>
  14. #include <linux/seq_file.h>
  15. #include <linux/err.h>
  16. #include <keys/user-type.h>
  17. #include <asm/uaccess.h>
  18. #include "internal.h"
  19. static int logon_vet_description(const char *desc);
  20. /*
  21. * user defined keys take an arbitrary string as the description and an
  22. * arbitrary blob of data as the payload
  23. */
  24. struct key_type key_type_user = {
  25. .name = "user",
  26. .preparse = user_preparse,
  27. .free_preparse = user_free_preparse,
  28. .instantiate = generic_key_instantiate,
  29. .update = user_update,
  30. .revoke = user_revoke,
  31. .destroy = user_destroy,
  32. .describe = user_describe,
  33. .read = user_read,
  34. };
  35. EXPORT_SYMBOL_GPL(key_type_user);
  36. /*
  37. * This key type is essentially the same as key_type_user, but it does
  38. * not define a .read op. This is suitable for storing username and
  39. * password pairs in the keyring that you do not want to be readable
  40. * from userspace.
  41. */
  42. struct key_type key_type_logon = {
  43. .name = "logon",
  44. .preparse = user_preparse,
  45. .free_preparse = user_free_preparse,
  46. .instantiate = generic_key_instantiate,
  47. .update = user_update,
  48. .revoke = user_revoke,
  49. .destroy = user_destroy,
  50. .describe = user_describe,
  51. .vet_description = logon_vet_description,
  52. };
  53. EXPORT_SYMBOL_GPL(key_type_logon);
  54. /*
  55. * Preparse a user defined key payload
  56. */
  57. int user_preparse(struct key_preparsed_payload *prep)
  58. {
  59. struct user_key_payload *upayload;
  60. size_t datalen = prep->datalen;
  61. if (datalen <= 0 || datalen > 32767 || !prep->data)
  62. return -EINVAL;
  63. upayload = kmalloc(sizeof(*upayload) + datalen, GFP_KERNEL);
  64. if (!upayload)
  65. return -ENOMEM;
  66. /* attach the data */
  67. prep->quotalen = datalen;
  68. prep->payload[0] = upayload;
  69. upayload->datalen = datalen;
  70. memcpy(upayload->data, prep->data, datalen);
  71. return 0;
  72. }
  73. EXPORT_SYMBOL_GPL(user_preparse);
  74. /*
  75. * Free a preparse of a user defined key payload
  76. */
  77. void user_free_preparse(struct key_preparsed_payload *prep)
  78. {
  79. kfree(prep->payload[0]);
  80. }
  81. EXPORT_SYMBOL_GPL(user_free_preparse);
  82. /*
  83. * update a user defined key
  84. * - the key's semaphore is write-locked
  85. */
  86. int user_update(struct key *key, struct key_preparsed_payload *prep)
  87. {
  88. struct user_key_payload *upayload, *zap;
  89. size_t datalen = prep->datalen;
  90. int ret;
  91. ret = -EINVAL;
  92. if (datalen <= 0 || datalen > 32767 || !prep->data)
  93. goto error;
  94. /* construct a replacement payload */
  95. ret = -ENOMEM;
  96. upayload = kmalloc(sizeof(*upayload) + datalen, GFP_KERNEL);
  97. if (!upayload)
  98. goto error;
  99. upayload->datalen = datalen;
  100. memcpy(upayload->data, prep->data, datalen);
  101. /* check the quota and attach the new data */
  102. zap = upayload;
  103. ret = key_payload_reserve(key, datalen);
  104. if (ret == 0) {
  105. /* attach the new data, displacing the old */
  106. zap = key->payload.data;
  107. rcu_assign_keypointer(key, upayload);
  108. key->expiry = 0;
  109. }
  110. if (zap)
  111. kfree_rcu(zap, rcu);
  112. error:
  113. return ret;
  114. }
  115. EXPORT_SYMBOL_GPL(user_update);
  116. /*
  117. * dispose of the links from a revoked keyring
  118. * - called with the key sem write-locked
  119. */
  120. void user_revoke(struct key *key)
  121. {
  122. struct user_key_payload *upayload = key->payload.data;
  123. /* clear the quota */
  124. key_payload_reserve(key, 0);
  125. if (upayload) {
  126. rcu_assign_keypointer(key, NULL);
  127. kfree_rcu(upayload, rcu);
  128. }
  129. }
  130. EXPORT_SYMBOL(user_revoke);
  131. /*
  132. * dispose of the data dangling from the corpse of a user key
  133. */
  134. void user_destroy(struct key *key)
  135. {
  136. struct user_key_payload *upayload = key->payload.data;
  137. kfree(upayload);
  138. }
  139. EXPORT_SYMBOL_GPL(user_destroy);
  140. /*
  141. * describe the user key
  142. */
  143. void user_describe(const struct key *key, struct seq_file *m)
  144. {
  145. seq_puts(m, key->description);
  146. if (key_is_instantiated(key))
  147. seq_printf(m, ": %u", key->datalen);
  148. }
  149. EXPORT_SYMBOL_GPL(user_describe);
  150. /*
  151. * read the key data
  152. * - the key's semaphore is read-locked
  153. */
  154. long user_read(const struct key *key, char __user *buffer, size_t buflen)
  155. {
  156. struct user_key_payload *upayload;
  157. long ret;
  158. upayload = rcu_dereference_key(key);
  159. ret = upayload->datalen;
  160. /* we can return the data as is */
  161. if (buffer && buflen > 0) {
  162. if (buflen > upayload->datalen)
  163. buflen = upayload->datalen;
  164. if (copy_to_user(buffer, upayload->data, buflen) != 0)
  165. ret = -EFAULT;
  166. }
  167. return ret;
  168. }
  169. EXPORT_SYMBOL_GPL(user_read);
  170. /* Vet the description for a "logon" key */
  171. static int logon_vet_description(const char *desc)
  172. {
  173. char *p;
  174. /* require a "qualified" description string */
  175. p = strchr(desc, ':');
  176. if (!p)
  177. return -EINVAL;
  178. /* also reject description with ':' as first char */
  179. if (p == desc)
  180. return -EINVAL;
  181. return 0;
  182. }