Skip to main content

volume file show-filehandle

Contributors
Suggest changes
PDFs

Show the file handle of a file

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

Description

This command requires a path to a file in a volume and displays the file handle and volume information described below:

  • Vserver name

  • Path to the file

  • File handle flags

  • Snapshot ID of the file (snapid)

  • File ID

  • File handle generation number

  • File system ID (fsid)

  • Master data set ID (msid)

  • Data set ID (dsid)

  • Volume or constituent name

If not logged in as a Vserver administrator, the command also requires a Vserver name.

Parameters

[-fields <fieldname>,…​]

If you specify the -fields <fieldname>, …​ parameter, the command output also includes the specified field or fields. You can use '-fields ?' to display the fields to specify.

| [-instance ] (privilege: advanced) }

If you specify the -instance parameter, the command displays detailed information about all fields.

[-vserver <vserver name>] - Vserver Managing Volume (privilege: advanced)

This specifies the Vserver where the file resides.

[-path <text>] - Path to File (privilege: advanced)

This specifies the path to the file.

Examples

The following example displays the file handle and volume information of a file named file1.txt in the volume /vol/vol1 .

cluster1::> volume file show-filehandle -vserver vs0 -path /vol/vol1/file1.txt
             Vserver                    Path
             ----------------------     -------------------------------------
             vs0                        /vol/vol1/file1.txt
flags   snapid  fileid     generation  fsid        msid          dsid
             ------- ------  ---------  ----------  ----------  ------------  -------------
             0x0     0       0x60       0x206b6     0x402       0x80000402    0x402
volume
             ------------------------------------------------------------------------------
             vol1__0003