Previous page

Next page

Locate page in Contents

Print this page

stat

Summary:

Returns filesystem element status information. The call is also capable of searching the backup archives and display the status information for the archived files and directories.

Request specification:

Name

Min/Max

Type

Description

stat

 

navigateType

 

{

 

 

 

usage

0..1

 

If present, the size returned for an element is a gross size on a disk, so for directories it is calculated by traversing their children.

{

 

 

 

single_fs

0..1

 

Do not go across different partitions, while traversing.

}

 

 

 

follow_links

0..1

 

If present, the information returned for links will be about their references, instead of themselves.

info

0..1

 

The list of properties to retrieve the information for. Simply include any of the following elements in the request if you would like the corresponding information to be included in the output.

{

 

 

 

user

0..1

none

User name.

group

0..1

none

Group name.

uid

0..1

none

User ID.

gid

0..1

none

Group ID.

mode

0..1

none

Mode.

size

0..1

none

Size.

date

0..1

none

Date.

links

0..1

none

Hard link information.

link_name

0..1

none

Link name.

content_type

0..1

none

File element content type.

}

 

 

 

Returns:

Name

Min/Max

Type

Description

file

0..[]

fileType

Status information.

Example:

Get the status of the "/" directory.

Input

<packet version="4.0.0" progress="on">

<dst>

<host>24b9acf5-8ca5-49c9-b7b1-4c93fe048389</host>

</dst>

<target>filer</target>

<data>

<filer>

<stat>

<cwd>Lw==</cwd>

<path>Lw==</path>

</stat>

</filer>

</data>

</packet>

Output

<ns1:packet priority="0" version="4.0.0">

<ns1:origin>filer</ns1:origin>

<ns1:target>vzclient3</ns1:target>

<ns1:data>

<ns2:filer>

<ns2:file>

<ns2:name>Lw==</ns2:name>

<ns2:type>4</ns2:type>

<ns2:mode>493</ns2:mode>

<ns2:user>root</ns2:user>

<ns2:group>root</ns2:group>

<ns2:uid>0</ns2:uid>

<ns2:gid>0</ns2:gid>

<ns2:links>27</ns2:links>

<ns2:size>0</ns2:size>

<ns2:date>2007-01-24T01:50:25+0000</ns2:date>

</ns2:file>

</ns2:filer>

</ns1:data>

</ns1:packet>

Please send us your feedback on this help page