aboutsummaryrefslogtreecommitdiffstatshomepage
path: root/contrib/examples/extract-keys/README
diff options
context:
space:
mode:
authorJason A. Donenfeld <Jason@zx2c4.com>2016-08-24 17:44:41 +0200
committerJason A. Donenfeld <Jason@zx2c4.com>2016-08-26 04:52:50 +0200
commit7234d7339f570be46b3d916fd7d2561b970b68e8 (patch)
treec9edbcceaf07da2718923c8c9ca48c8cd1f3ef22 /contrib/examples/extract-keys/README
parentexamples: add nat-hole-punching (diff)
downloadwireguard-monolithic-historical-7234d7339f570be46b3d916fd7d2561b970b68e8.tar.xz
wireguard-monolithic-historical-7234d7339f570be46b3d916fd7d2561b970b68e8.zip
examples: add key extractor
Diffstat (limited to 'contrib/examples/extract-keys/README')
-rw-r--r--contrib/examples/extract-keys/README23
1 files changed, 23 insertions, 0 deletions
diff --git a/contrib/examples/extract-keys/README b/contrib/examples/extract-keys/README
new file mode 100644
index 0000000..a91363d
--- /dev/null
+++ b/contrib/examples/extract-keys/README
@@ -0,0 +1,23 @@
+Key Extractor
+=============
+
+This will extract the symmetric ChaCha20Poly1305 session keys from the kernel
+for a WireGuard interface, for use in making packet dissectors.
+
+
+Build:
+ $ make
+
+Run (as root):
+ # ./extract-keys INTERFACE
+
+Output:
+ REMOTE_KEY_ID SENDING_KEY
+ LOCAL_KEY_ID RECEIVING_KEY
+
+Example:
+ # ./extract-keys wg0
+ 0x57b56068 tMTSEOJpEYFAQV2UviDiYooX0A1AD/ONqrzoQVHa1rQ=
+ 0xa182fd19 xvQSkQ5HTX5RUeJ74eAAb/xfNhdrDThxG91GXZIPKmY=
+ 0x01662508 LbMc84JULzXJiHotSkdSOPZ0bHh6IDwOrbxWLfwosTs=
+ 0xbd819021 4VA8lZ3I1HjnJcWTmhEzBdC92W1Aag9Lnyy2GkroOYI=