javax.realtime
Class RealtimeSecurity

java.lang.Object
  extended by javax.realtime.RealtimeSecurity

public class RealtimeSecurity
extends java.lang.Object

Security policy object for real-time specific issues. Primarily used to control access to physical memory.

Security requirements are generally application-specific. Every implementation shall have a default RealtimeSecurity instance, and a way to install a replacement at run-time, RealtimeSystem.setSecurityManager(javax.realtime.RealtimeSecurity). The default security is minimal. All security managers should prevent access to JVM internal data and the Java heap; additional protection is implementation-specific and must be documented.

Constructor Summary
RealtimeSecurity()
          Create an RealtimeSecurity object.
 
Method Summary
 void checkAccessPhysical()
          Check whether the application is allowed to access physical memory.
 void checkAccessPhysicalRange(long base, long size)
          Checks whether the application is allowed to access physical memory within the specified range.
 void checkAEHSetDaemon()
          Checks whether the application is allowed to set the daemon status of an AEH.
 void checkSetFilter()
          Checks whether the application is allowed to register PhysicalMemoryTypeFilter objects with the PhysicalMemoryManager.
 void checkSetMonitorControl(MonitorControl policy)
          Checks whether the application is allowed to set the default monitor control policy.
 void checkSetScheduler()
          Checks whether 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()
Create an RealtimeSecurity object.

Method Detail

checkAccessPhysical

public void checkAccessPhysical()
                         throws java.lang.SecurityException
Check whether the application is allowed to access physical memory.

Throws:
java.lang.SecurityException - The application doesn't have permission to access physical memory.

checkAccessPhysicalRange

public void checkAccessPhysicalRange(long base,
                                     long size)
                              throws java.lang.SecurityException
Checks whether the application is allowed to access physical memory within the specified range.

Parameters:
base - The beginning of the address range.
size - The size of the address range.
Throws:
java.lang.SecurityException - The application doesn't have permission to access the memory in the given range.

checkSetFilter

public void checkSetFilter()
                    throws java.lang.SecurityException
Checks whether the application is allowed to register PhysicalMemoryTypeFilter objects with the PhysicalMemoryManager.

Throws:
java.lang.SecurityException - The application doesn't have permission to register filter objects.

checkSetMonitorControl

public void checkSetMonitorControl(MonitorControl policy)
                            throws java.lang.SecurityException
Checks whether the application is allowed to set the default monitor control policy.

Parameters:
policy - The new policy
Throws:
java.lang.SecurityException - Thrown if the application doesn't have permission to change the default monitor control policy to policy.
Since:
1.0.1

checkAEHSetDaemon

public void checkAEHSetDaemon()
                       throws java.lang.SecurityException
Checks whether the application is allowed to set the daemon status of an AEH.

Throws:
java.lang.SecurityException - Thrown if the application is not permitted to alter the daemon status.
Since:
1.0.1

checkSetScheduler

public void checkSetScheduler()
                       throws java.lang.SecurityException
Checks whether the application is allowed to set the scheduler.

Throws:
java.lang.SecurityException - The application doesn't have permission to set the scheduler.