public inbox for passt-dev@passt.top
 help / color / mirror / code / Atom feed
From: Anshu Kumari <anskuma@redhat.com>
To: sbrivio@redhat.com, passt-dev@passt.top
Cc: lvivier@redhat.com, anskuma@redhat.com
Subject: [PATCH v7 7/7] dhcp: Add RFC 3396 option splitting for concatenation-requiring options
Date: Thu,  1 Oct 2026 18:46:00 +0530	[thread overview]
Message-ID: <20261001131602.653553-8-anskuma@redhat.com> (raw)
In-Reply-To: <20261001131602.653553-1-anskuma@redhat.com>

Implement option splitting per RFC 3396 for options that may exceed
255 bytes.  A concat_req[] lookup table marks options requiring
concatenation (currently option 81, Client FQDN per RFC 4702).

The opts[].s buffer is resized from 255 to OPT_CONCAT_MAX to
hold the maximum data that can be split across the options
field, file field, and sname field.

When a concatenation-requiring option does not fit as a single
option in any field, fill() calls fill_split() to split it across
fields in RFC 3396 order: options field first, then file, then
sname.  Each split chunk is capped at 255 bytes per the DHCP
option length field limit.

Link: https://bugs.passt.top/show_bug.cgi?id=192
Signed-off-by: Anshu Kumari <anskuma@redhat.com>
---
v7:
  - Capped each split chunk at 255 bytes:
    chunk = MIN(MIN(remaining, avail), 255) to prevent
    overflow in the uint8_t length field
  - Replaced inline space calculation with a dry-run pass
    via fill_split_areas()
  - Moved OPT_MAX and OPT_CONCAT_MAX definitions above struct opt.
  - Reordered struct opt fields to place s[OPT_CONCAT_MAX]
  - Added dry_run parameter to fill_split()

v6:
- Merged v5 patches 6/7 and 7/7 into a single patch.
- Replaced DHCP_OPT_STR_CONCAT enum value and is_concat_opt()
  helper with a concat_req[] boolean lookup table.
- Used MIN() macro instead of ternary for chunk size.
- Fixed space calculation to account for 2-byte code+length
  overhead per chunk.

v5:
  - New patch: implement option splitting per RFC 3396 for options exceeding 255 bytes
  - Add DHCP_OPT_STR_CONCAT type, is_concat_opt(), fill_split() helpers
  - Resize opts[].s from 255 to OPT_CONCAT_MAX (497) bytes
  - Add /* fallthrough */ between DHCP_OPT_STR and DHCP_OPT_STR_CONCAT case
---
 dhcp.c | 160 ++++++++++++++++++++++++++++++++++++++++++++++++++-------
 1 file changed, 142 insertions(+), 18 deletions(-)

diff --git a/dhcp.c b/dhcp.c
index 63ac8e3d..990b650d 100644
--- a/dhcp.c
+++ b/dhcp.c
@@ -35,6 +35,19 @@
 #include "dhcp.h"
 #include "parse.h"
 
+#define OPT_MIN		60 /* RFC 951 */
+
+/* Total option size (excluding end option) is 576 (RFC 2131), minus
+ * offset of options (268), minus end option (1).
+ */
+#define OPT_MAX		307
+
+/* RFC 3396: maximum option data that can be split across options field
+ * (OPT_MAX - 2), file field (64 - 2), and sname field (128 - 2),
+ * minus code+length overhead per portion.
+ */
+#define OPT_CONCAT_MAX	(OPT_MAX - 2 + 64 - 2 + 128 - 2)
+
 /**
  * enum opt_conf - DHCP option configuration
  * @OPT_UNSET:		Option not configured
@@ -51,18 +64,18 @@ enum opt_conf {
  * struct opt - DHCP option
  * @sent:	Convenience flag, set while filling replies
  * @slen:	Length of option defined for server
- * @s:		Option payload from server
  * @clen:	Length of option received from client, -1 if not received
  * @c:		Option payload from client
  * @conf:	Option configuration (unset, default, or user)
+ * @s:		Option payload from server
  */
 struct opt {
 	int sent;
 	int slen;
-	uint8_t s[255];
 	int clen;
 	uint8_t c[255];
 	enum opt_conf conf;
+	uint8_t s[OPT_CONCAT_MAX];
 };
 
 static struct opt opts[256];
@@ -79,32 +92,23 @@ static struct opt opts[256];
 #define DHCPINFORM	8
 #define DHCPFORCERENEW	9
 
-#define OPT_MIN		60 /* RFC 951 */
-
-/* Total option size (excluding end option) is 576 (RFC 2131), minus
- * offset of options (268), minus end option (1).
- */
-#define OPT_MAX		307
-
 /**
  * dhcp_init() - Initialise DHCP options
  */
 void dhcp_init(void)
 {
 	if (opts[1].conf != OPT_USER) 			/* Mask */
-		opts[1] = (struct opt) { 0, 4, {  0 }, 0, { 0 }, OPT_DEFAULT };
+		opts[1] = (struct opt) { 0, 4, 0, { 0 }, OPT_DEFAULT, { 0 } };
 	if (opts[3].conf != OPT_USER) 			/* Router */
-		opts[3] = (struct opt) { 0, 4, {  0 }, 0, { 0 }, OPT_DEFAULT };
+		opts[3] = (struct opt) { 0, 4, 0, { 0 }, OPT_DEFAULT, { 0 } };
 	if (opts[51].conf != OPT_USER) {		/* Lease time */
-		opts[51] = (struct opt) { 0, 4, { 0xff, 0xff, 0xff, 0xff },
-					       0, { 0 }, OPT_DEFAULT };
+		opts[51] = (struct opt) { 0, 4, 0, { 0 }, OPT_DEFAULT,
+					  { 0xff, 0xff, 0xff, 0xff } };
 	}
 	/* Type */
-	opts[53] = (struct opt) { 0, 1, {  0 }, 0, { 0 }, OPT_DEFAULT };
-	if (opts[54].conf != OPT_USER) {		/* Server ID */
-		opts[54] = (struct opt) { 0, 4, {  0 }, 0, { 0 },
-							OPT_DEFAULT };
-	}
+	opts[53] = (struct opt) { 0, 1, 0, { 0 }, OPT_DEFAULT, { 0 } };
+	if (opts[54].conf != OPT_USER) 		/* Server ID */
+		opts[54] = (struct opt) { 0, 4, 0, { 0 }, OPT_DEFAULT, { 0 } };
 }
 
 /**
@@ -211,6 +215,11 @@ static const enum dhcp_opt_type dhcp_opt_types[] = {
 	[252] = DHCP_OPT_STR,		/* WPAD URL */
 };
 
+/* Options requiring RFC 3396 concatenation, indexed by code */
+static const bool concat_req[256] = {
+	[81] = true,	/* Client FQDN (RFC 4702, Section 2) */
+};
+
 /**
  * dhcp_opt_parse() - Parse a DHCP option value
  * @code:	DHCP option code
@@ -308,6 +317,9 @@ static int dhcp_opt_parse(uint8_t code, const char *str,
 	case DHCP_OPT_STR:
 		slen = strlen(str);
 
+		if (!concat_req[code] && slen > 255)
+			return -1;
+
 		if (slen > buf_len)
 			return -1;
 
@@ -441,6 +453,45 @@ static void fill_one(uint8_t *buf, size_t size, int o, int *offset)
 	*offset += slen;
 }
 
+/**
+ * fill_split() - Write a split portion of an option into a buffer
+ * @buf:	Buffer to write into
+ * @size:	Usable size of @buf
+ * @o:		Option number (code)
+ * @offset:	Current offset within @buf, updated on write
+ * @data:	Pointer to remaining option data to write
+ * @remaining:	Bytes of option data still to write
+ * @dry_run:	If true, calculate size without writing to @buf
+ *
+ * Return: number of data bytes written (excluding code+length header)
+ */
+static size_t fill_split(uint8_t *buf, size_t size, int o, int *offset,
+			 const uint8_t *data, size_t remaining,
+			 bool dry_run)
+{
+	size_t avail, chunk;
+
+	if (*offset + 2 >= (int)size)
+		return 0;
+
+	avail = size - *offset - 2;
+	chunk = MIN(MIN(remaining, avail), 255);
+	if (!chunk)
+		return 0;
+
+	if (!dry_run) {
+		buf[*offset] = o;
+		buf[*offset + 1] = chunk;
+	}
+	*offset += 2;
+
+	if (!dry_run)
+		memcpy(buf + *offset, data, chunk);
+	*offset += chunk;
+
+	return chunk;
+}
+
 /**
  * enum dhcp_overload - DHCP option overload values (RFC 2132, Section 9.3)
  * @DHCP_OVERLOAD_NONE:		No overload
@@ -453,6 +504,43 @@ enum dhcp_overload {
 	DHCP_OVERLOAD_SNAME = 2,
 };
 
+/**
+ * fill_split_areas() - Write a split option across options, file, and sname areas
+ * @m:			Message to write into
+ * @opt_size:		Usable size of the options area
+ * @o:			Option number (code)
+ * @opt_off:		Current offset within options area, updated on write
+ * @file_off:		Current offset within file area, updated on write
+ * @sname_off:		Current offset within sname area, updated on write
+ * @has_bootfile:	If true, skip the file field
+ * @dry_run:		If true, calculate size without writing
+ *
+ * Return: total data bytes written across all areas
+ */
+static size_t fill_split_areas(struct msg *m, size_t opt_size, int o,
+			       int *opt_off, int *file_off, int *sname_off,
+			       bool has_bootfile, bool dry_run)
+{
+	size_t written = 0;
+
+	written += fill_split(m->o, opt_size, o, opt_off,
+			      opts[o].s, opts[o].slen, dry_run);
+	if (written < (size_t)opts[o].slen && !has_bootfile) {
+		written += fill_split(m->file, sizeof(m->file) - 1, o,
+				      file_off,
+				      opts[o].s + written,
+				      opts[o].slen - written, dry_run);
+	}
+	if (written < (size_t)opts[o].slen) {
+		written += fill_split(m->sname, sizeof(m->sname) - 1, o,
+				      sname_off,
+				      opts[o].s + written,
+				      opts[o].slen - written, dry_run);
+	}
+
+	return written;
+}
+
 /**
  * fill() - Fill options in message, with overload into file/sname if needed
  * @m:			Message to fill
@@ -504,6 +592,42 @@ static int fill(struct msg *m, bool has_bootfile)
 		}
 	}
 
+	/* RFC 3396: split concatenation-requiring options that didn't fit
+	 * as a single option.  Split order: options, file, sname.
+	 */
+	foreach_opt(o) {
+		int dry_off, dry_file_off, dry_sname_off;
+		size_t total, written;
+
+		if (opts[o].conf == OPT_UNSET || opts[o].sent ||
+		    !concat_req[o])
+			continue;
+
+		/* Dry run: verify the option fits across all areas */
+		dry_off = offset;
+		dry_file_off = file_off;
+		dry_sname_off = sname_off;
+
+		total = fill_split_areas(m, size, o,
+					 &dry_off, &dry_file_off,
+					 &dry_sname_off,
+					 has_bootfile, true);
+
+		if (total < (size_t)opts[o].slen) {
+			debug("DHCP: skipping option %i (no space to split)",
+			      o);
+			continue;
+		}
+
+		/* Actual write */
+		written = fill_split_areas(m, size, o,
+					   &offset, &file_off, &sname_off,
+					   has_bootfile, false);
+
+		if (written >= (size_t)opts[o].slen)
+			opts[o].sent = 1;
+	}
+
 	/* Report any options that could not be sent */
 	foreach_opt(o) {
 		if (opts[o].conf != OPT_UNSET && !opts[o].sent)
-- 
2.55.0


      parent reply	other threads:[~2026-10-01 13:16 UTC|newest]

Thread overview: 8+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2026-10-01 13:15 [PATCH v7 0/7] Add --dhcp-boot and --dhcp-opt options Anshu Kumari
2026-10-01 13:15 ` [PATCH v7 1/7] dhcp: Refactor fill_one() to operate on a generic buffer Anshu Kumari
2026-10-01 13:15 ` [PATCH v7 2/7] dhcp: Add option configuration tracking with enum opt_conf Anshu Kumari
2026-10-01 13:15 ` [PATCH v7 3/7] dhcp: Add --dhcp-opt with option table and value parser Anshu Kumari
2026-10-01 13:15 ` [PATCH v7 4/7] dhcp: Add --dhcp-boot command-line option Anshu Kumari
2026-10-01 13:15 ` [PATCH v7 5/7] dhcp: Change fill_one() to return void Anshu Kumari
2026-10-01 13:15 ` [PATCH v7 6/7] dhcp: Add option overload Anshu Kumari
2026-10-01 13:16 ` Anshu Kumari [this message]

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20261001131602.653553-8-anskuma@redhat.com \
    --to=anskuma@redhat.com \
    --cc=lvivier@redhat.com \
    --cc=passt-dev@passt.top \
    --cc=sbrivio@redhat.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

	https://passt.top/passt

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for IMAP folder(s).