Received: by 2002:a25:1985:0:0:0:0:0 with SMTP id 127csp337839ybz; Tue, 21 Apr 2020 09:58:16 -0700 (PDT) X-Google-Smtp-Source: APiQypJVaO4KwW3oORS1HDeGn+CC+TlsYfsf+OnaXB0HhZh7GgPE7X4A648iymN+mY/4IAHmMYnT X-Received: by 2002:a17:906:3443:: with SMTP id d3mr22947362ejb.18.1587488296423; Tue, 21 Apr 2020 09:58:16 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1587488296; cv=none; d=google.com; s=arc-20160816; b=u6iSbFoVZ84Uq9S82OqCbuKcWPIcF1gXQ/a2/R8C+sRPCnU9tqSjq3y02wZWQj6cx3 3S2YsY2fIoBXttM+PAat0SV1wTEqoHv7G2guC6dg2dCRsJ+0dEzClt00tEqth0GXQzgZ 9SpRZgyq9VIFrTi+6LzJwcGz7U7+LNFjqQ/VdQrmsWeQ5q8wBShS5nRPauZom5JYT2Sz BxBxZq9T4h3snRmbkXIZ2SH9pnymkYPNuP/YOZ1/b707Tmp7I5F3+VbtJ6s7OEymwxTy qJAXIz0sWeIpZdaaSq9tp84UFZ0RwIR00TUURSEaNbcSJx5JjfOryecHZkjK10X63T2M NQrg== 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=SOrFW0fCav0oBoDHbpZCeb32w+/YWITwf8I2YHVp6Yk=; b=gzMEl8uWJKbjwc7c4ZlWYQESmlWfoOlhdypJRuCH2XwX53gQLyiXm656ByW4WkI8FZ ts7djpC7O712nBmwPzCq5oFDCxq7Mu/P+686XOwD3eil5LhBrbZoHJmWyZA2CJgoCBZD oaN5q2e5TTahEEitSmPilyogQ1n811gx56lY19S/L1CErbUazoyIBFd38gFzurZp83b/ PxWO0Bjiw8xu8hjdCXI5M+sr4WcPDb2mho4hf0twzOMLMCzSacxRzO9Mcxh7y5kkIh9a 4OqrJ6GplEyIcPwt1QRMQfaTv6srFRLPj27OmOHnSH85D11t08/Ce2wFXxHw0EqqoiXc Ry4Q== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@kernel.org header.s=default header.b=O5xMph39; 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 p10si1953617edq.609.2020.04.21.09.57.52; Tue, 21 Apr 2020 09:58:16 -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=O5xMph39; 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 S1729482AbgDUQ4I (ORCPT + 99 others); Tue, 21 Apr 2020 12:56:08 -0400 Received: from mail.kernel.org ([198.145.29.99]:57318 "EHLO mail.kernel.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1729107AbgDUQyr (ORCPT ); Tue, 21 Apr 2020 12:54:47 -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 5C5EB20784; Tue, 21 Apr 2020 16:54:44 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1587488084; bh=kp5nplx63fBCtRMlxFYjJTVu+BQYNBrjo167uQPR67o=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=O5xMph39ozROnyaGTCDuAG1E0IEn6+Fz6S0LSXkq5WdjrAgUD5JEcBi1BZA+WiMJc lNoRH3KDsZxHBXZUTCEZB5jGvGrw4SmrJX2Sl0A31ED9zKmzd/O6HU5ooOJNRsFstx 4yAGUkMDl8PQdayaG9oWVOcMcBlMx3lwYDxfq9v8= Received: from mchehab by mail.kernel.org with local (Exim 4.92.3) (envelope-from ) id 1jQwAU-00CmEb-Iq; Tue, 21 Apr 2020 18:54:42 +0200 From: Mauro Carvalho Chehab To: Linux Doc Mailing List Cc: Mauro Carvalho Chehab , linux-kernel@vger.kernel.org, Jonathan Corbet Subject: [PATCH v2 16/29] docs: filesystems: convert locks.txt to ReST Date: Tue, 21 Apr 2020 18:54:27 +0200 Message-Id: <5af169bc55394e88adaf46b149ddcf43817fb8bd.1587487612.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 844e8065ac82..96190e268c11 100644 --- a/Documentation/filesystems/index.rst +++ b/Documentation/filesystems/index.rst @@ -28,6 +28,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