Received: by 2002:ab2:6857:0:b0:1ef:ffd0:ce49 with SMTP id l23csp2990218lqp; Mon, 25 Mar 2024 15:56:44 -0700 (PDT) X-Forwarded-Encrypted: i=3; AJvYcCXNEhUxClNlXwXt1c7l9GNpDDcRifbSZFWod/Wgiu3YzCA8GoFQXN2PCzTl6UMvzEPgoODrtiR4AZNNYPmvRXlBDSemBZYqXbIFHjR4BA== X-Google-Smtp-Source: AGHT+IFdwPSBpg0roBTkCgunsq5czIIuy+uVWbqhsJGGQuTqdVH1rrH0xgWBfSkG14728WEqq1Zn X-Received: by 2002:a17:90a:1589:b0:2a0:2881:74f0 with SMTP id m9-20020a17090a158900b002a0288174f0mr1086824pja.21.1711407404181; Mon, 25 Mar 2024 15:56:44 -0700 (PDT) ARC-Seal: i=2; a=rsa-sha256; t=1711407404; cv=pass; d=google.com; s=arc-20160816; b=Tkl7V9flnrMFe8hmomK+OAswTG8s2zNE4U8SLftZC/jLFaKGfgThFJEWzFxBpNxp/c jqtOPcyOovCgvmU9PWLAKUTbBS1vm9gSQjuRpHRaL5n9Eh/6fTFO+IA3URemmdEx+TMC +6Mp/vV4aBAmdFr5yOSHDt2mUrQJZbCgm9ND5BMErnt/ypXl3QzpMyfkJwpChwC99bIF Ac/1Zh7hSxPV6aLeQ4kBZwJcYA0OYQklClt9ZuAdUe3ydz9z6Qc0nnCD+UAFlwPYi+uH 0s9QNUEeTcl2R0TbTT6Cw8zu8JRYYDl8o8PNEfluViGqBLapUUHhMTi4/PeUzFnm0dQW vDQw== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-transfer-encoding:in-reply-to:organization:autocrypt:from :references:cc:to:content-language:subject:user-agent:mime-version :list-unsubscribe:list-subscribe:list-id:precedence:date:message-id :dkim-signature; bh=+nYy7tLv6zdEfSJ2dkzNYv8VHoAv3J8y+eYNA6CJIJc=; fh=3NrbWKDcXYwPPKp+UAqKqiHyPHPkdnxxzRig8uqTAjk=; b=CDMcdtZMhFs5OSQDB5cAJQKHvgqxm2Hwrw0izkmM24A/HvzVuhuMlriVKS/SM/B8ZY wPptl45qPEaFK7leCUEkH2ItGl5X+a4X1H7VERT6KNWD2XDnqtrVE7zjzX1q45r/imcm BTBRf+fNnVdM3vIUSMnp+pCQF7reHEJcdQZrgAJt5P5n6bMp63PoJD12jvGOpG5SJ+2P VAsWkikl7U4cFVzh9d4YRpL0zqwoNp+H1jlV7G8g7R6xWdXdy5X+G1f5QloL5sJCQhIe IYK/aBzAiCrtEa8uachO3WQ2sv/UVezgZrFa6fmeg8B9P3m4rf3Nr6tRymtJdNuGIEto bmxQ==; dara=google.com ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@redhat.com header.s=mimecast20190719 header.b=RLMNm7ID; arc=pass (i=1 spf=pass spfdomain=redhat.com dkim=pass dkdomain=redhat.com dmarc=pass fromdomain=redhat.com); spf=pass (google.com: domain of linux-kernel+bounces-117200-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:40f1:3f00::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-117200-linux.lists.archive=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=redhat.com Return-Path: Received: from sy.mirrors.kernel.org (sy.mirrors.kernel.org. [2604:1380:40f1:3f00::1]) by mx.google.com with ESMTPS id kb18-20020a17090ae7d200b0029b7a3cebf8si530444pjb.159.2024.03.25.15.56.43 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 25 Mar 2024 15:56:44 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel+bounces-117200-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:40f1:3f00::1 as permitted sender) client-ip=2604:1380:40f1:3f00::1; Authentication-Results: mx.google.com; dkim=pass header.i=@redhat.com header.s=mimecast20190719 header.b=RLMNm7ID; arc=pass (i=1 spf=pass spfdomain=redhat.com dkim=pass dkdomain=redhat.com dmarc=pass fromdomain=redhat.com); spf=pass (google.com: domain of linux-kernel+bounces-117200-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:40f1:3f00::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-117200-linux.lists.archive=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=redhat.com Received: from smtp.subspace.kernel.org (wormhole.subspace.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by sy.mirrors.kernel.org (Postfix) with ESMTPS id CD2DAC44AF0 for ; Mon, 25 Mar 2024 16:13:38 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 3BB721448F2; Mon, 25 Mar 2024 14:05:08 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (1024-bit key) header.d=redhat.com header.i=@redhat.com header.b="RLMNm7ID" Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.129.124]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id C035F1EF1D for ; Mon, 25 Mar 2024 14:05:05 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=170.10.129.124 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1711375507; cv=none; b=Kd/Jtiu5UdL53k/oDwNiByeWPQd7/NKjRV8T6l2xXN9eLuT/f8ujhKQEOlrorLb7zzgix98kN5OuT/o8NGWEtp+msw6UZxCglKOgl/e4cRGV4LN+/mccrUWeg8ZYfTW/8ry0H6xDSdsqHrwuF4xF59fUS4x0Hp1n4ZNKkLC9VIk= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1711375507; c=relaxed/simple; bh=QY6O2xLUxfGQB/5gXD3YV6ycQUMZeJ/XQzIHsKm7khI=; h=Message-ID:Date:MIME-Version:Subject:To:Cc:References:From: In-Reply-To:Content-Type; b=XjdUfOv/uymnpdIFFWCqM4cqjKOON40Wb8duT34gtohJwMPFZLs3EcTmNCBLAAA51vBSSbGe1P+HTPe9a/FEpSqmqYVVW54I5MVAs7OxroYUpLLpacX5NDSehRYI0FlmTAcAADsfU/f+wlNP5gF/vYvpPVOVvTLfp8sZyuaKqoo= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=redhat.com; spf=pass smtp.mailfrom=redhat.com; dkim=pass (1024-bit key) header.d=redhat.com header.i=@redhat.com header.b=RLMNm7ID; arc=none smtp.client-ip=170.10.129.124 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=redhat.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=redhat.com DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1711375504; h=from:from: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:autocrypt:autocrypt; bh=+nYy7tLv6zdEfSJ2dkzNYv8VHoAv3J8y+eYNA6CJIJc=; b=RLMNm7IDffUZBuKQAKFMDfPBYrB0oltfeP+TPVLo/htzt/6k82r1X9+GBupRRD5ktct2Vc UiJKZkBgJeDePrF47ig33U51QAbjCZ/Q39yAnexqXQ/2yN18yEl0UYGhP0o2PKiP0B0ZWO e0fLN/9NXui+9lFqkIF+4K9c1jl8LkY= Received: from mail-lj1-f197.google.com (mail-lj1-f197.google.com [209.85.208.197]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-499-BWBr9cXfPzaY-UzxqPHGBQ-1; Mon, 25 Mar 2024 10:05:03 -0400 X-MC-Unique: BWBr9cXfPzaY-UzxqPHGBQ-1 Received: by mail-lj1-f197.google.com with SMTP id 38308e7fff4ca-2d48517c975so33397721fa.2 for ; Mon, 25 Mar 2024 07:05:02 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1711375501; x=1711980301; h=content-transfer-encoding:in-reply-to:organization:autocrypt:from :references:cc:to:content-language:subject:user-agent:mime-version :date:message-id:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=+nYy7tLv6zdEfSJ2dkzNYv8VHoAv3J8y+eYNA6CJIJc=; b=os4l2s3RlrquYdlaOM3kx2FBDpgtGJEkvQFOv5sghIUs4iKnsJipH/Jc+NBUcXdQK9 4jj2PdgEfC4ZGOeWpkMzasZWJzNEOffTQyrven5F22/iiMVyGepL3IpuMrKoQmZ9ELqF pdcwMTw9RLhavOLIah4Q/JAYqiJURrE3ubQRo1N+vtzWkL2U3V9S238aJbGdC4dhxNRx igNtyoR2afs4wZfS/qTnKGdIrVAbd+CLmsDs5z1JkkpidT4lHt/QeqeUlJxWiihH8eMk D4u/DXJLoXUSohw7xXmVz326enav7C1P64jbQi8pvWrAPSQRn56g7zZcjj37gdzKVlSx Vo3g== X-Gm-Message-State: AOJu0YyZziyuDJ3kC3PzKKckIj18pJBzBAzlevSZGuAViGtC0KUwrmit jNgSNu4dkemJ5Z/ac1RwwSSk3vzn3DzMH7sEOc0c7WvYPGiVfB2fY0gpqCaK/H+6VH8i8Nvk14a pWiGitjPOeJcoDjDzsGdYLKvPA/ilUNAcJizZceuRfEMgBMC/h8vRPTQhvBcmlQ== X-Received: by 2002:ac2:5f85:0:b0:513:c28e:8215 with SMTP id r5-20020ac25f85000000b00513c28e8215mr4161556lfe.64.1711375501578; Mon, 25 Mar 2024 07:05:01 -0700 (PDT) X-Received: by 2002:ac2:5f85:0:b0:513:c28e:8215 with SMTP id r5-20020ac25f85000000b00513c28e8215mr4161524lfe.64.1711375501162; Mon, 25 Mar 2024 07:05:01 -0700 (PDT) Received: from ?IPV6:2003:cb:c738:b400:6a82:1eac:2b5:8fca? (p200300cbc738b4006a821eac02b58fca.dip0.t-ipconnect.de. [2003:cb:c738:b400:6a82:1eac:2b5:8fca]) by smtp.gmail.com with ESMTPSA id ck8-20020a5d5e88000000b00341ba91c1f5sm8375997wrb.102.2024.03.25.07.05.00 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Mon, 25 Mar 2024 07:05:00 -0700 (PDT) Message-ID: <30e9e4da-334e-4e48-a716-5edc2f2c0c21@redhat.com> Date: Mon, 25 Mar 2024 15:05:00 +0100 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 User-Agent: Mozilla Thunderbird Subject: Re: [PATCH] huge_memory.c: document huge page splitting rules more thoroughly Content-Language: en-US To: John Hubbard , Andrew Morton Cc: LKML , linux-mm@kvack.org, Matthew Wilcox , Zi Yan References: <20240325044452.217463-1-jhubbard@nvidia.com> From: David Hildenbrand Autocrypt: addr=david@redhat.com; keydata= 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 WNyWQQ== Organization: Red Hat In-Reply-To: <20240325044452.217463-1-jhubbard@nvidia.com> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit On 25.03.24 05:44, John Hubbard wrote: > 1. Add information about the behavior of huge page splitting, with > respect to page/folio refcounts, and gup/pup pins. > > 2. Update and clarify the existing documentation, to compensate for the > ravages of time and code change. > > Cc: David Hildenbrand > Cc: Matthew Wilcox > Cc: Zi Yan > > Signed-off-by: John Hubbard > --- Thanks! Reviewed-by: David Hildenbrand -- Cheers, David / dhildenb