javax.realtime.memory

Class ScopedMemoryPermission

java.lang.Object

java.security.Permission

javax.realtime.RealtimePermission

javax.realtime.memory.ScopedMemoryPermission

All Implemented Interfaces:

java.io.Serializable, java.security.Guard

public class ScopedMemoryPermission
extends RealtimePermission

The alternate memory management module provides thre permissions for the security manager to use. The following table describes the actions for checking the use of scoped memory. A signal name can be given as the target. The name of a scoped memory area type can be given for enter and a maximum amount of backing store can be used for global backing store.

Action Name	Description	Risks of grant
map	Uses a given amount of the global backing store.	Physical Map Risk
enter	Enters a scoped memory	Memory Risk
monitor	Visit root scoped memories	Encapsulation Risk

The wildcard * or no target allows access to any scoped memory area or any amount of backing store. The risk classes are defined in RealtimePermission.

Since:

RTSJ 2.0

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
ScopedMemoryPermission(java.lang.String actions) Creates a new ScopedMemoryPermission object for a given action, i.e., the symbolic name of an action.
ScopedMemoryPermission(java.lang.String target, java.lang.String actions) Creates a new ScopedMemoryPermission object for a given action, i.e., the symbolic name of an action.

Method Summary

Modifier and Type	Method and Description
boolean	implies(java.security.Permission permission) Checks if the given permission's actions are "implied by" this object's actions.

Methods inherited from class javax.realtime.RealtimePermission

equals, getActions, hashCode, setHashCode

Methods inherited from class java.security.Permission

checkGuard, getName, newPermissionCollection, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

ScopedMemoryPermission

public ScopedMemoryPermission(java.lang.String target,
                              java.lang.String actions)

Creates a new ScopedMemoryPermission object for a given action, i.e., the symbolic name of an action. The target string specifies additional limitations on the action.

Parameters:

target - Specifies the domain for the action, or * for no limit on the permission.

actions - The names of the actions to allow, or * for all actions.

Throws:

java.lang.NullPointerException - when action is null.

StaticIllegalArgumentException - when target or action is empty.

ScopedMemoryPermission

public ScopedMemoryPermission(java.lang.String actions)

Creates a new ScopedMemoryPermission object for a given action, i.e., the symbolic name of an action.

Parameters:

actions - The names of the actions to allow, or * for all actions.

Throws:

java.lang.NullPointerException - when action is null.

StaticIllegalArgumentException - when action is empty.

Method Detail

implies

public boolean implies(java.security.Permission permission)

Description copied from class: RealtimePermission

Checks if the given permission's actions are "implied by" this object's actions. This method is used by the AccessController to determine whether or not a requested permission is implied by another permission that is known to be valid in the current execution context.

Overrides:

implies in class RealtimePermission

Parameters:

permission - is the permission to check.

Returns:

true when yes and false otherwise.