libgfortran/io/io.h

   1 /* Copyright (C) 2002-2016 Free Software Foundation, Inc.
   2    Contributed by Andy Vaught
   3    F2003 I/O support contributed by Jerry DeLisle
   4
   5 This file is part of the GNU Fortran runtime library (libgfortran).
   6
   7 Libgfortran is free software; you can redistribute it and/or modify
   8 it under the terms of the GNU General Public License as published by
   9 the Free Software Foundation; either version 3, or (at your option)
  10 any later version.
  11
  12 Libgfortran is distributed in the hope that it will be useful,
  13 but WITHOUT ANY WARRANTY; without even the implied warranty of
  14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15 GNU General Public License for more details.
  16
  17 Under Section 7 of GPL version 3, you are granted additional
  18 permissions described in the GCC Runtime Library Exception, version
  19 3.1, as published by the Free Software Foundation.
  20
  21 You should have received a copy of the GNU General Public License and
  22 a copy of the GCC Runtime Library Exception along with this program;
  23 see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
  24 <http://www.gnu.org/licenses/>.  */
  25
  26 #ifndef GFOR_IO_H
  27 #define GFOR_IO_H
  28
  29 /* IO library include.  */
  30
  31 #include "libgfortran.h"
  32
  33 #include <gthr.h>
  34
  35
  36 /* POSIX 2008 specifies that the extended locale stuff is found in
  37    locale.h, but some systems have them in xlocale.h.  */
  38
  39 #include <locale.h>
  40
  41 #ifdef HAVE_XLOCALE_H
  42 #include <xlocale.h>
  43 #endif
  44
  45
  46 /* Forward declarations.  */
  47 struct st_parameter_dt;
  48 typedef struct stream stream;
  49 struct fbuf;
  50 struct format_data;
  51 typedef struct fnode fnode;
  52 struct gfc_unit;
  53
  54 #ifdef HAVE_NEWLOCALE
  55 /* We have POSIX 2008 extended locale stuff.  */
  56 extern locale_t c_locale;
  57 internal_proto(c_locale);
  58 #else
  59 extern char* old_locale;
  60 internal_proto(old_locale);
  61 extern int old_locale_ctr;
  62 internal_proto(old_locale_ctr);
  63 extern __gthread_mutex_t old_locale_lock;
  64 internal_proto(old_locale_lock);
  65 #endif
  66
  67
  68 /* Macros for testing what kinds of I/O we are doing.  */
  69
  70 #define is_array_io(dtp) ((dtp)->internal_unit_desc)
  71
  72 #define is_internal_unit(dtp) ((dtp)->u.p.current_unit->internal_unit_kind)
  73
  74 #define is_stream_io(dtp) ((dtp)->u.p.current_unit->flags.access == ACCESS_STREAM)
  75
  76 #define is_char4_unit(dtp) ((dtp)->u.p.current_unit->internal_unit_kind == 4)
  77
  78 /* The array_loop_spec contains the variables for the loops over index ranges
  79    that are encountered.  */
  80
  81 typedef struct array_loop_spec
  82 {
  83   /* Index counter for this dimension.  */
  84   index_type idx;
  85
  86   /* Start for the index counter.  */
  87   index_type start;
  88
  89   /* End for the index counter.  */
  90   index_type end;
  91
  92   /* Step for the index counter.  */
  93   index_type step;
  94 }
  95 array_loop_spec;
  96
  97 /* User defined input/output iomsg length. */
  98
  99 #define IOMSG_LEN 256
 100
 101 /* Subroutine formatted_dtio (struct, unit, iotype, v_list, iostat,
 102                               iomsg, (_iotype), (_iomsg))  */
 103 typedef void (*formatted_dtio)(void *, GFC_INTEGER_4 *, char *, gfc_array_i4 *,
 104                                GFC_INTEGER_4 *, char *,
 105                                gfc_charlen_type, gfc_charlen_type);
 106
 107 /* Subroutine unformatted_dtio (struct, unit, iostat, iomsg, (_iomsg))  */
 108 typedef void (*unformatted_dtio)(void *, GFC_INTEGER_4 *, GFC_INTEGER_4 *,
 109                                  char *, gfc_charlen_type);
 110
 111 /* The dtio calls for namelist require a CLASS object to be built.  */
 112 typedef struct gfc_class
 113 {
 114   void *data;
 115   void *vptr;
 116   index_type len;
 117 }
 118 gfc_class;
 119
 120
 121 /* A structure to build a hash table for format data.  */
 122
 123 #define FORMAT_HASH_SIZE 16
 124
 125 typedef struct format_hash_entry
 126 {
 127   char *key;
 128   gfc_charlen_type key_len;
 129   struct format_data *hashed_fmt;
 130 }
 131 format_hash_entry;
 132
 133 /* Representation of a namelist object in libgfortran
 134
 135    Namelist Records
 136       &GROUPNAME  OBJECT=value[s] [,OBJECT=value[s]].../
 137      or
 138       &GROUPNAME  OBJECT=value[s] [,OBJECT=value[s]]...&END
 139
 140    The object can be a fully qualified, compound name for an intrinsic
 141    type, derived types or derived type components.  So, a substring
 142    a(:)%b(4)%ch(2:4)(1:7) has to be treated correctly in namelist
 143    read. Hence full information about the structure of the object has
 144    to be available to list_read.c and write.
 145
 146    These requirements are met by the following data structures.
 147
 148    namelist_info type contains all the scalar information about the
 149    object and arrays of descriptor_dimension and array_loop_spec types for
 150    arrays.  */
 151
 152 typedef struct namelist_type
 153 {
 154   /* Object type.  */
 155   bt type;
 156
 157   /* Object name.  */
 158   char * var_name;
 159
 160   /* Address for the start of the object's data.  */
 161   void * mem_pos;
 162
 163   /* Address of specific DTIO subroutine.  */
 164   void * dtio_sub;
 165
 166   /* Address of vtable if dtio_sub non-null.  */
 167   void * vtable;
 168
 169   /* Flag to show that a read is to be attempted for this node.  */
 170   int touched;
 171
 172   /* Length of intrinsic type in bytes.  */
 173   int len;
 174
 175   /* Rank of the object.  */
 176   int var_rank;
 177
 178   /* Overall size of the object in bytes.  */
 179   index_type size;
 180
 181   /* Length of character string.  */
 182   index_type string_length;
 183
 184   descriptor_dimension * dim;
 185   array_loop_spec * ls;
 186   struct namelist_type * next;
 187 }
 188 namelist_info;
 189
 190 /* Options for the OPEN statement.  */
 191
 192 typedef enum
 193 { ACCESS_SEQUENTIAL, ACCESS_DIRECT, ACCESS_APPEND, ACCESS_STREAM,
 194   ACCESS_UNSPECIFIED
 195 }
 196 unit_access;
 197
 198 typedef enum
 199 { ACTION_READ, ACTION_WRITE, ACTION_READWRITE,
 200   ACTION_UNSPECIFIED
 201 }
 202 unit_action;
 203
 204 typedef enum
 205 { BLANK_NULL, BLANK_ZERO, BLANK_UNSPECIFIED }
 206 unit_blank;
 207
 208 typedef enum
 209 { DELIM_NONE, DELIM_APOSTROPHE, DELIM_QUOTE,
 210   DELIM_UNSPECIFIED
 211 }
 212 unit_delim;
 213
 214 typedef enum
 215 { FORM_FORMATTED, FORM_UNFORMATTED, FORM_UNSPECIFIED }
 216 unit_form;
 217
 218 typedef enum
 219 { POSITION_ASIS, POSITION_REWIND, POSITION_APPEND,
 220   POSITION_UNSPECIFIED
 221 }
 222 unit_position;
 223
 224 typedef enum
 225 { STATUS_UNKNOWN, STATUS_OLD, STATUS_NEW, STATUS_SCRATCH,
 226   STATUS_REPLACE, STATUS_UNSPECIFIED
 227 }
 228 unit_status;
 229
 230 typedef enum
 231 { PAD_YES, PAD_NO, PAD_UNSPECIFIED }
 232 unit_pad;
 233
 234 typedef enum
 235 { DECIMAL_POINT, DECIMAL_COMMA, DECIMAL_UNSPECIFIED }
 236 unit_decimal;
 237
 238 typedef enum
 239 { ENCODING_UTF8, ENCODING_DEFAULT, ENCODING_UNSPECIFIED }
 240 unit_encoding;
 241
 242 typedef enum
 243 { ROUND_UP = GFC_FPE_UPWARD,
 244   ROUND_DOWN = GFC_FPE_DOWNWARD,
 245   ROUND_ZERO = GFC_FPE_TOWARDZERO,
 246   ROUND_NEAREST = GFC_FPE_TONEAREST,
 247   ROUND_COMPATIBLE = 10, /* round away from zero.  */
 248   ROUND_PROCDEFINED, /* Here as ROUND_NEAREST. */
 249   ROUND_UNSPECIFIED /* Should never occur. */
 250 }
 251 unit_round;
 252
 253 /* NOTE: unit_sign must correspond with the sign_status enumerator in
 254    st_parameter_dt to not break the ABI.  */
 255 typedef enum
 256 { SIGN_PROCDEFINED, SIGN_SUPPRESS, SIGN_PLUS, SIGN_UNSPECIFIED }
 257 unit_sign;
 258
 259 typedef enum
 260 { ADVANCE_YES, ADVANCE_NO, ADVANCE_UNSPECIFIED }
 261 unit_advance;
 262
 263 typedef enum
 264 {READING, WRITING, LIST_READING, LIST_WRITING}
 265 unit_mode;
 266
 267 typedef enum
 268 { ASYNC_YES, ASYNC_NO, ASYNC_UNSPECIFIED }
 269 unit_async;
 270
 271 typedef enum
 272 { SIGN_S, SIGN_SS, SIGN_SP }
 273 unit_sign_s;
 274
 275 #define CHARACTER1(name) \
 276               char * name; \
 277               gfc_charlen_type name ## _len
 278 #define CHARACTER2(name) \
 279               gfc_charlen_type name ## _len; \
 280               char * name
 281
 282 typedef struct
 283 {
 284   st_parameter_common common;
 285   GFC_INTEGER_4 recl_in;
 286   CHARACTER2 (file);
 287   CHARACTER1 (status);
 288   CHARACTER2 (access);
 289   CHARACTER1 (form);
 290   CHARACTER2 (blank);
 291   CHARACTER1 (position);
 292   CHARACTER2 (action);
 293   CHARACTER1 (delim);
 294   CHARACTER2 (pad);
 295   CHARACTER1 (convert);
 296   CHARACTER2 (decimal);
 297   CHARACTER1 (encoding);
 298   CHARACTER2 (round);
 299   CHARACTER1 (sign);
 300   CHARACTER2 (asynchronous);
 301   GFC_INTEGER_4 *newunit;
 302 }
 303 st_parameter_open;
 304
 305 #define IOPARM_CLOSE_HAS_STATUS         (1 << 7)
 306
 307 typedef struct
 308 {
 309   st_parameter_common common;
 310   CHARACTER1 (status);
 311 }
 312 st_parameter_close;
 313
 314 typedef struct
 315 {
 316   st_parameter_common common;
 317 }
 318 st_parameter_filepos;
 319
 320 #define IOPARM_INQUIRE_HAS_EXIST        (1 << 7)
 321 #define IOPARM_INQUIRE_HAS_OPENED       (1 << 8)
 322 #define IOPARM_INQUIRE_HAS_NUMBER       (1 << 9)
 323 #define IOPARM_INQUIRE_HAS_NAMED        (1 << 10)
 324 #define IOPARM_INQUIRE_HAS_NEXTREC      (1 << 11)
 325 #define IOPARM_INQUIRE_HAS_RECL_OUT     (1 << 12)
 326 #define IOPARM_INQUIRE_HAS_STRM_POS_OUT (1 << 13)
 327 #define IOPARM_INQUIRE_HAS_FILE         (1 << 14)
 328 #define IOPARM_INQUIRE_HAS_ACCESS       (1 << 15)
 329 #define IOPARM_INQUIRE_HAS_FORM         (1 << 16)
 330 #define IOPARM_INQUIRE_HAS_BLANK        (1 << 17)
 331 #define IOPARM_INQUIRE_HAS_POSITION     (1 << 18)
 332 #define IOPARM_INQUIRE_HAS_ACTION       (1 << 19)
 333 #define IOPARM_INQUIRE_HAS_DELIM        (1 << 20)
 334 #define IOPARM_INQUIRE_HAS_PAD          (1 << 21)
 335 #define IOPARM_INQUIRE_HAS_NAME         (1 << 22)
 336 #define IOPARM_INQUIRE_HAS_SEQUENTIAL   (1 << 23)
 337 #define IOPARM_INQUIRE_HAS_DIRECT       (1 << 24)
 338 #define IOPARM_INQUIRE_HAS_FORMATTED    (1 << 25)
 339 #define IOPARM_INQUIRE_HAS_UNFORMATTED  (1 << 26)
 340 #define IOPARM_INQUIRE_HAS_READ         (1 << 27)
 341 #define IOPARM_INQUIRE_HAS_WRITE        (1 << 28)
 342 #define IOPARM_INQUIRE_HAS_READWRITE    (1 << 29)
 343 #define IOPARM_INQUIRE_HAS_CONVERT      (1 << 30)
 344 #define IOPARM_INQUIRE_HAS_FLAGS2       (1u << 31)
 345
 346 #define IOPARM_INQUIRE_HAS_ASYNCHRONOUS (1 << 0)
 347 #define IOPARM_INQUIRE_HAS_DECIMAL      (1 << 1)
 348 #define IOPARM_INQUIRE_HAS_ENCODING     (1 << 2)
 349 #define IOPARM_INQUIRE_HAS_ROUND        (1 << 3)
 350 #define IOPARM_INQUIRE_HAS_SIGN         (1 << 4)
 351 #define IOPARM_INQUIRE_HAS_PENDING      (1 << 5)
 352 #define IOPARM_INQUIRE_HAS_SIZE         (1 << 6)
 353 #define IOPARM_INQUIRE_HAS_ID           (1 << 7)
 354 #define IOPARM_INQUIRE_HAS_IQSTREAM     (1 << 8)
 355
 356 typedef struct
 357 {
 358   st_parameter_common common;
 359   GFC_INTEGER_4 *exist, *opened, *number, *named;
 360   GFC_INTEGER_4 *nextrec, *recl_out;
 361   GFC_IO_INT *strm_pos_out;
 362   CHARACTER1 (file);
 363   CHARACTER2 (access);
 364   CHARACTER1 (form);
 365   CHARACTER2 (blank);
 366   CHARACTER1 (position);
 367   CHARACTER2 (action);
 368   CHARACTER1 (delim);
 369   CHARACTER2 (pad);
 370   CHARACTER1 (name);
 371   CHARACTER2 (sequential);
 372   CHARACTER1 (direct);
 373   CHARACTER2 (formatted);
 374   CHARACTER1 (unformatted);
 375   CHARACTER2 (read);
 376   CHARACTER1 (write);
 377   CHARACTER2 (readwrite);
 378   CHARACTER1 (convert);
 379   GFC_INTEGER_4 flags2;
 380   CHARACTER1 (asynchronous);
 381   CHARACTER2 (decimal);
 382   CHARACTER1 (encoding);
 383   CHARACTER2 (round);
 384   CHARACTER1 (sign);
 385   GFC_INTEGER_4 *pending;
 386   GFC_IO_INT *size;
 387   GFC_INTEGER_4 *id;
 388   CHARACTER1 (iqstream);
 389 }
 390 st_parameter_inquire;
 391
 392
 393 #define IOPARM_DT_LIST_FORMAT                   (1 << 7)
 394 #define IOPARM_DT_NAMELIST_READ_MODE            (1 << 8)
 395 #define IOPARM_DT_HAS_REC                       (1 << 9)
 396 #define IOPARM_DT_HAS_SIZE                      (1 << 10)
 397 #define IOPARM_DT_HAS_IOLENGTH                  (1 << 11)
 398 #define IOPARM_DT_HAS_FORMAT                    (1 << 12)
 399 #define IOPARM_DT_HAS_ADVANCE                   (1 << 13)
 400 #define IOPARM_DT_HAS_INTERNAL_UNIT             (1 << 14)
 401 #define IOPARM_DT_HAS_NAMELIST_NAME             (1 << 15)
 402 #define IOPARM_DT_HAS_ID                        (1 << 16)
 403 #define IOPARM_DT_HAS_POS                       (1 << 17)
 404 #define IOPARM_DT_HAS_ASYNCHRONOUS              (1 << 18)
 405 #define IOPARM_DT_HAS_BLANK                     (1 << 19)
 406 #define IOPARM_DT_HAS_DECIMAL                   (1 << 20)
 407 #define IOPARM_DT_HAS_DELIM                     (1 << 21)
 408 #define IOPARM_DT_HAS_PAD                       (1 << 22)
 409 #define IOPARM_DT_HAS_ROUND                     (1 << 23)
 410 #define IOPARM_DT_HAS_SIGN                      (1 << 24)
 411 #define IOPARM_DT_HAS_F2003                     (1 << 25)
 412 #define IOPARM_DT_HAS_UDTIO                     (1 << 26)
 413 /* Internal use bit.  */
 414 #define IOPARM_DT_IONML_SET                     (1u << 31)
 415
 416
 417 typedef struct st_parameter_dt
 418 {
 419   st_parameter_common common;
 420   GFC_IO_INT rec;
 421   GFC_IO_INT *size, *iolength;
 422   gfc_array_char *internal_unit_desc;
 423   CHARACTER1 (format);
 424   CHARACTER2 (advance);
 425   CHARACTER1 (internal_unit);
 426   CHARACTER2 (namelist_name);
 427   /* Private part of the structure.  The compiler just needs
 428      to reserve enough space.  */
 429   union
 430     {
 431       struct
 432         {
 433           void (*transfer) (struct st_parameter_dt *, bt, void *, int,
 434                             size_t, size_t);
 435           struct gfc_unit *current_unit;
 436           /* Item number in a formatted data transfer.  Also used in namelist
 437              read_logical as an index into line_buffer.  */
 438           int item_count;
 439           unit_mode mode;
 440           unit_blank blank_status;
 441           unit_sign sign_status;
 442           int scale_factor;
 443           int max_pos; /* Maximum righthand column written to.  */
 444           /* Number of skips + spaces to be done for T and X-editing.  */
 445           int skips;
 446           /* Number of spaces to be done for T and X-editing.  */
 447           int pending_spaces;
 448           /* Whether an EOR condition was encountered. Value is:
 449                0 if no EOR was encountered
 450                1 if an EOR was encountered due to a 1-byte marker (LF)
 451                2 if an EOR was encountered due to a 2-bytes marker (CRLF) */
 452           int sf_seen_eor;
 453           unit_advance advance_status;
 454           unsigned reversion_flag : 1; /* Format reversion has occurred.  */
 455           unsigned first_item : 1;
 456           unsigned seen_dollar : 1;
 457           unsigned eor_condition : 1;
 458           unsigned no_leading_blank : 1;
 459           unsigned char_flag : 1;
 460           unsigned input_complete : 1;
 461           unsigned at_eol : 1;
 462           unsigned comma_flag : 1;
 463           /* A namelist specific flag used in the list directed library
 464              to flag that calls are being made from namelist read (e.g. to
 465              ignore comments or to treat '/' as a terminator)  */
 466           unsigned namelist_mode : 1;
 467           /* A namelist specific flag used in the list directed library
 468              to flag read errors and return, so that an attempt can be
 469              made to read a new object name.  */
 470           unsigned nml_read_error : 1;
 471           /* A sequential formatted read specific flag used to signal that a
 472              character string is being read so don't use commas to shorten a
 473              formatted field width.  */
 474           unsigned sf_read_comma : 1;
 475           /* A namelist specific flag used to enable reading input from
 476              line_buffer for logical reads.  */
 477           unsigned line_buffer_enabled : 1;
 478           /* An internal unit specific flag used to identify that the associated
 479              unit is internal.  */
 480           unsigned unit_is_internal : 1;
 481           /* An internal unit specific flag to signify an EOF condition for list
 482              directed read.  */
 483           unsigned at_eof : 1;
 484           /* Used for g0 floating point output.  */
 485           unsigned g0_no_blanks : 1;
 486           /* Used to signal use of free_format_data.  */
 487           unsigned format_not_saved : 1;
 488           /* A flag used to identify when a non-standard expanded namelist read
 489              has occurred.  */
 490           unsigned expanded_read : 1;
 491           /* 13 unused bits.  */
 492
 493           /* Used for ungetc() style functionality. Possible values
 494              are an unsigned char, EOF, or EOF - 1 used to mark the
 495              field as not valid.  */
 496           int last_char; /* No longer used, moved to gfc_unit.  */
 497           char nml_delim;
 498
 499           int repeat_count;
 500           int saved_length;
 501           int saved_used;
 502           bt saved_type;
 503           char *saved_string;
 504           char *scratch;
 505           char *line_buffer;
 506           struct format_data *fmt;
 507           namelist_info *ionml;
 508 #ifdef HAVE_NEWLOCALE
 509           locale_t old_locale;
 510 #endif
 511           /* Current position within the look-ahead line buffer.  */
 512           int line_buffer_pos;
 513           /* Storage area for values except for strings.  Must be
 514              large enough to hold a complex value (two reals) of the
 515              largest kind.  */
 516           char value[32];
 517           GFC_IO_INT size_used;
 518           formatted_dtio fdtio_ptr;
 519           unformatted_dtio ufdtio_ptr;
 520         } p;
 521       /* This pad size must be equal to the pad_size declared in
 522          trans-io.c (gfc_build_io_library_fndecls).  The above structure
 523          must be smaller or equal to this array.  */
 524       char pad[16 * sizeof (char *) + 32 * sizeof (int)];
 525     } u;
 526   GFC_INTEGER_4 *id;
 527   GFC_IO_INT pos;
 528   CHARACTER1 (asynchronous);
 529   CHARACTER2 (blank);
 530   CHARACTER1 (decimal);
 531   CHARACTER2 (delim);
 532   CHARACTER1 (pad);
 533   CHARACTER2 (round);
 534   CHARACTER1 (sign);
 535 }
 536 st_parameter_dt;
 537
 538 /* Ensure st_parameter_dt's u.pad is bigger or equal to u.p.  */
 539 extern char check_st_parameter_dt[sizeof (((st_parameter_dt *) 0)->u.pad)
 540                                   >= sizeof (((st_parameter_dt *) 0)->u.p)
 541                                   ? 1 : -1];
 542
 543 #define IOPARM_WAIT_HAS_ID              (1 << 7)
 544
 545 typedef struct
 546 {
 547   st_parameter_common common;
 548   CHARACTER1 (id);
 549 }
 550 st_parameter_wait;
 551
 552
 553 #undef CHARACTER1
 554 #undef CHARACTER2
 555
 556 typedef struct
 557 {
 558   unit_access access;
 559   unit_action action;
 560   unit_blank blank;
 561   unit_delim delim;
 562   unit_form form;
 563   int is_notpadded;
 564   unit_position position;
 565   unit_status status;
 566   unit_pad pad;
 567   unit_convert convert;
 568   int has_recl;
 569   unit_decimal decimal;
 570   unit_encoding encoding;
 571   unit_round round;
 572   unit_sign sign;
 573   unit_async async;
 574 }
 575 unit_flags;
 576
 577
 578 typedef struct gfc_unit
 579 {
 580   int unit_number;
 581   stream *s;
 582
 583   /* Treap links.  */
 584   struct gfc_unit *left, *right;
 585   int priority;
 586
 587   int read_bad, current_record, saved_pos, previous_nonadvancing_write;
 588
 589   enum
 590   { NO_ENDFILE, AT_ENDFILE, AFTER_ENDFILE }
 591   endfile;
 592
 593   unit_mode mode;
 594   unit_flags flags;
 595   unit_pad pad_status;
 596   unit_decimal decimal_status;
 597   unit_delim delim_status;
 598   unit_round round_status;
 599
 600   /* recl                 -- Record length of the file.
 601      last_record          -- Last record number read or written
 602      maxrec               -- Maximum record number in a direct access file
 603      bytes_left           -- Bytes left in current record.
 604      strm_pos             -- Current position in file for STREAM I/O.
 605      recl_subrecord       -- Maximum length for subrecord.
 606      bytes_left_subrecord -- Bytes left in current subrecord.  */
 607   gfc_offset recl, last_record, maxrec, bytes_left, strm_pos,
 608     recl_subrecord, bytes_left_subrecord;
 609
 610   /* Set to 1 if we have read a subrecord.  */
 611
 612   int continued;
 613
 614   __gthread_mutex_t lock;
 615   /* Number of threads waiting to acquire this unit's lock.
 616      When non-zero, close_unit doesn't only removes the unit
 617      from the UNIT_ROOT tree, but doesn't free it and the
 618      last of the waiting threads will do that.
 619      This must be either atomically increased/decreased, or
 620      always guarded by UNIT_LOCK.  */
 621   int waiting;
 622   /* Flag set by close_unit if the unit as been closed.
 623      Must be manipulated under unit's lock.  */
 624   int closed;
 625
 626   /* For traversing arrays */
 627   array_loop_spec *ls;
 628   int rank;
 629
 630   /* Name of the file at the time OPEN was executed, as a
 631      null-terminated C string.  */
 632   char *filename;
 633
 634   /* The format hash table.  */
 635   struct format_hash_entry format_hash_table[FORMAT_HASH_SIZE];
 636
 637   /* Formatting buffer.  */
 638   struct fbuf *fbuf;
 639
 640   /* Function pointer, points to list_read worker functions.  */
 641   int (*next_char_fn_ptr) (st_parameter_dt *);
 642   void (*push_char_fn_ptr) (st_parameter_dt *, int);
 643
 644   /* Internal unit char string data.  */
 645   char * internal_unit;
 646   gfc_charlen_type internal_unit_len;
 647   gfc_array_char *string_unit_desc;
 648   int internal_unit_kind;
 649
 650   /* DTIO Parent/Child procedure, 0 = parent, >0 = child level.  */
 651   int child_dtio;
 652   int last_char;
 653 }
 654 gfc_unit;
 655
 656 typedef struct gfc_saved_unit
 657 {
 658   GFC_INTEGER_4 unit_number;
 659   gfc_unit *unit;
 660 }
 661 gfc_saved_unit;
 662
 663 /* unit.c */
 664
 665 /* Maximum file offset, computed at library initialization time.  */
 666 extern gfc_offset max_offset;
 667 internal_proto(max_offset);
 668
 669 /* Unit tree root.  */
 670 extern gfc_unit *unit_root;
 671 internal_proto(unit_root);
 672
 673 extern __gthread_mutex_t unit_lock;
 674 internal_proto(unit_lock);
 675
 676 extern int close_unit (gfc_unit *);
 677 internal_proto(close_unit);
 678
 679 extern gfc_unit *set_internal_unit (st_parameter_dt *, gfc_unit *, int);
 680 internal_proto(set_internal_unit);
 681
 682 extern void stash_internal_unit (st_parameter_dt *);
 683 internal_proto(stash_internal_unit);
 684
 685 extern gfc_unit *find_unit (int);
 686 internal_proto(find_unit);
 687
 688 extern gfc_unit *find_or_create_unit (int);
 689 internal_proto(find_or_create_unit);
 690
 691 extern gfc_unit *get_unit (st_parameter_dt *, int);
 692 internal_proto(get_unit);
 693
 694 extern void unlock_unit (gfc_unit *);
 695 internal_proto(unlock_unit);
 696
 697 extern void finish_last_advance_record (gfc_unit *u);
 698 internal_proto (finish_last_advance_record);
 699
 700 extern int unit_truncate (gfc_unit *, gfc_offset, st_parameter_common *);
 701 internal_proto (unit_truncate);
 702
 703 extern GFC_INTEGER_4 get_unique_unit_number (st_parameter_common *);
 704 internal_proto(get_unique_unit_number);
 705
 706 /* open.c */
 707
 708 extern gfc_unit *new_unit (st_parameter_open *, gfc_unit *, unit_flags *);
 709 internal_proto(new_unit);
 710
 711
 712 /* transfer.c */
 713
 714 #define SCRATCH_SIZE 300
 715
 716 extern const char *type_name (bt);
 717 internal_proto(type_name);
 718
 719 extern void * read_block_form (st_parameter_dt *, int *);
 720 internal_proto(read_block_form);
 721
 722 extern void * read_block_form4 (st_parameter_dt *, int *);
 723 internal_proto(read_block_form4);
 724
 725 extern void *write_block (st_parameter_dt *, int);
 726 internal_proto(write_block);
 727
 728 extern gfc_offset next_array_record (st_parameter_dt *, array_loop_spec *,
 729                                      int*);
 730 internal_proto(next_array_record);
 731
 732 extern gfc_offset init_loop_spec (gfc_array_char *, array_loop_spec *,
 733                                   gfc_offset *);
 734 internal_proto(init_loop_spec);
 735
 736 extern void next_record (st_parameter_dt *, int);
 737 internal_proto(next_record);
 738
 739 extern void st_wait (st_parameter_wait *);
 740 export_proto(st_wait);
 741
 742 extern void hit_eof (st_parameter_dt *);
 743 internal_proto(hit_eof);
 744
 745 /* read.c */
 746
 747 extern void set_integer (void *, GFC_INTEGER_LARGEST, int);
 748 internal_proto(set_integer);
 749
 750 extern GFC_UINTEGER_LARGEST si_max (int);
 751 internal_proto(si_max);
 752
 753 extern int convert_real (st_parameter_dt *, void *, const char *, int);
 754 internal_proto(convert_real);
 755
 756 extern int convert_infnan (st_parameter_dt *, void *, const char *, int);
 757 internal_proto(convert_infnan);
 758
 759 extern void read_a (st_parameter_dt *, const fnode *, char *, int);
 760 internal_proto(read_a);
 761
 762 extern void read_a_char4 (st_parameter_dt *, const fnode *, char *, int);
 763 internal_proto(read_a);
 764
 765 extern void read_f (st_parameter_dt *, const fnode *, char *, int);
 766 internal_proto(read_f);
 767
 768 extern void read_l (st_parameter_dt *, const fnode *, char *, int);
 769 internal_proto(read_l);
 770
 771 extern void read_x (st_parameter_dt *, int);
 772 internal_proto(read_x);
 773
 774 extern void read_radix (st_parameter_dt *, const fnode *, char *, int, int);
 775 internal_proto(read_radix);
 776
 777 extern void read_decimal (st_parameter_dt *, const fnode *, char *, int);
 778 internal_proto(read_decimal);
 779
 780 extern void read_user_defined (st_parameter_dt *, void *);
 781 internal_proto(read_user_defined);
 782
 783 extern void read_user_defined (st_parameter_dt *, void *);
 784 internal_proto(read_user_defined);
 785
 786 /* list_read.c */
 787
 788 extern void list_formatted_read (st_parameter_dt *, bt, void *, int, size_t,
 789                                  size_t);
 790 internal_proto(list_formatted_read);
 791
 792 extern void finish_list_read (st_parameter_dt *);
 793 internal_proto(finish_list_read);
 794
 795 extern void namelist_read (st_parameter_dt *);
 796 internal_proto(namelist_read);
 797
 798 extern void namelist_write (st_parameter_dt *);
 799 internal_proto(namelist_write);
 800
 801 /* write.c */
 802
 803 extern void write_a (st_parameter_dt *, const fnode *, const char *, int);
 804 internal_proto(write_a);
 805
 806 extern void write_a_char4 (st_parameter_dt *, const fnode *, const char *, int);
 807 internal_proto(write_a_char4);
 808
 809 extern void write_b (st_parameter_dt *, const fnode *, const char *, int);
 810 internal_proto(write_b);
 811
 812 extern void write_d (st_parameter_dt *, const fnode *, const char *, int);
 813 internal_proto(write_d);
 814
 815 extern void write_e (st_parameter_dt *, const fnode *, const char *, int);
 816 internal_proto(write_e);
 817
 818 extern void write_en (st_parameter_dt *, const fnode *, const char *, int);
 819 internal_proto(write_en);
 820
 821 extern void write_es (st_parameter_dt *, const fnode *, const char *, int);
 822 internal_proto(write_es);
 823
 824 extern void write_f (st_parameter_dt *, const fnode *, const char *, int);
 825 internal_proto(write_f);
 826
 827 extern void write_i (st_parameter_dt *, const fnode *, const char *, int);
 828 internal_proto(write_i);
 829
 830 extern void write_l (st_parameter_dt *, const fnode *, char *, int);
 831 internal_proto(write_l);
 832
 833 extern void write_o (st_parameter_dt *, const fnode *, const char *, int);
 834 internal_proto(write_o);
 835
 836 extern void write_real (st_parameter_dt *, const char *, int);
 837 internal_proto(write_real);
 838
 839 extern void write_real_g0 (st_parameter_dt *, const char *, int, int);
 840 internal_proto(write_real_g0);
 841
 842 extern void write_x (st_parameter_dt *, int, int);
 843 internal_proto(write_x);
 844
 845 extern void write_z (st_parameter_dt *, const fnode *, const char *, int);
 846 internal_proto(write_z);
 847
 848 extern void write_user_defined (st_parameter_dt *, void *);
 849 internal_proto(write_user_defined);
 850
 851 extern void write_user_defined (st_parameter_dt *, void *);
 852 internal_proto(write_user_defined);
 853
 854 extern void list_formatted_write (st_parameter_dt *, bt, void *, int, size_t,
 855                                   size_t);
 856 internal_proto(list_formatted_write);
 857
 858 /* size_from_kind.c */
 859 extern size_t size_from_real_kind (int);
 860 internal_proto(size_from_real_kind);
 861
 862 extern size_t size_from_complex_kind (int);
 863 internal_proto(size_from_complex_kind);
 864
 865
 866 /* lock.c */
 867 extern void free_ionml (st_parameter_dt *);
 868 internal_proto(free_ionml);
 869
 870 static inline void
 871 inc_waiting_locked (gfc_unit *u)
 872 {
 873 #ifdef HAVE_SYNC_FETCH_AND_ADD
 874   (void) __sync_fetch_and_add (&u->waiting, 1);
 875 #else
 876   u->waiting++;
 877 #endif
 878 }
 879
 880 static inline int
 881 predec_waiting_locked (gfc_unit *u)
 882 {
 883 #ifdef HAVE_SYNC_FETCH_AND_ADD
 884   return __sync_add_and_fetch (&u->waiting, -1);
 885 #else
 886   return --u->waiting;
 887 #endif
 888 }
 889
 890 static inline void
 891 dec_waiting_unlocked (gfc_unit *u)
 892 {
 893 #ifdef HAVE_SYNC_FETCH_AND_ADD
 894   (void) __sync_fetch_and_add (&u->waiting, -1);
 895 #else
 896   __gthread_mutex_lock (&unit_lock);
 897   u->waiting--;
 898   __gthread_mutex_unlock (&unit_lock);
 899 #endif
 900 }
 901
 902
 903 static inline void
 904 memset4 (gfc_char4_t *p, gfc_char4_t c, int k)
 905 {
 906   int j;
 907   for (j = 0; j < k; j++)
 908     *p++ = c;
 909 }
 910
 911 #endif
 912