An improved fork of NetBSD's OpenPGP implementation; maintained by the p≡p foundation.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

171 lines
6.1 KiB

13 years ago
13 years ago
13 years ago
13 years ago
13 years ago
13 years ago
13 years ago
13 years ago
  1. /*-
  2. * Copyright (c) 2009 The NetBSD Foundation, Inc.
  3. * All rights reserved.
  4. *
  5. * This code is derived from software contributed to The NetBSD Foundation
  6. * by Alistair Crooks (agc@NetBSD.org)
  7. *
  8. * Redistribution and use in source and binary forms, with or without
  9. * modification, are permitted provided that the following conditions
  10. * are met:
  11. * 1. Redistributions of source code must retain the above copyright
  12. * notice, this list of conditions and the following disclaimer.
  13. * 2. Redistributions in binary form must reproduce the above copyright
  14. * notice, this list of conditions and the following disclaimer in the
  15. * documentation and/or other materials provided with the distribution.
  16. *
  17. * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
  18. * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
  19. * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  20. * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
  21. * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  22. * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  23. * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  24. * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  25. * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  26. * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  27. * POSSIBILITY OF SUCH DAMAGE.
  28. */
  29. /*
  30. * Copyright (c) 2005-2008 Nominet UK (www.nic.uk)
  31. * All rights reserved.
  32. * Contributors: Ben Laurie, Rachel Willmer. The Contributors have asserted
  33. * their moral rights under the UK Copyright Design and Patents Act 1988 to
  34. * be recorded as the authors of this copyright work.
  35. *
  36. * Licensed under the Apache License, Version 2.0 (the "License"); you may not
  37. * use this file except in compliance with the License.
  38. *
  39. * You may obtain a copy of the License at
  40. * http://www.apache.org/licenses/LICENSE-2.0
  41. *
  42. * Unless required by applicable law or agreed to in writing, software
  43. * distributed under the License is distributed on an "AS IS" BASIS,
  44. * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  45. *
  46. * See the License for the specific language governing permissions and
  47. * limitations under the License.
  48. */
  49. /** \file
  50. */
  51. #ifndef KEYRING_H_
  52. #define KEYRING_H_
  53. #include "packet.h"
  54. #include "packet-parse.h"
  55. #include "mj.h"
  56. enum {
  57. MAX_ID_LENGTH = 128,
  58. MAX_PASSPHRASE_LENGTH = 256
  59. };
  60. typedef struct pgp_key_t pgp_key_t;
  61. /** \struct pgp_keyring_t
  62. * A keyring
  63. */
  64. typedef struct pgp_keyring_t {
  65. DYNARRAY(pgp_key_t, key);
  66. pgp_hash_alg_t hashtype;
  67. } pgp_keyring_t;
  68. const pgp_key_t *pgp_getkeybyid(pgp_io_t *,
  69. const pgp_keyring_t *,
  70. const uint8_t *,
  71. unsigned *,
  72. pgp_pubkey_t **);
  73. unsigned pgp_deletekeybyid(pgp_io_t *,
  74. pgp_keyring_t *,
  75. const uint8_t *);
  76. const pgp_key_t *pgp_getkeybyfpr(pgp_io_t *,
  77. const pgp_keyring_t *,
  78. const uint8_t *fpr,
  79. size_t length,
  80. unsigned *,
  81. pgp_pubkey_t **);
  82. unsigned pgp_deletekeybyfpr(pgp_io_t *,
  83. pgp_keyring_t *,
  84. const uint8_t *fpr,
  85. size_t length);
  86. const pgp_key_t *pgp_getkeybyname(pgp_io_t *,
  87. const pgp_keyring_t *,
  88. const char *);
  89. const pgp_key_t *pgp_getnextkeybyname(pgp_io_t *,
  90. const pgp_keyring_t *,
  91. const char *,
  92. unsigned *);
  93. void pgp_key_free(pgp_key_t *);
  94. void pgp_keydata_free(pgp_key_t *);
  95. int pgp_keydata_dup(pgp_key_t *, pgp_key_t *, unsigned);
  96. void pgp_keyring_free(pgp_keyring_t *);
  97. void pgp_dump_keyring(const pgp_keyring_t *);
  98. const pgp_pubkey_t *pgp_get_pubkey(const pgp_key_t *);
  99. unsigned pgp_is_key_secret(const pgp_key_t *);
  100. const pgp_seckey_t *pgp_get_seckey(const pgp_key_t *);
  101. pgp_seckey_t *pgp_get_writable_seckey(pgp_key_t *);
  102. pgp_seckey_t *pgp_decrypt_seckey(const pgp_key_t *, void *);
  103. unsigned pgp_keyring_fileread(pgp_keyring_t *, const unsigned,
  104. const char *);
  105. int pgp_keyring_list(pgp_io_t *, const pgp_keyring_t *, const int);
  106. int pgp_keyring_json(pgp_io_t *, const pgp_keyring_t *, mj_t *, const int);
  107. void pgp_set_seckey(pgp_contents_t *, const pgp_key_t *);
  108. void pgp_forget(void *, unsigned);
  109. const uint8_t *pgp_get_key_id(const pgp_key_t *);
  110. unsigned pgp_get_userid_count(const pgp_key_t *);
  111. const uint8_t *pgp_get_userid(const pgp_key_t *, unsigned);
  112. unsigned pgp_is_key_supported(const pgp_key_t *);
  113. uint8_t *pgp_add_userid(pgp_key_t *, const uint8_t *);
  114. pgp_subpacket_t *pgp_add_subpacket(pgp_key_t *,
  115. const pgp_subpacket_t *);
  116. pgp_subpacket_t *pgp_replace_subpacket(pgp_key_t *,
  117. const pgp_subpacket_t *,
  118. unsigned );
  119. unsigned pgp_add_selfsigned_userid(pgp_key_t *, uint8_t *);
  120. pgp_key_t *pgp_keydata_new(void);
  121. void pgp_keydata_init(pgp_key_t *, const pgp_content_enum);
  122. int pgp_parse_and_accumulate(pgp_keyring_t *, pgp_stream_t *);
  123. int pgp_sprint_keydata(pgp_io_t *, const pgp_keyring_t *,
  124. const pgp_key_t *, char **, const char *,
  125. const pgp_pubkey_t *, const int);
  126. int pgp_sprint_mj(pgp_io_t *, const pgp_keyring_t *,
  127. const pgp_key_t *, mj_t *, const char *,
  128. const pgp_pubkey_t *, const int);
  129. int pgp_hkp_sprint_keydata(pgp_io_t *, const pgp_keyring_t *,
  130. const pgp_key_t *, char **,
  131. const pgp_pubkey_t *, const int);
  132. void pgp_print_keydata(pgp_io_t *, const pgp_keyring_t *, const pgp_key_t *,
  133. const char *, const pgp_pubkey_t *, const int);
  134. void pgp_print_sig(pgp_io_t *, const pgp_key_t *, const char *,
  135. const pgp_pubkey_t *);
  136. void pgp_print_pubkey(const pgp_pubkey_t *);
  137. int pgp_sprint_pubkey(const pgp_key_t *, char *, size_t);
  138. int pgp_list_packets(pgp_io_t *,
  139. char *,
  140. unsigned,
  141. pgp_keyring_t *,
  142. pgp_keyring_t *,
  143. void *,
  144. pgp_cbfunc_t *);
  145. char *pgp_export_key(pgp_io_t *, const pgp_key_t *, uint8_t *);
  146. int pgp_keyring_add(pgp_keyring_t *, const pgp_key_t *);
  147. int pgp_add_to_pubring(pgp_keyring_t *, const pgp_pubkey_t *, pgp_content_enum tag);
  148. int pgp_add_to_secring(pgp_keyring_t *, const pgp_seckey_t *);
  149. int pgp_append_keyring(pgp_keyring_t *, pgp_keyring_t *);
  150. #endif /* KEYRING_H_ */