* Sync comment with code's reality.
[dragonfly.git] / contrib / gdb / gdb / f-lang.h
1 /* Fortran language support definitions for GDB, the GNU debugger.
2    Copyright 1992, 1993, 1994 Free Software Foundation, Inc.
3    Contributed by Motorola.  Adapted from the C definitions by Farooq Butt
4    (fmbutt@engage.sps.mot.com).
5
6 This file is part of GDB.
7
8 This program is free software; you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation; either version 2 of the License, or
11 (at your option) any later version.
12
13 This program is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
16 GNU General Public License for more details.
17
18 You should have received a copy of the GNU General Public License
19 along with this program; if not, write to the Free Software
20 Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.  */
21
22 extern int f_parse PARAMS ((void));
23
24 extern void f_error PARAMS ((char *));  /* Defined in f-exp.y */
25
26 extern void f_print_type PARAMS ((struct type *, char *,
27                                   GDB_FILE *, int, int));
28
29 extern int f_val_print PARAMS ((struct type *, char *, int, 
30                                 CORE_ADDR, GDB_FILE *,
31                                 int, int, int, enum val_prettyprint));
32
33 /* Language-specific data structures */ 
34
35 struct common_entry
36 {
37   struct symbol *symbol;                    /* The symbol node corresponding
38                                                to this component */ 
39   struct common_entry *next;                /* The next component */ 
40 };
41
42 struct saved_f77_common
43 {
44   char *name;                                /* Name of COMMON */
45   char *owning_function;                     /* Name of parent function */ 
46   int secnum;                                /* Section # of .bss */ 
47   CORE_ADDR offset;                          /* Offset from .bss for 
48                                                 this block */
49   struct common_entry *entries;              /* List of block's components */
50   struct common_entry *end_of_entries;       /* ptr. to end of components */ 
51   struct saved_f77_common *next;              /* Next saved COMMON block */ 
52 };
53
54 typedef struct saved_f77_common    SAVED_F77_COMMON, *SAVED_F77_COMMON_PTR;
55
56 typedef struct common_entry        COMMON_ENTRY, *COMMON_ENTRY_PTR;
57
58 extern SAVED_F77_COMMON_PTR head_common_list;   /* Ptr to 1st saved COMMON  */
59 extern SAVED_F77_COMMON_PTR tail_common_list;   /* Ptr to last saved COMMON  */
60 extern SAVED_F77_COMMON_PTR current_common;     /* Ptr to current COMMON */
61
62 extern SAVED_F77_COMMON_PTR find_common_for_function PARAMS ((char *, char *));
63
64 #define UNINITIALIZED_SECNUM -1 
65 #define COMMON_NEEDS_PATCHING(blk) ((blk)->secnum == UNINITIALIZED_SECNUM)
66
67 #define BLANK_COMMON_NAME_ORIGINAL "#BLNK_COM"  /* XLF assigned  */
68 #define BLANK_COMMON_NAME_MF77     "__BLNK__"   /* MF77 assigned  */
69 #define BLANK_COMMON_NAME_LOCAL    "__BLANK"    /* Local GDB */
70
71 #define BOUND_FETCH_OK 1
72 #define BOUND_FETCH_ERROR -999
73
74 /* When reasonable array bounds cannot be fetched, such as when 
75 you ask to 'mt print symbols' and there is no stack frame and 
76 therefore no way of knowing the bounds of stack-based arrays, 
77 we have to assign default bounds, these are as good as any... */ 
78
79 #define DEFAULT_UPPER_BOUND 999999
80 #define DEFAULT_LOWER_BOUND -999999
81
82 extern char *real_main_name;   /* Name of main function */ 
83 extern int  real_main_c_value;   /* C_value field of main function */ 
84
85 extern int f77_get_dynamic_upperbound PARAMS ((struct type *, int *));
86
87 extern int f77_get_dynamic_lowerbound PARAMS ((struct type *, int *));
88
89 extern void f77_get_dynamic_array_length PARAMS ((struct type *)); 
90
91 extern int calc_f77_array_dims PARAMS ((struct type *));
92
93 #define DEFAULT_DOTMAIN_NAME_IN_MF77            ".MAIN_"
94 #define DEFAULT_MAIN_NAME_IN_MF77               "MAIN_"
95 #define DEFAULT_DOTMAIN_NAME_IN_XLF_BUGGY       ".main "
96 #define DEFAULT_DOTMAIN_NAME_IN_XLF             ".main"