1 /*
   2  * Copyright 2000-2008 Sun Microsystems, Inc.  All Rights Reserved.
   3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   4  *
   5  * This code is free software; you can redistribute it and/or modify it
   6  * under the terms of the GNU General Public License version 2 only, as
   7  * published by the Free Software Foundation.
   8  *
   9  * This code is distributed in the hope that it will be useful, but WITHOUT
  10  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  11  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  12  * version 2 for more details (a copy is included in the LICENSE file that
  13  * accompanied this code).
  14  *
  15  * You should have received a copy of the GNU General Public License version
  16  * 2 along with this work; if not, write to the Free Software Foundation,
  17  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  18  *
  19  * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
  20  * CA 95054 USA or visit www.sun.com if you need additional information or
  21  * have any questions.
  22  *  
  23  */
  24 
  25 package sun.jvm.hotspot.debugger;
  26 
  27 import java.io.Serializable;
  28 
  29 /** Encapsulates machine-specific information that currently must be
  30     exported up to the Java level. Implementations must be
  31     serializable. */
  32 
  33 public interface MachineDescription extends Serializable {
  34   /** Returns the size of an address in bytes. Currently needed to be
  35       able to traverse arrays of pointers or oops. */
  36   public long getAddressSize();
  37 
  38   /** Returns the maximum value of the C integer type with the given
  39       size in bytes and signedness. Throws IllegalArgumentException if
  40       the size in bytes is not legal for a C type (or can not be
  41       handled by this system). Note that the current implementation
  42       does not currently handle unsigned 8-byte longs properly. */
  43   public long cIntegerTypeMaxValue(long sizeInBytes, boolean isUnsigned);
  44 
  45   /** Returns the minimum value of the C integer type with the given
  46       size in bytes and signedness. Throws IllegalArgumentException if
  47       the size in bytes is not legal for a C type (or can not be
  48       handled by this system). */
  49   public long cIntegerTypeMinValue(long sizeInBytes, boolean isUnsigned);
  50 
  51   /** Indicates whether the CPU is big- or little-endian. This
  52       information is typically only needed by the Debugger
  53       implementation. */
  54   public boolean isBigEndian();
  55 
  56   /** Indicates whether the underlying machine supports the LP64 data
  57       model (currently only SPARC/64). */
  58   public boolean isLP64();
  59 }