2N/A * The contents of this file are subject to the terms of the 2N/A * Common Development and Distribution License (the "License"). 2N/A * You may not use this file except in compliance with the License. 2N/A * See the License for the specific language governing permissions 2N/A * and limitations under the License. 2N/A * When distributing Covered Code, include this CDDL HEADER in each 2N/A * If applicable, add the following below this CDDL HEADER, with the 2N/A * fields enclosed by brackets "[]" replaced with your own identifying 2N/A * information: Portions Copyright [yyyy] [name of copyright owner] 2N/A * Copyright 2007 Sun Microsystems, Inc. All rights reserved. 2N/A * Use is subject to license terms. 2N/A * ident "%Z%%M% %I% %E% SMI" 2N/A * A value generated by the DTrace {@code umod()}, {@code ufunc()}, or 2N/A * {@code usym()} action used to lookup the symbol associated with a 2N/A * @author Tom Erickson 2N/A new String[] {
"processID",
"symbol",
"address"})
2N/A * Need to prevent DefaultPersistenceDelegate from using 2N/A * overridden equals() method, resulting in a 2N/A * StackOverFlowError. Revert to PersistenceDelegate 2N/A * implementation. See 2N/A // serialized explicitly to hide implementation; treat as final 2N/A // set natively after creation; treat as final 2N/A * Called by native code. 2N/A * Creates a {@code UserSymbolRecord} with the given process ID, 2N/A * symbol lookup, and user address converted in probe context as a 2N/A * result of the DTrace {@code umod()}, {@code ufunc()}, or {@code 2N/A * Supports XML persistence. 2N/A * @param pid non-negative user process ID 2N/A * @param lookupValue the result in the native DTrace library of 2N/A * looking up the symbol associated with the given user address 2N/A * @param addressValue symbol address 2N/A * @throws NullPointerException if the given lookup value is {@code null} 2N/A * @throws IllegalArgumentException if the given process ID is 2N/A * Gets the process ID associated with this record's symbol. 2N/A * @return non-negative pid 2N/A * Gets the result of the address lookup in the same form returned 2N/A * by {@link Consumer#lookupUserFunction(int pid, long address)}. 2N/A * @return non-null address lookup in the format defined by the 2N/A * native DTrace library 2N/A * Called by native code and ProbeData addSymbolRecord() 2N/A * Gets the symbol's user address. 2N/A * @return the symbol's user address 2N/A * Gets the composite value of the symbol's process ID and address. 2N/A * The value is used in {@link #equals(Object o) equals()} and 2N/A * {@link #compareTo(UserSymbolRecord r) compareTo()} to test 2N/A * equality and to determine the natural ordering of {@code 2N/A * UserSymbolRecord} instances. 2N/A * @return non-null composite value of the symbols's process ID and 2N/A * Compares the specified object with this {@code UserSymbolRecord} 2N/A * for equality. Returns {@code true} if and only if the specified 2N/A * object is also a {@code UserSymbolRecord} and both records have 2N/A * the same process ID and the same address. 2N/A * @return {@code true} if and only if the specified object is also 2N/A * a {@code UserSymbolRecord} and both records have the same 2N/A * process ID and the same address 2N/A * Overridden to ensure that equal instances have equal hash codes. 2N/A * Compares this record with the given user symbol lookup and orders 2N/A * by the combined value of process ID first and address second. 2N/A * The comparison treats addresses as unsigned values so the 2N/A * ordering is consistent with that defined in the native DTrace 2N/A * library. The {@code compareTo()} method is compatible with {@link 2N/A * #equals(Object o) equals()}. 2N/A * @return -1, 0, or 1 as this record's combined process ID and 2N/A * address is less than, equal to, or greater than the given 2N/A * record's combined process ID and address 2N/A * Serialize this {@code UserSymbolRecord} instance. 2N/A * @serialData processID ({@code int}), followed by symbol ({@code 2N/A * java.lang.String}), followed by address ({@code long}) 2N/A * Gets the result of this symbol lookup. The format is defined in 2N/A * the native DTrace library and is as stable as that library 2N/A * @return {@link #getSymbol()} 2N/A * The composite value of a symbol's process ID and user address. 2N/A * Immutable. Supports persistence using {@link 2N/A * Need to prevent DefaultPersistenceDelegate from using 2N/A * overridden equals() method, resulting in a 2N/A * StackOverFlowError. Revert to PersistenceDelegate 2N/A * implementation. See 2N/A * Creates a composite value with the given user process ID and 2N/A * Supports XML persistence. 2N/A * @param pid non-negative process ID 2N/A * @param addressValue symbol address 2N/A * @throws IllegalArgumentException if the given process ID is 2N/A * Gets the process ID associated with this value's user 2N/A * @return non-negative pid 2N/A * Gets the symbol's user address. 2N/A * @return the symbol's user address 2N/A * Compares the specified object with this {@code 2N/A * UserSymbolRecord.Value} for equality. Returns {@code true} 2N/A * if and only if the specified object is also a {@code 2N/A * UserSymbolRecord.Value} and both values have the same process 2N/A * ID and the same address. 2N/A * @return {@code true} if and only if the specified object is 2N/A * also a {@code UserSymbolRecord.Value} and both values have 2N/A * the same process ID and the same address 2N/A * Overridden to ensure that equal instances have equal hash 2N/A * Compares this value with the given {@code 2N/A * UserSymbolRecord.Value} and orders by process ID first and 2N/A * address second. The comparison treats addresses as unsigned 2N/A * values so the ordering is consistent with that defined in the 2N/A * native DTrace library. The {@code compareTo()} method is 2N/A * compatible with {@link #equals(Object o) equals()}. 2N/A * @return -1, 0, or 1 as this value's combined process ID and 2N/A * address is less than, equal to, or greater than the given 2N/A * value's combined process ID and address 2N/A // check class invariants 2N/A * Gets a string representation of this {@code 2N/A * UserSymbolRecord.Value} instance useful for logging and not 2N/A * intended for display. The exact details of the 2N/A * representation are unspecified and subject to change, but the 2N/A * following format may be regarded as typical: 2N/A * class-name[property1 = value1, property2 = value2]