volume file show-inode

Display file paths for a given inode

Availability: This command is available to cluster and Vserver administrators at the admin privilege level.

Description

This command displays information about all the files having a given inode in a volume of a Vserver. If the -snapshot-id or -snapshot-name parameter is specified, the command displays file information from the Snapshot copy; otherwise, it displays the information from the active file system. The -vserver, -volume and -inode-number are mandatory parameters.

If no optional parameter is specified, the command displays the following fields for all the files having the given inode:
  • Vserver Name
  • Volume Name
  • Inode Number
  • File Path
The volume file show-inode command is only supported on flexible volumes and FlexGroup constituents.

Parameters

{ [-fields <fieldname>, ...]
If you specify the -fields parameter, the command output also includes the specified field or fields.
| [-snapshot ]
If this parameter is specified, the command displays the following information:
  • Vserver Name
  • Volume Name
  • Inode Number
  • Snapshot Name
  • Snapshot ID
  • File Path
| [-instance ]}
If this parameter is specified, the command displays detailed information about the files matching the specified inode number. The following information is displayed:
  • Vserver Name
  • Volume Name
  • Inode Number
  • File Path
  • Snapshot Name
  • Snapshot ID
  • File Name
  • Parent Inode Number
  • Parent Directory Cookie
-vserver <vserver name> - Vserver Name
This specifies the Vserver in which the volume or Snapshot copy is located.
-volume <volume name> - Volume Name
This specifies the volume in which the inode number is located.
-inode-number <integer> - Inode Number
This specifies the inode number whose information has to be retrieved.
{ [-snapshot-name <snapshot name>] - Snapshot Name
If this parameter or -snapshot-id is specified, information about the files is retrieved from the Snapshot copy instead of the active file system.
| [-snapshot-id <integer>]} - Physical Snapshot ID
If this parameter or -snapshot-name is specified, information about the files is retrieved from the Snapshot copy instead of the active file system.
[-file-path <text>] - File Path
If this parameter is specified, the command displays information only about the files that match the specified file path.
[-file-name <text>] - File Name
If this parameter is specified, the command displays information only about the files that match the specified file name.
[-parent-inode-number <integer>] - Parent Inode Number
The inode number of the parent directory of the file associated with the inode. If this parameter is specified, the command displays information only about the files that match the specified parent inode number.
[-parent-dir-cookie <integer>] - Parent Directory Cookie
The index of the directory entry of the file in its parent directory tree. If this parameter is specified, the command displays information only about the files that match the specified parent directory cookie.

Examples

The following example displays information about all the files having the inode number 96 in the active file system of a volume named vol1 on a Vserver named vs1:

cluster1::> volume file show-inode -vserver vs1 -volume vol1 -inode-number 96
                               Inode
        Vserver   Volume       Number   File Path
        --------- ------------ -------- ----------------------------------
        vs1       vol1         96       /vol/vol1/file1
        vs1       vol1         96       /vol/vol1/file2
        vs1       vol1         96       /vol/vol1/A/file2
        3 entries were displayed.
        

The following example displays information about all the files with inode number 96 in a Snapshot copy named mysnap. The Snapshot copy is present in a volume named vol1 on a Vserver named vs1:

cluster1::> volume file show-inode -vserver vs1 -volume vol1 -inode-number 96 -snapshot-name mysnap -snapshot
                               Inode    Snapshot Snapshot
        Vserver   Volume       Number   Name     ID        File Path
        --------- ------------ -------- -------- -------- -------------------------
        vs1       vol1         96       mysnap   131      /vol/vol1/.snapshot/mysnap/file1
        vs1       vol1         96       mysnap   131      /vol/vol1/.snapshot/mysnap/file2
        2 entries were displayed.
        

The following example displays detailed information about all the files with inode number 96 in a Snapshot copy named mysnap. The Snapshot copy is present in a volume named vol1 on a Vserver named vs1:

cluster1::> volume file show-inode -vserver vs1 -volume vol1 -inode-number 96 -snapshot-name mysnap -instance

                Vserver Name: vs1
                 Volume Name: vol1
                Inode number: 96
                   File Path: /vol/vol1/.snapshot/mysnap/file1
               Snapshot Name: mysnap
        Physical Snapshot ID: 131
                   File Name: file1
         Parent Inode Number: 64
     Parent Directory Cookie: 2

                Vserver Name: vs1
                 Volume Name: vol1
                Inode number: 96
                   File Path: /vol/vol1/.snapshot/mysnap/file2
               Snapshot Name: mysnap
        Physical Snapshot ID: 131
                   File Name: file2
         Parent Inode Number: 64
     Parent Directory Cookie: 3
        2 entries were displayed.