licentivo-launch 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (143) hide show
  1. checksums.yaml +7 -0
  2. data/LICENSE +21 -0
  3. data/README.md +35 -0
  4. data/ext/launch_native/extconf.rb +28 -0
  5. data/lib/licentivo_launch/vendor/licentivo.rb +262 -0
  6. data/lib/licentivo_launch.rb +352 -0
  7. data/vendor/LICENSE +21 -0
  8. data/vendor/NOTICE +17 -0
  9. data/vendor/VERSION +1 -0
  10. data/vendor/c/app.c +33 -0
  11. data/vendor/c/demo.c +77 -0
  12. data/vendor/c/feature_tasks.h +72 -0
  13. data/vendor/c/licentivo.c +382 -0
  14. data/vendor/c/licentivo.h +67 -0
  15. data/vendor/c/quickstart.c +51 -0
  16. data/vendor/c/test_vectors.c +4 -0
  17. data/vendor/c/vendor/Monocypher-LICENCE.md +173 -0
  18. data/vendor/c/vendor/cJSON-LICENSE +20 -0
  19. data/vendor/c/vendor/cJSON.c +3191 -0
  20. data/vendor/c/vendor/cJSON.h +306 -0
  21. data/vendor/c/vendor/monocypher-ed25519.c +500 -0
  22. data/vendor/c/vendor/monocypher-ed25519.h +140 -0
  23. data/vendor/c/vendor/monocypher.c +2956 -0
  24. data/vendor/c/vendor/monocypher.h +321 -0
  25. data/vendor/curl/COPYING.txt +22 -0
  26. data/vendor/curl/bin/libcurl-x64.dll +0 -0
  27. data/vendor/curl/include/brotli/decode.h +409 -0
  28. data/vendor/curl/include/brotli/encode.h +505 -0
  29. data/vendor/curl/include/brotli/port.h +302 -0
  30. data/vendor/curl/include/brotli/shared_dictionary.h +100 -0
  31. data/vendor/curl/include/brotli/types.h +83 -0
  32. data/vendor/curl/include/curl/curl.h +3374 -0
  33. data/vendor/curl/include/curl/curlver.h +77 -0
  34. data/vendor/curl/include/curl/easy.h +123 -0
  35. data/vendor/curl/include/curl/header.h +74 -0
  36. data/vendor/curl/include/curl/mprintf.h +85 -0
  37. data/vendor/curl/include/curl/multi.h +561 -0
  38. data/vendor/curl/include/curl/options.h +70 -0
  39. data/vendor/curl/include/curl/stdcheaders.h +35 -0
  40. data/vendor/curl/include/curl/system.h +399 -0
  41. data/vendor/curl/include/curl/typecheck-gcc.h +964 -0
  42. data/vendor/curl/include/curl/urlapi.h +156 -0
  43. data/vendor/curl/include/curl/websockets.h +98 -0
  44. data/vendor/curl/include/libpsl.h +207 -0
  45. data/vendor/curl/include/libssh2.h +1516 -0
  46. data/vendor/curl/include/libssh2_publickey.h +128 -0
  47. data/vendor/curl/include/libssh2_sftp.h +382 -0
  48. data/vendor/curl/include/nghttp2/nghttp2.h +6878 -0
  49. data/vendor/curl/include/nghttp2/nghttp2ver.h +42 -0
  50. data/vendor/curl/include/nghttp3/nghttp3.h +3704 -0
  51. data/vendor/curl/include/nghttp3/version.h +46 -0
  52. data/vendor/curl/include/ngtcp2/ngtcp2.h +7485 -0
  53. data/vendor/curl/include/ngtcp2/ngtcp2_crypto.h +1071 -0
  54. data/vendor/curl/include/ngtcp2/ngtcp2_crypto_quictls.h +147 -0
  55. data/vendor/curl/include/ngtcp2/version.h +51 -0
  56. data/vendor/curl/include/openssl/aes.h +120 -0
  57. data/vendor/curl/include/openssl/asn1.h +1121 -0
  58. data/vendor/curl/include/openssl/asn1t.h +996 -0
  59. data/vendor/curl/include/openssl/bio.h +716 -0
  60. data/vendor/curl/include/openssl/blowfish.h +106 -0
  61. data/vendor/curl/include/openssl/bn.h +480 -0
  62. data/vendor/curl/include/openssl/buffer.h +102 -0
  63. data/vendor/curl/include/openssl/camellia.h +121 -0
  64. data/vendor/curl/include/openssl/cast.h +99 -0
  65. data/vendor/curl/include/openssl/chacha.h +54 -0
  66. data/vendor/curl/include/openssl/cmac.h +81 -0
  67. data/vendor/curl/include/openssl/cms.h +541 -0
  68. data/vendor/curl/include/openssl/comp.h +7 -0
  69. data/vendor/curl/include/openssl/conf.h +189 -0
  70. data/vendor/curl/include/openssl/crypto.h +458 -0
  71. data/vendor/curl/include/openssl/ct.h +567 -0
  72. data/vendor/curl/include/openssl/curve25519.h +104 -0
  73. data/vendor/curl/include/openssl/des.h +215 -0
  74. data/vendor/curl/include/openssl/dh.h +245 -0
  75. data/vendor/curl/include/openssl/dsa.h +263 -0
  76. data/vendor/curl/include/openssl/dtls1.h +107 -0
  77. data/vendor/curl/include/openssl/ec.h +675 -0
  78. data/vendor/curl/include/openssl/ecdh.h +6 -0
  79. data/vendor/curl/include/openssl/ecdsa.h +6 -0
  80. data/vendor/curl/include/openssl/engine.h +215 -0
  81. data/vendor/curl/include/openssl/err.h +325 -0
  82. data/vendor/curl/include/openssl/evp.h +1288 -0
  83. data/vendor/curl/include/openssl/hkdf.h +65 -0
  84. data/vendor/curl/include/openssl/hmac.h +101 -0
  85. data/vendor/curl/include/openssl/idea.h +99 -0
  86. data/vendor/curl/include/openssl/kdf.h +137 -0
  87. data/vendor/curl/include/openssl/lhash.h +179 -0
  88. data/vendor/curl/include/openssl/md4.h +105 -0
  89. data/vendor/curl/include/openssl/md5.h +99 -0
  90. data/vendor/curl/include/openssl/mlkem.h +236 -0
  91. data/vendor/curl/include/openssl/modes.h +118 -0
  92. data/vendor/curl/include/openssl/obj_mac.h +4646 -0
  93. data/vendor/curl/include/openssl/objects.h +137 -0
  94. data/vendor/curl/include/openssl/ocsp.h +484 -0
  95. data/vendor/curl/include/openssl/opensslconf.h +16 -0
  96. data/vendor/curl/include/openssl/opensslfeatures.h +153 -0
  97. data/vendor/curl/include/openssl/opensslv.h +18 -0
  98. data/vendor/curl/include/openssl/ossl_typ.h +196 -0
  99. data/vendor/curl/include/openssl/pem.h +542 -0
  100. data/vendor/curl/include/openssl/pkcs12.h +284 -0
  101. data/vendor/curl/include/openssl/pkcs7.h +523 -0
  102. data/vendor/curl/include/openssl/poly1305.h +45 -0
  103. data/vendor/curl/include/openssl/posix_time.h +54 -0
  104. data/vendor/curl/include/openssl/rand.h +118 -0
  105. data/vendor/curl/include/openssl/rc2.h +101 -0
  106. data/vendor/curl/include/openssl/rc4.h +88 -0
  107. data/vendor/curl/include/openssl/ripemd.h +107 -0
  108. data/vendor/curl/include/openssl/rsa.h +603 -0
  109. data/vendor/curl/include/openssl/safestack.h +1739 -0
  110. data/vendor/curl/include/openssl/sha.h +190 -0
  111. data/vendor/curl/include/openssl/sm3.h +49 -0
  112. data/vendor/curl/include/openssl/sm4.h +47 -0
  113. data/vendor/curl/include/openssl/srtp.h +148 -0
  114. data/vendor/curl/include/openssl/ssl.h +2336 -0
  115. data/vendor/curl/include/openssl/ssl3.h +441 -0
  116. data/vendor/curl/include/openssl/stack.h +99 -0
  117. data/vendor/curl/include/openssl/tls1.h +764 -0
  118. data/vendor/curl/include/openssl/ts.h +660 -0
  119. data/vendor/curl/include/openssl/txt_db.h +112 -0
  120. data/vendor/curl/include/openssl/ui.h +397 -0
  121. data/vendor/curl/include/openssl/x509.h +1037 -0
  122. data/vendor/curl/include/openssl/x509_vfy.h +464 -0
  123. data/vendor/curl/include/openssl/x509v3.h +1039 -0
  124. data/vendor/curl/include/zconf.h +206 -0
  125. data/vendor/curl/include/zdict.h +481 -0
  126. data/vendor/curl/include/zlib.h +1859 -0
  127. data/vendor/curl/include/zlib_name_mangling.h +8 -0
  128. data/vendor/curl/include/zstd.h +3198 -0
  129. data/vendor/curl/include/zstd_errors.h +107 -0
  130. data/vendor/curl/lib/libcurl.dll.a +0 -0
  131. data/vendor/curl/licenses/brotli/LICENSE.txt +19 -0
  132. data/vendor/curl/licenses/certdata/LICENSE.url +2 -0
  133. data/vendor/curl/licenses/libpsl/COPYING.txt +20 -0
  134. data/vendor/curl/licenses/libressl/COPYING.txt +133 -0
  135. data/vendor/curl/licenses/libssh2/COPYING.txt +43 -0
  136. data/vendor/curl/licenses/nghttp2/COPYING.txt +23 -0
  137. data/vendor/curl/licenses/nghttp3/COPYING.txt +22 -0
  138. data/vendor/curl/licenses/ngtcp2/COPYING.txt +22 -0
  139. data/vendor/curl/licenses/psl/LICENSE.txt +373 -0
  140. data/vendor/curl/licenses/trurl/COPYING.txt +22 -0
  141. data/vendor/curl/licenses/zlibng/LICENSE.md +19 -0
  142. data/vendor/curl/licenses/zstd/LICENSE.txt +30 -0
  143. metadata +205 -0
@@ -0,0 +1,541 @@
1
+ /* $OpenBSD: cms.h,v 1.18 2024/03/30 00:35:15 joshua Exp $ */
2
+ /*
3
+ * Written by Dr Stephen N Henson (steve@openssl.org) for the OpenSSL
4
+ * project.
5
+ */
6
+ /* ====================================================================
7
+ * Copyright (c) 2008 The OpenSSL Project. All rights reserved.
8
+ *
9
+ * Redistribution and use in source and binary forms, with or without
10
+ * modification, are permitted provided that the following conditions
11
+ * are met:
12
+ *
13
+ * 1. Redistributions of source code must retain the above copyright
14
+ * notice, this list of conditions and the following disclaimer.
15
+ *
16
+ * 2. Redistributions in binary form must reproduce the above copyright
17
+ * notice, this list of conditions and the following disclaimer in
18
+ * the documentation and/or other materials provided with the
19
+ * distribution.
20
+ *
21
+ * 3. All advertising materials mentioning features or use of this
22
+ * software must display the following acknowledgment:
23
+ * "This product includes software developed by the OpenSSL Project
24
+ * for use in the OpenSSL Toolkit. (http://www.OpenSSL.org/)"
25
+ *
26
+ * 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
27
+ * endorse or promote products derived from this software without
28
+ * prior written permission. For written permission, please contact
29
+ * licensing@OpenSSL.org.
30
+ *
31
+ * 5. Products derived from this software may not be called "OpenSSL"
32
+ * nor may "OpenSSL" appear in their names without prior written
33
+ * permission of the OpenSSL Project.
34
+ *
35
+ * 6. Redistributions of any form whatsoever must retain the following
36
+ * acknowledgment:
37
+ * "This product includes software developed by the OpenSSL Project
38
+ * for use in the OpenSSL Toolkit (http://www.OpenSSL.org/)"
39
+ *
40
+ * THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY
41
+ * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
42
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
43
+ * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR
44
+ * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
45
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
46
+ * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
47
+ * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
48
+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
49
+ * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
50
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
51
+ * OF THE POSSIBILITY OF SUCH DAMAGE.
52
+ * ====================================================================
53
+ */
54
+
55
+ #ifndef HEADER_CMS_H
56
+ #define HEADER_CMS_H
57
+
58
+ #include <openssl/opensslconf.h>
59
+
60
+ #ifndef OPENSSL_NO_CMS
61
+
62
+ #include <openssl/pem.h>
63
+ #include <openssl/x509.h>
64
+ #include <openssl/x509v3.h>
65
+
66
+ #ifdef __cplusplus
67
+ extern "C" {
68
+ #endif
69
+
70
+ #ifdef _MSC_VER
71
+ #ifndef LIBRESSL_INTERNAL
72
+ #include <basetsd.h>
73
+ typedef SSIZE_T ssize_t;
74
+ #endif
75
+ #endif
76
+
77
+ typedef struct CMS_ContentInfo_st CMS_ContentInfo;
78
+ typedef struct CMS_SignerInfo_st CMS_SignerInfo;
79
+ typedef struct CMS_CertificateChoices CMS_CertificateChoices;
80
+ typedef struct CMS_RevocationInfoChoice_st CMS_RevocationInfoChoice;
81
+ typedef struct CMS_RecipientInfo_st CMS_RecipientInfo;
82
+ typedef struct CMS_ReceiptRequest_st CMS_ReceiptRequest;
83
+ typedef struct CMS_Receipt_st CMS_Receipt;
84
+ typedef struct CMS_RecipientEncryptedKey_st CMS_RecipientEncryptedKey;
85
+ typedef struct CMS_OtherKeyAttribute_st CMS_OtherKeyAttribute;
86
+
87
+ DECLARE_STACK_OF(CMS_SignerInfo)
88
+ DECLARE_STACK_OF(CMS_RecipientEncryptedKey)
89
+ DECLARE_STACK_OF(CMS_RecipientInfo)
90
+ DECLARE_STACK_OF(CMS_RevocationInfoChoice)
91
+ CMS_ContentInfo *CMS_ContentInfo_new(void);
92
+ void CMS_ContentInfo_free(CMS_ContentInfo *a);
93
+ CMS_ContentInfo *d2i_CMS_ContentInfo(CMS_ContentInfo **a, const unsigned char **in, long len);
94
+ int i2d_CMS_ContentInfo(CMS_ContentInfo *a, unsigned char **out);
95
+ extern const ASN1_ITEM CMS_ContentInfo_it;
96
+ CMS_ReceiptRequest *CMS_ReceiptRequest_new(void);
97
+ void CMS_ReceiptRequest_free(CMS_ReceiptRequest *a);
98
+ CMS_ReceiptRequest *d2i_CMS_ReceiptRequest(CMS_ReceiptRequest **a, const unsigned char **in, long len);
99
+ int i2d_CMS_ReceiptRequest(CMS_ReceiptRequest *a, unsigned char **out);
100
+ extern const ASN1_ITEM CMS_ReceiptRequest_it;
101
+ int CMS_ContentInfo_print_ctx(BIO *out, CMS_ContentInfo *x, int indent, const ASN1_PCTX *pctx);
102
+
103
+ #define CMS_SIGNERINFO_ISSUER_SERIAL 0
104
+ #define CMS_SIGNERINFO_KEYIDENTIFIER 1
105
+
106
+ #define CMS_RECIPINFO_NONE -1
107
+ #define CMS_RECIPINFO_TRANS 0
108
+ #define CMS_RECIPINFO_AGREE 1
109
+ #define CMS_RECIPINFO_KEK 2
110
+ #define CMS_RECIPINFO_PASS 3
111
+ #define CMS_RECIPINFO_OTHER 4
112
+
113
+ /* S/MIME related flags */
114
+
115
+ #define CMS_TEXT 0x1
116
+ #define CMS_NOCERTS 0x2
117
+ #define CMS_NO_CONTENT_VERIFY 0x4
118
+ #define CMS_NO_ATTR_VERIFY 0x8
119
+ #define CMS_NOSIGS \
120
+ (CMS_NO_CONTENT_VERIFY|CMS_NO_ATTR_VERIFY)
121
+ #define CMS_NOINTERN 0x10
122
+ #define CMS_NO_SIGNER_CERT_VERIFY 0x20
123
+ #define CMS_NOVERIFY 0x20
124
+ #define CMS_DETACHED 0x40
125
+ #define CMS_BINARY 0x80
126
+ #define CMS_NOATTR 0x100
127
+ #define CMS_NOSMIMECAP 0x200
128
+ #define CMS_NOOLDMIMETYPE 0x400
129
+ #define CMS_CRLFEOL 0x800
130
+ #define CMS_STREAM 0x1000
131
+ #define CMS_NOCRL 0x2000
132
+ #define CMS_PARTIAL 0x4000
133
+ #define CMS_REUSE_DIGEST 0x8000
134
+ #define CMS_USE_KEYID 0x10000
135
+ #define CMS_DEBUG_DECRYPT 0x20000
136
+ #define CMS_KEY_PARAM 0x40000
137
+ #define CMS_ASCIICRLF 0x80000
138
+
139
+ const ASN1_OBJECT *CMS_get0_type(const CMS_ContentInfo *cms);
140
+
141
+ int CMS_get_version(const CMS_ContentInfo *cms, long *version);
142
+ int CMS_SignerInfo_get_version(const CMS_SignerInfo *si, long *version);
143
+
144
+ BIO *CMS_dataInit(CMS_ContentInfo *cms, BIO *icont);
145
+ int CMS_dataFinal(CMS_ContentInfo *cms, BIO *bio);
146
+
147
+ ASN1_OCTET_STRING **CMS_get0_content(CMS_ContentInfo *cms);
148
+ int CMS_is_detached(CMS_ContentInfo *cms);
149
+ int CMS_set_detached(CMS_ContentInfo *cms, int detached);
150
+
151
+ CMS_ContentInfo *PEM_read_bio_CMS(BIO *bp, CMS_ContentInfo **x,
152
+ pem_password_cb *cb, void *u);
153
+ CMS_ContentInfo *PEM_read_CMS(FILE *fp, CMS_ContentInfo **x,
154
+ pem_password_cb *cb, void *u);
155
+ int PEM_write_bio_CMS(BIO *bp, const CMS_ContentInfo *x);
156
+ int PEM_write_CMS(FILE *fp, const CMS_ContentInfo *x);
157
+ int CMS_stream(unsigned char ***boundary, CMS_ContentInfo *cms);
158
+ CMS_ContentInfo *d2i_CMS_bio(BIO *bp, CMS_ContentInfo **cms);
159
+ int i2d_CMS_bio(BIO *bp, CMS_ContentInfo *cms);
160
+
161
+ BIO *BIO_new_CMS(BIO *out, CMS_ContentInfo *cms);
162
+ int i2d_CMS_bio_stream(BIO *out, CMS_ContentInfo *cms, BIO *in, int flags);
163
+ int PEM_write_bio_CMS_stream(BIO *out, CMS_ContentInfo *cms, BIO *in,
164
+ int flags);
165
+ CMS_ContentInfo *SMIME_read_CMS(BIO *bio, BIO **bcont);
166
+ int SMIME_write_CMS(BIO *bio, CMS_ContentInfo *cms, BIO *data, int flags);
167
+
168
+ int CMS_final(CMS_ContentInfo *cms, BIO *data, BIO *dcont, unsigned int flags);
169
+
170
+ CMS_ContentInfo *CMS_sign(X509 *signcert, EVP_PKEY *pkey, STACK_OF(X509) *certs,
171
+ BIO *data, unsigned int flags);
172
+
173
+ CMS_ContentInfo *CMS_sign_receipt(CMS_SignerInfo *si, X509 *signcert,
174
+ EVP_PKEY *pkey, STACK_OF(X509) *certs, unsigned int flags);
175
+
176
+ int CMS_data(CMS_ContentInfo *cms, BIO *out, unsigned int flags);
177
+ CMS_ContentInfo *CMS_data_create(BIO *in, unsigned int flags);
178
+
179
+ int CMS_digest_verify(CMS_ContentInfo *cms, BIO *dcont, BIO *out,
180
+ unsigned int flags);
181
+ CMS_ContentInfo *CMS_digest_create(BIO *in, const EVP_MD *md,
182
+ unsigned int flags);
183
+
184
+ int CMS_EncryptedData_decrypt(CMS_ContentInfo *cms, const unsigned char *key,
185
+ size_t keylen, BIO *dcont, BIO *out, unsigned int flags);
186
+
187
+ CMS_ContentInfo *CMS_EncryptedData_encrypt(BIO *in, const EVP_CIPHER *cipher,
188
+ const unsigned char *key, size_t keylen, unsigned int flags);
189
+
190
+ int CMS_EncryptedData_set1_key(CMS_ContentInfo *cms, const EVP_CIPHER *ciph,
191
+ const unsigned char *key, size_t keylen);
192
+
193
+ int CMS_verify(CMS_ContentInfo *cms, STACK_OF(X509) *certs,
194
+ X509_STORE *store, BIO *dcont, BIO *out, unsigned int flags);
195
+
196
+ int CMS_verify_receipt(CMS_ContentInfo *rcms, CMS_ContentInfo *ocms,
197
+ STACK_OF(X509) *certs, X509_STORE *store, unsigned int flags);
198
+
199
+ STACK_OF(X509) *CMS_get0_signers(CMS_ContentInfo *cms);
200
+
201
+ CMS_ContentInfo *CMS_encrypt(STACK_OF(X509) *certs, BIO *in,
202
+ const EVP_CIPHER *cipher, unsigned int flags);
203
+
204
+ int CMS_decrypt(CMS_ContentInfo *cms, EVP_PKEY *pkey, X509 *cert,
205
+ BIO *dcont, BIO *out, unsigned int flags);
206
+
207
+ int CMS_decrypt_set1_pkey(CMS_ContentInfo *cms, EVP_PKEY *pk, X509 *cert);
208
+ int CMS_decrypt_set1_key(CMS_ContentInfo *cms, unsigned char *key,
209
+ size_t keylen, const unsigned char *id, size_t idlen);
210
+ int CMS_decrypt_set1_password(CMS_ContentInfo *cms, unsigned char *pass,
211
+ ssize_t passlen);
212
+
213
+ STACK_OF(CMS_RecipientInfo) *CMS_get0_RecipientInfos(CMS_ContentInfo *cms);
214
+ int CMS_RecipientInfo_type(CMS_RecipientInfo *ri);
215
+ EVP_PKEY_CTX *CMS_RecipientInfo_get0_pkey_ctx(CMS_RecipientInfo *ri);
216
+ CMS_ContentInfo *CMS_EnvelopedData_create(const EVP_CIPHER *cipher);
217
+ CMS_RecipientInfo *CMS_add1_recipient_cert(CMS_ContentInfo *cms, X509 *recip,
218
+ unsigned int flags);
219
+ int CMS_RecipientInfo_set0_pkey(CMS_RecipientInfo *ri, EVP_PKEY *pkey);
220
+ int CMS_RecipientInfo_ktri_cert_cmp(CMS_RecipientInfo *ri, X509 *cert);
221
+ int CMS_RecipientInfo_ktri_get0_algs(CMS_RecipientInfo *ri, EVP_PKEY **pk,
222
+ X509 **recip, X509_ALGOR **palg);
223
+ int CMS_RecipientInfo_ktri_get0_signer_id(CMS_RecipientInfo *ri,
224
+ ASN1_OCTET_STRING **keyid, X509_NAME **issuer, ASN1_INTEGER **sno);
225
+
226
+ CMS_RecipientInfo *CMS_add0_recipient_key(CMS_ContentInfo *cms, int nid,
227
+ unsigned char *key, size_t keylen, unsigned char *id, size_t idlen,
228
+ ASN1_GENERALIZEDTIME *date, ASN1_OBJECT *otherTypeId, ASN1_TYPE *otherType);
229
+
230
+ int CMS_RecipientInfo_kekri_get0_id(CMS_RecipientInfo *ri, X509_ALGOR **palg,
231
+ ASN1_OCTET_STRING **pid, ASN1_GENERALIZEDTIME **pdate,
232
+ ASN1_OBJECT **potherid, ASN1_TYPE **pothertype);
233
+
234
+ int CMS_RecipientInfo_set0_key(CMS_RecipientInfo *ri, unsigned char *key,
235
+ size_t keylen);
236
+
237
+ int CMS_RecipientInfo_kekri_id_cmp(CMS_RecipientInfo *ri,
238
+ const unsigned char *id, size_t idlen);
239
+
240
+ int CMS_RecipientInfo_set0_password(CMS_RecipientInfo *ri, unsigned char *pass,
241
+ ssize_t passlen);
242
+
243
+ CMS_RecipientInfo *CMS_add0_recipient_password(CMS_ContentInfo *cms, int iter,
244
+ int wrap_nid, int pbe_nid, unsigned char *pass, ssize_t passlen,
245
+ const EVP_CIPHER *kekciph);
246
+
247
+ int CMS_RecipientInfo_decrypt(CMS_ContentInfo *cms, CMS_RecipientInfo *ri);
248
+ int CMS_RecipientInfo_encrypt(CMS_ContentInfo *cms, CMS_RecipientInfo *ri);
249
+
250
+ int CMS_uncompress(CMS_ContentInfo *cms, BIO *dcont, BIO *out,
251
+ unsigned int flags);
252
+ CMS_ContentInfo *CMS_compress(BIO *in, int comp_nid, unsigned int flags);
253
+
254
+ int CMS_set1_eContentType(CMS_ContentInfo *cms, const ASN1_OBJECT *oid);
255
+ const ASN1_OBJECT *CMS_get0_eContentType(CMS_ContentInfo *cms);
256
+
257
+ CMS_CertificateChoices *CMS_add0_CertificateChoices(CMS_ContentInfo *cms);
258
+ int CMS_add0_cert(CMS_ContentInfo *cms, X509 *cert);
259
+ int CMS_add1_cert(CMS_ContentInfo *cms, X509 *cert);
260
+ STACK_OF(X509) *CMS_get1_certs(CMS_ContentInfo *cms);
261
+
262
+ CMS_RevocationInfoChoice *CMS_add0_RevocationInfoChoice(CMS_ContentInfo *cms);
263
+ int CMS_add0_crl(CMS_ContentInfo *cms, X509_CRL *crl);
264
+ int CMS_add1_crl(CMS_ContentInfo *cms, X509_CRL *crl);
265
+ STACK_OF(X509_CRL) *CMS_get1_crls(CMS_ContentInfo *cms);
266
+
267
+ int CMS_SignedData_init(CMS_ContentInfo *cms);
268
+ CMS_SignerInfo *CMS_add1_signer(CMS_ContentInfo *cms, X509 *signer,
269
+ EVP_PKEY *pk, const EVP_MD *md, unsigned int flags);
270
+ EVP_PKEY_CTX *CMS_SignerInfo_get0_pkey_ctx(CMS_SignerInfo *si);
271
+ EVP_MD_CTX *CMS_SignerInfo_get0_md_ctx(CMS_SignerInfo *si);
272
+ STACK_OF(CMS_SignerInfo) *CMS_get0_SignerInfos(CMS_ContentInfo *cms);
273
+
274
+ void CMS_SignerInfo_set1_signer_cert(CMS_SignerInfo *si, X509 *signer);
275
+ int CMS_SignerInfo_get0_signer_id(CMS_SignerInfo *si, ASN1_OCTET_STRING **keyid,
276
+ X509_NAME **issuer, ASN1_INTEGER **sno);
277
+ int CMS_SignerInfo_cert_cmp(CMS_SignerInfo *si, X509 *cert);
278
+ int CMS_set1_signers_certs(CMS_ContentInfo *cms, STACK_OF(X509) *certs,
279
+ unsigned int flags);
280
+ void CMS_SignerInfo_get0_algs(CMS_SignerInfo *si, EVP_PKEY **pk, X509 **signer,
281
+ X509_ALGOR **pdig, X509_ALGOR **psig);
282
+ ASN1_OCTET_STRING *CMS_SignerInfo_get0_signature(CMS_SignerInfo *si);
283
+ int CMS_SignerInfo_sign(CMS_SignerInfo *si);
284
+ int CMS_SignerInfo_verify(CMS_SignerInfo *si);
285
+ int CMS_SignerInfo_verify_content(CMS_SignerInfo *si, BIO *chain);
286
+
287
+ int CMS_add_smimecap(CMS_SignerInfo *si, STACK_OF(X509_ALGOR) *algs);
288
+ int CMS_add_simple_smimecap(STACK_OF(X509_ALGOR) **algs, int algnid,
289
+ int keysize);
290
+ int CMS_add_standard_smimecap(STACK_OF(X509_ALGOR) **smcap);
291
+
292
+ int CMS_signed_get_attr_count(const CMS_SignerInfo *si);
293
+ int CMS_signed_get_attr_by_NID(const CMS_SignerInfo *si, int nid, int lastpos);
294
+ int CMS_signed_get_attr_by_OBJ(const CMS_SignerInfo *si, const ASN1_OBJECT *obj,
295
+ int lastpos);
296
+ X509_ATTRIBUTE *CMS_signed_get_attr(const CMS_SignerInfo *si, int loc);
297
+ X509_ATTRIBUTE *CMS_signed_delete_attr(CMS_SignerInfo *si, int loc);
298
+ int CMS_signed_add1_attr(CMS_SignerInfo *si, X509_ATTRIBUTE *attr);
299
+ int CMS_signed_add1_attr_by_OBJ(CMS_SignerInfo *si, const ASN1_OBJECT *obj,
300
+ int type, const void *bytes, int len);
301
+ int CMS_signed_add1_attr_by_NID(CMS_SignerInfo *si, int nid, int type,
302
+ const void *bytes, int len);
303
+ int CMS_signed_add1_attr_by_txt(CMS_SignerInfo *si,
304
+ const char *attrname, int type, const void *bytes, int len);
305
+ void *CMS_signed_get0_data_by_OBJ(CMS_SignerInfo *si, const ASN1_OBJECT *oid,
306
+ int lastpos, int type);
307
+
308
+ int CMS_unsigned_get_attr_count(const CMS_SignerInfo *si);
309
+ int CMS_unsigned_get_attr_by_NID(const CMS_SignerInfo *si, int nid,
310
+ int lastpos);
311
+ int CMS_unsigned_get_attr_by_OBJ(const CMS_SignerInfo *si,
312
+ const ASN1_OBJECT *obj, int lastpos);
313
+ X509_ATTRIBUTE *CMS_unsigned_get_attr(const CMS_SignerInfo *si, int loc);
314
+ X509_ATTRIBUTE *CMS_unsigned_delete_attr(CMS_SignerInfo *si, int loc);
315
+ int CMS_unsigned_add1_attr(CMS_SignerInfo *si, X509_ATTRIBUTE *attr);
316
+ int CMS_unsigned_add1_attr_by_OBJ(CMS_SignerInfo *si,
317
+ const ASN1_OBJECT *obj, int type, const void *bytes, int len);
318
+ int CMS_unsigned_add1_attr_by_NID(CMS_SignerInfo *si, int nid, int type,
319
+ const void *bytes, int len);
320
+ int CMS_unsigned_add1_attr_by_txt(CMS_SignerInfo *si, const char *attrname,
321
+ int type, const void *bytes, int len);
322
+ void *CMS_unsigned_get0_data_by_OBJ(CMS_SignerInfo *si, ASN1_OBJECT *oid,
323
+ int lastpos, int type);
324
+
325
+ int CMS_get1_ReceiptRequest(CMS_SignerInfo *si, CMS_ReceiptRequest **prr);
326
+ CMS_ReceiptRequest *CMS_ReceiptRequest_create0(unsigned char *id, int idlen,
327
+ int allorfirst, STACK_OF(GENERAL_NAMES) *receiptList,
328
+ STACK_OF(GENERAL_NAMES) *receiptsTo);
329
+ int CMS_add1_ReceiptRequest(CMS_SignerInfo *si, CMS_ReceiptRequest *rr);
330
+ void CMS_ReceiptRequest_get0_values(CMS_ReceiptRequest *rr, ASN1_STRING **pcid,
331
+ int *pallorfirst, STACK_OF(GENERAL_NAMES) **plist,
332
+ STACK_OF(GENERAL_NAMES) **prto);
333
+
334
+ int CMS_RecipientInfo_kari_get0_alg(CMS_RecipientInfo *ri, X509_ALGOR **palg,
335
+ ASN1_OCTET_STRING **pukm);
336
+ STACK_OF(CMS_RecipientEncryptedKey) *
337
+ CMS_RecipientInfo_kari_get0_reks(CMS_RecipientInfo *ri);
338
+
339
+ int CMS_RecipientInfo_kari_get0_orig_id(CMS_RecipientInfo *ri,
340
+ X509_ALGOR **pubalg, ASN1_BIT_STRING **pubkey, ASN1_OCTET_STRING **keyid,
341
+ X509_NAME **issuer, ASN1_INTEGER **sno);
342
+
343
+ int CMS_RecipientInfo_kari_orig_id_cmp(CMS_RecipientInfo *ri, X509 *cert);
344
+
345
+ int CMS_RecipientEncryptedKey_get0_id(CMS_RecipientEncryptedKey *rek,
346
+ ASN1_OCTET_STRING **keyid, ASN1_GENERALIZEDTIME **tm,
347
+ CMS_OtherKeyAttribute **other, X509_NAME **issuer, ASN1_INTEGER **sno);
348
+ int CMS_RecipientEncryptedKey_cert_cmp(CMS_RecipientEncryptedKey *rek,
349
+ X509 *cert);
350
+ int CMS_RecipientInfo_kari_set0_pkey(CMS_RecipientInfo *ri, EVP_PKEY *pk);
351
+ EVP_CIPHER_CTX *CMS_RecipientInfo_kari_get0_ctx(CMS_RecipientInfo *ri);
352
+ int CMS_RecipientInfo_kari_decrypt(CMS_ContentInfo *cms,
353
+ CMS_RecipientInfo *ri, CMS_RecipientEncryptedKey *rek);
354
+
355
+ int CMS_SharedInfo_encode(unsigned char **pder, X509_ALGOR *kekalg,
356
+ ASN1_OCTET_STRING *ukm, int keylen);
357
+
358
+ /* Backward compatibility for spelling errors. */
359
+ #define CMS_R_UNKNOWN_DIGEST_ALGORITM CMS_R_UNKNOWN_DIGEST_ALGORITHM
360
+ #define CMS_R_UNSUPPORTED_RECPIENTINFO_TYPE \
361
+ CMS_R_UNSUPPORTED_RECIPIENTINFO_TYPE
362
+
363
+ int ERR_load_CMS_strings(void);
364
+
365
+ /*
366
+ * CMS function codes.
367
+ */
368
+ #define CMS_F_CHECK_CONTENT 99
369
+ #define CMS_F_CMS_ADD0_CERT 164
370
+ #define CMS_F_CMS_ADD0_RECIPIENT_KEY 100
371
+ #define CMS_F_CMS_ADD0_RECIPIENT_PASSWORD 165
372
+ #define CMS_F_CMS_ADD1_RECEIPTREQUEST 158
373
+ #define CMS_F_CMS_ADD1_RECIPIENT_CERT 101
374
+ #define CMS_F_CMS_ADD1_SIGNER 102
375
+ #define CMS_F_CMS_ADD1_SIGNINGTIME 103
376
+ #define CMS_F_CMS_COMPRESS 104
377
+ #define CMS_F_CMS_COMPRESSEDDATA_CREATE 105
378
+ #define CMS_F_CMS_COMPRESSEDDATA_INIT_BIO 106
379
+ #define CMS_F_CMS_COPY_CONTENT 107
380
+ #define CMS_F_CMS_COPY_MESSAGEDIGEST 108
381
+ #define CMS_F_CMS_DATA 109
382
+ #define CMS_F_CMS_DATAFINAL 110
383
+ #define CMS_F_CMS_DATAINIT 111
384
+ #define CMS_F_CMS_DECRYPT 112
385
+ #define CMS_F_CMS_DECRYPT_SET1_KEY 113
386
+ #define CMS_F_CMS_DECRYPT_SET1_PASSWORD 166
387
+ #define CMS_F_CMS_DECRYPT_SET1_PKEY 114
388
+ #define CMS_F_CMS_DIGESTALGORITHM_FIND_CTX 115
389
+ #define CMS_F_CMS_DIGESTALGORITHM_INIT_BIO 116
390
+ #define CMS_F_CMS_DIGESTEDDATA_DO_FINAL 117
391
+ #define CMS_F_CMS_DIGEST_VERIFY 118
392
+ #define CMS_F_CMS_ENCODE_RECEIPT 161
393
+ #define CMS_F_CMS_ENCRYPT 119
394
+ #define CMS_F_CMS_ENCRYPTEDCONTENT_INIT 179
395
+ #define CMS_F_CMS_ENCRYPTEDCONTENT_INIT_BIO 120
396
+ #define CMS_F_CMS_ENCRYPTEDDATA_DECRYPT 121
397
+ #define CMS_F_CMS_ENCRYPTEDDATA_ENCRYPT 122
398
+ #define CMS_F_CMS_ENCRYPTEDDATA_SET1_KEY 123
399
+ #define CMS_F_CMS_ENVELOPEDDATA_CREATE 124
400
+ #define CMS_F_CMS_ENVELOPEDDATA_INIT_BIO 125
401
+ #define CMS_F_CMS_ENVELOPED_DATA_INIT 126
402
+ #define CMS_F_CMS_ENV_ASN1_CTRL 171
403
+ #define CMS_F_CMS_FINAL 127
404
+ #define CMS_F_CMS_GET0_CERTIFICATE_CHOICES 128
405
+ #define CMS_F_CMS_GET0_CONTENT 129
406
+ #define CMS_F_CMS_GET0_ECONTENT_TYPE 130
407
+ #define CMS_F_CMS_GET0_ENVELOPED 131
408
+ #define CMS_F_CMS_GET0_REVOCATION_CHOICES 132
409
+ #define CMS_F_CMS_GET0_SIGNED 133
410
+ #define CMS_F_CMS_MSGSIGDIGEST_ADD1 162
411
+ #define CMS_F_CMS_RECEIPTREQUEST_CREATE0 159
412
+ #define CMS_F_CMS_RECEIPT_VERIFY 160
413
+ #define CMS_F_CMS_RECIPIENTINFO_DECRYPT 134
414
+ #define CMS_F_CMS_RECIPIENTINFO_ENCRYPT 169
415
+ #define CMS_F_CMS_RECIPIENTINFO_KARI_ENCRYPT 178
416
+ #define CMS_F_CMS_RECIPIENTINFO_KARI_GET0_ALG 175
417
+ #define CMS_F_CMS_RECIPIENTINFO_KARI_GET0_ORIG_ID 173
418
+ #define CMS_F_CMS_RECIPIENTINFO_KARI_GET0_REKS 172
419
+ #define CMS_F_CMS_RECIPIENTINFO_KARI_ORIG_ID_CMP 174
420
+ #define CMS_F_CMS_RECIPIENTINFO_KEKRI_DECRYPT 135
421
+ #define CMS_F_CMS_RECIPIENTINFO_KEKRI_ENCRYPT 136
422
+ #define CMS_F_CMS_RECIPIENTINFO_KEKRI_GET0_ID 137
423
+ #define CMS_F_CMS_RECIPIENTINFO_KEKRI_ID_CMP 138
424
+ #define CMS_F_CMS_RECIPIENTINFO_KTRI_CERT_CMP 139
425
+ #define CMS_F_CMS_RECIPIENTINFO_KTRI_DECRYPT 140
426
+ #define CMS_F_CMS_RECIPIENTINFO_KTRI_ENCRYPT 141
427
+ #define CMS_F_CMS_RECIPIENTINFO_KTRI_GET0_ALGS 142
428
+ #define CMS_F_CMS_RECIPIENTINFO_KTRI_GET0_SIGNER_ID 143
429
+ #define CMS_F_CMS_RECIPIENTINFO_PWRI_CRYPT 167
430
+ #define CMS_F_CMS_RECIPIENTINFO_SET0_KEY 144
431
+ #define CMS_F_CMS_RECIPIENTINFO_SET0_PASSWORD 168
432
+ #define CMS_F_CMS_RECIPIENTINFO_SET0_PKEY 145
433
+ #define CMS_F_CMS_SD_ASN1_CTRL 170
434
+ #define CMS_F_CMS_SET1_IAS 176
435
+ #define CMS_F_CMS_SET1_KEYID 177
436
+ #define CMS_F_CMS_SET1_SIGNERIDENTIFIER 146
437
+ #define CMS_F_CMS_SET_DETACHED 147
438
+ #define CMS_F_CMS_SIGN 148
439
+ #define CMS_F_CMS_SIGNED_DATA_INIT 149
440
+ #define CMS_F_CMS_SIGNERINFO_CONTENT_SIGN 150
441
+ #define CMS_F_CMS_SIGNERINFO_SIGN 151
442
+ #define CMS_F_CMS_SIGNERINFO_VERIFY 152
443
+ #define CMS_F_CMS_SIGNERINFO_VERIFY_CERT 153
444
+ #define CMS_F_CMS_SIGNERINFO_VERIFY_CONTENT 154
445
+ #define CMS_F_CMS_SIGN_RECEIPT 163
446
+ #define CMS_F_CMS_STREAM 155
447
+ #define CMS_F_CMS_UNCOMPRESS 156
448
+ #define CMS_F_CMS_VERIFY 157
449
+ #define CMS_F_KEK_UNWRAP_KEY 180
450
+
451
+ /*
452
+ * CMS reason codes.
453
+ */
454
+ #define CMS_R_ADD_SIGNER_ERROR 99
455
+ #define CMS_R_CERTIFICATE_ALREADY_PRESENT 175
456
+ #define CMS_R_CERTIFICATE_HAS_NO_KEYID 160
457
+ #define CMS_R_CERTIFICATE_VERIFY_ERROR 100
458
+ #define CMS_R_CIPHER_INITIALISATION_ERROR 101
459
+ #define CMS_R_CIPHER_PARAMETER_INITIALISATION_ERROR 102
460
+ #define CMS_R_CMS_DATAFINAL_ERROR 103
461
+ #define CMS_R_CMS_LIB 104
462
+ #define CMS_R_CONTENTIDENTIFIER_MISMATCH 170
463
+ #define CMS_R_CONTENT_NOT_FOUND 105
464
+ #define CMS_R_CONTENT_TYPE_MISMATCH 171
465
+ #define CMS_R_CONTENT_TYPE_NOT_COMPRESSED_DATA 106
466
+ #define CMS_R_CONTENT_TYPE_NOT_ENVELOPED_DATA 107
467
+ #define CMS_R_CONTENT_TYPE_NOT_SIGNED_DATA 108
468
+ #define CMS_R_CONTENT_VERIFY_ERROR 109
469
+ #define CMS_R_CTRL_ERROR 110
470
+ #define CMS_R_CTRL_FAILURE 111
471
+ #define CMS_R_DECRYPT_ERROR 112
472
+ #define CMS_R_ERROR_GETTING_PUBLIC_KEY 113
473
+ #define CMS_R_ERROR_READING_MESSAGEDIGEST_ATTRIBUTE 114
474
+ #define CMS_R_ERROR_SETTING_KEY 115
475
+ #define CMS_R_ERROR_SETTING_RECIPIENTINFO 116
476
+ #define CMS_R_INVALID_ENCRYPTED_KEY_LENGTH 117
477
+ #define CMS_R_INVALID_KEY_ENCRYPTION_PARAMETER 176
478
+ #define CMS_R_INVALID_KEY_LENGTH 118
479
+ #define CMS_R_MD_BIO_INIT_ERROR 119
480
+ #define CMS_R_MESSAGEDIGEST_ATTRIBUTE_WRONG_LENGTH 120
481
+ #define CMS_R_MESSAGEDIGEST_WRONG_LENGTH 121
482
+ #define CMS_R_MSGSIGDIGEST_ERROR 172
483
+ #define CMS_R_MSGSIGDIGEST_VERIFICATION_FAILURE 162
484
+ #define CMS_R_MSGSIGDIGEST_WRONG_LENGTH 163
485
+ #define CMS_R_NEED_ONE_SIGNER 164
486
+ #define CMS_R_NOT_A_SIGNED_RECEIPT 165
487
+ #define CMS_R_NOT_ENCRYPTED_DATA 122
488
+ #define CMS_R_NOT_KEK 123
489
+ #define CMS_R_NOT_KEY_AGREEMENT 181
490
+ #define CMS_R_NOT_KEY_TRANSPORT 124
491
+ #define CMS_R_NOT_PWRI 177
492
+ #define CMS_R_NOT_SUPPORTED_FOR_THIS_KEY_TYPE 125
493
+ #define CMS_R_NO_CIPHER 126
494
+ #define CMS_R_NO_CONTENT 127
495
+ #define CMS_R_NO_CONTENT_TYPE 173
496
+ #define CMS_R_NO_DEFAULT_DIGEST 128
497
+ #define CMS_R_NO_DIGEST_SET 129
498
+ #define CMS_R_NO_KEY 130
499
+ #define CMS_R_NO_KEY_OR_CERT 174
500
+ #define CMS_R_NO_MATCHING_DIGEST 131
501
+ #define CMS_R_NO_MATCHING_RECIPIENT 132
502
+ #define CMS_R_NO_MATCHING_SIGNATURE 166
503
+ #define CMS_R_NO_MSGSIGDIGEST 167
504
+ #define CMS_R_NO_PASSWORD 178
505
+ #define CMS_R_NO_PRIVATE_KEY 133
506
+ #define CMS_R_NO_PUBLIC_KEY 134
507
+ #define CMS_R_NO_RECEIPT_REQUEST 168
508
+ #define CMS_R_NO_SIGNERS 135
509
+ #define CMS_R_PRIVATE_KEY_DOES_NOT_MATCH_CERTIFICATE 136
510
+ #define CMS_R_RECEIPT_DECODE_ERROR 169
511
+ #define CMS_R_RECIPIENT_ERROR 137
512
+ #define CMS_R_SIGNER_CERTIFICATE_NOT_FOUND 138
513
+ #define CMS_R_SIGNFINAL_ERROR 139
514
+ #define CMS_R_SMIME_TEXT_ERROR 140
515
+ #define CMS_R_STORE_INIT_ERROR 141
516
+ #define CMS_R_TYPE_NOT_COMPRESSED_DATA 142
517
+ #define CMS_R_TYPE_NOT_DATA 143
518
+ #define CMS_R_TYPE_NOT_DIGESTED_DATA 144
519
+ #define CMS_R_TYPE_NOT_ENCRYPTED_DATA 145
520
+ #define CMS_R_TYPE_NOT_ENVELOPED_DATA 146
521
+ #define CMS_R_UNABLE_TO_FINALIZE_CONTEXT 147
522
+ #define CMS_R_UNKNOWN_CIPHER 148
523
+ #define CMS_R_UNKNOWN_DIGEST_ALGORITHM 149
524
+ #define CMS_R_UNKNOWN_ID 150
525
+ #define CMS_R_UNSUPPORTED_COMPRESSION_ALGORITHM 151
526
+ #define CMS_R_UNSUPPORTED_CONTENT_TYPE 152
527
+ #define CMS_R_UNSUPPORTED_KEK_ALGORITHM 153
528
+ #define CMS_R_UNSUPPORTED_KEY_ENCRYPTION_ALGORITHM 179
529
+ #define CMS_R_UNSUPPORTED_RECIPIENTINFO_TYPE 155
530
+ #define CMS_R_UNSUPPORTED_RECIPIENT_TYPE 154
531
+ #define CMS_R_UNSUPPORTED_TYPE 156
532
+ #define CMS_R_UNWRAP_ERROR 157
533
+ #define CMS_R_UNWRAP_FAILURE 180
534
+ #define CMS_R_VERIFICATION_FAILURE 158
535
+ #define CMS_R_WRAP_ERROR 159
536
+
537
+ #ifdef __cplusplus
538
+ }
539
+ #endif
540
+ #endif
541
+ #endif
@@ -0,0 +1,7 @@
1
+ /* $OpenBSD: comp.h,v 1.13 2023/07/28 09:42:44 tb Exp $ */
2
+
3
+ /*
4
+ * Public domain.
5
+ *
6
+ * This header is intentionally left empty. Some software uses it unnecessarily.
7
+ */