fstat(TCL)

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.