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=-13.2 required=3.0 tests=HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_PATCH,MAILING_LIST_MULTI, MENTIONS_GIT_HOSTING,SIGNED_OFF_BY,SPF_HELO_NONE,SPF_PASS,UNPARSEABLE_RELAY, 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 4553EC34031 for ; Tue, 18 Feb 2020 01:21:57 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.kernel.org (Postfix) with ESMTP id 280BD20801 for ; Tue, 18 Feb 2020 01:21:57 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1726107AbgBRBV4 (ORCPT ); Mon, 17 Feb 2020 20:21:56 -0500 Received: from out30-57.freemail.mail.aliyun.com ([115.124.30.57]:46560 "EHLO out30-57.freemail.mail.aliyun.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726070AbgBRBV4 (ORCPT ); Mon, 17 Feb 2020 20:21:56 -0500 X-Alimail-AntiSpam: AC=PASS;BC=-1|-1;BR=01201311R111e4;CH=green;DM=||false|;DS=||;FP=0|-1|-1|-1|0|-1|-1|-1;HT=e01e04426;MF=joseph.qi@linux.alibaba.com;NM=1;PH=DS;RN=7;SR=0;TI=SMTPD_---0TqC7pSS_1581988911; Received: from JosephdeMacBook-Pro.local(mailfrom:joseph.qi@linux.alibaba.com fp:SMTPD_---0TqC7pSS_1581988911) by smtp.aliyun-inc.com(127.0.0.1); Tue, 18 Feb 2020 09:21:51 +0800 Subject: Re: [PATCH 12/44] docs: filesystems: convert dlmfs.txt to ReST To: Mauro Carvalho Chehab , Linux Doc Mailing List Cc: Jonathan Corbet , linux-fsdevel@vger.kernel.org, Mark Fasheh , Joel Becker , ocfs2-devel@oss.oracle.com References: From: Joseph Qi Message-ID: <3b40d7d4-3798-08db-220d-b45704ada48a@linux.alibaba.com> Date: Tue, 18 Feb 2020 09:21:51 +0800 User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.11; rv:68.0) Gecko/20100101 Thunderbird/68.5.0 MIME-Version: 1.0 In-Reply-To: Content-Type: text/plain; charset=utf-8 Content-Language: en-US Content-Transfer-Encoding: 7bit Sender: linux-fsdevel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-fsdevel@vger.kernel.org On 20/2/18 00:11, Mauro Carvalho Chehab wrote: > - Add a SPDX header; > - Use copyright symbol; > - Adjust document title; > - Some whitespace fixes and new line breaks; > - Mark literal blocks as such; > - Add table markups; > - Add it to filesystems/index.rst. > > Signed-off-by: Mauro Carvalho Chehab > --- > .../filesystems/{dlmfs.txt => dlmfs.rst} | 28 +++++++++++++------ > Documentation/filesystems/index.rst | 1 + > 2 files changed, 20 insertions(+), 9 deletions(-) > rename Documentation/filesystems/{dlmfs.txt => dlmfs.rst} (86%) > > diff --git a/Documentation/filesystems/dlmfs.txt b/Documentation/filesystems/dlmfs.rst > similarity index 86% > rename from Documentation/filesystems/dlmfs.txt > rename to Documentation/filesystems/dlmfs.rst > index fcf4d509d118..68daaa7facf9 100644 > --- a/Documentation/filesystems/dlmfs.txt > +++ b/Documentation/filesystems/dlmfs.rst > @@ -1,20 +1,25 @@ > -dlmfs > -================== > +.. SPDX-License-Identifier: GPL-2.0 > +.. include:: > + > +===== > +DLMFS > +===== > + > A minimal DLM userspace interface implemented via a virtual file > system. > > dlmfs is built with OCFS2 as it requires most of its infrastructure. > > -Project web page: http://ocfs2.wiki.kernel.org > -Tools web page: https://github.com/markfasheh/ocfs2-tools > -OCFS2 mailing lists: http://oss.oracle.com/projects/ocfs2/mailman/ > +:Project web page: http://ocfs2.wiki.kernel.org > +:Tools web page: https://github.com/markfasheh/ocfs2-tools > +:OCFS2 mailing lists: http://oss.oracle.com/projects/ocfs2/mailman/ > > All code copyright 2005 Oracle except when otherwise noted. > > -CREDITS > +Credits > ======= > > -Some code taken from ramfs which is Copyright (C) 2000 Linus Torvalds > +Some code taken from ramfs which is Copyright |copy| 2000 Linus Torvalds > and Transmeta Corp. > > Mark Fasheh > @@ -96,14 +101,19 @@ operation. If the lock succeeds, you'll get an fd. > open(2) with O_CREAT to ensure the resource inode is created - dlmfs does > not automatically create inodes for existing lock resources. > > +============ =========================== > Open Flag Lock Request Type > ---------- ----------------- Better to remove the above line. > +============ =========================== > O_RDONLY Shared Read > O_RDWR Exclusive > +============ =========================== > > + > +============ =========================== > Open Flag Resulting Locking Behavior > ---------- -------------------------- Ditto. > +============ =========================== > O_NONBLOCK Trylock operation > +============ =========================== > > You must provide exactly one of O_RDONLY or O_RDWR. > > diff --git a/Documentation/filesystems/index.rst b/Documentation/filesystems/index.rst > index ab3b656bbe60..c6885c7ef781 100644 > --- a/Documentation/filesystems/index.rst > +++ b/Documentation/filesystems/index.rst > @@ -58,6 +58,7 @@ Documentation for filesystem implementations. > ceph > cramfs > debugfs > + dlmfs > fuse > overlayfs > virtiofs > From mboxrd@z Thu Jan 1 00:00:00 1970 From: Joseph Qi Date: Tue, 18 Feb 2020 09:21:51 +0800 Subject: [Ocfs2-devel] [PATCH 12/44] docs: filesystems: convert dlmfs.txt to ReST In-Reply-To: References: Message-ID: <3b40d7d4-3798-08db-220d-b45704ada48a@linux.alibaba.com> List-Id: MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit To: Mauro Carvalho Chehab , Linux Doc Mailing List Cc: Jonathan Corbet , linux-fsdevel@vger.kernel.org, Mark Fasheh , Joel Becker , ocfs2-devel@oss.oracle.com On 20/2/18 00:11, Mauro Carvalho Chehab wrote: > - Add a SPDX header; > - Use copyright symbol; > - Adjust document title; > - Some whitespace fixes and new line breaks; > - Mark literal blocks as such; > - Add table markups; > - Add it to filesystems/index.rst. > > Signed-off-by: Mauro Carvalho Chehab > --- > .../filesystems/{dlmfs.txt => dlmfs.rst} | 28 +++++++++++++------ > Documentation/filesystems/index.rst | 1 + > 2 files changed, 20 insertions(+), 9 deletions(-) > rename Documentation/filesystems/{dlmfs.txt => dlmfs.rst} (86%) > > diff --git a/Documentation/filesystems/dlmfs.txt b/Documentation/filesystems/dlmfs.rst > similarity index 86% > rename from Documentation/filesystems/dlmfs.txt > rename to Documentation/filesystems/dlmfs.rst > index fcf4d509d118..68daaa7facf9 100644 > --- a/Documentation/filesystems/dlmfs.txt > +++ b/Documentation/filesystems/dlmfs.rst > @@ -1,20 +1,25 @@ > -dlmfs > -================== > +.. SPDX-License-Identifier: GPL-2.0 > +.. include:: > + > +===== > +DLMFS > +===== > + > A minimal DLM userspace interface implemented via a virtual file > system. > > dlmfs is built with OCFS2 as it requires most of its infrastructure. > > -Project web page: https://urldefense.com/v3/__http://ocfs2.wiki.kernel.org__;!!GqivPVa7Brio!J62vuPuajZiXibdGN7Xohrxt8XascTTzR2T7QluggF2lCXObu6HDN24MqEPApMb9-iEMmg$ > -Tools web page: https://urldefense.com/v3/__https://github.com/markfasheh/ocfs2-tools__;!!GqivPVa7Brio!J62vuPuajZiXibdGN7Xohrxt8XascTTzR2T7QluggF2lCXObu6HDN24MqEPApMb-Q-ssBg$ > -OCFS2 mailing lists: http://oss.oracle.com/projects/ocfs2/mailman/ > +:Project web page: https://urldefense.com/v3/__http://ocfs2.wiki.kernel.org__;!!GqivPVa7Brio!J62vuPuajZiXibdGN7Xohrxt8XascTTzR2T7QluggF2lCXObu6HDN24MqEPApMb9-iEMmg$ > +:Tools web page: https://urldefense.com/v3/__https://github.com/markfasheh/ocfs2-tools__;!!GqivPVa7Brio!J62vuPuajZiXibdGN7Xohrxt8XascTTzR2T7QluggF2lCXObu6HDN24MqEPApMb-Q-ssBg$ > +:OCFS2 mailing lists: http://oss.oracle.com/projects/ocfs2/mailman/ > > All code copyright 2005 Oracle except when otherwise noted. > > -CREDITS > +Credits > ======= > > -Some code taken from ramfs which is Copyright (C) 2000 Linus Torvalds > +Some code taken from ramfs which is Copyright |copy| 2000 Linus Torvalds > and Transmeta Corp. > > Mark Fasheh > @@ -96,14 +101,19 @@ operation. If the lock succeeds, you'll get an fd. > open(2) with O_CREAT to ensure the resource inode is created - dlmfs does > not automatically create inodes for existing lock resources. > > +============ =========================== > Open Flag Lock Request Type > ---------- ----------------- Better to remove the above line. > +============ =========================== > O_RDONLY Shared Read > O_RDWR Exclusive > +============ =========================== > > + > +============ =========================== > Open Flag Resulting Locking Behavior > ---------- -------------------------- Ditto. > +============ =========================== > O_NONBLOCK Trylock operation > +============ =========================== > > You must provide exactly one of O_RDONLY or O_RDWR. > > diff --git a/Documentation/filesystems/index.rst b/Documentation/filesystems/index.rst > index ab3b656bbe60..c6885c7ef781 100644 > --- a/Documentation/filesystems/index.rst > +++ b/Documentation/filesystems/index.rst > @@ -58,6 +58,7 @@ Documentation for filesystem implementations. > ceph > cramfs > debugfs > + dlmfs > fuse > overlayfs > virtiofs >