remove ilp scheduler; simplify listsched interface
[libfirm] / ir / be / scripts / generate_new_opcodes.pl
1 #!/usr/bin/perl -w
2
3 #
4 # Copyright (C) 1995-2008 University of Karlsruhe.  All right reserved.
5 #
6 # This file is part of libFirm.
7 #
8 # This file may be distributed and/or modified under the terms of the
9 # GNU General Public License version 2 as published by the Free Software
10 # Foundation and appearing in the file LICENSE.GPL included in the
11 # packaging of this file.
12 #
13 # Licensees holding valid libFirm Professional Edition licenses may use
14 # this file in accordance with the libFirm Commercial License.
15 # Agreement provided with the Software.
16 #
17 # This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
18 # WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR
19 # PURPOSE.
20 #
21
22 # This script generates the C code which creates the irop's and
23 # their coresponding node constructors for all operations in a given spec
24 # so they can be used as normal firm nodes.
25 # Creation: 2005/10/19
26 # $Id$
27
28 use strict;
29 use Data::Dumper;
30
31 my $specfile   = $ARGV[0];
32 my $target_dir = $ARGV[1];
33 my $state      = 1;
34 my $cur_op     = "";
35 my $line_nr    = 0;
36
37 our $arch;
38 our $additional_opcodes;
39 our %nodes;
40 our %operands;
41 our %cpu;
42 our $default_op_attr_type;
43 our $default_attr_type;
44 our $default_cmp_attr;
45 our $default_copy_attr;
46 our %init_attr;
47 our $custom_init_attr_func;
48 our %compare_attr;
49 our %copy_attr;
50 our %reg_classes;
51 our %custom_irn_flags;
52
53 # include spec file
54
55 my $return;
56
57 no strict "subs";
58 unless ($return = do $specfile) {
59         die "Fatal error: couldn't parse $specfile: $@" if $@;
60         die "Fatal error: couldn't do $specfile: $!"    unless defined $return;
61         die "Fatal error: couldn't run $specfile"       unless $return;
62 }
63 use strict "subs";
64
65 my $target_c = $target_dir."/gen_".$arch."_new_nodes.c.inl";
66 my $target_h = $target_dir."/gen_".$arch."_new_nodes.h";
67
68 if(!defined($default_attr_type)) {
69         $default_attr_type = "${arch}_attr_t";
70 }
71 if(!defined(%init_attr)) {
72         %init_attr = (
73                 "$default_attr_type" => "\tinit_${arch}_attributes(res, flags, in_reqs, exec_units, n_res);",
74         );
75 }
76 if(!defined($default_cmp_attr)) {
77         $default_cmp_attr = "${arch}_compare_attr";
78 }
79 if(!defined(%compare_attr)) {
80         %compare_attr = (
81                 "${default_attr_type}" => "${default_cmp_attr}",
82         );
83 }
84
85 # Operands are really just nodes with some special constraints, we check
86 # these and create new entries in the nodes hashmap
87 foreach my $op (keys(%operands)) {
88         my %operand = %{ $operands{"$op"} };
89         my %op_node;
90
91         # constraints
92         if(defined($operand{op_flags})) { die "Fatal error: operands can't have op_flags ($op)"; }
93         if(defined($operand{cmp_attr})) { die "Fatal error: cmp_attr not allowed for operands ($op)"; }
94         if(defined($operand{mode})) { die "Operand must not have a mode defined ($op)"; }
95         if(defined($operand{out_arity})) { die "operand must not have out_arity defined ($op)"; }
96         if(defined($nodes{$op})) { die "$op defined as operand and as node"; };
97
98
99         foreach my $flag (keys(%operand)) {
100                 $op_node{$flag} = $operand{$flag};
101         }
102         $op_node{op_flags} = "O";
103         $op_node{cmp_attr} = 'return 1;';
104         $op_node{mode}     = 'mode_ANY';
105
106         $nodes{$op} = \%op_node;
107 }
108
109 #print Dumper(%nodes);
110 #print Dumper(%operands);
111
112 # create c code file from specs
113
114 my @obst_limit_func;
115 my @obst_reg_reqs;
116 my @obst_opvar;       # stack for the "ir_op *op_<arch>_<op-name> = NULL;" statements
117 my @obst_get_opvar;   # stack for the get_op_<arch>_<op-name>() functions
118 my $obst_constructor; # stack for node constructor functions
119 my @obst_new_irop;    # stack for the new_ir_op calls
120 my @obst_enum_op;     # stack for creating the <arch>_opcode enum
121 my $obst_header;      # stack for function prototypes
122 my @obst_is_archirn;  # stack for the is_$arch_irn() function
123 my @obst_cmp_attr;    # stack for the compare attribute functions
124 my $obst_proj = "";   # stack for the pn_ numbers
125 my $orig_op;
126 my $arity;
127 my $cmp_attr_func;
128 my $temp;
129 my $n_opcodes = 0;    # number of opcodes
130 my $ARITY_VARIABLE = -1;
131 my $ARITY_DYNAMIC  = -2;
132 my %requirements = ();
133 my %limit_bitsets = ();
134 my %reg2class = ();
135 my %regclass2len = ();
136
137 # build register->class hashes
138 foreach my $class_name (keys(%reg_classes)) {
139         my @class         = @{ $reg_classes{"$class_name"} };
140         my $old_classname = $class_name;
141
142         pop(@class);
143
144         $class_name = $arch."_".$class_name;
145
146         my $idx = 0;
147         foreach (@class) {
148                 $reg2class{$_->{name}} = {
149                         "class" => $old_classname,
150                         "index" => $idx
151                 };
152                 $idx++;
153         }
154
155         $regclass2len{$old_classname} = $idx;
156 }
157
158
159 # for registering additional opcodes
160 $n_opcodes += $additional_opcodes if (defined($additional_opcodes));
161
162 $obst_header .= "void ${arch}_create_opcodes(const arch_irn_ops_t *be_ops);\n";
163
164 sub create_constructor {
165         my $op   = shift;
166         my $name = shift;
167         my $n    = shift;
168         my $on   = shift;
169         my $known_mode;
170
171         my $suffix = "";
172         if ($name ne "") {
173                 $suffix = "_${name}";
174         }
175
176         # determine mode
177         if (exists($n->{mode})) {
178                 $known_mode = $n->{mode};
179         }
180
181         # determine arity
182         my $arity = 0;
183         if(exists($n->{"arity"})) {
184                 $arity = $n->{"arity"};
185         } elsif (exists($n->{"reg_req"}) && exists($n->{"reg_req"}{"in"})) {
186                 $arity = scalar(@{ $n->{"reg_req"}{"in"} });
187         } elsif (exists($n->{"ins"})) {
188                 $arity = scalar(@{ $n->{"ins"} });
189         }
190         if($arity eq "variable") {
191                 $arity = $ARITY_VARIABLE;
192         } elsif($arity eq "dynamic") {
193                 $arity = $ARITY_DYNAMIC;
194         }
195
196         # determine out arity
197         my $out_arity = 0;
198         if(exists($n->{"out_arity"})) {
199                 $out_arity = $n->{"out_arity"};
200         } elsif (exists($n->{"reg_req"}) && exists($n->{"reg_req"}{"out"})) {
201                 $out_arity = scalar(@{ $n->{"reg_req"}{"out"} });
202         } elsif (exists($n->{"outs"})) {
203                 $out_arity = scalar(@{ $n->{"outs"} });
204         }
205         if($out_arity eq "variable") {
206                 $out_arity = $ARITY_VARIABLE;
207         } elsif($out_arity eq "dynamic") {
208                 $out_arity = $ARITY_DYNAMIC;
209         }
210         if ($out_arity != 0 && $out_arity != 1 && !defined($known_mode)) {
211                 $known_mode = "mode_T";
212         }
213
214         my $comment = $n->{"comment"};
215         if(!exists($n->{"comment"})) {
216                 $comment = "construct ${orig_op} node";
217         }
218         $comment =
219                 "/**\n".
220                 " * ${comment}\n".
221                 " */\n";
222
223         $obst_constructor .= $comment;
224
225         # create constructor head
226         my $complete_args = "";
227         $temp             = "";
228
229         $temp = "ir_node *new_bd_${arch}_${op}${suffix}(dbg_info *dbgi, ir_node *block";
230         if (!exists($n->{"args"})) { # default args
231                 if ($arity == $ARITY_VARIABLE) {
232                         $complete_args = ", int arity, ir_node *in[]";
233                 } elsif ($arity == $ARITY_DYNAMIC) {
234                         $complete_args = "";
235                 } else {
236                         for (my $i = 0; $i < $arity; $i++) {
237                                 my $opname = "op${i}";
238                                 if (exists($n->{"ins"})) {
239                                         my @ins = @{ $n->{"ins"} };
240                                         $opname = $ins[$i];
241                                 }
242
243                                 $complete_args .= ", ir_node *${opname}";
244                         }
245                 }
246                 if ($out_arity == $ARITY_VARIABLE) {
247                         $complete_args .= ", int n_res";
248                 }
249
250                 if (!defined($known_mode)) {
251                         $complete_args .= ", ir_mode *mode";
252                 }
253         } else { # user defined args
254                 for my $href (@{ $n->{"args"} }) {
255                         $href->{"type"} .= " " if ($href->{"type"} !~ / [*]?$/); # put a space between name and type if there is none at the end
256                         $complete_args  .= ", ".$href->{"type"}.$href->{"name"};
257                 }
258         }
259
260         # we have additional attribute arguements
261         if (exists($n->{"attr"})) {
262                 $complete_args .= ", ".$n->{"attr"};
263         }
264
265         $temp .= "$complete_args)";
266         $obst_constructor .= "${temp}\n{\n";
267
268         $obst_header .= $comment;
269         $obst_header .= "${temp};\n";
270
271         # emit constructor code
272         $temp = <<EOF;
273         ir_node        *res;
274         ir_op          *op      = op_${arch}_${op};
275         int             flags   = 0;
276         backend_info_t *info;
277 EOF
278
279         if($arity == $ARITY_DYNAMIC) {
280                 $temp .= <<EOF;
281         int             arity   = -1;
282         ir_node       **in      = NULL;
283 EOF
284         } elsif($arity == $ARITY_VARIABLE) {
285         } else {
286                 $temp .= <<EOF;
287         int             arity   = $arity;
288 EOF
289                 if($arity > 0) {
290                         $temp .= <<EOF;
291         ir_node        *in[$arity];
292 EOF
293                 } else {
294                         $temp .= <<EOF;
295         ir_node       **in      = NULL;
296 EOF
297                 }
298         }
299         if($out_arity == $ARITY_DYNAMIC) {
300                 $temp .= <<EOF;
301         int             n_res   = -1;
302 EOF
303         } elsif($out_arity == $ARITY_VARIABLE) {
304         } else {
305                 $temp .= <<EOF;
306         int             n_res   = ${out_arity};
307 EOF
308         }
309
310         if (defined($known_mode)) {
311                 $temp .= <<EOF;
312         ir_mode        *mode    = ${known_mode};
313 EOF
314         }
315
316         # set up static variables for cpu execution unit assigments
317         if (exists($n->{"units"})) {
318                 $temp .= gen_execunit_list_initializer($n->{"units"});
319         } else {
320                 $temp .= <<EOF;
321         static const be_execution_unit_t ***exec_units = NULL;
322 EOF
323         }
324
325         undef my $in_req_var;
326         undef my $out_req_var;
327
328         my $set_out_reqs = "";
329
330         # set up static variables for requirements and registers
331         if (exists($n->{"reg_req"})) {
332                 my %req = %{ $n->{"reg_req"} };
333                 my $idx;
334
335                 undef my @in;
336                 @in = @{ $req{"in"} } if (exists($req{"in"}));
337                 undef my @out;
338                 @out = @{ $req{"out"} } if exists(($req{"out"}));
339
340                 for(my $idx = 0; $idx < $#in; $idx++) {
341                         my $req = $in[$idx];
342                         generate_requirements($req, $n, "${arch}_${op}", $idx, 1);
343                 }
344                 for(my $idx = 0; $idx < $#out; $idx++) {
345                         my $req = $out[$idx];
346                         generate_requirements($req, $n, "${arch}_${op}", $idx, 0);
347                 }
348
349                 if (@in) {
350                         if($arity >= 0 && scalar(@in) != $arity) {
351                                 die "Fatal error: Arity and number of in requirements don't match for ${op}\n";
352                         }
353
354                         $temp .= "\tstatic const arch_register_req_t *in_reqs[] =\n";
355                         $temp .= "\t{\n";
356                         for ($idx = 0; $idx <= $#in; $idx++) {
357                                 my $req = $in[$idx];
358                                 my $reqstruct = generate_requirements($req, $n, "${arch}_${op}", $idx, 1);
359                                 $temp .= "\t\t& ${reqstruct},\n";
360                         }
361                         $temp .= "\t};\n";
362                 } else {
363                         if($arity > 0) {
364                                 die "Fatal error: need in requirements for ${op}\n";
365                         }
366                         $temp .= "\tstatic const arch_register_req_t **in_reqs = NULL;\n";
367                 }
368
369                 if (@out) {
370                         if($out_arity >= 0 && scalar(@out) != $out_arity) {
371                                 die "Fatal error: Out-Arity and number of out requirements don't match for ${op}\n";
372                         }
373
374                         for ($idx = 0; $idx <= $#out; $idx++) {
375                                 my $req = $out[$idx];
376                                 my $reqstruct = generate_requirements($req, $n, "${arch}_${op}", $idx, 0);
377                                 $set_out_reqs .= <<EOF;
378 info->out_infos[${idx}].req = &${reqstruct};
379 EOF
380                         }
381                 } else {
382                         if($out_arity > 0) {
383                                 die "Fatal error: need out requirements for ${op}\n";
384                         }
385                 }
386         } else {
387                 $temp .= "\tstatic const arch_register_req_t **in_reqs = NULL;\n";
388         }
389         my $attr_type = $on->{attr_type};
390         if(exists($n->{"init_attr"})) {
391                 $temp .= "\t${attr_type} *attr;\n";
392         }
393
394         $temp .= "\n";
395
396         if($arity > 0) {
397                 $temp .= "\t/* construct in array */\n";
398                 for (my $i = 0; $i < $arity; $i++) {
399                         my $opname = "op${i}";
400                         if (exists($n->{"ins"})) {
401                                 my @ins = @{ $n->{"ins"} };
402                                 $opname = $ins[$i];
403                         }
404
405                         $temp .= "\tin[${i}] = ${opname};\n";
406                 }
407                 $temp .= "\n";
408         }
409
410         # set flags
411         if (exists($n->{"irn_flags"})) {
412                 $temp .= "\t/* flags */\n";
413                 my %known_irn_flags = (
414                         "none"             => "arch_irn_flags_none",
415                         "dont_spill"       => "arch_irn_flags_dont_spill",
416                         "rematerializable" => "arch_irn_flags_rematerializable",
417                         "modify_flags"     => "arch_irn_flags_modify_flags",
418                         "simple_jump"      => "arch_irn_flags_simple_jump",
419                         "not_scheduled"    => "arch_irn_flags_not_scheduled",
420                 );
421                 if (defined(%custom_irn_flags)) {
422                         %known_irn_flags = (%known_irn_flags, %custom_irn_flags);
423                 }
424                 foreach my $flag (@{$n->{"irn_flags"}}) {
425                         if (not defined($known_irn_flags{$flag})) {
426                                 print STDERR "WARNING: irn_flag '$flag' in opcode $op is unknown\n";
427                         } else {
428                                 $temp .= "\tflags |= " . $known_irn_flags{$flag} . ";\n";
429                         }
430                 }
431                 $temp .= "\n";
432         }
433
434         # lookup init function
435         my $attr_init_code = $init_attr{$attr_type};
436         if(!defined($attr_init_code)) {
437                 die "Fatal error: Couldn't find attribute initialisation code for type '${attr_type}'";
438         }
439         my $custominit = "";
440         if(defined($custom_init_attr_func)) {
441                 $custominit .= &$custom_init_attr_func($n, $on, "${arch}_${op}");
442         }
443         if(defined($n->{custominit})) {
444                 $custominit .= $n->{custominit};
445         }
446
447         $temp .= <<EOF;
448         /* create node */
449         assert(op != NULL);
450         res = new_ir_node(dbgi, current_ir_graph, block, op, mode, arity, in);
451
452         /* init node attributes */
453         ${attr_init_code}
454         ${custominit}
455         info = be_get_info(res);
456         (void) info; /* avoid potential warning */
457         ${set_out_reqs}
458
459 EOF
460
461         if (exists($n->{"init_attr"})) {
462                 $temp .= "\tattr = get_irn_generic_attr(res);\n";
463                 $temp .= "\t".$n->{"init_attr"}."\n";
464         }
465
466         $temp .= <<EOF;
467         /* optimize node */
468         res = optimize_node(res);
469         irn_verify_irg(res, current_ir_graph);
470
471         return res;
472 EOF
473
474         $obst_constructor .= $temp;
475
476         # close constructor function
477         $obst_constructor .= "}\n\n";
478 }
479
480 push(@obst_enum_op, "typedef enum ${arch}_opcodes {\n");
481 foreach my $op (keys(%nodes)) {
482         my %n        = %{ $nodes{"$op"} };
483         my $known_mode;
484         my $num_outs = 0;
485         my $out_arity;
486         my @out_flags;
487
488         # determine arity
489         $arity = 0;
490         if(exists($n{"arity"})) {
491                 $arity = $n{"arity"};
492         } elsif (exists($n{"reg_req"}) && exists($n{"reg_req"}{"in"})) {
493                 $arity = scalar(@{ $n{"reg_req"}{"in"} });
494         } elsif (exists($n{"ins"})) {
495                 $arity = scalar(@{ $n{"ins"} });
496         }
497         if($arity eq "variable") {
498                 $arity = $ARITY_VARIABLE;
499         } elsif($arity eq "dynamic") {
500                 $arity = $ARITY_DYNAMIC;
501         }
502
503         # determine out arity
504         $out_arity = 0;
505         if(exists($n{"out_arity"})) {
506                 $out_arity = $n{"out_arity"};
507         } elsif (exists($n{"reg_req"}) && exists($n{"reg_req"}{"out"})) {
508                 $out_arity = scalar(@{ $n{"reg_req"}{"out"} });
509         } elsif (exists($n{"outs"})) {
510                 $out_arity = scalar(@{ $n{"outs"} });
511         }
512         if($out_arity eq "variable") {
513                 $out_arity = $ARITY_VARIABLE;
514         } elsif($out_arity eq "dynamic") {
515                 $out_arity = $ARITY_DYNAMIC;
516         }
517
518         $orig_op = $op;
519         $op      = $arch."_".$op;
520         $temp    = "";
521
522         # define proj numbers and in numbers
523         if (exists($n{"outs"})) {
524                 undef my @outs;
525
526                 @outs = @{ $n{"outs"} };
527                 if($out_arity >= 0 && scalar(@outs) != $out_arity) {
528                         die "Fatal error: Op ${op} has different number of outs and out_arity\n";
529                 }
530
531                 $num_outs = $#outs + 1;
532
533                 $obst_proj .= "\nenum pn_${op} {\n";
534
535                 for (my $idx = 0; $idx <= $#outs; $idx++) {
536                         # check, if we have additional flags annotated to out
537                         if ($outs[$idx] =~ /:((S|I)(\|(S|I))*)/) {
538                                 push(@out_flags, $1);
539                                 $outs[$idx] =~ s/:((S|I)(\|(S|I))*)//;
540                         }
541                         $obst_proj .= "\tpn_${op}_".$outs[$idx]." = ${idx},\n";
542                 }
543
544                 $obst_proj .= "};\n";
545                 # outs have names, it must be a mode_T node
546                 if (!defined($n{mode})) {
547                         $n{mode} = "mode_T";
548                 }
549         }
550         if (exists($n{"ins"})) {
551                 undef my @ins;
552
553                 @ins = @{ $n{"ins"} };
554                 if($arity >= 0 && scalar(@ins) != $arity) {
555                         die "Fatal error: Op ${op} has different number of ins and arity\n";
556                 }
557
558                 $obst_proj .= "\nenum n_$op {\n";
559                 for (my $idx = 0; $idx <= $#ins; $idx++) {
560                         $obst_proj .= "\tn_${op}_".$ins[$idx]." = ${idx},\n";
561                 }
562                 $obst_proj .= "};\n";
563         }
564
565         # Create opcode
566         push(@obst_opvar, "ir_op *op_$op = NULL;\n");
567         push(@obst_get_opvar, "ir_op *get_op_$op(void)         { return op_$op; }\n");
568         push(@obst_get_opvar, "int    is_$op(const ir_node *n) { return get_$arch\_irn_opcode(n) == iro_$op; }\n\n");
569
570         push(@obst_is_archirn, "is_$op(node)");
571
572         $obst_header .= <<EOF;
573 extern ir_op *op_${op};
574 ir_op *get_op_${op}(void);
575 int is_${op}(const ir_node *n);
576 EOF
577
578         my $attr_type= $n{attr_type};
579         if(!defined($attr_type)) {
580                 $attr_type = $default_attr_type;
581                 $n{attr_type} = $attr_type;
582         }
583
584         # determine hash function
585         my $hash_func;
586         if (exists($n{"hash_func"})) {
587                 $hash_func = $n{"hash_func"};
588         }
589
590         # determine compare function
591         my $cmp_attr_func;
592         if (exists($n{"cmp_attr"})) {
593                 my $cmpcode = $n{"cmp_attr"};
594
595                 push(@obst_cmp_attr, "static int cmp_attr_$op(ir_node *a, ir_node *b) {\n");
596                 if($cmpcode =~ m/attr_a/) {
597                         push(@obst_cmp_attr, "\t${attr_type} *attr_a = get_irn_generic_attr(a);\n");
598                 } else {
599                         push(@obst_cmp_attr, "\t(void) a;\n");
600                 }
601                 if($cmpcode =~ m/attr_b/) {
602                         push(@obst_cmp_attr, "\t${attr_type} *attr_b = get_irn_generic_attr(b);\n");
603                 } else {
604                         push(@obst_cmp_attr, "\t(void) b;\n");
605                 }
606                 push(@obst_cmp_attr, "\t${cmpcode}\n");
607                 push(@obst_cmp_attr, "}\n\n");
608
609                 $cmp_attr_func = "cmp_attr_${op}";
610         } else {
611                 if(defined($compare_attr{${attr_type}})) {
612                         $cmp_attr_func = $compare_attr{${attr_type}};
613                 } else {
614                         die "Fatal error: No compare function defined for ${attr_type} attributes.";
615                 }
616         }
617
618         my %constructors;
619         if (exists($n{constructors})) {
620                 %constructors = %{ $n{constructors} };
621         } else {
622                 # Create 1 default constructor
623                 my %constructor = ();
624                 foreach my $a ("comment", "ins", "outs", "args", "attr", "units",
625                                 "reg_req", "init_attr", "irn_flags", "mode", "arity",
626                                 "out_arity", "custominit") {
627                         if (defined($n{$a})) {
628                                 $constructor{$a} = $n{$a};
629                         }
630                 }
631                 %constructors = ( "" => \%constructor );
632         }
633
634         foreach my $constr (keys(%constructors)) {
635                 my %cstr = %{ $constructors{$constr} };
636                 # Copy some values from outer node if they don't exists in the constr
637                 foreach my $a ("ins", "outs", "irn_flags", "mode", "args", "attr",
638                                "custominit") {
639                         if (!defined($cstr{$a}) && defined($n{$a})) {
640                                 $cstr{$a} = $n{$a};
641                         }
642                 }
643                 create_constructor($orig_op, $constr, \%cstr, \%n);
644         }
645
646         # set default values for state and flags if not given
647         $n{"state"}    = "floats" if (! exists($n{"state"}));
648         $n{"op_flags"} = ["none"] if (! exists($n{"op_flags"}));
649
650         push(@obst_new_irop, "\n\tmemset(&ops, 0, sizeof(ops));\n");
651         push(@obst_new_irop, "\tops.be_ops        = be_ops;\n");
652         push(@obst_new_irop, "\tops.dump_node     = $arch\_dump_node;\n");
653
654         if (defined($cmp_attr_func)) {
655                 push(@obst_new_irop, "\tops.node_cmp_attr = ${cmp_attr_func};\n");
656         }
657         my $copy_attr_func = $copy_attr{$attr_type};
658         if (!defined($copy_attr_func)) {
659                 $copy_attr_func = $default_copy_attr;
660         }
661         if (defined($copy_attr_func)) {
662                 push(@obst_new_irop, "\tops.copy_attr = ${copy_attr_func};\n");
663         }
664         if (defined($hash_func)) {
665                 push(@obst_new_irop, "\tops.hash = ${hash_func};\n");
666         }
667
668         my %known_flags = map { $_ => 1 } (
669                 "none", "labeled", "commutative", "cfopcode", "op_cfopcode",
670                 "fragile", "forking", "highlevel", "constlike", "always_opt",
671                 "keep", "start_block", "uses_memory", "dump_noblock",
672                 "dump_noinput", "machine", "machine_op", "cse_neutral"
673         );
674         foreach my $flag (@{$n{"op_flags"}}) {
675                 if (not defined($known_flags{$flag})) {
676                         print STDERR "WARNING: Flag '$flag' in opcode $op is unknown\n";
677                 }
678         }
679         my @mapped = map { "irop_flag_$_" } @{$n{"op_flags"}};
680         my $op_flags = join('|', @mapped);
681
682         $n_opcodes++;
683         $temp  = "\top_$op = new_ir_op(cur_opcode + iro_$op, \"$op\", op_pin_state_".$n{"state"}.", $op_flags";
684         $temp .= "|irop_flag_machine, ".translate_arity($arity).", 0, sizeof(${attr_type}), &ops);\n";
685         push(@obst_new_irop, $temp);
686         push(@obst_new_irop, "\tset_op_tag(op_$op, $arch\_op_tag);\n");
687         if(defined($default_op_attr_type)) {
688                 push(@obst_new_irop, "\tattr = &attrs[iro_$op];\n");
689                 if(defined($n{op_attr_init})) {
690                         push(@obst_new_irop, "\t".$n{op_attr_init}."\n");
691                 }
692                 push(@obst_new_irop, "\tset_op_attr(op_$op, attr);\n");
693         }
694
695         push(@obst_enum_op, "\tiro_$op,\n");
696
697         $obst_header .= "\n";
698 }
699 push(@obst_enum_op, "\tiro_$arch\_last_generated,\n");
700 push(@obst_enum_op, "\tiro_$arch\_last = iro_$arch\_last_generated");
701 push(@obst_enum_op, " + $additional_opcodes") if (defined($additional_opcodes));
702 push(@obst_enum_op, "\n} $arch\_opcodes;\n\n");
703
704 # emit the code
705
706 open(OUT, ">$target_c") || die("Fatal error: Could not open $target_c, reason: $!\n");
707
708 print OUT "#include \"gen_$arch\_regalloc_if.h\"\n";
709 print OUT "#include \"irverify_t.h\"\n";
710 print OUT "\n";
711 print OUT @obst_cmp_attr;
712 print OUT "\n";
713 print OUT @obst_opvar;
714 print OUT "\n";
715 print OUT @obst_get_opvar;
716 print OUT "\n";
717
718 print OUT<<EOF;
719
720 static int $arch\_opcode_start = -1;
721 static int $arch\_opcode_end   = -1;
722
723 EOF
724
725 # build the FOURCC arguments from $arch
726
727 my ($a, $b, $c, $d) = ('\0', '\0', '\0', '\0');
728
729 if (length($arch) >= 1) {
730         $a = uc(substr($arch, 0, 1));
731 }
732
733 if (length($arch) >= 2) {
734         $b = uc(substr($arch, 1, 1));
735 }
736
737 if (length($arch) >= 3) {
738         $c = uc(substr($arch, 2, 1));
739 }
740
741 if (length($arch) >= 4) {
742         $d = uc(substr($arch, 3, 1));
743 }
744
745 print OUT<<ENDOFISIRN;
746
747 /** A tag for the $arch opcodes. Note that the address is used as a tag value, NOT the FOURCC code. */
748 #define $arch\_op_tag FOURCC('$a', '$b', '$c', '$d')
749
750 /** Return the opcode number of the first $arch opcode. */
751 int get_$arch\_opcode_first(void) {
752         return $arch\_opcode_start;
753 }
754
755 /** Return the opcode number of the last $arch opcode + 1. */
756 int get_$arch\_opcode_last(void) {
757         return $arch\_opcode_end;
758 }
759
760 /** Return 1 if the given opcode is a $arch machine op, 0 otherwise */
761 int is_$arch\_op(const ir_op *op) {
762         return get_op_tag(op) == $arch\_op_tag;
763 }
764
765 /** Return 1 if the given node is a $arch machine node, 0 otherwise */
766 int is_$arch\_irn(const ir_node *node) {
767         return is_$arch\_op(get_irn_op(node));
768 }
769
770 int get_$arch\_irn_opcode(const ir_node *node) {
771         if (is_$arch\_irn(node))
772                 return get_irn_opcode(node) - $arch\_opcode_start;
773         return -1;
774 }
775
776 ENDOFISIRN
777
778 print OUT <<END;
779 #ifdef BIT
780 #undef BIT
781 #endif
782 #define BIT(x)  (1 << (x % 32))
783
784 END
785
786 print OUT @obst_limit_func;
787 print OUT "\n";
788
789 print OUT @obst_reg_reqs;
790 print OUT "\n";
791
792 print OUT<<ENDOFMAIN;
793 $obst_constructor
794
795 /**
796  * Creates the $arch specific Firm machine operations
797  * needed for the assembler irgs.
798  */
799 void $arch\_create_opcodes(const arch_irn_ops_t *be_ops) {
800 #define N   irop_flag_none
801 #define L   irop_flag_labeled
802 #define C   irop_flag_commutative
803 #define X   irop_flag_cfopcode
804 #define F   irop_flag_fragile
805 #define Y   irop_flag_forking
806 #define H   irop_flag_highlevel
807 #define c   irop_flag_constlike
808 #define K   irop_flag_keep
809 #define M   irop_flag_machine
810 #define O   irop_flag_machine_op
811 #define NB  irop_flag_dump_noblock
812 #define NI  irop_flag_dump_noinput
813 #define n   irop_flag_cse_neutral
814 #define R   (irop_flag_user << 0)
815
816         ir_op_ops  ops;
817         int        cur_opcode;
818         static int run_once = 0;
819 ENDOFMAIN
820
821         if (defined($default_op_attr_type)) {
822                 print OUT "\t$default_op_attr_type *attr, *attrs;\n";
823         }
824
825 print OUT<<ENDOFMAIN;
826
827         if (run_once)
828                 return;
829         run_once = 1;
830
831         cur_opcode = get_next_ir_opcodes(iro_$arch\_last);
832
833         $arch\_opcode_start = cur_opcode;
834 ENDOFMAIN
835
836         if (defined($default_op_attr_type)) {
837                 print OUT "\tattrs = xmalloc(sizeof(attr[0]) * iro_$arch\_last);\n";
838                 print OUT "\tmemset(attrs, 0, sizeof(attr[0]) * iro_$arch\_last);\n";
839         }
840
841 print OUT @obst_new_irop;
842 print OUT "\n";
843 print OUT "\t$arch\_register_additional_opcodes(cur_opcode);\n" if (defined($additional_opcodes));
844 print OUT "\t$arch\_opcode_end = cur_opcode + iro_$arch\_last";
845 print OUT " + $additional_opcodes" if (defined($additional_opcodes));
846 print OUT ";\n";
847 print OUT "}\n";
848
849 close(OUT);
850
851 open(OUT, ">$target_h") || die("Fatal error: Could not open $target_h, reason: $!\n");
852
853 my $creation_time = localtime(time());
854 my $tmp = uc($arch);
855
856 print OUT<<EOF;
857 /**
858  * \@file
859  * \@brief Function prototypes for the new opcode functions.
860  * \@note  DO NOT EDIT THIS FILE, your changes will be lost.
861  *        Edit $specfile instead.
862  *        created by: $0 $specfile $target_dir
863  * \@date  $creation_time
864  */
865 #ifndef FIRM_BE_${tmp}_GEN_${tmp}_NEW_NODES_H
866 #define FIRM_BE_${tmp}_GEN_${tmp}_NEW_NODES_H
867
868 EOF
869
870 print OUT @obst_enum_op;
871 print OUT <<EOF;
872 int is_${arch}_irn(const ir_node *node);
873 int is_${arch}_op(const ir_op *op);
874
875 int get_${arch}_opcode_first(void);
876 int get_${arch}_opcode_last(void);
877 int get_${arch}_irn_opcode(const ir_node *node);
878 ${obst_header}
879 ${obst_proj}
880
881 #endif
882 EOF
883
884 close(OUT);
885
886 ###
887 # Translates numeric arity into string constant.
888 ###
889 sub translate_arity {
890         my $arity = shift;
891
892         if ($arity =~ /^\d+$/) {
893                 if    ($arity == 0) {
894                         return "oparity_zero";
895                 }
896                 elsif ($arity == 1) {
897                         return "oparity_unary";
898                 }
899                 elsif ($arity == 2) {
900                         return "oparity_binary";
901                 }
902                 elsif ($arity == 3) {
903                         return "oparity_trinary";
904                 }
905                 else {
906                         return "oparity_any";
907                 }
908         } elsif ($arity == $ARITY_VARIABLE) {
909                 return "oparity_variable";
910         } elsif ($arity == $ARITY_DYNAMIC) {
911                 return "oparity_dynamic";
912         } else {
913                 die "Fatal error: Unknown arity $arity";
914         }
915 }
916
917 ###
918 # Return the list of pointers for the given execution units.
919 ###
920 sub gen_execunit_list_initializer {
921         my $units   = shift;
922         my $uc_arch = uc($arch);
923         my $ret     = "";
924         my $ret2    = "";
925         my %init;
926
927         foreach my $unit (@{ $units }) {
928                 if ($unit eq "DUMMY") {
929                         push(@{ $init{"DUMMY"} }, "\t\t&be_machine_execution_units_DUMMY[0]");
930                 }
931                 elsif (exists($cpu{"$unit"})) {
932                         # operation can be executed on all units of this type
933                         # -> add them all
934                         my $tp_name = "$arch\_execution_units_$unit";
935                         my $idx     = 0;
936                         foreach (@{ $cpu{"$unit"} }) {
937                                 next if ($idx++ == 0);  # skip first element (it's not a unit)
938                                 my $unit_name = "$uc_arch\_EXECUNIT_TP_$unit\_$_";
939                                 push(@{ $init{"$unit"} }, "\t\t&".$tp_name."[".$unit_name."]");
940                         }
941                 }
942                 else {
943                         # operation can be executed only a certain unit
944                         # -> find corresponding unit type
945                         my $found = 0;
946 TP_SEARCH:      foreach my $cur_type (keys(%cpu)) {
947                                 foreach my $cur_unit (@{ $cpu{"$cur_type"} }) {
948                                         if ($unit eq $cur_unit) {
949                                                 my $tp_name   = "$arch\_execution_units_$cur_type";
950                                                 my $unit_name = "$uc_arch\_EXECUNIT_TP_$cur_type\_$unit";
951                                                 push(@{ $init{"$unit"} }, "\t\t&".$tp_name."[".$unit_name."]");
952                                                 $found = 1;
953                                                 last TP_SEARCH;
954                                         }
955                                 }
956                         }
957
958                         if (! $found) {
959                                 print STDERR "Invalid execution unit $unit specified!\n";
960                         }
961                 }
962         }
963
964         # prepare the 2-dim array init
965         foreach my $key (keys(%init)) {
966                 $ret .= "\tstatic const be_execution_unit_t *allowed_units_".$key."[] =\n";
967                 $ret .= "\t{\n";
968                 foreach (@{ $init{"$key"} }) {
969                         $ret .= "$_,\n";
970                 }
971                 $ret .= "\t\tNULL\n";
972                 $ret .= "\t};\n";
973                 $ret2 .= "\t\tallowed_units_$key,\n";
974         }
975         $ret2 .= "\t\tNULL\n";
976
977         $ret .= "\tstatic const be_execution_unit_t **exec_units[] =\n";
978         $ret .= "\t{\n";
979         $ret .= $ret2;
980         $ret .= "\t};\n";
981
982         return $ret;
983 }
984
985 sub mangle_requirements {
986         my $reqs  = shift;
987         my $class = shift;
988         my $flags = shift;
989
990         my @alternatives = split(/ /, $reqs);
991         for(my $idx = 0; $idx < scalar(@alternatives); $idx++) {
992                 $alternatives[$idx] =~ s/!/not_/g;
993         }
994
995         @alternatives = sort @alternatives;
996
997         my $name = $class."_".join('_', @alternatives);
998         if (defined($flags)) {
999                 $flags =~ s/\|/_/g;
1000                 $name .= "_$flags";
1001         }
1002
1003         return $name;
1004 }
1005
1006 ###
1007 # Determines whether $name is a specified register class or not.
1008 # @return 1 if name is register class, 0 otherwise
1009 ###
1010 sub is_reg_class {
1011     my $name = shift;
1012     return 1 if exists($reg_classes{"$name"});
1013     return 0;
1014 }
1015
1016 ###
1017 # Returns the register class for a given register.
1018 # @return class or undef
1019 ###
1020 sub get_reg_class {
1021     my $reg = shift;
1022     $reg = substr($reg, 1) if ($reg =~ /!.*/);
1023     return $reg2class{"$reg"}{"class"} if (exists($reg2class{"$reg"}));
1024     return undef;
1025 }
1026
1027 ###
1028 # Returns the index of a given register within it's register class.
1029 # @return index or undef
1030 ###
1031 sub get_reg_index {
1032     my $reg = shift;
1033     return $reg2class{"$reg"}{"index"} if (exists($reg2class{"$reg"}));
1034     return undef;
1035 }
1036
1037 ###
1038 # Remember the register class for each index in the given requirements.
1039 # We need this information for requirements like "in_sX" or "out_dX"
1040 # @return array of classes corresponding to the requirement for each index
1041 ###
1042 sub build_inout_idx_class {
1043         my $n     = shift;
1044         my $op    = shift;
1045         my $is_in = shift;
1046         my @idx_class;
1047
1048         my $inout = ($is_in ? "in" : "out");
1049
1050         if (exists($n->{"reg_req"}{"$inout"})) {
1051                 my @reqs = @{ $n->{"reg_req"}{"$inout"} };
1052
1053                 for (my $idx = 0; $idx <= $#reqs; $idx++) {
1054                         my $class = undef;
1055                         my ($req,) = split(/:/, $reqs[$idx]);
1056
1057                         if ($req eq "none") {
1058                                 $class = "none";
1059                         } elsif (is_reg_class($req)) {
1060                                 $class = $req;
1061                         } else {
1062                                 my @regs = split(/ /, $req);
1063 GET_CLASS:              foreach my $reg (@regs) {
1064                                         if ($reg =~ /!?(in|out)\_r\d+/ || $reg =~ /!in/) {
1065                                                 $class = "UNKNOWN_CLASS";
1066                                         } else {
1067                                                 $class = get_reg_class($reg);
1068                                                 if (!defined $class) {
1069                                                         die("Fatal error: Could not get ".uc($inout)." register class for '$op' pos $idx (reg $reg) ... exiting.\n");
1070                                                 } else {
1071                                                         last GET_CLASS;
1072                                                 } # !defined class
1073                                         } # if (reg =~ ...
1074                                 } # foreach
1075                         } # if
1076
1077                         push(@idx_class, $class);
1078                 } # for
1079         } # if
1080
1081         return @idx_class;
1082 }
1083
1084 ###
1085 # Generates the function for a given $op and a given IN-index
1086 # which returns a subset of possible register from a register class
1087 # @return classname from which the subset is derived or undef and
1088 #         pos which corresponds to in/out reference position or undef
1089 ###
1090 sub build_subset_class_func {
1091         my $neg           = undef;
1092         my $class         = undef;
1093         my $has_limit     = 0;
1094         my $limit_name;
1095         my $same_pos      = 0;
1096         my $different_pos = 0;
1097         my $temp;
1098         my @obst_init;
1099         my @obst_limits;
1100         my @obst_ignore;
1101         my @limit_array;
1102         my $limit_reqs;   #used for name mangling
1103
1104         # build function header
1105         my $node  = shift;
1106         my $op    = shift;
1107         my $idx   = shift;
1108         my $is_in = shift;
1109         my @regs  = split(/ /, shift);
1110         my $flags = shift;
1111
1112         my @idx_class = build_inout_idx_class($node, $op, !$is_in);
1113
1114         # set/unset registers
1115 CHECK_REQS: foreach (@regs) {
1116                 if (!$is_in && /(!)?in_r(\d+)/) {
1117                         my $bit_pos = 1 << ($2 - 1);
1118                         if ($different_pos & $bit_pos) {
1119                                 if ($1) {
1120                                         print STDERR "duplicate !in constraint\n";
1121                                 } else {
1122                                         print STDERR "conflicting !in and in constraints\n";
1123                                 }
1124                                 return (undef, undef, undef, undef);
1125                         }
1126
1127                         if ($same_pos & $bit_pos) {
1128                                 if ($1) {
1129                                         print STDERR "conflicting !in and in constraints\n";
1130                                 } else {
1131                                         print STDERR "duplicate in constraint\n";
1132                                 }
1133                                 return (undef, undef, undef, undef);
1134                         }
1135
1136                         if ($1) {
1137                                 $different_pos |= $bit_pos;
1138                         } else {
1139                                 $same_pos      |= $bit_pos;
1140                         }
1141
1142                         $class = $idx_class[$2 - 1];
1143                         next CHECK_REQS;
1144                 }
1145
1146                 # check for negate
1147                 if (substr($_, 0, 1) eq "!") {
1148                         if (defined($neg) && $neg == 0) {
1149                                 # we have seen a positiv constraint as first one but this one is negative
1150                                 # this doesn't make sense
1151                                 print STDERR "Mixed positive and negative constraints for the same slot are not allowed.\n";
1152                                 return (undef, undef, undef, undef);
1153                         }
1154
1155                         if (!defined($neg)) {
1156                                 $has_limit = 1;
1157                         }
1158
1159                         $_   = substr($_, 1); # skip '!'
1160                         $neg = 1;
1161                 } else {
1162                         if (defined($neg) && $neg == 1) {
1163                                 # we have seen a negative constraint as first one but this one is positive
1164                                 # this doesn't make sense
1165                                 print STDERR "Mixed positive and negative constraints for the same slot are not allowed.\n";
1166                                 return (undef, undef, undef, undef);
1167                         }
1168
1169                         $has_limit = 1;
1170                         $neg = 0;
1171                 }
1172
1173                 # check if register belongs to one of the given classes
1174                 $temp = get_reg_class($_);
1175                 if (!defined($temp)) {
1176                         print STDERR "Unknown register '$_'!\n";
1177                         return (undef, undef, undef, undef);
1178                 }
1179
1180                 # set class
1181                 if (!defined($class)) {
1182                         $class = $temp;
1183                 } elsif ($class ne $temp) {
1184                         # all registers must belong to the same class
1185                         print STDERR "Registerclass mismatch. '$_' is not member of class '$class'.\n";
1186                         return (undef, undef, undef, undef);
1187                 }
1188
1189                 # calculate position inside the initializer bitfield (only 32 bits per
1190                 # element)
1191                 my $regidx = get_reg_index($_);
1192                 my $arrayp = $regidx / 32;
1193                 push(@{$limit_array[$arrayp]}, $_);
1194                 $limit_reqs .= "$_ ";
1195         }
1196
1197         # don't allow ignore regs in negative constraints
1198         if($neg) {
1199                 my @cur_class = @{ $reg_classes{"$class"} };
1200                 for (my $idx = 0; $idx <= $#cur_class; $idx++) {
1201                         if (defined($cur_class[$idx]{"type"}) && ($cur_class[$idx]{"type"} & 4)) {
1202                                 my $reg    = $cur_class[$idx]{"name"};
1203                                 my $regix  = get_reg_index($reg);
1204                                 my $arrayp = $regix / 32;
1205                                 push(@{$limit_array[$arrayp]}, $reg);
1206                                 $limit_reqs .= "$reg ";
1207                         }
1208                 }
1209         }
1210
1211         if ($has_limit == 1) {
1212                 $limit_name = "${arch}_limit_".mangle_requirements($limit_reqs, $class);
1213
1214                 if(defined($limit_bitsets{$limit_name})) {
1215                         $limit_name = $limit_bitsets{$limit_name};
1216                         return ($class, $limit_name, $same_pos, $different_pos);
1217                 }
1218
1219                 $limit_bitsets{$limit_name} = $limit_name;
1220
1221                 push(@obst_limit_func, "static const unsigned " . $limit_name . "[] = { ");
1222                 my $first = 1;
1223                 my $limitbitsetlen = $regclass2len{$class};
1224                 my $limitarraylen = ($limitbitsetlen+31) / 32;
1225                 for(my $i = 0; $i < $limitarraylen; $i++) {
1226
1227                         my $limitarraypart = $limit_array[$i];
1228                         if($first) {
1229                                 $first = 0;
1230                         } else {
1231                                 push(@obst_limit_func, ", ");
1232                         }
1233                         my $temp;
1234                         if($neg) {
1235                                 $temp = "0xFFFFFFFF";
1236                         }
1237                         foreach my $reg (@{$limitarraypart}) {
1238                                 if($neg) {
1239                                         $temp .= " & ~";
1240                                 } elsif(defined($temp)) {
1241                                         $temp .= " | ";
1242                                 }
1243                                 $temp .= "BIT(REG_".uc(${reg}).")";
1244                         }
1245                         if(defined($temp)) {
1246                                 push(@obst_limit_func, "${temp}");
1247                         } else {
1248                                 push(@obst_limit_func, "0");
1249                         }
1250                 }
1251                 push(@obst_limit_func, " };\n");
1252         }
1253
1254         return ($class, $limit_name, $same_pos, $different_pos);
1255 }
1256
1257 ###
1258 # Generate register requirements structure
1259 ###
1260 sub generate_requirements {
1261         my ($reqs, $flags) = split(/:/, shift);
1262         my $node  = shift;
1263         my $op    = shift;
1264         my $idx   = shift;
1265         my $is_in = shift;
1266         my $class = "";
1267         my $width = 1;
1268         my $result;
1269
1270         my @req_type_mask;
1271         if (defined($flags)) {
1272                 foreach my $f (split(/|/, $flags)) {
1273                         if ($f eq "I") {
1274                                 push(@req_type_mask, "arch_register_req_type_ignore");
1275                         } elsif ($f eq "S") {
1276                                 push(@req_type_mask, "arch_register_req_type_produces_sp");
1277                         } elsif ($f eq "a") {
1278                                 push(@req_type_mask, "arch_register_req_type_aligned");
1279                         } elsif ($f eq "2" or $f eq "4" or $f eq "8") {
1280                                 $width = int($f);
1281                         }
1282                 }
1283         }
1284
1285         if ($reqs eq "none") {
1286
1287                 $result = <<EOF;
1288 {
1289         arch_register_req_type_none,
1290         NULL,                         /* regclass */
1291         NULL,                         /* limit bitset */
1292         0,                            /* same pos */
1293         0,                            /* different pos */
1294         0                             /* width */
1295 };
1296
1297 EOF
1298         } elsif (is_reg_class($reqs)) {
1299                 push(@req_type_mask, "arch_register_req_type_normal");
1300                 my $reqtype = join(" | ", @req_type_mask);
1301                 $class  = $reqs;
1302                 $result = <<EOF;
1303 {
1304         ${reqtype},
1305         & ${arch}_reg_classes[CLASS_${arch}_${class}],
1306         NULL,        /* limit bitset */
1307         0,           /* same pos */
1308         0,           /* different pos */
1309         $width            /* width */
1310 };
1311
1312 EOF
1313
1314         } else {
1315                 my ($regclass, $limit_bitset, $same_pos, $different_pos)
1316                         = build_subset_class_func($node, $op, $idx, $is_in, $reqs, $flags);
1317
1318                 if (!defined($regclass)) {
1319                         die("Fatal error: Could not build subset for requirements '$reqs' of '$op' pos $idx ... exiting.\n");
1320                 }
1321
1322                 if (defined($limit_bitset) && $limit_bitset ne "NULL") {
1323                         push(@req_type_mask, "arch_register_req_type_limited");
1324                 }
1325                 if ($same_pos != 0) {
1326                         push(@req_type_mask, "arch_register_req_type_should_be_same");
1327                 }
1328                 if ($different_pos != 0) {
1329                         push(@req_type_mask, "arch_register_req_type_must_be_different");
1330                 }
1331                 my $reqtype = join(" | ", @req_type_mask);
1332
1333                 if(!defined($limit_bitset)) {
1334                         $limit_bitset = "NULL";
1335                 }
1336
1337                 $class  = $regclass;
1338                 $result = <<EOF;
1339 {
1340         ${reqtype},
1341         & ${arch}_reg_classes[CLASS_${arch}_${class}],
1342         ${limit_bitset},
1343         ${same_pos},        /* same pos */
1344         ${different_pos},       /* different pos */
1345         $width             /* width */
1346 };
1347
1348 EOF
1349         }
1350
1351         my $name = "${arch}_requirements_".mangle_requirements($reqs, $class, $flags);
1352         if(defined($requirements{$name})) {
1353                 return $name;
1354         }
1355         $requirements{$name} = $name;
1356         push(@obst_reg_reqs, <<EOF);
1357 static const arch_register_req_t ${name} = ${result}
1358 EOF
1359
1360         return $name;
1361 }