0N/A/*
2362N/A * Copyright (c) 2007, 2011, Oracle and/or its affiliates. All rights reserved.
0N/A * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
0N/A *
0N/A * This code is free software; you can redistribute it and/or modify it
0N/A * under the terms of the GNU General Public License version 2 only, as
0N/A * published by the Free Software Foundation. Oracle designates this
0N/A * particular file as subject to the "Classpath" exception as provided
0N/A * by Oracle in the LICENSE file that accompanied this code.
0N/A *
0N/A * This code is distributed in the hope that it will be useful, but WITHOUT
0N/A * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
0N/A * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
0N/A * version 2 for more details (a copy is included in the LICENSE file that
0N/A * accompanied this code).
0N/A *
0N/A * You should have received a copy of the GNU General Public License version
0N/A * 2 along with this work; if not, write to the Free Software Foundation,
2362N/A * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
2362N/A *
2362N/A * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
0N/A * or visit www.oracle.com if you need additional information or have any
0N/A * questions.
0N/A */
0N/A
0N/Apackage java.nio.file;
0N/A
0N/Aimport java.security.BasicPermission;
0N/A
0N/A/**
0N/A * The {@code Permission} class for link creation operations.
0N/A *
0N/A * <p> The following table provides a summary description of what the permission
0N/A * allows, and discusses the risks of granting code the permission.
0N/A *
0N/A * <table border=1 cellpadding=5
0N/A * summary="Table shows permission target name, what the permission allows, and associated risks">
0N/A * <tr>
0N/A * <th>Permission Target Name</th>
0N/A * <th>What the Permission Allows</th>
0N/A * <th>Risks of Allowing this Permission</th>
0N/A * </tr>
0N/A * <tr>
0N/A * <td>hard</td>
0N/A * <td> Ability to add an existing file to a directory. This is sometimes
0N/A * known as creating a link, or hard link. </td>
0N/A * <td> Extreme care should be taken when granting this permission. It allows
0N/A * linking to any file or directory in the file system thus allowing the
0N/A * attacker access to all files. </td>
0N/A * </tr>
0N/A * <tr>
0N/A * <td>symbolic</td>
0N/A * <td> Ability to create symbolic links. </td>
0N/A * <td> Extreme care should be taken when granting this permission. It allows
0N/A * linking to any file or directory in the file system thus allowing the
0N/A * attacker to access to all files. </td>
0N/A * </tr>
0N/A * </table>
0N/A *
0N/A * @since 1.7
0N/A *
0N/A * @see Files#createLink
0N/A * @see Files#createSymbolicLink
0N/A */
0N/Apublic final class LinkPermission extends BasicPermission {
0N/A static final long serialVersionUID = -1441492453772213220L;
0N/A
0N/A private void checkName(String name) {
0N/A if (!name.equals("hard") && !name.equals("symbolic")) {
0N/A throw new IllegalArgumentException("name: " + name);
0N/A }
0N/A }
0N/A
0N/A /**
0N/A * Constructs a {@code LinkPermission} with the specified name.
0N/A *
* @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);
}
}
}