Annotation of parser3/src/classes/file.C, revision 1.162
1.17 paf 1: /** @file
2: Parser: @b file parser class.
3:
1.136 paf 4: Copyright (c) 2001-2005 ArtLebedev Group (http://www.artlebedev.com)
1.72 paf 5: Author: Alexandr Petrosian <paf@design.ru> (http://paf.design.ru)
1.91 paf 6: */
1.17 paf 7:
1.162 ! misha 8: static const char * const IDENT_FILE_C="$Date: 2007/11/14 09:45:21 $";
1.47 parser 9:
10: #include "pa_config_includes.h"
11:
12: #include "pcre.h"
1.1 paf 13:
1.35 paf 14: #include "classes.h"
1.111 paf 15: #include "pa_vmethod_frame.h"
16:
1.1 paf 17: #include "pa_request.h"
18: #include "pa_vfile.h"
1.11 paf 19: #include "pa_table.h"
1.21 paf 20: #include "pa_vint.h"
1.24 paf 21: #include "pa_exec.h"
1.40 parser 22: #include "pa_vdate.h"
1.47 parser 23: #include "pa_dir.h"
24: #include "pa_vtable.h"
1.67 paf 25: #include "pa_charset.h"
1.109 paf 26: #include "pa_charsets.h"
1.121 paf 27: #include "pa_sql_connection.h"
1.147 misha 28: #include "pa_md5.h"
1.1 paf 29:
1.32 paf 30: // defines
31:
1.48 parser 32: #define TEXT_MODE_NAME "text"
1.125 paf 33: #define BINARY_MODE_NAME "binary"
1.90 paf 34: #define STDIN_EXEC_PARAM_NAME "stdin"
1.109 paf 35: #define CHARSET_EXEC_PARAM_NAME "charset"
1.48 parser 36:
1.131 paf 37: #define NAME_NAME "name"
38:
1.132 paf 39: // externs
40:
41: extern String sql_limit_name;
42: extern String sql_offset_name;
43:
1.111 paf 44: // class
45:
46: class MFile: public Methoded {
47: public: // VStateless_class
48:
1.134 paf 49: Value* create_new_value(Pool&, HashStringValue&) { return new VFile(); }
1.111 paf 50:
51: public: // Methoded
52: bool used_directly() { return true; }
53:
54: public:
55: MFile();
56:
57: };
58:
59: // global variable
60:
61: DECLARE_CLASS_VAR(file, new MFile, 0);
62:
1.83 paf 63: // consts
64:
65: /// from apache-1.3|src|support|suexec.c
1.111 paf 66: static const char* suexec_safe_env_lst[]={
1.83 paf 67: "AUTH_TYPE",
68: "CONTENT_LENGTH",
69: "CONTENT_TYPE",
70: "DATE_GMT",
71: "DATE_LOCAL",
72: "DOCUMENT_NAME",
73: "DOCUMENT_PATH_INFO",
74: "DOCUMENT_ROOT",
75: "DOCUMENT_URI",
76: "FILEPATH_INFO",
77: "GATEWAY_INTERFACE",
78: "LAST_MODIFIED",
79: "PATH_INFO",
80: "PATH_TRANSLATED",
81: "QUERY_STRING",
82: "QUERY_STRING_UNESCAPED",
83: "REMOTE_ADDR",
84: "REMOTE_HOST",
85: "REMOTE_IDENT",
86: "REMOTE_PORT",
87: "REMOTE_USER",
88: "REDIRECT_QUERY_STRING",
89: "REDIRECT_STATUS",
90: "REDIRECT_URL",
91: "REQUEST_METHOD",
92: "REQUEST_URI",
93: "SCRIPT_FILENAME",
94: "SCRIPT_NAME",
95: "SCRIPT_URI",
96: "SCRIPT_URL",
97: "SERVER_ADMIN",
98: "SERVER_NAME",
99: "SERVER_ADDR",
100: "SERVER_PORT",
101: "SERVER_PROTOCOL",
102: "SERVER_SOFTWARE",
103: "UNIQUE_ID",
104: "USER_NAME",
105: "TZ",
106: NULL
107: };
108:
1.111 paf 109: // statics
1.33 paf 110:
1.112 paf 111: static const String::Body adate_name("adate");
112: static const String::Body mdate_name("mdate");
113: static const String::Body cdate_name("cdate");
1.32 paf 114:
1.1 paf 115: // methods
116:
1.161 misha 117: static bool is_valid_mode (const String& mode) {
118: return (mode==TEXT_MODE_NAME || mode==BINARY_MODE_NAME);
119: }
120:
1.125 paf 121: static bool is_text_mode(const String& mode) {
122: if(mode==TEXT_MODE_NAME)
123: return true;
124: if(mode==BINARY_MODE_NAME)
125: return false;
1.156 misha 126: throw Exception(PARSER_RUNTIME,
1.125 paf 127: &mode,
128: "is invalid mode, must be either '"TEXT_MODE_NAME"' or '"BINARY_MODE_NAME"'");
129: }
130:
1.111 paf 131: static void _save(Request& r, MethodParams& params) {
1.161 misha 132: Value& vmode_name=params.as_no_junction(0, MODE_MUST_NOT_BE_CODE);
1.152 misha 133: Value& vfile_name=params.as_no_junction(1, FILE_NAME_MUST_NOT_BE_CODE);
1.4 paf 134:
1.7 paf 135: // save
1.111 paf 136: GET_SELF(r, VFile).save(r.absolute(vfile_name.as_string()),
1.125 paf 137: is_text_mode(vmode_name.as_string()));
1.7 paf 138: }
139:
1.111 paf 140: static void _delete(Request& r, MethodParams& params) {
1.152 misha 141: Value& vfile_name=params.as_no_junction(0, FILE_NAME_MUST_NOT_BE_CODE);
1.7 paf 142:
143: // unlink
1.68 paf 144: file_delete(r.absolute(vfile_name.as_string()));
1.1 paf 145: }
146:
1.111 paf 147: static void _move(Request& r, MethodParams& params) {
148: Value& vfrom_file_name=params.as_no_junction(0, "from file name must not be code");
149: Value& vto_file_name=params.as_no_junction(1, "to file name must not be code");
1.45 parser 150:
1.51 parser 151: // move
1.68 paf 152: file_move(
1.45 parser 153: r.absolute(vfrom_file_name.as_string()),
154: r.absolute(vto_file_name.as_string()));
155: }
156:
1.148 misha 157: static void copy_process_source(
158: struct stat& ,
159: int from_file,
160: const String& , const char* /*fname*/, bool,
161: void *context) {
162: int& to_file=*static_cast<int *>(context);
163:
164: int nCount=0;
165: do {
166: unsigned char buffer[FILE_BUFFER_SIZE];
1.150 misha 167: nCount = file_block_read(from_file, buffer, sizeof(buffer));
1.148 misha 168: int written=write(to_file, buffer, nCount);
169: if( written < 0 )
170: throw Exception(0,
171: 0,
172: "write failed: %s (%d)", strerror(errno), errno);
173:
174: } while(nCount > 0);
175: }
176:
177: static void copy_open_target(int f, void *from_spec) {
178: String& file_spec=*static_cast<String *>(from_spec);
179: file_read_action_under_lock(file_spec, "copy", copy_process_source, &f);
180: };
181:
182: static void _copy(Request& r, MethodParams& params) {
183: Value& vfrom_file_name=params.as_no_junction(0, "from file name must not be code");
184: Value& vto_file_name=params.as_no_junction(1, "to file name must not be code");
185:
186: String from_spec = r.absolute(vfrom_file_name.as_string());
187: const String& to_spec = r.absolute(vto_file_name.as_string());
188:
189: file_write_action_under_lock(
190: to_spec,
191: "copy",
192: copy_open_target,
1.149 misha 193: &from_spec);
1.148 misha 194: }
195:
1.111 paf 196: static void _load_pass_param(
197: HashStringValue::key_type key,
198: HashStringValue::value_type value,
199: HashStringValue *dest) {
200: dest->put(key, value);
201: }
202: static void _load(Request& r, MethodParams& params) {
1.161 misha 203: Value& vmode_name=params.as_no_junction(0, MODE_MUST_NOT_BE_CODE);
1.152 misha 204: const String& lfile_name=r.absolute(params.as_no_junction(1, FILE_NAME_MUST_NOT_BE_CODE).as_string());
1.111 paf 205: Value* third_param=params.count()>2?¶ms.as_no_junction(2, "filename or options must not be code")
206: :0;
207: HashStringValue* third_param_hash=third_param?third_param->get_hash():0;
208: size_t alt_filename_param_index=2;
1.104 paf 209: if(third_param_hash)
210: alt_filename_param_index++;
1.9 paf 211:
1.132 paf 212: HashStringValue* options=third_param_hash;
213: size_t offset=0;
214: size_t limit=0;
215: if(options) {
216: options=new HashStringValue(*options);
217: if(Value *voffset=(Value *)options->get(sql_offset_name)) {
218: offset=r.process_to_value(*voffset).as_int();
219: }
220: if(Value *vlimit=(Value *)options->get(sql_limit_name)) {
221: limit=r.process_to_value(*vlimit).as_int();
222: }
223: // no check on options count here, see file_read
224: }
1.111 paf 225: File_read_result file=file_read(r.charsets, lfile_name,
1.125 paf 226: is_text_mode(vmode_name.as_string()),
1.132 paf 227: options, true, 0, offset, limit
1.104 paf 228: );
1.9 paf 229:
1.111 paf 230: const char *user_file_name=params.count()>alt_filename_param_index?
1.152 misha 231: params.as_string(alt_filename_param_index, FILE_NAME_MUST_BE_STRING).cstr()
1.111 paf 232: :lfile_name.cstr(String::L_FILE_SPEC);
233:
234: Value* vcontent_type=0;
235: if(file.headers)
1.129 paf 236: {
237: if(Value* remote_content_type=file.headers->get("CONTENT-TYPE"))
238: vcontent_type=new VString(*new String(remote_content_type->as_string().cstr()));
239: }
1.104 paf 240: if(!vcontent_type)
1.111 paf 241: vcontent_type=new VString(r.mime_type_of(user_file_name));
1.10 paf 242:
1.111 paf 243: VFile& self=GET_SELF(r, VFile);
244: self.set(true/*tainted*/, file.str, file.length, user_file_name, vcontent_type);
245: if(file.headers)
1.143 paf 246: file.headers->for_each<HashStringValue*>(_load_pass_param, &self.fields());
1.9 paf 247: }
248:
1.138 paf 249: static void _create(Request& r, MethodParams& params) {
1.161 misha 250: Value& vmode_name=params.as_no_junction(0, MODE_MUST_NOT_BE_CODE);
1.138 paf 251: if(!is_text_mode(vmode_name.as_string()))
1.156 misha 252: throw Exception(PARSER_RUNTIME,
1.138 paf 253: 0,
254: "only text mode is currently supported");
255:
256: const char* user_file_name_cstr=r.absolute(
1.152 misha 257: params.as_no_junction(1, FILE_NAME_MUST_NOT_BE_CODE).as_string()).cstr(String::L_FILE_SPEC);
1.138 paf 258:
259: const String& content=params.as_string(2, "content must be string");
260: const char* content_cstr=content.cstr(String::L_UNSPECIFIED); // explode content, honor tainting changes
261:
262: VString* vcontent_type=new VString(r.mime_type_of(user_file_name_cstr));
263:
264: VFile& self=GET_SELF(r, VFile);
265: self.set(true/*tainted*/, content_cstr, strlen(content_cstr), user_file_name_cstr, vcontent_type);
266: }
267:
1.111 paf 268: static void _stat(Request& r, MethodParams& params) {
1.152 misha 269: Value& vfile_name=params.as_no_junction(0, FILE_NAME_MUST_NOT_BE_CODE);
1.25 paf 270:
271: const String& lfile_name=vfile_name.as_string();
272:
1.40 parser 273: size_t size;
274: time_t atime, mtime, ctime;
275: file_stat(r.absolute(lfile_name),
276: size,
277: atime, mtime, ctime);
1.25 paf 278:
1.111 paf 279: VFile& self=GET_SELF(r, VFile);
280: self.set(true/*tainted*/, 0/*no bytes*/, size);
281: HashStringValue& ff=self.fields();
282: ff.put(adate_name, new VDate(atime));
283: ff.put(mdate_name, new VDate(mtime));
284: ff.put(cdate_name, new VDate(ctime));
285: ff.put(content_type_name, new VString(r.mime_type_of(lfile_name.cstr(String::L_FILE_SPEC))));
1.25 paf 286: }
287:
1.111 paf 288: static bool is_safe_env_key(const char* key) {
289: for(const char* validator=key; *validator; validator++) {
290: char c=*validator;
291: if(!(c>='A' && c<='Z' || c>='0' && c<='9' || c=='_' || c=='-'))
292: return false;
293: }
1.88 paf 294: if(strncasecmp(key, "HTTP_", 5)==0)
1.83 paf 295: return true;
1.87 paf 296: if(strncasecmp(key, "CGI_", 4)==0)
1.83 paf 297: return true;
298: for(int i=0; suexec_safe_env_lst[i]; i++) {
1.87 paf 299: if(strcasecmp(key, suexec_safe_env_lst[i])==0)
1.83 paf 300: return true;
301: }
302: return false;
303: }
1.90 paf 304: #ifndef DOXYGEN
305: struct Append_env_pair_info {
1.141 paf 306: Request_charsets* charsets;
1.111 paf 307: HashStringString* env;
1.100 paf 308: Value* vstdin;
1.90 paf 309: };
310: #endif
1.111 paf 311: static void append_env_pair(
312: HashStringValue::key_type akey,
313: HashStringValue::value_type avalue,
314: Append_env_pair_info *info) {
315: if(akey==STDIN_EXEC_PARAM_NAME) {
316: info->vstdin=avalue;
317: } else if(akey==CHARSET_EXEC_PARAM_NAME) {
1.141 paf 318: // ignore, already processed
1.90 paf 319: } else {
1.111 paf 320: if(!is_safe_env_key(akey.cstr()))
1.156 misha 321: throw Exception(PARSER_RUNTIME,
1.111 paf 322: new String(akey, String::L_TAINTED),
1.90 paf 323: "not safe environment variable");
1.141 paf 324: info->env->put(akey, avalue->as_string().cstr_to_string_body(String::L_UNSPECIFIED, 0, info->charsets));
1.90 paf 325: }
1.22 paf 326: }
1.94 paf 327: #ifndef DOXYGEN
328: struct Pass_cgi_header_attribute_info {
1.111 paf 329: Charset* charset;
330: HashStringValue* fields;
331: Value* content_type;
1.94 paf 332: };
333: #endif
1.111 paf 334: static void pass_cgi_header_attribute(
335: ArrayString::element_type astring,
336: Pass_cgi_header_attribute_info* info) {
337: size_t colon_pos=astring->pos(':');
1.130 paf 338: if(colon_pos!=STRING_NOT_FOUND) {
1.111 paf 339: const String& key=astring->mid(0, colon_pos).change_case(
340: *info->charset, String::CC_UPPER);
1.130 paf 341: Value* value=new VString(astring->mid(colon_pos+1, astring->length()).trim());
1.111 paf 342: info->fields->put(key, value);
1.94 paf 343: if(key=="CONTENT-TYPE")
1.111 paf 344: info->content_type=value;
1.94 paf 345: }
1.29 paf 346: }
1.155 misha 347:
348: static void append_to_argv(Request& r, ArrayString& argv, const String* str){
349: if( str->length() ){
350: argv+=new String(str->cstr_to_string_body(String::L_UNSPECIFIED, 0, &r.charsets), String::L_AS_IS);
351: }
352: }
353:
1.162 ! misha 354: inline size_t strpos(const char *s1, const char *s2) {
! 355: const char *p = strstr(s1, s2);
! 356: return (p==0)?(size_t)-1:p-s1;
! 357: }
! 358:
1.90 paf 359: /// @todo fix `` in perl - they produced flipping consoles and no output to perl
1.111 paf 360: static void _exec_cgi(Request& r, MethodParams& params,
1.41 parser 361: bool cgi) {
1.21 paf 362:
1.162 ! misha 363: Value& first_param=params.as_no_junction(0, FIRST_ARG_MUST_NOT_BE_CODE);
! 364:
! 365: bool is_mode_specified=is_valid_mode(first_param.as_string());
! 366: const String& mode_name=(is_mode_specified) ? first_param.as_string() : *new String(TEXT_MODE_NAME);
! 367:
! 368: size_t param_index=1;
! 369: if(!is_mode_specified){
! 370: --param_index;
! 371: }
! 372:
! 373: if(param_index>=params.count())
! 374: throw Exception(PARSER_RUNTIME,
! 375: 0,
! 376: "file name must be specified");
! 377:
! 378:
! 379: Value& vfile_name=params.as_no_junction(param_index++, FILE_NAME_MUST_NOT_BE_CODE);
1.21 paf 380:
1.23 paf 381: const String& script_name=r.absolute(vfile_name.as_string());
382:
1.111 paf 383: HashStringString env;
1.62 paf 384: #define ECSTR(name, value_cstr) \
1.111 paf 385: if(value_cstr) \
386: env.put( \
1.112 paf 387: String::Body(#name), \
388: String::Body(value_cstr, 0)); \
1.82 paf 389: // passing SAPI::environment
1.111 paf 390: if(const char *const *pairs=SAPI::environment(r.sapi_info)) {
391: while(const char* pair=*pairs++)
392: if(const char* eq_at=strchr(pair, '='))
393: if(eq_at[1]) // has value
394: env.put(
395: pa_strdup(pair, eq_at-pair),
396: pa_strdup(eq_at+1, 0));
1.82 paf 397: }
398:
1.23 paf 399: // const
1.63 paf 400: ECSTR(GATEWAY_INTERFACE, "CGI/1.1");
1.23 paf 401: // from Request.info
1.111 paf 402: ECSTR(DOCUMENT_ROOT, r.request_info.document_root);
403: ECSTR(PATH_TRANSLATED, r.request_info.path_translated);
404: ECSTR(REQUEST_METHOD, r.request_info.method);
405: ECSTR(QUERY_STRING, r.request_info.query_string);
406: ECSTR(REQUEST_URI, r.request_info.uri);
407: ECSTR(CONTENT_TYPE, r.request_info.content_type);
1.23 paf 408: char content_length_cstr[MAX_NUMBER];
1.111 paf 409: snprintf(content_length_cstr, MAX_NUMBER, "%u", r.request_info.content_length);
410: //String content_length(content_length_cstr);
1.62 paf 411: ECSTR(CONTENT_LENGTH, content_length_cstr);
1.82 paf 412: // SCRIPT_*
1.119 paf 413: env.put(String::Body("SCRIPT_NAME"), script_name);
414: //env.put(String::Body("SCRIPT_FILENAME"), ??&script_name);
1.23 paf 415:
1.111 paf 416: bool stdin_specified=false;
1.90 paf 417: // environment & stdin from param
1.111 paf 418: String *in=new String();
1.109 paf 419: Charset *charset=0; // default script works raw_in 'source' charset = no transcoding needed
1.162 ! misha 420: if(param_index < params.count()) {
! 421: Value& venv=params.as_no_junction(param_index++, "env must not be code");
1.111 paf 422: if(HashStringValue* user_env=venv.get_hash()) {
1.141 paf 423: // $.charset [previewing to handle URI pieces]
424: if(Value* vcharset=user_env->get(CHARSET_EXEC_PARAM_NAME))
425: charset=&charsets.get(vcharset->as_string()
426: .change_case(r.charsets.source(), String::CC_UPPER));
427:
428: // $.others
429: Append_env_pair_info info={&r.charsets, &env, 0};
430: {
1.144 paf 431: // influence tainting
432: // main target -- $.QUERY_STRING -- URLencoding of tainted pieces to String::L_URI lang
1.141 paf 433: Temp_client_charset temp(r.charsets, charset? *charset: r.charsets.source());
1.143 paf 434: user_env->for_each<Append_env_pair_info*>(append_env_pair, &info);
1.141 paf 435: }
1.109 paf 436: // $.stdin
1.103 paf 437: if(info.vstdin) {
1.111 paf 438: stdin_specified=true;
439: if(const String* sstdin=info.vstdin->get_string()) {
440: in->append(*sstdin, String::L_CLEAN, true);
1.103 paf 441: } else
1.111 paf 442: if(VFile* vfile=static_cast<VFile *>(info.vstdin->as("file", false)))
443: in->append_know_length((const char* )vfile->value_ptr(), vfile->value_size(), String::L_TAINTED);
1.100 paf 444: else
1.156 misha 445: throw Exception(PARSER_RUNTIME,
1.111 paf 446: 0,
1.100 paf 447: STDIN_EXEC_PARAM_NAME " parameter must be string or file");
1.103 paf 448: }
1.90 paf 449: }
1.21 paf 450: }
451:
1.90 paf 452: // argv from params
1.111 paf 453: ArrayString argv;
1.162 ! misha 454: if(param_index < params.count()) {
1.144 paf 455: // influence tainting
456: // main target -- URLencoding of tainted pieces to String::L_URI lang
457: Temp_client_charset temp(r.charsets, charset? *charset: r.charsets.source());
1.154 misha 458:
1.162 ! misha 459: for(size_t i=param_index; i<params.count(); i++) {
1.161 misha 460: Value& param=params.as_no_junction(i, PARAM_MUST_NOT_BE_CODE);
1.154 misha 461: if(param.is_defined()){
462: if(param.is_string()){
1.155 misha 463: append_to_argv(r, argv, param.get_string());
1.154 misha 464: } else {
1.155 misha 465: Table* table=param.get_table();
466: if(table){
467: for(size_t i=0; i<table->count(); i++) {
468: append_to_argv(r, argv, table->get(i)->get(0));
1.154 misha 469: }
470: } else {
1.156 misha 471: throw Exception(PARSER_RUNTIME,
1.154 misha 472: 0,
1.162 ! misha 473: "param must be string or table");
1.154 misha 474: }
475: }
1.145 misha 476: }
1.144 paf 477: }
1.21 paf 478: }
1.90 paf 479:
1.109 paf 480: // transcode if necessary
481: if(charset) {
1.111 paf 482: Charset::transcode(env, r.charsets.source(), *charset);
483: Charset::transcode(argv, r.charsets.source(), *charset);
484: in=&Charset::transcode(*in, r.charsets.source(), *charset);
485: }
486: // @todo
487: // ifdef WIN32 do OEM->ANSI transcode on some(.cmd?) programs to
488: // match silent conversion in OS
489:
490: // exec!
491: PA_exec_result execution=
492: pa_exec(false/*forced_allow*/, script_name, &env, argv, *in);
493:
1.162 ! misha 494: File_read_result *file_out=&execution.out;
1.111 paf 495: String *real_err=&execution.err;
1.162 ! misha 496:
! 497: if(is_text_mode(mode_name)){
! 498: fix_line_breaks(file_out->str, file_out->length);
! 499: // treat output as string
! 500: String *real_out = new String(file_out->str, file_out->length);
! 501:
! 502: // transcode if necessary
! 503: if(charset) {
! 504: real_out=&Charset::transcode(*real_out, *charset, r.charsets.source());
! 505: real_err=&Charset::transcode(*real_err, *charset, r.charsets.source());
! 506: }
! 507: // FIXME: unsafe cast
! 508: file_out->str = (char*)real_out->cstr();
! 509: file_out->length = real_out->length();
1.109 paf 510: }
511:
1.111 paf 512: VFile& self=GET_SELF(r, VFile);
1.109 paf 513:
1.162 ! misha 514: if(cgi) { // ^file::cgi
1.111 paf 515: const char* eol_marker=0; size_t eol_marker_size;
516: // construct with 'out' body and header
1.162 ! misha 517: size_t dos_pos=strpos(file_out->str, "\r\n\r\n");
! 518: size_t unix_pos=strpos(file_out->str, "\n\n");
1.111 paf 519:
520: bool unix_header_break;
521: switch((dos_pos!=STRING_NOT_FOUND?10:00) + (unix_pos!=STRING_NOT_FOUND?01:00)) {
522: case 10: // dos
523: unix_header_break=false;
524: break;
525: case 01: // unix
526: unix_header_break=true;
527: break;
528: case 11: // dos & unix
529: unix_header_break=unix_pos<dos_pos;
530: break;
531: default: // 00
532: unix_header_break=false; // calm down, compiler
1.74 paf 533: throw Exception(0,
1.111 paf 534: 0,
1.90 paf 535: "output does not contain CGI header; "
536: "exit status=%d; stdoutsize=%u; stdout: \"%s\"; stderrsize=%u; stderr: \"%s\"",
1.111 paf 537: execution.status,
1.162 ! misha 538: (uint)file_out->length, file_out->str,
1.111 paf 539: (uint)real_err->length(), real_err->cstr());
540: break; //never reached
541: }
542:
543: int header_break_pos;
544: if(unix_header_break) {
545: header_break_pos=unix_pos;
546: eol_marker="\n"; eol_marker_size=1;
547: } else {
548: header_break_pos=dos_pos;
549: eol_marker="\r\n"; eol_marker_size=2;
550: }
1.21 paf 551:
1.162 ! misha 552: file_out->str[header_break_pos] = 0;
! 553: String *header=new String(file_out->str, header_break_pos);
! 554: unsigned long headersize = header_break_pos+eol_marker_size*2;
! 555: file_out->str += headersize;
! 556: file_out->length -= headersize;
! 557:
! 558: // body
! 559: self.set(false/*not tainted*/, file_out->str, file_out->length);
! 560:
! 561: // $fields << header
! 562: if(header && eol_marker) {
! 563: ArrayString rows;
! 564: size_t pos_after=0;
! 565: header->split(rows, pos_after, eol_marker);
! 566: Pass_cgi_header_attribute_info info={0, 0, 0};
! 567: info.charset=&r.charsets.source();
! 568: info.fields=&self.fields();
! 569: rows.for_each(pass_cgi_header_attribute, &info);
! 570: if(info.content_type)
! 571: self.fields().put(content_type_name, info.content_type);
! 572: }
! 573: } else {
! 574: self.set(false/*not tainted*/, file_out->str, file_out->length);
1.94 paf 575: }
1.21 paf 576:
1.42 parser 577: // $status
1.111 paf 578: self.fields().put(file_status_name, new VInt(execution.status));
1.21 paf 579:
580: // $stderr
1.111 paf 581: if(real_err->length())
1.21 paf 582: self.fields().put(
1.119 paf 583: String::Body("stderr"),
1.111 paf 584: new VString(*real_err));
1.21 paf 585: }
1.111 paf 586: static void _exec(Request& r, MethodParams& params) {
587: _exec_cgi(r, params, false);
1.41 parser 588: }
1.111 paf 589: static void _cgi(Request& r, MethodParams& params) {
590: _exec_cgi(r, params, true);
1.41 parser 591: }
592:
1.111 paf 593: static void _list(Request& r, MethodParams& params) {
594: Value& relative_path=params.as_no_junction(0, "path must not be code");
1.47 parser 595:
1.111 paf 596: const String* regexp;
1.47 parser 597: pcre *regexp_code;
1.81 paf 598: const int ovecsize=(1/*match*/)*3;
599: int ovector[ovecsize];
1.111 paf 600: if(params.count()>1) {
601: regexp=¶ms.as_no_junction(1, "regexp must not be code").as_string();
1.47 parser 602:
1.111 paf 603: const char* pattern=regexp->cstr();
604: const char* errptr;
1.47 parser 605: int erroffset;
606: regexp_code=pcre_compile(pattern, PCRE_EXTRA | PCRE_DOTALL,
607: &errptr, &erroffset,
1.111 paf 608: r.charsets.source().pcre_tables);
1.47 parser 609:
610: if(!regexp_code)
1.74 paf 611: throw Exception(0,
1.111 paf 612: ®exp->mid(erroffset, regexp->length()),
1.47 parser 613: "regular expression syntax error - %s", errptr);
1.114 paf 614: } else {
615: regexp=0; // not used, just to calm down compiler
1.47 parser 616: regexp_code=0;
1.114 paf 617: }
1.47 parser 618:
619:
1.111 paf 620: const char* absolute_path_cstr=r.absolute(relative_path.as_string()).cstr(String::L_FILE_SPEC);
1.47 parser 621:
1.111 paf 622: Table::columns_type columns(new ArrayString);
623: *columns+=new String("name");
624: Table& table=*new Table(columns);
1.47 parser 625:
626: LOAD_DIR(absolute_path_cstr,
1.111 paf 627: const char* file_name_cstr=ffblk.ff_name;
628: size_t file_name_size=strlen(file_name_cstr);
1.47 parser 629: bool suits=true;
630: if(regexp_code) {
631: int exec_result=pcre_exec(regexp_code, 0,
632: ffblk.ff_name, file_name_size, 0,
633: 0, ovector, ovecsize);
634:
635: if(exec_result==PCRE_ERROR_NOMATCH)
636: suits=false;
637: else if(exec_result<0) {
638: (*pcre_free)(regexp_code);
1.74 paf 639: throw Exception(0,
1.47 parser 640: regexp,
641: "regular expression execute (%d)",
642: exec_result);
643: }
644: }
645:
646: if(suits) {
1.111 paf 647: Table::element_type row(new ArrayString);
648: *row+=new String(pa_strdup(file_name_cstr, file_name_size), file_name_size, true);
649: table+=row;
1.47 parser 650: }
651: );
652:
653: if(regexp_code)
1.111 paf 654: pcre_free(regexp_code);
1.47 parser 655:
1.60 parser 656: // write out result
1.111 paf 657: r.write_no_lang(*new VTable(&table));
1.47 parser 658: }
1.21 paf 659:
1.69 paf 660: #ifndef DOXYGEN
661: struct Lock_execute_body_info {
1.111 paf 662: Request* r;
663: Value* body_code;
1.69 paf 664: };
665: #endif
1.111 paf 666: static void lock_execute_body(int , void *ainfo) {
667: Lock_execute_body_info& info=*static_cast<Lock_execute_body_info *>(ainfo);
1.69 paf 668: // execute body
1.78 paf 669: info.r->write_assign_lang(info.r->process(*info.body_code));
1.69 paf 670: };
1.111 paf 671: static void _lock(Request& r, MethodParams& params) {
1.152 misha 672: const String& file_spec=r.absolute(params.as_string(0, FILE_NAME_MUST_BE_STRING));
1.116 paf 673: Lock_execute_body_info info={
674: &r,
1.117 paf 675: ¶ms.as_junction(1, "body must be code")
1.116 paf 676: };
1.69 paf 677:
1.158 misha 678: file_write_action_under_lock(
679: file_spec,
680: "lock",
681: lock_execute_body,
682: &info);
1.69 paf 683: }
684:
1.111 paf 685: static int lastposafter(const String& s, size_t after, const char* substr, size_t substr_size, bool beforelast=false) {
1.114 paf 686: size_t size=0; // just to calm down compiler
1.89 paf 687: if(beforelast)
1.111 paf 688: size=s.length();
1.116 paf 689: size_t at;
1.112 paf 690: while((at=s.pos(String::Body(substr, substr_size), after))!=STRING_NOT_FOUND) {
1.89 paf 691: size_t newafter=at+substr_size/*skip substr*/;
692: if(beforelast && newafter==size)
693: break;
694: after=newafter;
695: }
696:
697: return after;
698: }
699:
1.111 paf 700: static void _find(Request& r, MethodParams& params) {
1.152 misha 701: const String& file_name=params.as_no_junction(0, FILE_NAME_MUST_NOT_BE_CODE).as_string();
1.111 paf 702: const String* file_spec;
1.90 paf 703: if(file_name.first_char()=='/')
704: file_spec=&file_name;
705: else
1.111 paf 706: file_spec=&r.relative(r.request_info.uri, file_name);
1.90 paf 707:
708: // easy way
1.142 paf 709: if(file_exist(r.absolute(*file_spec))) {
1.96 paf 710: r.write_assign_lang(*file_spec);
1.90 paf 711: return;
712: }
713:
714: // monkey way
715: int after_base_slash=lastposafter(*file_spec, 0, "/", 1);
1.111 paf 716: const String* dirname=&file_spec->mid(0, after_base_slash);
717: const String& basename=file_spec->mid(after_base_slash, file_spec->length());
1.90 paf 718:
719: int after_monkey_slash;
720: while((after_monkey_slash=lastposafter(*dirname, 0, "/", 1, true))>0) {
1.111 paf 721: String test_name;
722: test_name<<*(dirname=&dirname->mid(0, after_monkey_slash));
723: test_name<<basename;
1.142 paf 724: if(file_exist(r.absolute(test_name))) {
1.111 paf 725: r.write_assign_lang(test_name);
1.90 paf 726: return;
727: }
728: }
729:
730: // no way, not found
1.111 paf 731: if(params.count()==2) {
732: Value& not_found_code=params.as_junction(1, "not-found param must be code");
1.90 paf 733: r.write_pass_lang(r.process(not_found_code));
734: }
735: }
736:
1.111 paf 737: static void _dirname(Request& r, MethodParams& params) {
1.152 misha 738: const String& file_spec=params.as_string(0, FILE_NAME_MUST_BE_STRING);
1.89 paf 739: // /a/some.tar.gz > /a
740: // /a/b/ > /a
741: int afterslash=lastposafter(file_spec, 0, "/", 1, true);
742: if(afterslash>0)
743: r.write_assign_lang(file_spec.mid(0, afterslash==1?1:afterslash-1));
744: else
1.111 paf 745: r.write_assign_lang(String(".", 1));
1.89 paf 746: }
747:
1.111 paf 748: static void _basename(Request& r, MethodParams& params) {
1.152 misha 749: const String& file_spec=params.as_string(0, FILE_NAME_MUST_BE_STRING);
1.89 paf 750: // /a/some.tar.gz > some.tar.gz
751: int afterslash=lastposafter(file_spec, 0, "/", 1);
1.111 paf 752: r.write_assign_lang(file_spec.mid(afterslash, file_spec.length()));
1.89 paf 753: }
754:
1.111 paf 755: static void _justname(Request& r, MethodParams& params) {
1.152 misha 756: const String& file_spec=params.as_string(0, FILE_NAME_MUST_BE_STRING);
1.89 paf 757: // /a/some.tar.gz > some.tar
758: int afterslash=lastposafter(file_spec, 0, "/", 1);
759: int afterdot=lastposafter(file_spec, afterslash, ".", 1);
1.111 paf 760: r.write_assign_lang(file_spec.mid(afterslash, afterdot!=afterslash?afterdot-1:file_spec.length()));
1.89 paf 761: }
1.111 paf 762: static void _justext(Request& r, MethodParams& params) {
1.152 misha 763: const String& file_spec=params.as_string(0, FILE_NAME_MUST_BE_STRING);
1.89 paf 764: // /a/some.tar.gz > gz
765: int afterdot=lastposafter(file_spec, 0, ".", 1);
766: if(afterdot>0)
1.111 paf 767: r.write_assign_lang(file_spec.mid(afterdot, file_spec.length()));
1.89 paf 768: }
769:
1.111 paf 770: static void _fullpath(Request& r, MethodParams& params) {
1.152 misha 771: const String& file_spec=params.as_string(0, FILE_NAME_MUST_BE_STRING);
1.111 paf 772: const String* result;
1.102 paf 773: if(file_spec.first_char()=='/')
774: result=&file_spec;
775: else {
776: // /some/page.html: ^file:fullpath[a.gif] => /some/a.gif
777: const String& full_disk_path=r.absolute(file_spec);
1.111 paf 778: size_t document_root_length=strlen(r.request_info.document_root);
1.106 paf 779:
780: if(document_root_length>0) {
1.111 paf 781: char last_char=r.request_info.document_root[document_root_length-1];
1.106 paf 782: if(last_char == '/' || last_char == '\\')
783: --document_root_length;
784: }
1.111 paf 785: result=&full_disk_path.mid(document_root_length, full_disk_path.length());
1.102 paf 786: }
787: r.write_assign_lang(*result);
788: }
789:
1.121 paf 790: static void _sql_string(Request& r, MethodParams&) {
791: VFile& self=GET_SELF(r, VFile);
792:
793: const char *quoted=r.connection()->quote(self.value_ptr(), self.value_size());
794: r.write_assign_lang(*new String(quoted));
795: }
1.89 paf 796:
1.122 paf 797: #ifndef DOXYGEN
798: class File_sql_event_handlers: public SQL_Driver_query_event_handlers {
799: const String& statement_string; const char* statement_cstr;
800: int got_columns;
801: int got_cells;
802: public:
803: String::C value;
1.131 paf 804: const String* user_file_name;
805: const String* user_content_type;
1.122 paf 806: public:
807: File_sql_event_handlers(
808: const String& astatement_string, const char* astatement_cstr):
809: statement_string(astatement_string), statement_cstr(astatement_cstr),
810: got_columns(0),
811: got_cells(0),
812: user_file_name(0),
813: user_content_type(0) {}
814:
815: bool add_column(SQL_Error& error, const char* /*str*/, size_t /*length*/) {
816: if(got_columns++==3) {
1.156 misha 817: error=SQL_Error(PARSER_RUNTIME, "result must contain not more then 3 columns");
1.122 paf 818: return true;
819: }
820: return false;
821: }
822: bool before_rows(SQL_Error& /*error*/ ) { /* ignore */ return false; }
823: bool add_row(SQL_Error& /*error*/) { /* ignore */ return false; }
824: bool add_row_cell(SQL_Error& error, const char* str, size_t length) {
825: try {
826: switch(got_cells++) {
827: case 0:
828: value=String::C(str, length);
829: break;
830: case 1:
1.131 paf 831: if(!user_file_name) // user not specified?
832: user_file_name=new String(str, length, true);
1.122 paf 833: break;
834: case 2:
1.131 paf 835: if(!user_content_type) // user not specified?
836: user_content_type=new String(str, length, true);
1.122 paf 837: break;
838: default:
1.156 misha 839: error=SQL_Error(PARSER_RUNTIME, "result must not contain more then one row, three rows");
1.122 paf 840: return true;
841: }
842: return false;
843: } catch(...) {
844: error=SQL_Error("exception occured in File_sql_event_handlers::add_row_cell");
845: return true;
846: }
847: }
848: };
849: #endif
850: static void _sql(Request& r, MethodParams& params) {
1.131 paf 851: Value& statement=params.as_junction(0, "statement must be code");
1.122 paf 852:
853: Temp_lang temp_lang(r, String::L_SQL);
854: const String& statement_string=r.process_to_string(statement);
855: const char* statement_cstr=
856: statement_string.cstr(String::L_UNSPECIFIED, r.connection());
857: File_sql_event_handlers handlers(statement_string, statement_cstr);
1.131 paf 858:
859: if(params.count()>1)
860: if(HashStringValue* options=
1.161 misha 861: params.as_no_junction(1, PARAM_MUST_NOT_BE_CODE).get_hash()) {
1.131 paf 862: int valid_options=0;
863: if(Value* vfilename=options->get(NAME_NAME)) {
864: valid_options++;
865: handlers.user_file_name=&vfilename->as_string();
866: }
867: if(Value* vcontent_type=options->get(CONTENT_TYPE_NAME)) {
868: valid_options++;
869: handlers.user_content_type=&vcontent_type->as_string();
870: }
871: if(valid_options!=options->count())
1.156 misha 872: throw Exception(PARSER_RUNTIME,
1.131 paf 873: 0,
874: "called with invalid option");
875: }
876:
877:
1.122 paf 878: r.connection()->query(
1.123 paf 879: statement_cstr,
880: 0, 0,
881: 0, 0,
1.122 paf 882: handlers,
883: statement_string);
884:
885: if(!handlers.value)
1.156 misha 886: throw Exception(PARSER_RUNTIME,
1.122 paf 887: 0,
888: "produced no result");
889:
1.131 paf 890: const char* user_file_name_cstr=handlers.user_file_name? handlers.user_file_name->cstr(): 0;
1.122 paf 891:
892: VString* vcontent_type=handlers.user_content_type?
893: new VString(*handlers.user_content_type)
894: : user_file_name_cstr?
895: new VString(r.mime_type_of(user_file_name_cstr))
896: : 0;
897: VFile& self=GET_SELF(r, VFile);
898: self.set(true/*tainted*/, handlers.value.str, handlers.value.length, user_file_name_cstr, vcontent_type);
899: }
1.140 paf 900:
1.139 paf 901: static void _base64(Request& r, MethodParams& params) {
1.151 misha 902: bool dynamic = !(&r.get_self() == file_class);
903: if ( dynamic ){
1.140 paf 904: VFile& self=GET_SELF(r, VFile);
1.139 paf 905: if(params.count()) {
1.140 paf 906: // decode
1.160 misha 907: const char* cstr=params.as_string(0, PARAMETER_MUST_BE_STRING).cstr();
1.140 paf 908: char* decoded_cstr=0;
1.139 paf 909: size_t decoded_size=0;
910: pa_base64_decode(cstr, strlen(cstr), decoded_cstr, decoded_size);
911: if(decoded_cstr && decoded_size)
1.140 paf 912: self.set(true/*tainted*/, decoded_cstr, decoded_size);
913: } else {
914: // encode
915: const char* encoded=pa_base64_encode(self.value_ptr(), self.value_size());
916: r.write_assign_lang(*new String(encoded, 0, true/*once ?param=base64(something) was needed*/));
1.139 paf 917: }
1.151 misha 918: } else {
919: // encode
1.152 misha 920: const String& file_spec=params.as_string(0, FILE_NAME_MUST_BE_STRING);
1.151 misha 921: const char* encoded=pa_base64_encode(r.absolute(file_spec));
922: r.write_assign_lang(*new String(encoded, 0, true/*once ?param=base64(something) was needed*/));
923: }
1.139 paf 924: }
1.140 paf 925:
1.146 misha 926: static void _crc32(Request& r, MethodParams& params) {
927: unsigned long crc32 = 0;
928: if(&r.get_self() == file_class) {
929: // ^file:crc32[file-name]
930: if(params.count()) {
1.152 misha 931: const String& file_spec=params.as_string(0, FILE_NAME_MUST_BE_STRING);
1.146 misha 932: crc32=pa_crc32(r.absolute(file_spec));
933: } else {
1.156 misha 934: throw Exception(PARSER_RUNTIME,
1.146 misha 935: 0,
936: "file name must be defined");
937: }
938: } else {
939: // ^file.crc32[]
940: VFile& self=GET_SELF(r, VFile);
941: crc32=pa_crc32(self.value_ptr(), self.value_size());
942: }
943: r.write_no_lang(*new VInt(crc32));
944: }
945:
946:
1.147 misha 947: static void file_md5_file_action(
948: struct stat& finfo,
949: int f,
950: const String& , const char* /*fname*/, bool,
951: void *context)
952: {
953: PA_MD5_CTX& md5context=*static_cast<PA_MD5_CTX *>(context);
954: if(finfo.st_size) {
1.148 misha 955: int nCount=0;
1.147 misha 956: do {
957: unsigned char buffer[FILE_BUFFER_SIZE];
1.150 misha 958: nCount = file_block_read(f, buffer, sizeof(buffer));
1.147 misha 959: if ( nCount ){
960: pa_MD5Update(&md5context, (const unsigned char*)buffer, nCount);
961: }
1.148 misha 962: } while(nCount > 0);
1.147 misha 963: }
964: }
965:
966: const char* pa_md5(const String& file_spec)
967: {
968: PA_MD5_CTX context;
969: unsigned char digest[16];
970: pa_MD5Init(&context);
971: file_read_action_under_lock(file_spec, "md5", file_md5_file_action, &context);
972: pa_MD5Final(digest, &context);
973:
974: return hex_string(digest, sizeof(digest), false);
975: }
976:
977: const char* pa_md5(const char *in, size_t in_size)
978: {
979: PA_MD5_CTX context;
980: unsigned char digest[16];
981: pa_MD5Init(&context);
982: pa_MD5Update(&context, (const unsigned char*)in, in_size);
983: pa_MD5Final(digest, &context);
984:
985: return hex_string(digest, sizeof(digest), false);
986: }
987:
988: static void _md5(Request& r, MethodParams& params) {
989: const char* md5;
990: if(&r.get_self() == file_class) {
991: // ^file:md5[file-name]
992: if(params.count()) {
1.152 misha 993: const String& file_spec=params.as_string(0, FILE_NAME_MUST_BE_STRING);
1.147 misha 994: md5=pa_md5(r.absolute(file_spec));
995: } else {
1.156 misha 996: throw Exception(PARSER_RUNTIME,
1.147 misha 997: 0,
998: "file name must be defined");
999: }
1000: } else {
1001: // ^file.md5[]
1002: VFile& self=GET_SELF(r, VFile);
1003: md5=pa_md5(self.value_ptr(), self.value_size());
1004:
1005: }
1006: r.write_no_lang(*new String(md5));
1007: }
1008:
1.32 paf 1009: // constructor
1010:
1.111 paf 1011: MFile::MFile(): Methoded("file") {
1.146 misha 1012: // ^file::create[text;user-name;string]
1013: // ^file::create[binary;user-name;SOMEDAY SOMETHING]
1.138 paf 1014: add_native_method("create", Method::CT_DYNAMIC, _create, 3, 3);
1015:
1.146 misha 1016: // ^file.save[mode;file-name]
1.48 parser 1017: add_native_method("save", Method::CT_DYNAMIC, _save, 2, 2);
1.7 paf 1018:
1.146 misha 1019: // ^file:delete[file-name]
1.32 paf 1020: add_native_method("delete", Method::CT_STATIC, _delete, 1, 1);
1.45 parser 1021:
1.146 misha 1022: // ^file:move[from-file-name;to-file-name]
1.45 parser 1023: add_native_method("move", Method::CT_STATIC, _move, 2, 2);
1.8 paf 1024:
1.146 misha 1025: // ^file::load[mode;disk-name]
1026: // ^file::load[mode;disk-name;user-name]
1.48 parser 1027: add_native_method("load", Method::CT_DYNAMIC, _load, 2, 3);
1.25 paf 1028:
1.146 misha 1029: // ^file::stat[disk-name]
1.32 paf 1030: add_native_method("stat", Method::CT_DYNAMIC, _stat, 1, 1);
1.21 paf 1031:
1.162 ! misha 1032: // ^file::cgi[mode;file-name]
! 1033: // ^file::cgi[mode;file-name;env hash]
! 1034: // ^file::cgi[mode;file-name;env hash;1cmd;2line;3ar;4g;5s]
! 1035: add_native_method("cgi", Method::CT_DYNAMIC, _cgi, 1, 3+50);
! 1036:
! 1037: // ^file::exec[mode;file-name]
! 1038: // ^file::exec[mode;file-name;env hash]
! 1039: // ^file::exec[mode;file-name;env hash;1cmd;2line;3ar;4g;5s]
! 1040: add_native_method("exec", Method::CT_DYNAMIC, _exec, 1, 3+50);
1.47 parser 1041:
1042: // ^file:list[path]
1043: // ^file:list[path][regexp]
1044: add_native_method("list", Method::CT_STATIC, _list, 1, 2);
1.69 paf 1045:
1046: // ^file:lock[path]{code}
1047: add_native_method("lock", Method::CT_STATIC, _lock, 2, 2);
1.90 paf 1048:
1.146 misha 1049: // ^file:find[file-name]
1050: // ^file:find[file-name]{when-not-found}
1.90 paf 1051: add_native_method("find", Method::CT_STATIC, _find, 1, 2);
1.47 parser 1052:
1.89 paf 1053: // ^file:dirname[/a/some.tar.gz]=/a
1054: // ^file:dirname[/a/b/]=/a
1055: add_native_method("dirname", Method::CT_STATIC, _dirname, 1, 1);
1056: // ^file:basename[/a/some.tar.gz]=some.tar.gz
1057: add_native_method("basename", Method::CT_STATIC, _basename, 1, 1);
1058: // ^file:justname[/a/some.tar.gz]=some.tar
1059: add_native_method("justname", Method::CT_STATIC, _justname, 1, 1);
1060: // ^file:justext[/a/some.tar.gz]=gz
1061: add_native_method("justext", Method::CT_STATIC, _justext, 1, 1);
1.102 paf 1062: // /some/page.html: ^file:fullpath[a.gif] => /some/a.gif
1063: add_native_method("fullpath", Method::CT_STATIC, _fullpath, 1, 1);
1.121 paf 1064:
1065: // ^file.sql-string[]
1066: add_native_method("sql-string", Method::CT_DYNAMIC, _sql_string, 0, 0);
1.122 paf 1067:
1068: // ^file::sql[[alt_name]]{}
1069: add_native_method("sql", Method::CT_DYNAMIC, _sql, 1, 2);
1.139 paf 1070:
1.146 misha 1071: // ^file::base64[string] << decode
1.139 paf 1072: // ^file.base64[] << encode
1.151 misha 1073: // ^file:base64[file-name] << encode
1074: add_native_method("base64", Method::CT_ANY, _base64, 0, 1);
1.146 misha 1075:
1076: // ^file.crc32[]
1077: // ^file:crc32[file-name]
1078: add_native_method("crc32", Method::CT_ANY, _crc32, 0, 1);
1.147 misha 1079:
1080: // ^file.md5[]
1081: // ^file:md5[file-name]
1082: add_native_method("md5", Method::CT_ANY, _md5, 0, 1);
1083:
1.148 misha 1084: // ^file:copy[from-file-name;to-file-name]
1085: add_native_method("copy", Method::CT_STATIC, _copy, 2, 2);
1.1 paf 1086: }
E-mail:
![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to file.C CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [parser3project] / parser3 / src / classes