Git Repo - binutils.git/blame_incremental

... / ...

Commit	Line	Data
	1	/* frags.h - Header file for the frag concept.
	2	Copyright (C) 1987-2022 Free Software Foundation, Inc.
	3
	4	This file is part of GAS, the GNU Assembler.
	5
	6	GAS is free software; you can redistribute it and/or modify
	7	it under the terms of the GNU General Public License as published by
	8	the Free Software Foundation; either version 3, or (at your option)
	9	any later version.
	10
	11	GAS is distributed in the hope that it will be useful,
	12	but WITHOUT ANY WARRANTY; without even the implied warranty of
	13	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
	14	GNU General Public License for more details.
	15
	16	You should have received a copy of the GNU General Public License
	17	along with GAS; see the file COPYING. If not, write to the Free
	18	Software Foundation, 51 Franklin Street - Fifth Floor, Boston, MA
	19	02110-1301, USA. */
	20
	21	#ifndef FRAGS_H
	22	#define FRAGS_H
	23
	24	/* A code fragment (frag) is some known number of chars, followed by some
	25	unknown number of chars. Typically the unknown number of chars is an
	26	instruction address whose size is yet unknown. We always know the greatest
	27	possible size the unknown number of chars may become, and reserve that
	28	much room at the end of the frag.
	29	Once created, frags do not change address during assembly.
	30	We chain the frags in (a) forward-linked list(s). The object-file address
	31	of the 1st char of a frag is generally not known until after relax().
	32	Many things at assembly time describe an address by {object-file-address
	33	of a particular frag}+offset.
	34
	35	BUG: it may be smarter to have a single pointer off to various different
	36	notes for different frag kinds. See how code pans. */
	37
	38	struct frag {
	39	/* Object file address (as an octet offset). */
	40	addressT fr_address;
	41	/* When relaxing multiple times, remember the address the frag had
	42	in the last relax pass. */
	43	addressT last_fr_address;
	44
	45	/* (Fixed) number of octets we know we have. May be 0. */
	46	valueT fr_fix;
	47	/* May be used for (Variable) number of octets after above.
	48	The generic frag handling code no longer makes any use of fr_var. */
	49	offsetT fr_var;
	50	/* For variable-length tail. */
	51	offsetT fr_offset;
	52	/* For variable-length tail. */
	53	symbolS *fr_symbol;
	54	/* Points to opcode low addr byte, for relaxation. */
	55	char *fr_opcode;
	56
	57	/* Chain forward; ascending address order. Rooted in frch_root. */
	58	struct frag *fr_next;
	59
	60	/* Where the frag was created, or where it became a variant frag. */
	61	const char *fr_file;
	62	unsigned int fr_line;
	63
	64	#ifndef NO_LISTING
	65	struct list_info_struct *line;
	66	#endif
	67
	68	/* A serial number for a sequence of frags having at most one alignment
	69	or org frag, and that at the tail of the sequence. */
	70	unsigned int region:16;
	71
	72	/* Flipped each relax pass so we can easily determine whether
	73	fr_address has been adjusted. */
	74	unsigned int relax_marker:1;
	75
	76	/* Used to ensure that all insns are emitted on proper address
	77	boundaries. */
	78	unsigned int has_code:1;
	79	unsigned int insn_addr:6;
	80
	81	/* What state is my tail in? */
	82	relax_stateT fr_type;
	83	relax_substateT fr_subtype;
	84
	85	#ifdef USING_CGEN
	86	/* Don't include this unless using CGEN to keep frag size down. */
	87	struct {
	88	/* CGEN_INSN entry for this instruction. */
	89	const struct cgen_insn *insn;
	90	/* Index into operand table. */
	91	int opindex;
	92	/* Target specific data, usually reloc number. */
	93	int opinfo;
	94	} fr_cgen;
	95	#endif
	96
	97	#ifdef TC_FRAG_TYPE
	98	TC_FRAG_TYPE tc_frag_data;
	99	#endif
	100	#ifdef OBJ_FRAG_TYPE
	101	OBJ_FRAG_TYPE obj_frag_data;
	102	#endif
	103
	104	/* Data begins here. */
	105	char fr_literal[1];
	106	};
	107
	108	#define SIZEOF_STRUCT_FRAG \
	109	((char ) zero_address_frag.fr_literal - (char ) &zero_address_frag)
	110	/* We want to say fr_literal[0] above. */
	111
	112	/* Current frag we are building. This frag is incomplete. It is,
	113	however, included in frchain_now. The fr_fix field is bogus;
	114	instead, use frag_now_fix (). */
	115	COMMON fragS *frag_now;
	116	extern addressT frag_now_fix (void);
	117	extern addressT frag_now_fix_octets (void);
	118
	119	/* For foreign-segment symbol fixups. */
	120	COMMON fragS zero_address_frag;
	121	COMMON fragS predefined_address_frag;
	122
	123	extern void frag_append_1_char (int);
	124	#define FRAG_APPEND_1_CHAR(X) frag_append_1_char (X)
	125
	126	void frag_init (void);
	127	fragS frag_alloc (struct obstack );
	128	void frag_grow (size_t nchars);
	129	char *frag_more (size_t nchars);
	130	void frag_align (int alignment, int fill_character, int max);
	131	void frag_align_pattern (int alignment, const char *fill_pattern,
	132	size_t n_fill, int max);
	133	void frag_align_code (int alignment, int max);
	134	void frag_new (size_t old_frags_var_max_size);
	135	void frag_wane (fragS * fragP);
	136	size_t frag_room (void);
	137
	138	char *frag_variant (relax_stateT type,
	139	size_t max_chars,
	140	size_t var,
	141	relax_substateT subtype,
	142	symbolS * symbol,
	143	offsetT offset,
	144	char *opcode);
	145
	146	char *frag_var (relax_stateT type,
	147	size_t max_chars,
	148	size_t var,
	149	relax_substateT subtype,
	150	symbolS * symbol,
	151	offsetT offset,
	152	char *opcode);
	153
	154	bool frag_offset_fixed_p (const fragS , const fragS , offsetT *);
	155	bool frag_offset_ignore_align_p (const fragS , const fragS , offsetT *);
	156	bool frag_gtoffset_p (valueT, const fragS , valueT, const fragS , offsetT *);
	157
	158	int get_frag_count (void);
	159	void clear_frag_count (void);
	160
	161	#endif /* FRAGS_H */