+++ /dev/null
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN""http://www.w3.org/TR/REC-html40/loose.dtd">
-<!--NewPage-->
-<HTML>
-<HEAD>
-<!-- Generated by javadoc on Mon Jun 09 15:53:37 PDT 2003 -->
-<TITLE>
-File (Java AFS API)
-</TITLE>
-<META NAME="keywords" CONTENT="org.openafs.jafs.File,File class">
-<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../stylesheet.css" TITLE="Style">
-</HEAD>
-<SCRIPT>
-function asd()
-{
-parent.document.title="File (Java AFS API)";
-}
-</SCRIPT>
-<BODY BGCOLOR="white" onload="asd();">
-
-<!-- ========== START OF NAVBAR ========== -->
-<A NAME="navbar_top"><!-- --></A>
-<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
-<TR>
-<TD COLSPAN=3 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
-<A NAME="navbar_top_firstrow"><!-- --></A>
-<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
- <TR ALIGN="center" VALIGN="top">
- <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
- <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
- <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/File.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD>
- <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
- <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
- <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
- <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
- </TR>
-</TABLE>
-</TD>
-<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
-<B>JAFS API v2</B></EM>
-</TD>
-</TR>
-
-<TR>
-<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
- <A HREF="../../../org/openafs/jafs/ErrorTable.html"><B>PREV CLASS</B></A>
- <A HREF="../../../org/openafs/jafs/FileInputStream.html"><B>NEXT CLASS</B></A></FONT></TD>
-<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
- <A HREF="../../../index.html" TARGET="_top"><B>FRAMES</B></A>
- <A HREF="File.html" TARGET="_top"><B>NO FRAMES</B></A>
-
-<SCRIPT>
- <!--
- if(window==top) {
- document.writeln('<A HREF="../../../allclasses-noframe.html" TARGET=""><B>All Classes</B></A>');
- }
- //-->
-</SCRIPT>
-<NOSCRIPT>
-<A HREF="../../../allclasses-noframe.html" TARGET=""><B>All Classes</B></A>
-</NOSCRIPT>
-</FONT></TD>
-</TR>
-<TR>
-<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
- SUMMARY: NESTED | <A HREF="#fields_inherited_from_class_java.io.File">FIELD</A> | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD>
-<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
-DETAIL: FIELD | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD>
-</TR>
-</TABLE>
-<!-- =========== END OF NAVBAR =========== -->
-
-<HR>
-<!-- ======== START OF CLASS DATA ======== -->
-<H2>
-<FONT SIZE="-1">
-org.openafs.jafs</FONT>
-<BR>
-Class File</H2>
-<PRE>
-<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html">java.lang.Object</A>
- |
- +--<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html">java.io.File</A>
- |
- +--<B>org.openafs.jafs.File</B>
-</PRE>
-<DL>
-<DT><B>All Implemented Interfaces:</B> <DD><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Comparable.html">Comparable</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/Serializable.html">Serializable</A></DD>
-</DL>
-<HR>
-<DL>
-<DT>public class <B>File</B><DT>extends <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html">File</A><DT>implements <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Comparable.html">Comparable</A></DL>
-
-<P>
-An abstract representation of AFS file and directory pathnames.
-
- This class is an extension of the standard Java File class with file-based
- manipulation methods overridden by integrated AFS native methods.
-
- <p> Extension methods include:
-
- <ol>
- <li> <code><A HREF="../../../org/openafs/jafs/File.html#isMountPoint()"><CODE>isMountPoint()</CODE></A></code>
- <li> <code><A HREF="../../../org/openafs/jafs/File.html#isLink()"><CODE>isLink()</CODE></A></code>
- <li> <code><A HREF="../../../org/openafs/jafs/File.html#isValidated()"><CODE>isValidated()</CODE></A></code>
- <li> <code><A HREF="../../../org/openafs/jafs/File.html#validate()"><CODE>validate()</CODE></A></code>
- <li> <code><A HREF="../../../org/openafs/jafs/File.html#refresh()"><CODE>refresh()</CODE></A></code>
- <li> <code><A HREF="../../../org/openafs/jafs/File.html#getErrorCode()"><CODE>getErrorCode()</CODE></A></code>
- <li> <code><A HREF="../../../org/openafs/jafs/File.html#getErrorMessage()"><CODE>getErrorMessage()</CODE></A></code>
- </ol>
-
- <p> For performance optimization, all newly constructed <code>File</code>
- objects are only validated once. Furthermore, if an abstract pathname
- denotes a symbolic-link, then the <A HREF="../../../org/openafs/jafs/File.html#isLink()"><CODE>isLink()</CODE></A> attribute is set
- to true and the <A HREF="../../../org/openafs/jafs/File.html#getTarget()"><CODE>getTarget()</CODE></A> field member is populated with
- this symbolic-link's target resource. (see <A HREF="../../../org/openafs/jafs/File.html#getTarget()"><CODE>getTarget()</CODE></A>)
-
- <p> If you are interested in validating the target resource, simply
- call <A HREF="../../../org/openafs/jafs/File.html#validate()"><CODE>validate()</CODE></A> before calling any of the attribute accessors.
- This action will <code>stat</code> the target resource, identifying
- its associated attributes and populating them in this objects field
- members.
-
- <p> Following is an example of how to construct a new AFS File Object:
- <p><blockquote><pre>
- try {
- File file = new File("/afs/mycell.com/proj/");
- if (file.isDirectory()) {
- System.out.println("This is a directory.");
- } else if (file.isLink()) {
- System.out.println("This is a symbolic-link.");
- System.out.println(" Its target is: " + file.getTarget());
- file.validate();
- if (file.isFile()) {
- System.out.println(" This object is now a file!");
- } else if (file.isDirectory()) {
- System.out.println(" This object is now a directory!");
- } else if (file.isMountPoint()) {
- System.out.println(" This object is now a volume mount point!");
- }
- } else if (file.isMountPoint()) {
- System.out.println("This is a volume mount point.");
- } else if (file.isFile()) {
- System.out.println("This is file.");
- System.out.println(" its size is: " + file.length());
- }
- } catch (AFSFileException ae) {
- System.out.println("AFS Exception: " + ae.getMessage());
- System.out.println("AFS Error Code: " + ae.getErrorCode());
- } catch (Exception e) {
- System.out.println("Exception: " + e.getMessage());
- e.printStackTrace();
- }
- </pre></blockquote>
-<P>
-
-<P>
-<DL>
-<DT><B>Version:</B></DT>
- <DD>2.0, 04/16/2001 - Completely revised class for efficiency., 1.3, 10/12/2000 - Introduced error code capture from native methods., 1.2, 05/30/2000</DD>
-<DT><B>See Also:</B><DD><A HREF="../../../serialized-form.html" TARGET="org.openafs.jafs.File">Serialized Form</A></DL>
-<HR>
-
-<P>
-<!-- ======== NESTED CLASS SUMMARY ======== -->
-
-
-<!-- =========== FIELD SUMMARY =========== -->
-
-<A NAME="field_summary"><!-- --></A>
-<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
-<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
-<TD COLSPAN=2><FONT SIZE="+2">
-<B>Field Summary</B></FONT></TD>
-</TR>
-</TABLE>
- <A NAME="fields_inherited_from_class_java.io.File"><!-- --></A>
-<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
-<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
-<TD><B>Fields inherited from class java.io.<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html">File</A></B></TD>
-</TR>
-<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#pathSeparator">pathSeparator</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#pathSeparatorChar">pathSeparatorChar</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#separator">separator</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#separatorChar">separatorChar</A></CODE></TD>
-</TR>
-</TABLE>
-
-<!-- ======== CONSTRUCTOR SUMMARY ======== -->
-
-<A NAME="constructor_summary"><!-- --></A>
-<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
-<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
-<TD COLSPAN=2><FONT SIZE="+2">
-<B>Constructor Summary</B></FONT></TD>
-</TR>
-<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#File(org.openafs.jafs.File, java.lang.String)">File</A></B>(<A HREF="../../../org/openafs/jafs/File.html">File</A> parent,
- <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> filename)</CODE>
-
-<BR>
- Creates a new <code>File</code> instance from a parent abstract
- pathname and a child pathname string and validates it against the file system.
-
- </TD>
-</TR>
-<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#File(org.openafs.jafs.File, java.lang.String, boolean)">File</A></B>(<A HREF="../../../org/openafs/jafs/File.html">File</A> parent,
- <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> filename,
- boolean validate)</CODE>
-
-<BR>
- Creates a new <code>File</code> instance from a parent abstract
- pathname and a child pathname string.
-
- </TD>
-</TR>
-<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#File(java.lang.String)">File</A></B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> pathname)</CODE>
-
-<BR>
- Creates a new <code>File</code> instance by converting the given
- pathname string into an abstract pathname and validating it against
- the file system. </TD>
-</TR>
-<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#File(java.lang.String, boolean)">File</A></B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> pathname,
- boolean validate)</CODE>
-
-<BR>
- Creates a new <code>File</code> instance by converting the given
- pathname string into an abstract pathname. </TD>
-</TR>
-<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#File(java.lang.String, java.lang.String)">File</A></B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> parent,
- <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> filename)</CODE>
-
-<BR>
- Creates a new <code>File</code> instance from a parent pathname string
- and a child pathname string and validates it against the file system.
-
- </TD>
-</TR>
-<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#File(java.lang.String, java.lang.String, boolean)">File</A></B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> parent,
- <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> filename,
- boolean validate)</CODE>
-
-<BR>
- Creates a new <code>File</code> instance from a parent pathname string
- and a child pathname string.
-
- </TD>
-</TR>
-</TABLE>
-
-<!-- ========== METHOD SUMMARY =========== -->
-
-<A NAME="method_summary"><!-- --></A>
-<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
-<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
-<TD COLSPAN=2><FONT SIZE="+2">
-<B>Method Summary</B></FONT></TD>
-</TR>
-<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
-<CODE> boolean</CODE></FONT></TD>
-<TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#canAdmin()">canAdmin</A></B>()</CODE>
-
-<BR>
- Tests whether the user can administer the ACL (see: <A HREF="../../../org/openafs/jafs/ACL.html"><CODE>ACL</CODE></A>
- of the directory denoted by this abstract pathname.</TD>
-</TR>
-<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
-<CODE> boolean</CODE></FONT></TD>
-<TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#canDelete()">canDelete</A></B>()</CODE>
-
-<BR>
- Tests whether the current user can delete the files or subdirectories of
- the directory denoted by this abstract pathname.</TD>
-</TR>
-<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
-<CODE> boolean</CODE></FONT></TD>
-<TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#canInsert()">canInsert</A></B>()</CODE>
-
-<BR>
- Tests whether the current user can insert a file into the directory
- denoted by this abstract pathname.</TD>
-</TR>
-<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
-<CODE> boolean</CODE></FONT></TD>
-<TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#canLock()">canLock</A></B>()</CODE>
-
-<BR>
- Tests whether the current user can lock the file denoted by this
- abstract pathname.</TD>
-</TR>
-<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
-<CODE> boolean</CODE></FONT></TD>
-<TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#canLookup()">canLookup</A></B>()</CODE>
-
-<BR>
- Tests whether the current user can lookup the contents of the directory
- denoted by this abstract pathname.</TD>
-</TR>
-<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
-<CODE> boolean</CODE></FONT></TD>
-<TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#canRead()">canRead</A></B>()</CODE>
-
-<BR>
- Tests whether the current user can read the file denoted by this
- abstract pathname.</TD>
-</TR>
-<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
-<CODE> boolean</CODE></FONT></TD>
-<TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#canWrite()">canWrite</A></B>()</CODE>
-
-<BR>
- Tests whether the current user can modify to the file denoted by this
- abstract pathname.</TD>
-</TR>
-<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
-<CODE> boolean</CODE></FONT></TD>
-<TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#close()">close</A></B>()</CODE>
-
-<BR>
- Closes the directory denoted by this abstract pathname.</TD>
-</TR>
-<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
-<CODE> int</CODE></FONT></TD>
-<TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#compareTo(org.openafs.jafs.File)">compareTo</A></B>(<A HREF="../../../org/openafs/jafs/File.html">File</A> file)</CODE>
-
-<BR>
- Compares two File objects relative to their filenames and <B>does not</B>
- compare their respective absolute paths. </TD>
-</TR>
-<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
-<CODE> int</CODE></FONT></TD>
-<TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#compareTo(java.lang.Object)">compareTo</A></B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html">Object</A> o)</CODE>
-
-<BR>
- Compares this file to another File object. </TD>
-</TR>
-<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
-<CODE> boolean</CODE></FONT></TD>
-<TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#copyTo(org.openafs.jafs.File)">copyTo</A></B>(<A HREF="../../../org/openafs/jafs/File.html">File</A> dest)</CODE>
-
-<BR>
- Copies the file denoted by this abstract pathname to the destination
- file provided. </TD>
-</TR>
-<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
-<CODE> boolean</CODE></FONT></TD>
-<TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#delete()">delete</A></B>()</CODE>
-
-<BR>
- Deletes the file or directory denoted by this abstract pathname. </TD>
-</TR>
-<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
-<CODE> boolean</CODE></FONT></TD>
-<TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#exists()">exists</A></B>()</CODE>
-
-<BR>
- Tests whether the file denoted by this abstract pathname exists.</TD>
-</TR>
-<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
-<CODE> int</CODE></FONT></TD>
-<TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#getErrorCode()">getErrorCode</A></B>()</CODE>
-
-<BR>
- Returns the AFS specific error number (code). </TD>
-</TR>
-<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
-<CODE> <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A></CODE></FONT></TD>
-<TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#getErrorMessage()">getErrorMessage</A></B>()</CODE>
-
-<BR>
- Returns the AFS error message string defined by the <code><A HREF="../../../org/openafs/jafs/ErrorTable.html"><CODE>ErrorTable</CODE></A></code>
- class.</TD>
-</TR>
-<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
-<CODE> int</CODE></FONT></TD>
-<TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#getPermissionsMask()">getPermissionsMask</A></B>()</CODE>
-
-<BR>
- Returns the permissions mask of the ACL for this object relative to the user accessing it.</TD>
-</TR>
-<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
-<CODE> <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A></CODE></FONT></TD>
-<TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#getTarget()">getTarget</A></B>()</CODE>
-
-<BR>
- Returns an abstract pathname string that represents the target resource of
- of this file, if it is a symbolic-link.
-
- </TD>
-</TR>
-<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
-<CODE> boolean</CODE></FONT></TD>
-<TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#isDirectory()">isDirectory</A></B>()</CODE>
-
-<BR>
- Tests whether the file denoted by this abstract pathname is a
- directory.</TD>
-</TR>
-<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
-<CODE> boolean</CODE></FONT></TD>
-<TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#isFile()">isFile</A></B>()</CODE>
-
-<BR>
- Tests whether the file denoted by this abstract pathname is a normal
- file. </TD>
-</TR>
-<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
-<CODE> boolean</CODE></FONT></TD>
-<TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#isLink()">isLink</A></B>()</CODE>
-
-<BR>
- Tests whether the file denoted by this abstract pathname is a
- symbolic-link.</TD>
-</TR>
-<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
-<CODE> boolean</CODE></FONT></TD>
-<TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#isMountPoint()">isMountPoint</A></B>()</CODE>
-
-<BR>
- Tests whether the file denoted by this abstract pathname is an
- AFS Volume Mount Point.</TD>
-</TR>
-<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
-<CODE> boolean</CODE></FONT></TD>
-<TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#isValidated()">isValidated</A></B>()</CODE>
-
-<BR>
- Tests whether the file denoted by this abstract pathname has
- been validated.
-
- </TD>
-</TR>
-<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
-<CODE> long</CODE></FONT></TD>
-<TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#lastModified()">lastModified</A></B>()</CODE>
-
-<BR>
- Returns the time that the file denoted by this abstract pathname was
- last modified.</TD>
-</TR>
-<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
-<CODE> long</CODE></FONT></TD>
-<TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#length()">length</A></B>()</CODE>
-
-<BR>
- Returns the length of the file denoted by this abstract pathname.</TD>
-</TR>
-<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
-<CODE> <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>[]</CODE></FONT></TD>
-<TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#list()">list</A></B>()</CODE>
-
-<BR>
- Returns an array of strings naming the files and directories in the
- directory denoted by this abstract pathname.
-
- </TD>
-</TR>
-<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
-<CODE> <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/util/ArrayList.html">ArrayList</A></CODE></FONT></TD>
-<TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#listArray()">listArray</A></B>()</CODE>
-
-<BR>
- Returns an ArrayList object containing strings naming the files and
- directories in the directory denoted by this abstract pathname.
-
- </TD>
-</TR>
-<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
-<CODE> boolean</CODE></FONT></TD>
-<TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#mkdir()">mkdir</A></B>()</CODE>
-
-<BR>
- Creates the directory named by this abstract pathname.</TD>
-</TR>
-<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
-<CODE> void</CODE></FONT></TD>
-<TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#refresh()">refresh</A></B>()</CODE>
-
-<BR>
- Refreshes this AFS file object by updating its attributes.
- </TD>
-</TR>
-<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
-<CODE> boolean</CODE></FONT></TD>
-<TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#renameTo(org.openafs.jafs.File)">renameTo</A></B>(<A HREF="../../../org/openafs/jafs/File.html">File</A> dest)</CODE>
-
-<BR>
- Renames the file denoted by this abstract pathname.</TD>
-</TR>
-<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
-<CODE> boolean</CODE></FONT></TD>
-<TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#setAttributes()">setAttributes</A></B>()</CODE>
-
-<BR>
- Performs a file <code>stat</code> on the actual AFS file and populates
- this object's respective field members with the appropriate values.
- </TD>
-</TR>
-<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
-<CODE> void</CODE></FONT></TD>
-<TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#validate()">validate</A></B>()</CODE>
-
-<BR>
- Validates this abstract pathname as an attributed AFS file object.
- </TD>
-</TR>
-</TABLE>
- <A NAME="methods_inherited_from_class_java.io.File"><!-- --></A>
-<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
-<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
-<TD><B>Methods inherited from class java.io.<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html">File</A></B></TD>
-</TR>
-<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#compareTo(java.io.File)">compareTo</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#createNewFile()">createNewFile</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#createTempFile(java.lang.String, java.lang.String)">createTempFile</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#createTempFile(java.lang.String, java.lang.String, java.io.File)">createTempFile</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#deleteOnExit()">deleteOnExit</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#equals(java.lang.Object)">equals</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#getAbsoluteFile()">getAbsoluteFile</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#getAbsolutePath()">getAbsolutePath</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#getCanonicalFile()">getCanonicalFile</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#getCanonicalPath()">getCanonicalPath</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#getName()">getName</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#getParent()">getParent</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#getParentFile()">getParentFile</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#getPath()">getPath</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#hashCode()">hashCode</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#isAbsolute()">isAbsolute</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#isHidden()">isHidden</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#list(java.io.FilenameFilter)">list</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#listFiles()">listFiles</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#listFiles(java.io.FileFilter)">listFiles</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#listFiles(java.io.FilenameFilter)">listFiles</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#listRoots()">listRoots</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#mkdirs()">mkdirs</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#renameTo(java.io.File)">renameTo</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#setLastModified(long)">setLastModified</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#setReadOnly()">setReadOnly</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#toString()">toString</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#toURI()">toURI</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#toURL()">toURL</A></CODE></TD>
-</TR>
-</TABLE>
- <A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
-<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
-<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
-<TD><B>Methods inherited from class java.lang.<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html">Object</A></B></TD>
-</TR>
-<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#clone()">clone</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#finalize()">finalize</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#getClass()">getClass</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#notify()">notify</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#notifyAll()">notifyAll</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#wait()">wait</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#wait(long)">wait</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#wait(long, int)">wait</A></CODE></TD>
-</TR>
-</TABLE>
-
-<P>
-
-<!-- ============ FIELD DETAIL =========== -->
-
-
-<!-- ========= CONSTRUCTOR DETAIL ======== -->
-
-<A NAME="constructor_detail"><!-- --></A>
-<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
-<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
-<TD COLSPAN=1><FONT SIZE="+2">
-<B>Constructor Detail</B></FONT></TD>
-</TR>
-</TABLE>
-
-<A NAME="File(java.lang.String)"><!-- --></A><H3>
-File</H3>
-<PRE>
-public <B>File</B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> pathname)
- throws <A HREF="../../../org/openafs/jafs/AFSFileException.html">AFSFileException</A></PRE>
-<DL>
-<DD>Creates a new <code>File</code> instance by converting the given
- pathname string into an abstract pathname and validating it against
- the file system. If the given string is an empty string, then the
- result is the empty abstract pathname; otherwise the abstract pathname
- is <code>validated</code> to represent a qualified file object.
-<P>
-<DT><B>Parameters:</B><DD><CODE>pathname</CODE> - A pathname string
-<DT><B>Throws:</B>
-<DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/NullPointerException.html">NullPointerException</A></CODE> - If the <code>pathname</code> argument is <code>null</code>
-<DD><CODE><A HREF="../../../org/openafs/jafs/AFSFileException.html">AFSFileException</A></CODE> - If the user constructing this AFS file object is denied
- access to stat the file or simply a stat cannot be performed
- on the file. The reason code and message will be available
- from <A HREF="../../../org/openafs/jafs/AFSFileException.html#getErrorCode()"><CODE>AFSFileException.getErrorCode()</CODE></A> and
- <A HREF="../../../org/openafs/jafs/AFSFileException.html#getMessage()"><CODE>AFSFileException.getMessage()</CODE></A> respectively.
- <p> This exception <U>will not</U> be thrown if the file does not
- exist. Rather, the <A HREF="../../../org/openafs/jafs/File.html#exists()"><CODE>exists()</CODE></A> attribute will be set to
- <code>false</code>.<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/File.html#validate()"><CODE>validate()</CODE></A></DL>
-<HR>
-
-<A NAME="File(java.lang.String, boolean)"><!-- --></A><H3>
-File</H3>
-<PRE>
-public <B>File</B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> pathname,
- boolean validate)</PRE>
-<DL>
-<DD>Creates a new <code>File</code> instance by converting the given
- pathname string into an abstract pathname. If the given string is
- an empty string, then the result is the empty abstract pathname.
-
- <p> The abstract pathname will remain <B>abstract</B> unless the
- <code>validate</code> parameter is set to <code>true</code>. This
- means that the abstract pathname will <U>not</U> be <code>validated</code>
- and therefore the file object will not represent a qualified, attributed,
- AFS file resource. Rather, this constructor provides a method by which
- you can construct a non-validated <code>File</code> object (one that
- does not contain the file's complete status information).
-
- <p> This constructor is useful for creating file objects of file/path names
- that you know exist, however are unauthorized to <code>validate</code> (or
- <code>stat</code> - to obtain complete status information). For example,
- if you are permitted to <code>lookup</code> (see: <A HREF="../../../org/openafs/jafs/File.html#canLookup()"><CODE>canLookup()</CODE></A>) the
- contents of a given directory yet <U>not</U> permitted to <code>read</code>
- (see: <A HREF="../../../org/openafs/jafs/File.html#canRead()"><CODE>canRead()</CODE></A>), then this constructor would enable you to render the
- contents of the directory without validating each entry.
-
- <p> <B>Please note:</B> this is the only constructor that does not throw an AFSFileException.
-<P>
-<DT><B>Parameters:</B><DD><CODE>pathname</CODE> - A pathname string<DD><CODE>validate</CODE> - A boolean flag to indicate if this abstract path
- should be validated.
-<DT><B>Throws:</B>
-<DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/NullPointerException.html">NullPointerException</A></CODE> - If the <code>pathname</code> argument is <code>null</code><DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/File.html#File(java.lang.String)"><CODE>File(String)</CODE></A>,
-<A HREF="../../../org/openafs/jafs/File.html#validate()"><CODE>validate()</CODE></A></DL>
-<HR>
-
-<A NAME="File(java.lang.String, java.lang.String)"><!-- --></A><H3>
-File</H3>
-<PRE>
-public <B>File</B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> parent,
- <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> filename)
- throws <A HREF="../../../org/openafs/jafs/AFSFileException.html">AFSFileException</A></PRE>
-<DL>
-<DD>Creates a new <code>File</code> instance from a parent pathname string
- and a child pathname string and validates it against the file system.
-
- <p> If <code>parent</code> is <code>null</code> then the new
- <code>File</code> instance is created as if by invoking the
- single-argument <code>File</code> constructor on the given
- <code>filename</code> string (child pathname).
-
- <p> Otherwise the <code>parent</code> pathname string is taken to denote
- a directory, and the <code>filename</code> string is taken to
- denote either a directory or a file. The directory or file will then be
- <code>validated</code> to represent a qualified file object.
-<P>
-<DT><B>Parameters:</B><DD><CODE>parent</CODE> - The parent pathname string<DD><CODE>filename</CODE> - This file's pathname string (child of specified parent)
-<DT><B>Throws:</B>
-<DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/NullPointerException.html">NullPointerException</A></CODE> - If <code>child</code> is <code>null</code>
-<DD><CODE><A HREF="../../../org/openafs/jafs/AFSFileException.html">AFSFileException</A></CODE> - If the user constructing this AFS file object is denied
- access to stat the file or simply a stat cannot be performed
- on the file. The reason code and message will be available
- from <A HREF="../../../org/openafs/jafs/AFSFileException.html#getErrorCode()"><CODE>AFSFileException.getErrorCode()</CODE></A> and
- <A HREF="../../../org/openafs/jafs/AFSFileException.html#getMessage()"><CODE>AFSFileException.getMessage()</CODE></A> respectively.
- <p> This exception <U>will not</U> be thrown if the file does not
- exist. Rather, the <A HREF="../../../org/openafs/jafs/File.html#exists()"><CODE>exists()</CODE></A> attribute will be set to
- <code>false</code>.<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/File.html#validate()"><CODE>validate()</CODE></A></DL>
-<HR>
-
-<A NAME="File(java.lang.String, java.lang.String, boolean)"><!-- --></A><H3>
-File</H3>
-<PRE>
-public <B>File</B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> parent,
- <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> filename,
- boolean validate)
- throws <A HREF="../../../org/openafs/jafs/AFSFileException.html">AFSFileException</A></PRE>
-<DL>
-<DD>Creates a new <code>File</code> instance from a parent pathname string
- and a child pathname string.
-
- <p> If <code>parent</code> is <code>null</code> then the new
- <code>File</code> instance is created as if by invoking the
- single-argument <code>File</code> constructor on the given
- <code>filename</code> string (child pathname).
-
- <p> Otherwise the <code>parent</code> pathname string is taken to denote
- a directory, and the <code>filename</code> string is taken to
- denote either a directory or a file.
-
- <p> The abstract pathname will remain <B>abstract</B> unless the
- <code>validate</code> parameter is set to <code>true</code>. This
- means that the abstract pathname will <U>not</U> be <code>validated</code>
- and therefore the file object will not represent a qualified, attributed,
- AFS file resource. Rather, this constructor provides a method by which
- you can construct a non-validated <code>File</code> object (one that
- does not contain the file's complete status information).
-
- <p> This constructor is useful for creating file objects of file/path names
- that you know exist, however are unauthorized to <code>validate</code> (or
- <code>stat</code> - to obtain complete status information). For example,
- if you are permitted to <code>lookup</code> (see: <A HREF="../../../org/openafs/jafs/File.html#canLookup()"><CODE>canLookup()</CODE></A>) the
- contents of a given directory yet <U>not</U> permitted to <code>read</code>
- (see: <A HREF="../../../org/openafs/jafs/File.html#canRead()"><CODE>canRead()</CODE></A>), then this constructor would enable you to render the
- contents of the directory without validating each entry.
-<P>
-<DT><B>Parameters:</B><DD><CODE>parent</CODE> - The parent pathname string<DD><CODE>filename</CODE> - This file's pathname string (child of specified parent)<DD><CODE>validate</CODE> - A boolean flag to indicate if this abstract path
- should be validated.
-<DT><B>Throws:</B>
-<DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/NullPointerException.html">NullPointerException</A></CODE> - If <code>child</code> is <code>null</code>
-<DD><CODE><A HREF="../../../org/openafs/jafs/AFSFileException.html">AFSFileException</A></CODE> - If the user constructing this AFS file object is denied
- access to stat the file or simply a stat cannot be performed
- on the file. The reason code and message will be available
- from <A HREF="../../../org/openafs/jafs/AFSFileException.html#getErrorCode()"><CODE>AFSFileException.getErrorCode()</CODE></A> and
- <A HREF="../../../org/openafs/jafs/AFSFileException.html#getMessage()"><CODE>AFSFileException.getMessage()</CODE></A> respectively.
- <p> This exception <U>will not</U> be thrown if the file does not
- exist. Rather, the <A HREF="../../../org/openafs/jafs/File.html#exists()"><CODE>exists()</CODE></A> attribute will be set to
- <code>false</code>.<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/File.html#File(java.lang.String, java.lang.String)"><CODE>File(String, String)</CODE></A>,
-<A HREF="../../../org/openafs/jafs/File.html#validate()"><CODE>validate()</CODE></A></DL>
-<HR>
-
-<A NAME="File(org.openafs.jafs.File, java.lang.String)"><!-- --></A><H3>
-File</H3>
-<PRE>
-public <B>File</B>(<A HREF="../../../org/openafs/jafs/File.html">File</A> parent,
- <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> filename)
- throws <A HREF="../../../org/openafs/jafs/AFSFileException.html">AFSFileException</A></PRE>
-<DL>
-<DD>Creates a new <code>File</code> instance from a parent abstract
- pathname and a child pathname string and validates it against the file system.
-
- <p> If <code>parent</code> is <code>null</code> then the new
- <code>File</code> instance is created as if by invoking the
- single-argument <code>File</code> constructor on the given
- <code>filename</code> string (child pathname).
-
- <p> Otherwise the <code>parent</code> abstract pathname is taken to
- denote a directory, and the <code>filename</code> string is taken
- to denote either a directory or a file. The directory or file will then be
- <code>validated</code> to represent a qualified file object.
-<P>
-<DT><B>Parameters:</B><DD><CODE>parent</CODE> - The parent abstract pathname<DD><CODE>filename</CODE> - This file's pathname string (child of specified parent)
-<DT><B>Throws:</B>
-<DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/NullPointerException.html">NullPointerException</A></CODE> - If <code>child</code> is <code>null</code>
-<DD><CODE><A HREF="../../../org/openafs/jafs/AFSFileException.html">AFSFileException</A></CODE> - If the user constructing this AFS file object is denied
- access to stat the file or simply a stat cannot be performed
- on the file. The reason code and message will be available
- from <A HREF="../../../org/openafs/jafs/AFSFileException.html#getErrorCode()"><CODE>AFSFileException.getErrorCode()</CODE></A> and
- <A HREF="../../../org/openafs/jafs/AFSFileException.html#getMessage()"><CODE>AFSFileException.getMessage()</CODE></A> respectively.
- <p> This exception <U>will not</U> be thrown if the file does not
- exist. Rather, the <A HREF="../../../org/openafs/jafs/File.html#exists()"><CODE>exists()</CODE></A> attribute will be set to
- <code>false</code>.<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/File.html#validate()"><CODE>validate()</CODE></A></DL>
-<HR>
-
-<A NAME="File(org.openafs.jafs.File, java.lang.String, boolean)"><!-- --></A><H3>
-File</H3>
-<PRE>
-public <B>File</B>(<A HREF="../../../org/openafs/jafs/File.html">File</A> parent,
- <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> filename,
- boolean validate)
- throws <A HREF="../../../org/openafs/jafs/AFSFileException.html">AFSFileException</A></PRE>
-<DL>
-<DD>Creates a new <code>File</code> instance from a parent abstract
- pathname and a child pathname string.
-
- <p> If <code>parent</code> is <code>null</code> then the new
- <code>File</code> instance is created as if by invoking the
- single-argument <code>File</code> constructor on the given
- <code>filename</code> string (child pathname).
-
- <p> Otherwise the <code>parent</code> abstract pathname is taken to
- denote a directory, and the <code>filename</code> string is taken
- to denote either a directory or a file.
-
- <p> The abstract pathname will remain <B>abstract</B> unless the
- <code>validate</code> parameter is set to <code>true</code>. This
- means that the abstract pathname will <U>not</U> be <code>validated</code>
- and therefore the file object will not represent a qualified, attributed,
- AFS file resource. Rather, this constructor provides a method by which
- you can construct a non-validated <code>File</code> object (one that
- does not contain the file's complete status information).
-
- <p> This constructor is useful for creating file objects of file/path names
- that you know exist, however are unauthorized to <code>validate</code> (or
- <code>stat</code> - to obtain complete status information). For example,
- if you are permitted to <code>lookup</code> (see: <A HREF="../../../org/openafs/jafs/File.html#canLookup()"><CODE>canLookup()</CODE></A>) the
- contents of a given directory yet <U>not</U> permitted to <code>read</code>
- (see: <A HREF="../../../org/openafs/jafs/File.html#canRead()"><CODE>canRead()</CODE></A>), then this constructor would enable you to render the
- contents of the directory without validating each entry.
-<P>
-<DT><B>Parameters:</B><DD><CODE>parent</CODE> - The parent abstract pathname<DD><CODE>filename</CODE> - This file's pathname string (child of specified parent)<DD><CODE>validate</CODE> - A boolean flag to indicate if this abstract path
- should be validated.
-<DT><B>Throws:</B>
-<DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/NullPointerException.html">NullPointerException</A></CODE> - If <code>child</code> is <code>null</code>
-<DD><CODE><A HREF="../../../org/openafs/jafs/AFSFileException.html">AFSFileException</A></CODE> - If the user constructing this AFS file object is denied
- access to stat the file or simply a stat cannot be performed
- on the file. The reason code and message will be available
- from <A HREF="../../../org/openafs/jafs/AFSFileException.html#getErrorCode()"><CODE>AFSFileException.getErrorCode()</CODE></A> and
- <A HREF="../../../org/openafs/jafs/AFSFileException.html#getMessage()"><CODE>AFSFileException.getMessage()</CODE></A> respectively.
- <p> This exception <U>will not</U> be thrown if the file does not
- exist. Rather, the <A HREF="../../../org/openafs/jafs/File.html#exists()"><CODE>exists()</CODE></A> attribute will be set to
- <code>false</code>.<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/File.html#validate()"><CODE>validate()</CODE></A>,
-<A HREF="../../../org/openafs/jafs/File.html#File(org.openafs.jafs.File, java.lang.String)"><CODE>File(File, String)</CODE></A></DL>
-
-<!-- ============ METHOD DETAIL ========== -->
-
-<A NAME="method_detail"><!-- --></A>
-<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
-<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
-<TD COLSPAN=1><FONT SIZE="+2">
-<B>Method Detail</B></FONT></TD>
-</TR>
-</TABLE>
-
-<A NAME="validate()"><!-- --></A><H3>
-validate</H3>
-<PRE>
-public void <B>validate</B>()
- throws <A HREF="../../../org/openafs/jafs/AFSSecurityException.html">AFSSecurityException</A></PRE>
-<DL>
-<DD>Validates this abstract pathname as an attributed AFS file object.
- This method will, if authorized, perform a <code>stat</code> on the
- actual AFS file and update its respective field members; defining
- this file object's attributes.
-<P>
-<DD><DL>
-</DL>
-</DD>
-<DD><DL>
-
-<DT><B>Throws:</B>
-<DD><CODE><A HREF="../../../org/openafs/jafs/AFSSecurityException.html">AFSSecurityException</A></CODE> - If an AFS exception occurs while attempting to stat and set this
- AFS file object's attributes.</DL>
-</DD>
-</DL>
-<HR>
-
-<A NAME="isValidated()"><!-- --></A><H3>
-isValidated</H3>
-<PRE>
-public boolean <B>isValidated</B>()</PRE>
-<DL>
-<DD>Tests whether the file denoted by this abstract pathname has
- been validated.
-
- <P> Validation is always attempted upon construction of the file object,
- therefore if this method returns false, then you are not permitted to
- <code>validate</code> this file and consequently all attribute accessors
- will be invalid.
-
- <P> This method should return <code>true</code> even if this abstract
- pathname does not exist. If this is abstract pathname does not exist then
- the <code><A HREF="../../../org/openafs/jafs/File.html#exists()"><CODE>exists()</CODE></A></code> method should return false, however this
- implies that the attribute accessors are valid and accurate; thus implying
- successful validation.
-
- <P> This method is useful before calling any of the attribute accessors
- to ensure a valid response.
-<P>
-<DD><DL>
-</DL>
-</DD>
-<DD><DL>
-
-<DT><B>Returns:</B><DD><code>true</code> if and only if the file denoted by this
- abstract pathname has been validated during or after object construction;
- <code>false</code> otherwise</DL>
-</DD>
-</DL>
-<HR>
-
-<A NAME="refresh()"><!-- --></A><H3>
-refresh</H3>
-<PRE>
-public void <B>refresh</B>()
- throws <A HREF="../../../org/openafs/jafs/AFSSecurityException.html">AFSSecurityException</A></PRE>
-<DL>
-<DD>Refreshes this AFS file object by updating its attributes.
- This method currently provides the same functionality as
- <A HREF="../../../org/openafs/jafs/File.html#validate()"><CODE>validate()</CODE></A>.
-<P>
-<DD><DL>
-</DL>
-</DD>
-<DD><DL>
-
-<DT><B>Throws:</B>
-<DD><CODE><A HREF="../../../org/openafs/jafs/AFSSecurityException.html">AFSSecurityException</A></CODE> - If an AFS exception occurs while attempting to stat and update this
- AFS file object's attributes.<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/File.html#validate()"><CODE>validate()</CODE></A></DL>
-</DD>
-</DL>
-<HR>
-
-<A NAME="isDirectory()"><!-- --></A><H3>
-isDirectory</H3>
-<PRE>
-public boolean <B>isDirectory</B>()</PRE>
-<DL>
-<DD>Tests whether the file denoted by this abstract pathname is a
- directory.
-<P>
-<DD><DL>
-<DT><B>Overrides:</B><DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#isDirectory()">isDirectory</A></CODE> in class <CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html">File</A></CODE></DL>
-</DD>
-<DD><DL>
-
-<DT><B>Returns:</B><DD><code>true</code> if and only if the file denoted by this
- abstract pathname exists <em>and</em> is a directory;
- <code>false</code> otherwise</DL>
-</DD>
-</DL>
-<HR>
-
-<A NAME="isFile()"><!-- --></A><H3>
-isFile</H3>
-<PRE>
-public boolean <B>isFile</B>()</PRE>
-<DL>
-<DD>Tests whether the file denoted by this abstract pathname is a normal
- file. A file is <em>normal</em> if it is not a directory and, in
- addition, satisfies other system-dependent criteria. Any non-directory
- file created by a Java application is guaranteed to be a normal file.
-<P>
-<DD><DL>
-<DT><B>Overrides:</B><DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#isFile()">isFile</A></CODE> in class <CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html">File</A></CODE></DL>
-</DD>
-<DD><DL>
-
-<DT><B>Returns:</B><DD><code>true</code> if and only if the file denoted by this
- abstract pathname exists <em>and</em> is a normal file;
- <code>false</code> otherwise</DL>
-</DD>
-</DL>
-<HR>
-
-<A NAME="isMountPoint()"><!-- --></A><H3>
-isMountPoint</H3>
-<PRE>
-public boolean <B>isMountPoint</B>()</PRE>
-<DL>
-<DD>Tests whether the file denoted by this abstract pathname is an
- AFS Volume Mount Point.
-<P>
-<DD><DL>
-</DL>
-</DD>
-<DD><DL>
-
-<DT><B>Returns:</B><DD><code>true</code> if and only if the file denoted by this
- abstract pathname exists <em>and</em> is a mount point;
- <code>false</code> otherwise</DL>
-</DD>
-</DL>
-<HR>
-
-<A NAME="isLink()"><!-- --></A><H3>
-isLink</H3>
-<PRE>
-public boolean <B>isLink</B>()</PRE>
-<DL>
-<DD>Tests whether the file denoted by this abstract pathname is a
- symbolic-link.
-<P>
-<DD><DL>
-</DL>
-</DD>
-<DD><DL>
-
-<DT><B>Returns:</B><DD><code>true</code> if and only if the file denoted by this
- abstract pathname exists <em>and</em> is a symbolic-link;
- <code>false</code> otherwise</DL>
-</DD>
-</DL>
-<HR>
-
-<A NAME="exists()"><!-- --></A><H3>
-exists</H3>
-<PRE>
-public boolean <B>exists</B>()</PRE>
-<DL>
-<DD>Tests whether the file denoted by this abstract pathname exists.
-<P>
-<DD><DL>
-<DT><B>Overrides:</B><DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#exists()">exists</A></CODE> in class <CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html">File</A></CODE></DL>
-</DD>
-<DD><DL>
-
-<DT><B>Returns:</B><DD><code>true</code> if and only if the file denoted by this
- abstract pathname exists; <code>false</code> otherwise</DL>
-</DD>
-</DL>
-<HR>
-
-<A NAME="lastModified()"><!-- --></A><H3>
-lastModified</H3>
-<PRE>
-public long <B>lastModified</B>()</PRE>
-<DL>
-<DD>Returns the time that the file denoted by this abstract pathname was
- last modified.
-<P>
-<DD><DL>
-<DT><B>Overrides:</B><DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#lastModified()">lastModified</A></CODE> in class <CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html">File</A></CODE></DL>
-</DD>
-<DD><DL>
-
-<DT><B>Returns:</B><DD>A <code>long</code> value representing the time the file was
- last modified, measured in milliseconds since the epoch
- (00:00:00 GMT, January 1, 1970), or <code>0L</code> if the
- file does not exist or if an I/O error occurs</DL>
-</DD>
-</DL>
-<HR>
-
-<A NAME="length()"><!-- --></A><H3>
-length</H3>
-<PRE>
-public long <B>length</B>()</PRE>
-<DL>
-<DD>Returns the length of the file denoted by this abstract pathname.
-<P>
-<DD><DL>
-<DT><B>Overrides:</B><DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#length()">length</A></CODE> in class <CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html">File</A></CODE></DL>
-</DD>
-<DD><DL>
-
-<DT><B>Returns:</B><DD>The length, in bytes, of the file denoted by this abstract
- pathname, or <code>0L</code> if the file does not exist</DL>
-</DD>
-</DL>
-<HR>
-
-<A NAME="getTarget()"><!-- --></A><H3>
-getTarget</H3>
-<PRE>
-public <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> <B>getTarget</B>()</PRE>
-<DL>
-<DD>Returns an abstract pathname string that represents the target resource of
- of this file, if it is a symbolic-link.
-
- <p> If this abstract pathname <B>does not</B> denote a symbolic-link, then this
- method returns <code>null</code>. Otherwise a string is
- returned that represents the target resource of this symbolic-link.
-<P>
-<DD><DL>
-</DL>
-</DD>
-<DD><DL>
-
-<DT><B>Returns:</B><DD>A string representation of this symbolic-link's target resource.<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/File.html#isLink()"><CODE>isLink()</CODE></A></DL>
-</DD>
-</DL>
-<HR>
-
-<A NAME="list()"><!-- --></A><H3>
-list</H3>
-<PRE>
-public <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>[] <B>list</B>()</PRE>
-<DL>
-<DD>Returns an array of strings naming the files and directories in the
- directory denoted by this abstract pathname.
-
- <p> If this abstract pathname does not denote a directory, then this
- method returns <code>null</code>. Otherwise an array of strings is
- returned, one for each file or directory in the directory. Names
- denoting the directory itself and the directory's parent directory are
- not included in the result. Each string is a file name rather than a
- complete path.
-
- <p> There is no guarantee that the name strings in the resulting array
- will appear in any specific order; they are not, in particular,
- guaranteed to appear in alphabetical order.
-<P>
-<DD><DL>
-<DT><B>Overrides:</B><DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#list()">list</A></CODE> in class <CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html">File</A></CODE></DL>
-</DD>
-<DD><DL>
-
-<DT><B>Returns:</B><DD>An array of strings naming the files and directories in the
- directory denoted by this abstract pathname. The array will be
- empty if the directory is empty. Returns <code>null</code> if
- this abstract pathname does not denote a directory, or if an
- I/O error occurs.</DL>
-</DD>
-</DL>
-<HR>
-
-<A NAME="listArray()"><!-- --></A><H3>
-listArray</H3>
-<PRE>
-public <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/util/ArrayList.html">ArrayList</A> <B>listArray</B>()
- throws <A HREF="../../../org/openafs/jafs/AFSFileException.html">AFSFileException</A></PRE>
-<DL>
-<DD>Returns an ArrayList object containing strings naming the files and
- directories in the directory denoted by this abstract pathname.
-
- <p> If this abstract pathname does not denote a directory, then this
- method returns <code>null</code>. Otherwise an array of strings is
- returned, one for each file or directory in the directory. Names
- denoting the directory itself and the directory's parent directory are
- not included in the result. Each string is a file name rather than a
- complete path.
-
- <p> There is no guarantee that the name strings in the resulting array
- will appear in any specific order; they are not, in particular,
- guaranteed to appear in alphabetical order.
-<P>
-<DD><DL>
-</DL>
-</DD>
-<DD><DL>
-
-<DT><B>Returns:</B><DD>An array of strings naming the files and directories in the
- directory denoted by this abstract pathname. The array will be
- empty if the directory is empty. Returns <code>null</code> if
- this abstract pathname does not denote a directory, or if an
- I/O error occurs.
-<DT><B>Throws:</B>
-<DD><CODE><A HREF="../../../org/openafs/jafs/AFSSecurityException.html">AFSSecurityException</A></CODE> - If you are not authorized to list the contents of this directory
-<DD><CODE><A HREF="../../../org/openafs/jafs/AFSFileException.html">AFSFileException</A></CODE> - If this file object is not a <code>mount point</code>, <code>link
- </code>, or <code>directory</code> <B>or</B> an unexpected AFS
- error occurs.<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/File.html#list()"><CODE>list()</CODE></A></DL>
-</DD>
-</DL>
-<HR>
-
-<A NAME="delete()"><!-- --></A><H3>
-delete</H3>
-<PRE>
-public boolean <B>delete</B>()</PRE>
-<DL>
-<DD>Deletes the file or directory denoted by this abstract pathname. If
- this pathname denotes a directory, then the directory must be empty in
- order to be deleted.
-<P>
-<DD><DL>
-<DT><B>Overrides:</B><DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#delete()">delete</A></CODE> in class <CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html">File</A></CODE></DL>
-</DD>
-<DD><DL>
-
-<DT><B>Returns:</B><DD><code>true</code> if and only if the file or directory is
- successfully deleted; <code>false</code> otherwise</DL>
-</DD>
-</DL>
-<HR>
-
-<A NAME="copyTo(org.openafs.jafs.File)"><!-- --></A><H3>
-copyTo</H3>
-<PRE>
-public boolean <B>copyTo</B>(<A HREF="../../../org/openafs/jafs/File.html">File</A> dest)
- throws <A HREF="../../../org/openafs/jafs/AFSFileException.html">AFSFileException</A></PRE>
-<DL>
-<DD>Copies the file denoted by this abstract pathname to the destination
- file provided. Then checks the newly copied file's size to
- test for file size consistency.
-<P>
-<DD><DL>
-</DL>
-</DD>
-<DD><DL>
-<DT><B>Parameters:</B><DD><CODE>dest</CODE> - The new abstract pathname for the named file
-<DT><B>Returns:</B><DD><code>true</code> if and only if the file that was copied
- reports the same file size (length) as that of this file;
- <code>false</code> otherwise
-<DT><B>Throws:</B>
-<DD><CODE><A HREF="../../../org/openafs/jafs/AFSFileException.html">AFSFileException</A></CODE> - If an I/O or AFS exception is encountered while copying the file.</DL>
-</DD>
-</DL>
-<HR>
-
-<A NAME="getPermissionsMask()"><!-- --></A><H3>
-getPermissionsMask</H3>
-<PRE>
-public int <B>getPermissionsMask</B>()</PRE>
-<DL>
-<DD>Returns the permissions mask of the ACL for this object relative to the user accessing it.
-<P>
-<DD><DL>
-</DL>
-</DD>
-<DD><DL>
-
-<DT><B>Returns:</B><DD>the permissions mask of this object based upon the current user.<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/ACL.Entry.html#getPermissionsMask()"><CODE>ACL.Entry.getPermissionsMask()</CODE></A></DL>
-</DD>
-</DL>
-<HR>
-
-<A NAME="canAdmin()"><!-- --></A><H3>
-canAdmin</H3>
-<PRE>
-public boolean <B>canAdmin</B>()</PRE>
-<DL>
-<DD>Tests whether the user can administer the ACL (see: <A HREF="../../../org/openafs/jafs/ACL.html"><CODE>ACL</CODE></A>
- of the directory denoted by this abstract pathname.
-<P>
-<DD><DL>
-</DL>
-</DD>
-<DD><DL>
-
-<DT><B>Returns:</B><DD><code>true</code> if and only if the directory specified by this
- abstract pathname exists <em>and</em> can be administered by the
- current user; <code>false</code> otherwise<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/ACL.Entry.html#canAdmin()"><CODE>ACL.Entry.canAdmin()</CODE></A></DL>
-</DD>
-</DL>
-<HR>
-
-<A NAME="canDelete()"><!-- --></A><H3>
-canDelete</H3>
-<PRE>
-public boolean <B>canDelete</B>()</PRE>
-<DL>
-<DD>Tests whether the current user can delete the files or subdirectories of
- the directory denoted by this abstract pathname.
-<P>
-<DD><DL>
-</DL>
-</DD>
-<DD><DL>
-
-<DT><B>Returns:</B><DD><code>true</code> if and only if the directory specified by this
- abstract pathname exists <em>and</em> permits deletion of its files
- and subdirectories by the current user; <code>false</code> otherwise<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/ACL.Entry.html#canDelete()"><CODE>ACL.Entry.canDelete()</CODE></A></DL>
-</DD>
-</DL>
-<HR>
-
-<A NAME="canInsert()"><!-- --></A><H3>
-canInsert</H3>
-<PRE>
-public boolean <B>canInsert</B>()</PRE>
-<DL>
-<DD>Tests whether the current user can insert a file into the directory
- denoted by this abstract pathname.
-<P>
-<DD><DL>
-</DL>
-</DD>
-<DD><DL>
-
-<DT><B>Returns:</B><DD><code>true</code> if and only if the directory specified by this
- abstract pathname exists <em>and</em> a file can be inserted by the
- current user; <code>false</code> otherwise<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/ACL.Entry.html#canInsert()"><CODE>ACL.Entry.canInsert()</CODE></A></DL>
-</DD>
-</DL>
-<HR>
-
-<A NAME="canLock()"><!-- --></A><H3>
-canLock</H3>
-<PRE>
-public boolean <B>canLock</B>()</PRE>
-<DL>
-<DD>Tests whether the current user can lock the file denoted by this
- abstract pathname.
-<P>
-<DD><DL>
-</DL>
-</DD>
-<DD><DL>
-
-<DT><B>Returns:</B><DD><code>true</code> if and only if the file specified by this
- abstract pathname exists <em>and</em> can be locked by the
- current user; <code>false</code> otherwise<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/ACL.Entry.html#canLock()"><CODE>ACL.Entry.canLock()</CODE></A></DL>
-</DD>
-</DL>
-<HR>
-
-<A NAME="canLookup()"><!-- --></A><H3>
-canLookup</H3>
-<PRE>
-public boolean <B>canLookup</B>()</PRE>
-<DL>
-<DD>Tests whether the current user can lookup the contents of the directory
- denoted by this abstract pathname.
-<P>
-<DD><DL>
-</DL>
-</DD>
-<DD><DL>
-
-<DT><B>Returns:</B><DD><code>true</code> if and only if the directory specified by this
- abstract pathname exists <em>and</em> its contents can be listed by the
- current user; <code>false</code> otherwise<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/ACL.Entry.html#canLookup()"><CODE>ACL.Entry.canLookup()</CODE></A></DL>
-</DD>
-</DL>
-<HR>
-
-<A NAME="canRead()"><!-- --></A><H3>
-canRead</H3>
-<PRE>
-public boolean <B>canRead</B>()</PRE>
-<DL>
-<DD>Tests whether the current user can read the file denoted by this
- abstract pathname.
-<P>
-<DD><DL>
-<DT><B>Overrides:</B><DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#canRead()">canRead</A></CODE> in class <CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html">File</A></CODE></DL>
-</DD>
-<DD><DL>
-
-<DT><B>Returns:</B><DD><code>true</code> if and only if the file specified by this
- abstract pathname exists <em>and</em> can be read by the
- current user; <code>false</code> otherwise<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/ACL.Entry.html#canRead()"><CODE>ACL.Entry.canRead()</CODE></A></DL>
-</DD>
-</DL>
-<HR>
-
-<A NAME="canWrite()"><!-- --></A><H3>
-canWrite</H3>
-<PRE>
-public boolean <B>canWrite</B>()</PRE>
-<DL>
-<DD>Tests whether the current user can modify to the file denoted by this
- abstract pathname.
-<P>
-<DD><DL>
-<DT><B>Overrides:</B><DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#canWrite()">canWrite</A></CODE> in class <CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html">File</A></CODE></DL>
-</DD>
-<DD><DL>
-
-<DT><B>Returns:</B><DD><code>true</code> if and only if the file system actually
- contains a file denoted by this abstract pathname <em>and</em>
- the current user is allowed to write to the file;
- <code>false</code> otherwise.<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/ACL.Entry.html#canWrite()"><CODE>ACL.Entry.canWrite()</CODE></A></DL>
-</DD>
-</DL>
-<HR>
-
-<A NAME="close()"><!-- --></A><H3>
-close</H3>
-<PRE>
-public boolean <B>close</B>()</PRE>
-<DL>
-<DD>Closes the directory denoted by this abstract pathname.
-<P>
-<DD><DL>
-</DL>
-</DD>
-<DD><DL>
-
-<DT><B>Returns:</B><DD><code>true</code> if and only if the directory is
- successfully closed; <code>false</code> otherwise</DL>
-</DD>
-</DL>
-<HR>
-
-<A NAME="getErrorCode()"><!-- --></A><H3>
-getErrorCode</H3>
-<PRE>
-public int <B>getErrorCode</B>()</PRE>
-<DL>
-<DD>Returns the AFS specific error number (code). This code can be interpreted
- by use of <code><A HREF="../../../org/openafs/jafs/ErrorTable.html"><CODE>ErrorTable</CODE></A></code> static class method
- <code><A HREF="../../../org/openafs/jafs/ErrorTable.html#getMessage(int)"><CODE>ErrorTable.getMessage(int)</CODE></A></code>
-<P>
-<DD><DL>
-</DL>
-</DD>
-<DD><DL>
-
-<DT><B>Returns:</B><DD>the AFS error code (number) associated with the last action performed
- on this object.<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/ErrorTable.html#getMessage(int)"><CODE>ErrorTable.getMessage(int)</CODE></A></DL>
-</DD>
-</DL>
-<HR>
-
-<A NAME="getErrorMessage()"><!-- --></A><H3>
-getErrorMessage</H3>
-<PRE>
-public <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> <B>getErrorMessage</B>()</PRE>
-<DL>
-<DD>Returns the AFS error message string defined by the <code><A HREF="../../../org/openafs/jafs/ErrorTable.html"><CODE>ErrorTable</CODE></A></code>
- class.
-<P>
-<DD><DL>
-</DL>
-</DD>
-<DD><DL>
-
-<DT><B>Returns:</B><DD>the AFS error message string associated with the last action performed
- on this object.<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/ErrorTable.html#getMessage(int)"><CODE>ErrorTable.getMessage(int)</CODE></A></DL>
-</DD>
-</DL>
-<HR>
-
-<A NAME="compareTo(org.openafs.jafs.File)"><!-- --></A><H3>
-compareTo</H3>
-<PRE>
-public int <B>compareTo</B>(<A HREF="../../../org/openafs/jafs/File.html">File</A> file)</PRE>
-<DL>
-<DD>Compares two File objects relative to their filenames and <B>does not</B>
- compare their respective absolute paths. Alphabetic case is significant in
- comparing filenames.
-<P>
-<DD><DL>
-</DL>
-</DD>
-<DD><DL>
-<DT><B>Parameters:</B><DD><CODE>file</CODE> - The File object to be compared to this file's filename
-<DT><B>Returns:</B><DD>Zero if the argument is equal to this file's filename, a
- value less than zero if this file's filename is
- lexicographically less than the argument, or a value greater
- than zero if this file's filename is lexicographically
- greater than the argument<DT><B>Since:</B></DT>
- <DD>JDK1.2</DD>
-</DL>
-</DD>
-</DL>
-<HR>
-
-<A NAME="compareTo(java.lang.Object)"><!-- --></A><H3>
-compareTo</H3>
-<PRE>
-public int <B>compareTo</B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html">Object</A> o)
- throws <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/ClassCastException.html">ClassCastException</A></PRE>
-<DL>
-<DD>Compares this file to another File object. If the other object
- is an abstract pathname, then this function behaves like <code><A HREF="../../../org/openafs/jafs/File.html#compareTo(org.openafs.jafs.File)"><CODE>compareTo(File)</CODE></A></code>. Otherwise, it throws a
- <code>ClassCastException</code>, since File objects can only be
- compared to File objects.
-<P>
-<DD><DL>
-<DT><B>Specified by:</B><DD><CODE>compareTo</CODE> in interface <CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Comparable.html">Comparable</A></CODE><DT><B>Overrides:</B><DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#compareTo(java.lang.Object)">compareTo</A></CODE> in class <CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html">File</A></CODE></DL>
-</DD>
-<DD><DL>
-<DT><B>Parameters:</B><DD><CODE>o</CODE> - The <code>Object</code> to be compared to this abstract pathname
-<DT><B>Returns:</B><DD>If the argument is an File object, returns zero
- if the argument is equal to this file's filename, a value
- less than zero if this file's filename is lexicographically
- less than the argument, or a value greater than zero if this
- file's filename is lexicographically greater than the
- argument
-<DT><B>Throws:</B>
-<DD><CODE><code>ClassCastException</code></CODE> - if the argument is not an
- File object
-<DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/ClassCastException.html">ClassCastException</A></CODE><DT><B>Since:</B></DT>
- <DD>JDK1.2</DD>
-<DT><B>See Also:</B><DD><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Comparable.html"><CODE>Comparable</CODE></A></DL>
-</DD>
-</DL>
-<HR>
-
-<A NAME="mkdir()"><!-- --></A><H3>
-mkdir</H3>
-<PRE>
-public boolean <B>mkdir</B>()</PRE>
-<DL>
-<DD>Creates the directory named by this abstract pathname.
-<P>
-<DD><DL>
-<DT><B>Overrides:</B><DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html#mkdir()">mkdir</A></CODE> in class <CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html">File</A></CODE></DL>
-</DD>
-<DD><DL>
-
-<DT><B>Returns:</B><DD><code>true</code> if and only if the directory was
- created; <code>false</code> otherwise</DL>
-</DD>
-</DL>
-<HR>
-
-<A NAME="renameTo(org.openafs.jafs.File)"><!-- --></A><H3>
-renameTo</H3>
-<PRE>
-public boolean <B>renameTo</B>(<A HREF="../../../org/openafs/jafs/File.html">File</A> dest)</PRE>
-<DL>
-<DD>Renames the file denoted by this abstract pathname.
-<P>
-<DD><DL>
-</DL>
-</DD>
-<DD><DL>
-<DT><B>Parameters:</B><DD><CODE>dest</CODE> - The new abstract pathname for the named file
-<DT><B>Returns:</B><DD><code>true</code> if and only if the renaming succeeded;
- <code>false</code> otherwise
-<DT><B>Throws:</B>
-<DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/NullPointerException.html">NullPointerException</A></CODE> - If parameter <code>dest</code> is <code>null</code></DL>
-</DD>
-</DL>
-<HR>
-
-<A NAME="setAttributes()"><!-- --></A><H3>
-setAttributes</H3>
-<PRE>
-public boolean <B>setAttributes</B>()
- throws <A HREF="../../../org/openafs/jafs/AFSSecurityException.html">AFSSecurityException</A></PRE>
-<DL>
-<DD>Performs a file <code>stat</code> on the actual AFS file and populates
- this object's respective field members with the appropriate values.
- method will, if authorized, perform a <code>stat</code> on the
- actual AFS file and update its respective field members; defining
- this file object's attributes.
-
- <P><B>This method should not be used directly for refreshing or validating
- this AFS file object. Please use <A HREF="../../../org/openafs/jafs/File.html#validate()"><CODE>validate()</CODE></A> instead.</B>
-<P>
-<DD><DL>
-</DL>
-</DD>
-<DD><DL>
-
-<DT><B>Returns:</B><DD><code>true</code> if and only if the current user is allowed to stat the file;
- <code>false</code> otherwise.
-<DD><CODE><A HREF="../../../org/openafs/jafs/AFSSecurityException.html">AFSSecurityException</A></CODE><DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/File.html#validate()"><CODE>validate()</CODE></A></DL>
-</DD>
-</DL>
-<!-- ========= END OF CLASS DATA ========= -->
-<HR>
-
-<!-- ========== START OF NAVBAR ========== -->
-<A NAME="navbar_bottom"><!-- --></A>
-<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
-<TR>
-<TD COLSPAN=3 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
-<A NAME="navbar_bottom_firstrow"><!-- --></A>
-<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
- <TR ALIGN="center" VALIGN="top">
- <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
- <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
- <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/File.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD>
- <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
- <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
- <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
- <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
- </TR>
-</TABLE>
-</TD>
-<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
-<B>JAFS API v2</B></EM>
-</TD>
-</TR>
-
-<TR>
-<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
- <A HREF="../../../org/openafs/jafs/ErrorTable.html"><B>PREV CLASS</B></A>
- <A HREF="../../../org/openafs/jafs/FileInputStream.html"><B>NEXT CLASS</B></A></FONT></TD>
-<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
- <A HREF="../../../index.html" TARGET="_top"><B>FRAMES</B></A>
- <A HREF="File.html" TARGET="_top"><B>NO FRAMES</B></A>
-
-<SCRIPT>
- <!--
- if(window==top) {
- document.writeln('<A HREF="../../../allclasses-noframe.html" TARGET=""><B>All Classes</B></A>');
- }
- //-->
-</SCRIPT>
-<NOSCRIPT>
-<A HREF="../../../allclasses-noframe.html" TARGET=""><B>All Classes</B></A>
-</NOSCRIPT>
-</FONT></TD>
-</TR>
-<TR>
-<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
- SUMMARY: NESTED | <A HREF="#fields_inherited_from_class_java.io.File">FIELD</A> | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD>
-<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
-DETAIL: FIELD | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD>
-</TR>
-</TABLE>
-<!-- =========== END OF NAVBAR =========== -->
-
-<HR>
-
-</BODY>
-</HTML>
git://git.openafs.org / openafs-wiki.git / blobdiff