Received: by 2002:a05:6a10:5bc5:0:0:0:0 with SMTP id os5csp217136pxb; Tue, 19 Oct 2021 01:06:58 -0700 (PDT) X-Google-Smtp-Source: ABdhPJxGCzKhHG1gIZwqjoD/1gupRKikdVp3j/4nsf858cyJYiL7jLiOHpxEHODSUbfFO6OnzuGc X-Received: by 2002:a62:27c7:0:b0:44d:b86:54f2 with SMTP id n190-20020a6227c7000000b0044d0b8654f2mr34025199pfn.68.1634630818074; Tue, 19 Oct 2021 01:06:58 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1634630818; cv=none; d=google.com; s=arc-20160816; b=AL6vdRnvR3LnnpV2/XjKW9PXTX71FiOVEV7oj9yQPFDWgsJOSDwpVGKE9nVKoYihgX Iye6EA2i82n3DcTKbjw5PvXad9ytfrgPAVimt0zzuyIUovMcPHPlBcaaLlALfMQhaNdN zGI4RcZFFYDHshHz1NEQSwwAVTK08jyeTI7jpDJ5JpgvDuwl1CFu89Q1rstTfJ9Jr1Vt IzubClqjC83qFEOaz+C8z4igDHO5+GNn8JDaKZTQlkIIz4JpKI0bFgvvJcq5NtvCjAZQ AAchmWuyR4kQ2DpPCKMsLCBXDLMHLzhM49wqsrPyc7CTPO2XLDjtojs3zXRfzncvqI7m gJ/g== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=PY4EDcAgucVZL6+64fQqARcydqvVgrQbfRh/8VMArx8=; b=QH7BB5d3zKnRs9Zgi3D9J1XxDNIIM2BO5kkHCJBgUWh9nvDVYhz7471+w1aAYBwzVK SOH+RgpPavPrnHqKqk1f4teroSvC7iOfivu2HoSjU7bZkH1P+rvF3wumXWI6rzoauFVO iy78D6n6+hawfmskXue/YLaFpor8bxbjiaTWWUeITnV+CPSQi3PlT2popr0mWzbLVezU /xvRVEYmDnXhgR5fFBujAOiCJrKwybBEE417mnzKXDGzv2sZjT30BXZOcmVjIf+T2I06 V3uoYP9hCV0/Gq7WJfCeKyLjVZEDPOFzq+eDt1QtBnBZJNFGoPib9VGEVP5t+jEyTrFy +5ig== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b="J9B/TDwT"; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id f13si23412285pln.393.2021.10.19.01.06.45; Tue, 19 Oct 2021 01:06:58 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18; Authentication-Results: mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b="J9B/TDwT"; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S235092AbhJSIHs (ORCPT + 99 others); Tue, 19 Oct 2021 04:07:48 -0400 Received: from mail.kernel.org ([198.145.29.99]:36568 "EHLO mail.kernel.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S234772AbhJSIGp (ORCPT ); Tue, 19 Oct 2021 04:06:45 -0400 Received: by mail.kernel.org (Postfix) with ESMTPSA id 492F0613A4; Tue, 19 Oct 2021 08:04:32 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1634630672; bh=OLQmIGIa96dqOjXdQ2IruQsJW6tAzqr/YAsyfqvgLa0=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=J9B/TDwT0Qn7yEcTUBhZ5Fe4yT/XY+9+QmBYjYdHYbeHdN4CABZUaFuN+KJSALreT 6LFpfAlinMeakg9tauHg9CadEOKSTc+heswFTGosVoGCEfPDcKIADR/cDi5aYA+Juo AS+4ymTXSzuFySdSs7vnpb+m2f18HgqCSkOOAzalv1rtLMAKKclV54T6h0uljBAl6x yICttUVdmkQp26JVTupOTskHmN1Eup/iBUNO+/iTN/XXWlTbEy8B/7mQugKCeuH3Kh vw73hGehxs68WGBmPrkIBNsl4MlseLZZEc7UGTBfTuolbWRwdSCnJTDSFzCQJVFKhD uCVUufzAUXmIA== Received: by mail.kernel.org with local (Exim 4.94.2) (envelope-from ) id 1mck6j-001oJd-8a; Tue, 19 Oct 2021 09:04:25 +0100 From: Mauro Carvalho Chehab To: Linux Doc Mailing List , Jonathan Corbet Cc: Mauro Carvalho Chehab , Jeff Layton , linux-kernel@vger.kernel.org Subject: [PATCH v3 17/23] docs: fs: locks.rst: update comment about mandatory file locking Date: Tue, 19 Oct 2021 09:04:16 +0100 Message-Id: <1dfcade1692df5435d4f0fd8e439a6e55cf44fa6.1634630486.git.mchehab+huawei@kernel.org> X-Mailer: git-send-email 2.31.1 In-Reply-To: References: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Sender: Mauro Carvalho Chehab Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org The mandatory file locking got removed due to its problems, but the fs locks documentation still points to it. Update the text there, informing that it was removed on Kernel 5.14. Fixes: f7e33bdbd6d1 ("fs: remove mandatory file locking support") Signed-off-by: Mauro Carvalho Chehab --- To mailbombing on a large number of people, only mailing lists were C/C on the cover. See [PATCH v3 00/23] at: https://lore.kernel.org/all/cover.1634630485.git.mchehab+huawei@kernel.org/ Documentation/filesystems/locks.rst | 17 +++++------------ 1 file changed, 5 insertions(+), 12 deletions(-) diff --git a/Documentation/filesystems/locks.rst b/Documentation/filesystems/locks.rst index c5ae858b1aac..26429317dbbc 100644 --- a/Documentation/filesystems/locks.rst +++ b/Documentation/filesystems/locks.rst @@ -57,16 +57,9 @@ fcntl(), with all the problems that implies. 1.3 Mandatory Locking As A Mount Option --------------------------------------- -Mandatory locking, as described in -'Documentation/filesystems/mandatory-locking.rst' was prior to this release a -general configuration option that was valid for all mounted filesystems. This -had a number of inherent dangers, not the least of which was the ability to -freeze an NFS server by asking it to read a file for which a mandatory lock -existed. - -From this release of the kernel, mandatory locking can be turned on and off -on a per-filesystem basis, using the mount options 'mand' and 'nomand'. -The default is to disallow mandatory locking. The intention is that -mandatory locking only be enabled on a local filesystem as the specific need -arises. +Mandatory locking was prior to this release a general configuration option +that was valid for all mounted filesystems. This had a number of inherent +dangers, not the least of which was the ability to freeze an NFS server by +asking it to read a file for which a mandatory lock existed. +Such option was dropped in Kernel v5.14. -- 2.31.1