/*
 * Copyright (c) 1997, 2010, Oracle and/or its affiliates. All rights reserved.
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
 *
 * This code is free software; you can redistribute it and/or modify it
 * under the terms of the GNU General Public License version 2 only, as
 * published by the Free Software Foundation.
 *
 * This code is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
 * version 2 for more details (a copy is included in the LICENSE file that
 * accompanied this code).
 *
 * You should have received a copy of the GNU General Public License version
 * 2 along with this work; if not, write to the Free Software Foundation,
 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
 *
 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
 * or visit www.oracle.com if you need additional information or have any
 * questions.
 *
 */


#ifndef __DECODER_HPP
#define __DECODER_HPP

#include "memory/allocation.hpp"
#include "runtime/mutex.hpp"

class Decoder: public CHeapObj {

public:
  // status code for decoding native C frame
  enum decoder_status {
         not_available = -10,  // real decoder is not available
         no_error = 0,         // successfully decoded frames
         out_of_memory,        // out of memory
         file_invalid,         // invalid elf file
         file_not_found,       // could not found symbol file (on windows), such as jvm.pdb or jvm.map
         helper_not_found,     // could not load dbghelp.dll (Windows only)
         helper_func_error,    // decoding functions not found (Windows only)
         helper_init_error     // SymInitialize failed (Windows only)
  };

   static bool decode(address pc, char* buf, int buflen, int* offset, const char* modulepath = NULL);
   static bool demangle(const char* symbol, char* buf, int buflen);
   static bool can_decode_C_frame_in_vm();

   static bool is_error(decoder_status status) { return (status > 0); }
   static decoder_status status();

   static void shutdown();
protected:
  Decoder() {
    _decoder_status = not_available;
  };

  ~Decoder() {};

  static Decoder* get_decoder();

  virtual bool _decode(address pc, char* buf, int buflen, int* offset, 
    const char* modulepath = NULL) {
    return false;
  }

  virtual bool _demangle(const char* symbol, char* buf, int buflen) {
    return false;
  }

  virtual bool _can_decode_C_frame_in_vm() const { 
    return false; 
  }

  virtual decoder_status _status() const { return _decoder_status; }
  virtual bool has_error() const { return is_error(_decoder_status); }
 
private:
  static Decoder*     _decoder;
  static Decoder      _do_nothing_decoder;

protected:
  static Mutex*       _decoder_lock;

  decoder_status      _decoder_status;
};

#endif // __DECODER_HPP