From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-wm1-f52.google.com (mail-wm1-f52.google.com [209.85.128.52]) (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 9611D4F0532 for ; Thu, 3 Sep 2026 16:26:46 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.128.52 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1788452809; cv=none; b=mHP6EhB7nqDinLvgnTDaMbU/ytB3+k1ywTxTFkWZ0FcKM79Zd8LgDW+uHg9Ll0J2nz06pwalacrcptJinySpt0CvaCESZ0fqoDEhNbmaXMaXNlTuc5/KGOzt4HZbe5orzh+CjuQ7GRaR+AG90ionBbGkwpcUnB69Ke2S0yqVYZ0= 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.52 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-f52.google.com with SMTP id 5b1f17b1804b1-499c0879d51so44645e9.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=irK+ufdiJ9c3hcGmWb1s3Emncon6iyNPIjIzdMAoSlbBfZn1X05ghJ8dDX8hdX1P/s fk/cTwxLX3rnmnjNDT0wEv1gkMI1ECvFK1U1Z8Oe7M3+KfWD+4aBb/AKEG7C3MHFUSGU qgSEaXGqsZxaWyD6JUBVQ6sf+YOMOgfMsgpondekJI9z48+9b/M5W5OLSDKc+G1oIKQO vWxbk8/sJN2wB/oprqwzJ58tGfgDCIZ7z1zy5vAgzpY3JmHu3Vk41AGLLymgTBI34drB ccG6BURHGmu+WPcHn5rORzUOvnFBcSjaXkXuNpCtZwJKx7LZR4Ix9prODkJq87719lCA LBMQ== X-Forwarded-Encrypted: i=1; AKwUvBx+fnG0v49oW7abwy7sgn8VIqr9uxb0VGkXRXxa2tgT7TLP541Ia2ulXBlR/6W5Z4GThWBMhohxDgk=@vger.kernel.org X-Gm-Message-State: AFuF++mU1FmFIGA5o5kgUu3ODD58AWeOzCjmU/DlHnRC5zlO1QL7Rkxx mU7eLiP5i+Xloe5hd+tz/z41NnTiObQCHVjOimbyu41bpEDIPqZZ7UwE X-Gm-Gg: AYBFou2T8m2d58UzdbWg/cqp1jb3RxyKhwGzEhv2UEI6I+JFjq2B9PRq/fACJ2l6HIB edGJD8gtqMU1+mde9xdXibQIah7fEUjYxc2rofOfnDlZsaIJzsRBmqzFTmm6hqZsl1Hwv2rZIra rgO3+nEkpMdv0bVxrbVkhQIVvSnSrcSnOpwqACj6xLzsSGzQaUucR1daqOcWh+mpok9bhUHjQTI Pe1bc1Giu+JsdyPJOxO68KkvUAyUhu3j4Tm4nx/Uute+puspBL261888rBGjFbZPF52PZN7geEb v29/IkTfaItdU4t4FdbXjjOEPYdZbUjUflGMwQlAZKkfCx7jxM31cGo5BygUv5IWU/mf7XcoXyr YfKCvSojJsnyI57WdGv2383/QpMPGhiRIWLCdZRshNG3lONcz11YYhstR/MojXb/fukaX/RK14g hx5SXk0C62rLGuzFzVj77AMo49YnGy4fhNls612rnrlSg= 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-doc@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