javax.realtime
Class RealtimeSecurity

java.lang.Object
  javax.realtime.RealtimeSecurity

public class RealtimeSecurity
extends java.lang.Object

Jamaica Realtime Specification for Java class RealtimeSecurity.

This class controls the access permissions to physical memory via the *PhysicalMemory and RawMemory*, the setting of the scheduler, monitor control and the daemon status of async event handlers.

The instance of RealtimeSecurity that is currently in use may be set via RealtimeSystem.setSecurityManager.

Constructor Summary

RealtimeSecurity()
Constructor for a default RealtimeSecurity instance.

Method Summary

void	checkAccessPhysical() checkAccessPhysical checks if access to physical memory is permitted.
void	checkAccessPhysicalRange(long base, long size) checkAccessPhysicalRange checks if access to the given area of physical memory is permitted.
void	checkSetAEHSetDaemon() checkSetMonitorControl checks if the application is allowed to set the daemon status of an AsyncEventHandler.
void	checkSetFilter() checkSetFilter checks if the application is allowed to register new memory type filters with the PhysicalMemoryManager class.
void	checkSetMonitorControl() checkSetMonitorControl checks if the application is allowed to set the default monitor control policy.
void	checkSetScheduler() checkSetScheduler checks if the application is allowed to set the scheduler.

Methods inherited from class java.lang.Object

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

Constructor Detail

RealtimeSecurity

public RealtimeSecurity()

Constructor for a default RealtimeSecurity instance.

Method Detail

checkAccessPhysical

public void checkAccessPhysical()
                         throws java.lang.SecurityException

checkAccessPhysical checks if access to physical memory is permitted. Throws a SecurityException if this is not the case. The default setting is that access to physical memory is not permitted, unless it was explicitly enabled via the Jamaica builder option -physicalMemoryRanges. If at least one range of memory has been made accessible by this option, this method will return without an exception.

Throws:

java.lang.SecurityException - iff access to physical memory is not permitted.

checkAccessPhysicalRange

public void checkAccessPhysicalRange(long base,
                                     long size)
                              throws java.lang.SecurityException

checkAccessPhysicalRange checks if access to the given area of physical memory is permitted. Throws a SecurityException if this is not the case. The default setting is that access to physical memory is not permitted, unless it was explicitly enabled via the Jamaica builder option -physicalMemoryRanges. If the provided range lies inside a range of memory that has been made accessible by this option, this method will return without an exception.

Parameters:

base - The base address of the area.

size - The size of the memory area in bytes.

Throws:

java.lang.SecurityException - iff access to physical memory is not permitted.

checkSetFilter

public void checkSetFilter()
                    throws java.lang.SecurityException

checkSetFilter checks if the application is allowed to register new memory type filters with the PhysicalMemoryManager class. The default implementation permits registering of new filters.

Throws:

java.lang.SecurityException

checkSetScheduler

public void checkSetScheduler()
                       throws java.lang.SecurityException

checkSetScheduler checks if the application is allowed to set the scheduler. The default implementation permits setting of the scheduler.

Throws:

java.lang.SecurityException

checkSetMonitorControl

public void checkSetMonitorControl()
                            throws java.lang.SecurityException

checkSetMonitorControl checks if the application is allowed to set the default monitor control policy. The default implementation permits setting of the default monitor control policy.

Throws:

java.lang.SecurityException

Since:

RTSJ V1.0.1

checkSetAEHSetDaemon

public void checkSetAEHSetDaemon()
                          throws java.lang.SecurityException

checkSetMonitorControl checks if the application is allowed to set the daemon status of an AsyncEventHandler. The default implementation permits setting of the default monitor control policy.

Throws:

java.lang.SecurityException

Since:

RTSJ V1.0.1