Created examples directory and adjusted README

1 files changed, 42 insertions, 0 deletions

diff --git a/examples/client6/main.go b/examples/client6/main.go
new file mode 100644
index 0000000..41cf692
--- /dev/null
+++ b/examples/client6/main.go
@@ -0,0 +1,42 @@
+package main
+
+import (
+	"flag"
+	"log"
+
+	"github.com/insomniacslk/dhcp/dhcpv6/client6"
+)
+
+var (
+	iface = flag.String("i", "eth0", "Interface to configure via DHCPv6")
+)
+
+func main() {
+	flag.Parse()
+	log.Printf("Starting DHCPv6 client on interface %s", *iface)
+
+	// NewClient sets up a new DHCPv6 client with default values
+	// for read and write timeouts, for destination address and listening
+	// address
+	client := client6.NewClient()
+
+	// Exchange runs a Solicit-Advertise-Request-Reply transaction on the
+	// specified network interface, and returns a list of DHCPv6 packets
+	// (a "conversation") and an error if any. Notice that Exchange may
+	// return a non-empty packet list even if there is an error. This is
+	// intended, because the transaction may fail at any point, and we
+	// still want to know what packets were exchanged until then.
+	// A default Solicit packet will be used during the "conversation",
+	// which can be manipulated by using modifiers.
+	conversation, err := client.Exchange(*iface)
+
+	// Summary() prints a verbose representation of the exchanged packets.
+	for _, packet := range conversation {
+		log.Print(packet.Summary())
+	}
+	// error handling is done *after* printing, so we still print the
+	// exchanged packets if any, as explained above.
+	if err != nil {
+		log.Fatal(err)
+	}
+}