1 /*
   2  * Copyright (c) 1999, 2019, Oracle and/or its affiliates. All rights reserved.
   3  * Copyright (c) 2013, 2016 SAP SE. All rights reserved.
   4  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   5  *
   6  * This code is free software; you can redistribute it and/or modify it
   7  * under the terms of the GNU General Public License version 2 only, as
   8  * published by the Free Software Foundation.
   9  *
  10  * This code is distributed in the hope that it will be useful, but WITHOUT
  11  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  12  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  13  * version 2 for more details (a copy is included in the LICENSE file that
  14  * accompanied this code).
  15  *
  16  * You should have received a copy of the GNU General Public License version
  17  * 2 along with this work; if not, write to the Free Software Foundation,
  18  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  19  *
  20  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  21  * or visit www.oracle.com if you need additional information or have any
  22  * questions.
  23  *
  24  */
  25 
  26 #ifndef OS_AIX_OS_AIX_HPP
  27 #define OS_AIX_OS_AIX_HPP
  28 
  29 // Information about the protection of the page at address '0' on this os.
  30 static bool zero_page_read_protected() { return false; }
  31 
  32 // Class Aix defines the interface to the Aix operating systems.
  33 
  34 class Aix {
  35   friend class os;
  36 
  37   static bool libjsig_is_loaded;        // libjsig that interposes sigaction(),
  38                                         // __sigaction(), signal() is loaded
  39   static struct sigaction *(*get_signal_action)(int);
  40   static struct sigaction *get_preinstalled_handler(int);
  41   static void save_preinstalled_handler(int, struct sigaction&);
  42 
  43   static void check_signal_handler(int sig);
  44 
  45  private:
  46 
  47   static julong _physical_memory;
  48   static pthread_t _main_thread;
  49   static Mutex* _createThread_lock;
  50   static int _page_size;
  51 
  52   // -1 = uninitialized, 0 = AIX, 1 = OS/400 (PASE)
  53   static int _on_pase;
  54 
  55   // 0 = uninitialized, otherwise 16 bit number:
  56   //  lower 8 bit - minor version
  57   //  higher 8 bit - major version
  58   //  For AIX, e.g. 0x0601 for AIX 6.1
  59   //  for OS/400 e.g. 0x0504 for OS/400 V5R4
  60   static uint32_t _os_version;
  61 
  62   // -1 = uninitialized,
  63   //  0 - SPEC1170 not requested (XPG_SUS_ENV is OFF or not set)
  64   //  1 - SPEC1170 requested (XPG_SUS_ENV is ON)
  65   static int _xpg_sus_mode;
  66 
  67   // -1 = uninitialized,
  68   //  0 - EXTSHM=OFF or not set
  69   //  1 - EXTSHM=ON
  70   static int _extshm;
  71 
  72   static julong available_memory();
  73   static julong physical_memory() { return _physical_memory; }
  74   static void initialize_system_info();
  75 
  76   // OS recognitions (PASE/AIX, OS level) call this before calling any
  77   // one of Aix::on_pase(), Aix::os_version().
  78   static void initialize_os_info();
  79 
  80   // Scan environment for important settings which might effect the
  81   // VM. Trace out settings. Warn about invalid settings and/or
  82   // correct them.
  83   //
  84   // Must run after os::Aix::initialue_os_info().
  85   static void scan_environment();
  86 
  87   // Initialize libo4 (on PASE) and libperfstat (on AIX). Call this
  88   // before relying on functions from either lib, e.g. Aix::get_meminfo().
  89   static void initialize_libo4();
  90   static void initialize_libperfstat();
  91 
  92  public:
  93   static void init_thread_fpu_state();
  94   static pthread_t main_thread(void)                                { return _main_thread; }
  95   static void set_createThread_lock(Mutex* lk)                      { _createThread_lock = lk; }
  96   static Mutex* createThread_lock(void)                             { return _createThread_lock; }
  97   static void hotspot_sigmask(Thread* thread);
  98 
  99   // Given an address, returns the size of the page backing that address
 100   static size_t query_pagesize(void* p);
 101 
 102   static int page_size(void) {
 103     assert(_page_size != -1, "not initialized");
 104     return _page_size;
 105   }
 106 
 107   static address   ucontext_get_pc(const ucontext_t* uc);
 108   static intptr_t* ucontext_get_sp(const ucontext_t* uc);
 109   static intptr_t* ucontext_get_fp(const ucontext_t* uc);
 110   // Set PC into context. Needed for continuation after signal.
 111   static void ucontext_set_pc(ucontext_t* uc, address pc);
 112 
 113   static bool get_frame_at_stack_banging_point(JavaThread* thread, ucontext_t* uc, frame* fr);
 114 
 115   // This boolean allows users to forward their own non-matching signals
 116   // to JVM_handle_aix_signal, harmlessly.
 117   static bool signal_handlers_are_installed;
 118 
 119   static int get_our_sigflags(int);
 120   static void set_our_sigflags(int, int);
 121   static void signal_sets_init();
 122   static void install_signal_handlers();
 123   static void set_signal_handler(int, bool);
 124 
 125   static sigset_t* unblocked_signals();
 126   static sigset_t* vm_signals();
 127 
 128   // For signal-chaining
 129   static struct sigaction *get_chained_signal_action(int sig);
 130   static bool chained_handler(int sig, siginfo_t* siginfo, void* context);
 131 
 132   // libpthread version string
 133   static void libpthread_init();
 134 
 135   // Function returns true if we run on OS/400 (pase), false if we run
 136   // on AIX.
 137   static bool on_pase() {
 138     assert(_on_pase != -1, "not initialized");
 139     return _on_pase ? true : false;
 140   }
 141 
 142   // Function returns true if we run on AIX, false if we run on OS/400
 143   // (pase).
 144   static bool on_aix() {
 145     assert(_on_pase != -1, "not initialized");
 146     return _on_pase ? false : true;
 147   }
 148 
 149   // Get 4 byte AIX kernel version number:
 150   // highest 2 bytes: Version, Release
 151   // if available: lowest 2 bytes: Tech Level, Service Pack.
 152   static uint32_t os_version() {
 153     assert(_os_version != 0, "not initialized");
 154     return _os_version;
 155   }
 156 
 157   // 0 = uninitialized, otherwise 16 bit number:
 158   // lower 8 bit - minor version
 159   // higher 8 bit - major version
 160   // For AIX, e.g. 0x0601 for AIX 6.1
 161   // for OS/400 e.g. 0x0504 for OS/400 V5R4
 162   static int os_version_short() {
 163     return os_version() >> 16;
 164   }
 165 
 166   // Convenience method: returns true if running on PASE V5R4 or older.
 167   static bool on_pase_V5R4_or_older() {
 168     return on_pase() && os_version_short() <= 0x0504;
 169   }
 170 
 171   // Convenience method: returns true if running on AIX 5.3 or older.
 172   static bool on_aix_53_or_older() {
 173     return on_aix() && os_version_short() <= 0x0503;
 174   }
 175 
 176   // Returns true if we run in SPEC1170 compliant mode (XPG_SUS_ENV=ON).
 177   static bool xpg_sus_mode() {
 178     assert(_xpg_sus_mode != -1, "not initialized");
 179     return _xpg_sus_mode;
 180   }
 181 
 182   // Returns true if EXTSHM=ON.
 183   static bool extshm() {
 184     assert(_extshm != -1, "not initialized");
 185     return _extshm;
 186   }
 187 
 188   // result struct for get_meminfo()
 189   struct meminfo_t {
 190 
 191     // Amount of virtual memory (in units of 4 KB pages)
 192     unsigned long long virt_total;
 193 
 194     // Amount of real memory, in bytes
 195     unsigned long long real_total;
 196 
 197     // Amount of free real memory, in bytes
 198     unsigned long long real_free;
 199 
 200     // Total amount of paging space, in bytes
 201     unsigned long long pgsp_total;
 202 
 203     // Amount of free paging space, in bytes
 204     unsigned long long pgsp_free;
 205 
 206   };
 207 
 208   // Functions to retrieve memory information on AIX, PASE.
 209   // (on AIX, using libperfstat, on PASE with libo4.so).
 210   // Returns true if ok, false if error.
 211   static bool get_meminfo(meminfo_t* pmi);
 212 
 213 };
 214 
 215 #endif // OS_AIX_OS_AIX_HPP