Serializable
, Guard
public final class AttachPermission extends BasicPermission
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 FormConstructor | Description |
---|---|
AttachPermission(String name) |
Constructs a new AttachPermission object.
|
AttachPermission(String name,
String actions) |
Constructs a new AttachPermission object.
|
equals, getActions, hashCode, implies, newPermissionCollection
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
checkGuard, getName, toString
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. Submit a bug or feature
Java is a trademark or registered trademark of Oracle and/or its affiliates in the US and other countries.
Copyright © 2005, 2017, Oracle and/or its affiliates. 500 Oracle Parkway
Redwood Shores, CA 94065 USA. All rights reserved.
DRAFT 9-Ubuntu+0-9b161-1