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