[BACK]Return to pa_request.C CVS log [TXT] [DIR] Up to [parser3project] / parser3 / src / main

Diff for /parser3/src/main/pa_request.C between versions 1.184 and 1.252

version 1.184, 2001/12/14 12:53:48 version 1.252, 2003/11/07 13:59:22
Line 1 Line 1
 /** @file  /** @file
         Parser: request class main part. @see compile.C and execute.C.          Parser: request class main part. @see compile.C and execute.C.
   
         Copyright (c) 2001 ArtLebedev Group (http://www.artlebedev.com)          Copyright (c) 2001-2003 ArtLebedev Group (http://www.artlebedev.com)
         Author: Alexander Petrosyan <paf@design.ru> (http://paf.design.ru)          Author: Alexandr Petrosian <paf@design.ru> (http://paf.design.ru)
   
         $Id$  
 */  */
   
 #include "pa_config_includes.h"  static const char* IDENT_REQUEST_C="$Date$";
   
 extern "C" unsigned char pcre_default_tables[]; // pcre/chartables.c  
   
 #include "pa_sapi.h"  #include "pa_sapi.h"
 #include "pa_common.h"  #include "pa_common.h"
Line 20  extern "C" unsigned char pcre_default_ta Line 16  extern "C" unsigned char pcre_default_ta
 #include "pa_vint.h"  #include "pa_vint.h"
 #include "pa_vmethod_frame.h"  #include "pa_vmethod_frame.h"
 #include "pa_types.h"  #include "pa_types.h"
   #include "pa_venv.h"
   #include "pa_vmath.h"
   #include "pa_vstatus.h"
   #include "pa_vrequest.h"
 #include "pa_vtable.h"  #include "pa_vtable.h"
 #include "pa_vfile.h"  #include "pa_vfile.h"
 #include "pa_dictionary.h"  #include "pa_dictionary.h"
 #include "pa_charset_manager.h"  #include "pa_charset.h"
 #include "pa_charset_connection.h"  #include "pa_charsets.h"
   #include "pa_cache_managers.h"
   #include "pa_vmail.h"
   #include "pa_vform.h"
   #include "pa_vcookie.h"
   #include "pa_vresponse.h"
   #include "pa_vmemory.h"
   
   // consts
   
   const char* UNHANDLED_EXCEPTION_METHOD_NAME="unhandled_exception";
   
 /// content type of exception response, when no @MAIN:exception handler defined  /// content type of exception response, when no @MAIN:exception handler defined
 const char *UNHANDLED_EXCEPTION_CONTENT_TYPE="text/plain";  const char* UNHANDLED_EXCEPTION_CONTENT_TYPE="text/plain";
   
 /// content type of response when no $MAIN:defaults.content-type defined  /// content type of response when no $MAIN:defaults.content-type defined
 const char *DEFAULT_CONTENT_TYPE="text/html";  const char* DEFAULT_CONTENT_TYPE="text/html";
 const char *ORIGINS_CONTENT_TYPE="text/plain";  const char* ORIGINS_CONTENT_TYPE="text/plain";
   
 Methoded *MOP_create(Pool&);  // defines for globals
   
 static void load_charset(const Hash::Key& akey, Hash::Val *avalue,   #define MAIN_METHOD_NAME "main"
                                                                                   void *info) {  #define AUTO_METHOD_NAME "auto"
         Value& value=*static_cast<Value *>(avalue);  #define BODY_NAME "body"
         Hash& CTYPE=*static_cast<Hash *>(info);  #define EXCEPTION_TYPE_PART_NAME "type"
   #define EXCEPTION_SOURCE_PART_NAME "source"
   #define EXCEPTION_COMMENT_PART_NAME "comment"
   #define EXCEPTION_HANDLED_PART_NAME "handled"
   
   // globals
   
   const String main_method_name(MAIN_METHOD_NAME);
   const String auto_method_name(AUTO_METHOD_NAME);
   const String content_disposition_name(CONTENT_DISPOSITION_NAME);
   const String content_disposition_value(CONTENT_DISPOSITION_VALUE);
   const String content_disposition_filename_name(CONTENT_DISPOSITION_FILENAME_NAME);
   const String body_name(BODY_NAME);
   const String exception_type_part_name(EXCEPTION_TYPE_PART_NAME);
   const String exception_source_part_name(EXCEPTION_SOURCE_PART_NAME);
   const String exception_comment_part_name(EXCEPTION_COMMENT_PART_NAME);
   const String exception_handled_part_name(EXCEPTION_HANDLED_PART_NAME);
   
   // defines for statics
   
   #define CHARSETS_NAME "CHARSETS"
   #define MIME_TYPES_NAME "MIME-TYPES"
   #define ORIGINS_MODE_NAME "ORIGINS"
   #define CONF_METHOD_NAME "conf"
   #define POST_PROCESS_METHOD_NAME "postprocess"
   #define DOWNLOAD_NAME "download"
   #define CLASS_PATH_NAME "CLASS_PATH"
   
   // statics
   
   static const String charsets_name(CHARSETS_NAME);
   static const String main_class_name(MAIN_CLASS_NAME);
   static const String mime_types_name(MIME_TYPES_NAME);
   static const String origins_mode_name(ORIGINS_MODE_NAME);
   static const String conf_method_name(CONF_METHOD_NAME);
   static const String post_process_method_name(POST_PROCESS_METHOD_NAME);
   static const String download_name(DOWNLOAD_NAME);
   static const String class_path_name(CLASS_PATH_NAME);
   
         Charset_connection& connection=  // defines
                 charset_manager->get_connection(akey, value.as_string());  
   
         // charset->transcoder   // op.C
         CTYPE.put(akey, &connection.transcoder());  VStateless_class& VClassMAIN_create();
 }  
   
 //  //
 Request::Request(Pool& apool,  Request::Request(SAPI_Info& asapi_info, Request_info& arequest_info, 
                                  Info& ainfo,                                   String::Language adefault_lang, bool status_allowed):
                                  uchar adefault_lang,          // private
                                  bool status_allowed) : Pooled(apool),  
         stack(apool),  
         OP(*MOP_create(apool)),  
         env(apool),  
         status(apool),  
         form(apool),  
         math(apool),  
         request(apool, *this),  
         response(apool),  
         cookie(apool),  
         fclasses(apool),  
         CTYPE(apool),  
         fdefault_lang(adefault_lang), flang(adefault_lang),  
         info(ainfo),  
         post_data(0), post_size(0),  
         used_files(apool),  
         default_content_type(0),  
         mime_types(0),  
         main_class(0),  
         connection(0),  
         classes_conf(apool),  
         anti_endless_execute_recoursion(0),          anti_endless_execute_recoursion(0),
         trace(apool)  
           // public
           method_frame(0),
           rcontext(0),
           wcontext(0),
           flang(adefault_lang),
           fconnection(0),
           finterrupted(false),
   
           // public
 #ifdef RESOURCES_DEBUG  #ifdef RESOURCES_DEBUG
         ,sql_connect_time(0),sql_request_time(0)          sql_connect_time(0),
 #endif          sql_request_time(0),
   #endif  
   
           // public
           sapi_info(asapi_info),
           request_info(arequest_info),
           charsets(UTF8_charset, UTF8_charset, UTF8_charset), // default charsets
   
           main_class(VClassMAIN_create()),
           form(*new VForm),
           mail(*new VMail),
           response(*new VResponse(arequest_info, charsets)),
           cookie(*new VCookie),
   
           // private
           configure_admin_done(false),
   
           // private defaults
           fdefault_lang(adefault_lang), 
           // private mime types
           mime_types(0)
 {  {
           // file_no=0 => unknown
           file_list+=String::Body("UNKNOWN");
           file_list+=String::Body("-body of process-"); // pseudo_file_no__process
   
         // maybe expire old caches          // maybe expire old caches
         cache_managers->maybe_expire();          cache_managers.maybe_expire();
                   
         /// directly used          /// directly used
         // operators          // MAIN class, operators
         OP.register_directly_used(*this);          classes().put(main_class.name(), &main_class);
         // classes:          // classes:
         // table, file, random, mail, image, ...          // table, file, random, mail, image, ...
         methoded_array->register_directly_used(*this);          methoded_array().register_directly_used(*this);
   
         /// methodless          /// methodless
         // env class          // env class
         classes().put(*NEW String(pool(), ENV_CLASS_NAME), &env);          classes().put(String::Body(ENV_CLASS_NAME), new VEnv(asapi_info));
         // status class          // status class
         if(status_allowed)          if(status_allowed)
                 classes().put(*NEW String(pool(), STATUS_CLASS_NAME), &status);                  classes().put(String::Body(STATUS_CLASS_NAME), new VStatus());
         // request class          // request class
         classes().put(*NEW String(pool(), REQUEST_CLASS_NAME), &request);                 classes().put(String::Body(REQUEST_CLASS_NAME), new VRequest(arequest_info, charsets)); 
         // cookie class          // cookie class
         classes().put(*NEW String(pool(), COOKIE_CLASS_NAME), &cookie);          classes().put(String::Body(COOKIE_CLASS_NAME), &cookie);
   
         /// methoded          /// methoded
         // response class          // response class
         classes().put(response.get_class()->name(), &response);           classes().put(response.get_class()->name(), &response);
   
         /// bases used          /// bases used
         // form class          // form class
         classes().put(form.get_class()->base()->name(), &form);           classes().put(form.get_class()->base_class()->name(), &form);
           // mail class
           classes().put(mail.get_class()->base_class()->name(), &mail);
         // math class          // math class
         classes().put(math.get_class()->base()->name(), &math);           {
                   Value& math=*new VMath;
                   classes().put(math.get_class()->base_class()->name(), &math);
           }
           // memory class
           {
                   Value& memory=*new VMemory;
                   classes().put(memory.get_class()->base_class()->name(), &memory);
           }
   }
   
   Request::~Request() {
   #ifdef XML
           // if for some strange reason xml generic errors failed to be reported, free them up
           if(const char* xml_generic_errors=xmlGenericErrors()) {
                   SAPI::log(sapi_info, "warning: unreported xmlGenericErrors: %s", xml_generic_errors);
                   free((void *)xml_generic_errors);
           }
   #endif
   }
   
   Value& Request::get_self() { return method_frame/*always have!*/->self(); }
   
   static void load_charset(HashStringValue::key_type akey, 
                            HashStringValue::value_type avalue, 
                            Request_charsets* charsets) {
           const String::Body NAME=String(akey, String::L_CLEAN).change_case(charsets->source(), String::CC_UPPER);
           ::charsets.load_charset(*charsets, NAME, avalue->as_string());
   }
   void Request::configure_admin(VStateless_class& conf_class) {
           if(configure_admin_done)
                   throw Exception("parser.runtime",
                   0,
                   "parser already configured");
           configure_admin_done=true;
           
           // charsets must only be specified in method_frame config
           // so that users would not interfere
   
           /* $MAIN:CHARSETS[
                           $.charsetname1[/full/path/to/charset/file.cfg]
                           ...
                   ]
           */
           if(Value* vcharsets=conf_class.get_element(charsets_name, conf_class, false)) {
                   if(!vcharsets->is_string())
                           if(HashStringValue* charsets=vcharsets->get_hash())
                                   charsets->for_each(load_charset, &this->charsets);
                           else
                                   throw Exception("parser.runtime",
                                           0,
                                           "$" MAIN_CLASS_NAME ":" CHARSETS_NAME " must be hash");
           }
   
           // configure method_frame options
           //      until someone with less privileges have overriden them
           methoded_array().configure_admin(*this);
 }  }
   
 /**  /**
Line 121  Request::Request(Pool& apool, Line 236  Request::Request(Pool& apool,
         @test log stack trace          @test log stack trace
   
 */  */
 void Request::core(  void Request::core(const char* config_filespec, bool config_fail_on_read_problem, bool header_only) {
                                    const char *root_config_filespec, bool root_config_fail_on_read_problem,  
                                    const char *site_config_filespec, bool site_config_fail_on_read_problem,  
                                    bool header_only) {  
   
 #ifdef RESOURCES_DEBUG  #ifdef RESOURCES_DEBUG
 //measures  //measures
Line 133  struct timeval mt[10]; Line 245  struct timeval mt[10];
 gettimeofday(&mt[0],NULL);  gettimeofday(&mt[0],NULL);
 #endif  #endif
         try {          try {
                 char *auto_filespec=(char *)malloc(MAX_STRING);                  // loading config
                                   if(config_filespec) {
                 // loading root config                          const String& filespec=*new String(config_filespec);
                 if(root_config_filespec) {                          use_file(main_class,
                         String& filespec=*NEW String(pool());                                  filespec, 0 /*main_alias*/, 
                         filespec.APPEND_CLEAN(root_config_filespec, 0, "root_config", 0);                                  true /*ignore class_path*/, 
                         main_class=use_file(                                  config_fail_on_read_problem, 
                                 filespec,                                   true /*file must exist if 'fail on read problem' not set*/);
                                 true/*ignore class_path*/, root_config_fail_on_read_problem,  
                                 main_class_name, main_class);  
                 }  
   
                 if(main_class) {  
                         /* $MAIN:CHARSETS[  
                                         $.charsetname1[/full/path/to/charset/file.cfg]  
                                         ...  
                                 ]  
                         */  
                         if(Value *vcharsets=main_class->get_element(*charsets_name)) {  
                                 if(Hash *charsets=vcharsets->get_hash(0))  
                                         charsets->for_each(load_charset, &CTYPE);  
                                 else  
                                         throw Exception(0, 0,  
                                                 &vcharsets->name(),  
                                                 "must be hash");  
                         }  
                 }  
   
                 // configure root options  
                 //      until someone with less privileges have overriden them  
                 OP.configure_admin(*this);  
                 methoded_array->configure_admin(*this);  
   
                 // loading site config  
                 if(site_config_filespec) {  
                         String& filespec=*NEW String(pool());  
                         filespec.APPEND_CLEAN(site_config_filespec, 0, "site_config", 0);  
                         main_class=use_file(  
                                 filespec,   
                                 true/*ignore class_path*/, site_config_fail_on_read_problem,  
                                 main_class_name, main_class);  
                 }                  }
   
                 // loading auto.p files from document_root/..                   // loading auto.p files from document_root/.. 
                 // to the one beside requested file.                  // to the one beside requested file.
                 // all assigned bases from upper dir                  // all assigned bases from upper dir
                 {                  {
                         const char *after=info.path_translated;                          const char* after=request_info.path_translated;
                         size_t drlen=strlen(info.document_root);                          size_t drlen=strlen(request_info.document_root);
                         if(memcmp(after, info.document_root, drlen)==0) {                          if(memcmp(after, request_info.document_root, drlen)==0) {
                                 after+=drlen;                                  after+=drlen;
                                 if(after[-1]=='/')                                   if(after[-1]=='/') 
                                         --after;                                          --after;
                         }                          }
                                                   
                         int step=0;                          int step=0;
                         while(const char *before=strchr(after, '/')) {                          while(const char* before=strchr(after, '/')) {
                                 String& sfile_spec=*NEW String(pool());                                  String& sfile_spec=*new String;
                                 if(after!=info.path_translated) {                                  if(after!=request_info.path_translated) {
                                         sfile_spec.APPEND_CLEAN(                                          sfile_spec.append_strdup(
                                                 info.path_translated, before-info.path_translated,                                                  request_info.path_translated, before-request_info.path_translated,
                                                 "path-translated-scanned", step++);                                                  String::L_CLEAN);
                                         sfile_spec << "/" AUTO_FILE_NAME;                                          sfile_spec << "/" AUTO_FILE_NAME;
   
                                         main_class=use_file(sfile_spec,                                           use_file(main_class,
                                                 true/*ignore class_path*/, false/*ignore read problem*/,                                                  sfile_spec, 
                                                 main_class_name, main_class);                                                  0 /*main_alias*/,
                                                   true /*ignore class_path*/, 
                                                   true /*fail on read problem*/, 
                                                   false /*but ignore absence, sole user*/);
                                 }                                  }
                                 after=before+1;                                  after=before+1;
                         }                          }
                 }                  }
   
                 // compile requested file                  // compile requested file
                 String& spath_translated=*NEW String(pool());                  String& spath_translated=*new String;
                 spath_translated.APPEND_TAINTED(info.path_translated, 0, "user-request", 0);                  spath_translated.append_help_length(request_info.path_translated, 0, String::L_TAINTED);
                 main_class=use_file(spath_translated,                   use_file(main_class,
                         true/*ignore class_path*/, true/*don't ignore read problem*/,                          spath_translated, 
                         main_class_name, main_class);                          0 /*main_alias*/,
                           true /*ignore class_path*/);
                 // configure not-root=user options  
                 OP.configure_user(*this);                  // configure method_frame options if not configured yet
                 methoded_array->configure_user(*this);                  if(!configure_admin_done)
                           configure_admin(main_class);
   
                   // configure not-method_frame=user options
                   methoded_array().configure_user(*this);
   
                 // $MAIN:MIME-TYPES                  // $MAIN:MIME-TYPES
                 if(Value *element=main_class->get_element(*mime_types_name))                  if(Value* element=main_class.get_element(mime_types_name, main_class, false))
                         if(Table *table=element->get_table())                          if(Table *table=element->get_table())
                                 mime_types=table;                                                         mime_types=table;                       
   
                 // filling form fields                  // filling form fields
                 form.fill_fields_and_tables(*this);                  form.fill_fields_and_tables(charsets, request_info);
   
                 // filling cookies                  // filling cookies
                 cookie.fill_fields(*this);                  cookie.fill_fields(request_info);
   
                   // filling mail received
                   mail.fill_received(*this);
   
 #ifdef RESOURCES_DEBUG  #ifdef RESOURCES_DEBUG
 //measure:after compile  //measure:after compile
 gettimeofday(&mt[1],NULL);  gettimeofday(&mt[1],NULL);
 #endif  #endif
                 // execute @main[]                  // execute @main[]
                 const String *body_string=execute_virtual_method(                  const String* body_string=execute_virtual_method(main_class, main_method_name);
                         *main_class, *main_method_name);  
                 if(!body_string)                  if(!body_string)
                         throw Exception(0,0,                          throw Exception("parser.runtime",
                                 0,                                   0,
                                 "'"MAIN_METHOD_NAME"' method not found");                                  "'"MAIN_METHOD_NAME"' method not found");
   
 #ifdef RESOURCES_DEBUG  #ifdef RESOURCES_DEBUG
Line 244  gettimeofday(&mt[1],NULL); Line 332  gettimeofday(&mt[1],NULL);
 gettimeofday(&mt[2],NULL);  gettimeofday(&mt[2],NULL);
 #endif  #endif
   
                 VString body_vstring_before_post_process(*body_string);                  // extract response body
                 VString *body_vstring_after_post_process=&body_vstring_before_post_process;                  Value* body_value=response.fields().get(download_name); // $response:download?
                   bool as_attachment=body_value!=0;
                   if(!body_value)
                           body_value=response.fields().get(body_name); // $response:body
                   if(!body_value)
                           body_value=new VString(*body_string); // just result of ^main[]
   
                 // @postprocess                  // @postprocess
                 if(Value *value=main_class->get_element(*post_process_method_name))                  if(Value* value=main_class.get_element(post_process_method_name, main_class, false))
                         if(Junction *junction=value->get_junction())                          if(Junction* junction=value->get_junction())
                                 if(const Method *method=junction->method) {                                  if(const Method *method=junction->method) {
                                         // preparing to pass parameters to                                           // preparing to pass parameters to 
                                         //      @postprocess[data]                                          //      @postprocess[data]
                                         VMethodFrame frame(pool(), value->name(), *junction);                                          VMethodFrame frame(/*method->name, */ *junction, 0/*no parent*/);
                                         frame.set_self(*main_class);                                          frame.set_self(main_class);
   
                                         frame.store_param(method->name,                                           frame.store_param(*body_value);
                                                 &body_vstring_before_post_process);                                          body_value=&execute_method(frame, *method).as_value();
                                         body_vstring_after_post_process=  
                                                 NEW VString(*execute_method(frame, *method));  
                                 }                                  }
   
                 bool origins_mode=main_class->get_element(*origins_mode_name)!=0;                  VFile* body_file=body_value->as_vfile(
                           String::L_UNSPECIFIED, &charsets);
                 const VFile *body_file=body_vstring_after_post_process->as_vfile(  
                         String::UL_UNSPECIFIED, origins_mode);  
   
                 // extract response body  
                 Value *body_value=static_cast<Value *>(  
                         response.fields().get(*body_name));  
                 if(body_value) // there is some $response.body  
                         body_file=body_value->as_vfile();  
                 else if(origins_mode)  
                         response.fields().put(*content_type_name,   
                                 NEW VString(*NEW String(pool(), ORIGINS_CONTENT_TYPE)));  
   
 #ifdef RESOURCES_DEBUG  #ifdef RESOURCES_DEBUG
 //measure:after postprocess  //measure:after postprocess
Line 281  gettimeofday(&mt[3],NULL); Line 362  gettimeofday(&mt[3],NULL);
 #endif  #endif
   
                 // OK. write out the result                  // OK. write out the result
                 output_result(*body_file, header_only);                  output_result(body_file, header_only, as_attachment);
   
 #ifdef RESOURCES_DEBUG  #ifdef RESOURCES_DEBUG
                 //measure:after output_result                  //measure:after output_result
Line 292  double t[10]; Line 373  double t[10];
 for(int i=0;i<10;i++)  for(int i=0;i<10;i++)
     t[i]=mt[i].tv_sec+mt[i].tv_usec/1000000.0;      t[i]=mt[i].tv_sec+mt[i].tv_usec/1000000.0;
 //measure:log2 compile,main,postprocess,output  //measure:log2 compile,main,postprocess,output
 SAPI::log(pool(), "rmeasure: %s,%.2f,%.2f,%.2f %.2f,%.2f %.2f",   SAPI::log("rmeasure: %s,%.2f,%.2f,%.2f %.2f,%.2f %.2f", 
 info.uri,  request_info.uri,
 t[1]-t[0],  t[1]-t[0],
 t[2]-t[1],  t[2]-t[1],
 t[3]-t[2],  t[3]-t[2],
Line 303  t[9]-t[3] Line 384  t[9]-t[3]
 #endif  #endif
         } catch(const Exception& e) { // request handling problem          } catch(const Exception& e) { // request handling problem
                 // we're returning not result, but error explanation                  // we're returning not result, but error explanation
                 try {  //              try {
   #define PA_URI_FORMAT "%s: "
   #define PA_ORIGIN_FILE_POS_FORMAT "%s(%d:%d): "
   #define PA_SOURCE_FORMAT "'%s' "
   #define PA_COMMENT_TYPE_FORMAT "%s [%s]"
                         // log the beast                          // log the beast
                         const String *problem_source=e.problem_source();                          Request::Exception_details details=get_details(e);
                         if(problem_source && problem_source->size())  
                                 SAPI::log(pool(),                          if(details.problem_source) { // do we know the guy?
 #ifndef NO_STRING_ORIGIN                                  if(details.trace) { // do whe know where he came from?
                                         ORIGIN_FILE_LINE_FORMAT": "                                          Operation::Origin origin=details.trace.origin();
 #endif                                          SAPI::log(sapi_info,
                                         "'%s' %s [%s %s]",                                                  PA_URI_FORMAT 
 #ifndef NO_STRING_ORIGIN                                                  PA_ORIGIN_FILE_POS_FORMAT 
                                         problem_source->origin().file?problem_source->origin().file:"global",                                                  PA_SOURCE_FORMAT PA_COMMENT_TYPE_FORMAT,
                                         problem_source->origin().line,                                                  request_info.uri,
 #endif                                                  file_list[origin.file_no].cstr(), 1+origin.line, 1+origin.col,
                                         problem_source->cstr(),                                                  details.problem_source->cstr(),
                                         e.comment(),                                                  e.comment(), e.type()
                                         e.type()?e.type()->cstr():"-",                                          );
                                         e.code()?e.code()->cstr():"-"                                  } else
                                 );                                          SAPI::log(sapi_info,
                         else                                                  PA_URI_FORMAT 
                                 SAPI::log(pool(),                                                  PA_SOURCE_FORMAT PA_COMMENT_TYPE_FORMAT,
                                         "%s [%s %s]",                                                  request_info.uri,
                                         e.comment(),                                                  details.problem_source->cstr(),
                                         e.type()?e.type()->cstr():"-",                                                  e.comment(), e.type()
                                         e.code()?e.code()->cstr():"-"                                          );
                           } else
                                   SAPI::log(sapi_info,
                                           PA_URI_FORMAT 
                                           PA_COMMENT_TYPE_FORMAT,
                                           request_info.uri,
                                           e.comment(), e.type()
                                 );                                  );
   
                         // reset language to default                          // reset language to default
Line 336  t[9]-t[3] Line 427  t[9]-t[3]
                         response.fields().clear();                          response.fields().clear();
   
                         // this is what we'd return in $response:body                          // this is what we'd return in $response:body
                         const String *body_string=0;                          const String* body_string=0;
   
                         if(main_class) { // we've managed to end up with some main_class                          // maybe we'd be lucky enough as to report an error
                                 // maybe we'd be lucky enough as to report an error                          // in a gracefull way...
                                 // in a gracefull way...                          if(Value* value=main_class.get_element(
                                 if(Value *value=main_class->get_element(*exception_method_name))                                          *new String(UNHANDLED_EXCEPTION_METHOD_NAME), 
                                         if(Junction *junction=value->get_junction())                                          main_class,
                                                 if(const Method *method=junction->method) {                                          false)) {
                                                         // preparing to pass parameters to                                   if(Junction* junction=value->get_junction()) {
                                                         //      @exception[origin;source;comment;type;code;stack]                                          if(const Method *method=junction->method) {
                                                         VMethodFrame frame(pool(), value->name(), *junction);  // preparing to pass parameters to 
                                                         frame.set_self(*main_class);  //      @unhandled_exception[exception;stack]
   VMethodFrame frame(/*method->name, */ *junction, 0/*no caller*/);
                                                         const String *problem_source=e.problem_source();  frame.set_self(main_class);
                                                         // origin  
                                                         Value *origin_value=0;  // $exception
 #ifndef NO_STRING_ORIGIN  frame.store_param(details.vhash);
                                                         if(problem_source && problem_source->size()) {  // $stack[^table::set{name      origin}]
                                                                 const Origin& origin=problem_source->origin();  Table::columns_type stack_trace_columns(new ArrayString);
                                                                 if(origin.file) {  *stack_trace_columns+=new String("name");
                                                                         char *buf=(char *)malloc(MAX_STRING);  *stack_trace_columns+=new String("file");
                                                                         size_t buf_size=snprintf(buf, MAX_STRING, ORIGIN_FILE_LINE_FORMAT,   *stack_trace_columns+=new String("lineno");
                                                                                 origin.file, 1+origin.line);  *stack_trace_columns+=new String("colno");
                                                                         origin_value=NEW VString(*NEW String(pool(),  Table& stack_trace=*new Table(stack_trace_columns);
                                                                                 buf, buf_size, true));  if(!exception_trace.is_empty()/*signed!*/) 
                                                                 }          for(size_t i=exception_trace.bottom_index(); i<exception_trace.top_index(); i++) {
                                                         }                  Trace trace=exception_trace.get(i);
 #endif                  Table::element_type row(new ArrayString);
                                                         frame.store_param(method->name,   
                                                                 origin_value?origin_value:NEW VVoid(pool()));                  *row+=trace.name(); // name column
                   Operation::Origin origin=trace.origin();
                   if(origin.file_no) {
                           *row+=new String(file_list[origin.file_no], String::L_TAINTED); // 'file' column
                           *row+=new String(String::Body::Format(1+origin.line), String::L_CLEAN); // 'lineno' column
                           *row+=new String(String::Body::Format(1+origin.col), String::L_CLEAN); // 'colno' column
                   }
                   stack_trace+=row;
           }
   frame.store_param(*new VTable(&stack_trace));
   
                                                         // source  // future $response:body=
                                                         Value *source_value=0;  //   execute ^unhandled_exception[exception;stack]
                                                         if(problem_source && problem_source->size()) {  body_string=&execute_method(frame, *method).as_string();
                                                                 String& problem_source_copy=*NEW String(pool());                                          }
                                                                 problem_source_copy.append(*problem_source,                                   }
                                                                         flang, true);  
                                                                 source_value=NEW VString(problem_source_copy);  
                                                         }  
                                                         frame.store_param(method->name,   
                                                                 source_value?source_value:NEW VVoid(pool()));  
   
                                                         // comment  
                                                         String *comment_value=NEW String(pool(),  
                                                                 e.comment(), 0, true);  
                                                         frame.store_param(method->name,   
                                                                 NEW VString(*comment_value));  
   
                                                         // type  
                                                         Value *type_value;  
                                                         if(e.type()) {  
                                                                 String& type_copy=*NEW String(pool());  
                                                                 type_value=NEW VString(type_copy.append(*e.type(),   
                                                                         flang, true));  
                                                         } else  
                                                                 type_value=NEW VVoid(pool());  
                                                         frame.store_param(method->name, type_value);  
   
                                                         // code  
                                                         Value *code_value;  
                                                         if(e.code()) {  
                                                                 String& code_copy=*NEW String(pool());  
                                                                 code_value=NEW VString(code_copy.append(*e.code(),   
                                                                         flang, true));  
                                                         } else  
                                                                 code_value=NEW VVoid(pool());  
                                                         frame.store_param(method->name, code_value);  
   
                                                         // $stack[^table::set{name      origin}]  
                                                         Array& stack_trace_columns=*NEW Array(pool());  
                                                         stack_trace_columns+=NEW String(pool(), "name");  
                                                         stack_trace_columns+=NEW String(pool(), "origin");  
                                                         Table& stack_trace=*NEW Table(pool(), 0, &stack_trace_columns);  
                                                         Array_iter tracei(trace);  
                                                         while(tracei.has_next()) {  
                                                                 Array& row=*NEW Array(pool());  
   
                                                                 const String *name=(const String *)tracei.next();  
                                                                 row+=name; // name column  
 #ifndef NO_STRING_ORIGIN  
                                                                 const Origin& origin=name->origin();  
                                                                 if(origin.file) {  
                                                                         char *buf=(char *)malloc(MAX_STRING);  
                                                                         size_t buf_size=snprintf(buf, MAX_STRING, ORIGIN_FILE_LINE_FORMAT,   
                                                                                 origin.file, 1+origin.line);  
                                                                         row+=NEW String(pool(), buf, buf_size, true); // origin column  
                                                                 }  
 #endif  
                                                                 stack_trace+=&row;  
                                                         }  
                                                         frame.store_param(method->name,   
                                                                 NEW VTable(pool(), &stack_trace));  
   
                                                         // future $response:body=  
                                                         //   execute ^exception[origin;source;comment;type;code;stack]  
                                                         body_string=execute_method(frame, *method);  
                                                 }  
                         }                          }
                                                   
                         if(!body_string) {  // couldn't report an error beautifully?                          if(!body_string) {  // couldn't report an error beautifully?
                                 // doing that ugly                                  // doing that ugly
   
                                 // make up result: $origin $source $comment $type $code                                  // make up result: $origin $source $comment $type $code
                                 char *buf=(char *)malloc(MAX_STRING);                                  char *buf=new(PointerFreeGC) char[MAX_STRING];
                                 size_t printed=0;                                  size_t printed=0;
                                 const String *problem_source=e.problem_source();                                  if(const String* problem_source=e.problem_source()) {
                                 if(problem_source) {                                          /*const String_fragment::Origin& origin=problem_source->origin();
 #ifndef NO_STRING_ORIGIN  
                                         const Origin& origin=problem_source->origin();  
                                         if(origin.file)                                          if(origin.file)
                                                 printed+=snprintf(buf+printed, MAX_STRING-printed,                                                   printed+=snprintf(buf+printed, MAX_STRING-printed, 
                                                         ORIGIN_FILE_LINE_FORMAT": ",                                                           PA_ORIGIN_FILE_POS_FORMAT, 
                                                         origin.file, 1+origin.line                                                          origin.file, 1+origin.line
                                                 );                                                  );
 #endif  
                                         printed+=snprintf(buf+printed, MAX_STRING-printed, "'%s' ",                                           printed+=snprintf(buf+printed, MAX_STRING-printed, "'%s' ", 
                                                 problem_source->cstr());                                                  problem_source->cstr().get());
                                 }                                                  */
                                 printed+=snprintf(buf+printed, MAX_STRING-printed, "%s",   
                                         e.comment());  
                                 const String *type=e.type();  
                                 if(type) {  
                                         printed+=snprintf(buf+printed, MAX_STRING-printed, "  type: %s",   
                                                 type->cstr());  
                                         const String *code=e.code();  
                                         if(code)  
                                                 printed+=snprintf(buf+printed, MAX_STRING-printed, ", code: %s",   
                                                 code->cstr());  
                                 }                                  }
                                   if(const char* comment=e.comment(true))
                                           printed+=snprintf(buf+printed, MAX_STRING-printed, "%s", comment);
                                   if(const char* type=e.type(true)) 
                                           printed+=snprintf(buf+printed, MAX_STRING-printed, "  type: %s",  type);
   
                                 // future $response:content-type                                  // future $response:content-type
                                 response.fields().put(*content_type_name,                                   response.fields().put(content_type_name, 
                                         NEW VString(*NEW String(pool(), UNHANDLED_EXCEPTION_CONTENT_TYPE)));                                          new VString(*new String(UNHANDLED_EXCEPTION_CONTENT_TYPE)));
                                 // future $response:body                                  // future $response:body
                                 body_string=NEW String(pool(), buf);                                  body_string=new String(buf);
                         }                          }
   
                         VString body_vstring(*body_string);                          VString body_vstring(*body_string);
                         const VFile *body_file=body_vstring.as_vfile();                          VFile* body_file=body_vstring.as_vfile(String::L_UNSPECIFIED, &charsets);
   
                         // ERROR. write it out                          // ERROR. write it out
                         output_result(*body_file, header_only);                          output_result(body_file, header_only, false);
                 } catch(const Exception& ) {  //              } catch(const Exception& ) {
                         /*re*/throw;  //                      rethrow;
                 }  //              }
         }          }
 }  }
   
 VStateless_class *Request::use_file(const String& file_name,   size_t Request::register_file(String::Body file_spec) {
                                                                         bool ignore_class_path, bool fail_on_read_problem,          file_list+=file_spec;
                                                                         const String *name,           return file_list.count()-1;
                                                                         VStateless_class *base_class) {  }
   
   void Request::use_file(VStateless_class& aclass,
                          const String& file_name, const String* main_alias, 
                          bool ignore_class_path, 
                          bool fail_on_read_problem, 
                          bool fail_on_file_absence) {
         // cyclic dependence check          // cyclic dependence check
         if(used_files.get(file_name))          if(used_files.get(file_name))
                 return base_class;                  return;
         used_files.put(file_name, (Hash::Val *)true);          used_files.put(file_name, true);
   
         const String *file_spec;          const String* file_spec;
         if(ignore_class_path) // ignore_class_path?          if(ignore_class_path) // ignore_class_path?
                 file_spec=&file_name;                  file_spec=&file_name;
         else if(file_name.first_char()=='/') //absolute path, no need to scan MAIN:CLASS_PATH?          else if(file_name.first_char()=='/') //absolute path? [no need to scan MAIN:CLASS_PATH]
                 file_spec=&absolute(file_name);                  file_spec=&absolute(file_name);
         else {          else {
                 file_spec=0;                  file_spec=0;
                 if(main_class)                  if(Value* element=main_class.get_element(class_path_name, main_class, false)) {
                         if(Value *element=main_class->get_element(*class_path_name)) {                          if(element->is_string()) {
                                 if(element->is_string()) {                                  file_spec=file_readable(absolute(element->as_string()), file_name); // found at class_path?
                                         file_spec=file_readable(element->as_string(), file_name); // found at class_path?                          } else if(Table *table=element->get_table()) {
                                 } else if(Table *table=element->get_table()) {                                  int size=table->count();
                                         int size=table->size();                                  for(int i=size; i--; ) {
                                         for(int i=size; i--; ) {                                          const String& path=*(*table->get(i))[0];
                                                 const String& path=*static_cast<Array *>(table->get(i))->get_string(0);                                          if(file_spec=file_readable(absolute(path), file_name))
                                                 if(file_spec=file_readable(path, file_name))                                                  break; // found along class_path
                                                         break; // found along class_path                                  }
                                         }                          } else
                                 } else                                  throw Exception("parser.runtime",
                                         throw Exception(0, 0,                                          0,
                                                 &element->name(),                                          "$" CLASS_PATH_NAME " must be string or table");
                                                 "must be string or table");                          if(!file_spec)
                                 if(!file_spec)                                  throw Exception("parser.runtime",
                                         throw Exception(0, 0,                                          &file_name,
                                                 &file_name,                                          "not found along " MAIN_CLASS_NAME ":" CLASS_PATH_NAME);
                                                 "not found along " MAIN_CLASS_NAME ":" CLASS_PATH_NAME);                  }
                         }  
                 if(!file_spec)                  if(!file_spec)
                         throw Exception(0, 0,                          throw Exception("parser.runtime",
                                 &file_name,                                  &file_name,
                                 "usage failed - no " MAIN_CLASS_NAME  ":" CLASS_PATH_NAME " were specified");                                  "usage failed - no $" MAIN_CLASS_NAME  ":" CLASS_PATH_NAME " were specified");
         }          }
   
         char *source=file_read_text(pool(), *file_spec, fail_on_read_problem);          if(fail_on_read_problem && !fail_on_file_absence) // ignore file absence if asked for
         if(!source)                  if(!entry_exists(*file_spec))
                 return base_class;                          return;
   
         return use_buf(source, file_spec->cstr(), 0/*new class*/, name, base_class);          if(const char* source=file_read_text(charsets, *file_spec, fail_on_read_problem))
                   use_buf(aclass, source, main_alias, register_file(*file_spec));
 }  }
   
 VStateless_class *Request::use_buf(const char *source, const char *file,  
                                                                    VStateless_class *aclass, const String *name,   void Request::use_buf(VStateless_class& aclass,
                                                                    VStateless_class *base_class) {                        const char* source, const String* main_alias, 
                         uint file_no) {
           // temporary zero @conf so to maybe-replace it in compiled code
           Temp_method temp_method_conf(aclass, conf_method_name, 0);
           // temporary zero @auto so to maybe-replace it in compiled code
           Temp_method temp_method_auto(aclass, auto_method_name, 0);
   
         // compile loaded class          // compile loaded class
         VStateless_class& cclass=COMPILE(source, aclass, name, base_class, file);          VStateless_class& cclass=compile(&aclass, source, main_alias, file_no);
   
         // locate and execute possible @auto[] static method          // locate and execute possible @conf[] static
         execute_nonvirtual_method(cclass, *auto_method_name, false /*no result needed*/);          VString* vfilespec=
         return &cclass;                  new VString(*new String(file_list[file_no], String::L_TAINTED));
 }          Execute_nonvirtual_method_result executed=execute_nonvirtual_method(cclass, 
                   conf_method_name, vfilespec,
 const String& Request::relative(const char *apath, const String& relative_name) {                  false/*no string result needed*/);
         int lpath_buf_size=strlen(apath)+1;          if(executed.method)
     char *lpath=(char *)malloc(lpath_buf_size);                  configure_admin(cclass/*, executed.method->name*/);
         memcpy(lpath, apath, lpath_buf_size);  
     if(!rsplit(lpath, '/'))          // locate and execute possible @auto[] static
                 strcpy(lpath, ".");          execute_nonvirtual_method(cclass, 
         String& result=*NEW String(pool(), lpath);                  auto_method_name, vfilespec,
     result << "/" << relative_name;                  false/*no result needed*/);
     return result;  }
   
   const String& Request::relative(const char* apath, const String& relative_name) {
           char *hpath=strdup(apath);
           String& result=*new String;
           if(rsplit(hpath, '/')) // if something/splitted
                   result << hpath << "/";
           result << relative_name;
           return result;
 }  }
   
 const String& Request::absolute(const String& relative_name) {  const String& Request::absolute(const String& relative_name) {
         char *relative_name_cstr=relative_name.cstr();          if(relative_name.first_char()=='/') {
         if(relative_name_cstr[0]=='/') {                  String& result=*new String(strdup(request_info.document_root));
                 String& result=*NEW String(pool(), info.document_root);  
                 result << relative_name;                  result << relative_name;
                 return result;                  return result;
         } else           } else 
                 return relative(info.path_translated, relative_name);                  if(relative_name.pos("://")!=STRING_NOT_FOUND // something like "http://xxx"
 }  #ifdef WIN32
                           || relative_name.pos(":")==1  // DRIVE:
 static void add_header_attribute(const Hash::Key& aattribute, Hash::Val *ameaning,                           || relative_name.starts_with("\\\\") // UNC1
                                                                  void *info) {                          || relative_name.starts_with("//") // UNC2
         Request& r=*static_cast<Request *>(info);  #endif
                           )
                           return relative_name;
                   else
                           return relative(request_info.path_translated, relative_name);
   }
   
   static void add_header_attribute(
                                    HashStringValue::key_type aattribute, 
                                    HashStringValue::value_type ameaning, 
                                    Request *r) {
         if(aattribute==BODY_NAME          if(aattribute==BODY_NAME
                   || aattribute==DOWNLOAD_NAME
                 || aattribute==CHARSET_NAME)                  || aattribute==CHARSET_NAME)
                 return;                  return;
   
         Value& lmeaning=*static_cast<Value *>(ameaning);          SAPI::add_header_attribute(r->sapi_info,
         Pool& pool=lmeaning.pool();  
   
         SAPI::add_header_attribute(pool,  
                 aattribute.cstr(),                   aattribute.cstr(), 
                 attributed_meaning_to_string(lmeaning, String::UL_HTTP_HEADER).cstr());                  attributed_meaning_to_string(*ameaning, String::L_HTTP_HEADER, false).
                           cstr(String::L_UNSPECIFIED));
 }  }
 void Request::output_result(const VFile& body_file, bool header_only) {  void Request::output_result(VFile* body_file, bool header_only, bool as_attachment) {
         // header: cookies          // header: cookies
         cookie.output_result();          cookie.output_result(sapi_info);
                   
           Value* body_file_content_type;
         // set content-type          // set content-type
         if(String *body_file_content_type=static_cast<String *>(          if(body_file_content_type=body_file->fields().get(content_type_name)) {
                 body_file.fields().get(*vfile_mime_type_name))) {  
                 // body file content type                  // body file content type
                 response.fields().put(*content_type_name, body_file_content_type);                  response.fields().put(content_type_name, body_file_content_type);
         } else {          } else {
                 // default content type                  // default content type
                 response.fields().put_dont_replace(*content_type_name,                   response.fields().put_dont_replace(content_type_name, 
                         default_content_type?default_content_type                          new VString(*new String(DEFAULT_CONTENT_TYPE)));
                         :NEW VString(*NEW String(pool(), DEFAULT_CONTENT_TYPE)));  
         }          }
   
         // content-disposition          // content-disposition
         if(VString *vfile_name=static_cast<VString *>(body_file.fields().get(*name_name)))          if(Value* vfile_name=body_file->fields().get(name_name))
                 if(vfile_name->string()!=NONAME_DAT) {                  if(*vfile_name->get_string()!=NONAME_DAT) {
                         VHash& vhash=*NEW VHash(pool());                          VHash& hash=*new VHash();
                         vhash.hash(0).put(*content_disposition_filename_name, vfile_name);                          HashStringValue &h=hash.hash();
                         response.fields().put(*content_disposition_name, &vhash);                          if(as_attachment)
                                   h.put(value_name, new VString(content_disposition_value));
                           h.put(content_disposition_filename_name, vfile_name);
                           response.fields().put(content_disposition_name, &hash);
                 }                  }
   
         // prepare header: $response:fields without :body          // prepare header: $response:fields without :body
         response.fields().for_each(add_header_attribute, this);          response.fields().for_each(add_header_attribute, this);
   
         // source bytes+transcoder          // transcode text body when "text/*" or simple result
         const Transcoder *source_transcoder=transcoder();          if(body_file_content_type)
         const void *source_body=body_file.value_ptr();                  if(HashStringValue *hash=body_file_content_type->get_hash())
         size_t source_content_length=body_file.value_size();                          body_file_content_type=hash->get(value_name);
           String::C output(body_file->value_ptr(), body_file->value_size());
         // client bytes+transcoder          if(!body_file_content_type/*vstring.as_vfile*/ || body_file_content_type->as_string().pos("text/")==0)
         Transcoder *client_transcoder;                  output=Charset::transcode(output, 
         Value *vclient_charset=static_cast<Value *>(response.fields().get(*charset_name));                          charsets.source(), 
         client_transcoder=vclient_charset?(Transcoder *)CTYPE.get(vclient_charset->as_string()):0;                          charsets.client());
         const void *client_body;  
         size_t client_content_length;  
   
         // transcode  
         transcoder_transcode(pool(),  
                 source_transcoder, source_body, source_content_length,  
                 client_transcoder, client_body, client_content_length  
         );  
   
         // prepare header: content-length          // prepare header: content-length
         if(client_content_length) { // useful for redirecting [header "location: http://..."]          char content_length_cstr[MAX_NUMBER];
                 char content_length_cstr[MAX_NUMBER];          snprintf(content_length_cstr, MAX_NUMBER, "%u", output.length);
                 snprintf(content_length_cstr, MAX_NUMBER, "%u", client_content_length);          SAPI::add_header_attribute(sapi_info, "content-length", content_length_cstr);
                 SAPI::add_header_attribute(pool(), "content-length", content_length_cstr);  
         }  
   
         // send header          // send header
         SAPI::send_header(pool());          SAPI::send_header(sapi_info);
                   
         // send body          // send body
         if(!header_only)          if(!header_only)
                 SAPI::send_body(pool(), client_body, client_content_length);                  SAPI::send_body(sapi_info, output.str, output.length);
 }  }
   
 const String& Request::mime_type_of(const char *user_file_name_cstr) {  const String& Request::mime_type_of(const char* user_file_name_cstr) {
         if(mime_types)          if(mime_types)
                 if(const char *cext=strrchr(user_file_name_cstr, '.')) {                  if(const char* cext=strrchr(user_file_name_cstr, '.')) {
                         String sext(pool(), ++cext);                          String sext(++cext);
                         if(mime_types->locate(0, sext))                          Table::Action_options options;
                                 if(const String *result=mime_types->item(1))                          if(mime_types->locate(0, sext.change_case(charsets.source(), String::CC_LOWER), options))
                                         return *result;                                          if(const String* result=mime_types->item(1))
                                                   return *result;
                                 else                                  else
                                         throw Exception(0, 0,                                          throw Exception("parser.runtime",
                                                 mime_types->origin_string(),                                                  0,
                                                 "MIME-TYPE table column elements must not be empty");                                                  MIME_TYPES_NAME  " table column elements must not be empty");
                 }                  }
         return *NEW String(pool(), "application/octet-stream");  
           return *new String("application/octet-stream");
   }
   
   #ifdef XML
   GdomeDOMString_auto_ptr Request::transcode(const String& s) {
           return charsets.source().transcode(s);
 }  }
   
 const Transcoder* Request::transcoder() {  GdomeDOMString_auto_ptr Request::transcode(const String::Body s) {
         return (Transcoder *)CTYPE.get(pool().get_charset());          return charsets.source().transcode(s);
 }  }
   
 const unsigned char *Request::pcre_tables() {  const String& Request::transcode(GdomeDOMString* s) {
         if(const Transcoder *ltranscoder=transcoder())          return charsets.source().transcode(s);
                 return ltranscoder->pcre_tables;  }
   
   const String& Request::transcode(xmlChar* s) {
           return charsets.source().transcode(s);
   }
   #endif
   
   
   const Request::Trace Request::Exception_trace::extract_origin(const String*& problem_source) {
           Trace result;
           if(!is_empty()) {
                   result=bottom_value();
                   if(!problem_source) { // we don't know who trigged the bug?
                           problem_source=result.name(); // consider the stack-top-guy did that
                           fbottom++;
                   } else if(result.name()==problem_source) // it is that same guy?
                           fbottom++; // throw away that trace
                   // else stack top contains not us, 
                   //      leaving result intact
                   //      it would help ^throw
           }
   
           return result;
   }
   
   Request::Exception_details Request::get_details(const Exception& e) {
           const String* problem_source=e.problem_source();
           Trace trace=exception_trace.extract_origin(problem_source);
           
           VHash& vhash=*new VHash;  HashStringValue& hash=vhash.hash();
   
           // $.type
           if(const char* type=e.type(true))
                   hash.put(exception_type_part_name, new VString(*new String(type)));
   
           // $.source
           if(problem_source) {
                   String& source=*new String; 
                   source.append(*problem_source, String::L_TAINTED, true/*forced*/);
   
                   hash.put(exception_source_part_name, new VString(source));
           }
   
           // $.file lineno colno
           if(trace) {
                   const Operation::Origin origin=trace.origin();
                   hash.put(String::Body("file"),
                           new VString(*new String(file_list[origin.file_no], String::L_TAINTED)));
                   hash.put(String::Body("lineno"), new VInt(1+origin.line));
                   hash.put(String::Body("colno"), new VInt(1+origin.col));
           }
   
           // $.comment
           if(const char* comment=e.comment(true))
                   hash.put(exception_comment_part_name, 
                           new VString(*new String(comment, 0, true/*tainted*/)));
   
           // $.handled(0)
           hash.put(exception_handled_part_name, new VBool(false));
   
         // this is not for pcre itself,           return Request::Exception_details(trace, problem_source, vhash);
         // it can do default, it's for string.lower&co  
         return pcre_default_tables;  
 }  }
Removed from v.1.184  
changed lines
  Added in v.1.252

E-mail: