Dell Mellanox Family of Adapters - Manual (Page 46)

Driver Installation and Configuration Rev 1.1
Mellanox Technologies 46
4.2.7.6 Configuring Pkeys and GUIDs under SR-IOV
4.2.7.6.1 SRIOV sysfs Administration Interfaces on the Hypervisor
Administration of GUIDs and PKeys is done via the sysfs interface in the Hypervisor (Dom0).
This interface is under:
Under this directory, the following subdirectories can be found:
• ports - The actual (physical) port resource tables
Port GID tables:
• ports//gids/ where 0 <= n <= 127 (the physical port gids)
• ports//admin_guids/ where 0 <= n <= 127 (allows examining or changing the
administrative state of a given GUID>
• ports//pkeys/ where 0 <= n <= 126 (displays the contents of the physical pkey
table)
• directories - one for Dom0 and one per guest. Here, you may see the map-
ping between virtual and physical pkey indices, and the virtual to physical gid 0.
Currently, the GID mapping cannot be modified, but the pkey virtual to physical mapping can .
These directories have the structure:
• /port//gid_idx/0 where m = 1..2 (this is read-only)
and
• /port//pkey_idx/ , where m = 1..2 and n = 0..126
For instructions on configuring pkey_idx, please see below.
4.2.7.6.2 Configuring an Alias GUID (under ports//admin_guids)
Step 1. Determine the GUID index of the PCI Virtual Function that you want to pass through to a
guest.
For example, if you want to pass through PCI function 02:00.3 to a certain guest, you ini-
tially need to see which GUID index is used for this function.
To do so:
The value returned will present which guid index to modify on Dom0.
Step 2. Modify the physical GUID table via the admin_guids sysfs interface.
To configure the GUID at index on port :
Only the PFs are set via this mechanism. The VFs inherit their port types from their asso-
ciated PF.
/sys/class/infiniband//iov
cat /sys/class/infiniband/iov/0000:02:00.3/port//gid_idx/0
cd /sys/class/infiniband/mlx4_0/iov/ports//admin_guids
echo > n