|
Attach API | ||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
java.lang.Objectjava.security.Permission
java.security.BasicPermission
com.sun.tools.attach.AttachPermission
public final class AttachPermission
When a SecurityManager set, this
is the permission which will be checked when code invokes VirtalMachine.attach to attach to a target virtual
machine.
This permission is also checked when an AttachProvider is created.
An AttachPermission object contains a name (also referred
to as a "target name") but no actions list; you either have the
named permission or you don't.
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 |
|---|---|---|
| attachVirtualMachine | Ability to attach to another Java virtual machine and load agents into that VM. | This allows an attacker to control the target VM which can potentially cause it to misbehave. |
| createAttachProvider | Ability to create an AttachProvider instance.
|
This allows an attacker to create an AttachProvider which can potentially be used to attach to other Java virtual machines. |
Programmers do not normally create AttachPermission objects directly. Instead they are created by the security policy code based on reading the security policy file.
VirtualMachine,
AttachProvider,
Serialized Form| Constructor Summary | |
|---|---|
AttachPermission(String name)
Constructs a new AttachPermission object. |
|
AttachPermission(String name,
String actions)
Constructs a new AttachPermission object. |
|
| Method Summary |
|---|
| 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 |
|---|
public AttachPermission(String name)
name - Permission name. Must be either "attachVirtualMachine",
or "createAttachProvider".
NullPointerException - if name is null.
IllegalArgumentException - if the name is invalid.
public AttachPermission(String name,
String actions)
name - Permission name. Must be either "attachVirtualMachine",
or "createAttachProvider".actions - Not used and should be null, or
the empty string.
NullPointerException - if name is null.
IllegalArgumentException - if arguments are invalid.
|
Attach API | ||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
Copyright © 2005, 2010, Oracle and/or its affiliates. All rights reserved.