javax.realtime

Class RealtimeSecurity

java.lang.Object

javax.realtime.RealtimeSecurity

public class RealtimeSecurity
extends java.lang.Object

Jamaica Real-Time 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

Constructors

Constructor and Description
RealtimeSecurity() Constructor for a default RealtimeSecurity instance.

Method Summary

Modifier and Type	Method and Description
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	checkAEHSetDaemon() checkAEHSetDaemon checks if the application is allowed to set the daemon status of an AsyncBaseEventHandler.
void	checkSetFilter() checkSetFilter checks if the application is allowed to register new memory type filters with the PhysicalMemoryManager class.
void	checkSetMonitorControl(MonitorControl policy) 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(MonitorControl policy)
                            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

checkAEHSetDaemon

public void checkAEHSetDaemon()
                       throws java.lang.SecurityException

checkAEHSetDaemon checks if the application is allowed to set the daemon status of an AsyncBaseEventHandler. The default implementation permits setting of the daemon status.

Throws:

java.lang.SecurityException

Since:

RTSJ V1.0.1