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 CF703CD3424 for ; Mon, 18 Sep 2023 23:26:27 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 43A156B046F; Mon, 18 Sep 2023 19:26:27 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 3C2476B0470; Mon, 18 Sep 2023 19:26:27 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 23C396B0471; Mon, 18 Sep 2023 19:26:27 -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 0D0C76B046F for ; Mon, 18 Sep 2023 19:26:27 -0400 (EDT) Received: from smtpin26.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay04.hostedemail.com (Postfix) with ESMTP id D7BDF1A04AB for ; Mon, 18 Sep 2023 23:26:26 +0000 (UTC) X-FDA: 81251304372.26.D05D917 Received: from mail-qv1-f42.google.com (mail-qv1-f42.google.com [209.85.219.42]) by imf18.hostedemail.com (Postfix) with ESMTP id E7B131C002D for ; Mon, 18 Sep 2023 23:26:24 +0000 (UTC) Authentication-Results: imf18.hostedemail.com; dkim=pass header.d=ziepe.ca header.s=google header.b=KOdzlYCB; spf=pass (imf18.hostedemail.com: domain of jgg@ziepe.ca designates 209.85.219.42 as permitted sender) smtp.mailfrom=jgg@ziepe.ca; dmarc=none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1695079585; 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=oAEtx1s5KODmNlfwZDRx/5fDgP/BvGwuP+6p/LeySyc=; b=nSb7+JfTaAWXG/YWhY5fF3h95xiW9G524lhVBStYruFpU0zkMH9EXP9fUfcAEtB9Yth7Dm hZ+c4OlNN4OtO6vmxeNfCnZ957wetYkYNgMTnszQzulix7dQRsOwX4aFujgTktN7HyXyZo PbOZdQ1PyIvvi37OBSv9iv600QDpwLQ= ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1695079585; a=rsa-sha256; cv=none; b=sHg9n2wez1suMLEMYoB8DKECMo1m8Xt3xP7Kf7hTYgdlYGFCj4lRmiUZNBN4RZyFwIslZA eImP6KGzCFPiNlw5VPFq0rcJt7ULnCo9GlegBLopEVrjzg2IQeky55GD2Sq3aySpN0+Vc2 gQm4ohp+JPCdBdiY2WtKb6m/6LAKQ6Q= ARC-Authentication-Results: i=1; imf18.hostedemail.com; dkim=pass header.d=ziepe.ca header.s=google header.b=KOdzlYCB; spf=pass (imf18.hostedemail.com: domain of jgg@ziepe.ca designates 209.85.219.42 as permitted sender) smtp.mailfrom=jgg@ziepe.ca; dmarc=none Received: by mail-qv1-f42.google.com with SMTP id 6a1803df08f44-65635b46f1aso16186936d6.2 for ; Mon, 18 Sep 2023 16:26:24 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=ziepe.ca; s=google; t=1695079584; x=1695684384; darn=kvack.org; h=in-reply-to:content-disposition:mime-version:references:message-id :subject:cc:to:from:date:from:to:cc:subject:date:message-id:reply-to; bh=oAEtx1s5KODmNlfwZDRx/5fDgP/BvGwuP+6p/LeySyc=; b=KOdzlYCBedrXHKlB0m79xn3bEnlH3dxOBNzHYwEdYf9lVRsyLXl1UODy88f43zg/6a p2TZaArn4D4z391m2ydKgErI/OEXJ/g8Ul9xHdvkK0d1Vi3cOrId02QA8fMUOBqr6aY8 NUHjZjT+Zord+fhiLOLfqcAlKHjwIOv89DRzefWfJrgEk2AoBwvomO2LlV4LyIUkj2IU lGTokMs93zaSUblm7pxKnS2Ospb7p+DcL4yTDReoJio8Hkd27h4KmZUDlrMI6V5AK7Xc h7uQrulVirhTdSgCsRenugMtbgsXUVBFQDGJhpkywRqrvr0Uq2eNFBd3lhtqKmM9UXS1 294Q== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1695079584; x=1695684384; h=in-reply-to:content-disposition:mime-version:references:message-id :subject:cc:to:from:date:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=oAEtx1s5KODmNlfwZDRx/5fDgP/BvGwuP+6p/LeySyc=; b=KzO7iF8qktqH1+V2jsi9ZJRSzFLi8XnNqxNmJ7o1YwW7Sto3IjzCHnBnh0cRzS+tSA 5VjVt8gMfsSar0UyjFhKLDJpUO3wF2P2/IWnjFPq1kx36y2Tz1hatuwcI4Ka8xccayFY NK41bXh5jxqR5q/YJwojsZrwy3rSBi/PIIX37R9keVNIgTRUFdA19EXBYPomj7lnZD31 seRRNiriPyDzny8DS8fuLy9vMGVplWxlTFU90/4Tvt7onrz0/aH541q5J4zwhUXvmI0B NoUCNkuBdwIUhrd3PYwPW+bLOBidAXalIzSulprQYkC+ajpX6ywxm8TTf0BDoDZBHorv 0scg== X-Gm-Message-State: AOJu0YxMJuGnnZ8AXb6vatJFv4uF/P1x3biPZHXDnAxsMgt2d8zCXnlQ oSqa8zJiysnaDc93nF5FDqPjJQ== X-Google-Smtp-Source: AGHT+IEXRIdmJQWyD0S5IhYq/RPfPN15fkMe6wTPmqLT8+ltrjCiLknrpDQvIt75XWrfMAomw0TJ5Q== X-Received: by 2002:a0c:e493:0:b0:658:2a3b:4a1f with SMTP id n19-20020a0ce493000000b006582a3b4a1fmr2642260qvl.22.1695079583965; Mon, 18 Sep 2023 16:26:23 -0700 (PDT) Received: from ziepe.ca (hlfxns017vw-142-68-26-201.dhcp-dynamic.fibreop.ns.bellaliant.net. [142.68.26.201]) by smtp.gmail.com with ESMTPSA id u11-20020a0cec8b000000b00641899958efsm3617260qvo.130.2023.09.18.16.26.23 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 18 Sep 2023 16:26:23 -0700 (PDT) Received: from jgg by wakko with local (Exim 4.95) (envelope-from ) id 1qiNdG-0007o0-U7; Mon, 18 Sep 2023 20:26:22 -0300 Date: Mon, 18 Sep 2023 20:26:22 -0300 From: Jason Gunthorpe To: Jann Horn Cc: Andrew Morton , Alistair Popple , linux-kernel@vger.kernel.org, linux-mm@kvack.org Subject: Re: [PATCH] mm: document mmu_notifier_invalidate_range_start_nonblock() Message-ID: <20230918232622.GN13795@ziepe.ca> References: <20230918201832.265108-1-jannh@google.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20230918201832.265108-1-jannh@google.com> X-Rspamd-Queue-Id: E7B131C002D X-Rspam-User: X-Stat-Signature: nr4aiuanajxzkbhducw73adsu33i4onk X-Rspamd-Server: rspam03 X-HE-Tag: 1695079584-993520 X-HE-Meta: U2FsdGVkX19jGNzkUGcZWWc3u25AoPReGUKMNYKnYiopT1pgk6t4shAf0iURwu6bKh5u8NMmeiVnYQob9NGWm4B2Naq5kGSBFid73R4DJxcSJ4hXf1Ha7AllXWUZNc/WTb/fi7YWMVjkJCsUbf5Dv+1TdTlKL+SwJcCoOU35WknCZn6B1GRosUWoVDw1fMSD5Lo0aM/VLf1o9+VB4LhZyjnf/ti5e1FDQGExQOkYYo7hfQN15eqOp8bpH6v1GbJ5zwdiEhGcDbXENIeFET7/tsBBFg1pTYhHzFFicBgnrnYjkjp1Z83nQpGIKWTS0nfNBHWuTl5FBWxmsZCEvvDsy8I/ejPbiuir8soDO5L6xtLJiGZ3rYXN6T11sy9c7J9rU5hSI3PCqWT417POlKiDjQo8WcFCV6b9IwiSx0mKYeXXIzQ5g+jkTLvitZY67ZF9R5CPOiGHiplyhbASCn7q0QJdbp4+X63EbuXP2yomL+fVRCc1h0NXN1qgLFdZEMHG9fe/O3sYH89p9nRGnxk0c1E3RPMLoabhEgKBkFfts+Lv8XLUq6WQZwkUxrualr2HRxQvTClCt+qH/GUAEGtgK5NTWzwGLiObfLq0ga3ButGDoxx4bhajECJI0jBbUrOKu/mi44fZRLQw4J7daaEyHRArROdXCnNSetbGY5pH35VCWyO+KR5ssSlZqibdA1bxTMluEvbhB1Zk9A7qfb3pqPnRlL3AhAoVakYh434dyfRtToUGmromIappDWPs9J0kjYJ0bpovDs28w+4LQhOhodnCUg99I6xhOwuz2rzSZPM7n2yE/X4FV+M2uFMP9Xtpe5JEDgHf06cTKjUFdhMRPzeJaXNi+R35/wyAiv/8spDamdOy9mnEVAbyYVi/RAieifsTzWBAf6vJ7Rgl4IET4ATVb4HGx+UbRpSTBI8EImsazfNXLdpyDMOKIqbUL0gkAWPCCtdKasUigKiJ8m9 qxZZ7Zlo bAictMfpYDHr1xOt4uDTV9HtzbKGH8eLNzzavrrtxA37vjS0uLnqE1gQQ6OTI36c+IR3CRsZUybrHhDUcQNaUC5cnof0iiPAFj6xQw6HSXayLg3FGelfYyGHlrh3eeVEfb+Ra6PRhDwN9WrA/1vTrCRYZdLu0VH3iweepluwweuh9Lh8WAa6j21i07f/HBsNKRIvkJz4y4HPqG4YCYV75TM60j8qeTFK+DxOuk4wW+I+OOZMaTZ0DjTg4xwVbEY6Kacw/anVxes98PBd2G7V43Px71H8YAImhu/CP/fzzhSpafpUzdGXg567EVXoceaiKgtvx0FPYONOkBpb6FuRYkO8Z/V+4FTN5YfHv1GQ1oNkD8IpJHRJCI4PNZ2/kIGD0YnB5ZEIW38Dmi5LoIqvovUC0AiZToaSRIag+ X-Bogosity: Ham, tests=bogofilter, spamicity=0.000006, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: On Mon, Sep 18, 2023 at 10:18:32PM +0200, Jann Horn wrote: > Document what mmu_notifier_invalidate_range_start_nonblock() is for. > Also add a __must_check annotation to signal that callers must bail out if > a notifier vetoes the operation. > > Signed-off-by: Jann Horn > --- > include/linux/mmu_notifier.h | 9 ++++++++- > 1 file changed, 8 insertions(+), 1 deletion(-) Reviewed-by: Jason Gunthorpe Jason