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 766B0C35FE8 for ; Sun, 15 Sep 2024 07:48:39 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 4DF4F6B007B; Sun, 15 Sep 2024 03:48:38 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 4679B6B0082; Sun, 15 Sep 2024 03:48:38 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 2E1726B0083; Sun, 15 Sep 2024 03:48:38 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0011.hostedemail.com [216.40.44.11]) by kanga.kvack.org (Postfix) with ESMTP id 101D96B007B for ; Sun, 15 Sep 2024 03:48:38 -0400 (EDT) Received: from smtpin03.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay01.hostedemail.com (Postfix) with ESMTP id 768601C6BF1 for ; Sun, 15 Sep 2024 07:48:37 +0000 (UTC) X-FDA: 82566195474.03.6CAD16C Received: from mail-il1-f175.google.com (mail-il1-f175.google.com [209.85.166.175]) by imf27.hostedemail.com (Postfix) with ESMTP id BC38B40008 for ; Sun, 15 Sep 2024 07:48:34 +0000 (UTC) Authentication-Results: imf27.hostedemail.com; dkim=pass header.d=google.com header.s=20230601 header.b=CLDfYKMD; spf=pass (imf27.hostedemail.com: domain of rientjes@google.com designates 209.85.166.175 as permitted sender) smtp.mailfrom=rientjes@google.com; dmarc=pass (policy=reject) header.from=google.com ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1726386370; 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=HLVuFTjPxdVI+7kmGEybDvBlo3i0Ln7Ns6A5/HzGKOw=; b=3RJA55j9QVV/NTCpoGBHLF1FM8eBfuH8SGjdwUz/AaMTZm9CAMarP/XDmUqaj+eYJJN57u MUe9Vw0kIsTnueTvwKLVSe2NiJaKvP0qok2IMU/jbbe/xBYhXF4oZ40JWxEQbiVirvuAxg CiuwN939eoSbxoUplVmvXXaBHwwXitI= ARC-Authentication-Results: i=1; imf27.hostedemail.com; dkim=pass header.d=google.com header.s=20230601 header.b=CLDfYKMD; spf=pass (imf27.hostedemail.com: domain of rientjes@google.com designates 209.85.166.175 as permitted sender) smtp.mailfrom=rientjes@google.com; dmarc=pass (policy=reject) header.from=google.com ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1726386371; a=rsa-sha256; cv=none; b=VlZPOrXN86a8iw2MHnV6vQQ38ljYJu1hPYZ7hVRT/RkDJ06ZBSqfXS4P99a4+7OF5VNqaT 9ihRDXrQo1sIJMz7XnxyLijvCXZ8d6r/JfrC2bK1RKdeFFU6MPmCp3kiPBmB3nyYGKt4OD WwkpYEcMlsrhtCd8me26KxCaYrHx0Rk= Received: by mail-il1-f175.google.com with SMTP id e9e14a558f8ab-3a098a4796dso369065ab.1 for ; Sun, 15 Sep 2024 00:48:34 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20230601; t=1726386514; x=1726991314; darn=kvack.org; h=mime-version:references:message-id:in-reply-to:subject:cc:to:from :date:from:to:cc:subject:date:message-id:reply-to; bh=HLVuFTjPxdVI+7kmGEybDvBlo3i0Ln7Ns6A5/HzGKOw=; b=CLDfYKMDmIZZC5HTQ2e1U9fbTQsYtDEuoG7Rxp+phEntTCDYs7iTrHDmW2eecYToCS MSZYgOFa8fVjeTwTg0c+5KJvxJ9qFpGFl4FyYexzQIbB57OVI+BTYVDxONqfg7MejjF4 qe/r6e3UxOmU3246tEbQOI3SC8QnddZyH3Ps69IDCICLkM29BW8px+7qGIFV/xr0sXJN +d4Rh20A1O2cQAfPMV5+m//DG81c5LdG2RQR8YtXahN9COujPOp6jwqvLhLAZHNUcKlr CDpox0/eV8hzivYu8/HXJzwifjsd4J0UZf1/26RyTUz+021fET3PXqJ0ym7abZZm6aCH i1rQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1726386514; x=1726991314; h=mime-version:references:message-id:in-reply-to:subject:cc:to:from :date:x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=HLVuFTjPxdVI+7kmGEybDvBlo3i0Ln7Ns6A5/HzGKOw=; b=FeUssRBxf1Cvjz7lBBgolr3nchuxjh3HCN6K8+oy5qHlJjOHRej7gk5QG48+mi583y 2xWV+SWCF0rMfD4OrYSs/yOUwnqXweGaEpJrz2LBnkw74/cvSF0NaO5oGZmc8W86YFDw hgDm4mpIuXMQTPpAtfQqFvxFDRp35JvR1XnRDREy89Zc9s960kNs9nge4S6aS7Gys6vU gW4X5nK+e6qTL+2Fh+ZyOJmmbF1CEss78UJQ71GkzSivIDN+G4njp38SkJ9Yl1vJA4iU xdWH+aHLfknQfKHd3jjxE5VfsLOIalmIKrwqLkz6yxWXS+Sa306HG3CWPixW+xMe9Kco BaIw== X-Forwarded-Encrypted: i=1; AJvYcCWulrb79nF6U6rii4dV2B0sFWq3y1mzO7eJUM3rpbet+jlPu/TEqCNQkHvR0wJUZ5ox6ZM8E/5bbQ==@kvack.org X-Gm-Message-State: AOJu0YxHX8Q/wrEizmSEjAuQOMM3EQUUUvM9WhJu6kI0o7Cv+Mb+71ca iQDoHRZ2p/zR04UjiCbIclK7Dbc2ha0oTY17JlxepCPlEeUZ2J30cW5pdx4fag== X-Google-Smtp-Source: AGHT+IExSliTPWuWZjVVFc6GTpC/D2iSL1U8krUYXTmqeRkU6+E4qCrb97cAgkyq5SvwFOghW6EjeA== X-Received: by 2002:a92:c549:0:b0:397:2c0:4a58 with SMTP id e9e14a558f8ab-3a0856d9c9cmr13754115ab.29.1726386513460; Sun, 15 Sep 2024 00:48:33 -0700 (PDT) Received: from [2620:0:1008:15:8b83:20f7:eba:dd56] ([2620:0:1008:15:8b83:20f7:eba:dd56]) by smtp.gmail.com with ESMTPSA id d9443c01a7336-207946fb72fsm17910315ad.199.2024.09.15.00.48.32 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 15 Sep 2024 00:48:32 -0700 (PDT) Date: Sun, 15 Sep 2024 00:48:30 -0700 (PDT) From: David Rientjes To: Vlastimil Babka cc: Christoph Lameter , Christian Brauner , Andrew Morton , Hyeonggon Yoo <42.hyeyoo@gmail.com>, Kees Cook , Roman Gushchin , Jann Horn , Mike Rapoport , linux-mm@kvack.org Subject: Re: [PATCH] mm, slab: restore kerneldoc for kmem_cache_create() In-Reply-To: <20240913083713.14838-2-vbabka@suse.cz> Message-ID: <6f2c2766-f09f-2e24-01d2-f444449dd9cd@google.com> References: <20240913083713.14838-2-vbabka@suse.cz> MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII X-Rspamd-Server: rspam06 X-Rspamd-Queue-Id: BC38B40008 X-Stat-Signature: tazdggr4wc96iefg8h1nwjja9u784b4u X-Rspam-User: X-HE-Tag: 1726386514-64588 X-HE-Meta: U2FsdGVkX1+Gf33xzSv3Tot7r4Uf0BExy6lblqnowonNtpKSoShlQRgtq/9cyH/c/UXrGLQMwgEgEPQDRSOZHGPQ7qMq5gW0h7f4idqaAApiaLmkvpRRKLHiL8UJxkRFhK+zK0g7ITFd9LjTSUSg7qLPAuo/tI/FZ9/oiJQVFEUeZIO+Lok/MM0T5nCjHPU5olX0Gjqd/1g5bd/Zk/ZB/RHSsIasMPJlnr8ZgHyAdqa353bj1qdYfTkonIiINd0x1utS/HmdIUYi2O6NxOEe2hIe4G8wGkHegwg/2E+Wp/PkYi9jDli/4S3QU8jeh+Ta9nXb75pLvcdnqyabiwr4LoCnPyOQGALhhrvyEcTyiHQpXfsOx2QKJQG4ukOgvLMcQxvNBuF4nucQM5MyrNRLJs1lBW0/PaDKtPIAUwKSAIs4ZVzIpsHDzAJ3fQk15ioKMVycmlHRFZfk8lG5aZqwNzuVTkKcCOlsGPCNRLTBL86AW1yV40gljcdGHxfuTW6ToH6iYv7/YsYLKGdL6yQjlNAixEWh79FhtxuqS3HZYSNFLt6I9z0JbbkjHLLh3EO/GNWpEFUzSHFrT1NazVlpwHYhCHOYCsAwdjZ7dl3wuIel43uEQ3HmgwWGlO/DTdh3Z2kXIqOHElTxvqsepxsxGY2oOpk/oe2M7bBRGPJ/laooXw0jeI70flLZZ6wv+SYsMhvtLv5TPtMYuEws39DgxyKXWM3TQ737plkwUpPja5eAb+CP0MaZiDdDobzztQCLXQoXy8f2LX+BpO/inLdezXQEKpcE05ZRzj16qvcy2FwxfeDSY7dDU/RMoQ3jXnUahNJTAWaP72fkBgcen3zt34GTugo7nIGQa/0612h/odSaAB8OByskZRMoze69Orh5vKI7TBSbnOMmecIar1nB5ePpZMymd1ET1XRp6wERnXYCW/ioHR4H79CSjusatFzxeVhqjBv5yrvFF36H8o8 nz2gU3y/ VGfyUEuvB0AG+XC5xDY84pwXUwh773AiWjMRD62wFG+EHuOgvObTbgF69B+MYGyYXX3QVTqM94YVcLwtwF0UtTguNa2uOwakHV1ZZ/+bYCZ8atWygPeVKxuPHYQVM3i1Ka8OqUI2lv8Jfn7+Q1lgR3g7vXmGf3+W+FTq8QZvjgAB+kEbtPALBnIj8H3Hl8M83Q+bdYL/3Gnjl+3oaL1FQJNjSbh/t/PoqOi68qGRi+wz65gviaJjLCIAHoJH9KgKXasXiH+r1RlEJfCbuihkzDUOQvPRJkx2Z1/Px0MhoDzxJLljgnbxSgildDNWUztBZWZO1RunY0HppVIsRxzhTsdsFTWfUb/s4T8BK2VWsDfj8jydpZixJ85OXDeUxvZ0CQLbeBQxbHaBBAyZPdvmjZTuEIcJl9l7FDLkNEu+ntN6vxhqGrn5N0i0on0wlPlUVufSTwc1cK5eRuP1l4PWAjQ9IxyURdk1K/VcU 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: On Fri, 13 Sep 2024, Vlastimil Babka wrote: > As kmem_cache_create() became a _Generic() wrapper macro, it currently > has no kerneldoc despite being the main API to use. Add it. Also adjust > kmem_cache_create_usercopy() kerneldoc to indicate it is now a legacy > wrapper. > > Also expand the kerneldoc for struct kmem_cache_args, especially for the > freeptr_offset field, where important details were removed with the > removal of kmem_cache_create_rcu(). > > Signed-off-by: Vlastimil Babka Acked-by: David Rientjes