From patchwork Tue May 26 06:41:59 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lukas Bulwahn X-Patchwork-Id: 11569993 Return-Path: Received: from mail.kernel.org (pdx-korg-mail-1.web.codeaurora.org [172.30.200.123]) by pdx-korg-patchwork-2.web.codeaurora.org (Postfix) with ESMTP id E127A14B7 for ; Tue, 26 May 2020 06:42:13 +0000 (UTC) Received: from kanga.kvack.org (kanga.kvack.org [205.233.56.17]) by mail.kernel.org (Postfix) with ESMTP id A41B9207D8 for ; Tue, 26 May 2020 06:42:13 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="jCm9i8vD" DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org A41B9207D8 Authentication-Results: mail.kernel.org; dmarc=fail (p=none dis=none) header.from=gmail.com Authentication-Results: mail.kernel.org; spf=pass smtp.mailfrom=owner-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix) id E082680083; Tue, 26 May 2020 02:42:12 -0400 (EDT) Delivered-To: linux-mm-outgoing@kvack.org Received: by kanga.kvack.org (Postfix, from userid 40) id DB85F80061; Tue, 26 May 2020 02:42:12 -0400 (EDT) X-Original-To: int-list-linux-mm@kvack.org X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id CCE0680083; Tue, 26 May 2020 02:42:12 -0400 (EDT) X-Original-To: linux-mm@kvack.org X-Delivered-To: linux-mm@kvack.org Received: from forelay.hostedemail.com (smtprelay0208.hostedemail.com [216.40.44.208]) by kanga.kvack.org (Postfix) with ESMTP id B409380061 for ; Tue, 26 May 2020 02:42:12 -0400 (EDT) Received: from smtpin09.hostedemail.com (10.5.19.251.rfc1918.com [10.5.19.251]) by forelay02.hostedemail.com (Postfix) with ESMTP id 76BC052AD for ; Tue, 26 May 2020 06:42:12 +0000 (UTC) X-FDA: 76857925704.09.actor21_3058d80d16d0a X-Spam-Summary: 2,0,0,b0316530c616fe46,d41d8cd98f00b204,lukas.bulwahn@gmail.com,,RULES_HIT:41:69:355:379:541:800:960:973:988:989:1260:1345:1437:1535:1542:1711:1730:1747:1777:1792:2198:2199:2393:2553:2559:2562:2901:3138:3139:3140:3141:3142:3353:3865:3867:3868:3870:3871:3874:5007:6119:6261:6653:7514:7974:8957:9413:10004:11026:11232:11658:11914:12043:12048:12291:12296:12297:12438:12517:12519:12555:12679:12895:13161:13229:14093:14096:14181:14394:14687:14721:21063:21080:21324:21325:21433:21444:21451:21627:21666:21990:30003:30054:30090,0,RBL:209.85.208.66:@gmail.com:.lbl8.mailshell.net-62.18.0.100 66.100.201.100,CacheIP:none,Bayesian:0.5,0.5,0.5,Netcheck:none,DomainCache:0,MSF:not bulk,SPF:fp,MSBL:0,DNSBL:neutral,Custom_rules:0:0:0,LFtime:23,LUA_SUMMARY:none X-HE-Tag: actor21_3058d80d16d0a X-Filterd-Recvd-Size: 5435 Received: from mail-ed1-f66.google.com (mail-ed1-f66.google.com [209.85.208.66]) by imf34.hostedemail.com (Postfix) with ESMTP for ; Tue, 26 May 2020 06:42:12 +0000 (UTC) Received: by mail-ed1-f66.google.com with SMTP id bs4so16692294edb.6 for ; Mon, 25 May 2020 23:42:12 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:date:message-id; bh=epNgORMkMUjQM1HJoGhYNDvLREi6hqAWQ+HHuUx5oQA=; b=jCm9i8vDYHxadEy85yOQF9hCW7pPngLMjzudSBP6uyic88SIOutHgLQGbPrz7tL620 PhmmRMgCrs7eS9MJfKyTJoYOBwbXaYjM1++N02ym79Cj+Yj0GPyKHHO4FGMGR+PHVREv RkV6Tg/n76oQ0euXYdAI71vv6GpyedB3bSrkevbHN6qlfAdH3/sktCn3t/ldj1N/O110 1OWUSVGBhuRaF1CwGEvPfDzA87wZ24uQrfioFirskmzNuBB35gOY09/z3pSBB1FrNm4N 2Sr+hKoYsZlS7IRPxPyD0u2EhcUEo872WGyen5o68vCUu58qbR1Wks8tk0pbOGv6V6e3 n6og== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id; bh=epNgORMkMUjQM1HJoGhYNDvLREi6hqAWQ+HHuUx5oQA=; b=Myrc1wpxxWnuFi4nC8MGhJPRaxY9KoyCWttR+J3iCrlSWNRcOj0m9WelxF20QPq5ZX 5LKbrEUT4rchXSPfG93QDE2R40Scyt3D1ZTEIAlUJaVl/7X0GCa7+z3kjT7F9J/2kycs 8wnGnolopWGtSThB5UzgZADqnO9dqmT/bt0Nb6BhQo9yM//ZcdfZDOygBxxfSfKgPFoI QW8JL8lsxQCwfi6jvA9tFSa1sw6b/8zkh7aaAJOz2igfqfIQnzwdP7Qo31Uz65wViXWd /8ZrieCEYN52GD02OExvhSb+k/uBaJQAHrklIm5R+ziLlBqo5I2jdDMAn1+uYTIKdfYN 3K9A== X-Gm-Message-State: AOAM530t9fJBJZ12Co+OIlvZGNgw4YATqp5WUPP2UqYMUym+oKD3mscO QNXXRfKxrx4Dsu5LlrxB7oQ= X-Google-Smtp-Source: ABdhPJzWVhTULfViaUSztBzQyqU1jJtBLgVZY5ewApMINBnYD59qRXLAvDSurLa2F1m7U13J1rHAuw== X-Received: by 2002:a50:9e21:: with SMTP id z30mr10115849ede.347.1590475330929; Mon, 25 May 2020 23:42:10 -0700 (PDT) Received: from felia.fritz.box ([2001:16b8:2d83:f700:a58b:70a4:9fe8:b41f]) by smtp.gmail.com with ESMTPSA id ld9sm16932149ejb.30.2020.05.25.23.42.09 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 25 May 2020 23:42:10 -0700 (PDT) From: Lukas Bulwahn To: Michel Lespinasse , Vlastimil Babka , Andrew Morton , linux-mm Cc: linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Lukas Bulwahn Subject: [PATCH] doc: filesystems: format tables in locking properly Date: Tue, 26 May 2020 08:41:59 +0200 Message-Id: <20200526064159.11361-1-lukas.bulwahn@gmail.com> X-Mailer: git-send-email 2.17.1 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: Commit 28df3d1539de ("nfsd: clients don't need to break their own delegations") introduced lm_breaker_owns_lease and documented that in the according table. Commit 43dbd0e7e62b ("mmap locking API: convert mmap_sem comments") renamed mmap_sem to mmap_lock in another table. Both changes created a table entry longer than the content before, but did not adjust the tables. Hence, make htmldocs warns about malformed tables. Adjust the tables to address the warning. Signed-off-by: Lukas Bulwahn --- Michel, Vlastimil, please ack this patch. Andrew, please pick this minor doc fix patch into your -next tree, where patch "mmap locking API: convert mmap_sem comments" has been applied. Documentation/filesystems/locking.rst | 24 ++++++++++++------------ 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/Documentation/filesystems/locking.rst b/Documentation/filesystems/locking.rst index 318605de83f3..faf7f4abd54d 100644 --- a/Documentation/filesystems/locking.rst +++ b/Documentation/filesystems/locking.rst @@ -433,15 +433,15 @@ prototypes:: locking rules: -========== ============= ================= ========= -ops inode->i_lock blocked_lock_lock may block -========== ============= ================= ========= -lm_notify: yes yes no -lm_grant: no no no -lm_break: yes no no -lm_change yes no no -lm_breaker_owns_lease: no no no -========== ============= ================= ========= +====================== ============= ================= ========= +ops inode->i_lock blocked_lock_lock may block +====================== ============= ================= ========= +lm_notify: yes yes no +lm_grant: no no no +lm_break: yes no no +lm_change yes no no +lm_breaker_owns_lease: no no no +====================== ============= ================= ========= buffer_head =========== @@ -616,9 +616,9 @@ prototypes:: locking rules: -============= ======== =========================== +============= ========= =========================== ops mmap_lock PageLocked(page) -============= ======== =========================== +============= ========= =========================== open: yes close: yes fault: yes can return with page locked @@ -626,7 +626,7 @@ map_pages: yes page_mkwrite: yes can return with page locked pfn_mkwrite: yes access: yes -============= ======== =========================== +============= ========= =========================== ->fault() is called when a previously not present pte is about to be faulted in. The filesystem must find and return the page associated