---
title: "file:status — File status"
description: "iXML command file:status: File status."
canonical_url: "https://www.zeyos.com/ixml/ref/file-status"
markdown_url: "https://www.zeyos.com/ai/guide/ixml/ref/file-status.md"
section: "ixml-reference"
authority: "reference"
language: "en"
source_repository: "https://cloud.zeyos.com/__doc/ixmldoc.xml"
source_sha256: "a23f04e6a98628ca3c273c3b8dd2c33c034cfda3e0f00478d8793074fd2f70dd"
---

# file:status — File status

FILE:STATUS returns the status of a file or directory.

FILE:STATUS returns an array comprised of the following items:

				Index/Key  Description
				-----------------------------------------------------
				0/dev      device number
				1/ino      inode number
				2/mode     inode protection mode
				3/nlink    number of links
				4/uid      userid of owner
				5/gid      groupid of owner
				6/rdev     device type if inode device
				7/size     size in bytes
				8/atime    time of last access (Unix timestamp)
				9/mtime    time of last modification (Unix timestamp)
				10/ctime   time of last inode change (Unix timestamp)
				11/blksize blocksize of filesystem IO
				12/blocks  number of 512-byte blocks allocated

### Attributes
| Name | Type | Default | Description |
| ---- | ---- | ------- | ----------- |
| var | var |  | Result variable name |
| filename | string |  | Filename |
| follow | bool |  | Follow symbolic links |

### Children
- (none)

### Parents
- (not restricted in the reference)

### Result
- binding: var; type: array; predicate: no-result-propagation

### Examples

```xml
<file:status var="status" filename="./test/ixml.inc"/>
<output>$status.size</output>
<!-- 4 -->
```