From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-pg1-f201.google.com (mail-pg1-f201.google.com [209.85.215.201]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 4A9D82EB5A6 for ; Tue, 12 May 2026 20:32:19 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.215.201 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1778617940; cv=none; b=BIyF8/ubNi3aubvepxBZocfLV35RbJy336MsSaDxniaK/lOiAwrqdyCvUB9iZ5WkR9DHSPFwO+rX9hRjCYktQGCDPf7CSf/OavFNQ0xOmSAl5ojd+sfQ9Ut2kbTzLTCuvkCDaZXaxxetEIKVODULQqF9czV2WFiG2DWQcItMbpo= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1778617940; c=relaxed/simple; bh=cbmkt9pZZr54kIHHjaESeO29ZT3m2Envrn5GyloGMiQ=; h=Date:Mime-Version:Message-ID:Subject:From:Cc:Content-Type; b=jbEj9sgMkvDEKxjGo5g3yCFy6C7tW9YFMl1lZ2hIJY3lzZNqgYZHbVkLHwIHtIRo3yX6OTqReoT+ZXkJ/JZJJBUaHeY2EkAHfAP4UetuClBaoomFebYY/bPe5XOQAJeB376WcLdZjiTp/VNsh770tYFRUWEK5C0sUCRcoqf6M4Y= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=google.com; spf=pass smtp.mailfrom=flex--fmayle.bounces.google.com; dkim=pass (2048-bit key) header.d=google.com header.i=@google.com header.b=oUG1ePpW; arc=none smtp.client-ip=209.85.215.201 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=google.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=flex--fmayle.bounces.google.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=google.com header.i=@google.com header.b="oUG1ePpW" Received: by mail-pg1-f201.google.com with SMTP id 41be03b00d2f7-c82ac893940so209899a12.1 for ; Tue, 12 May 2026 13:32:19 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20251104; t=1778617938; x=1779222738; darn=vger.kernel.org; h=cc:from:subject:message-id:mime-version:date:from:to:cc:subject :date:message-id:reply-to; bh=ZFtakTJB5Vs+VUIE17YL6aA+lS3I+iyXqjPjtCVuM/s=; b=oUG1ePpWZyIoxkUSjIElarYfWQTx/zHjVt7wv2XsuBaMTQo5lWAlU6oPh7+Xg7yNiS eDSoNLcp2FxZZCzN5I/LewRGVYY1jz4LzysMFM4ZDQsijA8VkLFVQX/Sl7TmT3XfXZYU lqzkSDPmy9ZeU/fI4OKAlz70CLkOQs4pIyNu+RdYxuiK6MaJuE6nbQhQPkVmMs8wdD/7 4mz30zXN6Rq8Fv7HZ6YidmMnaAlGqveiqa5bTtoY4BwLLzcmKA2gd4sY45DncAC8Bw07 GSthe8dpkkrB/P8gu+L/lG7cNiM5CSnLWACq8No84jPkYixeyu7vIHFo9RfC/qjcEDff ytTQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1778617938; x=1779222738; h=cc:from:subject:message-id:mime-version:date:x-gm-message-state :from:to:cc:subject:date:message-id:reply-to; bh=ZFtakTJB5Vs+VUIE17YL6aA+lS3I+iyXqjPjtCVuM/s=; b=V8FYXN1an67qDCKcUIE4krtHOc53Isfz1XsmU0k7O12Hrqh0sNE5LgG/9NxOHMuYmO KbzawcTFkTostuAMhr/jBwIfTrGToPTQTe4F1ZtcB11CQGcoRza/2Pg23DZU6qqt6k8J kpO3/+bfOm/2GeCN89kyGDnWFXoUf51XBdDHaYVhlw76h9jjbPjT5QMj3altiiPjBZyJ Sb3Xp9v4O8BWfYeOBqC7Az2Ita0MligeWttqrIYcgKhDlWsTODnhYtRAFCPTJe9tDBAg +JicVrQ1u3k6/4sJ6/8Dchh1g/wenlDguYbDZB0By5ns7U+e9xwAVrdewzgeBwbo0r8e GRKQ== X-Forwarded-Encrypted: i=1; AFNElJ9IgZ8EFwNC6nju82kwvh20M/0ya1k+vDB53TwuZYNEA64pJxs9YhP0rVwWra/lYV3z8/KLElxoAzeyutc=@vger.kernel.org X-Gm-Message-State: AOJu0YyB77GFNg+aK3hrYs583IxwgYiBg2MGCNujDcpJZTTkCF/meKro K/rHMffLo+A6oEaeQDEZ6W0HyzWMeV/ock69/MMeeTUmPdlANTbPloEt6HfGc7UXEh2tdQYf5Gm Bb4ROtA== X-Received: from pjxx6.prod.google.com ([2002:a17:90b:58c6:b0:366:191:7105]) (user=fmayle job=prod-delivery.src-stubby-dispatcher) by 2002:a17:90b:4c02:b0:35d:a38a:a117 with SMTP id 98e67ed59e1d1-368f3e6ffabmr627464a91.15.1778617938317; Tue, 12 May 2026 13:32:18 -0700 (PDT) Date: Tue, 12 May 2026 13:31:34 -0700 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: Mime-Version: 1.0 X-Mailer: git-send-email 2.54.0.563.g4f69b47b94-goog Message-ID: <20260512203154.754075-1-fmayle@google.com> Subject: [PATCH 0/2] mm: document read_pages and simplify usage From: Frederick Mayle Cc: android-mm@google.com, kernel-team@android.com, Frederick Mayle , "Matthew Wilcox (Oracle)" , Jan Kara , Andrew Morton , linux-fsdevel@vger.kernel.org, linux-mm@kvack.org, linux-kernel@vger.kernel.org Content-Type: text/plain; charset="UTF-8" Add a kerneldoc for read_pages() to formalize an invariant and then use it to simplify the callers in page_cache_ra_unbounded(). Frederick Mayle (2): mm/readahead: add kerneldoc for read_pages mm/readahead: simplify page_cache_ra_unbounded loop counter reset mm/readahead.c | 15 +++++++++++++-- 1 file changed, 13 insertions(+), 2 deletions(-) base-commit: 972c53e0ec3abfc6f5fe2cb503640710fb23cf95 -- 2.54.0.563.g4f69b47b94-goog