apps/dgst.c

   1 /* apps/dgst.c */
   2 /* Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com)
   3  * All rights reserved.
   4  *
   5  * This package is an SSL implementation written
   6  * by Eric Young (eay@cryptsoft.com).
   7  * The implementation was written so as to conform with Netscapes SSL.
   8  *
   9  * This library is free for commercial and non-commercial use as long as
  10  * the following conditions are aheared to.  The following conditions
  11  * apply to all code found in this distribution, be it the RC4, RSA,
  12  * lhash, DES, etc., code; not just the SSL code.  The SSL documentation
  13  * included with this distribution is covered by the same copyright terms
  14  * except that the holder is Tim Hudson (tjh@cryptsoft.com).
  15  *
  16  * Copyright remains Eric Young's, and as such any Copyright notices in
  17  * the code are not to be removed.
  18  * If this package is used in a product, Eric Young should be given attribution
  19  * as the author of the parts of the library used.
  20  * This can be in the form of a textual message at program startup or
  21  * in documentation (online or textual) provided with the package.
  22  *
  23  * Redistribution and use in source and binary forms, with or without
  24  * modification, are permitted provided that the following conditions
  25  * are met:
  26  * 1. Redistributions of source code must retain the copyright
  27  *    notice, this list of conditions and the following disclaimer.
  28  * 2. Redistributions in binary form must reproduce the above copyright
  29  *    notice, this list of conditions and the following disclaimer in the
  30  *    documentation and/or other materials provided with the distribution.
  31  * 3. All advertising materials mentioning features or use of this software
  32  *    must display the following acknowledgement:
  33  *    "This product includes cryptographic software written by
  34  *     Eric Young (eay@cryptsoft.com)"
  35  *    The word 'cryptographic' can be left out if the rouines from the library
  36  *    being used are not cryptographic related :-).
  37  * 4. If you include any Windows specific code (or a derivative thereof) from
  38  *    the apps directory (application code) you must include an acknowledgement:
  39  *    "This product includes software written by Tim Hudson (tjh@cryptsoft.com)"
  40  *
  41  * THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND
  42  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  43  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  44  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
  45  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  46  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  47  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  48  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  49  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  50  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  51  * SUCH DAMAGE.
  52  *
  53  * The licence and distribution terms for any publically available version or
  54  * derivative of this code cannot be changed.  i.e. this code cannot simply be
  55  * copied and put under another distribution licence
  56  * [including the GNU Public Licence.]
  57  */
  58
  59 #include <stdio.h>
  60 #include <string.h>
  61 #include <stdlib.h>
  62 #include "apps.h"
  63 #include <openssl/bio.h>
  64 #include <openssl/err.h>
  65 #include <openssl/evp.h>
  66 #include <openssl/objects.h>
  67 #include <openssl/x509.h>
  68 #include <openssl/pem.h>
  69 #include <openssl/hmac.h>
  70
  71 #undef BUFSIZE
  72 #define BUFSIZE 1024*8
  73
  74 #undef PROG
  75 #define PROG    dgst_main
  76
  77 int do_fp(BIO *out, unsigned char *buf, BIO *bp, int sep, int binout,
  78           EVP_PKEY *key, unsigned char *sigin, int siglen,
  79           const char *sig_name, const char *md_name,
  80           const char *file,BIO *bmd);
  81
  82 int MAIN(int, char **);
  83
  84 int MAIN(int argc, char **argv)
  85         {
  86         ENGINE *e = NULL;
  87         unsigned char *buf=NULL;
  88         int i,err=1;
  89         const EVP_MD *md=NULL,*m;
  90         BIO *in=NULL,*inp;
  91         BIO *bmd=NULL;
  92         BIO *out = NULL;
  93 #define PROG_NAME_SIZE  39
  94         char pname[PROG_NAME_SIZE+1];
  95         int separator=0;
  96         int debug=0;
  97         int keyform=FORMAT_PEM;
  98         const char *outfile = NULL, *keyfile = NULL;
  99         const char *sigfile = NULL, *randfile = NULL;
 100         int out_bin = -1, want_pub = 0, do_verify = 0;
 101         EVP_PKEY *sigkey = NULL;
 102         unsigned char *sigbuf = NULL;
 103         int siglen = 0;
 104         char *passargin = NULL, *passin = NULL;
 105 #ifndef OPENSSL_NO_ENGINE
 106         char *engine=NULL;
 107 #endif
 108         char *hmac_key=NULL;
 109         char *mac_name=NULL;
 110         STACK *sigopts = NULL, *macopts = NULL;
 111
 112         apps_startup();
 113
 114         if ((buf=(unsigned char *)OPENSSL_malloc(BUFSIZE)) == NULL)
 115                 {
 116                 BIO_printf(bio_err,"out of memory\n");
 117                 goto end;
 118                 }
 119         if (bio_err == NULL)
 120                 if ((bio_err=BIO_new(BIO_s_file())) != NULL)
 121                         BIO_set_fp(bio_err,stderr,BIO_NOCLOSE|BIO_FP_TEXT);
 122
 123         if (!load_config(bio_err, NULL))
 124                 goto end;
 125
 126         /* first check the program name */
 127         program_name(argv[0],pname,sizeof pname);
 128
 129         md=EVP_get_digestbyname(pname);
 130
 131         argc--;
 132         argv++;
 133         while (argc > 0)
 134                 {
 135                 if ((*argv)[0] != '-') break;
 136                 if (strcmp(*argv,"-c") == 0)
 137                         separator=1;
 138                 else if (strcmp(*argv,"-rand") == 0)
 139                         {
 140                         if (--argc < 1) break;
 141                         randfile=*(++argv);
 142                         }
 143                 else if (strcmp(*argv,"-out") == 0)
 144                         {
 145                         if (--argc < 1) break;
 146                         outfile=*(++argv);
 147                         }
 148                 else if (strcmp(*argv,"-sign") == 0)
 149                         {
 150                         if (--argc < 1) break;
 151                         keyfile=*(++argv);
 152                         }
 153                 else if (!strcmp(*argv,"-passin"))
 154                         {
 155                         if (--argc < 1)
 156                                 break;
 157                         passargin=*++argv;
 158                         }
 159                 else if (strcmp(*argv,"-verify") == 0)
 160                         {
 161                         if (--argc < 1) break;
 162                         keyfile=*(++argv);
 163                         want_pub = 1;
 164                         do_verify = 1;
 165                         }
 166                 else if (strcmp(*argv,"-prverify") == 0)
 167                         {
 168                         if (--argc < 1) break;
 169                         keyfile=*(++argv);
 170                         do_verify = 1;
 171                         }
 172                 else if (strcmp(*argv,"-signature") == 0)
 173                         {
 174                         if (--argc < 1) break;
 175                         sigfile=*(++argv);
 176                         }
 177                 else if (strcmp(*argv,"-keyform") == 0)
 178                         {
 179                         if (--argc < 1) break;
 180                         keyform=str2fmt(*(++argv));
 181                         }
 182 #ifndef OPENSSL_NO_ENGINE
 183                 else if (strcmp(*argv,"-engine") == 0)
 184                         {
 185                         if (--argc < 1) break;
 186                         engine= *(++argv);
 187                         e = setup_engine(bio_err, engine, 0);
 188                         }
 189 #endif
 190                 else if (strcmp(*argv,"-hex") == 0)
 191                         out_bin = 0;
 192                 else if (strcmp(*argv,"-binary") == 0)
 193                         out_bin = 1;
 194                 else if (strcmp(*argv,"-d") == 0)
 195                         debug=1;
 196                 else if (!strcmp(*argv,"-hmac"))
 197                         {
 198                         if (--argc < 1)
 199                                 break;
 200                         hmac_key=*++argv;
 201                         }
 202                 else if (!strcmp(*argv,"-mac"))
 203                         {
 204                         if (--argc < 1)
 205                                 break;
 206                         mac_name=*++argv;
 207                         }
 208                 else if (strcmp(*argv,"-sigopt") == 0)
 209                         {
 210                         if (--argc < 1)
 211                                 break;
 212                         if (!sigopts)
 213                                 sigopts = sk_new_null();
 214                         if (!sigopts || !sk_push(sigopts, *(++argv)))
 215                                 break;
 216                         }
 217                 else if (strcmp(*argv,"-macopt") == 0)
 218                         {
 219                         if (--argc < 1)
 220                                 break;
 221                         if (!macopts)
 222                                 macopts = sk_new_null();
 223                         if (!macopts || !sk_push(macopts, *(++argv)))
 224                                 break;
 225                         }
 226                 else if ((m=EVP_get_digestbyname(&((*argv)[1]))) != NULL)
 227                         md=m;
 228                 else
 229                         break;
 230                 argc--;
 231                 argv++;
 232                 }
 233
 234
 235         if(do_verify && !sigfile) {
 236                 BIO_printf(bio_err, "No signature to verify: use the -signature option\n");
 237                 goto end;
 238         }
 239
 240         if ((argc > 0) && (argv[0][0] == '-')) /* bad option */
 241                 {
 242                 BIO_printf(bio_err,"unknown option '%s'\n",*argv);
 243                 BIO_printf(bio_err,"options are\n");
 244                 BIO_printf(bio_err,"-c              to output the digest with separating colons\n");
 245                 BIO_printf(bio_err,"-d              to output debug info\n");
 246                 BIO_printf(bio_err,"-hex            output as hex dump\n");
 247                 BIO_printf(bio_err,"-binary         output in binary form\n");
 248                 BIO_printf(bio_err,"-sign   file    sign digest using private key in file\n");
 249                 BIO_printf(bio_err,"-verify file    verify a signature using public key in file\n");
 250                 BIO_printf(bio_err,"-prverify file  verify a signature using private key in file\n");
 251                 BIO_printf(bio_err,"-keyform arg    key file format (PEM or ENGINE)\n");
 252                 BIO_printf(bio_err,"-signature file signature to verify\n");
 253                 BIO_printf(bio_err,"-sigopt nm:v    signature parameter\n");
 254                 BIO_printf(bio_err,"-binary         output in binary form\n");
 255 #ifndef OPENSSL_NO_ENGINE
 256                 BIO_printf(bio_err,"-engine e       use engine e, possibly a hardware device.\n");
 257 #endif
 258
 259                 BIO_printf(bio_err,"-%-14s to use the %s message digest algorithm (default)\n",
 260                         LN_md5,LN_md5);
 261                 BIO_printf(bio_err,"-%-14s to use the %s message digest algorithm\n",
 262                         LN_md4,LN_md4);
 263                 BIO_printf(bio_err,"-%-14s to use the %s message digest algorithm\n",
 264                         LN_md2,LN_md2);
 265 #ifndef OPENSSL_NO_SHA
 266                 BIO_printf(bio_err,"-%-14s to use the %s message digest algorithm\n",
 267                         LN_sha1,LN_sha1);
 268 #ifndef OPENSSL_NO_SHA256
 269                 BIO_printf(bio_err,"-%-14s to use the %s message digest algorithm\n",
 270                         LN_sha224,LN_sha224);
 271                 BIO_printf(bio_err,"-%-14s to use the %s message digest algorithm\n",
 272                         LN_sha256,LN_sha256);
 273 #endif
 274 #ifndef OPENSSL_NO_SHA512
 275                 BIO_printf(bio_err,"-%-14s to use the %s message digest algorithm\n",
 276                         LN_sha384,LN_sha384);
 277                 BIO_printf(bio_err,"-%-14s to use the %s message digest algorithm\n",
 278                         LN_sha512,LN_sha512);
 279 #endif
 280 #endif
 281                 BIO_printf(bio_err,"-%-14s to use the %s message digest algorithm\n",
 282                         LN_mdc2,LN_mdc2);
 283                 BIO_printf(bio_err,"-%-14s to use the %s message digest algorithm\n",
 284                         LN_ripemd160,LN_ripemd160);
 285 #ifndef OPENSSL_NO_WHIRLPOOL
 286                 BIO_printf(bio_err,"-%-14s to use the %s message digest algorithm\n",
 287                         SN_whirlpool,SN_whirlpool);
 288 #endif
 289                 goto end;
 290                 }
 291
 292         in=BIO_new(BIO_s_file());
 293         bmd=BIO_new(BIO_f_md());
 294         if (debug)
 295                 {
 296                 BIO_set_callback(in,BIO_debug_callback);
 297                 /* needed for windows 3.1 */
 298                 BIO_set_callback_arg(in,(char *)bio_err);
 299                 }
 300
 301         if(!app_passwd(bio_err, passargin, NULL, &passin, NULL))
 302                 {
 303                 BIO_printf(bio_err, "Error getting password\n");
 304                 goto end;
 305                 }
 306
 307         if ((in == NULL) || (bmd == NULL))
 308                 {
 309                 ERR_print_errors(bio_err);
 310                 goto end;
 311                 }
 312
 313         if(out_bin == -1) {
 314                 if(keyfile)
 315                         out_bin = 1;
 316                 else
 317                         out_bin = 0;
 318         }
 319
 320         if(randfile)
 321                 app_RAND_load_file(randfile, bio_err, 0);
 322
 323         if(outfile) {
 324                 if(out_bin)
 325                         out = BIO_new_file(outfile, "wb");
 326                 else    out = BIO_new_file(outfile, "w");
 327         } else {
 328                 out = BIO_new_fp(stdout, BIO_NOCLOSE);
 329 #ifdef OPENSSL_SYS_VMS
 330                 {
 331                 BIO *tmpbio = BIO_new(BIO_f_linebuffer());
 332                 out = BIO_push(tmpbio, out);
 333                 }
 334 #endif
 335         }
 336
 337         if(!out) {
 338                 BIO_printf(bio_err, "Error opening output file %s\n",
 339                                         outfile ? outfile : "(stdout)");
 340                 ERR_print_errors(bio_err);
 341                 goto end;
 342         }
 343         if ((!!mac_name + !!keyfile + !!hmac_key) > 1)
 344                 {
 345                 BIO_printf(bio_err, "MAC and Signing key cannot both be specified\n");
 346                 goto end;
 347                 }
 348
 349         if(keyfile)
 350                 {
 351                 if (want_pub)
 352                         sigkey = load_pubkey(bio_err, keyfile, keyform, 0, NULL,
 353                                 e, "key file");
 354                 else
 355                         sigkey = load_key(bio_err, keyfile, keyform, 0, passin,
 356                                 e, "key file");
 357                 if (!sigkey)
 358                         {
 359                         /* load_[pub]key() has already printed an appropriate
 360                            message */
 361                         goto end;
 362                         }
 363                 }
 364
 365         if (mac_name)
 366                 {
 367                 EVP_PKEY_CTX *mac_ctx = NULL;
 368                 int r = 0;
 369                 if (!init_gen_str(bio_err, &mac_ctx, mac_name,e, 0))
 370                         goto mac_end;
 371                 if (macopts)
 372                         {
 373                         char *macopt;
 374                         for (i = 0; i < sk_num(macopts); i++)
 375                                 {
 376                                 macopt = sk_value(macopts, i);
 377                                 if (pkey_ctrl_string(mac_ctx, macopt) <= 0)
 378                                         {
 379                                         BIO_printf(bio_err,
 380                                                 "MAC parameter error \"%s\"\n",
 381                                                 macopt);
 382                                         ERR_print_errors(bio_err);
 383                                         goto mac_end;
 384                                         }
 385                                 }
 386                         }
 387                 if (EVP_PKEY_keygen(mac_ctx, &sigkey) <= 0)
 388                         {
 389                         BIO_puts(bio_err, "Error generating key\n");
 390                         ERR_print_errors(bio_err);
 391                         goto mac_end;
 392                         }
 393                 r = 1;
 394                 mac_end:
 395                 if (mac_ctx)
 396                         EVP_PKEY_CTX_free(mac_ctx);
 397                 if (r == 0)
 398                         goto end;
 399                 }
 400
 401         if (hmac_key)
 402                 {
 403                 sigkey = EVP_PKEY_new_mac_key(EVP_PKEY_HMAC, e,
 404                                         (unsigned char *)hmac_key, -1);
 405                 if (!sigkey)
 406                         goto end;
 407                 }
 408
 409         if (sigkey)
 410                 {
 411                 EVP_MD_CTX *mctx = NULL;
 412                 EVP_PKEY_CTX *pctx = NULL;
 413                 int r;
 414                 if (!BIO_get_md_ctx(bmd, &mctx))
 415                         {
 416                         BIO_printf(bio_err, "Error getting context\n");
 417                         ERR_print_errors(bio_err);
 418                         goto end;
 419                         }
 420                 if (do_verify)
 421                         r = EVP_DigestVerifyInit(mctx, &pctx, md, e, sigkey);
 422                 else
 423                         r = EVP_DigestSignInit(mctx, &pctx, md, e, sigkey);
 424                 if (!r)
 425                         {
 426                         BIO_printf(bio_err, "Error setting context\n");
 427                         ERR_print_errors(bio_err);
 428                         goto end;
 429                         }
 430                 if (sigopts)
 431                         {
 432                         char *sigopt;
 433                         for (i = 0; i < sk_num(sigopts); i++)
 434                                 {
 435                                 sigopt = sk_value(sigopts, i);
 436                                 if (pkey_ctrl_string(pctx, sigopt) <= 0)
 437                                         {
 438                                         BIO_printf(bio_err,
 439                                                 "parameter error \"%s\"\n",
 440                                                 sigopt);
 441                                         ERR_print_errors(bio_err);
 442                                         goto end;
 443                                         }
 444                                 }
 445                         }
 446                 }
 447         /* we use md as a filter, reading from 'in' */
 448         else
 449                 {
 450                 if (md == NULL)
 451                         md = EVP_md5();
 452                 if (!BIO_set_md(bmd,md))
 453                         {
 454                         BIO_printf(bio_err, "Error setting digest %s\n", pname);
 455                         ERR_print_errors(bio_err);
 456                         goto end;
 457                         }
 458                 }
 459
 460         if(sigfile && sigkey) {
 461                 BIO *sigbio;
 462                 sigbio = BIO_new_file(sigfile, "rb");
 463                 siglen = EVP_PKEY_size(sigkey);
 464                 sigbuf = OPENSSL_malloc(siglen);
 465                 if(!sigbio) {
 466                         BIO_printf(bio_err, "Error opening signature file %s\n",
 467                                                                 sigfile);
 468                         ERR_print_errors(bio_err);
 469                         goto end;
 470                 }
 471                 siglen = BIO_read(sigbio, sigbuf, siglen);
 472                 BIO_free(sigbio);
 473                 if(siglen <= 0) {
 474                         BIO_printf(bio_err, "Error reading signature file %s\n",
 475                                                                 sigfile);
 476                         ERR_print_errors(bio_err);
 477                         goto end;
 478                 }
 479         }
 480         inp=BIO_push(bmd,in);
 481
 482         if (md == NULL)
 483                 {
 484                 EVP_MD_CTX *tctx;
 485                 BIO_get_md_ctx(bmd, &tctx);
 486                 md = EVP_MD_CTX_md(tctx);
 487                 }
 488
 489         if (argc == 0)
 490                 {
 491                 BIO_set_fp(in,stdin,BIO_NOCLOSE);
 492                 err=do_fp(out, buf,inp,separator, out_bin, sigkey, sigbuf,
 493                           siglen,NULL,NULL,"stdin",bmd);
 494                 }
 495         else
 496                 {
 497                 const char *md_name = NULL, *sig_name = NULL;
 498                 if(!out_bin)
 499                         {
 500                         if (sigkey)
 501                                 {
 502                                 const EVP_PKEY_ASN1_METHOD *ameth;
 503                                 ameth = EVP_PKEY_get0_asn1(sigkey);
 504                                 if (ameth)
 505                                         EVP_PKEY_asn1_get0_info(NULL, NULL,
 506                                                 NULL, NULL, &sig_name, ameth);
 507                                 }
 508                         md_name = EVP_MD_name(md);
 509                         }
 510                 err = 0;
 511                 for (i=0; i<argc; i++)
 512                         {
 513                         int r;
 514                         if (BIO_read_filename(in,argv[i]) <= 0)
 515                                 {
 516                                 perror(argv[i]);
 517                                 err++;
 518                                 continue;
 519                                 }
 520                         else
 521                         r=do_fp(out,buf,inp,separator,out_bin,sigkey,sigbuf,
 522                                 siglen,sig_name,md_name, argv[i],bmd);
 523                         if(r)
 524                             err=r;
 525                         (void)BIO_reset(bmd);
 526                         }
 527                 }
 528 end:
 529         if (buf != NULL)
 530                 {
 531                 OPENSSL_cleanse(buf,BUFSIZE);
 532                 OPENSSL_free(buf);
 533                 }
 534         if (in != NULL) BIO_free(in);
 535         if (passin)
 536                 OPENSSL_free(passin);
 537         BIO_free_all(out);
 538         EVP_PKEY_free(sigkey);
 539         if (sigopts)
 540                 sk_free(sigopts);
 541         if (macopts)
 542                 sk_free(macopts);
 543         if(sigbuf) OPENSSL_free(sigbuf);
 544         if (bmd != NULL) BIO_free(bmd);
 545         apps_shutdown();
 546         OPENSSL_EXIT(err);
 547         }
 548
 549 int do_fp(BIO *out, unsigned char *buf, BIO *bp, int sep, int binout,
 550           EVP_PKEY *key, unsigned char *sigin, int siglen,
 551           const char *sig_name, const char *md_name,
 552           const char *file,BIO *bmd)
 553         {
 554         size_t len;
 555         int i;
 556
 557         for (;;)
 558                 {
 559                 i=BIO_read(bp,(char *)buf,BUFSIZE);
 560                 if(i < 0)
 561                         {
 562                         BIO_printf(bio_err, "Read Error in %s\n",file);
 563                         ERR_print_errors(bio_err);
 564                         return 1;
 565                         }
 566                 if (i == 0) break;
 567                 }
 568         if(sigin)
 569                 {
 570                 EVP_MD_CTX *ctx;
 571                 BIO_get_md_ctx(bp, &ctx);
 572                 i = EVP_DigestVerifyFinal(ctx, sigin, (unsigned int)siglen);
 573                 if(i > 0)
 574                         BIO_printf(out, "Verified OK\n");
 575                 else if(i == 0)
 576                         {
 577                         BIO_printf(out, "Verification Failure\n");
 578                         return 1;
 579                         }
 580                 else
 581                         {
 582                         BIO_printf(bio_err, "Error Verifying Data\n");
 583                         ERR_print_errors(bio_err);
 584                         return 1;
 585                         }
 586                 return 0;
 587                 }
 588         if(key)
 589                 {
 590                 EVP_MD_CTX *ctx;
 591                 BIO_get_md_ctx(bp, &ctx);
 592                 len = BUFSIZE;
 593                 if(!EVP_DigestSignFinal(ctx, buf, &len))
 594                         {
 595                         BIO_printf(bio_err, "Error Signing Data\n");
 596                         ERR_print_errors(bio_err);
 597                         return 1;
 598                         }
 599                 }
 600         else
 601                 len=BIO_gets(bp,(char *)buf,BUFSIZE);
 602
 603         if(binout) BIO_write(out, buf, len);
 604         else
 605                 {
 606                 if (sig_name)
 607                         BIO_printf(out, "%s-%s(%s)= ", sig_name, md_name, file);
 608                 else if (md_name)
 609                         BIO_printf(out, "%s(%s)= ", md_name, file);
 610                 else
 611                         BIO_printf(out, "(%s)= ", file);
 612                 for (i=0; i<(int)len; i++)
 613                         {
 614                         if (sep && (i != 0))
 615                                 BIO_printf(out, ":");
 616                         BIO_printf(out, "%02x",buf[i]);
 617                         }
 618                 BIO_printf(out, "\n");
 619                 }
 620         return 0;
 621         }
 622