Index | Thread | Search

From:
hshoexer <hshoexer@yerbouti.franken.de>
Subject:
iked/isakmpd: Explain ikev1 keyword and mention daemon coupling
To:
tech@openbsd.org
Date:
Mon, 9 Nov 2026 22:25:38 +0100

Download raw body.

Thread
Hi,

some basic documentation for ikev1 in iked.conf.  And mention in
the isakmpd manpage the "internal" option for coupling with iked.

ok?

Take care,
HJ.

---
 sbin/iked/iked.conf.5  | 30 ++++++++++++++++++++++++++++++
 sbin/isakmpd/isakmpd.8 | 11 +++++++++++
 2 files changed, 41 insertions(+)

diff --git a/sbin/iked/iked.conf.5 b/sbin/iked/iked.conf.5
index d7f1c75bcfa..886ca65c2c8 100644
--- a/sbin/iked/iked.conf.5
+++ b/sbin/iked/iked.conf.5
@@ -293,6 +293,36 @@ or any included files.
 If omitted,
 a name will be generated automatically for the policy.
 .Pp
+.It Xo
+.Ic ikev1
+.Op Ar name
+.Xc
+The
+.Ic ikev1
+keyword identifies an IKEv1 automatic keying policy, handled by the
+IKEv1 process of
+.Xr iked 8 .
+It takes the same options as
+.Ic ikev2 ,
+with restrictions:
+only
+.Ic psk
+authentication is supported,
+.Ar peer
+must be a single address,
+.Ic active
+mode also needs a single
+.Ar local
+address,
+and cipher suites, lifetimes, configuration payloads,
+.Ic iface
+and
+.Ic tap
+cannot be given.
+The IKEv1 process negotiates Main Mode with AES-128, HMAC-SHA2-256 and
+Diffie-Hellman group modp3072, and Quick Mode with AES-128, HMAC-SHA2-256
+and perfect forward secrecy using modp3072.
+.Pp
 .It Op Ar eval
 The
 .Ar eval
diff --git a/sbin/isakmpd/isakmpd.8 b/sbin/isakmpd/isakmpd.8
index 9dcd3d27e37..9550d305ef9 100644
--- a/sbin/isakmpd/isakmpd.8
+++ b/sbin/isakmpd/isakmpd.8
@@ -271,6 +271,17 @@ With verbose logging
 reports successful completion of phase 1 (Main and Aggressive) and phase 2
 (Quick) exchanges (Information and Transaction exchanges do not generate any
 additional status information).
+.It Fl Fl iked-mode
+Run as the IKEv1 process of
+.Xr iked 8 .
+This flag is used internally by
+.Xr iked 8 ,
+which starts
+.Nm
+with its own command line following the flag and talks to it over
+.Xr imsg_init 3
+channels.
+It is not meant to be used directly.
 .El
 .Sh THE FIFO USER INTERFACE
 When
-- 
2.56.0