vserver nfs pnfs devices show
Display pNFS device information
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
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
- 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
- If you specify this parameter, the command displays information only about the Vserver that owns the volume represented by MSID.
- [-msid <integer>] - Volume MSID
- 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
- 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
- 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
- If you specify this parameter, the command displays information only about pNFS devices that match the specified version number.
- [-generation-count <integer>] - Device Generation
- 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
- 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
- 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