javax.realtime.posix

Class POSIXPermission

java.lang.Object

java.security.Permission

javax.realtime.RealtimePermission

javax.realtime.posix.POSIXPermission

All Implemented Interfaces:

Serializable, Guard

public class POSIXPermission
extends RealtimePermission

The POSIX module provides one permission class for the security manager to use. This permission applies to both Signal and RealtimeSignal. The following table describes the actions for checking the use of signals. A signal name or * can be given as the name.

Action Name	Description	Risks of grant
control	Starts or stops this signal.	Scheduling Risk
handle	Adds a handle to the given signal.	Load Risk
override	Removes a handler that belongs to another scheduling group.	Interference Risk
system	Changes systemwide signaling behavior.	Scheduling and Load Risk
send	Sends a given signal.	External Risk
system	Changes systemwide signaling behavior.	Scheduling and Load Risk

The wildcard * is allowed for both signal and action. The risk classes are defined in RealtimePermission.

Since:

RTSJ 2.0

See Also:

Serialized Form

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
boolean	implies(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

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

POSIXPermission

public POSIXPermission(String name,
                       String actions)

Creates a new POSIXPermission object for a given action, i.e., the symbolic name of an action. The name string specifies for which POSIX signal the action applies.

Throws:

NullPointerException - when actions is null.

StaticIllegalArgumentException - when name or action is empty.

Parameters:

name - 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.

POSIXPermission

public POSIXPermission(String actions)

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

Throws:

NullPointerException - when actions is null.

StaticIllegalArgumentException - when actions is empty.

Parameters:

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

Method Detail

implies

public boolean implies(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.