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 1A266C3DA7F for ; Thu, 15 Aug 2024 12:44:54 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id A021A6B00DD; Thu, 15 Aug 2024 08:44:53 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 98ADA6B00DE; Thu, 15 Aug 2024 08:44:53 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 82B746B00DF; Thu, 15 Aug 2024 08:44:53 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0012.hostedemail.com [216.40.44.12]) by kanga.kvack.org (Postfix) with ESMTP id 6385D6B00DD for ; Thu, 15 Aug 2024 08:44:53 -0400 (EDT) Received: from smtpin01.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay04.hostedemail.com (Postfix) with ESMTP id 03DAE1A14D9 for ; Thu, 15 Aug 2024 12:44:52 +0000 (UTC) X-FDA: 82454449266.01.E57D522 Received: from mail-pg1-f178.google.com (mail-pg1-f178.google.com [209.85.215.178]) by imf29.hostedemail.com (Postfix) with ESMTP id 3544D12001F for ; Thu, 15 Aug 2024 12:44:50 +0000 (UTC) Authentication-Results: imf29.hostedemail.com; dkim=pass header.d=gmail.com header.s=20230601 header.b=Oi1WVADQ; dmarc=pass (policy=none) header.from=gmail.com; spf=pass (imf29.hostedemail.com: domain of miguel.ojeda.sandonis@gmail.com designates 209.85.215.178 as permitted sender) smtp.mailfrom=miguel.ojeda.sandonis@gmail.com ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1723725878; a=rsa-sha256; cv=none; b=azpGoKmPugMgEDbdFju3PxYTxSyjwcKjtJ9DiDLic63U0yxWY4Q7gBg8DSPE20ntkIRgaH D5K9A8wKQt9ozwv/U7jvs1/JpMBBnsMaViK1ace2JkApCiTxGYGQwAok6bHeLr+S+DU/aK WMcxTHUEKKpxZeluWaDG0Xuc2OYqzvg= ARC-Authentication-Results: i=1; imf29.hostedemail.com; dkim=pass header.d=gmail.com header.s=20230601 header.b=Oi1WVADQ; dmarc=pass (policy=none) header.from=gmail.com; spf=pass (imf29.hostedemail.com: domain of miguel.ojeda.sandonis@gmail.com designates 209.85.215.178 as permitted sender) smtp.mailfrom=miguel.ojeda.sandonis@gmail.com ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1723725878; 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:content-transfer-encoding: in-reply-to:in-reply-to:references:references:dkim-signature; bh=zaUO8KqepF7TIsKPx4BOFrKtUj2NGmhlsi3gEp5AZ0A=; b=sMUflBiHjNecHHj4EvdWJQCcr19IKy6xAO6Dbz5NcW4qOuC5BHlTIizMn8tqHKZNimQnlW kpLfofju5SsEpalcnn7SaskIc+X3oi+rtoJEXmNVZidXhcOeVI1pJLbdYgr2UwJQfD2Esa GYwKnGSfZ0CCBklAZRBKqfpdH/wcAS0= Received: by mail-pg1-f178.google.com with SMTP id 41be03b00d2f7-7c1324be8easo1423033a12.1 for ; Thu, 15 Aug 2024 05:44:50 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1723725890; x=1724330690; darn=kvack.org; h=content-transfer-encoding:cc:to:subject:message-id:date:from :in-reply-to:references:mime-version:from:to:cc:subject:date :message-id:reply-to; bh=zaUO8KqepF7TIsKPx4BOFrKtUj2NGmhlsi3gEp5AZ0A=; b=Oi1WVADQdxHGlykFBl0mbOceF8nVcdm+Tv3Pp8VGIaOsSFm17Y6dOIf1E8iyjR1n5/ lACdTs7MSHJN4DpDqqZWXgcYZUm+l6cd2xXjddLpn7aEb4Iwmu8R6MEdQA6xJz2GDFZM cbjhtnkcC0Vw+j9nJxadTc8/CeI9hmxmCqU1vOWpz01YomkehWx0Q9OZ1Bs9pu78Y9QX 7DGAPFabaEekuWfxhGmSlGDbjY1ScKu0ifCGnhjQ8PUChy0Y0oX+tFCyfSFurOJhDCB1 QYz2sWGDoHPOBKteOwC0mjjo2zEXOcdIHm2WQdd1dKbTnJqbeqFOhx1OjPyRIminFhSZ nvoQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1723725890; x=1724330690; h=content-transfer-encoding:cc:to:subject:message-id:date:from :in-reply-to:references:mime-version:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=zaUO8KqepF7TIsKPx4BOFrKtUj2NGmhlsi3gEp5AZ0A=; b=jMu2V/ZXYFp6TS1BMb6KS05SCWp9R1q1ju/p7MoE/PdSJIqjpIQQzj1Qa69+9t2Njd ss1XbVTXZekONjWfQzUAqiYnilJ5s7BHLlvRClybH20rqP96TFAmsTSOouOFWdW+FCnj J3dV7pcc9FwlMXK6jB7PasYra7ambXNA+ZDN/jgHmdi68EWh/K0Pz+ZuEre2BLW2+B+H A0PUcT4UXPT5DtU0RAycJjSc2hA5Vcqb8WYvjECcamrU3XnGV7p7sEDC5OHKkdYnxVby kY+4OWL/nwuHxaM/gPc3IBv5aj4JlBeJ9wBZpCUrceYqpxeVQCMS4Ea0UzHQf+EHc+B1 oMVQ== X-Forwarded-Encrypted: i=1; AJvYcCWQ3UIFetlV2Y2h4RUmEbN4itFbShUehYw5aGBOSTOdQE/67C0SBFsKAZFeewgn3m5Q+FgsKntRAnaBDQYHyxlw7J0= X-Gm-Message-State: AOJu0YxMxpIDTelmFadcBy2FcetcCfK50XE4ECk7Q04DPY1AfN4LftOL ewLRxTPRrHg+iLBuawBbUOFnD60eGkk83Tq3VNZ8ukG5lYPIGZMb11Mj1BPVAOUbfD/I/0TE9Fk orRwA+LB+FOgYU4It+tpSP3xhoNE= X-Google-Smtp-Source: AGHT+IFofOq09IsKpmrQJIfdTmeqkf26HIS9lZalMenCxQLT8Yr0fJiMnNkLzn72qFoygY5oTVLTu5R10HqmZsRrciw= X-Received: by 2002:a17:90a:ea0b:b0:2c9:a831:3b7d with SMTP id 98e67ed59e1d1-2d3c3a365b7mr4291506a91.18.1723725889725; Thu, 15 Aug 2024 05:44:49 -0700 (PDT) MIME-Version: 1.0 References: <20240812182355.11641-1-dakr@kernel.org> <20240812182355.11641-10-dakr@kernel.org> In-Reply-To: From: Miguel Ojeda Date: Thu, 15 Aug 2024 14:44:36 +0200 Message-ID: Subject: Re: [PATCH v5 09/26] rust: alloc: implement kernel `Box` To: Danilo Krummrich Cc: Benno Lossin , ojeda@kernel.org, alex.gaynor@gmail.com, wedsonaf@gmail.com, boqun.feng@gmail.com, gary@garyguo.net, bjorn3_gh@protonmail.com, a.hindborg@samsung.com, aliceryhl@google.com, akpm@linux-foundation.org, daniel.almeida@collabora.com, faith.ekstrand@collabora.com, boris.brezillon@collabora.com, lina@asahilina.net, mcanal@igalia.com, zhiw@nvidia.com, cjia@nvidia.com, jhubbard@nvidia.com, airlied@redhat.com, ajanulgu@redhat.com, lyude@redhat.com, linux-kernel@vger.kernel.org, rust-for-linux@vger.kernel.org, linux-mm@kvack.org Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable X-Rspam-User: X-Rspamd-Queue-Id: 3544D12001F X-Rspamd-Server: rspam01 X-Stat-Signature: ygqq5qe1wbuppojy9tgsm1m6y3acpbt1 X-HE-Tag: 1723725890-836811 X-HE-Meta: U2FsdGVkX18UfrX9vKXKZLDjt5dHm87PiPvpfWGzoWN3F0Gb0exE5k2biGAy39/nFuKKq/Qyk8dI524zbVG9x65FrLexvi7jYSxI+1Px/s6CDFHFhZHZ1Q60ntjZb4MopyoVLlmP2z4FbhBQD1xhlumyIUFdFNIA9aQn0+U+b9QatyoDSE0v6L+fwLCn172M79hjvmpnv/zd+933K9pJf8KrjgR//5dc1LckHWbm6b7Pe9NNN44UASvCciAbtzlbaYswIabQCOrsbD2UdKM/LVnbbwi+1UqLWzZ/NYKyzRsD0hnJ401ofzLFZoXm5s2pGeCEpchvTb1Qk+tZ3cCI3fjgE69g2FfxIWXiOAE+PDgPhP+I3tXWNBLqJKdvDKO5RJavjWPNzVOWQ4LX3YLsAXpKKGivaGW7D6Ooez4o+vWNn1ZutihiBgO6Y5xJPZ9qMZyJvovf63ijaDf7h3GpRUDbwRJOdJAw1kE5WR/dGdaNvLwp4QRYESNbqyLWJ4zivA0URrF4T5hWn7R8YhimZiF9c1TbyilY82SvdySn/ugkgxenTTFlQuteVtlqOsBJc3YNLnFa8lbyoyqFJG0cHTlwHyK1w82+9dI7Cv/g6tkkShl0vEjZeK1GhUlsfkCAEKD/56n4nNnLL2L87StTJAz0ssRq9sn8P8o33KQqVZgaQIvYs1TxdSAbOZQVnu59ZSQnRkB9r7miTv36XewHtvkv/d9+wJQb9R0QC6Mh4ds83zPNWQcj2MpebGegl9WDFGe8yiJWnunmnTpSzIL2MJCcyk3a7QPtZX8ssdfGOMme8PmRJjjeDLVrgZWM0A2h/vltkyXyJQll/jlDJmpSHe0pqS9AhAgENfoCwROBtrBHR6slpTuSje/dumxq9q+RLn2/GshiPCLToYgWGmYWM3t6TJNsqYAr6b1usTYQrIgRnlh4mh46Xvg0KReAMd+74aNScQlj+kcNefonEx0 jSyqE11u oQS138c1TBZKJZceaqweCWnlGq5bL31BX7S/JwW0YTI4eCgBXTJPhD09kBxB4yxfhC4XV9N7ORNWW3dqIsW1dWA9+tPHNTnzrbMsYM8J9D9KcOpT13eb23EXd6Dl527zoLU+10UxNelDcqzG/LXb2AJ1G/q8VMBxmuPiv/nRUyTPSyWo8WQ6xsJ6ryn23l1ffoibRwGbBOOMlhQPVRFIMYIQ32d5Wo3R4hKZ6/PO0YcLY0HXzVXQai27S94wguyS57NZIXpSAPeE7LwnZ9b0yiq+4NrhVTJ7Zbl9ljDp++FaPG8eqOSMRKo+LeyAowAGzsqVmngr+0porl63UxlHB4is6jltiUCNXxaocs6y5Lmb9TxgkxI61jN3VUnR/Woyz42QISSVa3CPdd2jcr71EvmAzZbr7Ki0ox6b9BwmlrDbPaJlLjCSSBXIrEHTj/cH8NxrBc7LAi3i0OxPm72fbhYwQa9/MTvayiac+ X-Bogosity: Ham, tests=bogofilter, spamicity=0.416722, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: List-Subscribe: List-Unsubscribe: On Wed, Aug 14, 2024 at 11:58=E2=80=AFPM Danilo Krummrich = wrote: > > I don't want duplicate the existing documentation around kmalloc and frie= nds > [1]. > > Maybe we can refer to the existing documentation somehow. > > [1] https://www.kernel.org/doc/html/latest/core-api/memory-allocation.htm= l Yeah, that is always a good idea. Sometimes we use the "Reference: " patterns, sometimes we linked to C functions/macros/etc. too (as if they were intra-doc links). In the future, the plan is to have the C side docs connected as "external references" via a new `rustdoc` feature, so that we can just write intra-doc links that "magically" resolve to the right place to the C docs. By the way, please use links to docs.kernel.org if possible, they are a bit nicer/shorter. Cheers, Miguel