commit 05edc1c31a433c513cd0d0961fcf54f96c2d7984
Author: W. David Ashley <w.david.ashley(a)gmail.com>
Date: Wed Aug 5 10:37:26 2015 -0500
Virtual Networks chapter
- added example 1
- added support text for example 1
en-US/Virtual_Networks.xml | 8 +++++-
en-US/extras/VirtualNetworks-Example-1.py | 35 +++++++++++++++++++++++++++++
2 files changed, 42 insertions(+), 1 deletions(-)
---
diff --git a/en-US/Virtual_Networks.xml b/en-US/Virtual_Networks.xml
index 22b6c08..7160cb1 100644
--- a/en-US/Virtual_Networks.xml
+++ b/en-US/Virtual_Networks.xml
@@ -64,8 +64,14 @@
<section
id="libvirt_application_development_guide_using_python-Virtual_Networks-Listing">
<title>Listing networks</title>
<para>
- TBD
+ Virtual networks are discovered using the methods
<literal>networkLookupByName</literal>,
+ <literal>networkLookupByUUID</literal>, and
<literal>networkLookupByUUIDString</literal>
+ and <literal>listNetworks</literal>. The following example shws
how to used these methods.
</para>
+ <example>
+ <title>Discovering and finding virtual networks</title>
+ <programlisting language="Python"><xi:include
href="extras/VirtualNetworks-Example-1.py" parse="text"
xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting>
+ </example>
</section>
<section
id="libvirt_application_development_guide_using_python-Virtual_Networks-Lifecycle">
diff --git a/en-US/extras/VirtualNetworks-Example-1.py
b/en-US/extras/VirtualNetworks-Example-1.py
new file mode 100644
index 0000000..ed1ab82
--- /dev/null
+++ b/en-US/extras/VirtualNetworks-Example-1.py
@@ -0,0 +1,35 @@
+# Example-1.py
+from __future__ import print_function
+import sys
+import libvirt
+
+conn = libvirt.open('qemu:///system')
+if conn == None:
+ print('Failed to open connection to qemu:///system', file=sys.stderr)
+ exit(1)
+
+# discover all the virtual networks
+networks = conn.listNetworks()
+print('Virtual networks:')
+for network in networks:
+ print(' '+network)
+print()
+
+# lookup the default network by name
+network = conn.networkLookupByName('default')
+print('Virtual network default:')
+print(' name: '+network.name())
+uuid = network.UUIDString()
+print(' UUID: '+uuid)
+print(' bridge: '+network.bridgeName())
+print()
+
+# lookup the default network by name
+network = conn.networkLookupByUUIDString(uuid)
+print('Virtual network default:')
+print(' name: '+network.name())
+print(' UUID: '+network.UUIDString())
+print(' bridge: '+network.bridgeName())
+
+conn.close()
+exit(0)