Diff for /parser3/src/classes/file.C between versions 1.107.2.16.2.3 and 1.299

version 1.107.2.16.2.3, 2003/03/20 08:11:12 version 1.299, 2026/04/25 13:38:46
Line 1 Line 1
 /** @file  /** @file
         Parser: @b file parser class.          Parser: @b file parser class.
   
         Copyright (c) 2001-2003 ArtLebedev Group (http://www.artlebedev.com)          Copyright (c) 2001-2026 Art. Lebedev Studio (https://www.artlebedev.com)
         Author: Alexandr Petrosian <paf@design.ru> (http://paf.design.ru)          Authors: Konstantin Morshnev <moko@design.ru>, Alexandr Petrosian <paf@design.ru>
 */  */
   
 static const char* IDENT_FILE_C="$Date$";  
   
 #include "pa_config_includes.h"  #include "pa_config_includes.h"
   
 #include "pcre.h"  
   
 #include "classes.h"  #include "classes.h"
 #include "pa_vmethod_frame.h"  #include "pa_vmethod_frame.h"
   #include "pa_base64.h"
   
 #include "pa_request.h"  #include "pa_request.h"
 #include "pa_vfile.h"  #include "pa_vfile.h"
Line 22  static const char* IDENT_FILE_C="$Date$" Line 19  static const char* IDENT_FILE_C="$Date$"
 #include "pa_vdate.h"  #include "pa_vdate.h"
 #include "pa_dir.h"  #include "pa_dir.h"
 #include "pa_vtable.h"  #include "pa_vtable.h"
   #include "pa_varray.h"
 #include "pa_charset.h"  #include "pa_charset.h"
   #include "pa_charsets.h"
   #include "pa_sql_connection.h"
   #include "pa_md5.h"
   #include "pa_vregex.h"
   #include "pa_version.h"
   
   volatile const char * IDENT_FILE_C="$Id$";
   
 // defines  // defines
   
 #define TEXT_MODE_NAME "text"  
 #define STDIN_EXEC_PARAM_NAME "stdin"  #define STDIN_EXEC_PARAM_NAME "stdin"
   #define CHARSET_EXEC_PARAM_NAME "charset"
   
   #define NAME_NAME "name"
   #define MODE_APPEND "append"
   #define KEEP_EMPTY_DIRS_NAME "keep-empty-dirs"
   #define SUPPRESS_EXCEPTION_NAME "exception"
   
   // externs
   
   extern String sql_limit_name;
   extern String sql_offset_name;
   
   // helpers
   
   class File_list_table_template_columns: public ArrayString {
   public:
           File_list_table_template_columns() {
                   *this+=new String("name");
                   *this+=new String("dir");
                   *this+=new String("size");
                   *this+=new String("cdate");
                   *this+=new String("mdate");
                   *this+=new String("adate");
           }
   };
   
   static Table &file_list_table_template(){
           static Table *singleton=NULL;
           if(!singleton)
                   singleton=new Table(new File_list_table_template_columns);
           return *singleton;
   }
   
 // class  // class
   
 class MFile: public Methoded {  class MFile: public Methoded {
 public: // VStateless_class  public: // VStateless_class
                   Value* create_new_value(Pool&) { return new VFile(); }
         ValuePtr create_new_value() { return ValuePtr(new VFile()); }  
   
 public: // Methoded  
         bool used_directly() { return true; }  
   
 public:  public:
         MFile();          MFile();
   
 };  };
   
 // global variable  // global variable
   
 DECLARE_CLASS_VAR(file, new MFile, 0);  DECLARE_CLASS_VAR(file, new MFile);
   
 // consts  // consts
   
Line 96  static const char* suexec_safe_env_lst[] Line 126  static const char* suexec_safe_env_lst[]
   
 // statics  // statics
   
 static const String& adate_name(new String("adate"));  static const String::Body size_name("size");
 static const String& mdate_name(new String("mdate"));  static const String::Body adate_name("adate");
 static const String& cdate_name(new String("cdate"));  static const String::Body mdate_name("mdate");
   static const String::Body cdate_name("cdate");
   
 // methods  // methods
   
 static void _save(Request& r, const String& /*method_name*/, MethodParams* params) {  static void _save(Request& r, MethodParams& params) {
         ValuePtr vmode_name=params-> as_no_junction(0, "mode must not be code");          bool do_append=false;
         ValuePtr vfile_name=params->as_no_junction(1, "file name must not be code");          bool is_text=VFile::is_text_mode(params.as_string(0, MODE_MUST_BE_STRING));
           const String& file_name=params.as_file_name(1);
   
           Charset* asked_charset=0;
           if(params.count()>2)
                   if(HashStringValue* options=params.as_hash(2)){
                           int valid_options=0;
                           if(Value* vcharset_name=options->get(PA_CHARSET_NAME)){
                                   asked_charset=&pa_charsets.get(vcharset_name->as_string());
                                   valid_options++;
                           }
                           if(Value* vappend=options->get(MODE_APPEND)){
                                   do_append=vappend->as_bool();
                                   valid_options++;
                           }
                           if(valid_options != options->count())
                                   throw Exception(PARSER_RUNTIME, 0, CALLED_WITH_INVALID_OPTION);
                   }
   
         // save          // save
         GET_SELF(r, VFile).save(r.absolute(vfile_name->as_string(&pool)),          GET_SELF(r, VFile).save(r.charsets, r.full_disk_path(file_name), is_text, do_append, asked_charset);
                 *vmode_name->as_string(&pool)==TEXT_MODE_NAME);  
 }  }
   
 static void _delete(Request& r, const String& /*method_name*/, MethodParams* params) {  static void _delete(Request& r, MethodParams& params) {
         ValuePtr vfile_name=params->as_no_junction(0, "file name must not be code");          const String& file_name=params.as_file_name(0);
           bool keep_empty_dirs=false;
           bool fail_on_problem=true;
   
           if(params.count()>1)
                   if(HashStringValue* options=params.as_hash(1)){
                           int valid_options=0;
                           if(Value* vkeep_empty_dirs=options->get(KEEP_EMPTY_DIRS_NAME)){
                                   keep_empty_dirs=r.process(*vkeep_empty_dirs).as_bool();
                                   valid_options++;
                           }
                           if(Value* vsuppress_exception=options->get(SUPPRESS_EXCEPTION_NAME)){
                                   fail_on_problem=r.process(*vsuppress_exception).as_bool();
                                   valid_options++;
                           }
                           if(valid_options != options->count())
                                   throw Exception(PARSER_RUNTIME, 0, CALLED_WITH_INVALID_OPTION);
                   }
   
         // unlink          // unlink
         file_delete(r.absolute(vfile_name->as_string(&pool)));          file_delete(r.full_disk_path(file_name), fail_on_problem, keep_empty_dirs);
 }  }
   
 static void _move(Request& r, const String& /*method_name*/, MethodParams* params) {  static void _move(Request& r, MethodParams& params) {
         ValuePtr vfrom_file_name=params->as_no_junction(0, "from file name must not be code");          Value& vfrom_file_name=params.as_no_junction(0, "from file name must not be code");
         ValuePtr vto_file_name=params->as_no_junction(1, "to file name must not be code");          Value& vto_file_name=params.as_no_junction(1, "to file name must not be code");
           bool keep_empty_dirs=false;
   
           if(params.count()>2)
                   if(HashStringValue* options=params.as_hash(2)){
                           int valid_options=0;
                           if(Value* vkeep_empty_dirs=options->get(KEEP_EMPTY_DIRS_NAME)){
                                   keep_empty_dirs=r.process(*vkeep_empty_dirs).as_bool();
                                   valid_options++;
                           }
                           if(valid_options != options->count())
                                   throw Exception(PARSER_RUNTIME, 0, CALLED_WITH_INVALID_OPTION);
                   }
   
         // move          // move
         file_move(          file_move(
                 r.absolute(vfrom_file_name->as_string(&pool)),                  r.full_disk_path(vfrom_file_name.as_string()),
                 r.absolute(vto_file_name->as_string(&pool)));                  r.full_disk_path(vto_file_name.as_string()),
                   keep_empty_dirs);
   }
   
   static void copy_process_source(struct stat&, int from_file, const String&, void *context) {
           int& to_file=*static_cast<int *>(context);
   
           int nCount=0;
           do {
                   unsigned char buffer[FILE_BUFFER_SIZE];
                   nCount = file_block_read(from_file, buffer, sizeof(buffer));
                   int written=write(to_file, buffer, nCount); 
                   if( written < 0 )
                           throw Exception("file.write", 0, "write failed: %s (%d)", strerror(errno), errno);
                   
           } while(nCount > 0);
   }
   
   static void copy_open_target(int f, void *from_spec) {
           String& file_spec=*static_cast<String *>(from_spec);
           file_read_action_under_lock(file_spec, "copy", copy_process_source, &f);
   }
   
   static void _copy(Request& r, MethodParams& params) {
           Value& vfrom_file_name=params.as_no_junction(0, "from file name must not be code");
           Value& vto_file_name=params.as_no_junction(1, "to file name must not be code");
   
           bool append=false;
           if(params.count()>2)
                   if(HashStringValue* options=params.as_hash(2)){
                           int valid_options=0;
                           if(Value* vappend=options->get(MODE_APPEND)){
                                   append=r.process(*vappend).as_bool();
                                   valid_options++;
                           }
                           if(valid_options != options->count())
                                   throw Exception(PARSER_RUNTIME, 0, CALLED_WITH_INVALID_OPTION);
                   }
   
           String from_spec = r.full_disk_path(vfrom_file_name.as_string());
           const String& to_spec = r.full_disk_path(vto_file_name.as_string());
           
           file_write_action_under_lock(
                           to_spec,
                           "copy",
                           copy_open_target,
                           &from_spec,
                           false /*as text*/,
                           append);
 }  }
   
 static void _load_pass_param(  static void _load_pass_param(
                                                          HashStringValue::key_type key,                                   HashStringValue::key_type key, 
                                                          HashStringValue::value_type value,                                   HashStringValue::value_type value, 
                                                          HashStringValue *dest) {                                  HashStringValue *dest) {
         dest->put(key, value);          dest->put(key, value);
 }  }
 static void _load(Request& r, const String& method_name, MethodParams* params) {  
         ValuePtr vmode_name=params-> as_no_junction(0, "mode must not be code");  
         const String& lfile_name=r.absolute(params->as_no_junction(1, "file name must not be code")->as_string(&pool));  
         ValuePtr third_param=params->count()>2?params->as_no_junction(2, "filename or options must not be code")  
                 :ValuePtr(0);  
         HashStringValue* third_param_hash=third_param?third_param->get_hash(method_name):0;  
         int alt_filename_param_index=2;  
         if(third_param_hash)  
                 alt_filename_param_index++;  
   
         File_read_result file=file_read(r.charsets.source(), lfile_name,  
                 *vmode_name->as_string(&pool)==TEXT_MODE_NAME,  
                 third_param_hash  
         );  
   
         char *user_file_name=params->count()>alt_filename_param_index?  static void _load(Request& r, MethodParams& params) {
                 params->as_string(alt_filename_param_index, "filename must be string")->cstr()          bool as_text=VFile::is_text_mode(params.as_string(0, MODE_MUST_BE_STRING));
                 :lfile_name->cstr(String::UL_FILE_SPEC);          const String& lfile_name=r.full_disk_path(params.as_file_name(1));
   
         ValuePtr vcontent_type(0);          size_t param_index=params.count()-1;
         if(file.headers)          Value* param_value=param_index>1?&params.as_no_junction(param_index, "file name or options must not be code"):0;
                 vcontent_type=file.headers->get(content_type_name);  
         if(!vcontent_type)          HashStringValue* options=0;
                 vcontent_type=ValuePtr(new VString(r.mime_type_of(user_file_name)));          const String* user_file_name=0;
           
           if(param_value){
                   options=param_value->get_hash();
                   if(options || param_index>2)
                           param_index--;
                   if(param_index>1){
                           const String& luser_file_name=params.as_string(param_index, FILE_NAME_MUST_BE_STRING);
                           if(!luser_file_name.is_empty())
                                   user_file_name=&luser_file_name;
                   }
           }
           if(!user_file_name)
                   user_file_name=&lfile_name;
   
           File_read_result file=file_load(r, lfile_name, as_text, options, true);
   
           Value* vcontent_type=0;
           if(file.headers){
                   if(Value* remote_content_type=file.headers->get(HTTP_CONTENT_TYPE_UPPER))
                           vcontent_type=new VString(*new String(remote_content_type->as_string().cstr()));
           } 
   
         VFile& self=GET_SELF(r, VFile);          VFile& self=GET_SELF(r, VFile);
         self.set(true/*tainted*/, file.data, file.size, user_file_name, vcontent_type);          self.set(true/*tainted*/, as_text, file.str, file.length, user_file_name, vcontent_type, &r);
         if(file.headers)  
                 file.headers->for_each(_load_pass_param, &self.fields());          if(file.headers){
                   file.headers->for_each<HashStringValue*>(_load_pass_param, &self.fields());
           } else {
                   uint64_t size;
                   time_t atime, mtime, ctime;
   
                   file_stat(lfile_name, size, atime, mtime, ctime);
           
                   HashStringValue& ff=self.fields();
                   ff.put(adate_name, new VDate((pa_time_t)atime));
                   ff.put(mdate_name, new VDate((pa_time_t)mtime));
                   ff.put(cdate_name, new VDate((pa_time_t)ctime));
           }
 }  }
   
 static void _stat(Request& r, const String& method_name, MethodParams* params) {  static void _create(Request& r, MethodParams& params) {
         ValuePtr vfile_name=params->as_no_junction(0, "file name must not be code");          const String* mode=0;
           const String* file_name=0;
           bool is_text=true;
   
           // new format: ^file::create[string-or-file-content[;$.mode[text|binary] $.name[...] $.content-type[...] $.charset[...] ]]
           size_t content_index=0;
           size_t options_index=1;
           bool extended_options=true;
   
           if(params.count()>=3){
                   // old format: ^file::create[text|binary;file-name;string-or-file-content[;options]] 
                   mode=&params.as_string(0, MODE_MUST_BE_STRING);
                   is_text=VFile::is_text_mode(*mode);
                   file_name=&params.as_string(1, FILE_NAME_MUST_BE_STRING);
                   content_index=2;
                   options_index=3;
                   extended_options=false;
           }
   
         const String& lfile_name=vfile_name->as_string(&pool);          VString* vcontent_type=0;
           Charset* to_charset=0;
           Charset* from_charset=0;
           if(params.count()>options_index)
                   if(HashStringValue* options=params.as_hash(options_index)) {
                           int valid_options=0;
                           if(extended_options) {
                                   if(Value* vmode=options->get(MODE_NAME)) {
                                           mode=&vmode->as_string();
                                           is_text=VFile::is_text_mode(*mode);
                                           valid_options++;
                                   }
                                   if(Value* vfile_name=options->get(NAME_NAME)) {
                                           file_name=&vfile_name->as_string();
                                           valid_options++;
                                   }
                           }
                           if(Value* vcharset_name=options->get("to-charset")) {
                                   to_charset=&pa_charsets.get(vcharset_name->as_string());
                                   valid_options++;
                           }
                           if(Value* vcharset_name=options->get("from-charset")) {
                                   from_charset=&pa_charsets.get(vcharset_name->as_string());
                                   valid_options++;
                           }
                           if(Value* vcharset_name=options->get(PA_CHARSET_NAME)) {
                                   if(to_charset)
                                           throw Exception(PARSER_RUNTIME, 0, "'charset' option cannot be used together with 'to-charset' option");
                                   to_charset=&pa_charsets.get(vcharset_name->as_string());
                                   valid_options++;
                           }
                           if(Value* value=options->get(CONTENT_TYPE_NAME)) {
                                   vcontent_type=new VString(value->as_string());
                                   valid_options++;
                           }
                           if(valid_options != options->count())
                                   throw Exception(PARSER_RUNTIME, 0, CALLED_WITH_INVALID_OPTION);
                   }
   
           Value& vcontent=params.as_no_junction(content_index, "content must be string or file");
   
           VFile& self=GET_SELF(r, VFile);
   
           if(const String* content_str=vcontent.get_string()){
                   String::Body body=content_str->cstr_to_string_body_untaint(String::L_AS_IS, r.connection(false), &r.charsets); // explode content, honor tainting changes
                   self.set(true/*tainted*/, is_text, body.cstrm(), body.length(), file_name, vcontent_type, &r);
           } else {
                   VFile& fcontent=*vcontent.as_vfile(); // can't be null
                   if(mode){
                           self.set(fcontent, &is_text, file_name, vcontent_type, &r);
                           if(is_text && !fcontent.is_text_mode())
                                   from_charset=self.detect_binary_charset(from_charset);
                   } else {
                           self.set(fcontent, 0, file_name, vcontent_type, &r);
                           is_text=fcontent.is_text_mode();
                   }
           }
   
           if(to_charset || from_charset)
                   if(is_text)
                           self.transcode(from_charset ? *from_charset : r.charsets.source(), to_charset ? *to_charset : r.charsets.source());
                   else
                           throw Exception(PARSER_RUNTIME, 0, "charset options cannot be used with binary content");
   }
   
         size_t size;  static void _stat(Request& r, MethodParams& params) {
           const String& lfile_name=params.as_file_name(0);
   
           uint64_t size;
         time_t atime, mtime, ctime;          time_t atime, mtime, ctime;
         file_stat(r.absolute(lfile_name),          file_stat(r.full_disk_path(lfile_name), size, atime, mtime, ctime);
                 size,  
                 atime, mtime, ctime);  
                   
         VFile& self=GET_SELF(r, VFile);          VFile& self=GET_SELF(r, VFile);
         self.set(true/*tainted*/, 0/*no bytes*/, size);  
           self.set_binary(true/*tainted*/, 0 /*no bytes*/, 0 /*fake size*/, &lfile_name, 0, &r);
         HashStringValue& ff=self.fields();          HashStringValue& ff=self.fields();
         ff.put(adate_name, ValuePtr(new VDate(atime)));          ff.put(size_name, new VDouble((double)size) /*real size*/);
         ff.put(mdate_name, ValuePtr(new VDate(mtime)));          ff.put(adate_name, new VDate((pa_time_t)atime));
         ff.put(cdate_name, ValuePtr(new VDate(ctime)));          ff.put(mdate_name, new VDate((pa_time_t)mtime));
         ff.put(content_type_name, ValuePtr(new VString(r.mime_type_of(lfile_name->cstr(String::UL_FILE_SPEC)))));          ff.put(cdate_name, new VDate((pa_time_t)ctime));
 }  }
   
 static bool is_safe_env_key(const char* key) {  static bool is_safe_env_key(const char* key) {
           for(const char* validator=key; *validator; validator++) {
                   char c=*validator;
                   if(!( (c>='A' && c<='Z') || (c>='0' && c<='9') || (c=='_' || c=='-') ))
                           return false;
           }
   #ifdef PA_SAFE_MODE
         if(strncasecmp(key, "HTTP_", 5)==0)          if(strncasecmp(key, "HTTP_", 5)==0)
                 return true;                  return true;
         if(strncasecmp(key, "CGI_", 4)==0)          if(strncasecmp(key, "CGI_", 4)==0)
Line 195  static bool is_safe_env_key(const char* Line 426  static bool is_safe_env_key(const char*
                         return true;                          return true;
         }          }
         return false;          return false;
   #else
           return true;
   #endif
 }  }
 #ifndef DOXYGEN  #ifndef DOXYGEN
 struct Append_env_pair_info {  struct Append_env_pair_info {
         ;          Request_charsets* charsets;
         HashStringString* env;          HashStringString* env;
         ValuePtr vstdin;          Value* vstdin;
 };  };
 #endif  #endif
 static void append_env_pair(  static void append_env_pair(
                                                         HashStringValue::key_type akey,                                   HashStringValue::key_type akey, 
                                                         HashStringValue::value_type avalue,                                   HashStringValue::value_type avalue, 
                                                         Append_env_pair_info *info) {                                  Append_env_pair_info *info) {
         if(*akey==STDIN_EXEC_PARAM_NAME) {          if(akey==STDIN_EXEC_PARAM_NAME) {
                 info->vstdin=avalue;                  info->vstdin=avalue;
           } else if(akey==CHARSET_EXEC_PARAM_NAME) {
                   // ignore, already processed
         } else {          } else {
                 if(!is_safe_env_key(akey->cstr()))                  if(!is_safe_env_key(akey.cstr()))
                         throw Exception("parser.runtime",                          throw Exception(PARSER_RUNTIME,
                                 akey,                                  new String(akey, String::L_TAINTED),
                                 "not safe environment variable");                                  "not safe environment variable");
                 info->env->put(akey, avalue->as_string(info->pool));                  info->env->put(akey, avalue->as_string().cstr_to_string_body_untaint(String::L_AS_IS, 0, info->charsets));
         }          }
 }  }
 #ifndef DOXYGEN  #ifndef DOXYGEN
 struct Pass_cgi_header_attribute_info {  struct Pass_cgi_header_attribute_info {
         ;  
         Charset* charset;          Charset* charset;
         HashStringValue* fields;          HashStringValue* fields;
         ValuePtr content_type;          Value* content_type;
 };  };
 #endif  #endif
 static void pass_cgi_header_attribute(  static void pass_cgi_header_attribute(
                                                                           ArrayString::element_type astring,                                           ArrayString::element_type astring, 
                                                                           Pass_cgi_header_attribute_info* info) {                                          Pass_cgi_header_attribute_info* info) {
         int colon_pos=astring->pos(":", 1);          size_t colon_pos=astring->pos(':');
         if(colon_pos>0) {          if(colon_pos!=STRING_NOT_FOUND) {
                 const String& key(astring->mid(0, colon_pos)->change_case(                  const String& key=astring->mid(0, colon_pos).change_case(
                         *info->*info->charset, String::CC_UPPER));                          *info->charset, String::CC_UPPER);
                 ValuePtr value(new VString(astring->mid(colon_pos+1, astring->size())));                  Value* value=new VString(astring->mid(colon_pos+1, astring->length()).trim());
                 info->fields->put(key, value);                  info->fields->put(key, value);
                 if(*key=="CONTENT-TYPE")                  if(key==HTTP_CONTENT_TYPE_UPPER)
                         info->content_type=value;                          info->content_type=value;
         }          }
 }  }
   
   static void append_to_argv(Request& r, ArrayString& argv, const String* str){
           argv+=new String(str->cstr_to_string_body_untaint(String::L_AS_IS, r.connection(false), &r.charsets), String::L_AS_IS);
   }
   
 /// @todo fix `` in perl - they produced flipping consoles and no output to perl  /// @todo fix `` in perl - they produced flipping consoles and no output to perl
 static void _exec_cgi(Request& r, const String& method_name, MethodParams* params,  static void _exec_cgi(Request& r, MethodParams& params, bool cgi) {
                                           bool cgi) {          bool is_text=true;
           size_t param_index=0;
           const String& mode=params.as_string(0, "mode must be string");
           if(VFile::is_valid_mode(mode)) {
                   is_text=VFile::is_text_mode(mode);
                   param_index++;
           }
   
         ValuePtr vfile_name=params->as_no_junction(0, "file name must not be code");          if(param_index>=params.count())
                   throw Exception(PARSER_RUNTIME, 0, FILE_NAME_MUST_BE_SPECIFIED);
   
         const String& script_name=r.absolute(vfile_name->as_string(&pool));          const String& script_name=r.full_disk_path(params.as_file_name(param_index++));
   
         HashStringString env;          HashStringString env;
         #define ECSTR(name, value_cstr) \          #define ECSTR(name, value_cstr) if(value_cstr) env.put(#name, String::Body(value_cstr));
                 if(value_cstr) \          // passing environment
                         env.put( \          for(SAPI::Env::Iterator i(r.sapi_info); i; i.next() )
                                 String* (new String(#name)), \                  env.put(i.key(), String::Body(i.value()) );
                                 String* (new String(value_cstr))); \  
         // passing SAPI::environment  
         if(const char* const *pairs=SAPI::environment(r.sapi_info, pool)) {  
                 while(const char* pair=*pairs++)  
                         if(const char* eq_at=strchr(pair, '='))  
                                 env.put(  
                                         String* (new String(pair, eq_at-pair)),  
                                         String* (new String(eq_at+1)));  
         }  
   
         // const          // const
         ECSTR(GATEWAY_INTERFACE, "CGI/1.1");          ECSTR(GATEWAY_INTERFACE, "CGI/1.1");
           ECSTR(PARSER_VERSION, PARSER_VERSION);
         // from Request.info          // from Request.info
         ECSTR(DOCUMENT_ROOT, r.request_info.document_root);          ECSTR(DOCUMENT_ROOT, r.request_info.document_root);
         ECSTR(PATH_TRANSLATED, r.request_info.path_translated);          ECSTR(PATH_TRANSLATED, r.request_info.path_translated);
Line 270  static void _exec_cgi(Request& r, const Line 509  static void _exec_cgi(Request& r, const
         ECSTR(QUERY_STRING, r.request_info.query_string);          ECSTR(QUERY_STRING, r.request_info.query_string);
         ECSTR(REQUEST_URI, r.request_info.uri);          ECSTR(REQUEST_URI, r.request_info.uri);
         ECSTR(CONTENT_TYPE, r.request_info.content_type);          ECSTR(CONTENT_TYPE, r.request_info.content_type);
         char content_length_cstr[MAX_NUMBER];            ECSTR(CONTENT_LENGTH, pa_uitoa(r.request_info.content_length));
         snprintf(content_length_cstr, MAX_NUMBER, "%u", r.request_info.content_length);  
         //String content_length(content_length_cstr);  
         ECSTR(CONTENT_LENGTH, content_length_cstr);  
         // SCRIPT_*          // SCRIPT_*
         env.put(String* (new String("SCRIPT_NAME")), script_name);          env.put("SCRIPT_NAME", script_name);
         //env.put(*new String("SCRIPT_FILENAME"), ??&script_name);  
   
         bool stdin_specified=false;  
         // environment & stdin from param          // environment & stdin from param
         String in;          bool in_is_text_mode=true;
         if(params->count()>1) {          String::C in;
                 ValuePtr venv=params->as_no_junction(1, "env must not be code");          Charset *charset=0; // default script works raw_in 'source' charset = no transcoding needed
                 if(HashStringValue* user_env=venv->get_hash(method_name)) {          if(param_index < params.count()) {
                         Append_env_pair_info info;                  if(HashStringValue* user_env=params.as_hash(param_index++, "env")) {
                         info.pool=&pool;                          // $.charset  [previewing to handle URI pieces]
                         info.env=&env;                          if(Value* vcharset=user_env->get(CHARSET_EXEC_PARAM_NAME))
                         user_env->for_each(append_env_pair, &info);                                  charset=&pa_charsets.get(vcharset->as_string());
   
                           // $.others
                           Append_env_pair_info info={&r.charsets, &env, 0};
                           {
                                   // influence tainting
                                   // main target -- $.QUERY_STRING -- URLencoding of tainted pieces to String::L_URI lang
                                   Temp_client_charset temp(r.charsets, charset? *charset: r.charsets.source());
                                   user_env->for_each<Append_env_pair_info*>(append_env_pair, &info);
                           }
                           // $.stdin
                         if(info.vstdin) {                          if(info.vstdin) {
                                 stdin_specified=true;                                  if(const String* sstdin=info.vstdin->get_string()) {
                                 if(const String& sstdin=info.vstdin->get_string(&pool)) {                                          // untaint stdin
                                         in.append(*sstdin, String::UL_CLEAN, true);                                          in = String::C(sstdin->cstr_to_string_body_untaint(String::L_AS_IS, r.connection(false), &r.charsets));
                                 } else                                  } else
                                         if(VFile *vfile=static_cast<VFile *>(info.vstdin->as("file", false)))                                          if(VFile* vfile=dynamic_cast<VFile *>(info.vstdin)){
                                                 in.APPEND_TAINTED((const char* )vfile->value_ptr(), vfile->value_size(),                                                  in = String::C((const char* )vfile->value_ptr(), vfile->value_size());
                                                         "$.stdin[assigned]", 0);                                                  in_is_text_mode = vfile->is_text_mode();
                                         else                                          } else
                                                 throw Exception("parser.runtime",                                                  throw Exception(PARSER_RUNTIME, 0, STDIN_EXEC_PARAM_NAME " parameter must be string or file");
                                                         method_name,  
                                                         STDIN_EXEC_PARAM_NAME " parameter must be string or file");  
                         }                          }
                 }                  }
         }          }
   
         // argv from params          // argv from params
         ArrayString argv;          ArrayString argv;
         if(params->count()>2) {          if(param_index < params.count()) {
                 for(int i=2; i<params->count(); i++)                  // influence tainting 
                         argv+=params->as_string(i, "parameter must be string");                  Temp_client_charset temp(r.charsets, charset? *charset: r.charsets.source());
   
                   for(size_t i=param_index; i<params.count(); i++) {
                           Value& param=params.as_no_junction(i, PARAM_MUST_NOT_BE_CODE);
                           if(const String *string=param.get_string()){
                                   append_to_argv(r, argv, string);
                           } else if(Table* table=param.get_table()){
                                   for(size_t j=0; j<table->count(); j++)
                                           append_to_argv(r, argv, table->get(j)->get(0));
                           } else if(VArray* array=dynamic_cast<VArray*>(&param)){
                                   for(ArrayValue::Iterator i(array->array()); i; i.next()){
                                           if(i.value()){
                                                   const String *string=i.value()->get_string();
                                                   if(!string)
                                                           i.value()->bark("array element is '%s', it does not have string value");
                                                   append_to_argv(r, argv, string);
                                           }
                                   }
                           } else {
                                   throw Exception(PARSER_RUNTIME, 0, "param must be string or table or array of strings");
                           }
                   }
   
                   // remove trailing empty arguments for backward compatibility
                   for(ArrayString::ReverseIterator i(argv); i;){
                           if(i.prev()->is_empty()){ // here for correct i.index()
                                   argv.remove(i.index());
                           } else {
                                   break;
                           }
                   }
         }          }
   
         // passing POST data          // transcode if necessary
         if(!stdin_specified) // if $.stdin[...] not specified           if(charset) {
                 in.APPEND(r.request_info.post_data, r.request_info.post_size, String::UL_CLEAN,                   Charset::transcode(env, r.charsets.source(), *charset);
                         "POST data (passed)", 0);                  Charset::transcode(argv, r.charsets.source(), *charset);
                   if(in_is_text_mode)
                           in=Charset::transcode(in, r.charsets.source(), *charset);
           }
           // @todo 
           // ifdef WIN32 do  OEM->ANSI transcode on some(.cmd?) programs to 
           // match silent conversion in OS
   
         // exec!          // exec!
         PA_exec_result execution=          PA_exec_result execution=pa_exec(false/*forced_allow*/, script_name, &env, argv, in);
                 pa_exec(false/*forced_allow*/, script_name, &env, argv, in);  
           File_read_result *file_out=&execution.out;
           String *real_err=&execution.err;
   
           // transcode err if necessary (@todo: need fix line breaks in err as well )
           if(charset)
                   real_err=&Charset::transcode(*real_err, *charset, r.charsets.source());
   
           if(file_out->length && is_text){
                   fix_line_breaks(file_out->str, file_out->length);
                   // treat output as string
                   String *real_out = new String(file_out->str);
   
                   // transcode out if necessary
                   if(charset)
                           real_out=&Charset::transcode(*real_out, *charset, r.charsets.source());
   
                   // FIXME: unsafe cast
                   file_out->str=const_cast<char *>(real_out->cstr()); // hacking a little
                   file_out->length = real_out->length();
           }
   
         VFile& self=GET_SELF(r, VFile);          VFile& self=GET_SELF(r, VFile);
   
         const String& body=execution.out; // ^file:exec          if(cgi) { // ^file::cgi
         ValuePtr content_type(0);                  const char* eol_marker=0;
         const char* eol_marker=0; size_t eol_marker_size;                  size_t eol_marker_size;
         const String& header(0);  
         if(cgi) { // ^file:cgi  
                 // construct with 'out' body and header                  // construct with 'out' body and header
                 int dos_pos=execution.out->pos("\r\n\r\n", 4);                  size_t dos_pos=(file_out->length)?strpos(file_out->str, "\r\n\r\n"):STRING_NOT_FOUND;
                 int unix_pos=execution.out->pos("\n\n", 2);                  size_t unix_pos=(file_out->length)?strpos(file_out->str, "\n\n"):STRING_NOT_FOUND;
   
                 bool unix_header_break;                  bool unix_header_break;
                 switch((dos_pos >= 0?10:00) + (unix_pos >= 0?01:00)) {                  switch((dos_pos!=STRING_NOT_FOUND?10:00) + (unix_pos!=STRING_NOT_FOUND?01:00)) {
                 case 10: // dos                          case 10: // dos
                         unix_header_break=false;                                  unix_header_break=false;
                         break;                                  break;
                 case 01: // unix                          case 01: // unix
                         unix_header_break=true;                                  unix_header_break=true;
                         break;                                  break;
                 case 11: // dos & unix                          case 11: // dos & unix
                         unix_header_break=unix_pos<dos_pos;                                  unix_header_break=unix_pos<dos_pos;
                         break;                                  break;
                 default: // 00                          default: // 00
                         unix_header_break=false; // calm down, compiler                                  unix_header_break=false; // calm down, compiler
                         throw Exception(0,                                  throw Exception("file.execute",
                                 method_name,                                          0,
                                 "output does not contain CGI header; "                                          "output does not contain CGI header; "
                                 "exit status=%d; stdoutsize=%u; stdout: \"%s\"; stderrsize=%u; stderr: \"%s\"",                                           "exit status=%d; stdoutsize=%u; stdout: \"%s\"; stderrsize=%u; stderr: \"%s\"", 
                                         execution.status,                                                   execution.status, 
                                         (uint)execution.out->size(), execution.out->cstr().get(),                                                  file_out->length, (file_out->length) ? (file_out->str) : "",
                                         (uint)execution.err->size(), execution.err->cstr().get());                                                  real_err->length(), real_err->cstr());
                         break; //never reached                                  break; //never reached
                 }                  }
   
                 int header_break_pos;                  size_t header_break_pos;
                 if(unix_header_break) {                  if(unix_header_break) {
                         header_break_pos=unix_pos;                          header_break_pos=unix_pos;
                         eol_marker="\n"; eol_marker_size=1;                          eol_marker="\n";
                           eol_marker_size=1;
                 } else {                  } else {
                         header_break_pos=dos_pos;                          header_break_pos=dos_pos;
                         eol_marker="\r\n"; eol_marker_size=2;                          eol_marker="\r\n";
                           eol_marker_size=2;
                 }                  }
   
                 header=execution.out->mid(0, header_break_pos);                  file_out->str[header_break_pos] = 0;
                 body=execution.out->mid(header_break_pos+eol_marker_size*2, execution.out->size());                  String *header=new String(file_out->str);
         }                  unsigned long headersize = header_break_pos+eol_marker_size*2;
         // body                  file_out->str += headersize;
         self.set(false/*not tainted*/, body->cstr(), body->size());                  file_out->length -= headersize;
   
         // $fields << header                  // $body
         if(header && eol_marker) {                  self.set(false/*not tainted*/, is_text, file_out->str, file_out->length);
                 ArrayString rows;  
                 header->split(rows, 0, eol_marker, eol_marker_size);                  // $fields << header
                 Pass_cgi_header_attribute_info info;                  if(header) {
                 info.pool=&pool;                          ArrayString rows;
                 info.charset=&r.charsets.source();                          header->split(rows, 0, eol_marker);
                 info.fields=&self.fields();                          Pass_cgi_header_attribute_info info={0, 0, 0};
                 rows.for_each(pass_cgi_header_attribute, &info);                          info.charset=&r.charsets.source();
                 if(info.content_type)                          info.fields=&self.fields();
                         self.fields().put(content_type_name, info.content_type);                          rows.for_each(pass_cgi_header_attribute, &info);
                           if(info.content_type)
                                   self.fields().put(content_type_name, info.content_type);
                   }
           } else { // ^file::exec
                   // $body
                   self.set(false/*not tainted*/, is_text, file_out->str ? file_out->str : pa_strdup("") /*to distinguish from stat-ed file*/, file_out->length);
         }          }
   
         // $status          // $status
         self.fields().put(file_status_name, ValuePtr(new VInt(execution.status)));          self.fields().put(file_status_name, new VInt(execution.status));
                   
         // $stderr          // $stderr
         if(execution.err->size())          if(!real_err->is_empty())
                 self.fields().put(                  self.fields().put("stderr", new VString(*real_err));
                         String* (new String("stderr")),  }
                         ValuePtr(new VString(execution.err)));  static void _exec(Request& r, MethodParams& params) {
 }          _exec_cgi(r, params, false);
 static void _exec(Request& r, const String& method_name, MethodParams* params) {  }
         _exec_cgi(r, method_name, params, false);  static void _cgi(Request& r, MethodParams& params) {
 }          _exec_cgi(r, params, true);
 static void _cgi(Request& r, const String& method_name, MethodParams* params) {  }
         _exec_cgi(r, method_name, params, true);  
 }  
   
 static void _list(Request& r, const String& method_name, MethodParams* params) {  
   
         ValuePtr relative_path=params->as_no_junction(0, "path must not be code");  
   
         const String& regexp;  
         pcre *regexp_code;  
         const int ovecsize=(1/*match*/)*3;  
         int ovector[ovecsize];  
         if(params->count()>1) {  
                 regexp=params->as_no_junction(1, "regexp must not be code")->as_string(&pool);  
   
                 const char* pattern=regexp->cstr();  
                 const char* errptr;  
                 int erroffset;  
                 regexp_code=pcre_compile(pattern, PCRE_EXTRA | PCRE_DOTALL,   
                         &errptr, &erroffset,   
                         r.charsets.source().pcre_tables);  
   
                 if(!regexp_code)  
                         throw Exception(0,   
                                 regexp->mid(erroffset, regexp->size()),   
                                 "regular expression syntax error - %s", errptr);  
         } else   
                 regexp_code=0;  
   
   
         const char* absolute_path_cstr=r.absolute(relative_path->as_string(&pool))->  
                 cstr(String::UL_FILE_SPEC);  
   
         Table::columns_type columns(new ArrayString);  
         *columns+=String* (new String("name"));   
         Table* table(new Table(method_name, columns));  
   
         LOAD_DIR(absolute_path_cstr,   static void _list(Request& r, MethodParams& params) {
                 const char* file_name_cstr=ffblk.ff_name;          Value& relative_path=params.as_no_junction(0, "path must not be code");
                 size_t file_name_size=strlen(file_name_cstr);  
                 bool suits=true;          bool stat=false;
                 if(regexp_code) {          VRegex* vregex=0;
                         int exec_result=pcre_exec(regexp_code, 0,           VRegexCleaner vrcleaner;
                                 ffblk.ff_name, file_name_size, 0,   
                                 0, ovector, ovecsize);          if(params.count()>1){
                                           Value& voption=params.as_no_junction(1, "option must not be code");
                         if(exec_result==PCRE_ERROR_NOMATCH)                  if(voption.is_defined()) {
                                 suits=false;                          Value* vfilter=0;
                         else if(exec_result<0) {                          if(HashStringValue* options=voption.get_hash()) {
                                 (*pcre_free)(regexp_code);                                  int valid_options=0;
                                 throw Exception(0,                                   if(Value* vstat=options->get("stat")) {
                                         regexp,                                           stat=r.process(*vstat).as_bool();
                                         "regular expression execute (%d)",                                           valid_options++;
                                                 exec_result);                                  }
                                   if(Value* value=options->get("filter")) {
                                           vfilter=value;
                                           valid_options++;
                                   }
                                   if(valid_options!=options->count())
                                           throw Exception(PARSER_RUNTIME, 0, CALLED_WITH_INVALID_OPTION);
                           } else {
                                   vfilter=&voption;
                           }
                           if(vfilter) {
                                   if(VRegex* value=dynamic_cast<VRegex*>(vfilter)) {
                                           vregex=value;
                                   } else if(vfilter->is_string()) {
                                           if(!vfilter->get_string()->trim().is_empty()) {
                                                   vregex=new VRegex(r.charsets.source(), &vfilter->as_string(), 0/*options*/);
                                                   vregex->study();
                                                   vrcleaner.vregex=vregex;
                                           }
                                   } else {
                                           throw Exception(PARSER_RUNTIME, 0, "filter must be regex or string");
                                   }
                         }                          }
                 }                  }
           }
   
                 if(suits) {          const char* absolute_path_cstr=r.full_disk_path(relative_path.as_string()).taint_cstr(String::L_FILE_SPEC);
                         const String& file_name(new String);  
                         file_name->APPEND_TAINTED(pool.copy(file_name_cstr, file_name_size), file_name_size,           Table::Action_options table_options;
                                 method_name->origin().file, method_name->origin().line);          Table& table=*new Table(file_list_table_template(), table_options);
                   
           const int ovector_size=(1/*match*/)*3;
           int ovector[ovector_size];
   
           LOAD_DIR(absolute_path_cstr, 
                   const char* file_name_cstr=ffblk.name();
                   size_t file_name_size=strlen(file_name_cstr);
   
                   if(!vregex || vregex->exec(file_name_cstr, file_name_size, ovector, ovector_size)>=0) {
                         Table::element_type row(new ArrayString);                          Table::element_type row(new ArrayString);
                         *row+=file_name;                          *row+=new String(pa_strdup(file_name_cstr, file_name_size), String::L_TAINTED);
                         *table+=row;                          *row+=new String(ffblk.is_dir(stat) ? "1" : "0", String::L_CLEAN);
                           if(stat) {
                                   *row+=VDouble(ffblk.size()).get_string();
                                   *row+=new String(pa_uitoa(ffblk.c_timestamp()), String::L_CLEAN);
                                   *row+=new String(pa_uitoa(ffblk.m_timestamp()), String::L_CLEAN);
                                   *row+=new String(pa_uitoa(ffblk.a_timestamp()), String::L_CLEAN);
                           }
                           table+=row;
                 }                  }
         );          );
   
         if(regexp_code)  
                 pcre_free(regexp_code);  
   
         // write out result          // write out result
         r.write_no_lang(ValuePtr(new VTable(table)));          r.write(*new VTable(&table));
 }  }
   
 #ifndef DOXYGEN  #ifndef DOXYGEN
 struct Lock_execute_body_info {  struct Lock_execute_body_info {
         Request* r;          Request* r;
         ValuePtr body_code;          Value* body_code;
 };  };
 #endif  #endif
   
 static void lock_execute_body(int , void *ainfo) {  static void lock_execute_body(int , void *ainfo) {
         Lock_execute_body_info& info=*static_cast<Lock_execute_body_info *>(ainfo);          Lock_execute_body_info& info=*static_cast<Lock_execute_body_info *>(ainfo);
         // execute body          // execute body
         info.r->write_assign_lang(info.r->process(info.body_code));          info.r->write(info.r->process(*info.body_code));
 };  }
 static void _lock(Request& r, const String& method_name, MethodParams* params) {  
         Lock_execute_body_info info;  static void _lock(Request& r, MethodParams& params) {
         info.r=&r;          const String& file_spec=r.full_disk_path(params.as_file_name(0));
         const String& file_spec=r.absolute(params->as_string(0, "file name must be string"));          Lock_execute_body_info info={
         info.body_code=params->as_junction(1, "body must be code");                  &r, 
                   &params.as_junction(1, "body must be code")
         file_write_action_under_lock(file_spec, "lock", lock_execute_body, &info);          };
 }  
           file_write_action_under_lock(
 static int lastposafter(const String& s, int after, const char* substr, size_t substr_size, bool beforelast=false) {                          file_spec,
         size_t size;                          "lock",
         if(beforelast)                          lock_execute_body,
                 size=s.size();                          &info);
         int at;  }
         while((at=s.pos(substr, substr_size, after))>=0) {  
                 size_t newafter=at+substr_size/*skip substr*/;  
                 if(beforelast && newafter==size)  
                         break;  
                 after=newafter;  
         }  
   
         return after;  static size_t afterlastslash(const String& str) {
           size_t pos=str.strrpbrk("/\\");
           return pos!=STRING_NOT_FOUND?pos+1:0;
 }  }
   
 static void _find(Request& r, const String& method_name, MethodParams* params) {  static size_t afterlastslash(const String& str, size_t right) {
         const String& file_name=params->as_no_junction(0, "file name must not be code")->as_string(&pool);          size_t pos=str.strrpbrk("/\\", 0, right);
         const String& file_spec;          return pos!=STRING_NOT_FOUND?pos+1:0;
         if(file_name->first_char()=='/')  }
                 file_spec=file_name;  
   static void _find(Request& r, MethodParams& params) {
           const String& file_name=params.as_string(0, FILE_NAME_MUST_BE_STRING);
   
           Value* not_found_code=(params.count()==2)?&params.as_junction(1, "not-found param must be code"):0;
   
           const String* file_spec;
           if(file_name.first_char()=='/')
                   file_spec=&file_name;
         else           else 
                 file_spec=r.relative(r.request_info.uri, file_name);                  file_spec=&r.relative(r.request_info.uri, file_name);
   
         // easy way          // easy way
         if(file_readable(r.absolute(file_spec))) {          if(file_exist(r.full_disk_path(*file_spec))) {
                 r.write_assign_lang(*file_spec);                  r.write(*file_spec);
                 return;                  return;
         }          }
   
         // monkey way          // monkey way
         int after_base_slash=lastposafter(*file_spec, 0, "/", 1);          size_t last_slash=file_spec->strrpbrk("/\\");
         const String& dirname=file_spec->mid(0, after_base_slash);          const String& dirname=file_spec->mid(0, last_slash!=STRING_NOT_FOUND?last_slash:0);
         const String& basename=file_spec->mid(after_base_slash, file_spec->size());          const String& basename=file_spec->mid(last_slash!=STRING_NOT_FOUND?last_slash+1:0, file_spec->length());
   
         int after_monkey_slash;          size_t rpos=dirname.is_empty()?0:dirname.length()-1;
         while((after_monkey_slash=lastposafter(*dirname, 0, "/", 1, true))>0) {          while((rpos=dirname.rskipchars("/\\", 0, rpos))!=STRING_NOT_FOUND){
                 const String& test_name(new String);                  size_t slash=dirname.strrpbrk("/\\", 0, rpos);
                 *test_name<<*(dirname=dirname->mid(0, after_monkey_slash));                  if(slash==STRING_NOT_FOUND)
                 *test_name<<basename;                          break;
                 if(file_readable(r.absolute(test_name))) {                  String test_name;
                         r.write_assign_lang(*test_name);                  test_name << dirname.mid(0, slash+1);
                   test_name << basename;
                   if(file_exist(r.full_disk_path(test_name))) {
                           r.write(test_name);
                         return;                          return;
                 }                  }
                   rpos=slash;
         }          }
   
         // no way, not found          // no way, not found
         if(params->count()==2) {          if(not_found_code)
                 ValuePtr not_found_code=params->as_junction(1, "not-found param must be code");                  r.write(r.process(*not_found_code));
                 r.write_pass_lang(r.process(not_found_code));  }
   
   static void _dirname(Request& r, MethodParams& params) {
           const String& file_spec=params.as_file_spec(0);
           // works as *nix dirname
   
           // empty   > .
           // /       > /
           // /a      > /
           // /a/     > /
           // /a/some.tar.gz > /a
           // /a/b/   > /a
           // /a///b/ > /a
           // /a/b/// > /a
           // file    > .
   
           if(file_spec.is_empty()) {
                   r.write(String("."));
                   return;
           }
   
           size_t p;
           size_t slash;
           if((p=file_spec.rskipchars("/\\"))==STRING_NOT_FOUND)
                   r.write(String("/"));
           else {
                   if((slash=file_spec.strrpbrk("/\\", 0, p))!=STRING_NOT_FOUND) {
                           if((p=file_spec.rskipchars("/\\", 0, slash))==STRING_NOT_FOUND)
                                   p=slash;
                           r.write(file_spec.mid(0, p+1));
                           return;
                   }
                   r.write(String("."));
         }          }
 }  }
   
 static void _dirname(Request& r, const String& method_name, MethodParams* params) {  static void _basename(Request& r, MethodParams& params) {
         const String& file_spec=params->as_string(0, "file name must be string");          const String& file_spec=params.as_file_spec(0);
     // /a/some.tar.gz > /a          // works as *nix basename
         // /a/b/ > /a  
         int afterslash=lastposafter(*file_spec, 0, "/", 1, true);          // empty   > .
         if(afterslash>0)          // /       > /
                 r.write_assign_lang(*file_spec->mid(0, afterslash==1?1:afterslash-1));          // /a      > a
           // /a/     > a
           // /a/some.tar.gz > some.tar.gz
           // /a/b/   > b
           // /a///b/ > b
           // /a/b/// > b
           // file    > file
   
           if(file_spec.is_empty()) {
                   r.write(String("."));
                   return;
           }
   
           size_t p=file_spec.rskipchars("/\\");
           if(p==STRING_NOT_FOUND)
                   r.write(String("/"));
         else          else
                 r.write_assign_lang(String(".", 1));                  r.write(file_spec.mid(afterlastslash(file_spec, p), p+1));
 }  }
   
 static void _basename(Request& r, const String& method_name, MethodParams* params) {  static void _justname(Request& r, MethodParams& params) {
         const String& file_spec=params->as_string(0, "file name must be string");          const String& file_spec=params.as_file_spec(0);
     // /a/some.tar.gz > some.tar.gz          // /a/some.tar.gz > some.tar
         int afterslash=lastposafter(*file_spec, 0, "/", 1);          // /a/b.c/ > empty
         r.write_assign_lang(*file_spec->mid(afterslash, file_spec->size()));          // /a/b.c  > b
 }          size_t pos=afterlastslash(file_spec);
           size_t dotpos=file_spec.strrpbrk(".", pos);
 static void _justname(Request& r, const String& method_name, MethodParams* params) {          r.write(file_spec.mid(pos, dotpos!=STRING_NOT_FOUND?dotpos:file_spec.length()));
         const String& file_spec=params->as_string(0, "file name must be string");  }
     // /a/some.tar.gz > some.tar  
         int afterslash=lastposafter(*file_spec, 0, "/", 1);  static void _justext(Request& r, MethodParams& params) {
         int afterdot=lastposafter(*file_spec, afterslash, ".", 1);          const String& file_spec=params.as_file_spec(0);
         r.write_assign_lang(*file_spec->mid(afterslash, afterdot!=afterslash?afterdot-1:file_spec->size()));          // /a/some.tar.gz > gz
 }          // /a/b.c/ > empty
 static void _justext(Request& r, const String& method_name, MethodParams* params) {          size_t pos=afterlastslash(file_spec);
         const String& file_spec=params->as_string(0, "file name must be string");          size_t dotpos=file_spec.strrpbrk(".", pos);
     // /a/some.tar.gz > gz          if(dotpos!=STRING_NOT_FOUND)
         int afterdot=lastposafter(*file_spec, 0, ".", 1);                  r.write(file_spec.mid(dotpos+1, file_spec.length()));
         if(afterdot>0)  }
                 r.write_assign_lang(*file_spec->mid(afterdot, file_spec->size()));  
 }  static void _fullpath(Request& r, MethodParams& params) {
           const String& file_spec=params.as_file_spec(0);
 static void _fullpath(Request& r, const String& method_name, MethodParams* params) {          const String* result;
         const String& file_spec=params->as_string(0, "file name must be string");          if(file_spec.first_char()=='/')
         const String& result(new String);                  result=&file_spec;
         if(file_spec->first_char()=='/')  
                 result=file_spec;  
         else {          else {
                 // /some/page.html: ^file:fullpath[a.gif] => /some/a.gif                  // /some/page.html: ^file:fullpath[a.gif] => /some/a.gif
                 const String& full_disk_path=r.absolute(file_spec);                  const String& full_disk_path=r.full_disk_path(file_spec);
                 size_t document_root_length=strlen(r.request_info.document_root);                  size_t document_root_length=strlen(r.request_info.document_root);
   
                 if(document_root_length>0) {                  if(document_root_length>0) {
Line 589  static void _fullpath(Request& r, const Line 947  static void _fullpath(Request& r, const
                         if(last_char == '/' || last_char == '\\')                          if(last_char == '/' || last_char == '\\')
                                 --document_root_length;                                  --document_root_length;
                 }                  }
                 result=full_disk_path->mid(document_root_length,  full_disk_path->size());                  result=&full_disk_path.mid(document_root_length,  full_disk_path.length());
         }          }
         r.write_assign_lang(*result);          r.write(*result);
 }  }
   
   static void _sql_string(Request& r, MethodParams&) {
           VFile& self=GET_SELF(r, VFile);
   
 // constructor          const char *quoted=r.connection()->quote(self.value_ptr(), self.value_size());
           r.write(*new String(quoted));
   }
   
 MFile::MFile(): Methoded("file") {  #ifndef DOXYGEN
         // ^save[mode;file-name]  class File_sql_event_handlers: public SQL_Driver_query_event_handlers {
         add_native_method("save", Method::CT_DYNAMIC, _save, 2, 2);          int got_columns;
           int got_cells;
           bool got_row;
   public:
           String::C value;
           const String* user_file_name;
           const String* user_content_type;
   public:
           File_sql_event_handlers():
                   got_columns(0),
                   got_cells(0),
                   got_row(false),
                   user_file_name(0),
                   user_content_type(0) {}
   
           bool add_column(SQL_Error& error, const char* /*str*/, size_t /*length*/) {
                   if(got_columns++==3) {
                           error=SQL_Error("result must contain no more than 3 columns");
                           return true;
                   }
                   return false;
           }
           bool before_rows(SQL_Error& /*error*/ ) { /* ignore */ return false; }
           bool add_row(SQL_Error& error) {
                   if(got_row) {
                           error=SQL_Error("result must contain no more than 1 row");
                           return true;
                   }
                   got_row=true;
                   return false;
           }
           bool add_row_cell(SQL_Error& error, const char* str, size_t length) {
                   try {
                           switch(got_cells++) {
                                   case 0:
                                           value=String::C(str, length); 
                                           break;
                                   case 1:
                                           if(!user_file_name) // user not specified?
                                                   user_file_name=new String(str, String::L_TAINTED);
                                           break;
                                   case 2:
                                           if(!user_content_type) // user not specified?
                                                   user_content_type=new String(str, String::L_TAINTED);
                                           break;
                                   default:
                                           error=SQL_Error("result must contain no more than 1 row and 3 columns");
                                           return true;
                           }
                           return false;
                   } catch(...) {
                           error=SQL_Error("exception occurred in File_sql_event_handlers::add_row_cell");
                           return true;
                   }
           }
   };
   #endif
   static void _sql(Request& r, MethodParams& params) {
           Value& statement=params.as_junction(0, "statement must be code");
   
         // ^delete[file-name]          const String& statement_string=r.process_to_string(statement);
         add_native_method("delete", Method::CT_STATIC, _delete, 1, 1);          const char* statement_cstr=statement_string.untaint_cstr(String::L_SQL, r.connection());
   
         // ^move[from-file-name;to-file-name]          File_sql_event_handlers handlers;
         add_native_method("move", Method::CT_STATIC, _move, 2, 2);  
   
         // ^load[mode;disk-name]          ulong limit=SQL_NO_LIMIT;
         // ^load[mode;disk-name;user-name]          ulong offset=0;
         add_native_method("load", Method::CT_DYNAMIC, _load, 2, 3);  
           if(params.count()>1)
                   if(HashStringValue* options=params.as_hash(1, "sql options")) {
                           int valid_options=0;
                           if(Value* vfilename=options->get(NAME_NAME)) {
                                   valid_options++;
                                   handlers.user_file_name=&vfilename->as_string();
                           }
                           if(Value* vcontent_type=options->get(CONTENT_TYPE_NAME)) {
                                   valid_options++;
                                   handlers.user_content_type=&vcontent_type->as_string();
                           }
                           if(Value* vlimit=options->get(sql_limit_name)) {
                                   valid_options++;
                                   limit=(ulong)r.process(*vlimit).as_double();
                           }
                           if(Value* voffset=options->get(sql_offset_name)) {
                                   valid_options++;
                                   offset=(ulong)r.process(*voffset).as_double();
                           }
                           if(valid_options!=options->count())
                                   throw Exception(PARSER_RUNTIME, 0, CALLED_WITH_INVALID_OPTION);
                   }
   
         // ^stat[disk-name]  
           r.connection()->query(statement_cstr, 0, 0, offset, limit, handlers, statement_string);
   
           if(!handlers.value.str)
                   throw Exception(PARSER_RUNTIME, 0, "produced no result");
   
           VFile& self=GET_SELF(r, VFile);
   
           self.set_binary(true/*tainted*/, handlers.value.str, handlers.value.length, handlers.user_file_name
                                   , handlers.user_content_type ? new VString(*handlers.user_content_type) : 0
                                   , &r);
   }
   
   extern Base64Options base64_encode_options(Request& r, HashStringValue* options);
   
   Base64Options base64_decode_options(Request& r, HashStringValue* options, VString** vcontent_type) {
           Base64Options result;
           if(options) {
                   for(HashStringValue::Iterator i(*options); i; i.next() ) {
                           String::Body key=i.key();
                           Value* value=i.value();
                           if(key == "pad") {
                                   result.pad=r.process(*value).as_bool();
                           } else if(key == "strict") {
                                   result.strict=r.process(*value).as_bool();
                           } else if(key == CONTENT_TYPE_NAME) {
                                   *vcontent_type=new VString(value->as_string());
                           } else if(key == "url-safe") {
                                   if(r.process(*value).as_bool())
                                           result.set_url_safe_abc();
                           } else
                                   throw Exception(PARSER_RUNTIME, 0, CALLED_WITH_INVALID_OPTION);
                   }
           }
           return result;
   }
   
   static void _base64(Request& r, MethodParams& params) {
           bool dynamic=!(&r.get_self() == file_class);
           if(dynamic) {
                   VFile& self=GET_SELF(r, VFile);
                   if(params.count()>1 || params.count()==1 && params[0].is_string()) {
                           // decode: 
                           //      ^file::base64[encoded] // backward
                           //      ^file::base64[mode;user-file-name;encoded[;$.content-type[...] $.strict(true|false)]]
                           bool is_text=false;
                           const String* user_file_name=0;
                           VString* vcontent_type=0;
                           Base64Options options;
   
                           size_t param_index=0;
   
                           if(params.count() > 1) {
                                   if(params.count() < 3)
                                           throw Exception(PARSER_RUNTIME, 0, "constructor cannot have less than 3 parameters (has %d parameters)", params.count()); // actually it accepts 1 parameter (backward)
   
                                   is_text=VFile::is_text_mode(params.as_string(0, MODE_MUST_BE_STRING));
                                   user_file_name=&params.as_string(1, FILE_NAME_MUST_BE_STRING);
   
                                   if(params.count() == 4)
                                           options=base64_decode_options(r, params.as_hash(3), &vcontent_type);
   
                                   param_index=2;
                           }
   
                           const char* encoded=params.as_string(param_index, PARAMETER_MUST_BE_STRING).cstr();
   
                           char* decoded=0;
                           size_t length=pa_base64_decode(encoded, strlen(encoded), decoded, options);
   
                           self.set(true/*tainted*/, is_text, decoded, length, user_file_name, vcontent_type, &r);
                   } else {
                           // encode: ^f.base64[options]
                           Base64Options options = base64_encode_options(r, params.count() > 0 ? params.as_hash(0) : NULL);
                           const char* encoded=pa_base64_encode(self.value_ptr(), self.value_size(), options);
                           r.write(*new String(encoded, String::L_TAINTED /*once ?param=base64(something) was needed**/ ));
                   }
           } else {
                   // encode: ^file:base64[filespec[;options]]
                   if(params.count() > 2)
                           throw Exception(PARSER_RUNTIME, 0, "accepts maximum 2 parameter(s) (has %d parameters)", params.count());
   
                   const String& file_spec = params.as_file_name(0);
                   File_read_result data = file_read_binary(r.full_disk_path(file_spec), true /*fail on problem*/);
   
                   Base64Options options = base64_encode_options(r, params.count() > 1 ? params.as_hash(1) : NULL);
                   const char* encoded = pa_base64_encode(data.str, data.length, options);
                   r.write(*new String(encoded, String::L_TAINTED /*once ?param=base64(something) was needed*/ ));
           }
   }
   
   static void _crc32(Request& r, MethodParams& params) {
           uint crc32 = 0;
           if(&r.get_self() == file_class) {
                   // ^file:crc32[file-name]
                   if(params.count()) {
                           const String& file_spec=params.as_file_name(0);
                           crc32=pa_crc32(r.full_disk_path(file_spec));
                   } else {
                           throw Exception(PARSER_RUNTIME, 0, FILE_NAME_MUST_BE_SPECIFIED);
                   }
           } else {
                   // ^file.crc32[]
                   VFile& self=GET_SELF(r, VFile);
                   crc32=pa_crc32(self.value_ptr(), self.value_size());
           }
           r.write(*new VDouble(crc32));
   }
   
   
   static void file_md5_file_action(struct stat& finfo, int f, const String&, void *context)
   {
           PA_MD5_CTX& md5context=*static_cast<PA_MD5_CTX *>(context);
           if(finfo.st_size) {
                   int nCount=0;
                   do {
                           unsigned char buffer[FILE_BUFFER_SIZE];
                           nCount = file_block_read(f, buffer, sizeof(buffer));
                           if ( nCount ){
                                   pa_MD5Update(&md5context, (const unsigned char*)buffer, nCount);
                           }
                   } while(nCount > 0);
           }
   }
   
   const char* pa_md5(const String& file_spec)
   {
           PA_MD5_CTX context;
           unsigned char digest[16];
           pa_MD5Init(&context);
           file_read_action_under_lock(file_spec, "md5", file_md5_file_action, &context);
           pa_MD5Final(digest, &context);
           
           return hex_string(digest, sizeof(digest), false);
   }
   
   const char* pa_md5(const char *in, size_t in_size)
   {
           PA_MD5_CTX context;
           unsigned char digest[16];
           pa_MD5Init(&context);
           pa_MD5Update(&context, (const unsigned char*)in, in_size);
           pa_MD5Final(digest, &context);
           
           return hex_string(digest, sizeof(digest), false);
   }
   
   static void _md5(Request& r, MethodParams& params) {
           const char* md5;
           if(&r.get_self() == file_class) {
                   // ^file:md5[file-name]
                   if(params.count()) {
                           const String& file_spec=params.as_file_name(0);
                           md5=pa_md5(r.full_disk_path(file_spec));
                   } else {
                           throw Exception(PARSER_RUNTIME, 0, FILE_NAME_MUST_BE_SPECIFIED);
                   }
           } else {
                   // ^file.md5[]
                   VFile& self=GET_SELF(r, VFile);
                   md5=pa_md5(self.value_ptr(), self.value_size());
   
           }
           r.write(*new String(md5));
   }
   
   // constructor
   
   MFile::MFile(): Methoded("file") {
           // ^file::create[text|binary;file-name;string-or-file[;options hash]]
           // ^file::create[string-or-file[;options hash]]
           add_native_method("create", Method::CT_DYNAMIC, _create, 1, 4);
   
           // ^file.save[mode;file-name]
           // ^file.save[mode;file-name;$.charset[...]$.append(false)]
           add_native_method("save", Method::CT_DYNAMIC, _save, 2, 3);
   
           // ^file:delete[file-name]
           // ^file:delete[file-name;$.keep-empty-dir(true)$.exception(false)]
           add_native_method("delete", Method::CT_STATIC, _delete, 1, 2);
   
           // ^file:move[from-file-name;to-file-name]
           // ^file:move[from-file-name;to-file-name;$.keep-empty-dir(true)]
           add_native_method("move", Method::CT_STATIC, _move, 2, 3);
   
           // ^file::load[mode;disk-name]
           // ^file::load[mode;disk-name;user-name]
           // ^file::load[mode;disk-name;user-name;options hash]
           // ^file::load[mode;disk-name;options hash]
           add_native_method("load", Method::CT_DYNAMIC, _load, 2, 4);
   
           // ^file::stat[disk-name]
         add_native_method("stat", Method::CT_DYNAMIC, _stat, 1, 1);          add_native_method("stat", Method::CT_DYNAMIC, _stat, 1, 1);
   
         // ^cgi[file-name]          // ^file::cgi[mode;file-name]
         // ^cgi[file-name;env hash]          // ^file::cgi[mode;file-name;env hash]
         // ^cgi[file-name;env hash;1cmd;2line;3ar;4g;5s]          // ^file::cgi[mode;file-name;env hash;1cmd;2line;3ar;4g;5s]
         add_native_method("cgi", Method::CT_DYNAMIC, _cgi, 1, 2+10);          add_native_method("cgi", Method::CT_DYNAMIC, _cgi, 1, 3+50);
   
         // ^exec[file-name]          // ^file::exec[mode;file-name]
         // ^exec[file-name;env hash]          // ^file::exec[mode;file-name;env hash]
         // ^exec[file-name;env hash;1cmd;2line;3ar;4g;5s]          // ^file::exec[mode;file-name;env hash;1cmd;2line;3ar;4g;5s]
         add_native_method("exec", Method::CT_DYNAMIC, _exec, 1, 2+10);          add_native_method("exec", Method::CT_DYNAMIC, _exec, 1, 3+50);
   
         // ^file:list[path]          // ^file:list[path]
         // ^file:list[path][regexp]          // ^file:list[path][regexp]
           // ^file:list[path][$.filter[regexp] $.stat(true)]
         add_native_method("list", Method::CT_STATIC, _list, 1, 2);          add_native_method("list", Method::CT_STATIC, _list, 1, 2);
   
         // ^file:lock[path]{code}          // ^file:lock[path]{code}
         add_native_method("lock", Method::CT_STATIC, _lock, 2, 2);          add_native_method("lock", Method::CT_STATIC, _lock, 2, 2);
   
         // ^find[file-name]          // ^file:find[file-name]
         // ^find[file-name]{when-not-found}          // ^file:find[file-name]{when-not-found}
         add_native_method("find", Method::CT_STATIC, _find, 1, 2);          add_native_method("find", Method::CT_STATIC, _find, 1, 2);
   
     // ^file:dirname[/a/some.tar.gz]=/a          // ^file:dirname[/a/some.tar.gz]=/a
         // ^file:dirname[/a/b/]=/a          // ^file:dirname[/a/b/]=/a
         add_native_method("dirname", Method::CT_STATIC, _dirname, 1, 1);          add_native_method("dirname", Method::CT_STATIC, _dirname, 1, 1);
     // ^file:basename[/a/some.tar.gz]=some.tar.gz          // ^file:basename[/a/some.tar.gz]=some.tar.gz
     add_native_method("basename", Method::CT_STATIC, _basename, 1, 1);          add_native_method("basename", Method::CT_STATIC, _basename, 1, 1);
     // ^file:justname[/a/some.tar.gz]=some.tar          // ^file:justname[/a/some.tar.gz]=some.tar
         add_native_method("justname", Method::CT_STATIC, _justname, 1, 1);          add_native_method("justname", Method::CT_STATIC, _justname, 1, 1);
     // ^file:justext[/a/some.tar.gz]=gz          // ^file:justext[/a/some.tar.gz]=gz
         add_native_method("justext", Method::CT_STATIC, _justext, 1, 1);          add_native_method("justext", Method::CT_STATIC, _justext, 1, 1);
     // /some/page.html: ^file:fullpath[a.gif] => /some/a.gif          // /some/page.html: ^file:fullpath[a.gif] => /some/a.gif
         add_native_method("fullpath", Method::CT_STATIC, _fullpath, 1, 1);          add_native_method("fullpath", Method::CT_STATIC, _fullpath, 1, 1);
   
           // ^file.sql-string[]
           add_native_method("sql-string", Method::CT_DYNAMIC, _sql_string, 0, 0);
   
           // ^file::sql{}
           // ^file::sql{}[options hash]
           add_native_method("sql", Method::CT_DYNAMIC, _sql, 1, 2);
   
           // encode:
           //   ^file.base64[]
           //   ^file:base64[file-name]
           // decode:
           //   ^file::base64[encoded] // backward
           //   ^file::base64[mode;user-file-name;encoded]
           //   ^file::base64[mode;user-file-name;encoded;$.content-type[...]]
           add_native_method("base64", Method::CT_ANY, _base64, 0, 4);
   
           // ^file.crc32[]
           // ^file:crc32[file-name]
           add_native_method("crc32", Method::CT_ANY, _crc32, 0, 1);
   
           // ^file.md5[]
           // ^file:md5[file-name]
           add_native_method("md5", Method::CT_ANY, _md5, 0, 1);
   
           // ^file:copy[from-file-name;to-file-name]
           // ^file:copy[from-file-name;to-file-name;$.append(false)]
           add_native_method("copy", Method::CT_STATIC, _copy, 2, 3);
 }  }

Removed from v.1.107.2.16.2.3  
changed lines
  Added in v.1.299


E-mail: