Changeset 25773 in project


Ignore:
Timestamp:
01/06/12 18:05:23 (9 years ago)
Author:
Jim Ursetto
Message:

wiki/man/Unit posix: Try to clear up file-stat vector contents

File:
1 edited

Legend:

Unmodified
Added
Removed
  • wiki/man/4/Unit posix

    r24346 r25773  
    386386<procedure>(file-stat FILE [LINK])</procedure>
    387387
    388 Returns a 13-element vector with the following contents: inode-number,
    389 mode (as with {{file-permissions}}), number of hard links, uid of
    390 owner (as with {{file-owner}}), gid of owner, size (as with
    391 {{file-size}}) and access-, change- and modification-time (as with
    392 {{file-access-time}}, {{file-change-time}} and
    393 {{file-modification-time}}, device id, device type (for special file
    394 inode, blocksize and blocks allocated.  On Windows systems the last 4
    395 values are undefined.
     388Returns a 13-element vector with the following contents:
     389
     390<table>
     391<tr><th>index</th>
     392    <th>value</th>
     393    <th>field</th>
     394    <th>notes</th></tr>
     395<tr><td>0</td>
     396    <td>inode number</td>
     397    <td>{{st_ino}}</td>
     398    <td></td></tr>
     399<tr><td>1</td>
     400    <td>mode</td>
     401    <td>{{st_mode}}</td>
     402    <td>bitfield combining file permissions and file type</td></tr>
     403<tr><td>2</td>
     404    <td>number of hard links</td>
     405    <td>{{st_nlink}}</td>
     406    <td></td></tr>
     407<tr><td>3</td>
     408    <td>UID of owner</td>
     409    <td>{{st_uid}}</td>
     410    <td>as with {{file-owner}}</td></tr>
     411<tr><td>4</td>
     412    <td>GID of owner</td>
     413    <td>{{st_gid}}</td>
     414    <td></td></tr>
     415<tr><td>5</td>
     416    <td>size</td>
     417    <td>{{st_size}}</td>
     418    <td>as with {{file-size}}</td></tr>
     419<tr><td>6</td>
     420    <td>access time</td>
     421    <td>{{st_atime}}</td>
     422    <td>as with {{file-access-time}}</td></tr>
     423<tr><td>7</td>
     424    <td>change time</td>
     425    <td>{{st_ctime}}</td>
     426    <td>as with {{file-change-time}}</td></tr>
     427<tr><td>8</td>
     428    <td>modification time</td>
     429    <td>{{st_mtime}}</td>
     430    <td>as with {{file-modification-time}}</td></tr>
     431<tr><td>9</td>
     432    <td>parent device ID </td>
     433    <td>{{st_dev}}</td>
     434    <td>ID of device on which this file resides</td></tr>
     435<tr><td>10</td>
     436    <td>device ID</td>
     437    <td>{{st_rdev}}</td>
     438    <td>device ID for special files (i.e. the raw major/minor number)</td></tr>
     439<tr><td>11</td>
     440    <td>block size</td>
     441    <td>{{st_blksize}}</td>
     442    <td></td></tr>
     443<tr><td>12</td>
     444    <td>number of blocks allocated</td>
     445    <td>{{st_blocks}}</td>
     446    <td></td></tr>
     447</table>
     448
     449On Windows systems, the last 4 values are undefined.
    396450
    397451By default, symbolic links are followed and
Note: See TracChangeset for help on using the changeset viewer.