ISTAT(1,C)                  AIX Commands Reference                   ISTAT(1,C)



-------------------------------------------------------------------------------
istat



PURPOSE

Examines inodes.

SYNTAX


         +----- filename ------+
istat ---|                     |---|
         +- inumber -- device -+


DESCRIPTION

The istat command writes information about the inodes specified with inumber to
standard output.  Use the istat command to write information about the inode
for a specified file name, or to write the contents of a specified inode,
inumber on an arbitrary file system.

If you specify file name, istat writes the following information about the
file:

  o The device where the file resides.
  o The inode number of the file, on that device.
  o Global File system number (gfs)-network-wide unique for the logical file
    system.  Separate copies of same replicated file system have the same gfs;
    it is the pair (gfs number, inode number) that uniquely identifies a file.
  o The file type (normal, directory, block device, and so on).
  o What protection is on the file.
  o The name and identification number of the owner and group.
  o The number of links to the file.
  o If the inode is for a normal file, the length of the file.
  o If inode is for a device, the major and minor device designations.
  o Inode Generation number - the number of times this Inode has been
    allocated.
  o Version number of the file - count of number of times the file has been
    updated.
  o Commit sequence number - number of file system changes which preceded last
    change to this file.
  o fstore value - indication of which sites store the file system if the file
    system is replicated.
  o The date of the last time the inode was updated.
  o The date of the last time the file was modified.
  o The date of the last time the file was referenced.






Processed November 8, 1990        ISTAT(1,C)                                  1

ISTAT(1,C)                  AIX Commands Reference                   ISTAT(1,C)



If you specify inumber and device, istat also displays, in long decimal values,
the block numbers recorded in the inode.  You can specify the device as either
a device name or as a mounted-file-system name.

EXAMPLES

  1. To display the information stored in a file inode:

      istat  /bin/sh

    This displays the inode information for the file "/bin/sh".  The
    information looks something like this:

      Inode 3812 on global file system 1 (site1 device 0/1)
      Type: file                    Protection:  r-xr-xr-x
      Owner:  2(bin)                Group:       2(bin)
      Link count: 2                 Length:      83460 bytes

      Inode Generation: 91          Version:  2
      Commit Sequence:  629019
      fstore: 7000 (i386)

      Last update:    Wed Mar 15 10:09:29 1989
      Last modified:  Wed Mar 15 10:09:29 1989
      Last accessed:  Wed Mar 15 11:15:57 1989

  2. To display inode information if given a file i-number:

      istat  34  /dev/hd0

    This displays the information contained in inode number "34" on the
    "/dev/hd0" device.  In addition to the information shown in Example 1, this
    displays:

      Block pointers:
           219   220   221   222   223   224   225   226
           227   228   229    0    0

    These numbers are addresses of the disk blocks that contain the data in the
    file.

RELATED INFORMATION

See the following command:  "fsdb."

See the statx system call and the file systems and fs files in AIX Operating
System Technical Reference.








Processed November 8, 1990        ISTAT(1,C)                                  2