src/srfsh/srfsh.c

   1 #include <opensrf/transport_client.h>
   2 #include <opensrf/osrf_message.h>
   3 #include <opensrf/osrf_app_session.h>
   4 #include <time.h>
   5 #include <ctype.h>
   6 #include <sys/timeb.h>
   7 #include <sys/types.h>
   8 #include <sys/wait.h>
   9
  10 #include <opensrf/utils.h>
  11 #include <opensrf/log.h>
  12
  13 #include <signal.h>
  14
  15 #include <stdio.h>
  16 #include <readline/readline.h>
  17 #include <readline/history.h>
  18
  19 #define SRFSH_PORT 5222
  20 #define COMMAND_BUFSIZE 4096
  21
  22
  23 /* shell prompt */
  24 static const char* prompt = "srfsh# ";
  25
  26 static char* history_file = NULL;
  27
  28 //static int child_dead = 0;
  29
  30 static char* login_session = NULL;
  31
  32 /* true if we're pretty printing json results */
  33 static int pretty_print = 1;
  34 /* true if we're bypassing 'less' */
  35 static int raw_print = 0;
  36
  37 /* our jabber connection */
  38 static transport_client* client = NULL;
  39
  40 /* the last result we received */
  41 static osrf_message* last_result = NULL;
  42
  43 /* functions */
  44 static int parse_request( char* request );
  45
  46 /* handles router requests */
  47 static int handle_router( char* words[] );
  48
  49 /* utility method for print time data */
  50 static int handle_time( char* words[] );
  51
  52 /* handles app level requests */
  53 static int handle_request( char* words[], int relay );
  54 static int handle_set( char* words[]);
  55 static int handle_print( char* words[]);
  56 static int send_request( char* server,
  57                                   char* method, growing_buffer* buffer, int relay );
  58 static int parse_error( char* words[] );
  59 static int router_query_servers( const char* server );
  60 static int print_help( void );
  61
  62 //static int srfsh_client_connect();
  63 //static char* tabs(int count);
  64 //static void sig_child_handler( int s );
  65 //static void sig_int_handler( int s );
  66
  67 static int load_history( void );
  68 static int handle_math( char* words[] );
  69 static int do_math( int count, int style );
  70 static int handle_introspect(char* words[]);
  71 static int handle_login( char* words[]);
  72
  73 static int recv_timeout = 120;
  74 static int is_from_script = 0;
  75
  76 int main( int argc, char* argv[] ) {
  77
  78         /* --------------------------------------------- */
  79         /* see if they have a .srfsh.xml in their home directory */
  80         char* home = getenv("HOME");
  81         int l = strlen(home) + 36;
  82         char fbuf[l];
  83         snprintf(fbuf, sizeof(fbuf), "%s/.srfsh.xml", home);
  84
  85         if(!access(fbuf, R_OK)) {
  86                 if( ! osrf_system_bootstrap_client(fbuf, "srfsh") ) {
  87                         fprintf(stderr,"Unable to bootstrap client for requests\n");
  88                         osrfLogError( OSRF_LOG_MARK,  "Unable to bootstrap client for requests");
  89                         return -1;
  90                 }
  91
  92         } else {
  93                 fprintf(stderr,"No Config file found at %s\n", fbuf );
  94                 return -1;
  95         }
  96
  97         if(argc > 1) {
  98                 /* for now.. the first arg is used as a script file for processing */
  99                 int f;
 100                 if( (f = open(argv[1], O_RDONLY)) == -1 ) {
 101                         osrfLogError( OSRF_LOG_MARK, "Unable to open file %s for reading, exiting...", argv[1]);
 102                         return -1;
 103                 }
 104
 105                 if(dup2(f, STDIN_FILENO) == -1) {
 106                         osrfLogError( OSRF_LOG_MARK, "Unable to duplicate STDIN, exiting...");
 107                         return -1;
 108                 }
 109
 110                 close(f);
 111                 is_from_script = 1;
 112         }
 113
 114         /* --------------------------------------------- */
 115         load_history();
 116
 117
 118         client = osrfSystemGetTransportClient();
 119
 120         /* main process loop */
 121         int newline_needed = 1;  /* used as boolean */
 122         char* request;
 123         while((request=readline(prompt))) {
 124
 125                 // Find first non-whitespace character
 126
 127                 char * cmd = request;
 128                 while( isspace( (unsigned char) *cmd ) )
 129                         ++cmd;
 130
 131                 // ignore comments and empty lines
 132
 133                 if( '\0' == *cmd || '#' == *cmd )
 134                         continue;
 135
 136                 // Remove trailing whitespace.  We know at this point that
 137                 // there is at least one non-whitespace character somewhere,
 138                 // or we would have already skipped this line.  Hence we
 139                 // needn't check to make sure that we don't back up past
 140                 // the beginning.
 141
 142                 {
 143                         // The curly braces limit the scope of the end variable
 144
 145                         char * end = cmd + strlen(cmd) - 1;
 146                         while( isspace( (unsigned char) *end ) )
 147                                 --end;
 148                         end[1] = '\0';
 149                 }
 150
 151                 if( !strcasecmp(cmd, "exit") || !strcasecmp(cmd, "quit"))
 152                 {
 153                         newline_needed = 0;
 154                         break;
 155                 }
 156
 157                 char* req_copy = strdup(cmd);
 158
 159                 parse_request( req_copy );
 160                 if( request && *cmd ) {
 161                         add_history(request);
 162                 }
 163
 164                 free(request);
 165                 free(req_copy);
 166
 167                 fflush(stderr);
 168                 fflush(stdout);
 169         }
 170
 171         if( newline_needed ) {
 172
 173                 // We left the readline loop after seeing an EOF, not after
 174                 // seeing "quit" or "exit".  So we issue a newline in order
 175                 // to avoid leaving a dangling prompt.
 176
 177                 putchar( '\n' );
 178         }
 179
 180         if(history_file != NULL )
 181                 write_history(history_file);
 182
 183         free(request);
 184         free(login_session);
 185
 186         osrf_system_shutdown();
 187         return 0;
 188 }
 189
 190 static int load_history( void ) {
 191
 192         char* home = getenv("HOME");
 193         int l = strlen(home) + 24;
 194         char fbuf[l];
 195         snprintf(fbuf, sizeof(fbuf), "%s/.srfsh_history", home);
 196         history_file = strdup(fbuf);
 197
 198         if(!access(history_file, W_OK | R_OK )) {
 199                 history_length = 5000;
 200                 read_history(history_file);
 201         }
 202         return 1;
 203 }
 204
 205
 206 static int parse_error( char* words[] ) {
 207
 208         if( ! words )
 209                 return 0;
 210
 211         growing_buffer * gbuf = buffer_init( 64 );
 212         buffer_add( gbuf, *words );
 213         while( *++words ) {
 214                 buffer_add( gbuf, " " );
 215                 buffer_add( gbuf, *words );
 216         }
 217         fprintf( stderr, "???: %s\n", gbuf->buf );
 218         buffer_free( gbuf );
 219
 220         return 0;
 221
 222 }
 223
 224
 225 static int parse_request( char* request ) {
 226
 227         if( request == NULL )
 228                 return 0;
 229
 230         char* original_request = strdup( request );
 231         char* words[COMMAND_BUFSIZE];
 232
 233         int ret_val = 0;
 234         int i = 0;
 235
 236
 237         char* req = request;
 238         char* cur_tok = strtok( req, " " );
 239
 240         if( cur_tok == NULL )
 241         {
 242                 free( original_request );
 243                 return 0;
 244         }
 245
 246         /* Load an array with pointers to    */
 247         /* the tokens as defined by strtok() */
 248
 249         while(cur_tok != NULL) {
 250                 if( i < COMMAND_BUFSIZE - 1 ) {
 251                         words[i++] = cur_tok;
 252                         cur_tok = strtok( NULL, " " );
 253                 } else {
 254                         fprintf( stderr, "Too many tokens in command\n" );
 255                         free( original_request );
 256                         return 1;
 257                 }
 258         }
 259
 260         words[i] = NULL;
 261
 262         /* pass off to the top level command */
 263         if( !strcmp(words[0],"router") )
 264                 ret_val = handle_router( words );
 265
 266         else if( !strcmp(words[0],"time") )
 267                 ret_val = handle_time( words );
 268
 269         else if (!strcmp(words[0],"request"))
 270                 ret_val = handle_request( words, 0 );
 271
 272         else if (!strcmp(words[0],"relay"))
 273                 ret_val = handle_request( words, 1 );
 274
 275         else if (!strcmp(words[0],"help"))
 276                 ret_val = print_help();
 277
 278         else if (!strcmp(words[0],"set"))
 279                 ret_val = handle_set(words);
 280
 281         else if (!strcmp(words[0],"print"))
 282                 ret_val = handle_print(words);
 283
 284         else if (!strcmp(words[0],"math_bench"))
 285                 ret_val = handle_math(words);
 286
 287         else if (!strcmp(words[0],"introspect"))
 288                 ret_val = handle_introspect(words);
 289
 290         else if (!strcmp(words[0],"login"))
 291                 ret_val = handle_login(words);
 292
 293         else if (words[0][0] == '!') {
 294                 system( original_request + 1 );
 295                 ret_val = 1;
 296         }
 297
 298         free( original_request );
 299
 300         if(!ret_val)
 301                 return parse_error( words );
 302         else
 303                 return 1;
 304 }
 305
 306
 307 static int handle_introspect(char* words[]) {
 308
 309         if( ! words[1] )
 310                 return 0;
 311
 312         fprintf(stderr, "--> %s\n", words[1]);
 313
 314         // Build a command in a suitably-sized
 315         // buffer and then parse it
 316
 317         size_t len;
 318         if( words[2] ) {
 319                 static const char text[] = "request %s opensrf.system.method %s";
 320                 len = sizeof( text ) + strlen( words[1] ) + strlen( words[2] );
 321                 char buf[len];
 322                 snprintf( buf, sizeof(buf), text, words[1], words[2] );
 323                 return parse_request( buf );
 324
 325         } else {
 326                 static const char text[] = "request %s opensrf.system.method.all";
 327                 len = sizeof( text ) + strlen( words[1] );
 328                 char buf[len];
 329                 snprintf( buf, sizeof(buf), text, words[1] );
 330                 return parse_request( buf );
 331
 332         }
 333 }
 334
 335
 336 static int handle_login( char* words[]) {
 337
 338         if( words[1] && words[2]) {
 339
 340                 char* username          = words[1];
 341                 char* password          = words[2];
 342                 char* type                      = words[3];
 343                 char* orgloc            = words[4];
 344                 char* workstation       = words[5];
 345                 int orgloci = (orgloc) ? atoi(orgloc) : 0;
 346                 if(!type) type = "opac";
 347
 348                 char login_text[] = "request open-ils.auth open-ils.auth.authenticate.init \"%s\"";
 349                 size_t len = sizeof( login_text ) + strlen(username) + 1;
 350
 351                 char buf[len];
 352                 snprintf( buf, sizeof(buf), login_text, username );
 353                 parse_request(buf);
 354
 355                 const char* hash;
 356                 if(last_result && last_result->_result_content) {
 357                         jsonObject* r = last_result->_result_content;
 358                         hash = jsonObjectGetString(r);
 359                 } else return 0;
 360
 361
 362                 char* pass_buf = md5sum(password);
 363
 364                 size_t both_len = strlen( hash ) + strlen( pass_buf ) + 1;
 365                 char both_buf[both_len];
 366                 snprintf(both_buf, sizeof(both_buf), "%s%s", hash, pass_buf);
 367
 368                 char* mess_buf = md5sum(both_buf);
 369
 370                 growing_buffer* argbuf = buffer_init(64);
 371                 buffer_fadd(argbuf,
 372                                 "request open-ils.auth open-ils.auth.authenticate.complete "
 373                                 "{ \"username\" : \"%s\", \"password\" : \"%s\"", username, mess_buf );
 374
 375                 if(type) buffer_fadd( argbuf, ", \"type\" : \"%s\"", type );
 376                 if(orgloci) buffer_fadd( argbuf, ", \"org\" : %d", orgloci );
 377                 if(workstation) buffer_fadd( argbuf, ", \"workstation\" : \"%s\"", workstation);
 378                 buffer_add(argbuf, "}");
 379
 380                 free(pass_buf);
 381                 free(mess_buf);
 382
 383                 parse_request( argbuf->buf );
 384                 buffer_free(argbuf);
 385
 386                 if( login_session != NULL )
 387                         free( login_session );
 388
 389                 const jsonObject* x = last_result->_result_content;
 390                 double authtime = 0;
 391                 if(x) {
 392                         const char* authtoken = jsonObjectGetString(
 393                                         jsonObjectGetKeyConst(jsonObjectGetKeyConst(x,"payload"), "authtoken"));
 394                         authtime  = jsonObjectGetNumber(
 395                                         jsonObjectGetKeyConst(jsonObjectGetKeyConst(x,"payload"), "authtime"));
 396
 397                         if(authtoken)
 398                                 login_session = strdup(authtoken);
 399                         else
 400                                 login_session = NULL;
 401                 }
 402                 else login_session = NULL;
 403
 404                 printf("Login Session: %s.  Session timeout: %f\n",
 405                            (login_session ? login_session : "(none)"), authtime );
 406
 407                 return 1;
 408
 409         }
 410
 411         return 0;
 412 }
 413
 414 static int handle_set( char* words[]) {
 415
 416         char* variable;
 417         if( (variable=words[1]) ) {
 418
 419                 char* val;
 420                 if( (val=words[2]) ) {
 421
 422                         if(!strcmp(variable,"pretty_print")) {
 423                                 if(!strcmp(val,"true")) {
 424                                         pretty_print = 1;
 425                                         printf("pretty_print = true\n");
 426                                         return 1;
 427                                 }
 428                                 if(!strcmp(val,"false")) {
 429                                         pretty_print = 0;
 430                                         printf("pretty_print = false\n");
 431                                         return 1;
 432                                 }
 433                         }
 434
 435                         if(!strcmp(variable,"raw_print")) {
 436                                 if(!strcmp(val,"true")) {
 437                                         raw_print = 1;
 438                                         printf("raw_print = true\n");
 439                                         return 1;
 440                                 }
 441                                 if(!strcmp(val,"false")) {
 442                                         raw_print = 0;
 443                                         printf("raw_print = false\n");
 444                                         return 1;
 445                                 }
 446                         }
 447
 448                 }
 449         }
 450
 451         return 0;
 452 }
 453
 454
 455 static int handle_print( char* words[]) {
 456
 457         char* variable;
 458         if( (variable=words[1]) ) {
 459                 if(!strcmp(variable,"pretty_print")) {
 460                         if(pretty_print) {
 461                                 printf("pretty_print = true\n");
 462                                 return 1;
 463                         } else {
 464                                 printf("pretty_print = false\n");
 465                                 return 1;
 466                         }
 467                 }
 468
 469                 if(!strcmp(variable,"raw_print")) {
 470                         if(raw_print) {
 471                                 printf("raw_print = true\n");
 472                                 return 1;
 473                         } else {
 474                                 printf("raw_print = false\n");
 475                                 return 1;
 476                         }
 477                 }
 478
 479                 if(!strcmp(variable,"login")) {
 480                         printf("login session = %s\n",
 481                                    login_session ? login_session : "(none)" );
 482                         return 1;
 483                 }
 484
 485         }
 486         return 0;
 487 }
 488
 489 static int handle_router( char* words[] ) {
 490
 491         if(!client)
 492                 return 1;
 493
 494         int i;
 495
 496         if( words[1] ) {
 497                 if( !strcmp(words[1],"query") ) {
 498
 499                         if( words[2] && !strcmp(words[2],"servers") ) {
 500                                 for(i=3; i < COMMAND_BUFSIZE - 3 && words[i]; i++ ) {
 501                                         router_query_servers( words[i] );
 502                                 }
 503                                 return 1;
 504                         }
 505                         return 0;
 506                 }
 507                 return 0;
 508         }
 509         return 0;
 510 }
 511
 512
 513
 514 static int handle_request( char* words[], int relay ) {
 515
 516         if(!client)
 517                 return 1;
 518
 519         if(words[1]) {
 520                 char* server = words[1];
 521                 char* method = words[2];
 522                 int i;
 523                 growing_buffer* buffer = NULL;
 524                 if(!relay) {
 525                         buffer = buffer_init(128);
 526                         buffer_add(buffer, "[");
 527                         for(i = 3; words[i] != NULL; i++ ) {
 528                                 /* removes trailing semicolon if user accidentally enters it */
 529                                 if( words[i][strlen(words[i])-1] == ';' )
 530                                         words[i][strlen(words[i])-1] = '\0';
 531                                 buffer_add( buffer, words[i] );
 532                                 buffer_add(buffer, " ");
 533                         }
 534                         buffer_add(buffer, "]");
 535                 }
 536
 537                 int rc = send_request( server, method, buffer, relay );
 538                 buffer_free( buffer );
 539                 return rc;
 540         }
 541
 542         return 0;
 543 }
 544
 545 int send_request( char* server,
 546                 char* method, growing_buffer* buffer, int relay ) {
 547         if( server == NULL || method == NULL )
 548                 return 0;
 549
 550         jsonObject* params = NULL;
 551         if( !relay ) {
 552                 if( buffer != NULL && buffer->n_used > 0 )
 553                         params = jsonParseString(buffer->buf);
 554         } else {
 555                 if(!last_result || ! last_result->_result_content) {
 556                         printf("We're not going to call 'relay' with no result params\n");
 557                         return 1;
 558                 }
 559                 else {
 560                         params = jsonNewObject(NULL);
 561                         jsonObjectPush(params, last_result->_result_content );
 562                 }
 563         }
 564
 565
 566         if(buffer->n_used > 0 && params == NULL) {
 567                 fprintf(stderr, "JSON error detected, not executing\n");
 568                 jsonObjectFree(params);
 569                 return 1;
 570         }
 571
 572         osrfAppSession* session = osrfAppSessionClientInit(server);
 573
 574         if(!osrf_app_session_connect(session)) {
 575                 osrfLogWarning( OSRF_LOG_MARK,  "Unable to connect to remote service %s\n", server );
 576                 jsonObjectFree(params);
 577                 return 1;
 578         }
 579
 580         double start = get_timestamp_millis();
 581
 582         int req_id = osrfAppSessionMakeRequest( session, params, method, 1, NULL );
 583         jsonObjectFree(params);
 584
 585         osrf_message* omsg = osrfAppSessionRequestRecv( session, req_id, recv_timeout );
 586
 587         if(!omsg)
 588                 printf("\nReceived no data from server\n");
 589
 590
 591         signal(SIGPIPE, SIG_IGN);
 592
 593         FILE* less;
 594         if(!is_from_script) less = popen( "less -EX", "w");
 595         else less = stdout;
 596
 597         if( less == NULL ) { less = stdout; }
 598
 599         growing_buffer* resp_buffer = buffer_init(4096);
 600
 601         while(omsg) {
 602
 603                 if(raw_print) {
 604
 605                         if(omsg->_result_content) {
 606
 607                                 osrfMessageFree(last_result);
 608                                 last_result = omsg;
 609
 610                                 char* content;
 611
 612                                 if( pretty_print ) {
 613                                         char* j = jsonObjectToJSON(omsg->_result_content);
 614                                         //content = json_printer(j);
 615                                         content = jsonFormatString(j);
 616                                         free(j);
 617                                 } else {
 618                                         const char * temp_content = jsonObjectGetString(omsg->_result_content);
 619                                         if( ! temp_content )
 620                                                 temp_content = "[null]";
 621                                         content = strdup( temp_content );
 622                                 }
 623
 624                                 printf( "\nReceived Data: %s\n", content );
 625                                 free(content);
 626
 627                         } else {
 628
 629                                 char code[16];
 630                                 snprintf( code, sizeof(code), "%d", omsg->status_code );
 631                                 buffer_add( resp_buffer, code );
 632
 633                                 printf( "\nReceived Exception:\nName: %s\nStatus: %s\nStatus: %s\n",
 634                                                 omsg->status_name, omsg->status_text, code );
 635
 636                                 fflush(stdout);
 637                         }
 638
 639                 } else {
 640
 641                         if(omsg->_result_content) {
 642
 643                                 osrfMessageFree(last_result);
 644                                 last_result = omsg;
 645
 646                                 char* content;
 647
 648                                 if( pretty_print && omsg->_result_content ) {
 649                                         char* j = jsonObjectToJSON(omsg->_result_content);
 650                                         //content = json_printer(j);
 651                                         content = jsonFormatString(j);
 652                                         free(j);
 653                                 } else {
 654                                         const char * temp_content = jsonObjectGetString(omsg->_result_content);
 655                                         if( temp_content )
 656                                                 content = strdup( temp_content );
 657                                         else
 658                                                 content = NULL;
 659                                 }
 660
 661                                 buffer_add( resp_buffer, "\nReceived Data: " );
 662                                 buffer_add( resp_buffer, content );
 663                                 buffer_add( resp_buffer, "\n" );
 664                                 free(content);
 665
 666                         } else {
 667
 668                                 buffer_add( resp_buffer, "\nReceived Exception:\nName: " );
 669                                 buffer_add( resp_buffer, omsg->status_name );
 670                                 buffer_add( resp_buffer, "\nStatus: " );
 671                                 buffer_add( resp_buffer, omsg->status_text );
 672                                 buffer_add( resp_buffer, "\nStatus: " );
 673                                 char code[16];
 674                                 snprintf( code, sizeof(code), "%d", omsg->status_code );
 675                                 buffer_add( resp_buffer, code );
 676                         }
 677                 }
 678
 679
 680                 omsg = osrfAppSessionRequestRecv( session, req_id, recv_timeout );
 681
 682         }
 683
 684         double end = get_timestamp_millis();
 685
 686         fprintf( less, resp_buffer->buf );
 687         buffer_free( resp_buffer );
 688         fprintf( less, "\n------------------------------------\n");
 689         if( osrf_app_session_request_complete( session, req_id ))
 690                 fprintf(less, "Request Completed Successfully\n");
 691
 692
 693         fprintf(less, "Request Time in seconds: %.6f\n", end - start );
 694         fprintf(less, "------------------------------------\n");
 695
 696         pclose(less);
 697
 698         osrf_app_session_request_finish( session, req_id );
 699         osrf_app_session_disconnect( session );
 700         osrfAppSessionFree( session );
 701
 702
 703         return 1;
 704
 705
 706 }
 707
 708 static int handle_time( char* words[] ) {
 709         if(!words[1]) {
 710                 printf("%f\n", get_timestamp_millis());
 711     } else {
 712         time_t epoch = (time_t) atoi(words[1]);
 713                 printf("%s", ctime(&epoch));
 714     }
 715         return 1;
 716 }
 717
 718
 719
 720 static int router_query_servers( const char* router_server ) {
 721
 722         if( ! router_server || strlen(router_server) == 0 )
 723                 return 0;
 724
 725         const static char router_text[] = "router@%s/router";
 726         size_t len = sizeof( router_text ) + strlen( router_server ) + 1;
 727         char rbuf[len];
 728         snprintf(rbuf, sizeof(rbuf), router_text, router_server );
 729
 730         transport_message* send =
 731                 message_init( "servers", NULL, NULL, rbuf, NULL );
 732         message_set_router_info( send, NULL, NULL, NULL, "query", 0 );
 733
 734         client_send_message( client, send );
 735         message_free( send );
 736
 737         transport_message* recv = client_recv( client, -1 );
 738         if( recv == NULL ) {
 739                 fprintf(stderr, "NULL message received from router\n");
 740                 return 1;
 741         }
 742
 743         printf(
 744                         "---------------------------------------------------------------------------------\n"
 745                         "Received from 'server' query on %s\n"
 746                         "---------------------------------------------------------------------------------\n"
 747                         "original reg time | latest reg time | last used time | class | server\n"
 748                         "---------------------------------------------------------------------------------\n"
 749                         "%s"
 750                         "---------------------------------------------------------------------------------\n"
 751                         , router_server, recv->body );
 752
 753         message_free( recv );
 754
 755         return 1;
 756 }
 757
 758 static int print_help( void ) {
 759
 760         printf(
 761                         "---------------------------------------------------------------------------------\n"
 762                         "Commands:\n"
 763                         "---------------------------------------------------------------------------------\n"
 764                         "help                   - Display this message\n"
 765                         "!<command> [args]      - Forks and runs the given command in the shell\n"
 766                 /*
 767                         "time                   - Prints the current time\n"
 768                         "time <timestamp>       - Formats seconds since epoch into readable format\n"
 769                 */
 770                         "set <variable> <value> - set a srfsh variable (e.g. set pretty_print true )\n"
 771                         "print <variable>       - Displays the value of a srfsh variable\n"
 772                         "---------------------------------------------------------------------------------\n"
 773
 774                         "router query servers <server1 [, server2, ...]>\n"
 775                         "       - Returns stats on connected services\n"
 776                         "\n"
 777                         "\n"
 778                         "request <service> <method> [ <json formatted string of params> ]\n"
 779                         "       - Anything passed in will be wrapped in a json array,\n"
 780                         "               so add commas if there is more than one param\n"
 781                         "\n"
 782                         "\n"
 783                         "relay <service> <method>\n"
 784                         "       - Performs the requested query using the last received result as the param\n"
 785                         "\n"
 786                         "\n"
 787                         "math_bench <num_batches> [0|1|2]\n"
 788                         "       - 0 means don't reconnect, 1 means reconnect after each batch of 4, and\n"
 789                         "                2 means reconnect after every request\n"
 790                         "\n"
 791                         "introspect <service>\n"
 792                         "       - prints the API for the service\n"
 793                         "\n"
 794                         "\n"
 795                         "---------------------------------------------------------------------------------\n"
 796                         " Commands for Open-ILS\n"
 797                         "---------------------------------------------------------------------------------\n"
 798                         "login <username> <password>\n"
 799                         "       - Logs into the 'server' and displays the session id\n"
 800                         "       - To view the session id later, enter: print login\n"
 801                         "---------------------------------------------------------------------------------\n"
 802                         "\n"
 803                         "\n"
 804                         "Note: long output is piped through 'less'. To search in 'less', type: /<search>\n"
 805                         "---------------------------------------------------------------------------------\n"
 806                         "\n"
 807                         );
 808
 809         return 1;
 810 }
 811
 812
 813 /*
 814 static char* tabs(int count) {
 815         growing_buffer* buf = buffer_init(24);
 816         int i;
 817         for(i=0;i!=count;i++)
 818                 buffer_add(buf, "  ");
 819
 820         char* final = buffer_data( buf );
 821         buffer_free( buf );
 822         return final;
 823 }
 824 */
 825
 826
 827 static int handle_math( char* words[] ) {
 828         if( words[1] )
 829                 return do_math( atoi(words[1]), 0 );
 830         return 0;
 831 }
 832
 833
 834 static int do_math( int count, int style ) {
 835
 836         osrfAppSession* session = osrfAppSessionClientInit( "opensrf.math" );
 837         osrf_app_session_connect(session);
 838
 839         jsonObject* params = jsonParseString("[]");
 840         jsonObjectPush(params,jsonNewObject("1"));
 841         jsonObjectPush(params,jsonNewObject("2"));
 842
 843         char* methods[] = { "add", "sub", "mult", "div" };
 844         char* answers[] = { "3", "-1", "2", "0.500000" };
 845
 846         float times[ count * 4 ];
 847         memset(times, 0, sizeof(times));
 848
 849         int k;
 850         for(k=0;k!=100;k++) {
 851                 if(!(k%10))
 852                         fprintf(stderr,"|");
 853                 else
 854                         fprintf(stderr,".");
 855         }
 856
 857         fprintf(stderr,"\n\n");
 858
 859         int running = 0;
 860         int i;
 861         for(i=0; i!= count; i++) {
 862
 863                 int j;
 864                 for(j=0; j != 4; j++) {
 865
 866                         ++running;
 867
 868                         double start = get_timestamp_millis();
 869                         int req_id = osrfAppSessionMakeRequest( session, params, methods[j], 1, NULL );
 870                         osrf_message* omsg = osrfAppSessionRequestRecv( session, req_id, 5 );
 871                         double end = get_timestamp_millis();
 872
 873                         times[(4*i) + j] = end - start;
 874
 875                         if(omsg) {
 876
 877                                 if(omsg->_result_content) {
 878                                         char* jsn = jsonObjectToJSON(omsg->_result_content);
 879                                         if(!strcmp(jsn, answers[j]))
 880                                                 fprintf(stderr, "+");
 881                                         else
 882                                                 fprintf(stderr, "\n![%s] - should be %s\n", jsn, answers[j] );
 883                                         free(jsn);
 884                                 }
 885
 886
 887                                 osrfMessageFree(omsg);
 888
 889                         } else { fprintf( stderr, "\nempty message for tt: %d\n", req_id ); }
 890
 891                         osrf_app_session_request_finish( session, req_id );
 892
 893                         if(style == 2)
 894                                 osrf_app_session_disconnect( session );
 895
 896                         if(!(running%100))
 897                                 fprintf(stderr,"\n");
 898                 }
 899
 900                 if(style==1)
 901                         osrf_app_session_disconnect( session );
 902         }
 903
 904         osrfAppSessionFree( session );
 905         jsonObjectFree(params);
 906
 907         int c;
 908         float total = 0;
 909         for(c=0; c!= count*4; c++)
 910                 total += times[c];
 911
 912         float avg = total / (count*4);
 913         fprintf(stderr, "\n      Average round trip time: %f\n", avg );
 914
 915         return 1;
 916 }