1003 lines · 39.4 KB · Java
RawDownload
     *     * <p>This method determines a block's base address by means of two parameters,     * and so it provides (in effect) a <em>double-register</em> addressing mode,     * as discussed in {@link #getInt(Object,long)}.  When the object reference is null,     * the offset supplies an absolute base address.     *     * <p>The stores are in coherent (atomic) units of a size determined     * by the address and length parameters.  If the effective address and     * length are all even modulo 8, the stores take place in 'long' units.     * If the effective address and length are (resp.) even modulo 4 or 2,     * the stores take place in units of 'int' or 'short'.     *     * @since 1.7     */    public native void setMemory(Object o, long offset, long bytes, byte value);     /**     * Sets all bytes in a given block of memory to a fixed value     * (usually zero).  This provides a <em>single-register</em> addressing mode,     * as discussed in {@link #getInt(Object,long)}.     *     * <p>Equivalent to <code>setMemory(null, address, bytes, value)</code>.     */    public void setMemory(long address, long bytes, byte value) {        setMemory(null, address, bytes, value);    }     /**     * Sets all bytes in a given block of memory to a copy of another     * block.     *     * <p>This method determines each block's base address by means of two parameters,     * and so it provides (in effect) a <em>double-register</em> addressing mode,     * as discussed in {@link #getInt(Object,long)}.  When the object reference is null,     * the offset supplies an absolute base address.     *     * <p>The transfers are in coherent (atomic) units of a size determined     * by the address and length parameters.  If the effective addresses and     * length are all even modulo 8, the transfer takes place in 'long' units.     * If the effective addresses and length are (resp.) even modulo 4 or 2,     * the transfer takes place in units of 'int' or 'short'.     *     * @since 1.7     */    public native void copyMemory(Object srcBase, long srcOffset,                                  Object destBase, long destOffset,                                  long bytes);    /**     * Sets all bytes in a given block of memory to a copy of another     * block.  This provides a <em>single-register</em> addressing mode,     * as discussed in {@link #getInt(Object,long)}.     *     * Equivalent to <code>copyMemory(null, srcAddress, null, destAddress, bytes)</code>.     */    public void copyMemory(long srcAddress, long destAddress, long bytes) {        copyMemory(null, srcAddress, null, destAddress, bytes);    }     /**     * Disposes of a block of native memory, as obtained from {@link     * #allocateMemory} or {@link #reallocateMemory}.  The address passed to     * this method may be null, in which case no action is taken.     *     * @see #allocateMemory     */    public native void freeMemory(long address);     /// random queries     /**     * This constant differs from all results that will ever be returned from     * {@link #staticFieldOffset}, {@link #objectFieldOffset},     * or {@link #arrayBaseOffset}.     */    public static final int INVALID_FIELD_OFFSET   = -1;     /**     * Returns the offset of a field, truncated to 32 bits.     * This method is implemented as follows:     * <blockquote><pre>     * public int fieldOffset(Field f) {     *     if (Modifier.isStatic(f.getModifiers()))     *         return (int) staticFieldOffset(f);     *     else     *         return (int) objectFieldOffset(f);     * }     * </pre></blockquote>     * @deprecated As of 1.4.1, use {@link #staticFieldOffset} for static     * fields and {@link #objectFieldOffset} for non-static fields.     */    @Deprecated    public int fieldOffset(Field f) {        if (Modifier.isStatic(f.getModifiers()))            return (int) staticFieldOffset(f);        else            return (int) objectFieldOffset(f);    }     /**     * Returns the base address for accessing some static field     * in the given class.  This method is implemented as follows:     * <blockquote><pre>     * public Object staticFieldBase(Class c) {     *     Field[] fields = c.getDeclaredFields();     *     for (int i = 0; i < fields.length; i++) {     *         if (Modifier.isStatic(fields[i].getModifiers())) {     *             return staticFieldBase(fields[i]);     *         }     *     }     *     return null;     * }     * </pre></blockquote>     * @deprecated As of 1.4.1, use {@link #staticFieldBase(Field)}     * to obtain the base pertaining to a specific {@link Field}.     * This method works only for JVMs which store all statics     * for a given class in one place.     */    @Deprecated    public Object staticFieldBase(Class c) {        Field[] fields = c.getDeclaredFields();        for (int i = 0; i < fields.length; i++) {            if (Modifier.isStatic(fields[i].getModifiers())) {                return staticFieldBase(fields[i]);            }        }        return null;    }     /**     * Report the location of a given field in the storage allocation of its     * class.  Do not expect to perform any sort of arithmetic on this offset;     * it is just a cookie which is passed to the unsafe heap memory accessors.     *     * <p>Any given field will always have the same offset and base, and no     * two distinct fields of the same class will ever have the same offset     * and base.     *     * <p>As of 1.4.1, offsets for fields are represented as long values,     * although the Sun JVM does not use the most significant 32 bits.     * However, JVM implementations which store static fields at absolute     * addresses can use long offsets and null base pointers to express     * the field locations in a form usable by {@link #getInt(Object,long)}.     * Therefore, code which will be ported to such JVMs on 64-bit platforms     * must preserve all bits of static field offsets.     * @see #getInt(Object, long)     */    public native long staticFieldOffset(Field f);     /**     * Report the location of a given static field, in conjunction with {@link     * #staticFieldBase}.     * <p>Do not expect to perform any sort of arithmetic on this offset;     * it is just a cookie which is passed to the unsafe heap memory accessors.     *     * <p>Any given field will always have the same offset, and no two distinct     * fields of the same class will ever have the same offset.     *     * <p>As of 1.4.1, offsets for fields are represented as long values,     * although the Sun JVM does not use the most significant 32 bits.     * It is hard to imagine a JVM technology which needs more than     * a few bits to encode an offset within a non-array object,     * However, for consistency with other methods in this class,     * this method reports its result as a long value.     * @see #getInt(Object, long)     */    public native long objectFieldOffset(Field f);     /**     * Report the location of a given static field, in conjunction with {@link     * #staticFieldOffset}.     * <p>Fetch the base "Object", if any, with which static fields of the     * given class can be accessed via methods like {@link #getInt(Object,     * long)}.  This value may be null.  This value may refer to an object     * which is a "cookie", not guaranteed to be a real Object, and it should     * not be used in any way except as argument to the get and put routines in     * this class.     */    public native Object staticFieldBase(Field f);     /**     * Ensure the given class has been initialized. This is often     * needed in conjunction with obtaining the static field base of a     * class.     */    public native void ensureClassInitialized(Class c);     /**     * Report the offset of the first element in the storage allocation of a     * given array class.  If {@link #arrayIndexScale} returns a non-zero value     * for the same class, you may use that scale factor, together with this     * base offset, to form new offsets to access elements of arrays of the     * given class.     *     * @see #getInt(Object, long)     * @see #putInt(Object, long, int)     */    public native int arrayBaseOffset(Class arrayClass);     /** The value of {@code arrayBaseOffset(boolean[].class)} */    public static final int ARRAY_BOOLEAN_BASE_OFFSET            = theUnsafe.arrayBaseOffset(boolean[].class);     /** The value of {@code arrayBaseOffset(byte[].class)} */    public static final int ARRAY_BYTE_BASE_OFFSET            = theUnsafe.arrayBaseOffset(byte[].class);     /** The value of {@code arrayBaseOffset(short[].class)} */    public static final int ARRAY_SHORT_BASE_OFFSET            = theUnsafe.arrayBaseOffset(short[].class);     /** The value of {@code arrayBaseOffset(char[].class)} */    public static final int ARRAY_CHAR_BASE_OFFSET            = theUnsafe.arrayBaseOffset(char[].class);     /** The value of {@code arrayBaseOffset(int[].class)} */    public static final int ARRAY_INT_BASE_OFFSET            = theUnsafe.arrayBaseOffset(int[].class);     /** The value of {@code arrayBaseOffset(long[].class)} */    public static final int ARRAY_LONG_BASE_OFFSET            = theUnsafe.arrayBaseOffset(long[].class);     /** The value of {@code arrayBaseOffset(float[].class)} */    public static final int ARRAY_FLOAT_BASE_OFFSET            = theUnsafe.arrayBaseOffset(float[].class);     /** The value of {@code arrayBaseOffset(double[].class)} */    public static final int ARRAY_DOUBLE_BASE_OFFSET            = theUnsafe.arrayBaseOffset(double[].class);     /** The value of {@code arrayBaseOffset(Object[].class)} */    public static final int ARRAY_OBJECT_BASE_OFFSET            = theUnsafe.arrayBaseOffset(Object[].class);     /**     * Report the scale factor for addressing elements in the storage     * allocation of a given array class.  However, arrays of "narrow" types     * will generally not work properly with accessors like {@link     * #getByte(Object, int)}, so the scale factor for such classes is reported     * as zero.     *     * @see #arrayBaseOffset     * @see #getInt(Object, long)     * @see #putInt(Object, long, int)     */    public native int arrayIndexScale(Class arrayClass);     /** The value of {@code arrayIndexScale(boolean[].class)} */    public static final int ARRAY_BOOLEAN_INDEX_SCALE            = theUnsafe.arrayIndexScale(boolean[].class);     /** The value of {@code arrayIndexScale(byte[].class)} */    public static final int ARRAY_BYTE_INDEX_SCALE            = theUnsafe.arrayIndexScale(byte[].class);     /** The value of {@code arrayIndexScale(short[].class)} */    public static final int ARRAY_SHORT_INDEX_SCALE            = theUnsafe.arrayIndexScale(short[].class);     /** The value of {@code arrayIndexScale(char[].class)} */    public static final int ARRAY_CHAR_INDEX_SCALE            = theUnsafe.arrayIndexScale(char[].class);     /** The value of {@code arrayIndexScale(int[].class)} */    public static final int ARRAY_INT_INDEX_SCALE            = theUnsafe.arrayIndexScale(int[].class);     /** The value of {@code arrayIndexScale(long[].class)} */    public static final int ARRAY_LONG_INDEX_SCALE            = theUnsafe.arrayIndexScale(long[].class);     /** The value of {@code arrayIndexScale(float[].class)} */    public static final int ARRAY_FLOAT_INDEX_SCALE            = theUnsafe.arrayIndexScale(float[].class);     /** The value of {@code arrayIndexScale(double[].class)} */    public static final int ARRAY_DOUBLE_INDEX_SCALE            = theUnsafe.arrayIndexScale(double[].class);     /** The value of {@code arrayIndexScale(Object[].class)} */    public static final int ARRAY_OBJECT_INDEX_SCALE            = theUnsafe.arrayIndexScale(Object[].class);     /**     * Report the size in bytes of a native pointer, as stored via {@link     * #putAddress}.  This value will be either 4 or 8.  Note that the sizes of     * other primitive types (as stored in native memory blocks) is determined     * fully by their information content.     */    public native int addressSize();     /** The value of {@code addressSize()} */    public static final int ADDRESS_SIZE = theUnsafe.addressSize();     /**     * Report the size in bytes of a native memory page (whatever that is).     * This value will always be a power of two.     */    public native int pageSize();      /// random trusted operations from JNI:     /**     * Tell the VM to define a class, without security checks.  By default, the     * class loader and protection domain come from the caller's class.     */    public native Class defineClass(String name, byte[] b, int off, int len,                                    ClassLoader loader,                                    ProtectionDomain protectionDomain);     public native Class defineClass(String name, byte[] b, int off, int len);     /**     * Define a class but do not make it known to the class loader or system dictionary.     * <p>     * For each CP entry, the corresponding CP patch must either be null or have     * the a format that matches its tag:     * <ul>     * <li>Integer, Long, Float, Double: the corresponding wrapper object type from java.lang     * <li>Utf8: a string (must have suitable syntax if used as signature or name)     * <li>Class: any java.lang.Class object     * <li>String: any object (not just a java.lang.String)     * <li>InterfaceMethodRef: (NYI) a method handle to invoke on that call site's arguments     * </ul>     * @params hostClass context for linkage, access control, protection domain, and class loader     * @params data      bytes of a class file     * @params cpPatches where non-null entries exist, they replace corresponding CP entries in data     */    public native Class defineAnonymousClass(Class hostClass, byte[] data, Object[] cpPatches);      /** Allocate an instance but do not run any constructor.        Initializes the class if it has not yet been. */    public native Object allocateInstance(Class cls)        throws InstantiationException;     /** Lock the object.  It must get unlocked via {@link #monitorExit}. */    public native void monitorEnter(Object o);     /**     * Unlock the object.  It must have been locked via {@link     * #monitorEnter}.     */    public native void monitorExit(Object o);     /**     * Tries to lock the object.  Returns true or false to indicate     * whether the lock succeeded.  If it did, the object must be     * unlocked via {@link #monitorExit}.     */    public native boolean tryMonitorEnter(Object o);     /** Throw the exception without telling the verifier. */    public native void throwException(Throwable ee);      /**     * Atomically update Java variable to <tt>x</tt> if it is currently     * holding <tt>expected</tt>.     * @return <tt>true</tt> if successful     */    public final native boolean compareAndSwapObject(Object o, long offset,                                                     Object expected,                                                     Object x);     /**     * Atomically update Java variable to <tt>x</tt> if it is currently     * holding <tt>expected</tt>.     * @return <tt>true</tt> if successful     */    public final native boolean compareAndSwapInt(Object o, long offset,                                                  int expected,                                                  int x);     /**     * Atomically update Java variable to <tt>x</tt> if it is currently     * holding <tt>expected</tt>.     * @return <tt>true</tt> if successful     */    public final native boolean compareAndSwapLong(Object o, long offset,                                                   long expected,                                                   long x);     /**     * Fetches a reference value from a given Java variable, with volatile     * load semantics. Otherwise identical to {@link #getObject(Object, long)}     */    public native Object getObjectVolatile(Object o, long offset);     /**     * Stores a reference value into a given Java variable, with     * volatile store semantics. Otherwise identical to {@link #putObject(Object, long, Object)}     */    public native void    putObjectVolatile(Object o, long offset, Object x);     /** Volatile version of {@link #getInt(Object, long)}  */    public native int     getIntVolatile(Object o, long offset);     /** Volatile version of {@link #putInt(Object, long, int)}  */    public native void    putIntVolatile(Object o, long offset, int x);     /** Volatile version of {@link #getBoolean(Object, long)}  */    public native boolean getBooleanVolatile(Object o, long offset);     /** Volatile version of {@link #putBoolean(Object, long, boolean)}  */    public native void    putBooleanVolatile(Object o, long offset, boolean x);     /** Volatile version of {@link #getByte(Object, long)}  */    public native byte    getByteVolatile(Object o, long offset);     /** Volatile version of {@link #putByte(Object, long, byte)}  */    public native void    putByteVolatile(Object o, long offset, byte x);     /** Volatile version of {@link #getShort(Object, long)}  */    public native short   getShortVolatile(Object o, long offset);     /** Volatile version of {@link #putShort(Object, long, short)}  */    public native void    putShortVolatile(Object o, long offset, short x);     /** Volatile version of {@link #getChar(Object, long)}  */    public native char    getCharVolatile(Object o, long offset);     /** Volatile version of {@link #putChar(Object, long, char)}  */    public native void    putCharVolatile(Object o, long offset, char x);     /** Volatile version of {@link #getLong(Object, long)}  */    public native long    getLongVolatile(Object o, long offset);     /** Volatile version of {@link #putLong(Object, long, long)}  */    public native void    putLongVolatile(Object o, long offset, long x);     /** Volatile version of {@link #getFloat(Object, long)}  */    public native float   getFloatVolatile(Object o, long offset);     /** Volatile version of {@link #putFloat(Object, long, float)}  */    public native void    putFloatVolatile(Object o, long offset, float x);     /** Volatile version of {@link #getDouble(Object, long)}  */    public native double  getDoubleVolatile(Object o, long offset);     /** Volatile version of {@link #putDouble(Object, long, double)}  */    public native void    putDoubleVolatile(Object o, long offset, double x);     /**     * Version of {@link #putObjectVolatile(Object, long, Object)}     * that does not guarantee immediate visibility of the store to     * other threads. This method is generally only useful if the     * underlying field is a Java volatile (or if an array cell, one     * that is otherwise only accessed using volatile accesses).     */    public native void    putOrderedObject(Object o, long offset, Object x);     /** Ordered/Lazy version of {@link #putIntVolatile(Object, long, int)}  */    public native void    putOrderedInt(Object o, long offset, int x);     /** Ordered/Lazy version of {@link #putLongVolatile(Object, long, long)} */    public native void    putOrderedLong(Object o, long offset, long x);     /**     * Unblock the given thread blocked on <tt>park</tt>, or, if it is     * not blocked, cause the subsequent call to <tt>park</tt> not to     * block.  Note: this operation is "unsafe" solely because the     * caller must somehow ensure that the thread has not been     * destroyed. Nothing special is usually required to ensure this     * when called from Java (in which there will ordinarily be a live     * reference to the thread) but this is not nearly-automatically     * so when calling from native code.     * @param thread the thread to unpark.     *     */    public native void unpark(Object thread);     /**     * Block current thread, returning when a balancing     * <tt>unpark</tt> occurs, or a balancing <tt>unpark</tt> has     * already occurred, or the thread is interrupted, or, if not     * absolute and time is not zero, the given time nanoseconds have     * elapsed, or if absolute, the given deadline in milliseconds     * since Epoch has passed, or spuriously (i.e., returning for no     * "reason"). Note: This operation is in the Unsafe class only     * because <tt>unpark</tt> is, so it would be strange to place it     * elsewhere.     */    public native void park(boolean isAbsolute, long time);     /**     * Gets the load average in the system run queue assigned     * to the available processors averaged over various periods of time.     * This method retrieves the given <tt>nelem</tt> samples and     * assigns to the elements of the given <tt>loadavg</tt> array.     * The system imposes a maximum of 3 samples, representing     * averages over the last 1,  5,  and  15 minutes, respectively.     *     * @params loadavg an array of double of size nelems     * @params nelems the number of samples to be retrieved and     *         must be 1 to 3.     *     * @return the number of samples actually retrieved; or -1     *         if the load average is unobtainable.

Lines 501–1000 of 1003. Previous lines