JavaAdminAPI/File.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN""http://www.w3.org/TR/REC-html40/loose.dtd">
   2 <!--NewPage-->
   3 <HTML>
   4 <HEAD>
   5 <!-- Generated by javadoc on Mon Jun 09 15:53:37 PDT 2003 -->
   6 <TITLE>
   7 File (Java AFS API)
   8 </TITLE>
   9 <META NAME="keywords" CONTENT="org.openafs.jafs.File,File class">
  10 <LINK REL ="stylesheet" TYPE="text/css" HREF="../../../stylesheet.css" TITLE="Style">
  11 </HEAD>
  12 <SCRIPT>
  13 function asd()
  14 {
  15 parent.document.title="File (Java AFS API)";
  16 }
  17 </SCRIPT>
  18 <BODY BGCOLOR="white" onload="asd();">
  19
  20 <!-- ========== START OF NAVBAR ========== -->
  21 <A NAME="navbar_top"><!-- --></A>
  22 <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
  23 <TR>
  24 <TD COLSPAN=3 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
  25 <A NAME="navbar_top_firstrow"><!-- --></A>
  26 <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
  27   <TR ALIGN="center" VALIGN="top">
  28   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
  29   <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
  30   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/File.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
  31   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
  32   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
  33   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
  34   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
  35   </TR>
  36 </TABLE>
  37 </TD>
  38 <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
  39 <B>JAFS API v2</B></EM>
  40 </TD>
  41 </TR>
  42
  43 <TR>
  44 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  45 &nbsp;<A HREF="../../../org/openafs/jafs/ErrorTable.html"><B>PREV CLASS</B></A>&nbsp;
  46 &nbsp;<A HREF="../../../org/openafs/jafs/FileInputStream.html"><B>NEXT CLASS</B></A></FONT></TD>
  47 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  48   <A HREF="../../../index.html" TARGET="_top"><B>FRAMES</B></A>  &nbsp;
  49 &nbsp;<A HREF="File.html" TARGET="_top"><B>NO FRAMES</B></A>  &nbsp;
  50 &nbsp;
  51 <SCRIPT>
  52   <!--
  53   if(window==top) {
  54     document.writeln('<A HREF="../../../allclasses-noframe.html" TARGET=""><B>All Classes</B></A>');
  55   }
  56   //-->
  57 </SCRIPT>
  58 <NOSCRIPT>
  59 <A HREF="../../../allclasses-noframe.html" TARGET=""><B>All Classes</B></A>
  60 </NOSCRIPT>
  61 </FONT></TD>
  62 </TR>
  63 <TR>
  64 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  65   SUMMARY:&nbsp;NESTED&nbsp;|&nbsp;<A HREF="#fields_inherited_from_class_java.io.File">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
  66 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  67 DETAIL:&nbsp;FIELD&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
  68 </TR>
  69 </TABLE>
  70 <!-- =========== END OF NAVBAR =========== -->
  71
  72 <HR>
  73 <!-- ======== START OF CLASS DATA ======== -->
  74 <H2>
  75 <FONT SIZE="-1">
  76 org.openafs.jafs</FONT>
  77 <BR>
  78 Class File</H2>
  79 <PRE>
  80 <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html">java.lang.Object</A>
  81   |
  82   +--<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/File.html">java.io.File</A>
  83         |
  84         +--<B>org.openafs.jafs.File</B>
  85 </PRE>
  86 <DL>
  87 <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>
  88 </DL>
  89 <HR>
  90 <DL>
  91 <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>
  92
  93 <P>
  94 An abstract representation of AFS file and directory pathnames.
  95
  96  This class is an extension of the standard Java File class with file-based
  97  manipulation methods overridden by integrated AFS native methods.
  98
  99  <p> Extension methods include:
 100
 101  <ol>
 102  <li> <code><A HREF="../../../org/openafs/jafs/File.html#isMountPoint()"><CODE>isMountPoint()</CODE></A></code>
 103  <li> <code><A HREF="../../../org/openafs/jafs/File.html#isLink()"><CODE>isLink()</CODE></A></code>
 104  <li> <code><A HREF="../../../org/openafs/jafs/File.html#isValidated()"><CODE>isValidated()</CODE></A></code>
 105  <li> <code><A HREF="../../../org/openafs/jafs/File.html#validate()"><CODE>validate()</CODE></A></code>
 106  <li> <code><A HREF="../../../org/openafs/jafs/File.html#refresh()"><CODE>refresh()</CODE></A></code>
 107  <li> <code><A HREF="../../../org/openafs/jafs/File.html#getErrorCode()"><CODE>getErrorCode()</CODE></A></code>
 108  <li> <code><A HREF="../../../org/openafs/jafs/File.html#getErrorMessage()"><CODE>getErrorMessage()</CODE></A></code>
 109  </ol>
 110
 111  <p> For performance optimization, all newly constructed <code>File</code>
 112  objects are only validated once.  Furthermore, if an abstract pathname
 113  denotes a symbolic-link, then the <A HREF="../../../org/openafs/jafs/File.html#isLink()"><CODE>isLink()</CODE></A> attribute is set
 114  to true and the <A HREF="../../../org/openafs/jafs/File.html#getTarget()"><CODE>getTarget()</CODE></A> field member is populated with
 115  this symbolic-link's target resource. (see <A HREF="../../../org/openafs/jafs/File.html#getTarget()"><CODE>getTarget()</CODE></A>)
 116
 117  <p> If you are interested in validating the target resource, simply
 118  call <A HREF="../../../org/openafs/jafs/File.html#validate()"><CODE>validate()</CODE></A> before calling any of the attribute accessors.
 119  This action will <code>stat</code> the target resource, identifying
 120  its associated attributes and populating them in this objects field
 121  members.
 122
 123  <p> Following is an example of how to construct a new AFS File Object:
 124  <p><blockquote><pre>
 125      try {
 126          File file = new File("/afs/mycell.com/proj/");
 127          if (file.isDirectory()) {
 128            System.out.println("This is a directory.");
 129          } else if (file.isLink()) {
 130            System.out.println("This is a symbolic-link.");
 131            System.out.println("  Its target is: " + file.getTarget());
 132            file.validate();
 133            if (file.isFile()) {
 134              System.out.println("  This object is now a file!");
 135            } else if (file.isDirectory()) {
 136              System.out.println("  This object is now a directory!");
 137            } else if (file.isMountPoint()) {
 138              System.out.println("  This object is now a volume mount point!");
 139            }
 140          } else if (file.isMountPoint()) {
 141            System.out.println("This is a volume mount point.");
 142          } else if (file.isFile()) {
 143            System.out.println("This is file.");
 144            System.out.println("  its size is: " + file.length());
 145          }
 146      } catch (AFSFileException ae) {
 147          System.out.println("AFS Exception: " + ae.getMessage());
 148          System.out.println("AFS Error Code: " + ae.getErrorCode());
 149      } catch (Exception e) {
 150          System.out.println("Exception: " + e.getMessage());
 151          e.printStackTrace();
 152      }
 153  </pre></blockquote>
 154 <P>
 155
 156 <P>
 157 <DL>
 158 <DT><B>Version:</B></DT>
 159   <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>
 160 <DT><B>See Also:</B><DD><A HREF="../../../serialized-form.html" TARGET="org.openafs.jafs.File">Serialized Form</A></DL>
 161 <HR>
 162
 163 <P>
 164 <!-- ======== NESTED CLASS SUMMARY ======== -->
 165
 166
 167 <!-- =========== FIELD SUMMARY =========== -->
 168
 169 <A NAME="field_summary"><!-- --></A>
 170 <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
 171 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
 172 <TD COLSPAN=2><FONT SIZE="+2">
 173 <B>Field Summary</B></FONT></TD>
 174 </TR>
 175 </TABLE>
 176 &nbsp;<A NAME="fields_inherited_from_class_java.io.File"><!-- --></A>
 177 <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
 178 <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
 179 <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>
 180 </TR>
 181 <TR BGCOLOR="white" CLASS="TableRowColor">
 182 <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>
 183 </TR>
 184 </TABLE>
 185 &nbsp;
 186 <!-- ======== CONSTRUCTOR SUMMARY ======== -->
 187
 188 <A NAME="constructor_summary"><!-- --></A>
 189 <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
 190 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
 191 <TD COLSPAN=2><FONT SIZE="+2">
 192 <B>Constructor Summary</B></FONT></TD>
 193 </TR>
 194 <TR BGCOLOR="white" CLASS="TableRowColor">
 195 <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>&nbsp;parent,
 196      <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;filename)</CODE>
 197
 198 <BR>
 199 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Creates a new <code>File</code> instance from a parent abstract
 200  pathname and a child pathname string and validates it against the file system.
 201
 202  </TD>
 203 </TR>
 204 <TR BGCOLOR="white" CLASS="TableRowColor">
 205 <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>&nbsp;parent,
 206      <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;filename,
 207      boolean&nbsp;validate)</CODE>
 208
 209 <BR>
 210 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Creates a new <code>File</code> instance from a parent abstract
 211  pathname and a child pathname string.
 212
 213  </TD>
 214 </TR>
 215 <TR BGCOLOR="white" CLASS="TableRowColor">
 216 <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>&nbsp;pathname)</CODE>
 217
 218 <BR>
 219 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Creates a new <code>File</code> instance by converting the given
 220  pathname string into an abstract pathname and validating it against
 221  the file system.  </TD>
 222 </TR>
 223 <TR BGCOLOR="white" CLASS="TableRowColor">
 224 <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>&nbsp;pathname,
 225      boolean&nbsp;validate)</CODE>
 226
 227 <BR>
 228 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Creates a new <code>File</code> instance by converting the given
 229  pathname string into an abstract pathname.  </TD>
 230 </TR>
 231 <TR BGCOLOR="white" CLASS="TableRowColor">
 232 <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>&nbsp;parent,
 233      <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;filename)</CODE>
 234
 235 <BR>
 236 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Creates a new <code>File</code> instance from a parent pathname string
 237  and a child pathname string and validates it against the file system.
 238
 239  </TD>
 240 </TR>
 241 <TR BGCOLOR="white" CLASS="TableRowColor">
 242 <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>&nbsp;parent,
 243      <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;filename,
 244      boolean&nbsp;validate)</CODE>
 245
 246 <BR>
 247 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Creates a new <code>File</code> instance from a parent pathname string
 248  and a child pathname string.
 249
 250  </TD>
 251 </TR>
 252 </TABLE>
 253 &nbsp;
 254 <!-- ========== METHOD SUMMARY =========== -->
 255
 256 <A NAME="method_summary"><!-- --></A>
 257 <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
 258 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
 259 <TD COLSPAN=2><FONT SIZE="+2">
 260 <B>Method Summary</B></FONT></TD>
 261 </TR>
 262 <TR BGCOLOR="white" CLASS="TableRowColor">
 263 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 264 <CODE>&nbsp;boolean</CODE></FONT></TD>
 265 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#canAdmin()">canAdmin</A></B>()</CODE>
 266
 267 <BR>
 268 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Tests whether the user can administer the ACL (see: <A HREF="../../../org/openafs/jafs/ACL.html"><CODE>ACL</CODE></A>
 269  of the directory denoted by this abstract pathname.</TD>
 270 </TR>
 271 <TR BGCOLOR="white" CLASS="TableRowColor">
 272 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 273 <CODE>&nbsp;boolean</CODE></FONT></TD>
 274 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#canDelete()">canDelete</A></B>()</CODE>
 275
 276 <BR>
 277 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Tests whether the current user can delete the files or subdirectories of
 278  the directory denoted by this abstract pathname.</TD>
 279 </TR>
 280 <TR BGCOLOR="white" CLASS="TableRowColor">
 281 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 282 <CODE>&nbsp;boolean</CODE></FONT></TD>
 283 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#canInsert()">canInsert</A></B>()</CODE>
 284
 285 <BR>
 286 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Tests whether the current user can insert a file into the directory
 287  denoted by this abstract pathname.</TD>
 288 </TR>
 289 <TR BGCOLOR="white" CLASS="TableRowColor">
 290 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 291 <CODE>&nbsp;boolean</CODE></FONT></TD>
 292 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#canLock()">canLock</A></B>()</CODE>
 293
 294 <BR>
 295 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Tests whether the current user can lock the file denoted by this
 296  abstract pathname.</TD>
 297 </TR>
 298 <TR BGCOLOR="white" CLASS="TableRowColor">
 299 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 300 <CODE>&nbsp;boolean</CODE></FONT></TD>
 301 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#canLookup()">canLookup</A></B>()</CODE>
 302
 303 <BR>
 304 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Tests whether the current user can lookup the contents of the directory
 305  denoted by this abstract pathname.</TD>
 306 </TR>
 307 <TR BGCOLOR="white" CLASS="TableRowColor">
 308 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 309 <CODE>&nbsp;boolean</CODE></FONT></TD>
 310 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#canRead()">canRead</A></B>()</CODE>
 311
 312 <BR>
 313 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Tests whether the current user can read the file denoted by this
 314  abstract pathname.</TD>
 315 </TR>
 316 <TR BGCOLOR="white" CLASS="TableRowColor">
 317 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 318 <CODE>&nbsp;boolean</CODE></FONT></TD>
 319 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#canWrite()">canWrite</A></B>()</CODE>
 320
 321 <BR>
 322 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Tests whether the current user can modify to the file denoted by this
 323  abstract pathname.</TD>
 324 </TR>
 325 <TR BGCOLOR="white" CLASS="TableRowColor">
 326 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 327 <CODE>&nbsp;boolean</CODE></FONT></TD>
 328 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#close()">close</A></B>()</CODE>
 329
 330 <BR>
 331 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Closes the directory denoted by this abstract pathname.</TD>
 332 </TR>
 333 <TR BGCOLOR="white" CLASS="TableRowColor">
 334 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 335 <CODE>&nbsp;int</CODE></FONT></TD>
 336 <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>&nbsp;file)</CODE>
 337
 338 <BR>
 339 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Compares two File objects relative to their filenames and <B>does not</B>
 340  compare their respective absolute paths.  </TD>
 341 </TR>
 342 <TR BGCOLOR="white" CLASS="TableRowColor">
 343 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 344 <CODE>&nbsp;int</CODE></FONT></TD>
 345 <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>&nbsp;o)</CODE>
 346
 347 <BR>
 348 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Compares this file to another File object.  </TD>
 349 </TR>
 350 <TR BGCOLOR="white" CLASS="TableRowColor">
 351 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 352 <CODE>&nbsp;boolean</CODE></FONT></TD>
 353 <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>&nbsp;dest)</CODE>
 354
 355 <BR>
 356 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Copies the file denoted by this abstract pathname to the destination
 357  file provided.  </TD>
 358 </TR>
 359 <TR BGCOLOR="white" CLASS="TableRowColor">
 360 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 361 <CODE>&nbsp;boolean</CODE></FONT></TD>
 362 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#delete()">delete</A></B>()</CODE>
 363
 364 <BR>
 365 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Deletes the file or directory denoted by this abstract pathname.  </TD>
 366 </TR>
 367 <TR BGCOLOR="white" CLASS="TableRowColor">
 368 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 369 <CODE>&nbsp;boolean</CODE></FONT></TD>
 370 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#exists()">exists</A></B>()</CODE>
 371
 372 <BR>
 373 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Tests whether the file denoted by this abstract pathname exists.</TD>
 374 </TR>
 375 <TR BGCOLOR="white" CLASS="TableRowColor">
 376 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 377 <CODE>&nbsp;int</CODE></FONT></TD>
 378 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#getErrorCode()">getErrorCode</A></B>()</CODE>
 379
 380 <BR>
 381 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the AFS specific error number (code).  </TD>
 382 </TR>
 383 <TR BGCOLOR="white" CLASS="TableRowColor">
 384 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 385 <CODE>&nbsp;<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A></CODE></FONT></TD>
 386 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#getErrorMessage()">getErrorMessage</A></B>()</CODE>
 387
 388 <BR>
 389 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the AFS error message string defined by the <code><A HREF="../../../org/openafs/jafs/ErrorTable.html"><CODE>ErrorTable</CODE></A></code>
 390  class.</TD>
 391 </TR>
 392 <TR BGCOLOR="white" CLASS="TableRowColor">
 393 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 394 <CODE>&nbsp;int</CODE></FONT></TD>
 395 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#getPermissionsMask()">getPermissionsMask</A></B>()</CODE>
 396
 397 <BR>
 398 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the permissions mask of the ACL for this object relative to the user accessing it.</TD>
 399 </TR>
 400 <TR BGCOLOR="white" CLASS="TableRowColor">
 401 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 402 <CODE>&nbsp;<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A></CODE></FONT></TD>
 403 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#getTarget()">getTarget</A></B>()</CODE>
 404
 405 <BR>
 406 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns an abstract pathname string that represents the target resource of
 407  of this file, if it is a symbolic-link.
 408
 409  </TD>
 410 </TR>
 411 <TR BGCOLOR="white" CLASS="TableRowColor">
 412 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 413 <CODE>&nbsp;boolean</CODE></FONT></TD>
 414 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#isDirectory()">isDirectory</A></B>()</CODE>
 415
 416 <BR>
 417 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Tests whether the file denoted by this abstract pathname is a
 418  directory.</TD>
 419 </TR>
 420 <TR BGCOLOR="white" CLASS="TableRowColor">
 421 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 422 <CODE>&nbsp;boolean</CODE></FONT></TD>
 423 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#isFile()">isFile</A></B>()</CODE>
 424
 425 <BR>
 426 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Tests whether the file denoted by this abstract pathname is a normal
 427  file.  </TD>
 428 </TR>
 429 <TR BGCOLOR="white" CLASS="TableRowColor">
 430 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 431 <CODE>&nbsp;boolean</CODE></FONT></TD>
 432 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#isLink()">isLink</A></B>()</CODE>
 433
 434 <BR>
 435 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Tests whether the file denoted by this abstract pathname is a
 436  symbolic-link.</TD>
 437 </TR>
 438 <TR BGCOLOR="white" CLASS="TableRowColor">
 439 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 440 <CODE>&nbsp;boolean</CODE></FONT></TD>
 441 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#isMountPoint()">isMountPoint</A></B>()</CODE>
 442
 443 <BR>
 444 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Tests whether the file denoted by this abstract pathname is an
 445  AFS Volume Mount Point.</TD>
 446 </TR>
 447 <TR BGCOLOR="white" CLASS="TableRowColor">
 448 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 449 <CODE>&nbsp;boolean</CODE></FONT></TD>
 450 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#isValidated()">isValidated</A></B>()</CODE>
 451
 452 <BR>
 453 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Tests whether the file denoted by this abstract pathname has
 454  been validated.
 455
 456  </TD>
 457 </TR>
 458 <TR BGCOLOR="white" CLASS="TableRowColor">
 459 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 460 <CODE>&nbsp;long</CODE></FONT></TD>
 461 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#lastModified()">lastModified</A></B>()</CODE>
 462
 463 <BR>
 464 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the time that the file denoted by this abstract pathname was
 465  last modified.</TD>
 466 </TR>
 467 <TR BGCOLOR="white" CLASS="TableRowColor">
 468 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 469 <CODE>&nbsp;long</CODE></FONT></TD>
 470 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#length()">length</A></B>()</CODE>
 471
 472 <BR>
 473 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the length of the file denoted by this abstract pathname.</TD>
 474 </TR>
 475 <TR BGCOLOR="white" CLASS="TableRowColor">
 476 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 477 <CODE>&nbsp;<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>[]</CODE></FONT></TD>
 478 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#list()">list</A></B>()</CODE>
 479
 480 <BR>
 481 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns an array of strings naming the files and directories in the
 482  directory denoted by this abstract pathname.
 483
 484  </TD>
 485 </TR>
 486 <TR BGCOLOR="white" CLASS="TableRowColor">
 487 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 488 <CODE>&nbsp;<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/util/ArrayList.html">ArrayList</A></CODE></FONT></TD>
 489 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#listArray()">listArray</A></B>()</CODE>
 490
 491 <BR>
 492 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns an ArrayList object containing strings naming the files and
 493  directories in the directory denoted by this abstract pathname.
 494
 495  </TD>
 496 </TR>
 497 <TR BGCOLOR="white" CLASS="TableRowColor">
 498 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 499 <CODE>&nbsp;boolean</CODE></FONT></TD>
 500 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#mkdir()">mkdir</A></B>()</CODE>
 501
 502 <BR>
 503 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Creates the directory named by this abstract pathname.</TD>
 504 </TR>
 505 <TR BGCOLOR="white" CLASS="TableRowColor">
 506 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 507 <CODE>&nbsp;void</CODE></FONT></TD>
 508 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#refresh()">refresh</A></B>()</CODE>
 509
 510 <BR>
 511 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Refreshes this AFS file object by updating its attributes.
 512  </TD>
 513 </TR>
 514 <TR BGCOLOR="white" CLASS="TableRowColor">
 515 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 516 <CODE>&nbsp;boolean</CODE></FONT></TD>
 517 <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>&nbsp;dest)</CODE>
 518
 519 <BR>
 520 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Renames the file denoted by this abstract pathname.</TD>
 521 </TR>
 522 <TR BGCOLOR="white" CLASS="TableRowColor">
 523 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 524 <CODE>&nbsp;boolean</CODE></FONT></TD>
 525 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#setAttributes()">setAttributes</A></B>()</CODE>
 526
 527 <BR>
 528 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Performs a file <code>stat</code> on the actual AFS file and populates
 529  this object's respective field members with the appropriate values.
 530  </TD>
 531 </TR>
 532 <TR BGCOLOR="white" CLASS="TableRowColor">
 533 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 534 <CODE>&nbsp;void</CODE></FONT></TD>
 535 <TD><CODE><B><A HREF="../../../org/openafs/jafs/File.html#validate()">validate</A></B>()</CODE>
 536
 537 <BR>
 538 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Validates this abstract pathname as an attributed AFS file object.
 539  </TD>
 540 </TR>
 541 </TABLE>
 542 &nbsp;<A NAME="methods_inherited_from_class_java.io.File"><!-- --></A>
 543 <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
 544 <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
 545 <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>
 546 </TR>
 547 <TR BGCOLOR="white" CLASS="TableRowColor">
 548 <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>
 549 </TR>
 550 </TABLE>
 551 &nbsp;<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
 552 <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
 553 <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
 554 <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>
 555 </TR>
 556 <TR BGCOLOR="white" CLASS="TableRowColor">
 557 <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>
 558 </TR>
 559 </TABLE>
 560 &nbsp;
 561 <P>
 562
 563 <!-- ============ FIELD DETAIL =========== -->
 564
 565
 566 <!-- ========= CONSTRUCTOR DETAIL ======== -->
 567
 568 <A NAME="constructor_detail"><!-- --></A>
 569 <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
 570 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
 571 <TD COLSPAN=1><FONT SIZE="+2">
 572 <B>Constructor Detail</B></FONT></TD>
 573 </TR>
 574 </TABLE>
 575
 576 <A NAME="File(java.lang.String)"><!-- --></A><H3>
 577 File</H3>
 578 <PRE>
 579 public <B>File</B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;pathname)
 580      throws <A HREF="../../../org/openafs/jafs/AFSFileException.html">AFSFileException</A></PRE>
 581 <DL>
 582 <DD>Creates a new <code>File</code> instance by converting the given
 583  pathname string into an abstract pathname and validating it against
 584  the file system.  If the given string is an empty string, then the
 585  result is the empty abstract pathname; otherwise the abstract pathname
 586  is <code>validated</code> to represent a qualified file object.
 587 <P>
 588 <DT><B>Parameters:</B><DD><CODE>pathname</CODE> - A pathname string
 589 <DT><B>Throws:</B>
 590 <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>
 591 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSFileException.html">AFSFileException</A></CODE> - If the user constructing this AFS file object is denied
 592           access to stat the file or simply a stat cannot be performed
 593           on the file. The reason code and message will be available
 594           from <A HREF="../../../org/openafs/jafs/AFSFileException.html#getErrorCode()"><CODE>AFSFileException.getErrorCode()</CODE></A> and
 595           <A HREF="../../../org/openafs/jafs/AFSFileException.html#getMessage()"><CODE>AFSFileException.getMessage()</CODE></A> respectively.
 596           <p> This exception <U>will not</U> be thrown if the file does not
 597           exist.  Rather, the <A HREF="../../../org/openafs/jafs/File.html#exists()"><CODE>exists()</CODE></A> attribute will be set to
 598           <code>false</code>.<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/File.html#validate()"><CODE>validate()</CODE></A></DL>
 599 <HR>
 600
 601 <A NAME="File(java.lang.String, boolean)"><!-- --></A><H3>
 602 File</H3>
 603 <PRE>
 604 public <B>File</B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;pathname,
 605             boolean&nbsp;validate)</PRE>
 606 <DL>
 607 <DD>Creates a new <code>File</code> instance by converting the given
 608  pathname string into an abstract pathname.  If the given string is
 609  an empty string, then the result is the empty abstract pathname.
 610
 611  <p> The abstract pathname will remain <B>abstract</B> unless the
 612  <code>validate</code> parameter is set to <code>true</code>. This
 613  means that the abstract pathname will <U>not</U> be <code>validated</code>
 614  and therefore the file object will not represent a qualified, attributed,
 615  AFS file resource.  Rather, this constructor provides a method by which
 616  you can construct a non-validated <code>File</code> object (one that
 617  does not contain the file's complete status information).
 618
 619  <p> This constructor is useful for creating file objects of file/path names
 620  that you know exist, however are unauthorized to <code>validate</code> (or
 621  <code>stat</code> - to obtain complete status information). For example,
 622  if you are permitted to <code>lookup</code> (see: <A HREF="../../../org/openafs/jafs/File.html#canLookup()"><CODE>canLookup()</CODE></A>) the
 623  contents of a given directory yet <U>not</U> permitted to <code>read</code>
 624  (see: <A HREF="../../../org/openafs/jafs/File.html#canRead()"><CODE>canRead()</CODE></A>), then this constructor would enable you to render the
 625  contents of the directory without validating each entry.
 626
 627  <p> <B>Please note:</B> this is the only constructor that does not throw an AFSFileException.
 628 <P>
 629 <DT><B>Parameters:</B><DD><CODE>pathname</CODE> - A pathname string<DD><CODE>validate</CODE> - A boolean flag to indicate if this abstract path
 630                                 should be validated.
 631 <DT><B>Throws:</B>
 632 <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>,
 633 <A HREF="../../../org/openafs/jafs/File.html#validate()"><CODE>validate()</CODE></A></DL>
 634 <HR>
 635
 636 <A NAME="File(java.lang.String, java.lang.String)"><!-- --></A><H3>
 637 File</H3>
 638 <PRE>
 639 public <B>File</B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;parent,
 640             <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;filename)
 641      throws <A HREF="../../../org/openafs/jafs/AFSFileException.html">AFSFileException</A></PRE>
 642 <DL>
 643 <DD>Creates a new <code>File</code> instance from a parent pathname string
 644  and a child pathname string and validates it against the file system.
 645
 646  <p> If <code>parent</code> is <code>null</code> then the new
 647  <code>File</code> instance is created as if by invoking the
 648  single-argument <code>File</code> constructor on the given
 649  <code>filename</code> string (child pathname).
 650
 651  <p> Otherwise the <code>parent</code> pathname string is taken to denote
 652  a directory, and the <code>filename</code> string is taken to
 653  denote either a directory or a file. The directory or file will then be
 654  <code>validated</code> to represent a qualified file object.
 655 <P>
 656 <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)
 657 <DT><B>Throws:</B>
 658 <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>
 659 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSFileException.html">AFSFileException</A></CODE> - If the user constructing this AFS file object is denied
 660           access to stat the file or simply a stat cannot be performed
 661           on the file. The reason code and message will be available
 662           from <A HREF="../../../org/openafs/jafs/AFSFileException.html#getErrorCode()"><CODE>AFSFileException.getErrorCode()</CODE></A> and
 663           <A HREF="../../../org/openafs/jafs/AFSFileException.html#getMessage()"><CODE>AFSFileException.getMessage()</CODE></A> respectively.
 664           <p> This exception <U>will not</U> be thrown if the file does not
 665           exist.  Rather, the <A HREF="../../../org/openafs/jafs/File.html#exists()"><CODE>exists()</CODE></A> attribute will be set to
 666           <code>false</code>.<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/File.html#validate()"><CODE>validate()</CODE></A></DL>
 667 <HR>
 668
 669 <A NAME="File(java.lang.String, java.lang.String, boolean)"><!-- --></A><H3>
 670 File</H3>
 671 <PRE>
 672 public <B>File</B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;parent,
 673             <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;filename,
 674             boolean&nbsp;validate)
 675      throws <A HREF="../../../org/openafs/jafs/AFSFileException.html">AFSFileException</A></PRE>
 676 <DL>
 677 <DD>Creates a new <code>File</code> instance from a parent pathname string
 678  and a child pathname string.
 679
 680  <p> If <code>parent</code> is <code>null</code> then the new
 681  <code>File</code> instance is created as if by invoking the
 682  single-argument <code>File</code> constructor on the given
 683  <code>filename</code> string (child pathname).
 684
 685  <p> Otherwise the <code>parent</code> pathname string is taken to denote
 686  a directory, and the <code>filename</code> string is taken to
 687  denote either a directory or a file.
 688
 689  <p> The abstract pathname will remain <B>abstract</B> unless the
 690  <code>validate</code> parameter is set to <code>true</code>. This
 691  means that the abstract pathname will <U>not</U> be <code>validated</code>
 692  and therefore the file object will not represent a qualified, attributed,
 693  AFS file resource.  Rather, this constructor provides a method by which
 694  you can construct a non-validated <code>File</code> object (one that
 695  does not contain the file's complete status information).
 696
 697  <p> This constructor is useful for creating file objects of file/path names
 698  that you know exist, however are unauthorized to <code>validate</code> (or
 699  <code>stat</code> - to obtain complete status information). For example,
 700  if you are permitted to <code>lookup</code> (see: <A HREF="../../../org/openafs/jafs/File.html#canLookup()"><CODE>canLookup()</CODE></A>) the
 701  contents of a given directory yet <U>not</U> permitted to <code>read</code>
 702  (see: <A HREF="../../../org/openafs/jafs/File.html#canRead()"><CODE>canRead()</CODE></A>), then this constructor would enable you to render the
 703  contents of the directory without validating each entry.
 704 <P>
 705 <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
 706                                 should be validated.
 707 <DT><B>Throws:</B>
 708 <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>
 709 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSFileException.html">AFSFileException</A></CODE> - If the user constructing this AFS file object is denied
 710           access to stat the file or simply a stat cannot be performed
 711           on the file. The reason code and message will be available
 712           from <A HREF="../../../org/openafs/jafs/AFSFileException.html#getErrorCode()"><CODE>AFSFileException.getErrorCode()</CODE></A> and
 713           <A HREF="../../../org/openafs/jafs/AFSFileException.html#getMessage()"><CODE>AFSFileException.getMessage()</CODE></A> respectively.
 714           <p> This exception <U>will not</U> be thrown if the file does not
 715           exist.  Rather, the <A HREF="../../../org/openafs/jafs/File.html#exists()"><CODE>exists()</CODE></A> attribute will be set to
 716           <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>,
 717 <A HREF="../../../org/openafs/jafs/File.html#validate()"><CODE>validate()</CODE></A></DL>
 718 <HR>
 719
 720 <A NAME="File(org.openafs.jafs.File, java.lang.String)"><!-- --></A><H3>
 721 File</H3>
 722 <PRE>
 723 public <B>File</B>(<A HREF="../../../org/openafs/jafs/File.html">File</A>&nbsp;parent,
 724             <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;filename)
 725      throws <A HREF="../../../org/openafs/jafs/AFSFileException.html">AFSFileException</A></PRE>
 726 <DL>
 727 <DD>Creates a new <code>File</code> instance from a parent abstract
 728  pathname and a child pathname string and validates it against the file system.
 729
 730  <p> If <code>parent</code> is <code>null</code> then the new
 731  <code>File</code> instance is created as if by invoking the
 732  single-argument <code>File</code> constructor on the given
 733  <code>filename</code> string (child pathname).
 734
 735  <p> Otherwise the <code>parent</code> abstract pathname is taken to
 736  denote a directory, and the <code>filename</code> string is taken
 737  to denote either a directory or a file.  The directory or file will then be
 738  <code>validated</code> to represent a qualified file object.
 739 <P>
 740 <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)
 741 <DT><B>Throws:</B>
 742 <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>
 743 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSFileException.html">AFSFileException</A></CODE> - If the user constructing this AFS file object is denied
 744           access to stat the file or simply a stat cannot be performed
 745           on the file. The reason code and message will be available
 746           from <A HREF="../../../org/openafs/jafs/AFSFileException.html#getErrorCode()"><CODE>AFSFileException.getErrorCode()</CODE></A> and
 747           <A HREF="../../../org/openafs/jafs/AFSFileException.html#getMessage()"><CODE>AFSFileException.getMessage()</CODE></A> respectively.
 748           <p> This exception <U>will not</U> be thrown if the file does not
 749           exist.  Rather, the <A HREF="../../../org/openafs/jafs/File.html#exists()"><CODE>exists()</CODE></A> attribute will be set to
 750           <code>false</code>.<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/File.html#validate()"><CODE>validate()</CODE></A></DL>
 751 <HR>
 752
 753 <A NAME="File(org.openafs.jafs.File, java.lang.String, boolean)"><!-- --></A><H3>
 754 File</H3>
 755 <PRE>
 756 public <B>File</B>(<A HREF="../../../org/openafs/jafs/File.html">File</A>&nbsp;parent,
 757             <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>&nbsp;filename,
 758             boolean&nbsp;validate)
 759      throws <A HREF="../../../org/openafs/jafs/AFSFileException.html">AFSFileException</A></PRE>
 760 <DL>
 761 <DD>Creates a new <code>File</code> instance from a parent abstract
 762  pathname and a child pathname string.
 763
 764  <p> If <code>parent</code> is <code>null</code> then the new
 765  <code>File</code> instance is created as if by invoking the
 766  single-argument <code>File</code> constructor on the given
 767  <code>filename</code> string (child pathname).
 768
 769  <p> Otherwise the <code>parent</code> abstract pathname is taken to
 770  denote a directory, and the <code>filename</code> string is taken
 771  to denote either a directory or a file.
 772
 773  <p> The abstract pathname will remain <B>abstract</B> unless the
 774  <code>validate</code> parameter is set to <code>true</code>. This
 775  means that the abstract pathname will <U>not</U> be <code>validated</code>
 776  and therefore the file object will not represent a qualified, attributed,
 777  AFS file resource.  Rather, this constructor provides a method by which
 778  you can construct a non-validated <code>File</code> object (one that
 779  does not contain the file's complete status information).
 780
 781  <p> This constructor is useful for creating file objects of file/path names
 782  that you know exist, however are unauthorized to <code>validate</code> (or
 783  <code>stat</code> - to obtain complete status information). For example,
 784  if you are permitted to <code>lookup</code> (see: <A HREF="../../../org/openafs/jafs/File.html#canLookup()"><CODE>canLookup()</CODE></A>) the
 785  contents of a given directory yet <U>not</U> permitted to <code>read</code>
 786  (see: <A HREF="../../../org/openafs/jafs/File.html#canRead()"><CODE>canRead()</CODE></A>), then this constructor would enable you to render the
 787  contents of the directory without validating each entry.
 788 <P>
 789 <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
 790                                 should be validated.
 791 <DT><B>Throws:</B>
 792 <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>
 793 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSFileException.html">AFSFileException</A></CODE> - If the user constructing this AFS file object is denied
 794           access to stat the file or simply a stat cannot be performed
 795           on the file. The reason code and message will be available
 796           from <A HREF="../../../org/openafs/jafs/AFSFileException.html#getErrorCode()"><CODE>AFSFileException.getErrorCode()</CODE></A> and
 797           <A HREF="../../../org/openafs/jafs/AFSFileException.html#getMessage()"><CODE>AFSFileException.getMessage()</CODE></A> respectively.
 798           <p> This exception <U>will not</U> be thrown if the file does not
 799           exist.  Rather, the <A HREF="../../../org/openafs/jafs/File.html#exists()"><CODE>exists()</CODE></A> attribute will be set to
 800           <code>false</code>.<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/File.html#validate()"><CODE>validate()</CODE></A>,
 801 <A HREF="../../../org/openafs/jafs/File.html#File(org.openafs.jafs.File, java.lang.String)"><CODE>File(File, String)</CODE></A></DL>
 802
 803 <!-- ============ METHOD DETAIL ========== -->
 804
 805 <A NAME="method_detail"><!-- --></A>
 806 <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
 807 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
 808 <TD COLSPAN=1><FONT SIZE="+2">
 809 <B>Method Detail</B></FONT></TD>
 810 </TR>
 811 </TABLE>
 812
 813 <A NAME="validate()"><!-- --></A><H3>
 814 validate</H3>
 815 <PRE>
 816 public void <B>validate</B>()
 817               throws <A HREF="../../../org/openafs/jafs/AFSSecurityException.html">AFSSecurityException</A></PRE>
 818 <DL>
 819 <DD>Validates this abstract pathname as an attributed AFS file object.
 820  This method will, if authorized, perform a <code>stat</code> on the
 821  actual AFS file and update its respective field members; defining
 822  this file object's attributes.
 823 <P>
 824 <DD><DL>
 825 </DL>
 826 </DD>
 827 <DD><DL>
 828
 829 <DT><B>Throws:</B>
 830 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSSecurityException.html">AFSSecurityException</A></CODE> - If an AFS exception occurs while attempting to stat and set this
 831           AFS file object's attributes.</DL>
 832 </DD>
 833 </DL>
 834 <HR>
 835
 836 <A NAME="isValidated()"><!-- --></A><H3>
 837 isValidated</H3>
 838 <PRE>
 839 public boolean <B>isValidated</B>()</PRE>
 840 <DL>
 841 <DD>Tests whether the file denoted by this abstract pathname has
 842  been validated.
 843
 844  <P> Validation is always attempted upon construction of the file object,
 845  therefore if this method returns false, then you are not permitted to
 846  <code>validate</code> this file and consequently all attribute accessors
 847  will be invalid.
 848
 849  <P> This method should return <code>true</code> even if this abstract
 850  pathname does not exist. If this is abstract pathname does not exist then
 851  the <code><A HREF="../../../org/openafs/jafs/File.html#exists()"><CODE>exists()</CODE></A></code> method should return false, however this
 852  implies that the attribute accessors are valid and accurate; thus implying
 853  successful validation.
 854
 855  <P> This method is useful before calling any of the attribute accessors
 856  to ensure a valid response.
 857 <P>
 858 <DD><DL>
 859 </DL>
 860 </DD>
 861 <DD><DL>
 862
 863 <DT><B>Returns:</B><DD><code>true</code> if and only if the file denoted by this
 864           abstract pathname has been validated during or after object construction;
 865           <code>false</code> otherwise</DL>
 866 </DD>
 867 </DL>
 868 <HR>
 869
 870 <A NAME="refresh()"><!-- --></A><H3>
 871 refresh</H3>
 872 <PRE>
 873 public void <B>refresh</B>()
 874              throws <A HREF="../../../org/openafs/jafs/AFSSecurityException.html">AFSSecurityException</A></PRE>
 875 <DL>
 876 <DD>Refreshes this AFS file object by updating its attributes.
 877  This method currently provides the same functionality as
 878  <A HREF="../../../org/openafs/jafs/File.html#validate()"><CODE>validate()</CODE></A>.
 879 <P>
 880 <DD><DL>
 881 </DL>
 882 </DD>
 883 <DD><DL>
 884
 885 <DT><B>Throws:</B>
 886 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSSecurityException.html">AFSSecurityException</A></CODE> - If an AFS exception occurs while attempting to stat and update this
 887           AFS file object's attributes.<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/File.html#validate()"><CODE>validate()</CODE></A></DL>
 888 </DD>
 889 </DL>
 890 <HR>
 891
 892 <A NAME="isDirectory()"><!-- --></A><H3>
 893 isDirectory</H3>
 894 <PRE>
 895 public boolean <B>isDirectory</B>()</PRE>
 896 <DL>
 897 <DD>Tests whether the file denoted by this abstract pathname is a
 898  directory.
 899 <P>
 900 <DD><DL>
 901 <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>
 902 </DD>
 903 <DD><DL>
 904
 905 <DT><B>Returns:</B><DD><code>true</code> if and only if the file denoted by this
 906           abstract pathname exists <em>and</em> is a directory;
 907           <code>false</code> otherwise</DL>
 908 </DD>
 909 </DL>
 910 <HR>
 911
 912 <A NAME="isFile()"><!-- --></A><H3>
 913 isFile</H3>
 914 <PRE>
 915 public boolean <B>isFile</B>()</PRE>
 916 <DL>
 917 <DD>Tests whether the file denoted by this abstract pathname is a normal
 918  file.  A file is <em>normal</em> if it is not a directory and, in
 919  addition, satisfies other system-dependent criteria.  Any non-directory
 920  file created by a Java application is guaranteed to be a normal file.
 921 <P>
 922 <DD><DL>
 923 <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>
 924 </DD>
 925 <DD><DL>
 926
 927 <DT><B>Returns:</B><DD><code>true</code> if and only if the file denoted by this
 928           abstract pathname exists <em>and</em> is a normal file;
 929           <code>false</code> otherwise</DL>
 930 </DD>
 931 </DL>
 932 <HR>
 933
 934 <A NAME="isMountPoint()"><!-- --></A><H3>
 935 isMountPoint</H3>
 936 <PRE>
 937 public boolean <B>isMountPoint</B>()</PRE>
 938 <DL>
 939 <DD>Tests whether the file denoted by this abstract pathname is an
 940  AFS Volume Mount Point.
 941 <P>
 942 <DD><DL>
 943 </DL>
 944 </DD>
 945 <DD><DL>
 946
 947 <DT><B>Returns:</B><DD><code>true</code> if and only if the file denoted by this
 948           abstract pathname exists <em>and</em> is a mount point;
 949           <code>false</code> otherwise</DL>
 950 </DD>
 951 </DL>
 952 <HR>
 953
 954 <A NAME="isLink()"><!-- --></A><H3>
 955 isLink</H3>
 956 <PRE>
 957 public boolean <B>isLink</B>()</PRE>
 958 <DL>
 959 <DD>Tests whether the file denoted by this abstract pathname is a
 960  symbolic-link.
 961 <P>
 962 <DD><DL>
 963 </DL>
 964 </DD>
 965 <DD><DL>
 966
 967 <DT><B>Returns:</B><DD><code>true</code> if and only if the file denoted by this
 968           abstract pathname exists <em>and</em> is a symbolic-link;
 969           <code>false</code> otherwise</DL>
 970 </DD>
 971 </DL>
 972 <HR>
 973
 974 <A NAME="exists()"><!-- --></A><H3>
 975 exists</H3>
 976 <PRE>
 977 public boolean <B>exists</B>()</PRE>
 978 <DL>
 979 <DD>Tests whether the file denoted by this abstract pathname exists.
 980 <P>
 981 <DD><DL>
 982 <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>
 983 </DD>
 984 <DD><DL>
 985
 986 <DT><B>Returns:</B><DD><code>true</code> if and only if the file denoted by this
 987           abstract pathname exists; <code>false</code> otherwise</DL>
 988 </DD>
 989 </DL>
 990 <HR>
 991
 992 <A NAME="lastModified()"><!-- --></A><H3>
 993 lastModified</H3>
 994 <PRE>
 995 public long <B>lastModified</B>()</PRE>
 996 <DL>
 997 <DD>Returns the time that the file denoted by this abstract pathname was
 998  last modified.
 999 <P>
1000 <DD><DL>
1001 <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>
1002 </DD>
1003 <DD><DL>
1004
1005 <DT><B>Returns:</B><DD>A <code>long</code> value representing the time the file was
1006           last modified, measured in milliseconds since the epoch
1007           (00:00:00 GMT, January 1, 1970), or <code>0L</code> if the
1008           file does not exist or if an I/O error occurs</DL>
1009 </DD>
1010 </DL>
1011 <HR>
1012
1013 <A NAME="length()"><!-- --></A><H3>
1014 length</H3>
1015 <PRE>
1016 public long <B>length</B>()</PRE>
1017 <DL>
1018 <DD>Returns the length of the file denoted by this abstract pathname.
1019 <P>
1020 <DD><DL>
1021 <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>
1022 </DD>
1023 <DD><DL>
1024
1025 <DT><B>Returns:</B><DD>The length, in bytes, of the file denoted by this abstract
1026           pathname, or <code>0L</code> if the file does not exist</DL>
1027 </DD>
1028 </DL>
1029 <HR>
1030
1031 <A NAME="getTarget()"><!-- --></A><H3>
1032 getTarget</H3>
1033 <PRE>
1034 public <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> <B>getTarget</B>()</PRE>
1035 <DL>
1036 <DD>Returns an abstract pathname string that represents the target resource of
1037  of this file, if it is a symbolic-link.
1038
1039  <p> If this abstract pathname <B>does not</B> denote a symbolic-link, then this
1040  method returns <code>null</code>.  Otherwise a string is
1041  returned that represents the target resource of this symbolic-link.
1042 <P>
1043 <DD><DL>
1044 </DL>
1045 </DD>
1046 <DD><DL>
1047
1048 <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>
1049 </DD>
1050 </DL>
1051 <HR>
1052
1053 <A NAME="list()"><!-- --></A><H3>
1054 list</H3>
1055 <PRE>
1056 public <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A>[] <B>list</B>()</PRE>
1057 <DL>
1058 <DD>Returns an array of strings naming the files and directories in the
1059  directory denoted by this abstract pathname.
1060
1061  <p> If this abstract pathname does not denote a directory, then this
1062  method returns <code>null</code>.  Otherwise an array of strings is
1063  returned, one for each file or directory in the directory.  Names
1064  denoting the directory itself and the directory's parent directory are
1065  not included in the result.  Each string is a file name rather than a
1066  complete path.
1067
1068  <p> There is no guarantee that the name strings in the resulting array
1069  will appear in any specific order; they are not, in particular,
1070  guaranteed to appear in alphabetical order.
1071 <P>
1072 <DD><DL>
1073 <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>
1074 </DD>
1075 <DD><DL>
1076
1077 <DT><B>Returns:</B><DD>An array of strings naming the files and directories in the
1078           directory denoted by this abstract pathname.  The array will be
1079           empty if the directory is empty.  Returns <code>null</code> if
1080           this abstract pathname does not denote a directory, or if an
1081           I/O error occurs.</DL>
1082 </DD>
1083 </DL>
1084 <HR>
1085
1086 <A NAME="listArray()"><!-- --></A><H3>
1087 listArray</H3>
1088 <PRE>
1089 public <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/util/ArrayList.html">ArrayList</A> <B>listArray</B>()
1090                     throws <A HREF="../../../org/openafs/jafs/AFSFileException.html">AFSFileException</A></PRE>
1091 <DL>
1092 <DD>Returns an ArrayList object containing strings naming the files and
1093  directories in the directory denoted by this abstract pathname.
1094
1095  <p> If this abstract pathname does not denote a directory, then this
1096  method returns <code>null</code>.  Otherwise an array of strings is
1097  returned, one for each file or directory in the directory.  Names
1098  denoting the directory itself and the directory's parent directory are
1099  not included in the result.  Each string is a file name rather than a
1100  complete path.
1101
1102  <p> There is no guarantee that the name strings in the resulting array
1103  will appear in any specific order; they are not, in particular,
1104  guaranteed to appear in alphabetical order.
1105 <P>
1106 <DD><DL>
1107 </DL>
1108 </DD>
1109 <DD><DL>
1110
1111 <DT><B>Returns:</B><DD>An array of strings naming the files and directories in the
1112           directory denoted by this abstract pathname.  The array will be
1113           empty if the directory is empty.  Returns <code>null</code> if
1114           this abstract pathname does not denote a directory, or if an
1115           I/O error occurs.
1116 <DT><B>Throws:</B>
1117 <DD><CODE><A HREF="../../../org/openafs/jafs/AFSSecurityException.html">AFSSecurityException</A></CODE> - If you are not authorized to list the contents of this directory
1118 <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
1119           </code>, or <code>directory</code> <B>or</B> an unexpected AFS
1120           error occurs.<DT><B>See Also:</B><DD><A HREF="../../../org/openafs/jafs/File.html#list()"><CODE>list()</CODE></A></DL>
1121 </DD>
1122 </DL>
1123 <HR>
1124
1125 <A NAME="delete()"><!-- --></A><H3>
1126 delete</H3>
1127 <PRE>
1128 public boolean <B>delete</B>()</PRE>
1129 <DL>
1130 <DD>Deletes the file or directory denoted by this abstract pathname.  If
1131  this pathname denotes a directory, then the directory must be empty in
1132  order to be deleted.
1133 <P>
1134 <DD><DL>
1135 <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>
1136 </DD>
1137 <DD><DL>
1138
1139 <DT><B>Returns:</B><DD><code>true</code> if and only if the file or directory is
1140           successfully deleted; <code>false</code> otherwise</DL>
1141 </DD>
1142 </DL>
1143 <HR>
1144
1145 <A NAME="copyTo(org.openafs.jafs.File)"><!-- --></A><H3>
1146 copyTo</H3>
1147 <PRE>
1148 public boolean <B>copyTo</B>(<A HREF="../../../org/openafs/jafs/File.html">File</A>&nbsp;dest)
1149                throws <A HREF="../../../org/openafs/jafs/AFSFileException.html">AFSFileException</A></PRE>
1150 <DL>
1151 <DD>Copies the file denoted by this abstract pathname to the destination
1152  file provided.  Then checks the newly copied file's size to
1153  test for file size consistency.
1154 <P>
1155 <DD><DL>
1156 </DL>
1157 </DD>
1158 <DD><DL>
1159 <DT><B>Parameters:</B><DD><CODE>dest</CODE> - The new abstract pathname for the named file
1160 <DT><B>Returns:</B><DD><code>true</code> if and only if the file that was copied
1161           reports the same file size (length) as that of this file;
1162           <code>false</code> otherwise
1163 <DT><B>Throws:</B>
1164 <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>
1165 </DD>
1166 </DL>
1167 <HR>
1168
1169 <A NAME="getPermissionsMask()"><!-- --></A><H3>
1170 getPermissionsMask</H3>
1171 <PRE>
1172 public int <B>getPermissionsMask</B>()</PRE>
1173 <DL>
1174 <DD>Returns the permissions mask of the ACL for this object relative to the user accessing it.
1175 <P>
1176 <DD><DL>
1177 </DL>
1178 </DD>
1179 <DD><DL>
1180
1181 <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>
1182 </DD>
1183 </DL>
1184 <HR>
1185
1186 <A NAME="canAdmin()"><!-- --></A><H3>
1187 canAdmin</H3>
1188 <PRE>
1189 public boolean <B>canAdmin</B>()</PRE>
1190 <DL>
1191 <DD>Tests whether the user can administer the ACL (see: <A HREF="../../../org/openafs/jafs/ACL.html"><CODE>ACL</CODE></A>
1192  of the directory denoted by this abstract pathname.
1193 <P>
1194 <DD><DL>
1195 </DL>
1196 </DD>
1197 <DD><DL>
1198
1199 <DT><B>Returns:</B><DD><code>true</code> if and only if the directory specified by this
1200           abstract pathname exists <em>and</em> can be administered by the
1201           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>
1202 </DD>
1203 </DL>
1204 <HR>
1205
1206 <A NAME="canDelete()"><!-- --></A><H3>
1207 canDelete</H3>
1208 <PRE>
1209 public boolean <B>canDelete</B>()</PRE>
1210 <DL>
1211 <DD>Tests whether the current user can delete the files or subdirectories of
1212  the directory denoted by this abstract pathname.
1213 <P>
1214 <DD><DL>
1215 </DL>
1216 </DD>
1217 <DD><DL>
1218
1219 <DT><B>Returns:</B><DD><code>true</code> if and only if the directory specified by this
1220           abstract pathname exists <em>and</em> permits deletion of its files
1221           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>
1222 </DD>
1223 </DL>
1224 <HR>
1225
1226 <A NAME="canInsert()"><!-- --></A><H3>
1227 canInsert</H3>
1228 <PRE>
1229 public boolean <B>canInsert</B>()</PRE>
1230 <DL>
1231 <DD>Tests whether the current user can insert a file into the directory
1232  denoted by this abstract pathname.
1233 <P>
1234 <DD><DL>
1235 </DL>
1236 </DD>
1237 <DD><DL>
1238
1239 <DT><B>Returns:</B><DD><code>true</code> if and only if the directory specified by this
1240           abstract pathname exists <em>and</em> a file can be inserted by the
1241           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>
1242 </DD>
1243 </DL>
1244 <HR>
1245
1246 <A NAME="canLock()"><!-- --></A><H3>
1247 canLock</H3>
1248 <PRE>
1249 public boolean <B>canLock</B>()</PRE>
1250 <DL>
1251 <DD>Tests whether the current user can lock the file denoted by this
1252  abstract pathname.
1253 <P>
1254 <DD><DL>
1255 </DL>
1256 </DD>
1257 <DD><DL>
1258
1259 <DT><B>Returns:</B><DD><code>true</code> if and only if the file specified by this
1260           abstract pathname exists <em>and</em> can be locked by the
1261           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>
1262 </DD>
1263 </DL>
1264 <HR>
1265
1266 <A NAME="canLookup()"><!-- --></A><H3>
1267 canLookup</H3>
1268 <PRE>
1269 public boolean <B>canLookup</B>()</PRE>
1270 <DL>
1271 <DD>Tests whether the current user can lookup the contents of the directory
1272  denoted by this abstract pathname.
1273 <P>
1274 <DD><DL>
1275 </DL>
1276 </DD>
1277 <DD><DL>
1278
1279 <DT><B>Returns:</B><DD><code>true</code> if and only if the directory specified by this
1280           abstract pathname exists <em>and</em> its contents can be listed by the
1281           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>
1282 </DD>
1283 </DL>
1284 <HR>
1285
1286 <A NAME="canRead()"><!-- --></A><H3>
1287 canRead</H3>
1288 <PRE>
1289 public boolean <B>canRead</B>()</PRE>
1290 <DL>
1291 <DD>Tests whether the current user can read the file denoted by this
1292  abstract pathname.
1293 <P>
1294 <DD><DL>
1295 <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>
1296 </DD>
1297 <DD><DL>
1298
1299 <DT><B>Returns:</B><DD><code>true</code> if and only if the file specified by this
1300           abstract pathname exists <em>and</em> can be read by the
1301           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>
1302 </DD>
1303 </DL>
1304 <HR>
1305
1306 <A NAME="canWrite()"><!-- --></A><H3>
1307 canWrite</H3>
1308 <PRE>
1309 public boolean <B>canWrite</B>()</PRE>
1310 <DL>
1311 <DD>Tests whether the current user can modify to the file denoted by this
1312  abstract pathname.
1313 <P>
1314 <DD><DL>
1315 <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>
1316 </DD>
1317 <DD><DL>
1318
1319 <DT><B>Returns:</B><DD><code>true</code> if and only if the file system actually
1320           contains a file denoted by this abstract pathname <em>and</em>
1321           the current user is allowed to write to the file;
1322           <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>
1323 </DD>
1324 </DL>
1325 <HR>
1326
1327 <A NAME="close()"><!-- --></A><H3>
1328 close</H3>
1329 <PRE>
1330 public boolean <B>close</B>()</PRE>
1331 <DL>
1332 <DD>Closes the directory denoted by this abstract pathname.
1333 <P>
1334 <DD><DL>
1335 </DL>
1336 </DD>
1337 <DD><DL>
1338
1339 <DT><B>Returns:</B><DD><code>true</code> if and only if the directory is
1340           successfully closed; <code>false</code> otherwise</DL>
1341 </DD>
1342 </DL>
1343 <HR>
1344
1345 <A NAME="getErrorCode()"><!-- --></A><H3>
1346 getErrorCode</H3>
1347 <PRE>
1348 public int <B>getErrorCode</B>()</PRE>
1349 <DL>
1350 <DD>Returns the AFS specific error number (code).  This code can be interpreted
1351  by use of <code><A HREF="../../../org/openafs/jafs/ErrorTable.html"><CODE>ErrorTable</CODE></A></code> static class method
1352  <code><A HREF="../../../org/openafs/jafs/ErrorTable.html#getMessage(int)"><CODE>ErrorTable.getMessage(int)</CODE></A></code>
1353 <P>
1354 <DD><DL>
1355 </DL>
1356 </DD>
1357 <DD><DL>
1358
1359 <DT><B>Returns:</B><DD>the AFS error code (number) associated with the last action performed
1360           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>
1361 </DD>
1362 </DL>
1363 <HR>
1364
1365 <A NAME="getErrorMessage()"><!-- --></A><H3>
1366 getErrorMessage</H3>
1367 <PRE>
1368 public <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html">String</A> <B>getErrorMessage</B>()</PRE>
1369 <DL>
1370 <DD>Returns the AFS error message string defined by the <code><A HREF="../../../org/openafs/jafs/ErrorTable.html"><CODE>ErrorTable</CODE></A></code>
1371  class.
1372 <P>
1373 <DD><DL>
1374 </DL>
1375 </DD>
1376 <DD><DL>
1377
1378 <DT><B>Returns:</B><DD>the AFS error message string associated with the last action performed
1379           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>
1380 </DD>
1381 </DL>
1382 <HR>
1383
1384 <A NAME="compareTo(org.openafs.jafs.File)"><!-- --></A><H3>
1385 compareTo</H3>
1386 <PRE>
1387 public int <B>compareTo</B>(<A HREF="../../../org/openafs/jafs/File.html">File</A>&nbsp;file)</PRE>
1388 <DL>
1389 <DD>Compares two File objects relative to their filenames and <B>does not</B>
1390  compare their respective absolute paths.  Alphabetic case is significant in
1391  comparing filenames.
1392 <P>
1393 <DD><DL>
1394 </DL>
1395 </DD>
1396 <DD><DL>
1397 <DT><B>Parameters:</B><DD><CODE>file</CODE> - The File object to be compared to this file's filename
1398 <DT><B>Returns:</B><DD>Zero if the argument is equal to this file's filename, a
1399                 value less than zero if this file's filename is
1400                 lexicographically less than the argument, or a value greater
1401                 than zero if this file's filename is lexicographically
1402                 greater than the argument<DT><B>Since:</B></DT>
1403   <DD>JDK1.2</DD>
1404 </DL>
1405 </DD>
1406 </DL>
1407 <HR>
1408
1409 <A NAME="compareTo(java.lang.Object)"><!-- --></A><H3>
1410 compareTo</H3>
1411 <PRE>
1412 public int <B>compareTo</B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html">Object</A>&nbsp;o)
1413               throws <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/ClassCastException.html">ClassCastException</A></PRE>
1414 <DL>
1415 <DD>Compares this file to another File object.  If the other object
1416  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
1417  <code>ClassCastException</code>, since File objects can only be
1418  compared to File objects.
1419 <P>
1420 <DD><DL>
1421 <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>
1422 </DD>
1423 <DD><DL>
1424 <DT><B>Parameters:</B><DD><CODE>o</CODE> - The <code>Object</code> to be compared to this abstract pathname
1425 <DT><B>Returns:</B><DD>If the argument is an File object, returns zero
1426           if the argument is equal to this file's filename, a value
1427           less than zero if this file's filename is lexicographically
1428           less than the argument, or a value greater than zero if this
1429           file's filename is lexicographically greater than the
1430           argument
1431 <DT><B>Throws:</B>
1432 <DD><CODE><code>ClassCastException</code></CODE> - if the argument is not an
1433                   File object
1434 <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>
1435   <DD>JDK1.2</DD>
1436 <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>
1437 </DD>
1438 </DL>
1439 <HR>
1440
1441 <A NAME="mkdir()"><!-- --></A><H3>
1442 mkdir</H3>
1443 <PRE>
1444 public boolean <B>mkdir</B>()</PRE>
1445 <DL>
1446 <DD>Creates the directory named by this abstract pathname.
1447 <P>
1448 <DD><DL>
1449 <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>
1450 </DD>
1451 <DD><DL>
1452
1453 <DT><B>Returns:</B><DD><code>true</code> if and only if the directory was
1454           created; <code>false</code> otherwise</DL>
1455 </DD>
1456 </DL>
1457 <HR>
1458
1459 <A NAME="renameTo(org.openafs.jafs.File)"><!-- --></A><H3>
1460 renameTo</H3>
1461 <PRE>
1462 public boolean <B>renameTo</B>(<A HREF="../../../org/openafs/jafs/File.html">File</A>&nbsp;dest)</PRE>
1463 <DL>
1464 <DD>Renames the file denoted by this abstract pathname.
1465 <P>
1466 <DD><DL>
1467 </DL>
1468 </DD>
1469 <DD><DL>
1470 <DT><B>Parameters:</B><DD><CODE>dest</CODE> - The new abstract pathname for the named file
1471 <DT><B>Returns:</B><DD><code>true</code> if and only if the renaming succeeded;
1472           <code>false</code> otherwise
1473 <DT><B>Throws:</B>
1474 <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>
1475 </DD>
1476 </DL>
1477 <HR>
1478
1479 <A NAME="setAttributes()"><!-- --></A><H3>
1480 setAttributes</H3>
1481 <PRE>
1482 public boolean <B>setAttributes</B>()
1483                       throws <A HREF="../../../org/openafs/jafs/AFSSecurityException.html">AFSSecurityException</A></PRE>
1484 <DL>
1485 <DD>Performs a file <code>stat</code> on the actual AFS file and populates
1486  this object's respective field members with the appropriate values.
1487  method will, if authorized, perform a <code>stat</code> on the
1488  actual AFS file and update its respective field members; defining
1489  this file object's attributes.
1490
1491  <P><B>This method should not be used directly for refreshing or validating
1492  this AFS file object.  Please use <A HREF="../../../org/openafs/jafs/File.html#validate()"><CODE>validate()</CODE></A> instead.</B>
1493 <P>
1494 <DD><DL>
1495 </DL>
1496 </DD>
1497 <DD><DL>
1498
1499 <DT><B>Returns:</B><DD><code>true</code> if and only if the current user is allowed to stat the file;
1500           <code>false</code> otherwise.
1501 <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>
1502 </DD>
1503 </DL>
1504 <!-- ========= END OF CLASS DATA ========= -->
1505 <HR>
1506
1507 <!-- ========== START OF NAVBAR ========== -->
1508 <A NAME="navbar_bottom"><!-- --></A>
1509 <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
1510 <TR>
1511 <TD COLSPAN=3 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
1512 <A NAME="navbar_bottom_firstrow"><!-- --></A>
1513 <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
1514   <TR ALIGN="center" VALIGN="top">
1515   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
1516   <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
1517   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/File.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
1518   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
1519   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
1520   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
1521   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
1522   </TR>
1523 </TABLE>
1524 </TD>
1525 <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
1526 <B>JAFS API v2</B></EM>
1527 </TD>
1528 </TR>
1529
1530 <TR>
1531 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
1532 &nbsp;<A HREF="../../../org/openafs/jafs/ErrorTable.html"><B>PREV CLASS</B></A>&nbsp;
1533 &nbsp;<A HREF="../../../org/openafs/jafs/FileInputStream.html"><B>NEXT CLASS</B></A></FONT></TD>
1534 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
1535   <A HREF="../../../index.html" TARGET="_top"><B>FRAMES</B></A>  &nbsp;
1536 &nbsp;<A HREF="File.html" TARGET="_top"><B>NO FRAMES</B></A>  &nbsp;
1537 &nbsp;
1538 <SCRIPT>
1539   <!--
1540   if(window==top) {
1541     document.writeln('<A HREF="../../../allclasses-noframe.html" TARGET=""><B>All Classes</B></A>');
1542   }
1543   //-->
1544 </SCRIPT>
1545 <NOSCRIPT>
1546 <A HREF="../../../allclasses-noframe.html" TARGET=""><B>All Classes</B></A>
1547 </NOSCRIPT>
1548 </FONT></TD>
1549 </TR>
1550 <TR>
1551 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
1552   SUMMARY:&nbsp;NESTED&nbsp;|&nbsp;<A HREF="#fields_inherited_from_class_java.io.File">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
1553 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
1554 DETAIL:&nbsp;FIELD&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
1555 </TR>
1556 </TABLE>
1557 <!-- =========== END OF NAVBAR =========== -->
1558
1559 <HR>
1560
1561 </BODY>
1562 </HTML>