org.jikesrvm.mm.mmtk.gcspy

Class Util

java.lang.Object

org.mmtk.vm.gcspy.Util

org.jikesrvm.mm.mmtk.gcspy.Util

public class Util
extends Util

This class provides generally useful methods.

Field Summary

Fields

Modifier and Type	Field and Description
private static boolean	DEBUG_
static int	KILOBYTE
static int	MEGABYTE

Constructor Summary

Constructors

Constructor and Description
Util()

Method Summary

Modifier and Type	Method and Description
Object	createDataArray(Object templ, int numElements) Create an array of a particular type.
void	formatSize(Address buffer, int size) Pretty print a size, converting from bytes to kilo- or mega-bytes as appropriate
Address	formatSize(String format, int bufsize, int size) Pretty print a size, converting from bytes to kilo- or mega-bytes as appropriate
void	free(Address addr) Free an array of bytes previously allocated with malloc
Address	getBytes(String str) Convert a String to a 0-terminated array of bytes WARNING: we call out to String.length and String.charAt, both of which are interruptible.
Address	malloc(int size) Allocate an array of bytes with malloc
int	sprintf(Address str, Address format, Address value) sprintf(char *str, char *format, char* value)

Methods inherited from class org.mmtk.vm.gcspy.Util

dumpRange, numToBytes, numToBytes

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

DEBUG_

private static final boolean DEBUG_

See Also:

Constant Field Values

KILOBYTE

public static final int KILOBYTE

See Also:

Constant Field Values

MEGABYTE

public static final int MEGABYTE

See Also:

Constant Field Values

Constructor Detail

Util

public Util()

Method Detail

malloc

public final Address malloc(int size)

Description copied from class: Util

Allocate an array of bytes with malloc

Specified by:

malloc in class Util

Parameters:

size - The size to allocate

Returns:

The start address of the memory allocated in C space

See Also:

Util.free(org.vmmagic.unboxed.Address)

free

public final void free(Address addr)

Description copied from class: Util

Free an array of bytes previously allocated with malloc

Specified by:

free in class Util

Parameters:

addr - The address of some memory previously allocated with malloc

See Also:

Util.malloc(int)

getBytes

public final Address getBytes(String str)

Convert a String to a 0-terminated array of bytes

WARNING: we call out to String.length and String.charAt, both of which are interruptible. We protect these calls with a swLock/swUnlock mechanism, as per VM.sysWrite on String.

Specified by:

getBytes in class Util

Parameters:

str - The string to convert

Returns:

The address of a null-terminated array in C-space

formatSize

public final void formatSize(Address buffer,
                             int size)

Description copied from class: Util

Pretty print a size, converting from bytes to kilo- or mega-bytes as appropriate

Specified by:

formatSize in class Util

Parameters:

buffer - The buffer (in C space) in which to place the formatted size

size - The size in bytes

formatSize

public final Address formatSize(String format,
                                int bufsize,
                                int size)

Description copied from class: Util

Pretty print a size, converting from bytes to kilo- or mega-bytes as appropriate

Specified by:

formatSize in class Util

Parameters:

format - A format string

bufsize - The size of a buffer large enough to hold the formatted result

size - The size in bytes

Returns:

start address of the buffer allocated by this call

createDataArray

public Object createDataArray(Object templ,
                              int numElements)

Description copied from class: Util

Create an array of a particular type. The easiest way to use this is: Foo[] x = (Foo [])Stream.createDataArray(new Foo[0], numElements);

Specified by:

createDataArray in class Util

Parameters:

templ - a data array to use as a template

numElements - number of elements in new array

Returns:

the new array

sprintf

public final int sprintf(Address str,
                         Address format,
                         Address value)

Description copied from class: Util

sprintf(char *str, char *format, char* value)

Specified by:

sprintf in class Util

Parameters:

str - The destination 'string' (memory in C space)

format - The format 'string' (memory in C space)

value - The value 'string' (memory in C space)

Returns:

The number of characters printed (as returned by C's sprintf