Received: by 2002:a25:1985:0:0:0:0:0 with SMTP id 127csp707335ybz; Wed, 15 Apr 2020 17:10:19 -0700 (PDT) X-Google-Smtp-Source: APiQypLDJuh1AeijF30gGZrrNe+4HbSWJzGD4iJyH95TUfU3GbJ2zqLUnZm2LV4K3ZTX3Hb5cok8 X-Received: by 2002:aa7:c5cf:: with SMTP id h15mr8086738eds.213.1586995819241; Wed, 15 Apr 2020 17:10:19 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1586995819; cv=none; d=google.com; s=arc-20160816; b=YfHHBf2QHw8MkOvkPe0HaFhJ5IIifjGrcKYgj6mMLx/judPTfU4UMC5/VqC4nOcNCS Za06Fkr52FllqeGtkfuY3D79fySkD0r780udDAJkfdCWLNuSN8SuCLM7UhMIg49CprbK e7AAn0t3/hTdF78QnX/yCMsDjsMr+bbVe0A1cYdadVUzbSTUsjFRrud0EbFC8NugmwVG xAsIH5wl8+zdH8fBF6KW/FdlIDBS7JjKFGP1KcHx9sdv/de7yAETYpestM6u0KT6t58y VLu37v6bD7oxxFUk0QphLqTiRQjYDPVI80ubHN1Xhxjg500AQx/+s8PBnT4vdCbuvJiY 5dgA== 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=m19PNm4fPwyQFu3E4xsK2yEoaN1B8qJoAerYUN56V0c=; b=HgufkOwq2OQCZoNDid/72IJWUCEUCB9Rwxoiois1gt/tc0oJX+krdSHkSgHxMYjcY2 PgxFwmpRV4amEfCZJytQjDFrnuC5H14XrM88xDvEvNL5soG/1Vm1ZcQnCYEFy6YJW6DN Yi75fTTFe8kumPDT219qKu6WRsWUHeGccmRQFtjh7pXfAARDtx6d/AeVbOKgjTeO1tMa MHYMydUWc5eAKzY8+d97jc/KnDCFXb3rC/eyLxwmyp8eLqIHra4LfkLjsh4C4IEKDixC wFGSNeygxK6SH/zSE7y9PNBaIEpgEqwfm/+fHV7btFkrQlmg2L0EYdJpOJNeDwiNo1Zw 4KHg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@kernel.org header.s=default header.b=Ft7S8nX6; 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 x24si1504332edr.432.2020.04.15.17.09.56; Wed, 15 Apr 2020 17:10:19 -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=default header.b=Ft7S8nX6; 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 S370852AbgDOOk5 (ORCPT + 99 others); Wed, 15 Apr 2020 10:40:57 -0400 Received: from mail.kernel.org ([198.145.29.99]:45584 "EHLO mail.kernel.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S2394052AbgDOOc7 (ORCPT ); Wed, 15 Apr 2020 10:32:59 -0400 Received: from mail.kernel.org (ip5f5ad4d8.dynamic.kabel-deutschland.de [95.90.212.216]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPSA id 628F62192A; Wed, 15 Apr 2020 14:32:51 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1586961171; bh=+igjvRxpuDNk+ImNBCy+AlqzVmAqV4enYJJws75GPmk=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=Ft7S8nX6e3UDcYwZx2JhFoYsguOls5IwwZzQdZbY5iKsuQRVpi+cA+durJS9XO1ia el9QM56SEGU+vdFfkaBDroUO4xznr/D2yXiUERN+WzphcbQY7OsHY/rRsVnva1BGlA pV6LwtB9kQlNtbj+Q1WUqwTHMDmrdp7CUXFTVN74= Received: from mchehab by mail.kernel.org with local (Exim 4.92.3) (envelope-from ) id 1jOj5t-006kPC-M8; Wed, 15 Apr 2020 16:32:49 +0200 From: Mauro Carvalho Chehab To: Linux Doc Mailing List Cc: Mauro Carvalho Chehab , linux-kernel@vger.kernel.org, Jonathan Corbet Subject: [PATCH 19/34] docs: filesystems: convert locks.txt to ReST Date: Wed, 15 Apr 2020 16:32:32 +0200 Message-Id: <848106d373e9175ab29537f6c85f2b13e664f65a.1586960617.git.mchehab+huawei@kernel.org> X-Mailer: git-send-email 2.25.2 In-Reply-To: References: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org - Add a SPDX header; - Adjust document and section titles; - Add it to filesystems/index.rst. Signed-off-by: Mauro Carvalho Chehab --- Documentation/filesystems/index.rst | 1 + Documentation/filesystems/{locks.txt => locks.rst} | 12 ++++++++---- 2 files changed, 9 insertions(+), 4 deletions(-) rename Documentation/filesystems/{locks.txt => locks.rst} (93%) diff --git a/Documentation/filesystems/index.rst b/Documentation/filesystems/index.rst index 6a34d1b578a9..40cdc4ce2ffc 100644 --- a/Documentation/filesystems/index.rst +++ b/Documentation/filesystems/index.rst @@ -29,6 +29,7 @@ algorithms work. dnotify fiemap files + locks automount-support diff --git a/Documentation/filesystems/locks.txt b/Documentation/filesystems/locks.rst similarity index 93% rename from Documentation/filesystems/locks.txt rename to Documentation/filesystems/locks.rst index 5368690f412e..10f67fb9ce07 100644 --- a/Documentation/filesystems/locks.txt +++ b/Documentation/filesystems/locks.rst @@ -1,4 +1,8 @@ - File Locking Release Notes +.. SPDX-License-Identifier: GPL-2.0 + +========================== +File Locking Release Notes +========================== Andy Walker @@ -6,7 +10,7 @@ 1. What's New? --------------- +============== 1.1 Broken Flock Emulation -------------------------- @@ -25,7 +29,7 @@ anyway (see the file "Documentation/process/changes.rst".) --------------------------- 1.2.1 Typical Problems - Sendmail ---------------------------------- +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Because sendmail was unable to use the old flock() emulation, many sendmail installations use fcntl() instead of flock(). This is true of Slackware 3.0 for example. This gave rise to some other subtle problems if sendmail was @@ -37,7 +41,7 @@ to lock solid with deadlocked processes. 1.2.2 The Solution ------------------- +^^^^^^^^^^^^^^^^^^ The solution I have chosen, after much experimentation and discussion, is to make flock() and fcntl() locks oblivious to each other. Both can exists, and neither will have any effect on the other. -- 2.25.2