libgfortran/libgfortran.h

   1 /* Common declarations for all of libgfortran.
   2    Copyright (C) 2002, 2003, 2004, 2005, 2006, 2007 Free Software Foundation, Inc.
   3    Contributed by Paul Brook <paul@nowt.org>, and
   4    Andy Vaught <andy@xena.eas.asu.edu>
   5
   6 This file is part of the GNU Fortran 95 runtime library (libgfortran).
   7
   8 Libgfortran is free software; you can redistribute it and/or
   9 modify it under the terms of the GNU Lesser General Public
  10 License as published by the Free Software Foundation; either
  11 version 2.1 of the License, or (at your option) any later version.
  12
  13 Libgfortran 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 Lesser General Public License for more details.
  17
  18 You should have received a copy of the GNU Lesser General Public
  19 License along with libgfor; see the file COPYING.LIB.  If not,
  20 write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
  21 Boston, MA 02110-1301, USA.  */
  22
  23 /* As a special exception, if you link this library with other files,
  24    some of which are compiled with GCC, to produce an executable,
  25    this library does not by itself cause the resulting executable
  26    to be covered by the GNU General Public License.
  27    This exception does not however invalidate any other reasons why
  28    the executable file might be covered by the GNU General Public License.  */
  29
  30
  31 #ifndef LIBGFOR_H
  32 #define LIBGFOR_H
  33
  34 #include <stdio.h>
  35 #include <math.h>
  36 #include <stddef.h>
  37 #include <float.h>
  38 #include <stdarg.h>
  39
  40 #ifndef M_PI
  41 #define M_PI 3.14159265358979323846264338327
  42 #endif
  43
  44 #if HAVE_COMPLEX_H
  45 # include <complex.h>
  46 #else
  47 #define complex __complex__
  48 #endif
  49
  50 #include "config.h"
  51 #include "c99_protos.h"
  52
  53 #if HAVE_IEEEFP_H
  54 #include <ieeefp.h>
  55 #endif
  56
  57 #include "gstdint.h"
  58
  59 #if HAVE_SYS_TYPES_H
  60 #include <sys/types.h>
  61 #endif
  62 typedef off_t gfc_offset;
  63
  64 #ifndef NULL
  65 #define NULL (void *) 0
  66 #endif
  67
  68 #ifndef __GNUC__
  69 #define __attribute__(x)
  70 #endif
  71
  72
  73 /* For a library, a standard prefix is a requirement in order to partition
  74    the namespace.  IPREFIX is for symbols intended to be internal to the
  75    library.  */
  76 #define PREFIX(x)       _gfortran_ ## x
  77 #define IPREFIX(x)      _gfortrani_ ## x
  78
  79 /* Magic to rename a symbol at the compiler level.  You continue to refer
  80    to the symbol as OLD in the source, but it'll be named NEW in the asm.  */
  81 #define sym_rename(old, new) sym_rename1(old, __USER_LABEL_PREFIX__, new)
  82 #define sym_rename1(old, ulp, new) sym_rename2(old, ulp, new)
  83 #define sym_rename2(old, ulp, new) extern __typeof(old) old __asm__(#ulp #new)
  84
  85 /* There are several classifications of routines:
  86
  87      (1) Symbols used only within the library,
  88      (2) Symbols to be exported from the library,
  89      (3) Symbols to be exported from the library, but
  90          also used inside the library.
  91
  92    By telling the compiler about these different classifications we can
  93    tightly control the interface seen by the user, and get better code
  94    from the compiler at the same time.
  95
  96    One of the following should be used immediately after the declaration
  97    of each symbol:
  98
  99      internal_proto     Marks a symbol used only within the library,
 100                         and adds IPREFIX to the assembly-level symbol
 101                         name.  The later is important for maintaining
 102                         the namespace partition for the static library.
 103
 104      export_proto       Marks a symbol to be exported, and adds PREFIX
 105                         to the assembly-level symbol name.
 106
 107      export_proto_np    Marks a symbol to be exported without adding PREFIX.
 108
 109      iexport_proto      Marks a function to be exported, but with the
 110                         understanding that it can be used inside as well.
 111
 112      iexport_data_proto Similarly, marks a data symbol to be exported.
 113                         Unfortunately, some systems can't play the hidden
 114                         symbol renaming trick on data symbols, thanks to
 115                         the horribleness of COPY relocations.
 116
 117    If iexport_proto or iexport_data_proto is used, you must also use
 118    iexport or iexport_data after the *definition* of the symbol.  */
 119
 120 #if defined(HAVE_ATTRIBUTE_VISIBILITY)
 121 # define internal_proto(x) \
 122         sym_rename(x, IPREFIX (x)) __attribute__((__visibility__("hidden")))
 123 #else
 124 # define internal_proto(x)      sym_rename(x, IPREFIX(x))
 125 #endif
 126
 127 #if defined(HAVE_ATTRIBUTE_VISIBILITY) && defined(HAVE_ATTRIBUTE_ALIAS)
 128 # define export_proto(x)        sym_rename(x, PREFIX(x))
 129 # define export_proto_np(x)     extern char swallow_semicolon
 130 # define iexport_proto(x)       internal_proto(x)
 131 # define iexport(x)             iexport1(x, IPREFIX(x))
 132 # define iexport1(x,y)          iexport2(x,y)
 133 # define iexport2(x,y) \
 134         extern __typeof(x) PREFIX(x) __attribute__((__alias__(#y)))
 135 /* ??? We're not currently building a dll, and it's wrong to add dllexport
 136    to objects going into a static library archive.  */
 137 #elif 0 && defined(HAVE_ATTRIBUTE_DLLEXPORT)
 138 # define export_proto_np(x)     extern __typeof(x) x __attribute__((dllexport))
 139 # define export_proto(x)    sym_rename(x, PREFIX(x)) __attribute__((dllexport))
 140 # define iexport_proto(x)       export_proto(x)
 141 # define iexport(x)             extern char swallow_semicolon
 142 #else
 143 # define export_proto(x)        sym_rename(x, PREFIX(x))
 144 # define export_proto_np(x)     extern char swallow_semicolon
 145 # define iexport_proto(x)       export_proto(x)
 146 # define iexport(x)             extern char swallow_semicolon
 147 #endif
 148
 149 /* TODO: detect the case when we *can* hide the symbol.  */
 150 #define iexport_data_proto(x)   export_proto(x)
 151 #define iexport_data(x)         extern char swallow_semicolon
 152
 153 /* The only reliable way to get the offset of a field in a struct
 154    in a system independent way is via this macro.  */
 155 #ifndef offsetof
 156 #define offsetof(TYPE, MEMBER)  ((size_t) &((TYPE *) 0)->MEMBER)
 157 #endif
 158
 159 /* The isfinite macro is only available with C99, but some non-C99
 160    systems still provide fpclassify, and there is a `finite' function
 161    in BSD.
 162
 163    Also, isfinite is broken on Cygwin.
 164
 165    When isfinite is not available, try to use one of the
 166    alternatives, or bail out.  */
 167
 168 #if defined(HAVE_BROKEN_ISFINITE) || defined(__CYGWIN__)
 169 #undef isfinite
 170 #endif
 171
 172 #if defined(HAVE_BROKEN_ISNAN)
 173 #undef isnan
 174 #endif
 175
 176 #if defined(HAVE_BROKEN_FPCLASSIFY)
 177 #undef fpclassify
 178 #endif
 179
 180 #if !defined(isfinite)
 181 #if !defined(fpclassify)
 182 #define isfinite(x) ((x) - (x) == 0)
 183 #else
 184 #define isfinite(x) (fpclassify(x) != FP_NAN && fpclassify(x) != FP_INFINITE)
 185 #endif /* !defined(fpclassify) */
 186 #endif /* !defined(isfinite)  */
 187
 188 #if !defined(isnan)
 189 #if !defined(fpclassify)
 190 #define isnan(x) ((x) != (x))
 191 #else
 192 #define isnan(x) (fpclassify(x) == FP_NAN)
 193 #endif /* !defined(fpclassify) */
 194 #endif /* !defined(isfinite)  */
 195
 196 /* TODO: find the C99 version of these an move into above ifdef.  */
 197 #define REALPART(z) (__real__(z))
 198 #define IMAGPART(z) (__imag__(z))
 199 #define COMPLEX_ASSIGN(z_, r_, i_) {__real__(z_) = (r_); __imag__(z_) = (i_);}
 200
 201 #include "kinds.h"
 202
 203 /* Define the type used for the current record number for large file I/O.
 204    The size must be consistent with the size defined on the compiler side.  */
 205 #ifdef HAVE_GFC_INTEGER_8
 206 typedef GFC_INTEGER_8 GFC_IO_INT;
 207 #else
 208 #ifdef HAVE_GFC_INTEGER_4
 209 typedef GFC_INTEGER_4 GFC_IO_INT;
 210 #else
 211 #error "GFC_INTEGER_4 should be available for the library to compile".
 212 #endif
 213 #endif
 214
 215 /* The following two definitions must be consistent with the types used
 216    by the compiler.  */
 217 /* The type used of array indices, amongst other things.  */
 218 typedef ssize_t index_type;
 219 /* The type used for the lengths of character variables.  */
 220 typedef GFC_INTEGER_4 gfc_charlen_type;
 221
 222 /* This will be 0 on little-endian machines and one on big-endian machines.  */
 223 extern int l8_to_l4_offset;
 224 internal_proto(l8_to_l4_offset);
 225
 226 #define GFOR_POINTER_L8_TO_L4(p8) \
 227   (l8_to_l4_offset + (GFC_LOGICAL_4 *)(p8))
 228
 229 #define GFC_INTEGER_1_HUGE \
 230   (GFC_INTEGER_1)((((GFC_UINTEGER_1)1) << 7) - 1)
 231 #define GFC_INTEGER_2_HUGE \
 232   (GFC_INTEGER_2)((((GFC_UINTEGER_2)1) << 15) - 1)
 233 #define GFC_INTEGER_4_HUGE \
 234   (GFC_INTEGER_4)((((GFC_UINTEGER_4)1) << 31) - 1)
 235 #define GFC_INTEGER_8_HUGE \
 236   (GFC_INTEGER_8)((((GFC_UINTEGER_8)1) << 63) - 1)
 237 #ifdef HAVE_GFC_INTEGER_16
 238 #define GFC_INTEGER_16_HUGE \
 239   (GFC_INTEGER_16)((((GFC_UINTEGER_16)1) << 127) - 1)
 240 #endif
 241
 242 #define GFC_REAL_4_HUGE FLT_MAX
 243 #define GFC_REAL_8_HUGE DBL_MAX
 244 #ifdef HAVE_GFC_REAL_10
 245 #define GFC_REAL_10_HUGE LDBL_MAX
 246 #endif
 247 #ifdef HAVE_GFC_REAL_16
 248 #define GFC_REAL_16_HUGE LDBL_MAX
 249 #endif
 250
 251 #define GFC_REAL_4_DIGITS FLT_MANT_DIG
 252 #define GFC_REAL_8_DIGITS DBL_MANT_DIG
 253 #ifdef HAVE_GFC_REAL_10
 254 #define GFC_REAL_10_DIGITS LDBL_MANT_DIG
 255 #endif
 256 #ifdef HAVE_GFC_REAL_16
 257 #define GFC_REAL_16_DIGITS LDBL_MANT_DIG
 258 #endif
 259
 260 #define GFC_REAL_4_RADIX FLT_RADIX
 261 #define GFC_REAL_8_RADIX FLT_RADIX
 262 #ifdef HAVE_GFC_REAL_10
 263 #define GFC_REAL_10_RADIX FLT_RADIX
 264 #endif
 265 #ifdef HAVE_GFC_REAL_16
 266 #define GFC_REAL_16_RADIX FLT_RADIX
 267 #endif
 268
 269 #ifndef GFC_MAX_DIMENSIONS
 270 #define GFC_MAX_DIMENSIONS 7
 271 #endif
 272
 273 typedef struct descriptor_dimension
 274 {
 275   index_type stride;
 276   index_type lbound;
 277   index_type ubound;
 278 }
 279 descriptor_dimension;
 280
 281 #define GFC_ARRAY_DESCRIPTOR(r, type) \
 282 struct {\
 283   type *data;\
 284   size_t offset;\
 285   index_type dtype;\
 286   descriptor_dimension dim[r];\
 287 }
 288
 289 /* Commonly used array descriptor types.  */
 290 typedef GFC_ARRAY_DESCRIPTOR (GFC_MAX_DIMENSIONS, void) gfc_array_void;
 291 typedef GFC_ARRAY_DESCRIPTOR (GFC_MAX_DIMENSIONS, char) gfc_array_char;
 292 typedef GFC_ARRAY_DESCRIPTOR (GFC_MAX_DIMENSIONS, GFC_INTEGER_1) gfc_array_i1;
 293 typedef GFC_ARRAY_DESCRIPTOR (GFC_MAX_DIMENSIONS, GFC_INTEGER_2) gfc_array_i2;
 294 typedef GFC_ARRAY_DESCRIPTOR (GFC_MAX_DIMENSIONS, GFC_INTEGER_4) gfc_array_i4;
 295 typedef GFC_ARRAY_DESCRIPTOR (GFC_MAX_DIMENSIONS, GFC_INTEGER_8) gfc_array_i8;
 296 #ifdef HAVE_GFC_INTEGER_16
 297 typedef GFC_ARRAY_DESCRIPTOR (GFC_MAX_DIMENSIONS, GFC_INTEGER_16) gfc_array_i16;
 298 #endif
 299 typedef GFC_ARRAY_DESCRIPTOR (GFC_MAX_DIMENSIONS, GFC_REAL_4) gfc_array_r4;
 300 typedef GFC_ARRAY_DESCRIPTOR (GFC_MAX_DIMENSIONS, GFC_REAL_8) gfc_array_r8;
 301 #ifdef HAVE_GFC_REAL_10
 302 typedef GFC_ARRAY_DESCRIPTOR (GFC_MAX_DIMENSIONS, GFC_REAL_10) gfc_array_r10;
 303 #endif
 304 #ifdef HAVE_GFC_REAL_16
 305 typedef GFC_ARRAY_DESCRIPTOR (GFC_MAX_DIMENSIONS, GFC_REAL_16) gfc_array_r16;
 306 #endif
 307 typedef GFC_ARRAY_DESCRIPTOR (GFC_MAX_DIMENSIONS, GFC_COMPLEX_4) gfc_array_c4;
 308 typedef GFC_ARRAY_DESCRIPTOR (GFC_MAX_DIMENSIONS, GFC_COMPLEX_8) gfc_array_c8;
 309 #ifdef HAVE_GFC_COMPLEX_10
 310 typedef GFC_ARRAY_DESCRIPTOR (GFC_MAX_DIMENSIONS, GFC_COMPLEX_10) gfc_array_c10;
 311 #endif
 312 #ifdef HAVE_GFC_COMPLEX_16
 313 typedef GFC_ARRAY_DESCRIPTOR (GFC_MAX_DIMENSIONS, GFC_COMPLEX_16) gfc_array_c16;
 314 #endif
 315 typedef GFC_ARRAY_DESCRIPTOR (GFC_MAX_DIMENSIONS, GFC_LOGICAL_4) gfc_array_l4;
 316 typedef GFC_ARRAY_DESCRIPTOR (GFC_MAX_DIMENSIONS, GFC_LOGICAL_8) gfc_array_l8;
 317 #ifdef HAVE_GFC_LOGICAL_16
 318 typedef GFC_ARRAY_DESCRIPTOR (GFC_MAX_DIMENSIONS, GFC_LOGICAL_16) gfc_array_l16;
 319 #endif
 320
 321 #define GFC_DTYPE_RANK_MASK 0x07
 322 #define GFC_DTYPE_TYPE_SHIFT 3
 323 #define GFC_DTYPE_TYPE_MASK 0x38
 324 #define GFC_DTYPE_SIZE_SHIFT 6
 325
 326 /* added for f03.  --Rickett, 02.28.06 */
 327 #define GFC_NUM_RANK_BITS 3
 328
 329 enum
 330 {
 331   GFC_DTYPE_UNKNOWN = 0,
 332   GFC_DTYPE_INTEGER,
 333   /* TODO: recognize logical types.  */
 334   GFC_DTYPE_LOGICAL,
 335   GFC_DTYPE_REAL,
 336   GFC_DTYPE_COMPLEX,
 337   GFC_DTYPE_DERIVED,
 338   GFC_DTYPE_CHARACTER
 339 };
 340
 341 #define GFC_DESCRIPTOR_RANK(desc) ((desc)->dtype & GFC_DTYPE_RANK_MASK)
 342 #define GFC_DESCRIPTOR_TYPE(desc) (((desc)->dtype & GFC_DTYPE_TYPE_MASK) \
 343                                    >> GFC_DTYPE_TYPE_SHIFT)
 344 #define GFC_DESCRIPTOR_SIZE(desc) ((desc)->dtype >> GFC_DTYPE_SIZE_SHIFT)
 345 #define GFC_DESCRIPTOR_DATA(desc) ((desc)->data)
 346 #define GFC_DESCRIPTOR_DTYPE(desc) ((desc)->dtype)
 347
 348 /* Runtime library include.  */
 349 #define stringize(x) expand_macro(x)
 350 #define expand_macro(x) # x
 351
 352 /* Runtime options structure.  */
 353
 354 typedef struct
 355 {
 356   int stdin_unit, stdout_unit, stderr_unit, optional_plus;
 357   int allocate_init_flag, allocate_init_value;
 358   int locus;
 359
 360   int separator_len;
 361   const char *separator;
 362
 363   int mem_check;
 364   int use_stderr, all_unbuffered, default_recl;
 365
 366   int fpu_round, fpu_precision, fpe;
 367
 368   int sighup, sigint;
 369   int dump_core, backtrace;
 370 }
 371 options_t;
 372
 373 extern options_t options;
 374 internal_proto(options);
 375
 376 extern void handler (int);
 377 internal_proto(handler);
 378
 379
 380 /* Compile-time options that will influence the library.  */
 381
 382 typedef struct
 383 {
 384   int warn_std;
 385   int allow_std;
 386   int pedantic;
 387   int convert;
 388   int dump_core;
 389   int backtrace;
 390   int sign_zero;
 391   size_t record_marker;
 392   int max_subrecord_length;
 393   int bounds_check;
 394 }
 395 compile_options_t;
 396
 397 extern compile_options_t compile_options;
 398 internal_proto(compile_options);
 399
 400 extern void init_compile_options (void);
 401 internal_proto(init_compile_options);
 402
 403 #define GFC_MAX_SUBRECORD_LENGTH 2147483639   /* 2**31 - 9 */
 404
 405 /* Structure for statement options.  */
 406
 407 typedef struct
 408 {
 409   const char *name;
 410   int value;
 411 }
 412 st_option;
 413
 414 /* Runtime errors.  The EOR and EOF errors are required to be negative.
 415    These codes must be kept sychronized with their equivalents in
 416    gcc/fortran/gfortran.h .  */
 417
 418 typedef enum
 419 {
 420   ERROR_FIRST = -3,             /* Marker for the first error.  */
 421   ERROR_EOR = -2,
 422   ERROR_END = -1,
 423   ERROR_OK = 0,                 /* Indicates success, must be zero.  */
 424   ERROR_OS = 5000,              /* Operating system error, more info in errno.  */
 425   ERROR_OPTION_CONFLICT,
 426   ERROR_BAD_OPTION,
 427   ERROR_MISSING_OPTION,
 428   ERROR_ALREADY_OPEN,
 429   ERROR_BAD_UNIT,
 430   ERROR_FORMAT,
 431   ERROR_BAD_ACTION,
 432   ERROR_ENDFILE,
 433   ERROR_BAD_US,
 434   ERROR_READ_VALUE,
 435   ERROR_READ_OVERFLOW,
 436   ERROR_INTERNAL,
 437   ERROR_INTERNAL_UNIT,
 438   ERROR_ALLOCATION,
 439   ERROR_DIRECT_EOR,
 440   ERROR_SHORT_RECORD,
 441   ERROR_CORRUPT_FILE,
 442   ERROR_LAST                    /* Not a real error, the last error # + 1.  */
 443 }
 444 error_codes;
 445
 446
 447 /* Flags to specify which standard/extension contains a feature.
 448    Keep them in sync with their counterparts in gcc/fortran/gfortran.h.  */
 449 #define GFC_STD_LEGACY          (1<<6) /* Backward compatibility.  */
 450 #define GFC_STD_GNU             (1<<5)    /* GNU Fortran extension.  */
 451 #define GFC_STD_F2003           (1<<4)    /* New in F2003.  */
 452 /* Note that no features were obsoleted nor deleted in F2003.  */
 453 #define GFC_STD_F95             (1<<3)    /* New in F95.  */
 454 #define GFC_STD_F95_DEL         (1<<2)    /* Deleted in F95.  */
 455 #define GFC_STD_F95_OBS         (1<<1)    /* Obsoleted in F95.  */
 456 #define GFC_STD_F77             (1<<0)    /* Up to and including F77.  */
 457
 458 /* Bitmasks for the various FPE that can be enabled.
 459    Keep them in sync with their counterparts in gcc/fortran/gfortran.h.  */
 460 #define GFC_FPE_INVALID    (1<<0)
 461 #define GFC_FPE_DENORMAL   (1<<1)
 462 #define GFC_FPE_ZERO       (1<<2)
 463 #define GFC_FPE_OVERFLOW   (1<<3)
 464 #define GFC_FPE_UNDERFLOW  (1<<4)
 465 #define GFC_FPE_PRECISION  (1<<5)
 466
 467 /* This is returned by notification_std to know if, given the flags
 468    that were given (-std=, -pedantic) we should issue an error, a warning
 469    or nothing.  */
 470 typedef enum
 471 { SILENT, WARNING, ERROR }
 472 notification;
 473
 474 /* This is returned by notify_std and several io functions.  */
 475 typedef enum
 476 { SUCCESS = 1, FAILURE }
 477 try;
 478
 479 /* The filename and line number don't go inside the globals structure.
 480    They are set by the rest of the program and must be linked to.  */
 481
 482 /* Location of the current library call (optional).  */
 483 extern unsigned line;
 484 iexport_data_proto(line);
 485
 486 extern char *filename;
 487 iexport_data_proto(filename);
 488
 489 /* Avoid conflicting prototypes of alloca() in system headers by using
 490    GCC's builtin alloca().  */
 491 #define gfc_alloca(x)  __builtin_alloca(x)
 492
 493
 494 /* Various I/O stuff also used in other parts of the library.  */
 495
 496 #define DEFAULT_TEMPDIR "/tmp"
 497
 498 /* The default value of record length for preconnected units is defined
 499    here. This value can be overriden by an environment variable.
 500    Default value is 1 Gb.  */
 501 #define DEFAULT_RECL 1073741824
 502
 503 typedef enum
 504 { CONVERT_NONE=-1, CONVERT_NATIVE, CONVERT_SWAP, CONVERT_BIG, CONVERT_LITTLE }
 505 unit_convert;
 506
 507 #define CHARACTER2(name) \
 508               gfc_charlen_type name ## _len; \
 509               char * name
 510
 511 typedef struct st_parameter_common
 512 {
 513   GFC_INTEGER_4 flags;
 514   GFC_INTEGER_4 unit;
 515   const char *filename;
 516   GFC_INTEGER_4 line;
 517   CHARACTER2 (iomsg);
 518   GFC_INTEGER_4 *iostat;
 519 }
 520 st_parameter_common;
 521
 522 #undef CHARACTER2
 523
 524 #define IOPARM_LIBRETURN_MASK           (3 << 0)
 525 #define IOPARM_LIBRETURN_OK             (0 << 0)
 526 #define IOPARM_LIBRETURN_ERROR          (1 << 0)
 527 #define IOPARM_LIBRETURN_END            (2 << 0)
 528 #define IOPARM_LIBRETURN_EOR            (3 << 0)
 529 #define IOPARM_ERR                      (1 << 2)
 530 #define IOPARM_END                      (1 << 3)
 531 #define IOPARM_EOR                      (1 << 4)
 532 #define IOPARM_HAS_IOSTAT               (1 << 5)
 533 #define IOPARM_HAS_IOMSG                (1 << 6)
 534
 535 #define IOPARM_COMMON_MASK              ((1 << 7) - 1)
 536
 537 #define IOPARM_OPEN_HAS_RECL_IN         (1 << 7)
 538 #define IOPARM_OPEN_HAS_FILE            (1 << 8)
 539 #define IOPARM_OPEN_HAS_STATUS          (1 << 9)
 540 #define IOPARM_OPEN_HAS_ACCESS          (1 << 10)
 541 #define IOPARM_OPEN_HAS_FORM            (1 << 11)
 542 #define IOPARM_OPEN_HAS_BLANK           (1 << 12)
 543 #define IOPARM_OPEN_HAS_POSITION        (1 << 13)
 544 #define IOPARM_OPEN_HAS_ACTION          (1 << 14)
 545 #define IOPARM_OPEN_HAS_DELIM           (1 << 15)
 546 #define IOPARM_OPEN_HAS_PAD             (1 << 16)
 547 #define IOPARM_OPEN_HAS_CONVERT         (1 << 17)
 548
 549 /* library start function and end macro.  These can be expanded if needed
 550    in the future.  cmp is st_parameter_common *cmp  */
 551
 552 extern void library_start (st_parameter_common *);
 553 internal_proto(library_start);
 554
 555 #define library_end()
 556
 557 /* main.c */
 558
 559 extern void stupid_function_name_for_static_linking (void);
 560 internal_proto(stupid_function_name_for_static_linking);
 561
 562 extern void set_args (int, char **);
 563 export_proto(set_args);
 564
 565 extern void get_args (int *, char ***);
 566 internal_proto(get_args);
 567
 568 extern void store_exe_path (const char *);
 569 export_proto(store_exe_path);
 570
 571 extern char * full_exe_path (void);
 572 internal_proto(full_exe_path);
 573
 574 /* backtrace.c */
 575
 576 extern void show_backtrace (void);
 577 internal_proto(show_backtrace);
 578
 579 /* error.c */
 580
 581 #define GFC_ITOA_BUF_SIZE (sizeof (GFC_INTEGER_LARGEST) * 3 + 2)
 582 #define GFC_XTOA_BUF_SIZE (sizeof (GFC_UINTEGER_LARGEST) * 2 + 1)
 583 #define GFC_OTOA_BUF_SIZE (sizeof (GFC_INTEGER_LARGEST) * 3 + 1)
 584 #define GFC_BTOA_BUF_SIZE (sizeof (GFC_INTEGER_LARGEST) * 8 + 1)
 585
 586 extern void sys_exit (int) __attribute__ ((noreturn));
 587 internal_proto(sys_exit);
 588
 589 extern const char *gfc_itoa (GFC_INTEGER_LARGEST, char *, size_t);
 590 internal_proto(gfc_itoa);
 591
 592 extern const char *xtoa (GFC_UINTEGER_LARGEST, char *, size_t);
 593 internal_proto(xtoa);
 594
 595 extern void os_error (const char *) __attribute__ ((noreturn));
 596 iexport_proto(os_error);
 597
 598 extern void show_locus (st_parameter_common *);
 599 internal_proto(show_locus);
 600
 601 extern void runtime_error (const char *, ...)
 602      __attribute__ ((noreturn, format (printf, 1, 2)));
 603 iexport_proto(runtime_error);
 604
 605 extern void runtime_error_at (const char *, const char *, ...)
 606      __attribute__ ((noreturn, format (printf, 2, 3)));
 607 iexport_proto(runtime_error_at);
 608
 609 extern void internal_error (st_parameter_common *, const char *)
 610   __attribute__ ((noreturn));
 611 internal_proto(internal_error);
 612
 613 extern const char *get_oserror (void);
 614 internal_proto(get_oserror);
 615
 616 extern const char *translate_error (int);
 617 internal_proto(translate_error);
 618
 619 extern void generate_error (st_parameter_common *, int, const char *);
 620 iexport_proto(generate_error);
 621
 622 extern try notify_std (st_parameter_common *, int, const char *);
 623 internal_proto(notify_std);
 624
 625 extern notification notification_std(int);
 626 internal_proto(notification_std);
 627
 628 /* fpu.c */
 629
 630 extern void set_fpu (void);
 631 internal_proto(set_fpu);
 632
 633 /* memory.c */
 634
 635 extern void *get_mem (size_t) __attribute__ ((malloc));
 636 internal_proto(get_mem);
 637
 638 extern void free_mem (void *);
 639 internal_proto(free_mem);
 640
 641 extern void *internal_malloc_size (size_t) __attribute__ ((malloc));
 642 internal_proto(internal_malloc_size);
 643
 644 /* environ.c */
 645
 646 extern int check_buffered (int);
 647 internal_proto(check_buffered);
 648
 649 extern void init_variables (void);
 650 internal_proto(init_variables);
 651
 652 extern void show_variables (void);
 653 internal_proto(show_variables);
 654
 655 unit_convert get_unformatted_convert (int);
 656 internal_proto(get_unformatted_convert);
 657
 658 /* string.c */
 659
 660 extern int find_option (st_parameter_common *, const char *, gfc_charlen_type,
 661                         const st_option *, const char *);
 662 internal_proto(find_option);
 663
 664 extern gfc_charlen_type fstrlen (const char *, gfc_charlen_type);
 665 internal_proto(fstrlen);
 666
 667 extern gfc_charlen_type fstrcpy (char *, gfc_charlen_type, const char *, gfc_charlen_type);
 668 internal_proto(fstrcpy);
 669
 670 extern gfc_charlen_type cf_strcpy (char *, gfc_charlen_type, const char *);
 671 internal_proto(cf_strcpy);
 672
 673 /* io/intrinsics.c */
 674
 675 extern void flush_all_units (void);
 676 internal_proto(flush_all_units);
 677
 678 /* io.c */
 679
 680 extern void init_units (void);
 681 internal_proto(init_units);
 682
 683 extern void close_units (void);
 684 internal_proto(close_units);
 685
 686 extern int unit_to_fd (int);
 687 internal_proto(unit_to_fd);
 688
 689 extern int st_printf (const char *, ...)
 690   __attribute__ ((format (printf, 1, 2)));
 691 internal_proto(st_printf);
 692
 693 extern int st_vprintf (const char *, va_list);
 694 internal_proto(st_vprintf);
 695
 696 extern char * filename_from_unit (int);
 697 internal_proto(filename_from_unit);
 698
 699 /* stop.c */
 700
 701 extern void stop_numeric (GFC_INTEGER_4) __attribute__ ((noreturn));
 702 iexport_proto(stop_numeric);
 703
 704 /* reshape_packed.c */
 705
 706 extern void reshape_packed (char *, index_type, const char *, index_type,
 707                             const char *, index_type);
 708 internal_proto(reshape_packed);
 709
 710 /* Repacking functions.  */
 711
 712 /* ??? These aren't currently used by the compiler, though we
 713    certainly could do so.  */
 714 GFC_INTEGER_4 *internal_pack_4 (gfc_array_i4 *);
 715 internal_proto(internal_pack_4);
 716
 717 GFC_INTEGER_8 *internal_pack_8 (gfc_array_i8 *);
 718 internal_proto(internal_pack_8);
 719
 720 #if defined HAVE_GFC_INTEGER_16
 721 GFC_INTEGER_16 *internal_pack_16 (gfc_array_i16 *);
 722 internal_proto(internal_pack_16);
 723 #endif
 724
 725 GFC_COMPLEX_4 *internal_pack_c4 (gfc_array_c4 *);
 726 internal_proto(internal_pack_c4);
 727
 728 GFC_COMPLEX_8 *internal_pack_c8 (gfc_array_c8 *);
 729 internal_proto(internal_pack_c8);
 730
 731 #if defined HAVE_GFC_COMPLEX_10
 732 GFC_COMPLEX_10 *internal_pack_c10 (gfc_array_c10 *);
 733 internal_proto(internal_pack_c10);
 734 #endif
 735
 736 extern void internal_unpack_4 (gfc_array_i4 *, const GFC_INTEGER_4 *);
 737 internal_proto(internal_unpack_4);
 738
 739 extern void internal_unpack_8 (gfc_array_i8 *, const GFC_INTEGER_8 *);
 740 internal_proto(internal_unpack_8);
 741
 742 #if defined HAVE_GFC_INTEGER_16
 743 extern void internal_unpack_16 (gfc_array_i16 *, const GFC_INTEGER_16 *);
 744 internal_proto(internal_unpack_16);
 745 #endif
 746
 747 extern void internal_unpack_c4 (gfc_array_c4 *, const GFC_COMPLEX_4 *);
 748 internal_proto(internal_unpack_c4);
 749
 750 extern void internal_unpack_c8 (gfc_array_c8 *, const GFC_COMPLEX_8 *);
 751 internal_proto(internal_unpack_c8);
 752
 753 #if defined HAVE_GFC_COMPLEX_10
 754 extern void internal_unpack_c10 (gfc_array_c10 *, const GFC_COMPLEX_10 *);
 755 internal_proto(internal_unpack_c10);
 756 #endif
 757
 758 #if defined HAVE_GFC_COMPLEX_16
 759 extern void internal_unpack_c16 (gfc_array_c16 *, const GFC_COMPLEX_16 *);
 760 internal_proto(internal_unpack_c16);
 761 #endif
 762
 763 /* string_intrinsics.c */
 764
 765 extern int compare_string (GFC_INTEGER_4, const char *,
 766                            GFC_INTEGER_4, const char *);
 767 iexport_proto(compare_string);
 768
 769 /* random.c */
 770
 771 extern void random_seed_i4 (GFC_INTEGER_4 * size, gfc_array_i4 * put,
 772                             gfc_array_i4 * get);
 773 iexport_proto(random_seed_i4);
 774 extern void random_seed_i8 (GFC_INTEGER_8 * size, gfc_array_i8 * put,
 775                             gfc_array_i8 * get);
 776 iexport_proto(random_seed_i8);
 777
 778 /* size.c */
 779
 780 typedef GFC_ARRAY_DESCRIPTOR (GFC_MAX_DIMENSIONS, void) array_t;
 781
 782 extern index_type size0 (const array_t * array);
 783 iexport_proto(size0);
 784
 785 #endif  /* LIBGFOR_H  */