2000-10-25 04:05:36 +08:00
|
|
|
/* Shared library declarations for GDB, the GNU Debugger.
|
2005-12-18 06:34:03 +08:00
|
|
|
Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1996, 1998, 1999, 2000,
|
2001-03-06 16:22:02 +08:00
|
|
|
2001
|
2000-10-25 04:05:36 +08:00
|
|
|
Free Software Foundation, Inc.
|
|
|
|
|
|
|
|
This file is part of GDB.
|
|
|
|
|
|
|
|
This program 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 2 of the License, or
|
|
|
|
(at your option) any later version.
|
|
|
|
|
|
|
|
This program 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.
|
|
|
|
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
|
|
along with this program; if not, write to the Free Software
|
2005-12-18 06:34:03 +08:00
|
|
|
Foundation, Inc., 51 Franklin Street, Fifth Floor,
|
|
|
|
Boston, MA 02110-1301, USA. */
|
2000-10-25 04:05:36 +08:00
|
|
|
|
2001-10-22 03:20:30 +08:00
|
|
|
#ifndef SOLIST_H
|
|
|
|
#define SOLIST_H
|
|
|
|
|
2000-10-25 04:05:36 +08:00
|
|
|
#define SO_NAME_MAX_PATH_SIZE 512 /* FIXME: Should be dynamic */
|
|
|
|
|
|
|
|
/* Forward declaration for target specific link map information. This
|
|
|
|
struct is opaque to all but the target specific file. */
|
|
|
|
struct lm_info;
|
|
|
|
|
|
|
|
struct so_list
|
|
|
|
{
|
|
|
|
/* The following fields of the structure come directly from the
|
|
|
|
dynamic linker's tables in the inferior, and are initialized by
|
|
|
|
current_sos. */
|
|
|
|
|
|
|
|
struct so_list *next; /* next structure in linked list */
|
|
|
|
|
|
|
|
/* A pointer to target specific link map information. Often this
|
|
|
|
will be a copy of struct link_map from the user process, but
|
|
|
|
it need not be; it can be any collection of data needed to
|
|
|
|
traverse the dynamic linker's data structures. */
|
|
|
|
struct lm_info *lm_info;
|
|
|
|
|
|
|
|
/* Shared object file name, exactly as it appears in the
|
|
|
|
inferior's link map. This may be a relative path, or something
|
|
|
|
which needs to be looked up in LD_LIBRARY_PATH, etc. We use it
|
|
|
|
to tell which entries in the inferior's dynamic linker's link
|
|
|
|
map we've already loaded. */
|
|
|
|
char so_original_name[SO_NAME_MAX_PATH_SIZE];
|
|
|
|
|
|
|
|
/* shared object file name, expanded to something GDB can open */
|
|
|
|
char so_name[SO_NAME_MAX_PATH_SIZE];
|
|
|
|
|
|
|
|
/* The following fields of the structure are built from
|
|
|
|
information gathered from the shared object file itself, and
|
2001-05-25 09:27:11 +08:00
|
|
|
are set when we actually add it to our symbol tables.
|
|
|
|
|
|
|
|
current_sos must initialize these fields to 0. */
|
2000-10-25 04:05:36 +08:00
|
|
|
|
|
|
|
bfd *abfd;
|
|
|
|
char symbols_loaded; /* flag: symbols read in yet? */
|
|
|
|
char from_tty; /* flag: print msgs? */
|
|
|
|
struct objfile *objfile; /* objfile for loaded lib */
|
|
|
|
struct section_table *sections;
|
|
|
|
struct section_table *sections_end;
|
|
|
|
struct section_table *textsection;
|
|
|
|
};
|
|
|
|
|
|
|
|
struct target_so_ops
|
|
|
|
{
|
2000-10-31 07:31:17 +08:00
|
|
|
/* Adjust the section binding addresses by the base address at
|
|
|
|
which the object was actually mapped. */
|
|
|
|
void (*relocate_section_addresses) (struct so_list *so,
|
|
|
|
struct section_table *);
|
|
|
|
|
|
|
|
/* Free the the link map info and any other private data
|
|
|
|
structures associated with a so_list entry. */
|
2000-10-25 04:05:36 +08:00
|
|
|
void (*free_so) (struct so_list *so);
|
2000-10-31 07:31:17 +08:00
|
|
|
|
|
|
|
/* Reset or free private data structures not associated with
|
|
|
|
so_list entries. */
|
2000-10-25 04:05:36 +08:00
|
|
|
void (*clear_solib) (void);
|
2000-10-31 07:31:17 +08:00
|
|
|
|
|
|
|
/* Target dependent code to run after child process fork. */
|
2000-10-25 04:05:36 +08:00
|
|
|
void (*solib_create_inferior_hook) (void);
|
2000-10-31 07:31:17 +08:00
|
|
|
|
|
|
|
/* Do additional symbol handling, lookup, etc. after symbols
|
|
|
|
for a shared object have been loaded. */
|
2000-10-25 04:05:36 +08:00
|
|
|
void (*special_symbol_handling) (void);
|
2000-10-31 07:31:17 +08:00
|
|
|
|
|
|
|
/* Construct a list of the currently loaded shared objects. */
|
2000-10-25 04:05:36 +08:00
|
|
|
struct so_list *(*current_sos) (void);
|
2000-10-31 07:31:17 +08:00
|
|
|
|
|
|
|
/* Find, open, and read the symbols for the main executable. */
|
2000-10-25 04:05:36 +08:00
|
|
|
int (*open_symbol_file_object) (void *from_ttyp);
|
2001-02-22 11:01:27 +08:00
|
|
|
|
|
|
|
/* Determine if PC lies in the dynamic symbol resolution code of
|
|
|
|
the run time loader */
|
|
|
|
int (*in_dynsym_resolve_code) (CORE_ADDR pc);
|
2003-02-25 03:11:04 +08:00
|
|
|
|
2005-01-14 12:00:06 +08:00
|
|
|
/* Extra hook for finding and opening a solib.
|
|
|
|
Convenience function for remote debuggers finding host libs. */
|
2003-02-25 03:11:04 +08:00
|
|
|
int (*find_and_open_solib) (char *soname,
|
|
|
|
unsigned o_flags, char **temp_pathname);
|
|
|
|
|
2000-10-25 04:05:36 +08:00
|
|
|
};
|
|
|
|
|
2004-03-12 01:04:40 +08:00
|
|
|
/* Free the memory associated with a (so_list *). */
|
2000-10-25 04:05:36 +08:00
|
|
|
void free_so (struct so_list *so);
|
|
|
|
|
2004-03-12 01:04:40 +08:00
|
|
|
/* Return address of first so_list entry in master shared object list. */
|
|
|
|
struct so_list *master_so_list (void);
|
|
|
|
|
2000-11-21 09:09:54 +08:00
|
|
|
/* Find solib binary file and open it. */
|
|
|
|
extern int solib_open (char *in_pathname, char **found_pathname);
|
|
|
|
|
2000-10-25 04:05:36 +08:00
|
|
|
/* FIXME: gdbarch needs to control this variable */
|
|
|
|
extern struct target_so_ops *current_target_so_ops;
|
|
|
|
|
2000-10-31 07:31:17 +08:00
|
|
|
#define TARGET_SO_RELOCATE_SECTION_ADDRESSES \
|
|
|
|
(current_target_so_ops->relocate_section_addresses)
|
2003-02-25 03:11:04 +08:00
|
|
|
#define TARGET_SO_FIND_AND_OPEN_SOLIB \
|
|
|
|
(current_target_so_ops->find_and_open_solib)
|
2005-04-30 20:59:57 +08:00
|
|
|
#define TARGET_SO_IN_DYNSYM_RESOLVE_CODE \
|
|
|
|
(current_target_so_ops->in_dynsym_resolve_code)
|
2001-10-22 03:20:30 +08:00
|
|
|
|
|
|
|
#endif
|