jdk-sandbox: comparison jdk/src/share/classes/java/io/File.java

equal deleted inserted replaced

-:b124faa29aef
+:ce5ab758aeb5
 /*
-* Copyright (c) 1994, 2011, Oracle and/or its affiliates. All rights reserved.
+* Copyright (c) 1994, 2012, Oracle and/or its affiliates. All rights reserved.
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
 *
 * This code is free software; you can redistribute it and/or modify it
 * under the terms of the GNU General Public License version 2 only, as
 * published by the Free Software Foundation.  Oracle designates this
 /* -- Attribute accessors -- */
 /**
 * Tests whether the application can read the file denoted by this
-* abstract pathname.
+* abstract pathname. On some platforms it may be possible to start the
+* Java virtual machine with special privileges that allow it to read
+* files that are marked as unreadable. Consequently this method may return
+* {@code true} even though the file does not have read permissions.
 *
 * @return  <code>true</code> if and only if the file specified by this
 *          abstract pathname exists <em>and</em> can be read by the
 *          application; <code>false</code> otherwise
 *
 return fs.checkAccess(this, FileSystem.ACCESS_READ);
 }
 /**
 * Tests whether the application can modify the file denoted by this
-* abstract pathname.
+* abstract pathname. On some platforms it may be possible to start the
+* Java virtual machine with special privileges that allow it to modify
+* files that are marked read-only. Consequently this method may return
+* {@code true} even though the file is marked read-only.
 *
 * @return  <code>true</code> if and only if the file system actually
 *          contains a file denoted by this abstract pathname <em>and</em>
 *          the application is allowed to write to the file;
 *          <code>false</code> otherwise.
 return fs.setLastModifiedTime(this, time);
 }
 /**
 * Marks the file or directory named by this abstract pathname so that
-* only read operations are allowed.  After invoking this method the file
+* only read operations are allowed. After invoking this method the file
-* or directory is guaranteed not to change until it is either deleted or
+* or directory will not change until it is either deleted or marked
-* marked to allow write access.  Whether or not a read-only file or
+* to allow write access. On some platforms it may be possible to start the
+* Java virtual machine with special privileges that allow it to modify
+* files that are marked read-only. Whether or not a read-only file or
 * directory may be deleted depends upon the underlying system.
 *
 * @return <code>true</code> if and only if the operation succeeded;
 *          <code>false</code> otherwise
 *
 return fs.setReadOnly(this);
 }
 /**
 * Sets the owner's or everybody's write permission for this abstract
-* pathname.
+* pathname. On some platforms it may be possible to start the Java virtual
+* machine with special privileges that allow it to modify files that
+* disallow write operations.
 *
 * <p> The {@link java.nio.file.Files} class defines methods that operate on
 * file attributes including file permissions. This may be used when finer
 * manipulation of file permissions is required.
 *
 return fs.setPermission(this, FileSystem.ACCESS_WRITE, writable, ownerOnly);
 }
 /**
 * A convenience method to set the owner's write permission for this abstract
-* pathname.
+* pathname. On some platforms it may be possible to start the Java virtual
+* machine with special privileges that allow it to modify files that
+* disallow write operations.
 *
 * <p> An invocation of this method of the form <tt>file.setWritable(arg)</tt>
 * behaves in exactly the same way as the invocation
 *
 * <pre>
 return setWritable(writable, true);
 }
 /**
 * Sets the owner's or everybody's read permission for this abstract
-* pathname.
+* pathname. On some platforms it may be possible to start the Java virtual
+* machine with special privileges that allow it to read files that are
+* marked as unreadable.
 *
 * <p> The {@link java.nio.file.Files} class defines methods that operate on
 * file attributes including file permissions. This may be used when finer
 * manipulation of file permissions is required.
 *
 return fs.setPermission(this, FileSystem.ACCESS_READ, readable, ownerOnly);
 }
 /**
 * A convenience method to set the owner's read permission for this abstract
-* pathname.
+* pathname. On some platforms it may be possible to start the Java virtual
+* machine with special privileges that allow it to read files that that are
+* marked as unreadable.
 *
 * <p>An invocation of this method of the form <tt>file.setReadable(arg)</tt>
 * behaves in exactly the same way as the invocation
 *
 * <pre>
 return setReadable(readable, true);
 }
 /**
 * Sets the owner's or everybody's execute permission for this abstract
-* pathname.
+* pathname. On some platforms it may be possible to start the Java virtual
+* machine with special privileges that allow it to execute files that are
+* not marked executable.
 *
 * <p> The {@link java.nio.file.Files} class defines methods that operate on
 * file attributes including file permissions. This may be used when finer
 * manipulation of file permissions is required.
 *
 }
 return fs.setPermission(this, FileSystem.ACCESS_EXECUTE, executable, ownerOnly);
 }
 /**
-* A convenience method to set the owner's execute permission for this abstract
+* A convenience method to set the owner's execute permission for this
-* pathname.
+* abstract pathname. On some platforms it may be possible to start the Java
+* virtual machine with special privileges that allow it to execute files
+* that are not marked executable.
 *
 * <p>An invocation of this method of the form <tt>file.setExcutable(arg)</tt>
 * behaves in exactly the same way as the invocation
 *
 * <pre>
 return setExecutable(executable, true);
 }
 /**
 * Tests whether the application can execute the file denoted by this
-* abstract pathname.
+* abstract pathname. On some platforms it may be possible to start the
+* Java virtual machine with special privileges that allow it to execute
+* files that are not marked executable. Consequently this method may return
+* {@code true} even though the file does not have execute permissions.
 *
 * @return  <code>true</code> if and only if the abstract pathname exists
 *          <em>and</em> the application is allowed to execute the file
 *
 * @throws  SecurityException

changeset 13568	ce5ab758aeb5
parent 11907	c021db66251d
child 14324	3510b4bf90ee