<?xml version="1.0" standalone="no"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
  "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">

<refentry id="class-matevfs-fileinfo">
  <refnamediv>
    <refname>matevfs.FileInfo</refname>
    <refpurpose>Object which stores information about a file</refpurpose>
  </refnamediv>

  <refsect1>
    <title>Synopsis</title>
    <classsynopsis language="python">
      <ooclass><classname>matevfs.FileInfo</classname></ooclass>
    </classsynopsis>
  </refsect1>

  <refsect1>
    <title>Attributes</title>
    <blockquote role="properties">
      <informaltable pgwide="1" frame="none">
        <tgroup cols="2">
	  <colspec column="1" colwidth="1in"/>
	  <colspec column="3" colwidth="3.5in"/>

	  <tbody>
            <row valign="top">
	      <entry>atime</entry>
	      <entry>Access time.</entry>
	    </row>

            <row valign="top">
	      <entry>block_count</entry>
	      <entry>Size measured in 512-byte blocks</entry>
	    </row>

            <row valign="top">
	      <entry>ctime</entry>
	      <entry>Change time.</entry>
	    </row>

            <row valign="top">
	      <entry>device</entry>
	      <entry>Device type.  This property is only valid if the file is local.</entry>
	    </row>

            <row valign="top">
	      <entry>flags</entry>
	      <entry>Flags for this file.  See <link linkend="matevfs-constants-file-flags">matevfs File Flags</link>.</entry>
	    </row>

            <row valign="top">
	      <entry>gid</entry>
	      <entry>Group ID of the file</entry>
	    </row>

            <row valign="top">
	      <entry>inode</entry>
	      <entry>Inode number.  This property is only valid if the file is local.</entry>
	    </row>

            <row valign="top">
	      <entry>io_block_size</entry>
	      <entry>Optimal buffer size for reading/writing the file.</entry>
	    </row>

            <row valign="top">
	      <entry>link_count</entry>
	      <entry>Number of links to this file.</entry>
	    </row>

            <row valign="top">
	      <entry>mime_type</entry>
	      <entry>MIME type as an ASCII string</entry>
	    </row>

            <row valign="top">
	      <entry>mtime</entry>
	      <entry>Modification time.</entry>
	    </row>

            <row valign="top">
	      <entry>name</entry>
	      <entry>Base name of the file (no path).</entry>
	    </row>

            <row valign="top">
	      <entry>permissions</entry>
	      <entry>File permissions.</entry>
	    </row>

            <row valign="top">
	      <entry>size</entry>
	      <entry>Size in bytes.</entry>
	    </row>

            <row valign="top">
	      <entry>symlink_name</entry>
	      <entry>If the file is a symlink (see `flags'), the name of the file this link points to.</entry>
	    </row>

            <row valign="top">
	      <entry>type</entry>
	      <entry>File type (i.e. regular, directory, block device...).</entry>
	    </row>

            <row valign="top">
	      <entry>uid</entry>
	      <entry>User ID of the file</entry>
	    </row>

            <row valign="top">
	      <entry>valid_fields</entry>
	      <entry>Fields which are actually valid in this structure.</entry>
	    </row>
	  </tbody>
	</tgroup>
      </informaltable>
    </blockquote>
  </refsect1>
</refentry>
