xref: /netbsd-src/external/gpl3/binutils/dist/gold/yyscript.y (revision cb63e24e8d6aae7ddac1859a9015f48b1d8bd90e)
1 /* yyscript.y -- linker script grammar for gold.  */
2 
3 /* Copyright (C) 2006-2024 Free Software Foundation, Inc.
4    Written by Ian Lance Taylor <iant@google.com>.
5 
6    This file is part of gold.
7 
8    This program is free software; you can redistribute it and/or modify
9    it under the terms of the GNU General Public License as published by
10    the Free Software Foundation; either version 3 of the License, or
11    (at your option) any later version.
12 
13    This program is distributed in the hope that it will be useful,
14    but WITHOUT ANY WARRANTY; without even the implied warranty of
15    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
16    GNU General Public License for more details.
17 
18    You should have received a copy of the GNU General Public License
19    along with this program; if not, write to the Free Software
20    Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston,
21    MA 02110-1301, USA.  */
22 
23 /* This is a bison grammar to parse a subset of the original GNU ld
24    linker script language.  */
25 
26 %{
27 
28 #include "config.h"
29 #include "diagnostics.h"
30 
31 #include <stddef.h>
32 #include <stdint.h>
33 #include <stdlib.h>
34 #include <string.h>
35 
36 #include "script-c.h"
37 
38 DIAGNOSTIC_IGNORE_UNUSED_BUT_SET_VARIABLE
39 
40 %}
41 
42 /* We need to use a pure parser because we might be multi-threaded.
43    We pass some arguments through the parser to the lexer.  */
44 
45 %pure-parser
46 
47 %parse-param {void* closure}
48 %lex-param {void* closure}
49 
50 /* Since we require bison anyhow, we take advantage of it.  */
51 
52 %error-verbose
53 
54 /* The values associated with tokens.  */
55 
56 %union {
57   /* A string.  */
58   struct Parser_string string;
59   /* A number.  */
60   uint64_t integer;
61   /* An expression.  */
62   Expression_ptr expr;
63   /* An output section header.  */
64   struct Parser_output_section_header output_section_header;
65   /* An output section trailer.  */
66   struct Parser_output_section_trailer output_section_trailer;
67   /* A section constraint.  */
68   enum Section_constraint constraint;
69   /* A complete input section specification.  */
70   struct Input_section_spec input_section_spec;
71   /* A list of wildcard specifications, with exclusions.  */
72   struct Wildcard_sections wildcard_sections;
73   /* A single wildcard specification.  */
74   struct Wildcard_section wildcard_section;
75   /* A list of strings.  */
76   String_list_ptr string_list;
77   /* Information for a program header.  */
78   struct Phdr_info phdr_info;
79   /* Used for version scripts and within VERSION {}.  */
80   struct Version_dependency_list* deplist;
81   struct Version_expression_list* versyms;
82   struct Version_tree* versnode;
83   enum Script_section_type section_type;
84 }
85 
86 /* Operators, including a precedence table for expressions.  */
87 
88 %right PLUSEQ MINUSEQ MULTEQ DIVEQ '=' LSHIFTEQ RSHIFTEQ ANDEQ OREQ
89 %right '?' ':'
90 %left OROR
91 %left ANDAND
92 %left '|'
93 %left '^'
94 %left '&'
95 %left EQ NE
96 %left '<' '>' LE GE
97 %left LSHIFT RSHIFT
98 %left '+' '-'
99 %left '*' '/' '%'
100 
101 /* A fake operator used to indicate unary operator precedence.  */
102 %right UNARY
103 
104 /* Constants.  */
105 
106 %token <string> STRING
107 %token <string> QUOTED_STRING
108 %token <integer> INTEGER
109 
110 /* Keywords.  This list is taken from ldgram.y and ldlex.l in the old
111    GNU linker, with the keywords which only appear in MRI mode
112    removed.  Not all these keywords are actually used in this grammar.
113    In most cases the keyword is recognized as the token name in upper
114    case.  The comments indicate where this is not the case.  */
115 
116 %token ABSOLUTE
117 %token ADDR
118 %token ALIGN_K		/* ALIGN */
119 %token ALIGNOF
120 %token ASSERT_K		/* ASSERT */
121 %token AS_NEEDED
122 %token AT
123 %token BIND
124 %token BLOCK
125 %token BYTE
126 %token CONSTANT
127 %token CONSTRUCTORS
128 %token COPY
129 %token CREATE_OBJECT_SYMBOLS
130 %token DATA_SEGMENT_ALIGN
131 %token DATA_SEGMENT_END
132 %token DATA_SEGMENT_RELRO_END
133 %token DEFINED
134 %token DSECT
135 %token ENTRY
136 %token EXCLUDE_FILE
137 %token EXTERN
138 %token FILL
139 %token FLOAT
140 %token FORCE_COMMON_ALLOCATION
141 %token GLOBAL		/* global */
142 %token GROUP
143 %token HIDDEN
144 %token HLL
145 %token INCLUDE
146 %token INHIBIT_COMMON_ALLOCATION
147 %token INFO
148 %token INPUT
149 %token KEEP
150 %token LEN
151 %token LENGTH		/* LENGTH, l, len */
152 %token LOADADDR
153 %token LOCAL		/* local */
154 %token LONG
155 %token MAP
156 %token MAX_K		/* MAX */
157 %token MEMORY
158 %token MIN_K		/* MIN */
159 %token NEXT
160 %token NOCROSSREFS
161 %token NOFLOAT
162 %token NOLOAD
163 %token ONLY_IF_RO
164 %token ONLY_IF_RW
165 %token ORG
166 %token ORIGIN		/* ORIGIN, o, org */
167 %token OUTPUT
168 %token OUTPUT_ARCH
169 %token OUTPUT_FORMAT
170 %token OVERLAY
171 %token PHDRS
172 %token PROVIDE
173 %token PROVIDE_HIDDEN
174 %token QUAD
175 %token SEARCH_DIR
176 %token SECTIONS
177 %token SEGMENT_START
178 %token SHORT
179 %token SIZEOF
180 %token SIZEOF_HEADERS	/* SIZEOF_HEADERS, sizeof_headers */
181 %token SORT_BY_ALIGNMENT
182 %token SORT_BY_INIT_PRIORITY
183 %token SORT_BY_NAME
184 %token SPECIAL
185 %token SQUAD
186 %token STARTUP
187 %token SUBALIGN
188 %token SYSLIB
189 %token TARGET_K		/* TARGET */
190 %token TRUNCATE
191 %token VERSIONK		/* VERSION */
192 
193 /* Keywords, part 2.  These are keywords that are unique to gold,
194    and not present in the old GNU linker.  As before, unless the
195    comments say otherwise, the keyword is recognized as the token
196    name in upper case. */
197 
198 %token OPTION
199 
200 /* Special tokens used to tell the grammar what type of tokens we are
201    parsing.  The token stream always begins with one of these tokens.
202    We do this because version scripts can appear embedded within
203    linker scripts, and because --defsym uses the expression
204    parser.  */
205 %token PARSING_LINKER_SCRIPT
206 %token PARSING_VERSION_SCRIPT
207 %token PARSING_DEFSYM
208 %token PARSING_DYNAMIC_LIST
209 %token PARSING_SECTIONS_BLOCK
210 %token PARSING_SECTION_COMMANDS
211 %token PARSING_MEMORY_DEF
212 
213 /* Non-terminal types, where needed.  */
214 
215 %type <expr> parse_exp exp
216 %type <expr> opt_at opt_align opt_subalign opt_fill
217 %type <output_section_header> section_header opt_address_and_section_type
218 %type <section_type> section_type
219 %type <output_section_trailer> section_trailer
220 %type <constraint> opt_constraint
221 %type <string_list> opt_phdr
222 %type <integer> data_length
223 %type <input_section_spec> input_section_no_keep
224 %type <wildcard_sections> wildcard_sections
225 %type <wildcard_section> wildcard_file wildcard_section
226 %type <string_list> exclude_names
227 %type <string> wildcard_name
228 %type <integer> phdr_type memory_attr
229 %type <phdr_info> phdr_info
230 %type <versyms> vers_defns
231 %type <versnode> vers_tag
232 %type <deplist> verdep
233 %type <string> string
234 
235 %%
236 
237 /* Read the special token to see what to read next.  */
238 top:
239 	  PARSING_LINKER_SCRIPT linker_script
240 	| PARSING_VERSION_SCRIPT version_script
241 	| PARSING_DEFSYM defsym_expr
242         | PARSING_DYNAMIC_LIST dynamic_list_expr
243         | PARSING_SECTIONS_BLOCK sections_block
244         | PARSING_SECTION_COMMANDS section_cmds
245         | PARSING_MEMORY_DEF memory_defs
246 	;
247 
248 /* A file contains a list of commands.  */
249 linker_script:
250 	  linker_script file_cmd
251 	| /* empty */
252 	;
253 
254 /* A command which may appear at top level of a linker script.  */
255 file_cmd:
256 	  EXTERN '(' extern_name_list ')'
257 	| FORCE_COMMON_ALLOCATION
258 	    { script_set_common_allocation(closure, 1); }
259 	| GROUP
260 	    { script_start_group(closure); }
261 	  '(' input_list ')'
262 	    { script_end_group(closure); }
263 	| INHIBIT_COMMON_ALLOCATION
264 	    { script_set_common_allocation(closure, 0); }
265 	| INPUT '(' input_list ')'
266 	| MEMORY '{' memory_defs '}'
267         | OPTION '(' string ')'
268 	    { script_parse_option(closure, $3.value, $3.length); }
269 	| OUTPUT_FORMAT '(' string ')'
270 	    {
271 	      if (!script_check_output_format(closure, $3.value, $3.length,
272 					      NULL, 0, NULL, 0))
273 		YYABORT;
274 	    }
275 	| OUTPUT_FORMAT '(' string ',' string ',' string ')'
276 	    {
277 	      if (!script_check_output_format(closure, $3.value, $3.length,
278 					      $5.value, $5.length,
279 					      $7.value, $7.length))
280 		YYABORT;
281 	    }
282 	| PHDRS '{' phdrs_defs '}'
283 	| SEARCH_DIR '(' string ')'
284 	    { script_add_search_dir(closure, $3.value, $3.length); }
285 	| SECTIONS '{'
286 	    { script_start_sections(closure); }
287 	  sections_block '}'
288 	    { script_finish_sections(closure); }
289 	| TARGET_K '(' string ')'
290 	    { script_set_target(closure, $3.value, $3.length); }
291         | VERSIONK '{'
292             { script_push_lex_into_version_mode(closure); }
293           version_script '}'
294             { script_pop_lex_mode(closure); }
295 	| ENTRY '(' string ')'
296 	    { script_set_entry(closure, $3.value, $3.length); }
297 	| assignment end
298 	| ASSERT_K '(' parse_exp ',' string ')'
299 	    { script_add_assertion(closure, $3, $5.value, $5.length); }
300 	| INCLUDE string
301 	    { script_include_directive(PARSING_LINKER_SCRIPT, closure,
302 				       $2.value, $2.length); }
303 	| ignore_cmd
304 	| ';'
305 	;
306 
307 /* Top level commands which we ignore.  The GNU linker uses these to
308    select the output format, but we don't offer a choice.  Ignoring
309    these is more-or-less OK since most scripts simply explicitly
310    choose the default.  */
311 ignore_cmd:
312 	  OUTPUT_ARCH '(' string ')'
313 	;
314 
315 /* A list of external undefined symbols.  We put the lexer into
316    expression mode so that commas separate names; this is what the GNU
317    linker does.  */
318 
319 extern_name_list:
320 	    { script_push_lex_into_expression_mode(closure); }
321 	  extern_name_list_body
322 	    { script_pop_lex_mode(closure); }
323 	;
324 
325 extern_name_list_body:
326 	  string
327 	    { script_add_extern(closure, $1.value, $1.length); }
328 	| extern_name_list_body string
329 	    { script_add_extern(closure, $2.value, $2.length); }
330 	| extern_name_list_body ',' string
331 	    { script_add_extern(closure, $3.value, $3.length); }
332 	;
333 
334 /* A list of input file names.  */
335 input_list:
336 	  input_list_element
337 	| input_list opt_comma input_list_element
338 	;
339 
340 /* An input file name.  */
341 input_list_element:
342 	  string
343 	    { script_add_file(closure, $1.value, $1.length); }
344 	| '-' STRING
345 	    { script_add_library(closure, $2.value, $2.length); }
346 	| AS_NEEDED
347 	    { script_start_as_needed(closure); }
348 	  '(' input_list ')'
349 	    { script_end_as_needed(closure); }
350 	;
351 
352 /* Commands in a SECTIONS block.  */
353 sections_block:
354 	  sections_block section_block_cmd
355 	| /* empty */
356 	;
357 
358 /* A command which may appear within a SECTIONS block.  */
359 section_block_cmd:
360 	  ENTRY '(' string ')'
361 	    { script_set_entry(closure, $3.value, $3.length); }
362 	| assignment end
363 	| ASSERT_K '(' parse_exp ',' string ')'
364 	    { script_add_assertion(closure, $3, $5.value, $5.length); }
365 	| INCLUDE string
366 	    { script_include_directive(PARSING_SECTIONS_BLOCK, closure,
367 				       $2.value, $2.length); }
368 	| string section_header
369 	    { script_start_output_section(closure, $1.value, $1.length, &$2); }
370 	  '{' section_cmds '}' section_trailer
371 	    { script_finish_output_section(closure, &$7); }
372 	;
373 
374 /* The header of an output section in a SECTIONS block--everything
375    after the name.  */
376 section_header:
377 	    { script_push_lex_into_expression_mode(closure); }
378 	  opt_address_and_section_type opt_at opt_align opt_subalign
379 	    { script_pop_lex_mode(closure); }
380 	  opt_constraint
381 	    {
382 	      $$.address = $2.address;
383 	      $$.section_type = $2.section_type;
384 	      $$.load_address = $3;
385 	      $$.align = $4;
386 	      $$.subalign = $5;
387 	      $$.constraint = $7;
388 	    }
389 	;
390 
391 /* The optional address followed by the optional section type.  This
392    is a separate nonterminal to avoid a shift/reduce conflict on
393    '(' in section_header.  */
394 
395 opt_address_and_section_type:
396 	':'
397 	    {
398 	      $$.address = NULL;
399 	      $$.section_type = SCRIPT_SECTION_TYPE_NONE;
400 	    }
401 	| '(' ')' ':'
402 	    {
403 	      $$.address = NULL;
404 	      $$.section_type = SCRIPT_SECTION_TYPE_NONE;
405 	    }
406 	| exp ':'
407 	    {
408 	      $$.address = $1;
409 	      $$.section_type = SCRIPT_SECTION_TYPE_NONE;
410 	    }
411 	| exp '(' ')' ':'
412 	    {
413 	      $$.address = $1;
414 	      $$.section_type = SCRIPT_SECTION_TYPE_NONE;
415 	    }
416 	| '(' section_type ')' ':'
417 	    {
418 	      $$.address = NULL;
419 	      $$.section_type = $2;
420 	    }
421 	| exp '(' section_type ')' ':'
422 	    {
423 	      $$.address = $1;
424 	      $$.section_type = $3;
425 	    }
426 	;
427 
428 /* We only support NOLOAD.  */
429 section_type:
430 	NOLOAD
431 	    { $$ = SCRIPT_SECTION_TYPE_NOLOAD; }
432 	| DSECT
433 	    {
434 	      yyerror(closure, "DSECT section type is unsupported");
435 	      $$ = SCRIPT_SECTION_TYPE_DSECT;
436 	    }
437 	| COPY
438 	    {
439 	      yyerror(closure, "COPY section type is unsupported");
440 	      $$ = SCRIPT_SECTION_TYPE_COPY;
441 	    }
442 	| INFO
443 	    {
444 	      yyerror(closure, "INFO section type is unsupported");
445 	      $$ = SCRIPT_SECTION_TYPE_INFO;
446 	    }
447 	| OVERLAY
448 	    {
449 	      yyerror(closure, "OVERLAY section type is unsupported");
450 	      $$ = SCRIPT_SECTION_TYPE_OVERLAY;
451 	    }
452 	;
453 
454 /* The address at which an output section should be loaded.  */
455 opt_at:
456 	  /* empty */
457 	    { $$ = NULL; }
458 	| AT '(' exp ')'
459 	    { $$ = $3; }
460 	;
461 
462 /* The alignment of an output section.  */
463 opt_align:
464 	  /* empty */
465 	    { $$ = NULL; }
466 	| ALIGN_K '(' exp ')'
467 	    { $$ = $3; }
468 	;
469 
470 /* The input section alignment within an output section.  */
471 opt_subalign:
472 	  /* empty */
473 	    { $$ = NULL; }
474 	| SUBALIGN '(' exp ')'
475 	    { $$ = $3; }
476 	;
477 
478 /* A section constraint.  */
479 opt_constraint:
480 	  /* empty */
481 	    { $$ = CONSTRAINT_NONE; }
482 	| ONLY_IF_RO
483 	    { $$ = CONSTRAINT_ONLY_IF_RO; }
484 	| ONLY_IF_RW
485 	    { $$ = CONSTRAINT_ONLY_IF_RW; }
486 	| SPECIAL
487 	    { $$ = CONSTRAINT_SPECIAL; }
488 	;
489 
490 /* The trailer of an output section in a SECTIONS block.  */
491 section_trailer:
492 	  opt_memspec opt_at_memspec opt_phdr opt_fill opt_comma
493 	    {
494 	      $$.fill = $4;
495 	      $$.phdrs = $3;
496 	    }
497 	;
498 
499 /* A memory specification for an output section.  */
500 opt_memspec:
501 	  '>' string
502 	    { script_set_section_region(closure, $2.value, $2.length, 1); }
503 	| /* empty */
504 	;
505 
506 /* A memory specification for where to load an output section.  */
507 opt_at_memspec:
508 	  AT '>' string
509 	    { script_set_section_region(closure, $3.value, $3.length, 0); }
510 	| /* empty */
511 	;
512 
513 /* The program segment an output section should go into.  */
514 opt_phdr:
515 	  opt_phdr ':' string
516 	    { $$ = script_string_list_push_back($1, $3.value, $3.length); }
517 	| /* empty */
518 	    { $$ = NULL; }
519 	;
520 
521 /* The value to use to fill an output section.  FIXME: This does not
522    handle a string of arbitrary length.  */
523 opt_fill:
524 	  '=' parse_exp
525 	    { $$ = $2; }
526 	| /* empty */
527 	    { $$ = NULL; }
528 	;
529 
530 /* Commands which may appear within the description of an output
531    section in a SECTIONS block.  */
532 section_cmds:
533 	  /* empty */
534 	| section_cmds section_cmd
535 	;
536 
537 /* A command which may appear within the description of an output
538    section in a SECTIONS block.  */
539 section_cmd:
540 	  assignment end
541 	| input_section_spec
542 	| data_length '(' parse_exp ')'
543 	    { script_add_data(closure, $1, $3); }
544 	| ASSERT_K '(' parse_exp ',' string ')'
545 	    { script_add_assertion(closure, $3, $5.value, $5.length); }
546 	| FILL '(' parse_exp ')'
547 	    { script_add_fill(closure, $3); }
548 	| CONSTRUCTORS
549 	    {
550 	      /* The GNU linker uses CONSTRUCTORS for the a.out object
551 		 file format.  It does nothing when using ELF.  Since
552 		 some ELF linker scripts use it although it does
553 		 nothing, we accept it and ignore it.  */
554 	    }
555 	| SORT_BY_NAME '(' CONSTRUCTORS ')'
556 	| INCLUDE string
557 	    { script_include_directive(PARSING_SECTION_COMMANDS, closure,
558 				       $2.value, $2.length); }
559 	| ';'
560 	;
561 
562 /* The length of data which may appear within the description of an
563    output section in a SECTIONS block.  */
564 data_length:
565 	  QUAD
566 	    { $$ = QUAD; }
567 	| SQUAD
568 	    { $$ = SQUAD; }
569 	| LONG
570 	    { $$ = LONG; }
571 	| SHORT
572 	    { $$ = SHORT; }
573 	| BYTE
574 	    { $$ = BYTE; }
575 	;
576 
577 /* An input section specification.  This may appear within the
578    description of an output section in a SECTIONS block.  */
579 input_section_spec:
580 	  input_section_no_keep
581 	    { script_add_input_section(closure, &$1, 0); }
582 	| KEEP '(' input_section_no_keep ')'
583 	    { script_add_input_section(closure, &$3, 1); }
584 	;
585 
586 /* An input section specification within a KEEP clause.  */
587 input_section_no_keep:
588 	  string
589 	    {
590 	      $$.file.name = $1;
591 	      $$.file.sort = SORT_WILDCARD_NONE;
592 	      $$.input_sections.sections = NULL;
593 	      $$.input_sections.exclude = NULL;
594 	    }
595 	| wildcard_file '(' wildcard_sections ')'
596 	    {
597 	      $$.file = $1;
598 	      $$.input_sections = $3;
599 	    }
600 	;
601 
602 /* A wildcard file specification.  */
603 wildcard_file:
604 	  wildcard_name
605 	    {
606 	      $$.name = $1;
607 	      $$.sort = SORT_WILDCARD_NONE;
608 	    }
609 	| SORT_BY_NAME '(' wildcard_name ')'
610 	    {
611 	      $$.name = $3;
612 	      $$.sort = SORT_WILDCARD_BY_NAME;
613 	    }
614 	;
615 
616 /* A list of wild card section specifications.  */
617 wildcard_sections:
618 	  wildcard_sections opt_comma wildcard_section
619 	    {
620 	      $$.sections = script_string_sort_list_add($1.sections, &$3);
621 	      $$.exclude = $1.exclude;
622 	    }
623 	| wildcard_section
624 	    {
625 	      $$.sections = script_new_string_sort_list(&$1);
626 	      $$.exclude = NULL;
627 	    }
628 	| wildcard_sections opt_comma EXCLUDE_FILE '(' exclude_names ')'
629 	    {
630 	      $$.sections = $1.sections;
631 	      $$.exclude = script_string_list_append($1.exclude, $5);
632 	    }
633 	| EXCLUDE_FILE '(' exclude_names ')'
634 	    {
635 	      $$.sections = NULL;
636 	      $$.exclude = $3;
637 	    }
638 	;
639 
640 /* A single wild card specification.  */
641 wildcard_section:
642 	  wildcard_name
643 	    {
644 	      $$.name = $1;
645 	      $$.sort = SORT_WILDCARD_NONE;
646 	    }
647 	| SORT_BY_NAME '(' wildcard_section ')'
648 	    {
649 	      $$.name = $3.name;
650 	      switch ($3.sort)
651 		{
652 		case SORT_WILDCARD_NONE:
653 		  $$.sort = SORT_WILDCARD_BY_NAME;
654 		  break;
655 		case SORT_WILDCARD_BY_NAME:
656 		case SORT_WILDCARD_BY_NAME_BY_ALIGNMENT:
657 		  break;
658 		case SORT_WILDCARD_BY_ALIGNMENT:
659 		case SORT_WILDCARD_BY_ALIGNMENT_BY_NAME:
660 		  $$.sort = SORT_WILDCARD_BY_NAME_BY_ALIGNMENT;
661 		  break;
662 		default:
663 		  abort();
664 		}
665 	    }
666 	| SORT_BY_ALIGNMENT '(' wildcard_section ')'
667 	    {
668 	      $$.name = $3.name;
669 	      switch ($3.sort)
670 		{
671 		case SORT_WILDCARD_NONE:
672 		  $$.sort = SORT_WILDCARD_BY_ALIGNMENT;
673 		  break;
674 		case SORT_WILDCARD_BY_ALIGNMENT:
675 		case SORT_WILDCARD_BY_ALIGNMENT_BY_NAME:
676 		  break;
677 		case SORT_WILDCARD_BY_NAME:
678 		case SORT_WILDCARD_BY_NAME_BY_ALIGNMENT:
679 		  $$.sort = SORT_WILDCARD_BY_ALIGNMENT_BY_NAME;
680 		  break;
681 		default:
682 		  abort();
683 		}
684 	    }
685 	| SORT_BY_INIT_PRIORITY '(' wildcard_name ')'
686 	    {
687 	      $$.name = $3;
688 	      $$.sort = SORT_WILDCARD_BY_INIT_PRIORITY;
689 	    }
690 	;
691 
692 /* A list of file names to exclude.  */
693 exclude_names:
694 	  exclude_names opt_comma wildcard_name
695 	    { $$ = script_string_list_push_back($1, $3.value, $3.length); }
696 	| wildcard_name
697 	    { $$ = script_new_string_list($1.value, $1.length); }
698 	;
699 
700 /* A single wildcard name.  We recognize '*' and '?' specially since
701    they are expression tokens.  */
702 wildcard_name:
703 	  string
704 	    { $$ = $1; }
705 	| '*'
706 	    {
707 	      $$.value = "*";
708 	      $$.length = 1;
709 	    }
710 	| '?'
711 	    {
712 	      $$.value = "?";
713 	      $$.length = 1;
714 	    }
715 	;
716 
717 /* A list of MEMORY definitions.  */
718 memory_defs:
719 	  memory_defs opt_comma memory_def
720 	| /* empty */
721 	;
722 
723 /* A single MEMORY definition.  */
724 memory_def:
725 	  string memory_attr ':' memory_origin '=' parse_exp opt_comma memory_length '=' parse_exp
726 	  { script_add_memory(closure, $1.value, $1.length, $2, $6, $10); }
727 	|
728 	  INCLUDE string
729 	  { script_include_directive(PARSING_MEMORY_DEF, closure,
730 				     $2.value, $2.length); }
731 	|
732 	;
733 
734 /* The (optional) attributes of a MEMORY region.  */
735 memory_attr:
736 	  '(' string ')'
737 	  { $$ = script_parse_memory_attr(closure, $2.value, $2.length, 0); }
738         | /* Inverted attributes. */
739 	  '(' '!' string ')'
740 	  { $$ = script_parse_memory_attr(closure, $3.value, $3.length, 1); }
741 	| /* empty */
742 	    { $$ = 0; }
743 	;
744 
745 memory_origin:
746           ORIGIN
747 	|
748 	  ORG
749 	|
750 	  'o'
751 	;
752 
753 memory_length:
754           LENGTH
755 	|
756 	  LEN
757 	|
758 	  'l'
759 	;
760 
761 /* A list of program header definitions.  */
762 phdrs_defs:
763 	  phdrs_defs phdr_def
764 	| /* empty */
765 	;
766 
767 /* A program header definition.  */
768 phdr_def:
769 	  string phdr_type phdr_info ';'
770 	    { script_add_phdr(closure, $1.value, $1.length, $2, &$3); }
771 	;
772 
773 /* A program header type.  The GNU linker accepts a general expression
774    here, but that would be a pain because we would have to dig into
775    the expression structure.  It's unlikely that anybody uses anything
776    other than a string or a number here, so that is all we expect.  */
777 phdr_type:
778 	  string
779 	    { $$ = script_phdr_string_to_type(closure, $1.value, $1.length); }
780 	| INTEGER
781 	    { $$ = $1; }
782 	;
783 
784 /* Additional information for a program header.  */
785 phdr_info:
786 	  /* empty */
787 	    { memset(&$$, 0, sizeof(struct Phdr_info)); }
788 	| string phdr_info
789 	    {
790 	      $$ = $2;
791 	      if ($1.length == 7 && strncmp($1.value, "FILEHDR", 7) == 0)
792 		$$.includes_filehdr = 1;
793 	      else
794 		yyerror(closure, "PHDRS syntax error");
795 	    }
796 	| PHDRS phdr_info
797 	    {
798 	      $$ = $2;
799 	      $$.includes_phdrs = 1;
800 	    }
801 	| string '(' INTEGER ')' phdr_info
802 	    {
803 	      $$ = $5;
804 	      if ($1.length == 5 && strncmp($1.value, "FLAGS", 5) == 0)
805 		{
806 		  $$.is_flags_valid = 1;
807 		  $$.flags = $3;
808 		}
809 	      else
810 		yyerror(closure, "PHDRS syntax error");
811 	    }
812 	| AT '(' parse_exp ')' phdr_info
813 	    {
814 	      $$ = $5;
815 	      $$.load_address = $3;
816 	    }
817 	;
818 
819 /* Set a symbol to a value.  */
820 assignment:
821 	  string '=' parse_exp
822 	    { script_set_symbol(closure, $1.value, $1.length, $3, 0, 0); }
823 	| string PLUSEQ parse_exp
824 	    {
825 	      Expression_ptr s = script_exp_string($1.value, $1.length);
826 	      Expression_ptr e = script_exp_binary_add(s, $3);
827 	      script_set_symbol(closure, $1.value, $1.length, e, 0, 0);
828 	    }
829 	| string MINUSEQ parse_exp
830 	    {
831 	      Expression_ptr s = script_exp_string($1.value, $1.length);
832 	      Expression_ptr e = script_exp_binary_sub(s, $3);
833 	      script_set_symbol(closure, $1.value, $1.length, e, 0, 0);
834 	    }
835 	| string MULTEQ parse_exp
836 	    {
837 	      Expression_ptr s = script_exp_string($1.value, $1.length);
838 	      Expression_ptr e = script_exp_binary_mult(s, $3);
839 	      script_set_symbol(closure, $1.value, $1.length, e, 0, 0);
840 	    }
841 	| string DIVEQ parse_exp
842 	    {
843 	      Expression_ptr s = script_exp_string($1.value, $1.length);
844 	      Expression_ptr e = script_exp_binary_div(s, $3);
845 	      script_set_symbol(closure, $1.value, $1.length, e, 0, 0);
846 	    }
847 	| string LSHIFTEQ parse_exp
848 	    {
849 	      Expression_ptr s = script_exp_string($1.value, $1.length);
850 	      Expression_ptr e = script_exp_binary_lshift(s, $3);
851 	      script_set_symbol(closure, $1.value, $1.length, e, 0, 0);
852 	    }
853 	| string RSHIFTEQ parse_exp
854 	    {
855 	      Expression_ptr s = script_exp_string($1.value, $1.length);
856 	      Expression_ptr e = script_exp_binary_rshift(s, $3);
857 	      script_set_symbol(closure, $1.value, $1.length, e, 0, 0);
858 	    }
859 	| string ANDEQ parse_exp
860 	    {
861 	      Expression_ptr s = script_exp_string($1.value, $1.length);
862 	      Expression_ptr e = script_exp_binary_bitwise_and(s, $3);
863 	      script_set_symbol(closure, $1.value, $1.length, e, 0, 0);
864 	    }
865 	| string OREQ parse_exp
866 	    {
867 	      Expression_ptr s = script_exp_string($1.value, $1.length);
868 	      Expression_ptr e = script_exp_binary_bitwise_or(s, $3);
869 	      script_set_symbol(closure, $1.value, $1.length, e, 0, 0);
870 	    }
871 	| HIDDEN '(' string '=' parse_exp ')'
872 	    { script_set_symbol(closure, $3.value, $3.length, $5, 0, 1); }
873 	| PROVIDE '(' string '=' parse_exp ')'
874 	    { script_set_symbol(closure, $3.value, $3.length, $5, 1, 0); }
875 	| PROVIDE_HIDDEN '(' string '=' parse_exp ')'
876 	    { script_set_symbol(closure, $3.value, $3.length, $5, 1, 1); }
877 	;
878 
879 /* Parse an expression, putting the lexer into the right mode.  */
880 parse_exp:
881 	    { script_push_lex_into_expression_mode(closure); }
882 	  exp
883 	    {
884 	      script_pop_lex_mode(closure);
885 	      $$ = $2;
886 	    }
887 	;
888 
889 /* An expression.  */
890 exp:
891 	  '(' exp ')'
892 	    { $$ = $2; }
893 	| '-' exp %prec UNARY
894 	    { $$ = script_exp_unary_minus($2); }
895 	| '!' exp %prec UNARY
896 	    { $$ = script_exp_unary_logical_not($2); }
897 	| '~' exp %prec UNARY
898 	    { $$ = script_exp_unary_bitwise_not($2); }
899 	| '+' exp %prec UNARY
900 	    { $$ = $2; }
901 	| exp '*' exp
902 	    { $$ = script_exp_binary_mult($1, $3); }
903 	| exp '/' exp
904 	    { $$ = script_exp_binary_div($1, $3); }
905 	| exp '%' exp
906 	    { $$ = script_exp_binary_mod($1, $3); }
907 	| exp '+' exp
908 	    { $$ = script_exp_binary_add($1, $3); }
909 	| exp '-' exp
910 	    { $$ = script_exp_binary_sub($1, $3); }
911 	| exp LSHIFT exp
912 	    { $$ = script_exp_binary_lshift($1, $3); }
913 	| exp RSHIFT exp
914 	    { $$ = script_exp_binary_rshift($1, $3); }
915 	| exp EQ exp
916 	    { $$ = script_exp_binary_eq($1, $3); }
917 	| exp NE exp
918 	    { $$ = script_exp_binary_ne($1, $3); }
919 	| exp LE exp
920 	    { $$ = script_exp_binary_le($1, $3); }
921 	| exp GE exp
922 	    { $$ = script_exp_binary_ge($1, $3); }
923 	| exp '<' exp
924 	    { $$ = script_exp_binary_lt($1, $3); }
925 	| exp '>' exp
926 	    { $$ = script_exp_binary_gt($1, $3); }
927 	| exp '&' exp
928 	    { $$ = script_exp_binary_bitwise_and($1, $3); }
929 	| exp '^' exp
930 	    { $$ = script_exp_binary_bitwise_xor($1, $3); }
931 	| exp '|' exp
932 	    { $$ = script_exp_binary_bitwise_or($1, $3); }
933 	| exp ANDAND exp
934 	    { $$ = script_exp_binary_logical_and($1, $3); }
935 	| exp OROR exp
936 	    { $$ = script_exp_binary_logical_or($1, $3); }
937 	| exp '?' exp ':' exp
938 	    { $$ = script_exp_trinary_cond($1, $3, $5); }
939 	| INTEGER
940 	    { $$ = script_exp_integer($1); }
941 	| string
942 	    { $$ = script_symbol(closure, $1.value, $1.length); }
943 	| MAX_K '(' exp ',' exp ')'
944 	    { $$ = script_exp_function_max($3, $5); }
945 	| MIN_K '(' exp ',' exp ')'
946 	    { $$ = script_exp_function_min($3, $5); }
947 	| DEFINED '(' string ')'
948 	    { $$ = script_exp_function_defined($3.value, $3.length); }
949 	| SIZEOF_HEADERS
950 	    { $$ = script_exp_function_sizeof_headers(); }
951 	| ALIGNOF '(' string ')'
952 	    { $$ = script_exp_function_alignof($3.value, $3.length); }
953 	| SIZEOF '(' string ')'
954 	    { $$ = script_exp_function_sizeof($3.value, $3.length); }
955 	| ADDR '(' string ')'
956 	    { $$ = script_exp_function_addr($3.value, $3.length); }
957 	| LOADADDR '(' string ')'
958 	    { $$ = script_exp_function_loadaddr($3.value, $3.length); }
959 	| ORIGIN '(' string ')'
960 	    { $$ = script_exp_function_origin(closure, $3.value, $3.length); }
961 	| LENGTH '(' string ')'
962 	    { $$ = script_exp_function_length(closure, $3.value, $3.length); }
963 	| CONSTANT '(' string ')'
964 	    { $$ = script_exp_function_constant($3.value, $3.length); }
965 	| ABSOLUTE '(' exp ')'
966 	    { $$ = script_exp_function_absolute($3); }
967 	| ALIGN_K '(' exp ')'
968 	    { $$ = script_exp_function_align(script_exp_string(".", 1), $3); }
969 	| ALIGN_K '(' exp ',' exp ')'
970 	    { $$ = script_exp_function_align($3, $5); }
971 	| BLOCK '(' exp ')'
972 	    { $$ = script_exp_function_align(script_exp_string(".", 1), $3); }
973 	| DATA_SEGMENT_ALIGN '(' exp ',' exp ')'
974 	    {
975 	      script_data_segment_align(closure);
976 	      $$ = script_exp_function_data_segment_align($3, $5);
977 	    }
978 	| DATA_SEGMENT_RELRO_END '(' exp ',' exp ')'
979 	    {
980 	      script_data_segment_relro_end(closure);
981 	      $$ = script_exp_function_data_segment_relro_end($3, $5);
982 	    }
983 	| DATA_SEGMENT_END '(' exp ')'
984 	    { $$ = script_exp_function_data_segment_end($3); }
985 	| SEGMENT_START '(' string ',' exp ')'
986 	    {
987 	      $$ = script_exp_function_segment_start($3.value, $3.length, $5);
988 	      /* We need to take note of any SEGMENT_START expressions
989 		 because they change the behaviour of -Ttext, -Tdata and
990 		 -Tbss options.  */
991 	      script_saw_segment_start_expression(closure);
992 	    }
993 	| ASSERT_K '(' exp ',' string ')'
994 	    { $$ = script_exp_function_assert($3, $5.value, $5.length); }
995 	;
996 
997 /* Handle the --defsym option.  */
998 defsym_expr:
999 	  string '=' parse_exp
1000 	    { script_set_symbol(closure, $1.value, $1.length, $3, 0, 0); }
1001 	;
1002 
1003 /* Handle the --dynamic-list option.  A dynamic list has the format
1004    { sym1; sym2; extern "C++" { namespace::sym3 }; };
1005    We store the symbol we see in the "local" list; that is where
1006    Command_line::in_dynamic_list() will look to do its check.
1007    TODO(csilvers): More than one of these brace-lists can appear, and
1008    should just be merged and treated as a single list.  */
1009 dynamic_list_expr: dynamic_list_nodes ;
1010 
1011 dynamic_list_nodes:
1012 	  dynamic_list_node
1013 	| dynamic_list_nodes dynamic_list_node
1014         ;
1015 
1016 dynamic_list_node:
1017           '{' vers_defns ';' '}' ';'
1018             { script_new_vers_node (closure, NULL, $2); }
1019         ;
1020 
1021 /* A version script.  */
1022 version_script:
1023 	  vers_nodes
1024 	;
1025 
1026 vers_nodes:
1027 	  vers_node
1028 	| vers_nodes vers_node
1029 	;
1030 
1031 vers_node:
1032 	  '{' vers_tag '}' ';'
1033 	    {
1034 	      script_register_vers_node (closure, NULL, 0, $2, NULL);
1035 	    }
1036 	| string '{' vers_tag '}' ';'
1037 	    {
1038 	      script_register_vers_node (closure, $1.value, $1.length, $3,
1039 					 NULL);
1040 	    }
1041 	| string '{' vers_tag '}' verdep ';'
1042 	    {
1043 	      script_register_vers_node (closure, $1.value, $1.length, $3, $5);
1044 	    }
1045 	;
1046 
1047 verdep:
1048 	  string
1049 	    {
1050 	      $$ = script_add_vers_depend (closure, NULL, $1.value, $1.length);
1051 	    }
1052 	| verdep string
1053 	    {
1054 	      $$ = script_add_vers_depend (closure, $1, $2.value, $2.length);
1055 	    }
1056 	;
1057 
1058 vers_tag:
1059 	  /* empty */
1060 	    { $$ = script_new_vers_node (closure, NULL, NULL); }
1061 	| vers_defns ';'
1062 	    { $$ = script_new_vers_node (closure, $1, NULL); }
1063 	| GLOBAL ':' vers_defns ';'
1064 	    { $$ = script_new_vers_node (closure, $3, NULL); }
1065 	| LOCAL ':' vers_defns ';'
1066 	    { $$ = script_new_vers_node (closure, NULL, $3); }
1067 	| GLOBAL ':' vers_defns ';' LOCAL ':' vers_defns ';'
1068 	    { $$ = script_new_vers_node (closure, $3, $7); }
1069 	;
1070 
1071 /* Here is one of the rare places we care about the distinction
1072    between STRING and QUOTED_STRING.  For QUOTED_STRING, we do exact
1073    matching on the pattern, so we pass in true for the exact_match
1074    parameter.  For STRING, we do glob matching and pass in false.  */
1075 vers_defns:
1076 	  STRING
1077 	    {
1078 	      $$ = script_new_vers_pattern (closure, NULL, $1.value,
1079 					    $1.length, 0);
1080 	    }
1081 	| QUOTED_STRING
1082 	    {
1083 	      $$ = script_new_vers_pattern (closure, NULL, $1.value,
1084 					    $1.length, 1);
1085 	    }
1086 	| vers_defns ';' STRING
1087 	    {
1088 	      $$ = script_new_vers_pattern (closure, $1, $3.value,
1089                                             $3.length, 0);
1090 	    }
1091 	| vers_defns ';' QUOTED_STRING
1092 	    {
1093 	      $$ = script_new_vers_pattern (closure, $1, $3.value,
1094                                             $3.length, 1);
1095 	    }
1096         | /* Push string on the language stack. */
1097           EXTERN string '{'
1098 	    { version_script_push_lang (closure, $2.value, $2.length); }
1099 	  vers_defns opt_semicolon '}'
1100 	    {
1101 	      $$ = $5;
1102 	      version_script_pop_lang(closure);
1103 	    }
1104         | /* Push string on the language stack.  This is more complicated
1105              than the other cases because we need to merge the linked-list
1106              state from the pre-EXTERN defns and the post-EXTERN defns.  */
1107           vers_defns ';' EXTERN string '{'
1108 	    { version_script_push_lang (closure, $4.value, $4.length); }
1109 	  vers_defns opt_semicolon '}'
1110 	    {
1111 	      $$ = script_merge_expressions ($1, $7);
1112 	      version_script_pop_lang(closure);
1113 	    }
1114         | EXTERN  // "extern" as a symbol name
1115 	    {
1116 	      $$ = script_new_vers_pattern (closure, NULL, "extern",
1117 					    sizeof("extern") - 1, 1);
1118 	    }
1119 	| vers_defns ';' EXTERN
1120 	    {
1121 	      $$ = script_new_vers_pattern (closure, $1, "extern",
1122 					    sizeof("extern") - 1, 1);
1123 	    }
1124 	;
1125 
1126 /* A string can be either a STRING or a QUOTED_STRING.  Almost all the
1127    time we don't care, and we use this rule.  */
1128 string:
1129           STRING
1130 	    { $$ = $1; }
1131 	| QUOTED_STRING
1132 	    { $$ = $1; }
1133 	;
1134 
1135 /* Some statements require a terminator, which may be a semicolon or a
1136    comma.  */
1137 end:
1138 	  ';'
1139 	| ','
1140 	;
1141 
1142 /* An optional semicolon.  */
1143 opt_semicolon:
1144 	  ';'
1145 	|  /* empty */
1146 	;
1147 
1148 /* An optional comma.  */
1149 opt_comma:
1150 	  ','
1151 	| /* empty */
1152 	;
1153 
1154 %%
1155