From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from relay.sgi.com (relay1.corp.sgi.com [137.38.102.111]) by oss.sgi.com (Postfix) with ESMTP id A83CF8275 for ; Thu, 25 Aug 2016 18:52:55 -0500 (CDT) Received: from cuda.sgi.com (cuda3.sgi.com [192.48.176.15]) by relay1.corp.sgi.com (Postfix) with ESMTP id 616708F8033 for ; Thu, 25 Aug 2016 16:52:55 -0700 (PDT) Received: from userp1040.oracle.com (userp1040.oracle.com [156.151.31.81]) by cuda.sgi.com with ESMTP id Ou3EDekCmIy1RvOX (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NO) for ; Thu, 25 Aug 2016 16:52:53 -0700 (PDT) Subject: [PATCH 58/71] man: document the inode cowextsize flags & fields From: "Darrick J. Wong" Date: Thu, 25 Aug 2016 16:52:50 -0700 Message-ID: <147216917010.4420.687777056323399610.stgit@birch.djwong.org> In-Reply-To: <147216879156.4420.2446767701729565218.stgit@birch.djwong.org> References: <147216879156.4420.2446767701729565218.stgit@birch.djwong.org> MIME-Version: 1.0 List-Id: XFS Filesystem from SGI List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Errors-To: xfs-bounces@oss.sgi.com Sender: xfs-bounces@oss.sgi.com To: david@fromorbit.com, darrick.wong@oracle.com Cc: linux-xfs@vger.kernel.org, xfs@oss.sgi.com Document the new copy-on-write extent size fields and inode flags available in struct fsxattr. Signed-off-by: Darrick J. Wong --- man/man3/xfsctl.3 | 24 +++++++++++++++++++++++- 1 file changed, 23 insertions(+), 1 deletion(-) diff --git a/man/man3/xfsctl.3 b/man/man3/xfsctl.3 index ef6c992..77506aa 100644 --- a/man/man3/xfsctl.3 +++ b/man/man3/xfsctl.3 @@ -150,6 +150,15 @@ value returned indicates that a preferred extent size was previously set on the file, a .B fsx_extsize of zero indicates that the defaults for that filesystem will be used. +A +.B fsx_cowextsize +value returned indicates that a preferred copy on write extent size was +previously set on the file, whereas a +.B fsx_cowextsize +of zero indicates that the defaults for that filesystem will be used. +The current default for +.B fsx_cowextsize +is 128 blocks. Currently the meaningful bits for the .B fsx_xflags field are: @@ -240,6 +249,15 @@ and .BR XFS_XFLAG_DAX set at the same time, that is to say that DAX files cannot share blocks. .TP +.SM "Bit 17 (0x20000) \- XFS_XFLAG_COWEXTSIZE" +Copy on Write Extent size bit - if a CoW extent size value is set on the file, +the allocator will allocate extents for staging a copy on write operation +in multiples of the set size for this file (see +.B XFS_IOC_FSSETXATTR +below). +If the CoW extent size is set on a directory, then new file and directories +created in the directory will inherit the parent's CoW extent size value. +.TP .SM "Bit 31 (0x80000000) \- XFS_XFLAG_HASATTR" The file has extended attributes associated with it. .RE @@ -261,7 +279,8 @@ The final argument points to a variable of type .BR "struct fsxattr" , but only the following fields are used in this call: .BR fsx_xflags , -.B fsx_extsize +.BR fsx_extsize , +.BR fsx_cowextsize , and .BR fsx_projid . The @@ -271,6 +290,9 @@ when the file is empty, except in the case of a directory where the extent size can be set at any time (this value is only used for regular file allocations, so should only be set on a directory in conjunction with the XFS_XFLAG_EXTSZINHERIT flag). +The copy on write extent size, +.BR fsx_cowextsize , +can be set at any time. .TP .B XFS_IOC_GETBMAP _______________________________________________ xfs mailing list xfs@oss.sgi.com http://oss.sgi.com/mailman/listinfo/xfs