2011-02-21 Hui Zhu <teawater@gmail.com>

[deliverable/binutils-gdb.git] / gdb / solist.h

diff --git a/gdb/solist.h b/gdb/solist.h
index 573f73665120d0f01347ca19893996c07c50ece0..c4607d0d6c774153bf45226a5e0aff13a41136cf 100644 (file)
--- a/gdb/solist.h
+++ b/gdb/solist.h
@@ -1,6 +1,6 @@
 /* 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 Free Software Foundation, Inc.
+   2001, 2007, 2008, 2009, 2010, 2011 Free Software Foundation, Inc.
 
    This file is part of GDB.
 
@@ -39,7 +39,7 @@ struct so_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. */
+       traverse the dynamic linker's data structures.  */
     struct lm_info *lm_info;
 
     /* Shared object file name, exactly as it appears in the
@@ -49,7 +49,7 @@ struct so_list
        map we've already loaded.  */
     char so_original_name[SO_NAME_MAX_PATH_SIZE];
 
-    /* shared object file name, expanded to something GDB can open */
+    /* Shared object file name, expanded to something GDB can open.  */
     char so_name[SO_NAME_MAX_PATH_SIZE];
 
     /* Program space this shared library belongs to.  */
@@ -62,9 +62,13 @@ struct so_list
        current_sos must initialize these fields to 0.  */
 
     bfd *abfd;
-    char symbols_loaded;       /* flag: symbols read in yet? */
-    char from_tty;             /* flag: print msgs? */
-    struct objfile *objfile;   /* objfile for loaded lib */
+    char symbols_loaded;       /* flag: symbols read in yet?  */
+
+    /* objfile with symbols for a loaded library.  Target memory is read from
+       ABFD.  OBJFILE may be NULL either before symbols have been loaded, if
+       the file cannot be found or after the command "nosharedlibrary".  */
+    struct objfile *objfile;
+
     struct target_section *sections;
     struct target_section *sections_end;
 
@@ -103,13 +107,13 @@ struct target_so_ops
     int (*open_symbol_file_object) (void *from_ttyp);
 
     /* Determine if PC lies in the dynamic symbol resolution code of
-       the run time loader */
+       the run time loader.  */
     int (*in_dynsym_resolve_code) (CORE_ADDR pc);
 
     /* Find and open shared library binary file.  */
     bfd *(*bfd_open) (char *pathname);
 
-    /* Extra hook for finding and opening a solib.  
+    /* Extra hook for finding and opening a solib.
        Convenience function for remote debuggers finding host libs.  */
     int (*find_and_open_solib) (char *soname,
         unsigned o_flags, char **temp_pathname);
@@ -117,7 +121,6 @@ struct target_so_ops
     /* 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 char *linkage_name,
                                                 const domain_enum domain);
 
     /* Given two so_list objects, one from the GDB thread list
@@ -151,13 +154,12 @@ extern bfd *solib_bfd_fopen (char *pathname, int fd);
 /* Find solib binary file and open it.  */
 extern bfd *solib_bfd_open (char *in_pathname);
 
-/* FIXME: gdbarch needs to control this variable */
+/* 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 char *linkage_name,
                                    const domain_enum domain);
 
 #endif