[deliverable/binutils-gdb.git] / ld / ldemul.h

/* ld-emul.h - Linker emulation header file
   Copyright 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 2000
   Free Software Foundation, Inc.

   This file is part of GLD, the Gnu Linker.

   GLD is free software; you can redistribute it and/or modify
   it under the terms of the GNU General Public License as published by
   the Free Software Foundation; either version 1, or (at your option)
   any later version.

   GLD is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   GNU General Public License for more details.  */

#ifndef LDEMUL_H
#define LDEMUL_H

extern void ldemul_hll PARAMS ((char *));
extern void ldemul_syslib PARAMS ((char *));
extern void ldemul_after_parse PARAMS ((void));
extern void ldemul_before_parse PARAMS ((void));
extern void ldemul_after_open PARAMS ((void));
extern void ldemul_after_allocation PARAMS ((void));
extern void ldemul_before_allocation PARAMS ((void));
extern void ldemul_set_output_arch PARAMS ((void));
extern char *ldemul_choose_target PARAMS ((int, char**));
extern void ldemul_choose_mode PARAMS ((char *));
extern void ldemul_list_emulations PARAMS ((FILE *));
extern void ldemul_list_emulation_options PARAMS ((FILE *));
extern char *ldemul_get_script PARAMS ((int *isfile));
extern void ldemul_finish PARAMS ((void));
extern void ldemul_set_symbols PARAMS ((void));
extern void ldemul_create_output_section_statements PARAMS ((void));
extern boolean ldemul_place_orphan
  PARAMS ((struct lang_input_statement_struct *, asection *));
extern int ldemul_parse_args PARAMS ((int, char **));
extern boolean ldemul_unrecognized_file
  PARAMS ((struct lang_input_statement_struct *));
extern boolean ldemul_recognized_file
  PARAMS ((struct lang_input_statement_struct *));
extern boolean ldemul_open_dynamic_archive
  PARAMS ((const char *, struct search_dirs *,
	   struct lang_input_statement_struct *));
extern char *ldemul_default_target PARAMS ((int, char**));
extern void after_parse_default PARAMS ((void));
extern void after_open_default PARAMS ((void));
extern void after_allocation_default PARAMS ((void));
extern void before_allocation_default PARAMS ((void));
extern void set_output_arch_default PARAMS ((void));
extern void syslib_default PARAMS ((char*));
extern void hll_default PARAMS ((char*));
extern int  ldemul_find_potential_libraries
  PARAMS ((char *, struct lang_input_statement_struct *));
extern struct bfd_elf_version_expr *ldemul_new_vers_pattern
  PARAMS ((struct bfd_elf_version_expr *));

typedef struct ld_emulation_xfer_struct {
  /* Run before parsing the command line and script file.
     Set the architecture, maybe other things.  */
  void   (*before_parse) PARAMS ((void));

  /* Handle the SYSLIB (low level library) script command.  */
  void   (*syslib) PARAMS ((char *));

  /* Handle the HLL (high level library) script command.  */
  void   (*hll) PARAMS ((char *));

  /* Run after parsing the command line and script file.  */
  void   (*after_parse) PARAMS ((void));

  /* Run after opening all input files, and loading the symbols.  */
  void   (*after_open) PARAMS ((void));

  /* Run after allocating output sections.  */
  void   (*after_allocation) PARAMS ( (void));

  /* Set the output architecture and machine if possible.  */
  void   (*set_output_arch) PARAMS ((void));

  /* Decide which target name to use.  */
  char * (*choose_target) PARAMS ((int, char**));

  /* Run before allocating output sections.  */
  void   (*before_allocation) PARAMS ((void));

  /* Return the appropriate linker script.  */
  char * (*get_script) PARAMS ((int *isfile));

  /* The name of this emulation.  */
  char *emulation_name;

  /* The output format.  */
  char *target_name;

  /* Run after assigning values from the script.  */
  void	(*finish) PARAMS ((void));

  /* Create any output sections needed by the target.  */
  void	(*create_output_section_statements) PARAMS ((void));

  /* Try to open a dynamic library.  ARCH is an architecture name, and
     is normally the empty string.  ENTRY is the lang_input_statement
     that should be opened.  */
  boolean (*open_dynamic_archive)
    PARAMS ((const char *arch, struct search_dirs *,
	     struct lang_input_statement_struct *entry));

  /* Place an orphan section.  Return true if it was placed, false if
     the default action should be taken.  This field may be NULL, in
     which case the default action will always be taken.  */
  boolean (*place_orphan)
    PARAMS ((struct lang_input_statement_struct *, asection *));

  /* Run after assigning parsing with the args, but before
     reading the script.  Used to initialize symbols used in the script.  */
  void	(*set_symbols) PARAMS ((void));

  /* Run to parse args which the base linker doesn't
     understand. Return non zero on sucess.  */
  int (*parse_args) PARAMS ((int, char **));

  /* Run to handle files which are not recognized as object files or
     archives.  Return true if the file was handled.  */
  boolean (*unrecognized_file)
    PARAMS ((struct lang_input_statement_struct *));

  /* Run to list the command line options which parse_args handles.  */
  void (* list_options) PARAMS ((FILE *));

  /* Run to specially handle files which *are* recognized as object
     files or archives.  Return true if the file was handled.  */
  boolean (*recognized_file)
    PARAMS ((struct lang_input_statement_struct *));

  /* Called when looking for libraries in a directory specified
     via a linker command line option or linker script option.
     Files that match the pattern "lib*.a" have already been scanned.
     (For VMS files matching ":lib*.a" have also been scanned).  */
  int (* find_potential_libraries)
    PARAMS ((char *, struct lang_input_statement_struct *));

  /* Called when adding a new version pattern.  PowerPC64-ELF uses
     this hook to add a pattern matching ".foo" for every "foo".  */
  struct bfd_elf_version_expr * (*new_vers_pattern)
    PARAMS ((struct bfd_elf_version_expr *));

} ld_emulation_xfer_type;

typedef enum {
  intel_ic960_ld_mode_enum,
  default_mode_enum,
  intel_gld960_ld_mode_enum
} lang_emulation_mode_enum_type;

extern ld_emulation_xfer_type *ld_emulations[];

#endif
Commit	Line	Data
252b5132	1	/* ld-emul.h - Linker emulation header file
a2b64bed	2	Copyright 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 2000
5cc18311	3	Free Software Foundation, Inc.
252b5132 RH	4
	5	This file is part of GLD, the Gnu Linker.
	6
	7	GLD is free software; you can redistribute it and/or modify
	8	it under the terms of the GNU General Public License as published by
	9	the Free Software Foundation; either version 1, or (at your option)
	10	any later version.
	11
	12	GLD is distributed in the hope that it will be useful,
	13	but WITHOUT ANY WARRANTY; without even the implied warranty of
	14	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
	15	GNU General Public License for more details. */
	16
	17	#ifndef LDEMUL_H
	18	#define LDEMUL_H
	19
252b5132 RH	20	extern void ldemul_hll PARAMS ((char *));
	21	extern void ldemul_syslib PARAMS ((char *));
	22	extern void ldemul_after_parse PARAMS ((void));
	23	extern void ldemul_before_parse PARAMS ((void));
	24	extern void ldemul_after_open PARAMS ((void));
	25	extern void ldemul_after_allocation PARAMS ((void));
	26	extern void ldemul_before_allocation PARAMS ((void));
	27	extern void ldemul_set_output_arch PARAMS ((void));
742aeb63	28	extern char ldemul_choose_target PARAMS ((int, char*));
252b5132 RH	29	extern void ldemul_choose_mode PARAMS ((char *));
	30	extern void ldemul_list_emulations PARAMS ((FILE *));
	31	extern void ldemul_list_emulation_options PARAMS ((FILE *));
	32	extern char ldemul_get_script PARAMS ((int isfile));
	33	extern void ldemul_finish PARAMS ((void));
	34	extern void ldemul_set_symbols PARAMS ((void));
	35	extern void ldemul_create_output_section_statements PARAMS ((void));
	36	extern boolean ldemul_place_orphan
	37	PARAMS ((struct lang_input_statement_struct , asection ));
	38	extern int ldemul_parse_args PARAMS ((int, char **));
	39	extern boolean ldemul_unrecognized_file
	40	PARAMS ((struct lang_input_statement_struct *));
	41	extern boolean ldemul_recognized_file
	42	PARAMS ((struct lang_input_statement_struct *));
	43	extern boolean ldemul_open_dynamic_archive
	44	PARAMS ((const char , struct search_dirs ,
	45	struct lang_input_statement_struct *));
742aeb63	46	extern char ldemul_default_target PARAMS ((int, char*));
252b5132 RH	47	extern void after_parse_default PARAMS ((void));
	48	extern void after_open_default PARAMS ((void));
	49	extern void after_allocation_default PARAMS ((void));
	50	extern void before_allocation_default PARAMS ((void));
	51	extern void set_output_arch_default PARAMS ((void));
	52	extern void syslib_default PARAMS ((char*));
	53	extern void hll_default PARAMS ((char*));
344a211f NC	54	extern int ldemul_find_potential_libraries
344a211f NC	55	PARAMS ((char , struct lang_input_statement_struct ));
fac1652d AM	56	extern struct bfd_elf_version_expr *ldemul_new_vers_pattern
fac1652d AM	57	PARAMS ((struct bfd_elf_version_expr *));
252b5132	58
89cdebba	59	typedef struct ld_emulation_xfer_struct {
252b5132 RH	60	/* Run before parsing the command line and script file.
	61	Set the architecture, maybe other things. */
	62	void (*before_parse) PARAMS ((void));
	63
	64	/* Handle the SYSLIB (low level library) script command. */
	65	void (syslib) PARAMS ((char ));
	66
	67	/* Handle the HLL (high level library) script command. */
	68	void (hll) PARAMS ((char ));
	69
	70	/* Run after parsing the command line and script file. */
	71	void (*after_parse) PARAMS ((void));
	72
	73	/* Run after opening all input files, and loading the symbols. */
	74	void (*after_open) PARAMS ((void));
	75
	76	/* Run after allocating output sections. */
	77	void (*after_allocation) PARAMS ( (void));
	78
	79	/* Set the output architecture and machine if possible. */
	80	void (*set_output_arch) PARAMS ((void));
	81
	82	/* Decide which target name to use. */
742aeb63	83	char * (choose_target) PARAMS ((int, char*));
252b5132 RH	84
	85	/* Run before allocating output sections. */
	86	void (*before_allocation) PARAMS ((void));
	87
	88	/* Return the appropriate linker script. */
	89	char * (get_script) PARAMS ((int isfile));
	90
	91	/* The name of this emulation. */
	92	char *emulation_name;
	93
	94	/* The output format. */
	95	char *target_name;
	96
	97	/* Run after assigning values from the script. */
	98	void (*finish) PARAMS ((void));
	99
	100	/* Create any output sections needed by the target. */
	101	void (*create_output_section_statements) PARAMS ((void));
	102
	103	/* Try to open a dynamic library. ARCH is an architecture name, and
	104	is normally the empty string. ENTRY is the lang_input_statement
	105	that should be opened. */
	106	boolean (*open_dynamic_archive)
	107	PARAMS ((const char arch, struct search_dirs ,
	108	struct lang_input_statement_struct *entry));
	109
	110	/* Place an orphan section. Return true if it was placed, false if
	111	the default action should be taken. This field may be NULL, in
	112	which case the default action will always be taken. */
	113	boolean (*place_orphan)
	114	PARAMS ((struct lang_input_statement_struct , asection ));
	115
5cc18311 KH	116	/* Run after assigning parsing with the args, but before
5cc18311 KH	117	reading the script. Used to initialize symbols used in the script. */
252b5132 RH	118	void (*set_symbols) PARAMS ((void));
	119
	120	/* Run to parse args which the base linker doesn't
5cc18311	121	understand. Return non zero on sucess. */
252b5132 RH	122	int (parse_args) PARAMS ((int, char *));
	123
	124	/* Run to handle files which are not recognized as object files or
	125	archives. Return true if the file was handled. */
	126	boolean (*unrecognized_file)
	127	PARAMS ((struct lang_input_statement_struct *));
	128
	129	/* Run to list the command line options which parse_args handles. */
	130	void (* list_options) PARAMS ((FILE *));
	131
	132	/* Run to specially handle files which are recognized as object
	133	files or archives. Return true if the file was handled. */
	134	boolean (*recognized_file)
	135	PARAMS ((struct lang_input_statement_struct *));
	136
344a211f NC	137	/* Called when looking for libraries in a directory specified
	138	via a linker command line option or linker script option.
	139	Files that match the pattern "lib*.a" have already been scanned.
	140	(For VMS files matching ":lib.a" have also been scanned). /
	141	int (* find_potential_libraries)
	142	PARAMS ((char , struct lang_input_statement_struct ));
5cc18311	143
fac1652d AM	144	/* Called when adding a new version pattern. PowerPC64-ELF uses
	145	this hook to add a pattern matching ".foo" for every "foo". */
	146	struct bfd_elf_version_expr * (*new_vers_pattern)
	147	PARAMS ((struct bfd_elf_version_expr *));
	148
252b5132 RH	149	} ld_emulation_xfer_type;
252b5132 RH	150
89cdebba	151	typedef enum {
252b5132	152	intel_ic960_ld_mode_enum,
89cdebba	153	default_mode_enum,
252b5132 RH	154	intel_gld960_ld_mode_enum
	155	} lang_emulation_mode_enum_type;
	156
	157	extern ld_emulation_xfer_type *ld_emulations[];
	158
	159	#endif