{"id":2229776,"url":"http://patchwork.ozlabs.org/api/1.1/patches/2229776/?format=json","web_url":"http://patchwork.ozlabs.org/project/ovn/patch/20260428174509.145440-5-mmichels@redhat.com/","project":{"id":68,"url":"http://patchwork.ozlabs.org/api/1.1/projects/68/?format=json","name":"Open Virtual Network development","link_name":"ovn","list_id":"ovs-dev.openvswitch.org","list_email":"ovs-dev@openvswitch.org","web_url":"http://openvswitch.org/","scm_url":"","webscm_url":""},"msgid":"<20260428174509.145440-5-mmichels@redhat.com>","date":"2026-04-28T17:45:04","name":"[ovs-dev,4/5] northd: Fix ovn-northd manpage and usage for options and commands.","commit_ref":null,"pull_url":null,"state":"new","archived":false,"hash":"e3a82162f849a352785e0618bffa396cf3146862","submitter":{"id":71978,"url":"http://patchwork.ozlabs.org/api/1.1/people/71978/?format=json","name":"Mark Michelson","email":"mmichels@redhat.com"},"delegate":null,"mbox":"http://patchwork.ozlabs.org/project/ovn/patch/20260428174509.145440-5-mmichels@redhat.com/mbox/","series":[{"id":501914,"url":"http://patchwork.ozlabs.org/api/1.1/series/501914/?format=json","web_url":"http://patchwork.ozlabs.org/project/ovn/list/?series=501914","date":"2026-04-28T17:45:02","name":"Fix up northd documentation.","version":1,"mbox":"http://patchwork.ozlabs.org/series/501914/mbox/"}],"comments":"http://patchwork.ozlabs.org/api/patches/2229776/comments/","check":"fail","checks":"http://patchwork.ozlabs.org/api/patches/2229776/checks/","tags":{},"headers":{"Return-Path":"","X-Original-To":["incoming@patchwork.ozlabs.org","dev@openvswitch.org"],"Delivered-To":["patchwork-incoming@legolas.ozlabs.org","ovs-dev@lists.linuxfoundation.org"],"Authentication-Results":["legolas.ozlabs.org;\n\tdkim=fail reason=\"signature verification failed\" (1024-bit key;\n unprotected) header.d=redhat.com header.i=@redhat.com header.a=rsa-sha256\n header.s=mimecast20190719 header.b=B4l+DAJj;\n\tdkim-atps=neutral","legolas.ozlabs.org;\n spf=pass (sender SPF authorized) smtp.mailfrom=openvswitch.org\n (client-ip=140.211.166.138; helo=smtp1.osuosl.org;\n envelope-from=ovs-dev-bounces@openvswitch.org; receiver=patchwork.ozlabs.org)","smtp1.osuosl.org;\n\tdkim=fail reason=\"signature verification failed\" (1024-bit key)\n header.d=redhat.com header.i=@redhat.com header.a=rsa-sha256\n header.s=mimecast20190719 header.b=B4l+DAJj","smtp3.osuosl.org; dmarc=pass (p=quarantine dis=none)\n header.from=redhat.com","smtp3.osuosl.org; dkim=pass (1024-bit key,\n unprotected) header.d=redhat.com header.i=@redhat.com header.a=rsa-sha256\n header.s=mimecast20190719 header.b=B4l+DAJj"],"Received":["from smtp1.osuosl.org (smtp1.osuosl.org [140.211.166.138])\n\t(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)\n\t key-exchange x25519 server-signature ECDSA (secp384r1) server-digest SHA384)\n\t(No client certificate requested)\n\tby legolas.ozlabs.org (Postfix) with ESMTPS id 4g4ns41RSSz1yJH\n\tfor ; Wed, 29 Apr 2026 03:45:27 +1000 (AEST)","from localhost (localhost [127.0.0.1])\n\tby smtp1.osuosl.org (Postfix) with ESMTP id F3981835EF;\n\tTue, 28 Apr 2026 17:45:25 +0000 (UTC)","from smtp1.osuosl.org ([127.0.0.1])\n by localhost (smtp1.osuosl.org [127.0.0.1]) (amavis, port 10024) with ESMTP\n id Ho9YEATXAhYN; Tue, 28 Apr 2026 17:45:24 +0000 (UTC)","from lists.linuxfoundation.org (lf-lists.osuosl.org\n [IPv6:2605:bc80:3010:104::8cd3:938])\n\tby smtp1.osuosl.org (Postfix) with ESMTPS id E3C6383455;\n\tTue, 28 Apr 2026 17:45:22 +0000 (UTC)","from lf-lists.osuosl.org (localhost [127.0.0.1])\n\tby lists.linuxfoundation.org (Postfix) with ESMTP id BF52EC04FB;\n\tTue, 28 Apr 2026 17:45:22 +0000 (UTC)","from smtp3.osuosl.org (smtp3.osuosl.org [140.211.166.136])\n by lists.linuxfoundation.org (Postfix) with ESMTP id D5991C0592\n for ; Tue, 28 Apr 2026 17:45:19 +0000 (UTC)","from localhost (localhost [127.0.0.1])\n by smtp3.osuosl.org (Postfix) with ESMTP id C696160C24\n for ; Tue, 28 Apr 2026 17:45:19 +0000 (UTC)","from smtp3.osuosl.org ([127.0.0.1])\n by localhost (smtp3.osuosl.org [127.0.0.1]) (amavis, port 10024) with ESMTP\n id Roqs3Gb2M1B9 for ;\n Tue, 28 Apr 2026 17:45:18 +0000 (UTC)","from us-smtp-delivery-124.mimecast.com\n (us-smtp-delivery-124.mimecast.com [170.10.133.124])\n by smtp3.osuosl.org (Postfix) with ESMTPS id AC0DB60A3D\n for ; Tue, 28 Apr 2026 17:45:18 +0000 (UTC)","from mx-prod-mc-05.mail-002.prod.us-west-2.aws.redhat.com\n (ec2-54-186-198-63.us-west-2.compute.amazonaws.com [54.186.198.63]) by\n relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3,\n cipher=TLS_AES_256_GCM_SHA384) id us-mta-508-5FaGWu02Mou_EhNB9MrVKA-1; Tue,\n 28 Apr 2026 13:45:15 -0400","from mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com\n (mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.12])\n (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)\n key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest\n SHA256)\n (No client certificate requested)\n by mx-prod-mc-05.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS\n id 738771956089\n for ; Tue, 28 Apr 2026 17:45:14 +0000 (UTC)","from localhost.localdomain.com (unknown [10.22.88.208])\n by mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP\n id 1A77F19560AB\n for ; Tue, 28 Apr 2026 17:45:13 +0000 (UTC)"],"X-Virus-Scanned":["amavis at osuosl.org","amavis at osuosl.org"],"X-Comment":"SPF check N/A for local connections -\n client-ip=2605:bc80:3010:104::8cd3:938; helo=lists.linuxfoundation.org;\n envelope-from=ovs-dev-bounces@openvswitch.org; receiver= ","DKIM-Filter":["OpenDKIM Filter v2.11.0 smtp1.osuosl.org E3C6383455","OpenDKIM Filter v2.11.0 smtp3.osuosl.org AC0DB60A3D"],"Received-SPF":"Pass (mailfrom) identity=mailfrom; client-ip=170.10.133.124;\n helo=us-smtp-delivery-124.mimecast.com; envelope-from=mmichels@redhat.com;\n receiver=","DMARC-Filter":"OpenDMARC Filter v1.4.2 smtp3.osuosl.org AC0DB60A3D","DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com;\n s=mimecast20190719; t=1777398316;\n h=from:from:reply-to:subject:subject:date:date:message-id:message-id:\n to:to:cc:mime-version:mime-version:content-type:content-type:\n content-transfer-encoding:content-transfer-encoding:\n in-reply-to:in-reply-to:references:references;\n bh=DKH4FhDrx2v4b3xvkDDd8Fkdi76RH1gnSZ/UMCAiqAA=;\n b=B4l+DAJjSZLzs9efXv8l52cF/b7dno7q0y2m0Qb3LygdTvgxo8JIzd7Tz7ww8KLfz133kM\n 07oAw1upnh5s0juCDVCdFRi2xRXppSH6cf+CuZGW2+LN3LJ53gpFRo6j2b6nqVRadTpplD\n b4KNIjEaqn7Dmx2FhOprmliMjkLUKlE=","X-MC-Unique":"5FaGWu02Mou_EhNB9MrVKA-1","X-Mimecast-MFC-AGG-ID":"5FaGWu02Mou_EhNB9MrVKA_1777398314","To":"dev@openvswitch.org","Date":"Tue, 28 Apr 2026 13:45:04 -0400","Message-ID":"<20260428174509.145440-5-mmichels@redhat.com>","In-Reply-To":"<20260428174509.145440-1-mmichels@redhat.com>","References":"<20260428174509.145440-1-mmichels@redhat.com>","MIME-Version":"1.0","X-Scanned-By":"MIMEDefang 3.0 on 10.30.177.12","X-Mimecast-Spam-Score":"0","X-Mimecast-MFC-PROC-ID":"nS0Cr4z5uF2PrVcozWzZt96DH_k4TsQSLfk1McF_1sM_1777398314","X-Mimecast-Originator":"redhat.com","Subject":"[ovs-dev] [PATCH ovn 4/5] northd: Fix ovn-northd manpage and usage\n for options and commands.","X-BeenThere":"ovs-dev@openvswitch.org","X-Mailman-Version":"2.1.30","Precedence":"list","List-Id":"","List-Unsubscribe":",\n ","List-Archive":"","List-Post":"","List-Help":"","List-Subscribe":",\n ","From":"Mark Michelson via dev ","Reply-To":"Mark Michelson ","Content-Type":"text/plain; charset=\"us-ascii\"","Content-Transfer-Encoding":"7bit","Errors-To":"ovs-dev-bounces@openvswitch.org","Sender":"\"dev\" "},"content":"Fix the --n-threads option format in the manpage (was missing the\n\"--\" prefix). Add the undocumented --dump-inc-proc-graph option to\nboth the manpage and usage() output.\n\nFix runtime management command names: set-n-threads and get-n-threads\nwere documented with incorrect names; the actual registered commands\nare parallel-build/set-n-threads and parallel-build/get-n-threads.\n\nAdd missing runtime management commands to the manpage:\nnb-connection-status, sb-connection-status,\ndebug/chassis-features-list, inc-engine/recompute,\ninc-engine/compute-log-timeout, and inc-engine/list-stopwatches.\n\nMark the counter_name argument of inc-engine/show-stats as optional,\nmatching the actual command registration.\n\nReported-at: https://redhat.atlassian.net/browse/FDP-3054\nAssisted-by: Claude Code (Claude Opus 4.6)\nSigned-off-by: Mark Michelson \n---\n northd/ovn-northd.8.xml | 57 +++++++++++++++++++++++++++++++++++++----\n northd/ovn-northd.c | 2 ++\n 2 files changed, 54 insertions(+), 5 deletions(-)","diff":"diff --git a/northd/ovn-northd.8.xml b/northd/ovn-northd.8.xml\nindex e5d460382..c49ec1b37 100644\n--- a/northd/ovn-northd.8.xml\n+++ b/northd/ovn-northd.8.xml\n@@ -44,7 +44,7 @@\n Commands below.\n

\n \n-
n-threads N
\n+
--n-threads=N
\n
\n

\n In certain situations, it may be desirable to enable parallelization\n@@ -62,6 +62,15 @@\n enabled (with 256 threads) and a warning is logged.\n

\n
\n+
--dump-inc-proc-graph[=node]
\n+
\n+

\n+ Dump the incremental processing engine graph representation in\n+ DOT format to stdout at startup and then exit. If\n+ node is specified, only the subgraph rooted at that\n+ engine node is printed.\n+

\n+
\n \n

\n database in the above options must be an OVSDB active or\n@@ -157,7 +166,7 @@\n \n \n \n-

set-n-threads N
\n+
parallel-build/set-n-threads N
\n
\n

\n Set the number of threads used for building logical flows.\n@@ -165,17 +174,36 @@\n When N is 1 parallelization is disabled.\n When N is less than 1 or more than 256, an error is returned.\n If ovn-northd fails to start parallelization (e.g. fails to setup\n- semaphores, parallelization is disabled and an error is returned.\n+ semaphores), parallelization is disabled and an error is returned.\n

\n
\n \n-
get-n-threads
\n+
parallel-build/get-n-threads
\n
\n

\n Return the number of threads used for building logical flows.\n

\n
\n \n+
nb-connection-status
\n+
\n+ Prints whether the connection to the OVN Northbound database is\n+ currently connected or not.\n+
\n+\n+
sb-connection-status
\n+
\n+ Prints whether the connection to the OVN Southbound database is\n+ currently connected or not.\n+
\n+\n+
debug/chassis-features-list
\n+
\n+ Lists the chassis feature flags and their current values as\n+ determined by ovn-northd. These features reflect\n+ the capabilities reported by the connected chassis.\n+
\n+\n
inc-engine/show-stats
\n
\n

\n@@ -195,7 +223,7 @@\n

\n
\n \n-
inc-engine/show-stats engine_node_name counter_name
\n+
inc-engine/show-stats engine_node_name [counter_name]
\n
\n

\n Display the ovn-northd engine counter(s) for the specified\n@@ -210,6 +238,25 @@\n

Reset ovn-northd engine counters.

\n
\n \n+
inc-engine/recompute
\n+
\n+ Triggers a full recompute of the incremental processing engine\n+ on the next iteration.\n+
\n+\n+
inc-engine/compute-log-timeout msecs
\n+
\n+ Sets the timeout in milliseconds for logging engine compute\n+ events.\n+
\n+\n+
inc-engine/list-stopwatches [node]
\n+
\n+ Lists the engine nodes and their change handler names. If\n+ node is specified, only the handlers for that engine\n+ node are listed.\n+
\n+\n \n

\n \ndiff --git a/northd/ovn-northd.c b/northd/ovn-northd.c\nindex 0ed2eb17a..7e0f888c1 100644\n--- a/northd/ovn-northd.c\n+++ b/northd/ovn-northd.c\n@@ -619,6 +619,8 @@ Options:\\n\\\n (default: %s)\\n\\\n --dry-run start in paused state (do not commit db changes)\\n\\\n --n-threads=N specify number of threads\\n\\\n+ --dump-inc-proc-graph[=NODE]\\n\\\n+ dump incremental processing graph and exit\\n\\\n --unixctl=SOCKET override default control socket name\\n\\\n -h, --help display this help message\\n\\\n -o, --options list available options\\n\\\n","prefixes":["ovs-dev","4/5"]}