New peer option `-mobile': follow rapid IP address and port changes.

[tripe] / server / tripe-admin.5.in

diff --git a/server/tripe-admin.5.in b/server/tripe-admin.5.in
index 2142674..5b0fe3b 100644 (file)
--- a/server/tripe-admin.5.in
+++ b/server/tripe-admin.5.in
@@ -354,6 +354,16 @@ Use the public key
 to authenticate the peer.  The default is to use the key tagged
 .IR peer .
 .TP
 to authenticate the peer.  The default is to use the key tagged
 .IR peer .
 .TP

+.B "\-mobile"
+The peer is a mobile device, and is likely to change address rapidly.
+If a packet arrives from an unknown address, the server's usual response
+is to log a warning and discard it.  If the server knows of any mobile
+peers, however, it will attempt to decrypt the packet using their keys,
+and if one succeeds, the server will update its idea of the peer's
+address and emit an
+.B NEWADDR
+notification.
+.TP

 .BI "\-tunnel " tunnel
 Use the named tunnel driver, rather than the default.
 .\"-opts
 .BI "\-tunnel " tunnel
 Use the named tunnel driver, rather than the default.
 .\"-opts


@@ -1082,6 +1092,12 @@ Key exchange with
 has begun or restarted.  If key exchange keeps failing, this message
 will be repeated periodically.
 .SP
 has begun or restarted.  If key exchange keeps failing, this message
 will be repeated periodically.
 .SP

+.BI "NEWADDR " peer " " address
+The given mobile
+.IR peer 's
+IP address has been changed to
+.IR address .
+.SP

 .BI "NEWIFNAME " peer " " old-name " " new-name
 The given
 .IR peer 's
 .BI "NEWIFNAME " peer " " old-name " " new-name
 The given
 .IR peer 's