summaryrefslogtreecommitdiff
path: root/man/nmcli-examples.xml
diff options
context:
space:
mode:
authorBeniamino Galvani <bgalvani@redhat.com>2018-12-03 17:04:34 +0100
committerBeniamino Galvani <bgalvani@redhat.com>2018-12-12 14:38:18 +0100
commitf606124b6212e7d6cc005ff0147e63a30da09586 (patch)
tree13b3a59048351a3ab2331c46b69b11b816542d20 /man/nmcli-examples.xml
parente01a7c1154e0a580f09b76e7735448c54224b2e8 (diff)
downloadNetworkManager-f606124b6212e7d6cc005ff0147e63a30da09586.tar.gz
man: add SR-IOV nmcli example
Add an example on how to configure SR-IOV to the nmcli examples man page. https://bugzilla.redhat.com/show_bug.cgi?id=1651979
Diffstat (limited to 'man/nmcli-examples.xml')
-rw-r--r--man/nmcli-examples.xml17
1 files changed, 17 insertions, 0 deletions
diff --git a/man/nmcli-examples.xml b/man/nmcli-examples.xml
index 32fc567b04..e777c326d1 100644
--- a/man/nmcli-examples.xml
+++ b/man/nmcli-examples.xml
@@ -285,6 +285,23 @@ IP4:192.168.1.12/24:192.168.1.1::192.168.1.1::</screen>
</para>
</example>
+ <example><title>Adding an Ethernet connection and configuring SR-IOV VFs</title>
+<screen><prompt>$ </prompt><userinput>nmcli con add type ethernet con-name EthernetPF ifname em1</userinput>
+<prompt>$ </prompt><userinput>nmcli con modify EthernetPF sriov.total-vfs 3 sriov.autoprobe-drivers false</userinput>
+<prompt>$ </prompt><userinput>nmcli con modify EthernetPF sriov.vfs '0 mac=00:11:22:33:44:55 vlans=10, 1 trust=true spoof-check=false'</userinput>
+<prompt>$ </prompt><userinput>nmcli con modify EthernetPF +sriov.vfs '2 max-tx-rate=20'</userinput></screen>
+ <para>
+ This example demonstrates adding an Ethernet connection for
+ physical function (PF) <emphasis>ens4</emphasis> and
+ configuring 3 SR-IOV virtual functions (VFs) on it. The first
+ VF is configured with MAC address 00:11:22:33:44:55 and VLAN
+ 10, the second one has the <emphasis>trust</emphasis> and
+ <emphasis>spoof-check</emphasis> features respectively enabled
+ and disabled. VF number 2 has a maximux transmission rate of
+ 20Mbps. The kernel is instructed to not automatically
+ instantiate a network interface for the VFs.
+ </para>
+ </example>
<example><title>Escaping colon characters in tabular mode</title>
<screen><prompt>$ </prompt><userinput>nmcli -t -f general -e yes -m tab dev show eth0</userinput>