javax.realtime
Class LTPhysicalMemory

java.lang.Object
  |
  +--javax.realtime.MemoryArea
        |
        +--javax.realtime.ScopedMemory
              |
              +--javax.realtime.LTPhysicalMemory

public class LTPhysicalMemory

extends ScopedMemory

An instance of LTPhysicalMemory allows objects to be allocated from a range of physical memory with particular attributes, determined by their memory type. This memory area has the same restrictive set of assignment rules as ScopedMemory memory areas, and the same performance restrictions as LTMemory.

Field Summary

private long	base
private java.lang.Runnable	logic
private long	size

Fields inherited from class javax.realtime.ScopedMemory

portal

Fields inherited from class javax.realtime.MemoryArea

constant, heap, id, memoryConsumed, nullClassArr, nullMem, nullObjArr, scoped, shadow

Constructor Summary

LTPhysicalMemory(java.lang.Object type, long size)
Create an instance of LTPhysicalMemory with the given parameters.

LTPhysicalMemory(java.lang.Object type, long base, long size)
Create an instance of LTPhysicalMemory with the given parameters.

LTPhysicalMemory(java.lang.Object type, long base, long size, java.lang.Runnable logic)
Create an instance of LTPhysicalMemory with the given parameters.

LTPhysicalMemory(java.lang.Object type, long size, java.lang.Runnable logic)
Create an instance of LTPhysicalMemory with the given parameters.

LTPhysicalMemory(java.lang.Object type, long base, javax.realtime.SizeEstimator size)
Create an instance of LTPhysicalMemory with the given parameters.

LTPhysicalMemory(java.lang.Object type, long base, javax.realtime.SizeEstimator size, java.lang.Runnable logic)
Create an instance of LTPhysicalMemory with the given parameters.

LTPhysicalMemory(java.lang.Object type, javax.realtime.SizeEstimator size)
Create an instance of LTPhysicalMemory with the given parameters.

LTPhysicalMemory(java.lang.Object type, javax.realtime.SizeEstimator size, java.lang.Runnable logic)
Create an instance of LTPhysicalMemory with the given parameters.

Method Summary

protected void	initNative(long sizeInBytes)
java.lang.String	toString() Creates a string representing the name of this.

Methods inherited from class javax.realtime.ScopedMemory

checkAccess, checkNewInstance, enter, enter, getMaximumSize, getOuterScope, getPortal, getReferenceCount, join, join, joinAndEnter, joinAndEnter, joinAndEnter, joinAndEnter, setPortal, setupMemBlock

Methods inherited from class javax.realtime.MemoryArea

bless, enterMemBlock, executeInArea, exitMemBlock, getMemoryArea, memoryConsumed, memoryRemaining, newArray, newArray, newArray, newArray, newInstance, newInstance, newInstance, newInstance, postSetup, preSetup, registerFinal, shadow, size, startMem, stopMem, throwIllegalAssignmentError

Methods inherited from class java.lang.Object

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

Field Detail

base

private long base

size

private long size

logic

private java.lang.Runnable logic

Constructor Detail

LTPhysicalMemory

public LTPhysicalMemory(java.lang.Object type,
                        long size)
                 throws java.lang.SecurityException,
                        SizeOutOfBoundsException,
                        UnsupportedPhysicalMemoryException,
                        MemoryTypeConflictException

Create an instance of LTPhysicalMemory with the given parameters.

Parameters:

type - An instance of Object representing the type of memory required (e.g., dma, shared) - used to define the base address and control the mapping.

size - The size of the area in bytes.

Throws:

java.lang.SecurityException - The application doesn't have permissions to access physical memory or the given type of memory.

SizeOutOfBoundsException - The size is negative or extends into an invalid range of memory.

UnsupportedPhysicalMemoryException - Thrown if the underlying hardware does not support the given type.

MemoryTypeConflictException - The specified base does not point to memory that matches the request type, or if type specifies attributes with a conflict.

LTPhysicalMemory

public LTPhysicalMemory(java.lang.Object type,
                        long base,
                        long size)
                 throws java.lang.SecurityException,
                        SizeOutOfBoundsException,
                        OffsetOutOfBoundsException,
                        UnsupportedPhysicalMemoryException,
                        MemoryTypeConflictException,
                        MemoryInUseException

Create an instance of LTPhysicalMemory with the given parameters.

Parameters:

type - An instance of Object representing the type of memory required (e.g., dma, shared) - used to define the base address and control the mapping.

base - The physical memory address of the area.

size - The size of the area in bytes.

Throws:

java.lang.SecurityException - The application doesn't have permissions to access physical memory or the given type of memory.

SizeOutOfBoundsException - The size is negative or extends into an invalid range of memory.

UnsupportedPhysicalMemoryException - Thrown if the underlying hardware does not support the given type.

MemoryTypeConflictException - The specified base does not point to memory that matches the request type, or if type specifies attributes with a conflict.

MemoryInUseException - The specified memory is already in use.

OffsetOutOfBoundsException

LTPhysicalMemory

public LTPhysicalMemory(java.lang.Object type,
                        long base,
                        long size,
                        java.lang.Runnable logic)
                 throws java.lang.SecurityException,
                        SizeOutOfBoundsException,
                        OffsetOutOfBoundsException,
                        UnsupportedPhysicalMemoryException,
                        MemoryTypeConflictException,
                        MemoryInUseException

Create an instance of LTPhysicalMemory with the given parameters.

Parameters:

type - An instance of Object representing the type of memory required (e.g., dma, shared) - used to define the base address and control the mapping.

base - The physical memory address of the area.

size - The size of the area in bytes.

logic - enter this memory area with this Runnable after the memory area is created.

Throws:

java.lang.SecurityException - The application doesn't have permissions to access physical memory or the given type of memory.

SizeOutOfBoundsException - The size is negative or extends into an invalid range of memory.

UnsupportedPhysicalMemoryException - Thrown if the underlying hardware does not support the given type.

MemoryTypeConflictException - The specified base does not point to memory that matches the request type, or if type specifies attributes with a conflict.

MemoryInUseException - The specified memory is already in use.

OffsetOutOfBoundsException

LTPhysicalMemory

public LTPhysicalMemory(java.lang.Object type,
                        long size,
                        java.lang.Runnable logic)
                 throws java.lang.SecurityException,
                        SizeOutOfBoundsException,
                        UnsupportedPhysicalMemoryException,
                        MemoryTypeConflictException

Create an instance of LTPhysicalMemory with the given parameters.

Parameters:

type - An instance of Object representing the type of memory required (e.g., dma, shared) - used to define the base address and control the mapping.

size - The size of the area in bytes.

logic - enter this memory area with this Runnable after the memory area is created.

Throws:

java.lang.SecurityException - The application doesn't have permissions to access physical memory or the given type of memory.

SizeOutOfBoundsException - The size is negative or extends into an invalid range of memory.

UnsupportedPhysicalMemoryException - Thrown if the underlying hardware does not support the given type.

MemoryTypeConflictException - The specified base does not point to memory that matches the request type, or if type specifies attributes with a conflict.

LTPhysicalMemory

public LTPhysicalMemory(java.lang.Object type,
                        long base,
                        javax.realtime.SizeEstimator size)
                 throws java.lang.SecurityException,
                        SizeOutOfBoundsException,
                        OffsetOutOfBoundsException,
                        UnsupportedPhysicalMemoryException,
                        MemoryTypeConflictException,
                        MemoryInUseException

Create an instance of LTPhysicalMemory with the given parameters.

Parameters:

type - An instance of Object representing the type of memory required (e.g., dma, shared) - used to define the base address and control the mapping.

base - The physical memory address of the area.

size - The size estimator for this memory area.

Throws:

java.lang.SecurityException - The application doesn't have permissions to access physical memory or the given type of memory.

SizeOutOfBoundsException - The size is negative or extends into an invalid range of memory.

UnsupportedPhysicalMemoryException - Thrown if the underlying hardware does not support the given type.

MemoryTypeConflictException - The specified base does not point to memory that matches the request type, or if type specifies attributes with a conflict.

OffsetOutOfBoundsException

MemoryInUseException

LTPhysicalMemory

public LTPhysicalMemory(java.lang.Object type,
                        long base,
                        javax.realtime.SizeEstimator size,
                        java.lang.Runnable logic)
                 throws java.lang.SecurityException,
                        SizeOutOfBoundsException,
                        OffsetOutOfBoundsException,
                        UnsupportedPhysicalMemoryException,
                        MemoryTypeConflictException,
                        MemoryInUseException

Create an instance of LTPhysicalMemory with the given parameters.

Parameters:

type - An instance of Object representing the type of memory required (e.g., dma, shared) - used to define the base address and control the mapping.

base - The physical memory address of the area.

size - The size estimator for this memory area.

logic - enter this memory area with this Runnable after the memory area is created.

Throws:

java.lang.SecurityException - The application doesn't have permissions to access physical memory or the given type of memory.

SizeOutOfBoundsException - The size is negative or extends into an invalid range of memory.

UnsupportedPhysicalMemoryException - Thrown if the underlying hardware does not support the given type.

MemoryTypeConflictException - The specified base does not point to memory that matches the request type, or if type specifies attributes with a conflict.

OffsetOutOfBoundsException

MemoryInUseException

LTPhysicalMemory

public LTPhysicalMemory(java.lang.Object type,
                        javax.realtime.SizeEstimator size)
                 throws java.lang.SecurityException,
                        SizeOutOfBoundsException,
                        UnsupportedPhysicalMemoryException,
                        MemoryTypeConflictException

Create an instance of LTPhysicalMemory with the given parameters.

Parameters:

type - An instance of Object representing the type of memory required (e.g., dma, shared) - used to define the base address and control the mapping.

size - The size estimator for this memory area.

Throws:

java.lang.SecurityException - The application doesn't have permissions to access physical memory or the given type of memory.

SizeOutOfBoundsException - The size is negative or extends into an invalid range of memory.

UnsupportedPhysicalMemoryException - Thrown if the underlying hardware does not support the given type.

MemoryTypeConflictException - The specified base does not point to memory that matches the request type, or if type specifies attributes with a conflict.

LTPhysicalMemory

public LTPhysicalMemory(java.lang.Object type,
                        javax.realtime.SizeEstimator size,
                        java.lang.Runnable logic)
                 throws java.lang.SecurityException,
                        SizeOutOfBoundsException,
                        UnsupportedPhysicalMemoryException,
                        MemoryTypeConflictException

Create an instance of LTPhysicalMemory with the given parameters.

Parameters:

type - An instance of Object representing the type of memory required (e.g., dma, shared) - used to define the base address and control the mapping.

size - The size estimator for this memory area.

logic - enter this memory area with this Runnable after the memory area is created.

Throws:

java.lang.SecurityException - The application doesn't have permissions to access physical memory or the given type of memory.

SizeOutOfBoundsException - The size is negative or extends into an invalid range of memory.

UnsupportedPhysicalMemoryException - Thrown if the underlying hardware does not support the given type.

MemoryTypeConflictException - The specified base does not point to memory that matches the request type, or if type specifies attributes with a conflict.

Method Detail

initNative

protected void initNative(long sizeInBytes)

Specified by:

initNative in class MemoryArea

toString

public java.lang.String toString()

Creates a string representing the name of this.

Overrides:

toString in class ScopedMemory

Returns:

A string representing the name of this.