Skip to main content

vserver nfs pnfs devices mappings show

Contributors
Suggest changes

Display the list of pNFS device mappings

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

Description

The link:vserver-nfs-pnfs-devices-show.html[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 parameters, the command displays the following information about all pNFS devices:
  • Vserver name

  • The global device mapping identifier of the device

  • The Data Set ID (DSID) of the constituent volume

  • The LIF IP address that serves the constituent on the same controller.

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)

This specifies the unique identifier that the pNFS devices subsystem assigns to the device whose mappings are being output.

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

If your specify this parameter, the command displays information only about the Vserver that the mapping identifier and DSID belong to.

[-dsid <integer>] - Constituent Volume DSID (privilege: advanced)

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

[-lifip <IP Address>] - LIF IP Address (privilege: advanced)

If you specify this parameter, the command displays information only about the pNFS devices that match the specified LIF IP address.

Examples

The following example displays the device information of a device with global mapping identifier 6. The device corresponds to a volume with MSID 2147484673 on Vserver vs1. The device has one constituent with DSID 1025 and is served by the LIF with the IP address 10.53.4.14.

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