ragel/main.cpp

   1 /*
   2  *  Copyright 2001-2007 Adrian Thurston <thurston@cs.queensu.ca>
   3  */
   4
   5 /*  This file is part of Ragel.
   6  *
   7  *  Ragel is free software; you can redistribute it and/or modify
   8  *  it under the terms of the GNU General Public License as published by
   9  *  the Free Software Foundation; either version 2 of the License, or
  10  *  (at your option) any later version.
  11  *
  12  *  Ragel is distributed in the hope that it will be useful,
  13  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
  14  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15  *  GNU General Public License for more details.
  16  *
  17  *  You should have received a copy of the GNU General Public License
  18  *  along with Ragel; if not, write to the Free Software
  19  *  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  20  */
  21
  22 #include <stdlib.h>
  23 #include <string.h>
  24 #include <stdio.h>
  25 #include <iostream>
  26 #include <fstream>
  27 #include <unistd.h>
  28 #include <sstream>
  29 #include <unistd.h>
  30 #include <sys/types.h>
  31 #include <sys/stat.h>
  32 #include <fcntl.h>
  33 #include <errno.h>
  34
  35 #ifndef WIN32
  36 #include <sys/wait.h>
  37 #else
  38 #include <windows.h>
  39 #include <psapi.h>
  40 #endif
  41
  42 /* Parsing. */
  43 #include "ragel.h"
  44 #include "rlscan.h"
  45
  46 /* Parameters and output. */
  47 #include "pcheck.h"
  48 #include "vector.h"
  49 #include "version.h"
  50 #include "common.h"
  51
  52 using std::istream;
  53 using std::ostream;
  54 using std::ifstream;
  55 using std::ofstream;
  56 using std::cin;
  57 using std::cout;
  58 using std::cerr;
  59 using std::endl;
  60 using std::ios;
  61 using std::streamsize;
  62
  63 /* Controls minimization. */
  64 MinimizeLevel minimizeLevel = MinimizePartition2;
  65 MinimizeOpt minimizeOpt = MinimizeMostOps;
  66
  67 /* Graphviz dot file generation. */
  68 char *machineSpec = 0, *machineName = 0;
  69 bool machineSpecFound = false;
  70
  71 bool printStatistics = false;
  72 bool frontendOnly = false;
  73 bool generateDot = false;
  74
  75 typedef Vector<char*> ArgsVector;
  76 ArgsVector frontendArgs;
  77 ArgsVector backendArgs;
  78
  79 /* Print a summary of the options. */
  80 void usage()
  81 {
  82         cout <<
  83 "usage: ragel [options] file\n"
  84 "general:\n"
  85 "   -h, -H, -?, --help   Print this usage and exit\n"
  86 "   -v, --version        Print version information and exit\n"
  87 "   -o <file>            Write output to <file>\n"
  88 "   -s                   Print some statistics on stderr\n"
  89 "fsm minimization:\n"
  90 "   -n                   Do not perform minimization\n"
  91 "   -m                   Minimize at the end of the compilation\n"
  92 "   -l                   Minimize after most operations (default)\n"
  93 "   -e                   Minimize after every operation\n"
  94 "visualization:\n"
  95 "   -V                   Generate a dot file for Graphviz\n"
  96 "   -p                   Display printable characters on labels\n"
  97 "   -S <spec>            FSM specification to output (for rlgen-dot)\n"
  98 "   -M <machine>         Machine definition/instantiation to output (for rlgen-dot)\n"
  99 "host language:\n"
 100 "   -C                   The host language is C, C++, Obj-C or Obj-C++ (default)\n"
 101 "   -D                   The host language is D\n"
 102 "   -J                   The host language is Java\n"
 103 "   -R                   The host language is Ruby\n"
 104 "line direcives: (C/D only)\n"
 105 "   -L                   Inhibit writing of #line directives\n"
 106 "code style: (C/Ruby only)\n"
 107 "   -T0                  Table driven FSM (default)\n"
 108 "   -T1                  Faster table driven FSM\n"
 109 "   -F0                  Flat table driven FSM\n"
 110 "   -F1                  Faster flat table-driven FSM\n"
 111 "code style: (C only)\n"
 112 "   -G0                  Goto-driven FSM\n"
 113 "   -G1                  Faster goto-driven FSM\n"
 114 "   -G2                  Really fast goto-driven FSM\n"
 115 "   -P<N>                N-Way Split really fast goto-driven FSM\n"
 116         ;
 117 }
 118
 119 /* Print version information. */
 120 void version()
 121 {
 122         cout << "Ragel State Machine Compiler version " VERSION << " " PUBDATE << endl <<
 123                         "Copyright (c) 2001-2007 by Adrian Thurston" << endl;
 124 }
 125
 126 /* Total error count. */
 127 int gblErrorCount = 0;
 128
 129 /* Print the opening to a warning in the input, then return the error ostream. */
 130 ostream &warning( const InputLoc &loc )
 131 {
 132         assert( loc.fileName != 0 );
 133         cerr << loc.fileName << ":" << loc.line << ":" <<
 134                         loc.col << ": warning: ";
 135         return cerr;
 136 }
 137
 138 /* Print the opening to a program error, then return the error stream. */
 139 ostream &error()
 140 {
 141         gblErrorCount += 1;
 142         cerr << PROGNAME ": ";
 143         return cerr;
 144 }
 145
 146 ostream &error( const InputLoc &loc )
 147 {
 148         gblErrorCount += 1;
 149         assert( loc.fileName != 0 );
 150         cerr << loc.fileName << ":" << loc.line << ": ";
 151         return cerr;
 152 }
 153
 154 void escapeLineDirectivePath( std::ostream &out, char *path )
 155 {
 156         for ( char *pc = path; *pc != 0; pc++ ) {
 157                 if ( *pc == '\\' )
 158                         out << "\\\\";
 159                 else
 160                         out << *pc;
 161         }
 162 }
 163
 164 void processArgs( int argc, char **argv, char *&inputFileName, char *&outputFileName )
 165 {
 166         ParamCheck pc("fo:nmleabjkS:M:CDJRvHh?-:sT:F:G:P:LpV", argc, argv);
 167
 168         while ( pc.check() ) {
 169                 switch ( pc.state ) {
 170                 case ParamCheck::match:
 171                         switch ( pc.parameter ) {
 172                         case 'V':
 173                                 generateDot = true;
 174                                 break;
 175
 176                         case 'f':
 177                                 frontendOnly = true;
 178                                 break;
 179
 180                         /* Output. */
 181                         case 'o':
 182                                 if ( *pc.parameterArg == 0 )
 183                                         error() << "a zero length output file name was given" << endl;
 184                                 else if ( outputFileName != 0 )
 185                                         error() << "more than one output file name was given" << endl;
 186                                 else {
 187                                         /* Ok, remember the output file name. */
 188                                         outputFileName = pc.parameterArg;
 189                                 }
 190                                 break;
 191
 192                         /* Minimization, mostly hidden options. */
 193                         case 'n':
 194                                 minimizeOpt = MinimizeNone;
 195                                 frontendArgs.append( "-n" );
 196                                 break;
 197                         case 'm':
 198                                 minimizeOpt = MinimizeEnd;
 199                                 frontendArgs.append( "-m" );
 200                                 break;
 201                         case 'l':
 202                                 minimizeOpt = MinimizeMostOps;
 203                                 frontendArgs.append( "-l" );
 204                                 break;
 205                         case 'e':
 206                                 minimizeOpt = MinimizeEveryOp;
 207                                 frontendArgs.append( "-e" );
 208                                 break;
 209                         case 'a':
 210                                 minimizeLevel = MinimizeApprox;
 211                                 frontendArgs.append( "-a" );
 212                                 break;
 213                         case 'b':
 214                                 minimizeLevel = MinimizeStable;
 215                                 frontendArgs.append( "-b" );
 216                                 break;
 217                         case 'j':
 218                                 minimizeLevel = MinimizePartition1;
 219                                 frontendArgs.append( "-j" );
 220                                 break;
 221                         case 'k':
 222                                 minimizeLevel = MinimizePartition2;
 223                                 frontendArgs.append( "-k" );
 224                                 break;
 225
 226                         /* Machine spec. */
 227                         case 'S':
 228                                 if ( *pc.parameterArg == 0 )
 229                                         error() << "please specify an argument to -S" << endl;
 230                                 else if ( machineSpec != 0 )
 231                                         error() << "more than one -S argument was given" << endl;
 232                                 else {
 233                                         /* Ok, remember the path to the machine to generate. */
 234                                         machineSpec = pc.parameterArg;
 235                                         frontendArgs.append( "-S" );
 236                                         frontendArgs.append( pc.parameterArg );
 237                                 }
 238                                 break;
 239
 240                         /* Machine path. */
 241                         case 'M':
 242                                 if ( *pc.parameterArg == 0 )
 243                                         error() << "please specify an argument to -M" << endl;
 244                                 else if ( machineName != 0 )
 245                                         error() << "more than one -M argument was given" << endl;
 246                                 else {
 247                                         /* Ok, remember the machine name to generate. */
 248                                         machineName = pc.parameterArg;
 249                                         frontendArgs.append( "-M" );
 250                                         frontendArgs.append( pc.parameterArg );
 251                                 }
 252                                 break;
 253
 254                         /* Host language types. */
 255                         case 'C':
 256                                 hostLang = &hostLangC;
 257                                 frontendArgs.append( "-C" );
 258                                 break;
 259                         case 'D':
 260                                 hostLang = &hostLangD;
 261                                 frontendArgs.append( "-D" );
 262                                 break;
 263                         case 'J':
 264                                 hostLang = &hostLangJava;
 265                                 frontendArgs.append( "-J" );
 266                                 break;
 267                         case 'R':
 268                                 hostLang = &hostLangRuby;
 269                                 frontendArgs.append( "-R" );
 270                                 break;
 271
 272                         /* Version and help. */
 273                         case 'v':
 274                                 version();
 275                                 exit(0);
 276                         case 'H': case 'h': case '?':
 277                                 usage();
 278                                 exit(0);
 279                         case 's':
 280                                 printStatistics = true;
 281                                 frontendArgs.append( "-s" );
 282                                 break;
 283                         case '-':
 284                                 if ( strcasecmp(pc.parameterArg, "help") == 0 ) {
 285                                         usage();
 286                                         exit(0);
 287                                 }
 288                                 else if ( strcasecmp(pc.parameterArg, "version") == 0 ) {
 289                                         version();
 290                                         exit(0);
 291                                 }
 292                                 else {
 293                                         error() << "--" << pc.parameterArg <<
 294                                                         " is an invalid argument" << endl;
 295                                 }
 296
 297                         /* Passthrough args. */
 298                         case 'T':
 299                                 backendArgs.append( "-T" );
 300                                 backendArgs.append( pc.parameterArg );
 301                                 break;
 302                         case 'F':
 303                                 backendArgs.append( "-F" );
 304                                 backendArgs.append( pc.parameterArg );
 305                                 break;
 306                         case 'G':
 307                                 backendArgs.append( "-G" );
 308                                 backendArgs.append( pc.parameterArg );
 309                                 break;
 310                         case 'P':
 311                                 backendArgs.append( "-P" );
 312                                 backendArgs.append( pc.parameterArg );
 313                                 break;
 314                         case 'p':
 315                                 backendArgs.append( "-p" );
 316                                 break;
 317                         case 'L':
 318                                 backendArgs.append( "-L" );
 319                                 break;
 320                         }
 321                         break;
 322
 323                 case ParamCheck::invalid:
 324                         error() << "-" << pc.parameter << " is an invalid argument" << endl;
 325                         break;
 326
 327                 case ParamCheck::noparam:
 328                         /* It is interpreted as an input file. */
 329                         if ( *pc.curArg == 0 )
 330                                 error() << "a zero length input file name was given" << endl;
 331                         else if ( inputFileName != 0 )
 332                                 error() << "more than one input file name was given" << endl;
 333                         else {
 334                                 /* OK, Remember the filename. */
 335                                 inputFileName = pc.curArg;
 336                         }
 337                         break;
 338                 }
 339         }
 340 }
 341
 342 int frontend( char *inputFileName, char *outputFileName )
 343 {
 344         /* Open the input file for reading. */
 345         assert( inputFileName != 0 );
 346         ifstream *inFile = new ifstream( inputFileName );
 347         istream *inStream = inFile;
 348         if ( ! inFile->is_open() )
 349                 error() << "could not open " << inputFileName << " for reading" << endp;
 350
 351         /* Used for just a few things. */
 352         std::ostringstream hostData;
 353
 354         if ( machineSpec == 0 && machineName == 0 )
 355                 hostData << "<host line=\"1\" col=\"1\">";
 356
 357         Scanner scanner( inputFileName, *inStream, hostData, 0, 0, 0, false );
 358         scanner.do_scan();
 359
 360         /* Finished, final check for errors.. */
 361         if ( gblErrorCount > 0 )
 362                 return 1;
 363
 364         /* Now send EOF to all parsers. */
 365         terminateAllParsers();
 366
 367         /* Finished, final check for errors.. */
 368         if ( gblErrorCount > 0 )
 369                 return 1;
 370
 371         if ( machineSpec == 0 && machineName == 0 )
 372                 hostData << "</host>\n";
 373
 374         if ( gblErrorCount > 0 )
 375                 return 1;
 376
 377         ostream *outputFile = 0;
 378         if ( outputFileName != 0 )
 379                 outputFile = new ofstream( outputFileName );
 380         else
 381                 outputFile = &cout;
 382
 383         /* Write the machines, then the surrounding code. */
 384         writeMachines( *outputFile, hostData.str(), inputFileName );
 385
 386         /* Close the intermediate file. */
 387         if ( outputFileName != 0 )
 388                 delete outputFile;
 389
 390         return gblErrorCount > 0;
 391 }
 392
 393 char *makeIntermedTemplate( char *baseFileName )
 394 {
 395         char *result = 0, *templ = "ragel-XXXXXX.xml";
 396         char *lastSlash = strrchr( baseFileName, '/' );
 397         if ( lastSlash == 0 ) {
 398                 result = new char[strlen(templ)+1];
 399                 strcpy( result, templ );
 400         }
 401         else {
 402                 int baseLen = lastSlash - baseFileName + 1;
 403                 result = new char[baseLen + strlen(templ) + 1];
 404                 memcpy( result, baseFileName, baseLen );
 405                 strcpy( result+baseLen, templ );
 406         }
 407         return result;
 408 };
 409
 410 char *openIntermed( char *inputFileName, char *outputFileName )
 411 {
 412         srand(time(0));
 413         char *result = 0;
 414
 415         /* Which filename do we use as the base? */
 416         char *baseFileName = outputFileName != 0 ? outputFileName : inputFileName;
 417
 418         /* The template for the intermediate file name. */
 419         char *intermedFileName = makeIntermedTemplate( baseFileName );
 420
 421         /* Randomize the name and try to open. */
 422         char fnChars[] = "abcdefghijklmnopqrstuvwxyz0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ";
 423         char *firstX = strrchr( intermedFileName, 'X' ) - 5;
 424         for ( int tries = 0; tries < 20; tries++ ) {
 425                 /* Choose a random name. */
 426                 for ( int x = 0; x < 6; x++ )
 427                         firstX[x] = fnChars[rand() % 52];
 428
 429                 /* Try to open the file. */
 430                 int fd = ::open( intermedFileName, O_WRONLY|O_EXCL|O_CREAT, S_IRUSR|S_IWUSR );
 431
 432                 if ( fd > 0 ) {
 433                         /* Success. Close the file immediately and return the name for use
 434                          * by the child processes. */
 435                         ::close( fd );
 436                         result = intermedFileName;
 437                         break;
 438                 }
 439
 440                 if ( errno == EACCES ) {
 441                         error() << "failed to open temp file " << intermedFileName <<
 442                                         ", access denied" << endp;
 443                 }
 444         }
 445
 446         if ( result == 0 )
 447                 error() << "abnormal error: cannot find unique name for temp file" << endp;
 448
 449         return result;
 450 }
 451
 452
 453 void cleanExit( char *intermed, int status )
 454 {
 455         unlink( intermed );
 456         exit( status );
 457 }
 458
 459 #ifndef WIN32
 460
 461 /* If any forward slash is found in argv0 then it is assumed that the path is
 462  * explicit and the path to the backend executable should be derived from
 463  * that. Whe check that location and also go up one then inside a directory of
 464  * the same name in case we are executing from the source tree. If no forward
 465  * slash is found it is assumed the file is being run from the installed
 466  * location. The PREFIX supplied during configuration is used. */
 467 char **makePathChecksUnix( const char *argv0, const char *progName )
 468 {
 469         char **result = new char*[3];
 470         const char *lastSlash = strrchr( argv0, '/' );
 471         int numChecks = 0;
 472
 473         if ( lastSlash != 0 ) {
 474                 char *path = strdup( argv0 );
 475                 int givenPathLen = (lastSlash - argv0) + 1;
 476                 path[givenPathLen] = 0;
 477
 478                 int progNameLen = strlen(progName);
 479                 int length = givenPathLen + progNameLen + 1;
 480                 char *check = new char[length];
 481                 sprintf( check, "%s%s", path, progName );
 482                 result[numChecks++] = check;
 483
 484                 length = givenPathLen + 3 + progNameLen + 1 + progNameLen + 1;
 485                 check = new char[length];
 486                 sprintf( check, "%s../%s/%s", path, progName, progName );
 487                 result[numChecks++] = check;
 488         }
 489         else {
 490                 int prefixLen = strlen(PREFIX);
 491                 int progNameLen = strlen(progName);
 492                 int length = prefixLen + 5 + progNameLen + 1;
 493                 char *check = new char[length];
 494
 495                 sprintf( check, PREFIX "/bin/%s", progName );
 496                 result[numChecks++] = check;
 497         }
 498
 499         result[numChecks] = 0;
 500         return result;
 501 }
 502
 503
 504 void forkAndExec( char *progName, char **pathChecks,
 505                 ArgsVector &args, char *intermed )
 506 {
 507         pid_t pid = fork();
 508         if ( pid < 0 ) {
 509                 /* Error, no child created. */
 510                 error() << "failed to fork for " << progName << endl;
 511                 cleanExit( intermed, 1 );
 512         }
 513         else if ( pid == 0 ) {
 514                 /* child */
 515                 while ( *pathChecks != 0 ) {
 516                         execv( *pathChecks, args.data );
 517                         pathChecks += 1;
 518                 }
 519                 error() << "failed to exec " << progName << endl;
 520                 cleanExit( intermed, 1 );
 521         }
 522
 523         /* Parent process, wait for the child. */
 524         int status;
 525         wait( &status );
 526
 527         /* What happened with the child. */
 528         if ( ! WIFEXITED( status ) ) {
 529                 error() << progName << " did not exit normally" << endl;
 530                 cleanExit( intermed, 1 );
 531         }
 532
 533         if ( WEXITSTATUS(status) != 0 )
 534                 cleanExit( intermed, WEXITSTATUS(status) );
 535 }
 536
 537 #else
 538
 539 /* GetModuleFileNameEx is used to find out where the the current process's
 540  * binary is. That location is searched first. If that fails then we go up one
 541  * directory and look for the executable inside a directory of the same name
 542  * in case we are executing from the source tree.
 543  * */
 544 char **makePathChecksWin( const char *progName )
 545 {
 546         int len = 1024;
 547         char *imageFileName = new char[len];
 548         HANDLE h = GetCurrentProcess();
 549         len = GetModuleFileNameEx( h, NULL, imageFileName, len );
 550         imageFileName[len] = 0;
 551
 552         char **result = new char*[3];
 553         const char *lastSlash = strrchr( imageFileName, '\\' );
 554         int numChecks = 0;
 555
 556         assert( lastSlash != 0 );
 557         char *path = strdup( imageFileName );
 558         int givenPathLen = (lastSlash - imageFileName) + 1;
 559         path[givenPathLen] = 0;
 560
 561         int progNameLen = strlen(progName);
 562         int length = givenPathLen + progNameLen + 1;
 563         char *check = new char[length];
 564         sprintf( check, "%s%s", path, progName );
 565         result[numChecks++] = check;
 566
 567         length = givenPathLen + 3 + progNameLen + 1 + progNameLen + 1;
 568         check = new char[length];
 569         sprintf( check, "%s..\\%s\\%s", path, progName, progName );
 570         result[numChecks++] = check;
 571
 572         result[numChecks] = 0;
 573         return result;
 574 }
 575
 576 void spawn( char *progName, char **pathChecks,
 577                 ArgsVector &args, char *intermed )
 578 {
 579         int result = 0;
 580         while ( *pathChecks != 0 ) {
 581                 cerr << "trying to execute " << *pathChecks << endl;
 582                 result = _spawnv( _P_WAIT, *pathChecks, args.data );
 583                 if ( result >= 0 || errno != ENOENT )
 584                         break;
 585                 pathChecks += 1;
 586         }
 587
 588         if ( result < 0 ) {
 589                 error() << "failed to spawn " << progName << endl;
 590                 cleanExit( intermed, 1 );
 591         }
 592
 593         if ( result > 0 )
 594                 cleanExit( intermed, 1 );
 595 }
 596
 597 #endif
 598
 599 void execFrontend( const char *argv0, char *inputFileName, char *intermed )
 600 {
 601         /* The frontend program name. */
 602         char *progName = "ragel";
 603
 604         frontendArgs.insert( 0, progName );
 605         frontendArgs.insert( 1, "-f" );
 606         frontendArgs.append( "-o" );
 607         frontendArgs.append( intermed );
 608         frontendArgs.append( inputFileName );
 609         frontendArgs.append( 0 );
 610
 611 #ifndef WIN32
 612         char **pathChecks = makePathChecksUnix( argv0, progName );
 613         forkAndExec( progName, pathChecks, frontendArgs, intermed );
 614 #else
 615         char **pathChecks = makePathChecksWin( progName );
 616         spawn( progName, pathChecks, frontendArgs, intermed );
 617 #endif
 618 }
 619
 620 void execBackend( const char *argv0, char *intermed, char *outputFileName )
 621 {
 622         /* Locate the backend program */
 623         char *progName = 0;
 624         if ( generateDot )
 625                 progName = "rlgen-dot";
 626         else {
 627                 switch ( hostLang->lang ) {
 628                         case HostLang::C:
 629                         case HostLang::D:
 630                                 progName = "rlgen-cd";
 631                                 break;
 632                         case HostLang::Java:
 633                                 progName = "rlgen-java";
 634                                 break;
 635                         case HostLang::Ruby:
 636                                 progName = "rlgen-ruby";
 637                                 break;
 638                 }
 639         }
 640
 641         backendArgs.insert( 0, progName );
 642         if ( outputFileName != 0 ) {
 643                 backendArgs.append( "-o" );
 644                 backendArgs.append( outputFileName );
 645         }
 646         backendArgs.append( intermed );
 647         backendArgs.append( 0 );
 648
 649 #ifndef WIN32
 650         char **pathChecks = makePathChecksUnix( argv0, progName );
 651         forkAndExec( progName, pathChecks, backendArgs, intermed );
 652 #else
 653         char **pathChecks = makePathChecksWin( progName );
 654         spawn( progName, pathChecks, backendArgs, intermed );
 655 #endif
 656 }
 657
 658 /* Main, process args and call yyparse to start scanning input. */
 659 int main(int argc, char **argv)
 660 {
 661         char *inputFileName = 0;
 662         char *outputFileName = 0;
 663
 664         processArgs( argc, argv, inputFileName, outputFileName );
 665
 666         /* Require an input file. If we use standard in then we won't have a file
 667          * name on which to base the output. */
 668         if ( inputFileName == 0 )
 669                 error() << "no input file given" << endl;
 670
 671         /* Bail on argument processing errors. */
 672         if ( gblErrorCount > 0 )
 673                 exit(1);
 674
 675         /* Make sure we are not writing to the same file as the input file. */
 676         if ( inputFileName != 0 && outputFileName != 0 &&
 677                         strcmp( inputFileName, outputFileName  ) == 0 )
 678         {
 679                 error() << "output file \"" << outputFileName  <<
 680                                 "\" is the same as the input file" << endp;
 681         }
 682
 683         if ( frontendOnly )
 684                 return frontend( inputFileName, outputFileName );
 685
 686         char *intermed = openIntermed( inputFileName, outputFileName );
 687
 688         /* From here on in the cleanExit function should be used to exit. */
 689
 690         /* Run the frontend, then the backend processes. */
 691         execFrontend( argv[0], inputFileName, intermed );
 692         execBackend( argv[0], intermed, outputFileName );
 693
 694         /* Clean up the intermediate. */
 695         cleanExit( intermed, 0 );
 696
 697         return 0;
 698 }