fstat(TCLX)

fstat(TCLX)


fstat -- obtain status information on open file

Syntax

fstat fileId [item] | [stat arrayvar]

Description

Obtains status information about an open file.

The following keys are used to identify data items:

atime
The time of last access.

ctime
The time of last file status change.

dev
The device containing a directory for the file. This value uniquely identifies the filesystem that contains the file.

gid
The group ID of the file's group.

ino
The inode number. This field uniquely identifies the file in a given filesystem.

mode
The mode of the file (see the mknod system call).

mtime
The time when the data in the file was last modified.

nlink
The number of links to the file.

size
The file size in bytes.

tty
If the file is associated with a terminal, then 1; otherwise 0.

type
The type of the file in symbolic form, which is one of the following values: file, directory, characterSpecial, blockSpecial, fifo, link, or socket.

uid
The user ID of the file's owner.

If one of these keys is specified as item, then that data item is returned.

If stat arrayvar is specified, then the information is returned in the array arrayvar. Each of the above keys indexes an element of the array containing the data.

If only fileId is specified, the command returns the data as a keyed list.

The following value may be returned only if explicitly asked for. It will not be returned with the array or keyed list forms:

remotehost
If fileId is a TCP/IP socket connection, then a list is returned with the first element being the remote host IP address. If the remote host name can be found, it is returned as the second element of the list.