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