From patchwork Sat Dec 21 11:09:14 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Matthieu Baerts X-Patchwork-Id: 13917791 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 260613F9D2; Sat, 21 Dec 2024 11:09:23 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1734779364; cv=none; b=hwaPD99vf3i5R1O2w+MoyHo8eh1xkqK9uZBC/x+4A33cz9oB7nIJ1jYLf7quhiQpzP++UKmWfmqdnb8ELvTEw0EsoFnjJ+jc+xJW6ugq4W7tqY9oIRX40SBvrD3PoOpornwUVjyeRhAJhsLrrnbf+M+/EwKXOPt7JwlNeT1yzxE= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1734779364; c=relaxed/simple; bh=u3fwubOZfC6AniriBqkgTG5ia0NGJOwaok4Fu2Da9Kk=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=tBG6p7KFAJ72ybNyUlDxUj1bKfGAT3YNUxm12Z4FMyVoQJF88XAe0QR1wWrvs61bZfEA6hwzL72xtCnS4MOaj+LzRLk1a6BK2LQ+okI9k7r3bOZrcLbLf2lYxpQfKx2kEIR6WsOfKJBbn5tLVWX+KkHgEapDLaAohc66TvRUXfY= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=Wu12UgOI; arc=none smtp.client-ip=10.30.226.201 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="Wu12UgOI" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 27A70C4CECE; Sat, 21 Dec 2024 11:09:20 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1734779363; bh=u3fwubOZfC6AniriBqkgTG5ia0NGJOwaok4Fu2Da9Kk=; h=From:Date:Subject:References:In-Reply-To:To:Cc:From; b=Wu12UgOI/BMuJWR+6lbah2ouD2DajxpP9LrLpV3xoPA9pym7fRLa7OD5LVVzoOg62 LsrZyi246MZHE1HQ01a0PjYML3X02tWdVlzPy5vyVKZ2E0la4x/4/oGuCrg9GmMjoD Wk7s/zfk/osQA1tJUGTdm4OoupCmZ+kwUJUtaM7ghOCwL75XV3ZmIFmmoYKgwzsBPs XAfB4ocimTi61582kf5WbFcd/hHrDe32DWioaNhyKLi+RVQPoCkOxL0XjbyPnvR11O cvkj0e4KmKI1nfHgay4F5i0mAzqd50mMt8fRPkm55vThSi9So/MHggLBHz5ZvxFUT4 0Ru37sNShjXEA== From: "Matthieu Baerts (NGI0)" Date: Sat, 21 Dec 2024 12:09:14 +0100 Subject: [PATCH net v2 1/3] netlink: specs: mptcp: add missing 'server-side' attr Precedence: bulk X-Mailing-List: mptcp@lists.linux.dev List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Message-Id: <20241221-net-mptcp-netlink-specs-pm-doc-fixes-v2-1-e54f2db3f844@kernel.org> References: <20241221-net-mptcp-netlink-specs-pm-doc-fixes-v2-0-e54f2db3f844@kernel.org> In-Reply-To: <20241221-net-mptcp-netlink-specs-pm-doc-fixes-v2-0-e54f2db3f844@kernel.org> To: mptcp@lists.linux.dev, Mat Martineau , Geliang Tang , Donald Hunter , Jakub Kicinski , "David S. Miller" , Eric Dumazet , Paolo Abeni , Simon Horman , Davide Caratti Cc: netdev@vger.kernel.org, linux-kernel@vger.kernel.org, "Matthieu Baerts (NGI0)" X-Mailer: b4 0.14.2 X-Developer-Signature: v=1; a=openpgp-sha256; l=3051; i=matttbe@kernel.org; h=from:subject:message-id; bh=u3fwubOZfC6AniriBqkgTG5ia0NGJOwaok4Fu2Da9Kk=; b=owEBbQKS/ZANAwAIAfa3gk9CaaBzAcsmYgBnZqHdqREl4qhDmc6aYeWMI7KCjCt2d2FyEvg5P S+vvFno06WJAjMEAAEIAB0WIQToy4X3aHcFem4n93r2t4JPQmmgcwUCZ2ah3QAKCRD2t4JPQmmg c/7DEAC1FCDxSwrO3oGm5aqP8MQbACSjK7y92E0pYkHtfVIgVrA4sd5OPTNlO0sVc40TiXDKdGD lgLaY4plVBM1lRpjjnAFr8dKCJqLEyfvgm2uckhAG84rDwsy12OgMQHkbIzT0aW5GRVeMgB7F1g qz1MKznDhl6/SvzxPqJsgt0c/wp4P/PeMiOv4RrYSFnVwb+DLuBS1APb8pMPHKLXxnqnajbLRv8 dix3xJh4YbDFiPL8SRa2f+Jz5wfYqIPjh0/Qf/Tv4LJgAP/2lm9WptRJmmYpm4W79lBp7bLGBxE cbLj1V+E7uhJvf1Peo8f3fdsg5DKeSvc8UoEQ5h67kTyLriuV0a/O0mAKHq9OBd/BwwGm7P4ugg O3p05xhDsB6cJvEi4PJ2u2lOVniGfw1Jm74orvNrnTsKV7x8KvU0baGGZSp9wuXbt5SCD77npoz TLhD8eU6uUZ8coCQidXkPyUUhMh4sByJU47ztTvQFhUPjPsvgMCKHutsxoNMUYxaLhUKeWRhroM kBmvyNhk6Jq8L/is+ilMlWrHTcT4dnJq0fFnaQ4KG9H8eFIbU0b50wYiEHW++9T9UQo9t3h2QKx 8gUq+/kcOCkBoXv+kprV98yXjqtvlOWJ3SD+1Ob+6KtcuAPfv/SpD4eXl69spXDQkr6TbxNLirO 2xJW8tbOnEUf1XA== X-Developer-Key: i=matttbe@kernel.org; a=openpgp; fpr=E8CB85F76877057A6E27F77AF6B7824F4269A073 This attribute is added with the 'created' and 'established' events, but the documentation didn't mention it. The documentation in the UAPI header has been auto-generated by: ./tools/net/ynl/ynl-regen.sh Reviewed-by: Geliang Tang Signed-off-by: Matthieu Baerts (NGI0) --- Notes: - v2: Regen YNL doc + remove Fixes tag (Jakub). --- Documentation/netlink/specs/mptcp_pm.yaml | 6 ++++-- include/uapi/linux/mptcp_pm.h | 11 ++++++----- 2 files changed, 10 insertions(+), 7 deletions(-) diff --git a/Documentation/netlink/specs/mptcp_pm.yaml b/Documentation/netlink/specs/mptcp_pm.yaml index dc190bf838fec6add28b61e5e2cac8dee601b012..fc0603f51665a6260fb4dc78bc641c4175a8577e 100644 --- a/Documentation/netlink/specs/mptcp_pm.yaml +++ b/Documentation/netlink/specs/mptcp_pm.yaml @@ -23,7 +23,8 @@ definitions: - name: created doc: - token, family, saddr4 | saddr6, daddr4 | daddr6, sport, dport + token, family, saddr4 | saddr6, daddr4 | daddr6, sport, dport, + server-side A new MPTCP connection has been created. It is the good time to allocate memory and send ADD_ADDR if needed. Depending on the traffic-patterns it can take a long time until the @@ -31,7 +32,8 @@ definitions: - name: established doc: - token, family, saddr4 | saddr6, daddr4 | daddr6, sport, dport + token, family, saddr4 | saddr6, daddr4 | daddr6, sport, dport, + server-side A MPTCP connection is established (can start new subflows). - name: closed diff --git a/include/uapi/linux/mptcp_pm.h b/include/uapi/linux/mptcp_pm.h index 50589e5dd6a38a3b4158e2e4092a9b3442b8fe96..b34fd95b6f841529a8c4e8feca20450cb92f8bfc 100644 --- a/include/uapi/linux/mptcp_pm.h +++ b/include/uapi/linux/mptcp_pm.h @@ -13,12 +13,13 @@ * enum mptcp_event_type * @MPTCP_EVENT_UNSPEC: unused event * @MPTCP_EVENT_CREATED: token, family, saddr4 | saddr6, daddr4 | daddr6, - * sport, dport A new MPTCP connection has been created. It is the good time - * to allocate memory and send ADD_ADDR if needed. Depending on the - * traffic-patterns it can take a long time until the MPTCP_EVENT_ESTABLISHED - * is sent. + * sport, dport, server-side A new MPTCP connection has been created. It is + * the good time to allocate memory and send ADD_ADDR if needed. Depending on + * the traffic-patterns it can take a long time until the + * MPTCP_EVENT_ESTABLISHED is sent. * @MPTCP_EVENT_ESTABLISHED: token, family, saddr4 | saddr6, daddr4 | daddr6, - * sport, dport A MPTCP connection is established (can start new subflows). + * sport, dport, server-side A MPTCP connection is established (can start new + * subflows). * @MPTCP_EVENT_CLOSED: token A MPTCP connection has stopped. * @MPTCP_EVENT_ANNOUNCED: token, rem_id, family, daddr4 | daddr6 [, dport] A * new address has been announced by the peer. From patchwork Sat Dec 21 11:09:15 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Matthieu Baerts X-Patchwork-Id: 13917792 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 40FFF1F2C57; Sat, 21 Dec 2024 11:09:26 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1734779367; cv=none; b=FvTL7nB4wQm4GO2vmYyBv86WyW72fBAZ+TXTseHRV2k+B6pHxL0US9Y/wcwWc8FRQHrjXxS7sGrRA97EdPZqcet7H9qDeSvN44tl+rSgKOeB1p+E8kXYlCbrhplJCEb96+p/yjpn57e0f4aCQvJeD/FjKJVOz+NDpttk75CE2CA= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1734779367; c=relaxed/simple; bh=ASr3/4DAVtVdPC5X9jokt3ABmYTkKfh8apzzBt0xxA8=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=muiN8yXp0E5mLXHJpFzejPqyiCvtFg/XT1Dc7XhfWFhVkpEE2sFuHq/7eRN2Rlgsw4iJ6xSOP1Ck4LWOWkf2JdecF8valNcL39PH5D2YHGFOnkVOhxm5/tCDNl4NEBqCfLTB1Ul2t9J3Rf2Gtb73tL1Q3fxw2oaNtLd8irajupc= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=Xo9FxMpS; arc=none smtp.client-ip=10.30.226.201 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="Xo9FxMpS" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 360B8C4CED4; Sat, 21 Dec 2024 11:09:24 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1734779366; bh=ASr3/4DAVtVdPC5X9jokt3ABmYTkKfh8apzzBt0xxA8=; h=From:Date:Subject:References:In-Reply-To:To:Cc:From; b=Xo9FxMpScRsWJEK5BOzi6TpHq2Zww8QXOX2uovXmVj2U58yIB/ism0EEiGv/bgNQb PBYWigd0x4zjoklSTF5gUZdKPFfn1mBhSaagrtbM+1Tqt3ivGyHCuaO6hNvSLFaJEm eWHR+oTL3otmh0XALzOOq4Y8YXW2N+rGNs79hQFUuQrAVzt+0q1zAnAyazbKyM3MC9 PlzY3IU+JJbe3/XKiq2kZplvaanpmiI+k7OGpIbJ99jLTawT+2UBWSRYoJIprJu5wU w4PwfA2Lq+c6hasQBnLEeM2EXHRIN8iuQiphFY3bYJaP4qi7L45G9QUxGx5j6s5pe0 53/P1TRP/vYww== From: "Matthieu Baerts (NGI0)" Date: Sat, 21 Dec 2024 12:09:15 +0100 Subject: [PATCH net v2 2/3] netlink: specs: mptcp: clearly mention attributes Precedence: bulk X-Mailing-List: mptcp@lists.linux.dev List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Message-Id: <20241221-net-mptcp-netlink-specs-pm-doc-fixes-v2-2-e54f2db3f844@kernel.org> References: <20241221-net-mptcp-netlink-specs-pm-doc-fixes-v2-0-e54f2db3f844@kernel.org> In-Reply-To: <20241221-net-mptcp-netlink-specs-pm-doc-fixes-v2-0-e54f2db3f844@kernel.org> To: mptcp@lists.linux.dev, Mat Martineau , Geliang Tang , Donald Hunter , Jakub Kicinski , "David S. Miller" , Eric Dumazet , Paolo Abeni , Simon Horman , Davide Caratti Cc: netdev@vger.kernel.org, linux-kernel@vger.kernel.org, "Matthieu Baerts (NGI0)" X-Mailer: b4 0.14.2 X-Developer-Signature: v=1; a=openpgp-sha256; l=8506; i=matttbe@kernel.org; h=from:subject:message-id; bh=ASr3/4DAVtVdPC5X9jokt3ABmYTkKfh8apzzBt0xxA8=; b=owEBbQKS/ZANAwAIAfa3gk9CaaBzAcsmYgBnZqHdQ+84wXUPc9DjfOve0AARrk3mpq2LiDCqW mM0IOtZhyOJAjMEAAEIAB0WIQToy4X3aHcFem4n93r2t4JPQmmgcwUCZ2ah3QAKCRD2t4JPQmmg c3CXEADQFiY6JfRNxpDQMFcNCe002FIaOjzuKtGAJkqgUSdxdyhwfGM90/keJ+e+6jetOywgN31 7bsNdB8lk9kl9CJXg+0ntBGL7JgrO/9obsJY0j9LT/GKdBzPy2gzr/8tux9yQEjg+xOfhLnyPgC mCTZHqTt7fDsH/Nklmr7+rl5qNYJrBN6E99epjcQD5v7PnKa67kxB38jXN6/IhBGcjNUALUZEqW uX1KxRuJyjS50hCaHyT6g8amBebYsZlazek75n20Yg+E4yR8CX2YQd3OudIiy6KEnAD1VASt92u YKkAumXbTI/JoSy2PUwJHYK0TbPSzYLqZioxTU3SvTdMZ/xGJxss5/ccO+G9n9CHdbWI5ZmoJVw d4AEuJKWmFy5EfNhNg7n+T71i0V9aY1ncCiShIAK0/JvNe08xB0xHYyGEt9PcF/szaA9M4dgxL0 b+OQBXEcKWwJ/bcAhwq5VW4y39lZi+SiseCswEx9T2/G2JI99GeS6jK1gPOeONCV1XYFDfDLGRO aVxsy++0i2DY0AXrOknP4LCnpKtdEa5JYBbipQgVlJyKKQt9KnimORGqlI6P32KcFd1vMvCWhWX TxP9bQ6AdfXFGGITbhrj7pBbZZQ+qtOQrzJQpGOD8orx4+yeFpb43V2Gum5J2vm6zZYgRNDQQkj 82Ti3C7XkshMG4A== X-Developer-Key: i=matttbe@kernel.org; a=openpgp; fpr=E8CB85F76877057A6E27F77AF6B7824F4269A073 The rendered version of the MPTCP events [1] looked strange, because the whole content of the 'doc' was displayed in the same block. It was then not clear that the first words, not even ended by a period, were the attributes that are defined when such events are emitted. These attributes have now been moved to the end, prefixed by 'Attributes:' and ended with a period. Note that '>-' has been added after 'doc:' to allow ':' in the text below. The documentation in the UAPI header has been auto-generated by: ./tools/net/ynl/ynl-regen.sh Link: https://docs.kernel.org/networking/netlink_spec/mptcp_pm.html#event-type [1] Reviewed-by: Geliang Tang Signed-off-by: Matthieu Baerts (NGI0) --- Notes: - v2: Regen YNL doc + remove Fixes tag (Jakub). --- Documentation/netlink/specs/mptcp_pm.yaml | 50 ++++++++++++++--------------- include/uapi/linux/mptcp_pm.h | 53 ++++++++++++++++--------------- 2 files changed, 52 insertions(+), 51 deletions(-) diff --git a/Documentation/netlink/specs/mptcp_pm.yaml b/Documentation/netlink/specs/mptcp_pm.yaml index fc0603f51665a6260fb4dc78bc641c4175a8577e..59087a23056510dfb939b702e231b6e97ae042c7 100644 --- a/Documentation/netlink/specs/mptcp_pm.yaml +++ b/Documentation/netlink/specs/mptcp_pm.yaml @@ -22,67 +22,67 @@ definitions: doc: unused event - name: created - doc: - token, family, saddr4 | saddr6, daddr4 | daddr6, sport, dport, - server-side + doc: >- A new MPTCP connection has been created. It is the good time to allocate memory and send ADD_ADDR if needed. Depending on the traffic-patterns it can take a long time until the MPTCP_EVENT_ESTABLISHED is sent. + Attributes: token, family, saddr4 | saddr6, daddr4 | daddr6, sport, + dport, server-side. - name: established - doc: - token, family, saddr4 | saddr6, daddr4 | daddr6, sport, dport, - server-side + doc: >- A MPTCP connection is established (can start new subflows). + Attributes: token, family, saddr4 | saddr6, daddr4 | daddr6, sport, + dport, server-side. - name: closed - doc: - token + doc: >- A MPTCP connection has stopped. + Attribute: token. - name: announced value: 6 - doc: - token, rem_id, family, daddr4 | daddr6 [, dport] + doc: >- A new address has been announced by the peer. + Attributes: token, rem_id, family, daddr4 | daddr6 [, dport]. - name: removed - doc: - token, rem_id + doc: >- An address has been lost by the peer. + Attributes: token, rem_id. - name: sub-established value: 10 - doc: - token, family, loc_id, rem_id, saddr4 | saddr6, daddr4 | daddr6, sport, - dport, backup, if_idx [, error] + doc: >- A new subflow has been established. 'error' should not be set. + Attributes: token, family, loc_id, rem_id, saddr4 | saddr6, daddr4 | + daddr6, sport, dport, backup, if_idx [, error]. - name: sub-closed - doc: - token, family, loc_id, rem_id, saddr4 | saddr6, daddr4 | daddr6, sport, - dport, backup, if_idx [, error] + doc: >- A subflow has been closed. An error (copy of sk_err) could be set if an error has been detected for this subflow. + Attributes: token, family, loc_id, rem_id, saddr4 | saddr6, daddr4 | + daddr6, sport, dport, backup, if_idx [, error]. - name: sub-priority value: 13 - doc: - token, family, loc_id, rem_id, saddr4 | saddr6, daddr4 | daddr6, sport, - dport, backup, if_idx [, error] + doc: >- The priority of a subflow has changed. 'error' should not be set. + Attributes: token, family, loc_id, rem_id, saddr4 | saddr6, daddr4 | + daddr6, sport, dport, backup, if_idx [, error]. - name: listener-created value: 15 - doc: - family, sport, saddr4 | saddr6 + doc: >- A new PM listener is created. + Attributes: family, sport, saddr4 | saddr6. - name: listener-closed - doc: - family, sport, saddr4 | saddr6 + doc: >- A PM listener is closed. + Attributes: family, sport, saddr4 | saddr6. attribute-sets: - diff --git a/include/uapi/linux/mptcp_pm.h b/include/uapi/linux/mptcp_pm.h index b34fd95b6f841529a8c4e8feca20450cb92f8bfc..84fa8a21dfd022a266507371d67f0f00599d8429 100644 --- a/include/uapi/linux/mptcp_pm.h +++ b/include/uapi/linux/mptcp_pm.h @@ -12,32 +12,33 @@ /** * enum mptcp_event_type * @MPTCP_EVENT_UNSPEC: unused event - * @MPTCP_EVENT_CREATED: token, family, saddr4 | saddr6, daddr4 | daddr6, - * sport, dport, server-side A new MPTCP connection has been created. It is - * the good time to allocate memory and send ADD_ADDR if needed. Depending on - * the traffic-patterns it can take a long time until the - * MPTCP_EVENT_ESTABLISHED is sent. - * @MPTCP_EVENT_ESTABLISHED: token, family, saddr4 | saddr6, daddr4 | daddr6, - * sport, dport, server-side A MPTCP connection is established (can start new - * subflows). - * @MPTCP_EVENT_CLOSED: token A MPTCP connection has stopped. - * @MPTCP_EVENT_ANNOUNCED: token, rem_id, family, daddr4 | daddr6 [, dport] A - * new address has been announced by the peer. - * @MPTCP_EVENT_REMOVED: token, rem_id An address has been lost by the peer. - * @MPTCP_EVENT_SUB_ESTABLISHED: token, family, loc_id, rem_id, saddr4 | - * saddr6, daddr4 | daddr6, sport, dport, backup, if_idx [, error] A new - * subflow has been established. 'error' should not be set. - * @MPTCP_EVENT_SUB_CLOSED: token, family, loc_id, rem_id, saddr4 | saddr6, - * daddr4 | daddr6, sport, dport, backup, if_idx [, error] A subflow has been - * closed. An error (copy of sk_err) could be set if an error has been - * detected for this subflow. - * @MPTCP_EVENT_SUB_PRIORITY: token, family, loc_id, rem_id, saddr4 | saddr6, - * daddr4 | daddr6, sport, dport, backup, if_idx [, error] The priority of a - * subflow has changed. 'error' should not be set. - * @MPTCP_EVENT_LISTENER_CREATED: family, sport, saddr4 | saddr6 A new PM - * listener is created. - * @MPTCP_EVENT_LISTENER_CLOSED: family, sport, saddr4 | saddr6 A PM listener - * is closed. + * @MPTCP_EVENT_CREATED: A new MPTCP connection has been created. It is the + * good time to allocate memory and send ADD_ADDR if needed. Depending on the + * traffic-patterns it can take a long time until the MPTCP_EVENT_ESTABLISHED + * is sent. Attributes: token, family, saddr4 | saddr6, daddr4 | daddr6, + * sport, dport, server-side. + * @MPTCP_EVENT_ESTABLISHED: A MPTCP connection is established (can start new + * subflows). Attributes: token, family, saddr4 | saddr6, daddr4 | daddr6, + * sport, dport, server-side. + * @MPTCP_EVENT_CLOSED: A MPTCP connection has stopped. Attribute: token. + * @MPTCP_EVENT_ANNOUNCED: A new address has been announced by the peer. + * Attributes: token, rem_id, family, daddr4 | daddr6 [, dport]. + * @MPTCP_EVENT_REMOVED: An address has been lost by the peer. Attributes: + * token, rem_id. + * @MPTCP_EVENT_SUB_ESTABLISHED: A new subflow has been established. 'error' + * should not be set. Attributes: token, family, loc_id, rem_id, saddr4 | + * saddr6, daddr4 | daddr6, sport, dport, backup, if_idx [, error]. + * @MPTCP_EVENT_SUB_CLOSED: A subflow has been closed. An error (copy of + * sk_err) could be set if an error has been detected for this subflow. + * Attributes: token, family, loc_id, rem_id, saddr4 | saddr6, daddr4 | + * daddr6, sport, dport, backup, if_idx [, error]. + * @MPTCP_EVENT_SUB_PRIORITY: The priority of a subflow has changed. 'error' + * should not be set. Attributes: token, family, loc_id, rem_id, saddr4 | + * saddr6, daddr4 | daddr6, sport, dport, backup, if_idx [, error]. + * @MPTCP_EVENT_LISTENER_CREATED: A new PM listener is created. Attributes: + * family, sport, saddr4 | saddr6. + * @MPTCP_EVENT_LISTENER_CLOSED: A PM listener is closed. Attributes: family, + * sport, saddr4 | saddr6. */ enum mptcp_event_type { MPTCP_EVENT_UNSPEC, From patchwork Sat Dec 21 11:09:16 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Matthieu Baerts X-Patchwork-Id: 13917793 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 55E211F6692; Sat, 21 Dec 2024 11:09:29 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1734779370; cv=none; b=eX+xKWWPL96+BFkUz88Zr6lKpfl1sOIkOQ+ESjgdOhh9BDK9HGTxlt7Mi88JUbaQ3mnqXWclsdU67XwsiuZvyV1Zlo0dCb49Iq4ixGm+v4nfwkM55JAmVg6Fch6ugXDHVAAPWXBezOxotImdA8ZyXzH+q7p1vB1FyO44GYZ330I= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1734779370; c=relaxed/simple; bh=QRpkcpc59deBZi3zJVNk1kxfy0JxjlG1o513S2C1O8E=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=hgEzlGmnosyB5+Z46AzoMUOHVh6VIc6AEU9ig4FAvXYn/VZ03LQk9nabqevEgpxV31q0maXqwGZB0j9GbZX6n29P/xfgIhwtXYByX5J22htNDw5L7z3xugGvzZMZYp4Ltvo+MYsPadX/aZgu2KFwb41k7VyWL5wpAX2lqM4vpSs= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=jBF0Mt6R; arc=none smtp.client-ip=10.30.226.201 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="jBF0Mt6R" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 46CF4C4CED7; Sat, 21 Dec 2024 11:09:27 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1734779369; bh=QRpkcpc59deBZi3zJVNk1kxfy0JxjlG1o513S2C1O8E=; h=From:Date:Subject:References:In-Reply-To:To:Cc:From; b=jBF0Mt6RHpOtbsuNIslqB7Re4DAOkEePF4SAbczB3O8J+Se9Q3X5y4lFR2XoBi/qR HgPNRxlZZ8hlvSODJj0wXU81RfiQbwN+1bb1EDbsffTnnzV7+FFg76EhBldIivdNOy bptLn0jN6qfu5ndqh5t3P1U9N4tq14a/4GfWtJ45MJtE6ghXBkHTaHFYXZkl7HHwZP 5mTGqUOrAPsS+/h/IS+gVAeZgG32V5SsDXYf3dznGd4pg6iKYoTpyUBSJkJb/xtGQF hhVOUxwPwhKGp13DY+W9saQppqIuI6uoYUOrN/sQRVDmIEEGGUUPASOXBpdajJPLa/ /78KpLySrxqbA== From: "Matthieu Baerts (NGI0)" Date: Sat, 21 Dec 2024 12:09:16 +0100 Subject: [PATCH net v2 3/3] netlink: specs: mptcp: fix missing doc Precedence: bulk X-Mailing-List: mptcp@lists.linux.dev List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Message-Id: <20241221-net-mptcp-netlink-specs-pm-doc-fixes-v2-3-e54f2db3f844@kernel.org> References: <20241221-net-mptcp-netlink-specs-pm-doc-fixes-v2-0-e54f2db3f844@kernel.org> In-Reply-To: <20241221-net-mptcp-netlink-specs-pm-doc-fixes-v2-0-e54f2db3f844@kernel.org> To: mptcp@lists.linux.dev, Mat Martineau , Geliang Tang , Donald Hunter , Jakub Kicinski , "David S. Miller" , Eric Dumazet , Paolo Abeni , Simon Horman , Davide Caratti Cc: netdev@vger.kernel.org, linux-kernel@vger.kernel.org, "Matthieu Baerts (NGI0)" X-Mailer: b4 0.14.2 X-Developer-Signature: v=1; a=openpgp-sha256; l=2249; i=matttbe@kernel.org; h=from:subject:message-id; bh=QRpkcpc59deBZi3zJVNk1kxfy0JxjlG1o513S2C1O8E=; b=owEBbQKS/ZANAwAIAfa3gk9CaaBzAcsmYgBnZqHde4aO63EFlbqwVijkoere635EuchTCPAXd O74THRvly+JAjMEAAEIAB0WIQToy4X3aHcFem4n93r2t4JPQmmgcwUCZ2ah3QAKCRD2t4JPQmmg c7KKEACFnQCfH3qc6jrWpaeOZarnpXR+MIfJiMsm9h/7A1T6asAioINoC9XYwm1O+jVO7x2F1ps 7HWJyzJ7W0H4kDAqJ89SyTml9U5n9QrzVluiccNWwJgZcJqIwH8Ws2cnbhK20PZvTBwSFOmeRF/ J1M1HgxGbx1MVTSPYwO7SeGIOAjaDt0iJqd6vAQ+vkvDeFDtw1LPfsbub4nPDn4iJbC/TzkcV/J 7vF3UWMfW639yPBMZQ7vZgMFS56q5E6J+LMNs/oAdlxfZpwa7jkXLlhhYpwcRrTvi6vTk0+DwXx sEsP831orvzPTW7zcoJ35MZipznKh2p1WvlKc3K4bk7xeLjsbKBvuCt4Wz7BzoBz6S2iqolPVZi t3NWbZJxEi1QP9tCv15kHMtQz0mpJ8yoG+yFXszXzbCMvPsoxzohmWfX5HJ31/yyIuu7nFKahiq YrpIbtYFx8ezu1DqjXMPDhzHkxtuMbGCtj2wiuY6kkaWwrSUn6gUEXxbaCFi3F6fFLgS1eIpcbR WNGZ/AgzHoSk2DokY2EKhLBVE0gksyfYthC6FsBjTcOtZ+Ae8wcDo5tYfcSOSL9Eh86caT7irOh /cOrszLfVo4zaKR5yWlAU4s7DVo53vEtuq0KYawoAXVN5y+agLOu1CrihGyGp76wq8BBCYlve1/ PI6gbKvMfGZXGyA== X-Developer-Key: i=matttbe@kernel.org; a=openpgp; fpr=E8CB85F76877057A6E27F77AF6B7824F4269A073 Two operations didn't have a small description. It looks like something that has been missed in the original commit introducing this file. Replace the two "todo" by a small and simple description: Create/Destroy subflow. While at it, also uniform the capital letters, avoid double spaces, and fix the "announce" event description: a new "address" has been announced, not a new "subflow". Reviewed-by: Geliang Tang Signed-off-by: Matthieu Baerts (NGI0) --- Notes: - v2: Removed Fixes tag (Jakub). --- Documentation/netlink/specs/mptcp_pm.yaml | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/Documentation/netlink/specs/mptcp_pm.yaml b/Documentation/netlink/specs/mptcp_pm.yaml index 59087a23056510dfb939b702e231b6e97ae042c7..dfd017780d2f942eefd6e5ab0f1edd3fba653172 100644 --- a/Documentation/netlink/specs/mptcp_pm.yaml +++ b/Documentation/netlink/specs/mptcp_pm.yaml @@ -308,8 +308,8 @@ operations: attributes: - addr - - name: flush-addrs - doc: flush addresses + name: flush-addrs + doc: Flush addresses attribute-set: endpoint dont-validate: [ strict ] flags: [ uns-admin-perm ] @@ -353,7 +353,7 @@ operations: - addr-remote - name: announce - doc: announce new sf + doc: Announce new address attribute-set: attr dont-validate: [ strict ] flags: [ uns-admin-perm ] @@ -364,7 +364,7 @@ operations: - token - name: remove - doc: announce removal + doc: Announce removal attribute-set: attr dont-validate: [ strict ] flags: [ uns-admin-perm ] @@ -375,7 +375,7 @@ operations: - loc-id - name: subflow-create - doc: todo + doc: Create subflow attribute-set: attr dont-validate: [ strict ] flags: [ uns-admin-perm ] @@ -387,7 +387,7 @@ operations: - addr-remote - name: subflow-destroy - doc: todo + doc: Destroy subflow attribute-set: attr dont-validate: [ strict ] flags: [ uns-admin-perm ]