From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-wm1-f53.google.com (mail-wm1-f53.google.com [209.85.128.53]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 38A084F053E for ; Thu, 3 Sep 2026 16:26:46 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.128.53 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1788452809; cv=none; b=Dg2NiSIakEKyaNVx5sEVwdNOFgsJDAcHNKCzx2YuXaKbwQaJPyUoRGavxXn3lWoG44VKpNu+UoC1dC6kTlaMecye3gazlqWX/gg67J5JgdxNgx57tgDBxf0oaUOQwtiVH5/uaIG7++EDlSH1O56zThFKUh0XHKnEpMximBXSh6M= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1788452809; c=relaxed/simple; bh=nOO/E6lZobnxas+CjEmlQQqFvaYHZtCUk+zEXJi39rY=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=gZy8LiYNHPsE7IN7Vg30ECjqo6KNxsOu/Gp+UgE5tLr9SYWIQPCpoPh+Dwallm3vJaLGgX08PSE/K1i3/Rmg/5d8j23UWkgYrQQLuUCC+cEvK31DpLIWxgDFqNsff8+3xm3gejdeCdhvbvYKajWmSU+QdTzBL6igjWAGAZz7XZ8= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=e0RL6Tbd; arc=none smtp.client-ip=209.85.128.53 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="e0RL6Tbd" Received: by mail-wm1-f53.google.com with SMTP id 5b1f17b1804b1-499c0879d51so44655e9.2 for ; Thu, 03 Sep 2026 09:26:46 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20251104; t=1788452805; x=1789057605; darn=vger.kernel.org; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :content-type:mime-version:subject:date:from:from:to:cc:subject:date :message-id:reply-to:content-type; bh=Naf/s4dAV3WmHAfnOCKQz+YEIomyzUmgkSw+k6SbsTg=; b=e0RL6TbdWqMV7jJ0hskdOfI4JYNw43vDNCpkik9dmM6xYdgcQOudJoIDNDtein+si2 ssVuSGXP7ivsIcJJUikSfShas1g81y2/QmXwit+hUi2WM0QTNBH3pZ/ipxyIAzLlLYt+ awyEzJ6ldWKHfgpyCjYPskmXwnXU1XS5k2p67ZmkmO8hCOTRuYTiGir8x8+CfTbutHfS YV4gjCuWTkE9UXZtH6Iw3STi5JiHcn3evzE4y6wJ5CaO4PZCqkBKUzcJ30Bj12xcewc6 36PCNZvIUcnVEcQdtnXbPPmIOEJPTgNmVQNWaNh3qvbzSp4JGTrWiXhhr/nvICYCGd5/ kh0Q== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1788452805; x=1789057605; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :content-type:mime-version:subject:date:from:x-gm-gg :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to :content-type; bh=Naf/s4dAV3WmHAfnOCKQz+YEIomyzUmgkSw+k6SbsTg=; b=FxWKl+mRMZEEXUlV8UQNlCyXF3gF+R5n1WQR0yMaLqG2OXiVDMNHBzaeLqFZpz7EAH KSLTkV/qGIW89MJo7FdGfLVmAuTvbjh5KPbwZcTsTVJwbBEBGLPXjSppAaUouSUBG6Ok hsSZFluqIVzudatHTrjaGGAZX9bxBs3lwIecBCzhbclsLVYyu8VUeOKDPend0rOnDLjP AsUIBFiWIP6axNhkJDZP3mQm7d9xA9xtc5Y1SxnUpp3TrmYZskqWAJ/cpw7b4rc0JzIS zeDvaHcZG8yIxE94U+oMY9lJSFo5W1IaMuLRTfg1jSvs+UfHhhnTGqHNMqEm4J9A6H0a a2aw== X-Forwarded-Encrypted: i=1; AKwUvBwblJg/cr/OwXy4gkvwHA4hORbGmangC5Cm5xHaTmvm1vr8kbEFXiK5lqvFFN3SYZ+GwWbYdFLWpvPgFzQ=@vger.kernel.org X-Gm-Message-State: AFuF++mQoQ/zqm7NZHD0z1/4RHMvkBxl3FJDcrmXQ/mK0RLO+rYtX0TP iwPDqPkdr2j3N2lX/VNxhdYYVRErbUrAM767nvQfDz0tZiPjWZjTAavF X-Gm-Gg: AYBFou0LEKJQTHItSjaDB1PYnQ36gZ3ZYiahB968PoU1JPpOiElWH3sgN2xgProFPty JuLAjn9B9AQobyIw7voGBEAz7AxmOva2TukI/0jt0xiI3omr4wpauTYxhCkDQj5OomWTS3f8ESH AwVdnhGz1/8EI4wktc8KHvQ6lRB3BmfbXDvarrObMXzq4glWC0qcoF5xPiY9Ftb8KZ9NjTTy9+b yQDmvBelOSCP2VgxSdaeNIVXhhoycw2mtR2qXcehNi0mKzwLV4HgY+SnViPhknuFAXVLo8EpXG1 E3BuueGzkBmE2HcbPIm5cPT0N0vlyTkvTxMDIg1Js3D/8pY5s6y0hfagzwaxXTr//hY5O61XXyC 0dx6YASOgh/i0yZ+N+V6qworD1Jl0u22iUtjxucRkvCZChzsKcWXEfCB5+Bp9xKBb8xQi99BoJZ Za03RwNG561WCWv0dgcMPGMwIBg8YS51Ne+mYCIvxMaMM= X-Received: by 2002:a05:600c:3b03:b0:49b:910c:76fb with SMTP id 5b1f17b1804b1-49ce58252e3mr115661705e9.2.1788452804766; Thu, 03 Sep 2026 09:26:44 -0700 (PDT) Received: from localhost ([2620:10d:c092:500::6:124b]) by smtp.gmail.com with ESMTPSA id 5b1f17b1804b1-49cee5dadddsm101965955e9.9.2026.09.03.09.26.44 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 03 Sep 2026 09:26:44 -0700 (PDT) From: Gustavo Luiz Duarte Date: Thu, 03 Sep 2026 17:26:06 +0100 Subject: [PATCH net-next v4 7/7] docs: netconsole: document local_ip auto-selection Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: 7bit Message-Id: <20260903-netcons_ipv6-v4-7-bdd183c844d3@gmail.com> References: <20260903-netcons_ipv6-v4-0-bdd183c844d3@gmail.com> In-Reply-To: <20260903-netcons_ipv6-v4-0-bdd183c844d3@gmail.com> To: Breno Leitao , Andrew Lunn , "David S. Miller" , Eric Dumazet , Jakub Kicinski , Paolo Abeni , Simon Horman , Jonathan Corbet , Shuah Khan Cc: Gustavo Luiz Duarte , netdev@vger.kernel.org, linux-kernel@vger.kernel.org, linux-doc@vger.kernel.org X-Mailer: b4 0.15.2 An unset local_ip is auto-populated from the egress interface at enable time, but any value the user writes, including 0.0.0.0, is used as-is. This deviates from the behavior prior to "netconsole: use the address family instead of the ipv6 flag", which interpreted 0.0.0.0 as unset. Document this so the distinction between "unset" and "set to 0.0.0.0" is clear. Reviewed-by: Breno Leitao Signed-off-by: Gustavo Luiz Duarte --- Documentation/networking/netconsole.rst | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/Documentation/networking/netconsole.rst b/Documentation/networking/netconsole.rst index 4ab5d7b05cf1..694bca4803d5 100644 --- a/Documentation/networking/netconsole.rst +++ b/Documentation/networking/netconsole.rst @@ -141,6 +141,11 @@ The interface exposes these parameters of a netconsole target to userspace: transmit_errors Number of packet send errors (read-only) =============== ================================= ============ +local_ip is optional: if it is left unset, netconsole derives a source +address from the egress interface when the target is enabled. Writing any +value to it, including 0.0.0.0, uses that value verbatim and disables the +automatic selection. + The "enabled" attribute is also used to control whether the parameters of a target can be updated or not -- you can modify the parameters of only disabled targets (i.e. if "enabled" is 0). -- 2.55.0