CLRI(8,C)                   AIX Commands Reference                    CLRI(8,C)



-------------------------------------------------------------------------------
clri



PURPOSE

Clears a specified inode.

SYNTAX


        +--------+
clri ---| one of |-- filesystem -- inumber --|
        | +----+ |               ^         |
        +-| -f |-+               +---------+
          | -q |
          +----+


Warning: See restrictions, Chapter 18, AIX Programming Tools and Interfaces.

DESCRIPTION

Warning: Use this command only in emergencies and with extreme care.

The clri command is used to clear inode entries for files that do not appear in
a directory.  In general, you do not need to use this program because, the fsck
command can deal with most file system inconsistencies.

Running the clri command can create dangling references or missing blocks.
Therefore, after you run this command, you should run the fsck command on the
file system.  These can be fixed if they are attended to promptly.  Do not run
the system when the file system has dangling directory references or a bad free
list.

The clri command zeroes over the flags word of the inode, thus freeing the
inode for reallocation.  The inumber parameter specifies the inode and
filesystem specifies the file system the inode is on.  The inumber parameter
should be a decimal number, while filesystem can be either the name of the
device on which the file system resides or the name by which it is normally
mounted.  In the latter form, the file system must be one normally mounted on
the local cluster site.

If you use the clri command to remove an inode that does appear in a directory,
you should track down and remove all inode entries.  Otherwise, when the inode
is reallocated to a new file, the old entry still points to that file.  At that
point, removing the old entry destroys the new file and the new entry again
points to an unallocated inode.






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

CLRI(8,C)                   AIX Commands Reference                    CLRI(8,C)



By default, the clri command displays information about the file and asks for
confirmation before it destroys the file.  If you enter a "y" or "yes", the
file is destroyed.

Note:  If the file is open, the clri command is likely to be ineffective.  For
       this reason, you should run this command only on an unmounted file
       system.

FLAGS

-f    Destroys the file without confirmation, but writes a description of the
      file.

-q    Destroys the file without confirmation, but does not write a description
      of the file.

EXAMPLE

To clear inodes "170" and "368" of the file system "/diskette0" and then clean
up the file system:

  clri  /diskette0  170  368
  fsck  /diskette0

RELATED INFORMATION

See the following commands:  "fsck, dfsck" and "fsdb."

See the fs file in AIX Operating System Technical Reference.


























Processed November 8, 1990         CLRI(8,C)                                  2