Class ManagementPermission
java.lang.management
java.lang.Object
  java.security.Permission
      java.security.BasicPermission
          java.lang.management.ManagementPermission
All Implemented Interfaces:

final public class ManagementPermission
extends java.security.BasicPermission
The permission which the SecurityManager will check when code that is running with a SecurityManager calls methods defined in the management interface for the Java platform.

The following table provides a summary description of what the permission allows, and discusses the risks of granting code the permission.

Permission Target Name What the Permission Allows Risks of Allowing this Permission
control Ability to control the runtime characteristics of the Java virtual machine, for example, setting the -verbose:gc and -verbose:class flag, setting the threshold of a memory pool, and enabling and disabling the thread contention monitoring support. This allows an attacker to control the runtime characteristics of the Java virtual machine and cause the system to misbehave.
monitor Ability to retrieve runtime information about the Java virtual machine such as thread stack trace, a list of all loaded class names, and input arguments to the Java virtual machine. This allows malicious code to monitor runtime information and uncover vulnerabilities.

Programmers do not normally create ManagementPermission objects directly. Instead they are created by the security policy code based on reading the security policy file.

Since:
1.5
Version:
1.5, 04/21/06
Author:
Mandy Chung
See Also:
java.security.BasicPermission, java.security.Permission, java.security.Permissions, java.security.PermissionCollection, SecurityManager

Constructor Summary
ManagementPermission(String name)
Constructs a ManagementPermission with the specified name.
ManagementPermission(String name, String actions)
Constructs a new ManagementPermission object.
Methods inherited from class java.security.BasicPermission
equals, getActions, hashCode, implies, newPermissionCollection
Methods inherited from class java.security.Permission
checkGuard, getName, toString
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
Constructor Detail
ManagementPermission
public ManagementPermission(String name)
Constructs a ManagementPermission with the specified name.
Parameters:
name - Permission name. Must be either "monitor" or "control".
Throws:
NullPointerException - if name is null.
IllegalArgumentException - if name is empty or invalid.

ManagementPermission
public ManagementPermission(String name,
                            String actions)
                     throws IllegalArgumentException
Constructs a new ManagementPermission object.
Parameters:
name - Permission name. Must be either "monitor" or "control".
actions - Must be either null or the empty string.
Throws:
IllegalArgumentException - if name is empty or if arguments are invalid.
NullPointerException - if name is null.
Java API documentation generated with DocFlex/Doclet v1.5.6
DocFlex/Doclet is both a multi-format Javadoc doclet and a free edition of DocFlex/Javadoc. If you need to customize your Javadoc without writing a full-blown doclet from scratch, DocFlex/Javadoc may be the only tool able to help you! Find out more at www.docflex.com