Skip to main content

vserver nfs pnfs devices show

Contributors
Suggest changes

Display pNFS device information

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

Description

The `vserver nfs pnfs devices show` command displays a pNFS device for a given instance of a volume. The command output depends on the parameter or parameters specified with the command. If you do not specify any parameters, the command displays the following information about all pNFS devices:
  • Vserver name

  • The global device mapping identifier of the device

  • The master data set ID (MSID) of the volume that leads to this device

  • The mapping status of the device

  • The generation number of the device

You can specify additional parameters to display only information that matches those parameters. For instance, to display information only about devices that are exported as write-only devices, enter the command with the -access-flags 1 parameter.

Parameters

{ [-fields <fieldname>,…​]

If you specify the -fields parameter, the command only displays the fields that you specify.

| [-instance ] }

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

[-global-device-table-id <integer>] - Global Device Mapping Table ID (privilege: advanced)

If you specify this parameter, the command displays information only about the unique identifier that the pNFS devices subsystem assigns to the device that is being output.

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

If you specify this parameter, the command displays information only about the Vserver that owns the volume represented by MSID.

[-msid <integer>] - Volume MSID (privilege: advanced)

If you specify this parameter, the command displays information only about the volume or volumes that match the specified MSID.

[-striping-epoch <integer>] - Striping Epoch (privilege: advanced)

If you specify this parameter, the command displays information only about the striping epoch identifier for a volume that serves as the basis for the pNFS device.

[-device-access <integer>] - Device Access Flags (privilege: advanced)

If you specify this parameter, the command displays information only about access flags which specify the type of access that is given to the pNFS device. If the value is 1, it means write access. If the value is 0, it means read access.

[-version <integer>] - Device Version (privilege: advanced)

If you specify this parameter, the command displays information only about pNFS devices that match the specified version number.

[-generation-count <integer>] - Device Generation (privilege: advanced)

If you specify this parameter, the command displays information only about generation count associated with the pNFS device identifier.

[-create-time <MM/DD/YYYY HH:MM:SS>] - Device Creation Time (privilege: advanced)

If you specify this parameter, the command displays information only about pNFS devices that were created at the specified time.

[-mapping-status {available|notavailable}] - Device Mapping Status (privilege: advanced)

If you specify this parameter, the command displays information only about if the mapping exists for a device. If the value is set to "available", the mappings can be seen in the device mappings table. If the value is set to "notavailable", the mappings will not be seen in the device mappings table.

Examples

The following example displays the information of a device with global mapping identifier 6. The device corresponds to a volume with MSID 2147484673 on Vserver vs1. The device mappings corresponding to this device follow in the mappings table.

cluster1::*> vserver nfs pnfs devices show
Vserver Name     Mapping ID      Msid            Mapping Status  Generation
---------------  --------------- --------------- --------------- -------------
vs1              1               2147484673      available       6

cluster1::*> vserver nfs pnfs devices mappings show
Vserver Name    Mapping ID      Dsid            LIF IP
--------------  --------------- --------------- --------------------
vs1             1               1025            10.53.4.14