From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-yw1-f194.google.com (mail-yw1-f194.google.com [209.85.128.194]) (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 A42D937BE9C for ; Mon, 23 Feb 2026 22:38:56 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.128.194 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1771886338; cv=none; b=nfkqu3jSC/K37KH6FwJQ8Us0Igv1GZrrlqIQ3/UwMKdlj5wuNafa2WmpxrgJPGYtZz5tHSrLE6dRg7n7ummxMciPNM2yP7bnGFe7Igkloxj9ImqNnEoFl5iM+/XeU7AhWsv+h5lI1Vr+Vka1jlDwhAHSABhCmyadk6Z8fRsIykE= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1771886338; c=relaxed/simple; bh=ZIS40BN/lVEtVVMEAyUeO8Q0LmXvqKfPsebwIKGBEeo=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=nNVBkGosvsZTrX/oLyAhToA369CgH5HBwH0XNXkEMJNJBx7n06AtJbW3qv3iKuLm4FzaDbcGxRgU/5NngLeAIy7rSLAzAFYu7j6/5R/4FzCNcj8qJ+2g/wVSsZBVdMNqQ7/EyfK0xfua6V9NGkZtG+Y7ZGxI/TnapWWVL7iMm1A= 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=WXwcJ5nH; arc=none smtp.client-ip=209.85.128.194 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="WXwcJ5nH" Received: by mail-yw1-f194.google.com with SMTP id 00721157ae682-797a52d8c34so45657287b3.2 for ; Mon, 23 Feb 2026 14:38:56 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1771886336; x=1772491136; darn=vger.kernel.org; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:from:to:cc:subject:date:message-id :reply-to; bh=0cemh6Unm8avZ318Zd18G/NSlRGlTIfX9gcE2w2y6Xk=; b=WXwcJ5nHT2Wm/PBC1YtI6EPOCYBowHp3Lk1cw+rFZMNUHtzbT9DCmAW/xRAREIgHIB CnIiKyBKNvtAZMG5pxeq1heJClkrSVPTvrFX6EzwNyNnnZ+2b1peTvJ3YNl+K/i3b9It 3SG10I3GoZgiQeLqR+RkMFANZ1ahMjQJRrQhhLT7Q2slVUOgqdPcJ2IgQppjMTVsgohD qx4TerJTJdvZgXiiO3oK6UUFl6VWQsjKft6zZa2ffx8XMU1NmU62gK5aBFvPG5mpS5bW U/ek6YQgDPh+GqfXaffTgfXOdkrHi8+rzPfeSNMt4Ueqs4X+XVLJ6RmLkGSxbqs+Xeal wdBQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1771886336; x=1772491136; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:x-gm-gg:x-gm-message-state:from:to :cc:subject:date:message-id:reply-to; bh=0cemh6Unm8avZ318Zd18G/NSlRGlTIfX9gcE2w2y6Xk=; b=gukc9jij2tYObiFQptXrGCUPtq3y7RGop5LBxoDsL305rV5JYJyjqmhneBPLh8T9FW ff1pj+WYZZ58qDt5lFLXZLHUL9JMTUFlbn3TYWeb9ylly5rfMEqs4WCkdmY78e+hRBis dcR8rLzd8++YQjZIcPEJj/ubjDKPbttSwwcx17ZmXFQGbRRz8vDFf3iLngUWS+kB7NCa zqcTcMHwlLRQaO0qzccsRs63RSyLGC0cNcHE5DdxZo6SpMG9cGeCXocZXJiI9R38vGEu qKsWUfGvv473YZY/Y75LjYTO84KMwgrVLUr1ie/xfa2GK89683XnnJWV0pclLA9Y8PSC +2tw== X-Forwarded-Encrypted: i=1; AJvYcCVCgZXdViLB6WU4pdQQfWdsP06H9YjcoUbX/B8cc3hu9jYmf/jWbiMDttPZ7LzUMXArO8JAGA96iYw=@vger.kernel.org X-Gm-Message-State: AOJu0YwA5sZLJE57G113ChxzGWgAXGN9L4Z1LuZB6JzaMTDXo/YuDoLZ bxl1ncxewX+SQ7n3JAlosGKiaAWmOvaQeLOY2+jYC3TMqZiwvl+PLXJD X-Gm-Gg: ATEYQzzgQBUsM11Pcl/VNMRZ9ZKafOwgKmJVcpRZj7tgmM4z5CTQroshstosDoAFsxx OlrIOR8ziAzy96qvlOGQKomwhawqvzxmejziHbkiZvDqgEZMQcMm+ZTWR/R5Wh+Z0F277xvoeym 0SYhq+qVjwk9fZcXoMB7wG4yFiRHMV75vGvR1uFTXvFP3uVklbecs9lytr/bs9gqnCAizdk9453 RdsJCi6DW4hnvl8S0v/PIANERUH+hzwfuxdn7/dJQu7PTpeI0AohqGmDWu7L4878MA3zbZcCLZ4 NBAXhmw2Qwy2Ww6O8TgR+55gp/zcXn2LJjAU1v3BR9tSwx9lqYK7+iwJB5BCpPL8jUnPyg1UFom mYf8KokoKNjV3ANB/j3Z/iNdSTd6xvwExpiYpqaYJCuLQU5CEqx9I4ZNb5fwAeOqjV+SOxzMSdQ irMbd99Hc9MIA7gjaexBhs3A== X-Received: by 2002:a05:690c:d89:b0:796:34f7:8ea2 with SMTP id 00721157ae682-79828fd308cmr92461117b3.31.1771886335647; Mon, 23 Feb 2026 14:38:55 -0800 (PST) Received: from localhost ([2a03:2880:25ff:58::]) by smtp.gmail.com with ESMTPSA id 00721157ae682-7982dd87fa2sm37132007b3.28.2026.02.23.14.38.55 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 23 Feb 2026 14:38:55 -0800 (PST) From: Bobby Eshleman Date: Mon, 23 Feb 2026 14:38:34 -0800 Subject: [PATCH net v3 3/3] vsock: document write-once behavior of the child_ns_mode sysctl 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: <20260223-vsock-ns-write-once-v3-3-c0cde6959923@meta.com> References: <20260223-vsock-ns-write-once-v3-0-c0cde6959923@meta.com> In-Reply-To: <20260223-vsock-ns-write-once-v3-0-c0cde6959923@meta.com> To: Stefano Garzarella , "David S. Miller" , Eric Dumazet , Jakub Kicinski , Paolo Abeni , Simon Horman , Stefan Hajnoczi , Shuah Khan , Bobby Eshleman , "Michael S. Tsirkin" , Jonathan Corbet , Shuah Khan Cc: virtualization@lists.linux.dev, netdev@vger.kernel.org, linux-kernel@vger.kernel.org, kvm@vger.kernel.org, linux-kselftest@vger.kernel.org, linux-doc@vger.kernel.org, kuniyu@google.com, ncardwell@google.com X-Mailer: b4 0.14.3 From: Bobby Eshleman Update the vsock child_ns_mode documentation to include the new write-once semantics of setting child_ns_mode. The semantics are implemented in a preceding patch in this series. Signed-off-by: Bobby Eshleman --- Changes in v3: - update language to clarify language that first value is locked, but subsequent writes succeed. --- Documentation/admin-guide/sysctl/net.rst | 3 +++ 1 file changed, 3 insertions(+) diff --git a/Documentation/admin-guide/sysctl/net.rst b/Documentation/admin-guide/sysctl/net.rst index c10530624f1e..3b2ad61995d4 100644 --- a/Documentation/admin-guide/sysctl/net.rst +++ b/Documentation/admin-guide/sysctl/net.rst @@ -594,6 +594,9 @@ Values: their sockets will only be able to connect within their own namespace. +The first write to ``child_ns_mode`` locks its value. Subsequent writes of the +same value succeed, but writing a different value returns ``-EBUSY``. + Changing ``child_ns_mode`` only affects namespaces created after the change; it does not modify the current namespace or any existing children. -- 2.47.3