Remove outdated DEBUG flags.
[openssl.git] / crypto / pkcs7 / pk7_smime.c
1 /*
2  * Written by Dr Stephen N Henson (steve@openssl.org) for the OpenSSL
3  * project.
4  */
5 /* ====================================================================
6  * Copyright (c) 1999-2004 The OpenSSL Project.  All rights reserved.
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  *
12  * 1. Redistributions of source code must retain the above copyright
13  *    notice, this list of conditions and the following disclaimer.
14  *
15  * 2. Redistributions in binary form must reproduce the above copyright
16  *    notice, this list of conditions and the following disclaimer in
17  *    the documentation and/or other materials provided with the
18  *    distribution.
19  *
20  * 3. All advertising materials mentioning features or use of this
21  *    software must display the following acknowledgment:
22  *    "This product includes software developed by the OpenSSL Project
23  *    for use in the OpenSSL Toolkit. (http://www.OpenSSL.org/)"
24  *
25  * 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
26  *    endorse or promote products derived from this software without
27  *    prior written permission. For written permission, please contact
28  *    licensing@OpenSSL.org.
29  *
30  * 5. Products derived from this software may not be called "OpenSSL"
31  *    nor may "OpenSSL" appear in their names without prior written
32  *    permission of the OpenSSL Project.
33  *
34  * 6. Redistributions of any form whatsoever must retain the following
35  *    acknowledgment:
36  *    "This product includes software developed by the OpenSSL Project
37  *    for use in the OpenSSL Toolkit (http://www.OpenSSL.org/)"
38  *
39  * THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY
40  * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
41  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
42  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE OpenSSL PROJECT OR
43  * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
44  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
45  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
46  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
47  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
48  * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
49  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
50  * OF THE POSSIBILITY OF SUCH DAMAGE.
51  * ====================================================================
52  *
53  * This product includes cryptographic software written by Eric Young
54  * (eay@cryptsoft.com).  This product includes software written by Tim
55  * Hudson (tjh@cryptsoft.com).
56  *
57  */
58
59 /* Simple PKCS#7 processing functions */
60
61 #include <stdio.h>
62 #include "internal/cryptlib.h"
63 #include <openssl/x509.h>
64 #include <openssl/x509v3.h>
65
66
67 #define BUFFERSIZE 4096
68
69 static int pkcs7_copy_existing_digest(PKCS7 *p7, PKCS7_SIGNER_INFO *si);
70
71 PKCS7 *PKCS7_sign(X509 *signcert, EVP_PKEY *pkey, STACK_OF(X509) *certs,
72                   BIO *data, int flags)
73 {
74     PKCS7 *p7;
75     int i;
76
77     if ((p7 = PKCS7_new()) == NULL) {
78         PKCS7err(PKCS7_F_PKCS7_SIGN, ERR_R_MALLOC_FAILURE);
79         return NULL;
80     }
81
82     if (!PKCS7_set_type(p7, NID_pkcs7_signed))
83         goto err;
84
85     if (!PKCS7_content_new(p7, NID_pkcs7_data))
86         goto err;
87
88     if (pkey && !PKCS7_sign_add_signer(p7, signcert, pkey, NULL, flags)) {
89         PKCS7err(PKCS7_F_PKCS7_SIGN, PKCS7_R_PKCS7_ADD_SIGNER_ERROR);
90         goto err;
91     }
92
93     if (!(flags & PKCS7_NOCERTS)) {
94         for (i = 0; i < sk_X509_num(certs); i++) {
95             if (!PKCS7_add_certificate(p7, sk_X509_value(certs, i)))
96                 goto err;
97         }
98     }
99
100     if (flags & PKCS7_DETACHED)
101         PKCS7_set_detached(p7, 1);
102
103     if (flags & (PKCS7_STREAM | PKCS7_PARTIAL))
104         return p7;
105
106     if (PKCS7_final(p7, data, flags))
107         return p7;
108
109  err:
110     PKCS7_free(p7);
111     return NULL;
112 }
113
114 int PKCS7_final(PKCS7 *p7, BIO *data, int flags)
115 {
116     BIO *p7bio;
117     int ret = 0;
118
119     if ((p7bio = PKCS7_dataInit(p7, NULL)) == NULL) {
120         PKCS7err(PKCS7_F_PKCS7_FINAL, ERR_R_MALLOC_FAILURE);
121         return 0;
122     }
123
124     SMIME_crlf_copy(data, p7bio, flags);
125
126     (void)BIO_flush(p7bio);
127
128     if (!PKCS7_dataFinal(p7, p7bio)) {
129         PKCS7err(PKCS7_F_PKCS7_FINAL, PKCS7_R_PKCS7_DATASIGN);
130         goto err;
131     }
132
133     ret = 1;
134
135  err:
136     BIO_free_all(p7bio);
137
138     return ret;
139
140 }
141
142 /* Check to see if a cipher exists and if so add S/MIME capabilities */
143
144 static int add_cipher_smcap(STACK_OF(X509_ALGOR) *sk, int nid, int arg)
145 {
146     if (EVP_get_cipherbynid(nid))
147         return PKCS7_simple_smimecap(sk, nid, arg);
148     return 1;
149 }
150
151 static int add_digest_smcap(STACK_OF(X509_ALGOR) *sk, int nid, int arg)
152 {
153     if (EVP_get_digestbynid(nid))
154         return PKCS7_simple_smimecap(sk, nid, arg);
155     return 1;
156 }
157
158 PKCS7_SIGNER_INFO *PKCS7_sign_add_signer(PKCS7 *p7, X509 *signcert,
159                                          EVP_PKEY *pkey, const EVP_MD *md,
160                                          int flags)
161 {
162     PKCS7_SIGNER_INFO *si = NULL;
163     STACK_OF(X509_ALGOR) *smcap = NULL;
164     if (!X509_check_private_key(signcert, pkey)) {
165         PKCS7err(PKCS7_F_PKCS7_SIGN_ADD_SIGNER,
166                  PKCS7_R_PRIVATE_KEY_DOES_NOT_MATCH_CERTIFICATE);
167         return NULL;
168     }
169
170     if ((si = PKCS7_add_signature(p7, signcert, pkey, md)) == NULL) {
171         PKCS7err(PKCS7_F_PKCS7_SIGN_ADD_SIGNER,
172                  PKCS7_R_PKCS7_ADD_SIGNATURE_ERROR);
173         return NULL;
174     }
175
176     if (!(flags & PKCS7_NOCERTS)) {
177         if (!PKCS7_add_certificate(p7, signcert))
178             goto err;
179     }
180
181     if (!(flags & PKCS7_NOATTR)) {
182         if (!PKCS7_add_attrib_content_type(si, NULL))
183             goto err;
184         /* Add SMIMECapabilities */
185         if (!(flags & PKCS7_NOSMIMECAP)) {
186             if ((smcap = sk_X509_ALGOR_new_null()) == NULL) {
187                 PKCS7err(PKCS7_F_PKCS7_SIGN_ADD_SIGNER, ERR_R_MALLOC_FAILURE);
188                 goto err;
189             }
190             if (!add_cipher_smcap(smcap, NID_aes_256_cbc, -1)
191                 || !add_digest_smcap(smcap, NID_id_GostR3411_2012_256, -1)
192                 || !add_digest_smcap(smcap, NID_id_GostR3411_2012_512, -1)
193                 || !add_digest_smcap(smcap, NID_id_GostR3411_94, -1)
194                 || !add_cipher_smcap(smcap, NID_id_Gost28147_89, -1)
195                 || !add_cipher_smcap(smcap, NID_aes_192_cbc, -1)
196                 || !add_cipher_smcap(smcap, NID_aes_128_cbc, -1)
197                 || !add_cipher_smcap(smcap, NID_des_ede3_cbc, -1)
198                 || !add_cipher_smcap(smcap, NID_rc2_cbc, 128)
199                 || !add_cipher_smcap(smcap, NID_rc2_cbc, 64)
200                 || !add_cipher_smcap(smcap, NID_des_cbc, -1)
201                 || !add_cipher_smcap(smcap, NID_rc2_cbc, 40)
202                 || !PKCS7_add_attrib_smimecap(si, smcap))
203                 goto err;
204             sk_X509_ALGOR_pop_free(smcap, X509_ALGOR_free);
205             smcap = NULL;
206         }
207         if (flags & PKCS7_REUSE_DIGEST) {
208             if (!pkcs7_copy_existing_digest(p7, si))
209                 goto err;
210             if (!(flags & PKCS7_PARTIAL) && !PKCS7_SIGNER_INFO_sign(si))
211                 goto err;
212         }
213     }
214     return si;
215  err:
216     sk_X509_ALGOR_pop_free(smcap, X509_ALGOR_free);
217     return NULL;
218 }
219
220 /*
221  * Search for a digest matching SignerInfo digest type and if found copy
222  * across.
223  */
224
225 static int pkcs7_copy_existing_digest(PKCS7 *p7, PKCS7_SIGNER_INFO *si)
226 {
227     int i;
228     STACK_OF(PKCS7_SIGNER_INFO) *sinfos;
229     PKCS7_SIGNER_INFO *sitmp;
230     ASN1_OCTET_STRING *osdig = NULL;
231     sinfos = PKCS7_get_signer_info(p7);
232     for (i = 0; i < sk_PKCS7_SIGNER_INFO_num(sinfos); i++) {
233         sitmp = sk_PKCS7_SIGNER_INFO_value(sinfos, i);
234         if (si == sitmp)
235             break;
236         if (sk_X509_ATTRIBUTE_num(sitmp->auth_attr) <= 0)
237             continue;
238         if (!OBJ_cmp(si->digest_alg->algorithm, sitmp->digest_alg->algorithm)) {
239             osdig = PKCS7_digest_from_attributes(sitmp->auth_attr);
240             break;
241         }
242
243     }
244
245     if (osdig)
246         return PKCS7_add1_attrib_digest(si, osdig->data, osdig->length);
247
248     PKCS7err(PKCS7_F_PKCS7_COPY_EXISTING_DIGEST,
249              PKCS7_R_NO_MATCHING_DIGEST_TYPE_FOUND);
250     return 0;
251 }
252
253 int PKCS7_verify(PKCS7 *p7, STACK_OF(X509) *certs, X509_STORE *store,
254                  BIO *indata, BIO *out, int flags)
255 {
256     STACK_OF(X509) *signers;
257     X509 *signer;
258     STACK_OF(PKCS7_SIGNER_INFO) *sinfos;
259     PKCS7_SIGNER_INFO *si;
260     X509_STORE_CTX cert_ctx;
261     char *buf = NULL;
262     int i, j = 0, k, ret = 0;
263     BIO *p7bio = NULL;
264     BIO *tmpin = NULL, *tmpout = NULL;
265
266     if (!p7) {
267         PKCS7err(PKCS7_F_PKCS7_VERIFY, PKCS7_R_INVALID_NULL_POINTER);
268         return 0;
269     }
270
271     if (!PKCS7_type_is_signed(p7)) {
272         PKCS7err(PKCS7_F_PKCS7_VERIFY, PKCS7_R_WRONG_CONTENT_TYPE);
273         return 0;
274     }
275
276     /* Check for no data and no content: no data to verify signature */
277     if (PKCS7_get_detached(p7) && !indata) {
278         PKCS7err(PKCS7_F_PKCS7_VERIFY, PKCS7_R_NO_CONTENT);
279         return 0;
280     }
281
282     /* Check for data and content: two sets of data */
283     if (!PKCS7_get_detached(p7) && indata) {
284         PKCS7err(PKCS7_F_PKCS7_VERIFY, PKCS7_R_CONTENT_AND_DATA_PRESENT);
285         return 0;
286     }
287
288     sinfos = PKCS7_get_signer_info(p7);
289
290     if (!sinfos || !sk_PKCS7_SIGNER_INFO_num(sinfos)) {
291         PKCS7err(PKCS7_F_PKCS7_VERIFY, PKCS7_R_NO_SIGNATURES_ON_DATA);
292         return 0;
293     }
294
295     signers = PKCS7_get0_signers(p7, certs, flags);
296     if (!signers)
297         return 0;
298
299     /* Now verify the certificates */
300
301     if (!(flags & PKCS7_NOVERIFY))
302         for (k = 0; k < sk_X509_num(signers); k++) {
303             signer = sk_X509_value(signers, k);
304             if (!(flags & PKCS7_NOCHAIN)) {
305                 if (!X509_STORE_CTX_init(&cert_ctx, store, signer,
306                                          p7->d.sign->cert)) {
307                     PKCS7err(PKCS7_F_PKCS7_VERIFY, ERR_R_X509_LIB);
308                     goto err;
309                 }
310                 X509_STORE_CTX_set_default(&cert_ctx, "smime_sign");
311             } else if (!X509_STORE_CTX_init(&cert_ctx, store, signer, NULL)) {
312                 PKCS7err(PKCS7_F_PKCS7_VERIFY, ERR_R_X509_LIB);
313                 goto err;
314             }
315             if (!(flags & PKCS7_NOCRL))
316                 X509_STORE_CTX_set0_crls(&cert_ctx, p7->d.sign->crl);
317             i = X509_verify_cert(&cert_ctx);
318             if (i <= 0)
319                 j = X509_STORE_CTX_get_error(&cert_ctx);
320             X509_STORE_CTX_cleanup(&cert_ctx);
321             if (i <= 0) {
322                 PKCS7err(PKCS7_F_PKCS7_VERIFY,
323                          PKCS7_R_CERTIFICATE_VERIFY_ERROR);
324                 ERR_add_error_data(2, "Verify error:",
325                                    X509_verify_cert_error_string(j));
326                 goto err;
327             }
328             /* Check for revocation status here */
329         }
330
331     /*
332      * Performance optimization: if the content is a memory BIO then store
333      * its contents in a temporary read only memory BIO. This avoids
334      * potentially large numbers of slow copies of data which will occur when
335      * reading from a read write memory BIO when signatures are calculated.
336      */
337
338     if (indata && (BIO_method_type(indata) == BIO_TYPE_MEM)) {
339         char *ptr;
340         long len;
341         len = BIO_get_mem_data(indata, &ptr);
342         tmpin = BIO_new_mem_buf(ptr, len);
343         if (tmpin == NULL) {
344             PKCS7err(PKCS7_F_PKCS7_VERIFY, ERR_R_MALLOC_FAILURE);
345             goto err;
346         }
347     } else
348         tmpin = indata;
349
350     if ((p7bio = PKCS7_dataInit(p7, tmpin)) == NULL)
351         goto err;
352
353     if (flags & PKCS7_TEXT) {
354         if ((tmpout = BIO_new(BIO_s_mem())) == NULL) {
355             PKCS7err(PKCS7_F_PKCS7_VERIFY, ERR_R_MALLOC_FAILURE);
356             goto err;
357         }
358         BIO_set_mem_eof_return(tmpout, 0);
359     } else
360         tmpout = out;
361
362     /* We now have to 'read' from p7bio to calculate digests etc. */
363     if ((buf = OPENSSL_malloc(BUFFERSIZE)) == NULL) {
364         PKCS7err(PKCS7_F_PKCS7_VERIFY, ERR_R_MALLOC_FAILURE);
365         goto err;
366     }
367     for (;;) {
368         i = BIO_read(p7bio, buf, BUFFERSIZE);
369         if (i <= 0)
370             break;
371         if (tmpout)
372             BIO_write(tmpout, buf, i);
373     }
374
375     if (flags & PKCS7_TEXT) {
376         if (!SMIME_text(tmpout, out)) {
377             PKCS7err(PKCS7_F_PKCS7_VERIFY, PKCS7_R_SMIME_TEXT_ERROR);
378             BIO_free(tmpout);
379             goto err;
380         }
381         BIO_free(tmpout);
382     }
383
384     /* Now Verify All Signatures */
385     if (!(flags & PKCS7_NOSIGS))
386         for (i = 0; i < sk_PKCS7_SIGNER_INFO_num(sinfos); i++) {
387             si = sk_PKCS7_SIGNER_INFO_value(sinfos, i);
388             signer = sk_X509_value(signers, i);
389             j = PKCS7_signatureVerify(p7bio, p7, si, signer);
390             if (j <= 0) {
391                 PKCS7err(PKCS7_F_PKCS7_VERIFY, PKCS7_R_SIGNATURE_FAILURE);
392                 goto err;
393             }
394         }
395
396     ret = 1;
397
398  err:
399     OPENSSL_free(buf);
400     if (tmpin == indata) {
401         if (indata)
402             BIO_pop(p7bio);
403     }
404     BIO_free_all(p7bio);
405     sk_X509_free(signers);
406     return ret;
407 }
408
409 STACK_OF(X509) *PKCS7_get0_signers(PKCS7 *p7, STACK_OF(X509) *certs,
410                                    int flags)
411 {
412     STACK_OF(X509) *signers;
413     STACK_OF(PKCS7_SIGNER_INFO) *sinfos;
414     PKCS7_SIGNER_INFO *si;
415     PKCS7_ISSUER_AND_SERIAL *ias;
416     X509 *signer;
417     int i;
418
419     if (!p7) {
420         PKCS7err(PKCS7_F_PKCS7_GET0_SIGNERS, PKCS7_R_INVALID_NULL_POINTER);
421         return NULL;
422     }
423
424     if (!PKCS7_type_is_signed(p7)) {
425         PKCS7err(PKCS7_F_PKCS7_GET0_SIGNERS, PKCS7_R_WRONG_CONTENT_TYPE);
426         return NULL;
427     }
428
429     /* Collect all the signers together */
430
431     sinfos = PKCS7_get_signer_info(p7);
432
433     if (sk_PKCS7_SIGNER_INFO_num(sinfos) <= 0) {
434         PKCS7err(PKCS7_F_PKCS7_GET0_SIGNERS, PKCS7_R_NO_SIGNERS);
435         return 0;
436     }
437
438     if ((signers = sk_X509_new_null()) == NULL) {
439         PKCS7err(PKCS7_F_PKCS7_GET0_SIGNERS, ERR_R_MALLOC_FAILURE);
440         return NULL;
441     }
442
443     for (i = 0; i < sk_PKCS7_SIGNER_INFO_num(sinfos); i++) {
444         si = sk_PKCS7_SIGNER_INFO_value(sinfos, i);
445         ias = si->issuer_and_serial;
446         signer = NULL;
447         /* If any certificates passed they take priority */
448         if (certs)
449             signer = X509_find_by_issuer_and_serial(certs,
450                                                     ias->issuer, ias->serial);
451         if (!signer && !(flags & PKCS7_NOINTERN)
452             && p7->d.sign->cert)
453             signer =
454                 X509_find_by_issuer_and_serial(p7->d.sign->cert,
455                                                ias->issuer, ias->serial);
456         if (!signer) {
457             PKCS7err(PKCS7_F_PKCS7_GET0_SIGNERS,
458                      PKCS7_R_SIGNER_CERTIFICATE_NOT_FOUND);
459             sk_X509_free(signers);
460             return 0;
461         }
462
463         if (!sk_X509_push(signers, signer)) {
464             sk_X509_free(signers);
465             return NULL;
466         }
467     }
468     return signers;
469 }
470
471 /* Build a complete PKCS#7 enveloped data */
472
473 PKCS7 *PKCS7_encrypt(STACK_OF(X509) *certs, BIO *in, const EVP_CIPHER *cipher,
474                      int flags)
475 {
476     PKCS7 *p7;
477     BIO *p7bio = NULL;
478     int i;
479     X509 *x509;
480     if ((p7 = PKCS7_new()) == NULL) {
481         PKCS7err(PKCS7_F_PKCS7_ENCRYPT, ERR_R_MALLOC_FAILURE);
482         return NULL;
483     }
484
485     if (!PKCS7_set_type(p7, NID_pkcs7_enveloped))
486         goto err;
487     if (!PKCS7_set_cipher(p7, cipher)) {
488         PKCS7err(PKCS7_F_PKCS7_ENCRYPT, PKCS7_R_ERROR_SETTING_CIPHER);
489         goto err;
490     }
491
492     for (i = 0; i < sk_X509_num(certs); i++) {
493         x509 = sk_X509_value(certs, i);
494         if (!PKCS7_add_recipient(p7, x509)) {
495             PKCS7err(PKCS7_F_PKCS7_ENCRYPT, PKCS7_R_ERROR_ADDING_RECIPIENT);
496             goto err;
497         }
498     }
499
500     if (flags & PKCS7_STREAM)
501         return p7;
502
503     if (PKCS7_final(p7, in, flags))
504         return p7;
505
506  err:
507
508     BIO_free_all(p7bio);
509     PKCS7_free(p7);
510     return NULL;
511
512 }
513
514 int PKCS7_decrypt(PKCS7 *p7, EVP_PKEY *pkey, X509 *cert, BIO *data, int flags)
515 {
516     BIO *tmpmem;
517     int ret = 0, i;
518     char *buf = NULL;
519
520     if (!p7) {
521         PKCS7err(PKCS7_F_PKCS7_DECRYPT, PKCS7_R_INVALID_NULL_POINTER);
522         return 0;
523     }
524
525     if (!PKCS7_type_is_enveloped(p7)) {
526         PKCS7err(PKCS7_F_PKCS7_DECRYPT, PKCS7_R_WRONG_CONTENT_TYPE);
527         return 0;
528     }
529
530     if (cert && !X509_check_private_key(cert, pkey)) {
531         PKCS7err(PKCS7_F_PKCS7_DECRYPT,
532                  PKCS7_R_PRIVATE_KEY_DOES_NOT_MATCH_CERTIFICATE);
533         return 0;
534     }
535
536     if ((tmpmem = PKCS7_dataDecode(p7, pkey, NULL, cert)) == NULL) {
537         PKCS7err(PKCS7_F_PKCS7_DECRYPT, PKCS7_R_DECRYPT_ERROR);
538         return 0;
539     }
540
541     if (flags & PKCS7_TEXT) {
542         BIO *tmpbuf, *bread;
543         /* Encrypt BIOs can't do BIO_gets() so add a buffer BIO */
544         if ((tmpbuf = BIO_new(BIO_f_buffer())) == NULL) {
545             PKCS7err(PKCS7_F_PKCS7_DECRYPT, ERR_R_MALLOC_FAILURE);
546             BIO_free_all(tmpmem);
547             return 0;
548         }
549         if ((bread = BIO_push(tmpbuf, tmpmem)) == NULL) {
550             PKCS7err(PKCS7_F_PKCS7_DECRYPT, ERR_R_MALLOC_FAILURE);
551             BIO_free_all(tmpbuf);
552             BIO_free_all(tmpmem);
553             return 0;
554         }
555         ret = SMIME_text(bread, data);
556         if (ret > 0 && BIO_method_type(tmpmem) == BIO_TYPE_CIPHER) {
557             if (!BIO_get_cipher_status(tmpmem))
558                 ret = 0;
559         }
560         BIO_free_all(bread);
561         return ret;
562     }
563     if ((buf = OPENSSL_malloc(BUFFERSIZE)) == NULL) {
564         PKCS7err(PKCS7_F_PKCS7_DECRYPT, ERR_R_MALLOC_FAILURE);
565         goto err;
566     }
567     for (;;) {
568         i = BIO_read(tmpmem, buf, BUFFERSIZE);
569         if (i <= 0) {
570             ret = 1;
571             if (BIO_method_type(tmpmem) == BIO_TYPE_CIPHER) {
572                 if (!BIO_get_cipher_status(tmpmem))
573                     ret = 0;
574             }
575
576             break;
577         }
578         if (BIO_write(data, buf, i) != i) {
579             break;
580         }
581     }
582 err:
583     OPENSSL_free(buf);
584     BIO_free_all(tmpmem);
585     return ret;
586 }