From 1a590b3ffa9241eea4930bf851a19e3da199441c Mon Sep 17 00:00:00 2001
From: Matthias Radestock <matthias.radestock@gmail.com>
Date: Sat, 23 Jan 2016 09:01:41 +0000
Subject: [PATCH] document `--name`

---
 site/ipam.md | 9 ++++++++-
 weave        | 2 +-
 2 files changed, 9 insertions(+), 2 deletions(-)

diff --git a/site/ipam.md b/site/ipam.md
index a50893c1..1e9c0d62 100644
--- a/site/ipam.md
+++ b/site/ipam.md
@@ -184,7 +184,14 @@ previously using.
 
 The same normally happens when a peer is restarted any other way,
 e.g. as result of a reboot, provided the
-[system-uuid](http://linux.die.net/man/8/dmidecode) didn't change.
+[system-uuid](http://linux.die.net/man/8/dmidecode) didn't change,
+from which weave derives the peer name. In circumstances where the
+system-uuid is not stable, the weave peer name can be specified on
+`weave launch` with the `--name` option in form of MAC address, e.g.
+
+    host1$ weave launch --name d2:e1:4d:cc:92:15
+
+_NOTE: Do not do this unless absolutely necessary._
 
 If you want to remove a peer from the network, run `weave reset`. This
 removes the ranges allocated to the peer, thus allowing other peers to
diff --git a/weave b/weave
index 04e14be2..d4c09437 100755
--- a/weave
+++ b/weave
@@ -39,7 +39,7 @@ weave --help | help
       version
 
 weave launch        <same arguments as 'weave launch-router'>
-      launch-router [--password <password>] [--nickname <nickname>]
+      launch-router [--password <pass>] [--name <mac>] [--nickname <nickname>]
                       [--ipalloc-range <cidr> [--ipalloc-default-subnet <cidr>]]
                       [--init-peer-count <count>] [--no-discovery]
                       [--trusted-subnets <cidr>,...] <peer> ...