libgfortran/caf/libcaf.h

   1 /* Common declarations for all of GNU Fortran libcaf implementations.
   2    Copyright (C) 2011-2013 Free Software Foundation, Inc.
   3    Contributed by Tobias Burnus <burnus@net-b.de>
   4
   5 This file is part of the GNU Fortran Coarray Runtime Library (libcaf).
   6
   7 Libcaf 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 Libcaf 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 LIBCAF_H
  27 #define LIBCAF_H
  28
  29 #include <stdint.h>     /* For int32_t.  */
  30 #include <stddef.h>     /* For ptrdiff_t.  */
  31
  32 #ifndef __GNUC__
  33 #define __attribute__(x)
  34 #define likely(x)       (x)
  35 #define unlikely(x)     (x)
  36 #else
  37 #define likely(x)       __builtin_expect(!!(x), 1)
  38 #define unlikely(x)     __builtin_expect(!!(x), 0)
  39 #endif
  40
  41 /* Definitions of the Fortran 2008 standard; need to kept in sync with
  42    ISO_FORTRAN_ENV, cf. libgfortran.h.  */
  43 #define STAT_UNLOCKED           0
  44 #define STAT_LOCKED             1
  45 #define STAT_LOCKED_OTHER_IMAGE 2
  46 #define STAT_STOPPED_IMAGE      6000
  47
  48 /* Describes what type of array we are registerring. Keep in sync with
  49    gcc/fortran/trans.h.  */
  50 typedef enum caf_register_t {
  51   CAF_REGTYPE_COARRAY_STATIC,
  52   CAF_REGTYPE_COARRAY_ALLOC,
  53   CAF_REGTYPE_LOCK,
  54   CAF_REGTYPE_LOCK_COMP
  55 }
  56 caf_register_t;
  57
  58 /* Linked list of static coarrays registered.  */
  59 typedef struct caf_static_t {
  60   void **token;
  61   struct caf_static_t *prev;
  62 }
  63 caf_static_t;
  64
  65
  66 void _gfortran_caf_init (int *, char ***, int *, int *);
  67 void _gfortran_caf_finalize (void);
  68
  69 void * _gfortran_caf_register (ptrdiff_t, caf_register_t, void ***, int *,
  70                                char *, int);
  71 void _gfortran_caf_deregister (void ***, int *, char *, int);
  72
  73
  74 void _gfortran_caf_sync_all (int *, char *, int);
  75 void _gfortran_caf_sync_images (int, int[], int *, char *, int);
  76
  77 /* FIXME: The CRITICAL functions should be removed;
  78    the functionality is better represented using Coarray's lock feature.  */
  79 void _gfortran_caf_critical (void)  { }
  80 void _gfortran_caf_end_critical (void)  { }
  81
  82
  83 void _gfortran_caf_error_stop_str (const char *, int32_t)
  84      __attribute__ ((noreturn));
  85 void _gfortran_caf_error_stop (int32_t) __attribute__ ((noreturn));
  86
  87 #endif  /* LIBCAF_H  */