You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
108 lines
2.8 KiB
108 lines
2.8 KiB
/*
|
|
* Copyright (c) 2007, 2011, Oracle and/or its affiliates. All rights reserved.
|
|
* ORACLE PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*/
|
|
|
|
package java.nio.file;
|
|
|
|
import java.security.BasicPermission;
|
|
|
|
/**
|
|
* The {@code Permission} class for link creation operations.
|
|
*
|
|
* <p> The following table provides a summary description of what the permission
|
|
* allows, and discusses the risks of granting code the permission.
|
|
*
|
|
* <table border=1 cellpadding=5
|
|
* summary="Table shows permission target name, what the permission allows, and associated risks">
|
|
* <tr>
|
|
* <th>Permission Target Name</th>
|
|
* <th>What the Permission Allows</th>
|
|
* <th>Risks of Allowing this Permission</th>
|
|
* </tr>
|
|
* <tr>
|
|
* <td>hard</td>
|
|
* <td> Ability to add an existing file to a directory. This is sometimes
|
|
* known as creating a link, or hard link. </td>
|
|
* <td> Extreme care should be taken when granting this permission. It allows
|
|
* linking to any file or directory in the file system thus allowing the
|
|
* attacker access to all files. </td>
|
|
* </tr>
|
|
* <tr>
|
|
* <td>symbolic</td>
|
|
* <td> Ability to create symbolic links. </td>
|
|
* <td> Extreme care should be taken when granting this permission. It allows
|
|
* linking to any file or directory in the file system thus allowing the
|
|
* attacker to access to all files. </td>
|
|
* </tr>
|
|
* </table>
|
|
*
|
|
* @since 1.7
|
|
*
|
|
* @see Files#createLink
|
|
* @see Files#createSymbolicLink
|
|
*/
|
|
public final class LinkPermission extends BasicPermission {
|
|
static final long serialVersionUID = -1441492453772213220L;
|
|
|
|
private void checkName(String name) {
|
|
if (!name.equals("hard") && !name.equals("symbolic")) {
|
|
throw new IllegalArgumentException("name: " + name);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Constructs a {@code LinkPermission} with the specified name.
|
|
*
|
|
* @param name
|
|
* the name of the permission. It must be "hard" or "symbolic".
|
|
*
|
|
* @throws IllegalArgumentException
|
|
* if name is empty or invalid
|
|
*/
|
|
public LinkPermission(String name) {
|
|
super(name);
|
|
checkName(name);
|
|
}
|
|
|
|
/**
|
|
* Constructs a {@code LinkPermission} with the specified name.
|
|
*
|
|
* @param name
|
|
* the name of the permission; must be "hard" or "symbolic".
|
|
* @param actions
|
|
* the actions for the permission; must be the empty string or
|
|
* {@code null}
|
|
*
|
|
* @throws IllegalArgumentException
|
|
* if name is empty or invalid, or actions is a non-empty string
|
|
*/
|
|
public LinkPermission(String name, String actions) {
|
|
super(name);
|
|
checkName(name);
|
|
if (actions != null && actions.length() > 0) {
|
|
throw new IllegalArgumentException("actions: " + actions);
|
|
}
|
|
}
|
|
}
|