Received: by 2002:ac0:bc90:0:0:0:0:0 with SMTP id a16csp4963814img; Tue, 26 Mar 2019 22:21:06 -0700 (PDT) X-Google-Smtp-Source: APXvYqyiuxtajduWT9Cl815iywM6cvCUOqU3Lj2cBJtMO/6iNlsJDPPh4kEHuAnkwubPC23Gs6lg X-Received: by 2002:a63:fc43:: with SMTP id r3mr14961552pgk.44.1553664066450; Tue, 26 Mar 2019 22:21:06 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1553664066; cv=none; d=google.com; s=arc-20160816; b=AkEyh/DdJ3WqSa2nPMkh+nxjM2xAnbnECSaFqA8dTRt/XEBTafUzcNDXr5zGSM7ELP 5E2a8Lb9J/mlQ5PuhMaVtdNhBhHzDfK7O5bhkSn4bAtt4EJmhTn5nNVJBgK/dvatuK6M QHv8nFAGjT0H9AaLTZOEDQgegP6HmkoOBrWoZaHqDhxjy6OZfTs5fcd9tcb4WSVUa9q+ UcG/PT6J6jlhRhhygRDMwJeqm7IPP1P9cR4Wl3lqN8gg3M3mpX53gOpNxR/S0cR9wjb6 Km6fvfezcdN91h4J7PnG3A9sFgnIqfHLWNPmGGuSW/niMLmeNxMzE2yAlNnGgz9PI0Xs L4Eg== 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=FjHoXW+oSNbeABpNGFpEjjjz7ysOT0oYkb5mJvFJQgs=; b=TQrPaBGHNjg01E8AOZQCdYhOWkVMOHTlYnherehKBqzcGRuT/hnyS0mseqm6EnGnSs BnU8nIEs5n0v7PEyahrtIOwGX5YvXcthMCDcY5HKOpMVcvYBj2sBGkne1cXXPPrlZUAt y3tUp4C9ikpXBFzku2jS+yRul6yreChly4LVQF+OzX0C4uyMmdB8lJspFGdJdI94WHo5 Ua3MQtcVQThprDXTHbAqETIoMaaBUB0B0xo878rzj2JwD2+idkG+eS/T20OeDKXw+sWg 9F3GTTsqxuBUCpcgShSElDFhahDspmHty7pE2PdfUCpz03gRFkbiBh4FLRmPyGDnuk/l jW0A== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@messagingengine.com header.s=fm2 header.b="S/j6Tl/N"; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=kernel.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id l69si11660093plb.272.2019.03.26.22.20.51; Tue, 26 Mar 2019 22:21:06 -0700 (PDT) Received-SPF: pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; dkim=pass header.i=@messagingengine.com header.s=fm2 header.b="S/j6Tl/N"; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1733264AbfC0FTm (ORCPT + 99 others); Wed, 27 Mar 2019 01:19:42 -0400 Received: from out3-smtp.messagingengine.com ([66.111.4.27]:58345 "EHLO out3-smtp.messagingengine.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1733150AbfC0FTk (ORCPT ); Wed, 27 Mar 2019 01:19:40 -0400 Received: from compute3.internal (compute3.nyi.internal [10.202.2.43]) by mailout.nyi.internal (Postfix) with ESMTP id 1997A220B3; Wed, 27 Mar 2019 01:19:39 -0400 (EDT) Received: from mailfrontend1 ([10.202.2.162]) by compute3.internal (MEProxy); Wed, 27 Mar 2019 01:19:39 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-transfer-encoding:date:from :in-reply-to:message-id:mime-version:references:subject:to :x-me-proxy:x-me-proxy:x-me-sender:x-me-sender:x-sasl-enc; s= fm2; bh=FjHoXW+oSNbeABpNGFpEjjjz7ysOT0oYkb5mJvFJQgs=; b=S/j6Tl/N NbTJEwyaJtOYu9Iohj/ldzgSgGpjkpmPyVCiSjUBn53UoILk4yUGXxLiwzGOj4/g cY+iYKnhNAWGVCCzlouQfdh7oTLdHqUTSw0PjzhssAlRFO+gNLePrX8/OC2ddTxA sDt/mHOb8EZt1/zthu94d+Kgztn8HBn+nh1e3of4WCrCcHlDtF96kt2AfGOcxfEG Viwzy/8d+onwEljeUGoCu3eaSvO/iXfoYQSojUVgSqUILQgChU+cm11sL7ML7QA7 GXMr6EigRcPinGUEStE6dXv7oeF34lsvPbZg4dbWvF9Tc7nTR9RFU13hsXurDV8W r285dFZzljv3OQ== X-ME-Sender: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedutddrkedugdektdcutefuodetggdotefrodftvf curfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfghnecu uegrihhlohhuthemuceftddtnecusecvtfgvtghiphhivghnthhsucdlqddutddtmdenuc fjughrpefhvffufffkofgjfhgggfestdekredtredttdenucfhrhhomhepfdfvohgsihhn ucevrdcujfgrrhguihhnghdfuceothhosghinheskhgvrhhnvghlrdhorhhgqeenucfkph epuddvgedrudeiledrudefledrudelvdenucfrrghrrghmpehmrghilhhfrhhomhepthho sghinheskhgvrhhnvghlrdhorhhgnecuvehluhhsthgvrhfuihiivgepudei X-ME-Proxy: Received: from eros.localdomain (124-169-139-192.dyn.iinet.net.au [124.169.139.192]) by mail.messagingengine.com (Postfix) with ESMTPA id 7E174E415C; Wed, 27 Mar 2019 01:19:35 -0400 (EDT) From: "Tobin C. Harding" To: Al Viro Cc: "Tobin C. Harding" , Jonathan Corbet , Mauro Carvalho Chehab , Neil Brown , Randy Dunlap , linux-doc@vger.kernel.org, linux-fsdevel@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH v3 18/24] docs: filesystems: vfs: Use uniform spacing around headings Date: Wed, 27 Mar 2019 16:17:11 +1100 Message-Id: <20190327051717.23225-19-tobin@kernel.org> X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190327051717.23225-1-tobin@kernel.org> References: <20190327051717.23225-1-tobin@kernel.org> 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 Currently spacing before and after headings is non-uniform. Use two blank lines before a heading and one after the heading. Use uniform spacing around headings. Tested-by: Randy Dunlap Signed-off-by: Tobin C. Harding --- Documentation/filesystems/vfs.txt | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/Documentation/filesystems/vfs.txt b/Documentation/filesystems/vfs.txt index 5c4d74547dd7..b452b3fc5edc 100644 --- a/Documentation/filesystems/vfs.txt +++ b/Documentation/filesystems/vfs.txt @@ -321,6 +321,7 @@ Whoever sets up the inode is responsible for filling in the "i_op" field. This is a pointer to a "struct inode_operations" which describes the methods that can be performed on individual inodes. + struct xattr_handlers --------------------- @@ -507,6 +508,7 @@ otherwise noted. tmpfile: called in the end of O_TMPFILE open(). Optional, equivalent to atomically creating, opening and unlinking a file in given directory. + The Address Space Object ======================== @@ -580,8 +582,10 @@ and the constraints under which it is being done. It is also used to return information back to the caller about the result of a writepage or writepages request. + Handling errors during writeback -------------------------------- + Most applications that do buffered I/O will periodically call a file synchronization call (fsync, fdatasync, msync or sync_file_range) to ensure that data written has made it to the backing store. When there @@ -612,6 +616,7 @@ file->fsync operation, they should call file_check_and_advance_wb_err to ensure that the struct file's error cursor has advanced to the correct point in the stream of errors emitted by the backing device(s). + struct address_space_operations ------------------------------- @@ -1200,9 +1205,11 @@ manipulate dentries: and the dentry is returned. The caller must use dput() to free the dentry when it finishes using it. + Mount Options ============= + Parsing options --------------- @@ -1217,6 +1224,7 @@ The header defines an API that helps parse these options. There are plenty of examples on how to use it in existing filesystems. + Showing options --------------- @@ -1238,6 +1246,7 @@ The underlying reason for the above rules is to make sure, that a mount can be accurately replicated (e.g. umounting and mounting again) based on the information found in /proc/mounts. + Resources ========= -- 2.21.0