/* Shared library declarations for GDB, the GNU Debugger.
- Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1996, 1998, 1999, 2000,
- 2001, 2007, 2008, 2009, 2010, 2011 Free Software Foundation, Inc.
+ Copyright (C) 1990-2017 Free Software Foundation, Inc.
This file is part of GDB.
#define SO_NAME_MAX_PATH_SIZE 512 /* FIXME: Should be dynamic */
/* For domain_enum domain. */
#include "symtab.h"
+#include "gdb_bfd.h"
/* Forward declaration for target specific link map information. This
struct is opaque to all but the target specific file. */
associated with a so_list entry. */
void (*free_so) (struct so_list *so);
+ /* Reset private data structures associated with SO.
+ This is called when SO is about to be reloaded.
+ It is also called before free_so when SO is about to be freed. */
+ void (*clear_so) (struct so_list *so);
+
/* Reset or free private data structures not associated with
so_list entries. */
void (*clear_solib) (void);
/* Target dependent code to run after child process fork. */
void (*solib_create_inferior_hook) (int from_tty);
- /* Do additional symbol handling, lookup, etc. after symbols
- for a shared object have been loaded. */
- void (*special_symbol_handling) (void);
+ /* Construct a list of the currently loaded shared objects. This
+ list does not include an entry for the main executable file.
- /* Construct a list of the currently loaded shared objects. */
+ Note that we only gather information directly available from the
+ inferior --- we don't examine any of the shared library files
+ themselves. The declaration of `struct so_list' says which fields
+ we provide values for. */
struct so_list *(*current_sos) (void);
- /* Find, open, and read the symbols for the main executable. */
+ /* Find, open, and read the symbols for the main executable. If
+ FROM_TTYP dereferences to a non-zero integer, allow messages to
+ be printed. This parameter is a pointer rather than an int
+ because open_symbol_file_object is called via catch_errors and
+ catch_errors requires a pointer argument. */
int (*open_symbol_file_object) (void *from_ttyp);
/* Determine if PC lies in the dynamic symbol resolution code of
int (*in_dynsym_resolve_code) (CORE_ADDR pc);
/* Find and open shared library binary file. */
- bfd *(*bfd_open) (char *pathname);
+ gdb_bfd_ref_ptr (*bfd_open) (char *pathname);
- /* Extra hook for finding and opening a solib.
- Convenience function for remote debuggers finding host libs. */
- int (*find_and_open_solib) (char *soname,
+ /* Optional extra hook for finding and opening a solib.
+ If TEMP_PATHNAME is non-NULL: If the file is successfully opened a
+ pointer to a malloc'd and realpath'd copy of SONAME is stored there,
+ otherwise NULL is stored there. */
+ int (*find_and_open_solib) (const char *soname,
unsigned o_flags, char **temp_pathname);
/* Hook for looking up global symbols in a library-specific way. */
- struct symbol * (*lookup_lib_global_symbol) (const struct objfile *objfile,
- const char *name,
- const domain_enum domain);
+ struct block_symbol (*lookup_lib_global_symbol)
+ (struct objfile *objfile,
+ const char *name,
+ const domain_enum domain);
/* Given two so_list objects, one from the GDB thread list
and another from the list returned by current_sos, return 1
core file (in particular, for readonly sections). */
int (*keep_data_in_core) (CORE_ADDR vaddr,
unsigned long size);
+
+ /* Enable or disable optional solib event breakpoints as
+ appropriate. This should be called whenever
+ stop_on_solib_events is changed. This pointer can be
+ NULL, in which case no enabling or disabling is necessary
+ for this target. */
+ void (*update_breakpoints) (void);
+
+ /* Target-specific processing of solib events that will be
+ performed before solib_add is called. This pointer can be
+ NULL, in which case no specific preprocessing is necessary
+ for this target. */
+ void (*handle_event) (void);
};
/* Free the memory associated with a (so_list *). */
/* Return address of first so_list entry in master shared object list. */
struct so_list *master_so_list (void);
+/* Find main executable binary file. */
+extern char *exec_file_find (const char *in_pathname, int *fd);
+
/* Find shared library binary file. */
-extern char *solib_find (char *in_pathname, int *fd);
+extern char *solib_find (const char *in_pathname, int *fd);
/* Open BFD for shared library file. */
-extern bfd *solib_bfd_fopen (char *pathname, int fd);
+extern gdb_bfd_ref_ptr solib_bfd_fopen (char *pathname, int fd);
/* Find solib binary file and open it. */
-extern bfd *solib_bfd_open (char *in_pathname);
+extern gdb_bfd_ref_ptr solib_bfd_open (char *in_pathname);
/* FIXME: gdbarch needs to control this variable. */
extern struct target_so_ops *current_target_so_ops;
/* Handler for library-specific global symbol lookup in solib.c. */
-struct symbol *solib_global_lookup (const struct objfile *objfile,
- const char *name,
- const domain_enum domain);
+struct block_symbol solib_global_lookup (struct objfile *objfile,
+ const char *name,
+ const domain_enum domain);
#endif
projects / deliverable / binutils-gdb.git / blobdiff