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 X-Spam-Level: X-Spam-Status: No, score=-5.3 required=3.0 tests=DKIM_SIGNED,DKIM_VALID, HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI,SIGNED_OFF_BY,SPF_HELO_NONE, SPF_PASS,USER_AGENT_SANE_1 autolearn=unavailable autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 65A54C43215 for ; Tue, 19 Nov 2019 16:20:03 +0000 (UTC) Received: from kanga.kvack.org (kanga.kvack.org [205.233.56.17]) by mail.kernel.org (Postfix) with ESMTP id 1329A22362 for ; Tue, 19 Nov 2019 16:20:03 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=pass (2048-bit key) header.d=cmpxchg-org.20150623.gappssmtp.com header.i=@cmpxchg-org.20150623.gappssmtp.com header.b="z9ODofZL" DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org 1329A22362 Authentication-Results: mail.kernel.org; dmarc=fail (p=none dis=none) header.from=cmpxchg.org Authentication-Results: mail.kernel.org; spf=pass smtp.mailfrom=owner-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix) id AE1FC6B0003; Tue, 19 Nov 2019 11:20:02 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id A926B6B0006; Tue, 19 Nov 2019 11:20:02 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 9A82D6B0007; Tue, 19 Nov 2019 11:20:02 -0500 (EST) X-Delivered-To: linux-mm@kvack.org Received: from forelay.hostedemail.com (smtprelay0035.hostedemail.com [216.40.44.35]) by kanga.kvack.org (Postfix) with ESMTP id 861566B0003 for ; Tue, 19 Nov 2019 11:20:02 -0500 (EST) Received: from smtpin22.hostedemail.com (10.5.19.251.rfc1918.com [10.5.19.251]) by forelay02.hostedemail.com (Postfix) with SMTP id 1FF9B584D for ; Tue, 19 Nov 2019 16:20:02 +0000 (UTC) X-FDA: 76173538644.22.nerve47_3a66686475606 X-HE-Tag: nerve47_3a66686475606 X-Filterd-Recvd-Size: 6067 Received: from mail-qk1-f196.google.com (mail-qk1-f196.google.com [209.85.222.196]) by imf45.hostedemail.com (Postfix) with ESMTP for ; Tue, 19 Nov 2019 16:20:01 +0000 (UTC) Received: by mail-qk1-f196.google.com with SMTP id z16so18321760qkg.7 for ; Tue, 19 Nov 2019 08:20:00 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=cmpxchg-org.20150623.gappssmtp.com; s=20150623; h=date:from:to:cc:subject:message-id:references:mime-version :content-disposition:in-reply-to:user-agent; bh=P9Nm0dmtDONqzZOiG8f0kC+bAXI7b+Ydc24QnuYX/wc=; b=z9ODofZLwVJ5kMknpHKRESiJDZBNi3Pyza7Lc9GUeJNHofrQ86wibU3eFnsO2CVIu+ IfAgM62vq+764hz0qZ7RurgWgkiidhrvNyqW6ve6XTcrt1pa0T+IBaQFh6GvVNqcIXBF Ufy2rTPODX34yXNizSAi3WtQarGWeLPCoeXXJKP8I0Cb0CRRWpEy9NOqkoaP9VmwY9h1 cD8j9AgPTXAvnN73paddQAX1/NUY7TjJhO4MrEwcGMLbJNfqlaFEN76hxgxI1sUPxUoF rpTdJBr0sBkYiM5s7RkzXWL86X/Ms+STXj4E4DantEgdps6LghwvRYO6bCdspBkQ3lot zPnQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:date:from:to:cc:subject:message-id:references :mime-version:content-disposition:in-reply-to:user-agent; bh=P9Nm0dmtDONqzZOiG8f0kC+bAXI7b+Ydc24QnuYX/wc=; b=Fle2U9opcNysueYxAKxmj2KZ78eXeUoeSd7CeLmhN3IURzJlYuFx1njQIB4+Vz4q3v BMXZTzVTs30u51JufRyYWWsD3ZlmMTuXq5SGMBH3C0VXRm7OBdvcTBvzFYf8k1ESWk2/ jXAtDXgLonrone2Z5vAapfXcn3WmAKCPdHvWsVZKbA1Pe7ec6RHsQ6yuVe2ln/4g+1rJ ktvVp7LtUmsCWcRShVV8R6Zw002OSvcjcDdUmOa7Zr+vEkl0fwHBvXNKUL6+/19sCwRx M2HdxHwejngHAiDwmCfASBoi//Kxh80vrxfvvkdauqARJVlcEGPmdsH3Azw4CAR5S6ZE Vp7Q== X-Gm-Message-State: APjAAAUUVH6NAl77su7VYCSZuBO7uH0V/K+P0JQv1GUUISh9k7T0iUi6 VZ4UenQh4beyd+QSibSh2sGlvQ== X-Google-Smtp-Source: APXvYqwl+S9iMasVSXI1muFO2L+Fzgo4inTTJLcO5OXE6vDvUnuWsZ5UkRMSK4/30PNMVIetjQqjxw== X-Received: by 2002:a05:620a:226:: with SMTP id u6mr29793788qkm.393.1574180400357; Tue, 19 Nov 2019 08:20:00 -0800 (PST) Received: from localhost ([2620:10d:c091:500::c7ac]) by smtp.gmail.com with ESMTPSA id a7sm10253897qka.136.2019.11.19.08.19.59 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 19 Nov 2019 08:19:59 -0800 (PST) Date: Tue, 19 Nov 2019 11:19:58 -0500 From: Johannes Weiner To: Alex Shi Cc: cgroups@vger.kernel.org, linux-kernel@vger.kernel.org, linux-mm@kvack.org, akpm@linux-foundation.org, mgorman@techsingularity.net, tj@kernel.org, hughd@google.com, khlebnikov@yandex-team.ru, daniel.m.jordan@oracle.com, yang.shi@linux.alibaba.com, willy@infradead.org, shakeelb@google.com, Jason Gunthorpe , Dan Williams , Vlastimil Babka , Ira Weiny , Jesper Dangaard Brouer , Andrey Ryabinin , Jann Horn , Logan Gunthorpe , Souptick Joarder , Ralph Campbell , "Tobin C. Harding" , Michal Hocko , Oscar Salvador , Wei Yang , Arun KS , "Darrick J. Wong" , Amir Goldstein , Dave Chinner , Josef Bacik , "Kirill A. Shutemov" , =?iso-8859-1?B?Suly9G1l?= Glisse , Mike Kravetz , Kirill Tkhai , Yafang Shao Subject: Re: [PATCH v4 9/9] mm/lru: revise the comments of lru_lock Message-ID: <20191119161958.GE382712@cmpxchg.org> References: <1574166203-151975-1-git-send-email-alex.shi@linux.alibaba.com> <1574166203-151975-10-git-send-email-alex.shi@linux.alibaba.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <1574166203-151975-10-git-send-email-alex.shi@linux.alibaba.com> User-Agent: Mutt/1.12.2 (2019-09-21) 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: On Tue, Nov 19, 2019 at 08:23:23PM +0800, Alex Shi wrote: > Since we changed the pgdat->lru_lock to lruvec->lru_lock, it's time to > fix the incorrect comments in code. Also fixed some zone->lru_lock comment > error from ancient time. etc. > > Originally-from: Hugh Dickins You can resubmit a patch written by somebody else, but you need to preserve authorship such that git can attribute it properly: From: Hugh Dickins in the patch header, as well as Signed-off-by: Hugh Dickins in the changelog tags. It should look something like this: --- From: Hugh Dickins Subject: [PATCH] mm/memcg: update lru_lock Doc and comments Update scattered references from "zone_lru_lock" to "lruvec->lru_lock" (in low-level descriptions) or "lruvec lock" (where that reads better). In the course of doing so, update lock ordering comments in mm/rmap.c and mm/filemap.c and Documentation/cgroups/memory.txt - slightly, with no attempt to be complete (swap_lock, in particular, left out-of-date). Remove allusions to set_page_dirty under page_remove_rmap: gone in v3.9. memcg_test.txt looks quite out-of-date: just give LRU a short paragraph. Replaced zone by node throughout unevictable-lru.txt (except for stats). Leave Documentation/locking/lockstat.txt untouched this time: it doesn't matter if that still refers to zone->lru_lock, along with other history. I struggled to understand the comment above move_pages_to_lru() (surely it never calls page_referenced()), and eventually realized that most of it had got separated from shrink_active_list(): move that comment back. Signed-off-by: Hugh Dickins Signed-off-by: Alex Shi ---