From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from kanga.kvack.org (kanga.kvack.org [205.233.56.17]) by smtp.lore.kernel.org (Postfix) with ESMTP id 2BBE9C19F32 for ; Fri, 7 Mar 2025 14:22:29 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 208906B0083; Fri, 7 Mar 2025 09:22:28 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id 1B82F6B0085; Fri, 7 Mar 2025 09:22:28 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 0A83A6B0088; Fri, 7 Mar 2025 09:22:28 -0500 (EST) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0010.hostedemail.com [216.40.44.10]) by kanga.kvack.org (Postfix) with ESMTP id D791C6B0083 for ; Fri, 7 Mar 2025 09:22:27 -0500 (EST) Received: from smtpin04.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay04.hostedemail.com (Postfix) with ESMTP id 0BFC61A0C07 for ; Fri, 7 Mar 2025 14:22:28 +0000 (UTC) X-FDA: 83194970376.04.34DE55D Received: from ms.lwn.net (ms.lwn.net [45.79.88.28]) by imf28.hostedemail.com (Postfix) with ESMTP id 57C0EC0009 for ; Fri, 7 Mar 2025 14:22:26 +0000 (UTC) Authentication-Results: imf28.hostedemail.com; dkim=pass header.d=lwn.net header.s=20201203 header.b=KolgCqAa; dmarc=pass (policy=none) header.from=lwn.net; spf=pass (imf28.hostedemail.com: domain of corbet@lwn.net designates 45.79.88.28 as permitted sender) smtp.mailfrom=corbet@lwn.net ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1741357346; h=from:from:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type:content-transfer-encoding: in-reply-to:in-reply-to:references:references:dkim-signature; bh=ihMi6eUWoBG67x5XZWjzpKw0nnicR+z1rqoKyPAosc0=; b=KQz81KsLKYGFlprzy4mvxAti8MMypSqUAP+Mq3vpazXl2fTSUZVJUsnbXzpduJ+be/e6Ms NwnoAExzZIAcZvJv4WbIRvj+B0PUZQgfQLsg34cGprIb+lD6wQLskHs1nNBCgEY7YwWnlr 8GUhyhb8FZOO16Qyv5TP6iakMRkMFTo= ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1741357346; a=rsa-sha256; cv=none; b=BlntFdGV/lT6pIkO5hmIn2E6cy/bHDA8W1n7xiPVmSVS1Zwey1Dx1gtuaj39TwtrkZtqft UaKtqw6wtcx0O/GS+jjN9u/JDTG3+GLoJKzZU5RQUuN8pUvgdbwtBrsE0BPlB+awNUAVNu srpRMhzeVm4G3XlkgHHdoP+9qdh1O5k= ARC-Authentication-Results: i=1; imf28.hostedemail.com; dkim=pass header.d=lwn.net header.s=20201203 header.b=KolgCqAa; dmarc=pass (policy=none) header.from=lwn.net; spf=pass (imf28.hostedemail.com: domain of corbet@lwn.net designates 45.79.88.28 as permitted sender) smtp.mailfrom=corbet@lwn.net DKIM-Filter: OpenDKIM Filter v2.11.0 ms.lwn.net 306574105E DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=lwn.net; s=20201203; t=1741357344; bh=ihMi6eUWoBG67x5XZWjzpKw0nnicR+z1rqoKyPAosc0=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From; b=KolgCqAaKSRvl4BpdkLf68uOY6ycttrCai6uBAeUv7AYMdowFzB1ry6Fa6VN6EU+r bccR64R5gTWUfbaTknO2VDolfU7n0LqUsLvlq22+KM2tlEq+yeOqSE1jRudS9Q4AIW o0Vc8o1cE/Hb9ZdiN8Xe39y/6NnMSNZlKE+PLAZUvlmamH5cJUvvsaF87Fx7qYv8qL 4Zsmao2IGj0jFTxt4SzmuF0k9XzKqv4yhhS43MGHNzZ5ZPOBnEyKIK1yjSYqQT41uT vqNEJYuLNI7HBC91PUmiPRd6F/QubeYSPstaCdCrVSwoQWHLGMWq2k/ydrtBC/Ty4h MI4WzsTnml+uw== Received: from localhost (unknown [IPv6:2601:280:4600:2d7f::1fe]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by ms.lwn.net (Postfix) with ESMTPSA id 306574105E; Fri, 7 Mar 2025 14:22:24 +0000 (UTC) From: Jonathan Corbet To: Pratyush Yadav , linux-kernel@vger.kernel.org Cc: Pratyush Yadav , Eric Biederman , Arnd Bergmann , Greg Kroah-Hartman , Alexander Viro , Christian Brauner , Jan Kara , Hugh Dickins , Alexander Graf , Benjamin Herrenschmidt , David Woodhouse , James Gowans , Mike Rapoport , Paolo Bonzini , Pasha Tatashin , Anthony Yznaga , Dave Hansen , David Hildenbrand , Jason Gunthorpe , Matthew Wilcox , Wei Yang , Andrew Morton , linux-fsdevel@vger.kernel.org, linux-doc@vger.kernel.org, linux-mm@kvack.org, kexec@lists.infradead.org Subject: Re: [RFC PATCH 2/5] misc: add documentation for FDBox In-Reply-To: <20250307005830.65293-3-ptyadav@amazon.de> References: <20250307005830.65293-1-ptyadav@amazon.de> <20250307005830.65293-3-ptyadav@amazon.de> Date: Fri, 07 Mar 2025 07:22:23 -0700 Message-ID: <87ikok7wf4.fsf@trenco.lwn.net> MIME-Version: 1.0 Content-Type: text/plain X-Rspam-User: X-Rspamd-Server: rspam12 X-Rspamd-Queue-Id: 57C0EC0009 X-Stat-Signature: jktmg4enyze5x5e5qkx9uczowpiomfkf X-HE-Tag: 1741357346-170543 X-HE-Meta: U2FsdGVkX1/ABMsZEQqJxM0bo0fAk1Eqf31FXkVGb5g5TAdXIyDQurTM1Ave2CB1ggBOO8G7JDnu+PONQnfxnCBOl4E8fK3Oii4mJtdde7xKXOBGylj1+HpZkcUaH8wXyU1L7y4nzNT9bHEOALvQ8/+CMZmrSkme7axYq0xOo0mkQiosdaniKH7lir8VSoaapjANOJIAaTzI4hz4ybtyhcm9nQ8qbaO+r2KvFTeYGkxxmzDma/Q9OcNrYawGZYw/91yaxDFDd3SSwr6oa5e6iADMnXT435JICEwq2vhqh69e+65c3f6GWakNS3j5Mvc1XJ+OXHYZABialNic79OmtcfLtj/yzjjofMMzfRA5BGLs+FjUuH1hGrbcY51ekcMP2aPoKJsmh+8BrQqAJ6tMnZzdmSBuw40YYXDHHOu4mi6kT5odsyUDViog/f6walC1cNupjWUp3Wy3kGVHJSyr+X5VPciOo2qlmbGARWYfiySha4V6+nnuwrh1NOJUIbhaMx42D5P17WMl4YNIb84NbQk+exY2I1hMGdrHmjJ6kXT6YRRUM2laY3mjxpswKr+Nu7h2ts3wgd8QsCQtPXl8bjpRSimXrm/wcOjRR8pJLEQWR7LEznwfQljo+Hx4sG6C4Q3PEOBTTm0N2nc01bj6KBp0jNOYk5rGkn8V0DQOpMk6BGbyQoX8SX+A31sXjsyHaDrbutU3NtxqjrQDEhSTqgKjRI0YjE+r5in+4PX6aNzG3a0QVOqFbzUAkDu6f0BxDKYqQaFGc63+75QJ3i+hVRX6/EmnwuXQhamIEWyMwpZQ2gwYqzlExgGZdDTIGT05wkAU9EhVFuRf339wni1ZRXgZ9Pz7I+vGLFScpm5lpWhIuRM2zrhIbiTUaPMWERHvIltrImu9qa1jqEdtIjHZkflkCtdPx7wMp6JjtKCVSMbDrnlxcwYecDsOPqb8HQVuscTLfEDy4uaRsFkqppg CYX4v7hp hgIev6o9im7IUohcY4JSaOG4PBW72z1KgxuERddXkWhl1EuwALW9CSPKLvYUfXdR0a0XDtb5DvaY9kyuBHXdxMNzsbqrdKF1RGa6nEkvcKOGoByacbGjSjMeubBGgr14kEVsk1RePzvmYMUN6AFdjzOjnmm4eYMrqAUIt8tQUbD8OlB/HP5mnEvOLjh/ZcQaygbRV7Gadzh4f0JGVULqvMypQt0oleQ/EwIt0BaQ56JCyZURhD1GuOoXbWhfDf+e5kgCTCqlCG8/sVP0ylvD2FXLiscR/e999RaNeTbSSmqZa5zHRSuPetusZFIWwzTY8ZI1+Z4EdSeEtcfBg81hETUPbg7G773Rx5kB9kdiXMSh+Wmk= X-Bogosity: Ham, tests=bogofilter, spamicity=0.000000, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: List-Subscribe: List-Unsubscribe: Pratyush Yadav writes: > With FDBox in place, add documentation that describes what it is and how > it is used, along with its UAPI and in-kernel API. > > Since the document refers to KHO, add a reference tag in kho/index.rst. > > Signed-off-by: Pratyush Yadav > --- > Documentation/filesystems/locking.rst | 21 +++ > Documentation/kho/fdbox.rst | 224 ++++++++++++++++++++++++++ > Documentation/kho/index.rst | 3 + > MAINTAINERS | 1 + > 4 files changed, 249 insertions(+) > create mode 100644 Documentation/kho/fdbox.rst Please do not create a new top-level directory under Documentation for this; your new file belongs in userspace-api/. >From a quick perusal of your documentation: - You never say what "KHO" is - Your boxes live in a single global namespace? - What sort of access control applies to one of these boxes? What keeps me from mucking around inside somebody else's box? Thanks, jon