From patchwork Sat Jan 21 08:08:51 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: "Darrick J. Wong" X-Patchwork-Id: 9530057 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork.web.codeaurora.org (Postfix) with ESMTP id 37C05600CA for ; Sat, 21 Jan 2017 08:08:57 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 26BA72842E for ; Sat, 21 Jan 2017 08:08:57 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 1B9F528620; Sat, 21 Jan 2017 08:08:57 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-6.9 required=2.0 tests=BAYES_00, RCVD_IN_DNSWL_HI, UNPARSEABLE_RELAY autolearn=ham version=3.3.1 Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id B3DEC2842E for ; Sat, 21 Jan 2017 08:08:56 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751273AbdAUII4 (ORCPT ); Sat, 21 Jan 2017 03:08:56 -0500 Received: from aserp1040.oracle.com ([141.146.126.69]:20503 "EHLO aserp1040.oracle.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751169AbdAUIIz (ORCPT ); Sat, 21 Jan 2017 03:08:55 -0500 Received: from userv0021.oracle.com (userv0021.oracle.com [156.151.31.71]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id v0L88qjL017206 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sat, 21 Jan 2017 08:08:53 GMT Received: from userv0121.oracle.com (userv0121.oracle.com [156.151.31.72]) by userv0021.oracle.com (8.14.4/8.14.4) with ESMTP id v0L88qwM021737 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sat, 21 Jan 2017 08:08:52 GMT Received: from abhmp0015.oracle.com (abhmp0015.oracle.com [141.146.116.21]) by userv0121.oracle.com (8.14.4/8.13.8) with ESMTP id v0L88q4A026724; Sat, 21 Jan 2017 08:08:52 GMT Received: from localhost (/24.21.211.40) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Sat, 21 Jan 2017 00:08:51 -0800 Subject: [PATCH 07/17] xfs_spaceman: add a man page From: "Darrick J. Wong" To: sandeen@redhat.com, darrick.wong@oracle.com Cc: linux-xfs@vger.kernel.org, linux-fsdevel@vger.kernel.org Date: Sat, 21 Jan 2017 00:08:51 -0800 Message-ID: <148498613103.16675.8670953960956445038.stgit@birch.djwong.org> In-Reply-To: <148498608472.16675.14848042961636871812.stgit@birch.djwong.org> References: <148498608472.16675.14848042961636871812.stgit@birch.djwong.org> User-Agent: StGit/0.17.1-dirty MIME-Version: 1.0 X-Source-IP: userv0021.oracle.com [156.151.31.71] Sender: linux-xfs-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-xfs@vger.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP Add a manual page describing xfs_spaceman's behavior. Signed-off-by: Darrick J. Wong --- man/man8/xfs_spaceman.8 | 102 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 102 insertions(+) create mode 100644 man/man8/xfs_spaceman.8 -- To unsubscribe from this list: send the line "unsubscribe linux-xfs" in the body of a message to majordomo@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html diff --git a/man/man8/xfs_spaceman.8 b/man/man8/xfs_spaceman.8 new file mode 100644 index 0000000..c1d19c0 --- /dev/null +++ b/man/man8/xfs_spaceman.8 @@ -0,0 +1,102 @@ +.TH xfs_spaceman 8 +.SH NAME +xfs_spaceman \- show free space information about an XFS filesystem +.SH SYNOPSIS +.B xfs_spaceman +[ +.B \-c +.I cmd +] +.I file +.br +.B xfs_spaceman \-V +.SH DESCRIPTION +.B xfs_spaceman +reports and controls free space usage in an XFS filesystem. +.SH OPTIONS +.TP 1.0i +.BI \-c " cmd" +.B xfs_spaceman +commands may be run interactively (the default) or as arguments on +the command line. Multiple +.B \-c +arguments may be given. The commands are run in the sequence given, +then the program exits. + +.SH COMMANDS +.TP +.BI "freesp [ \-sr ] [ \-b | \-e bsize | \-h h1 [ \-m bmult ]] [-a agno]" +With no arguments, +.B freesp +shows a histogram of all free space extents in the filesystem. +The +.B -b +argument establishes that the histogram bins are successive powers of two. +This is the default. +The +.BR -h " and " -m +options can be used to specify a custom histogram bin size as well as a +multiplication factor for subsequent bin sizes. +The +.BR -e +option fixes the histogram size to a particular value. +The +.BR -a " and " -r +options constrain the free space information report to a particular AG +or the realtime device, respectively. The +.B -a +option may be specified multiple times. +A summary of free space information will be printed if the +.B -s +option is given. +.TP +.BR "help [ " command " ]" +Display a brief description of one or all commands. +.TP +.BI "prealloc [ \-ugp id ] [ \-m minlen ] [ \-s ]" +Controls speculative preallocation. The +.BR -u "," +.BR -g "," +and +.B -p +options will clear all speculative preallocations for a given user, +group, or project ID, respectively. +The +.B -m +option causes the operation to ignore any file with a size smaller than +.BR minlen "." +The +.B -s +option will flush all dirty data and metadata to disk. +.TP +.B print +Display a list of all open files. +.TP +.B quit +Exit +.BR xfs_spaceman . +.TP +.BI "trim [ \-f ] [ \-a agno ] [ \-m minlen ] [" " offset length " ] +Instructs the underlying storage device to release all storage that may +be backing free space in the filesystem. +The +.B -f +option trims all free space in the entire filesystem. +The +.B -a +option trims only the free space in a given AG. +The +.B -m +option only trims free space extents that are longer than +.IR minlen "." +The +.IR offset " and " length +arguments trim all free space between +.I offset +and +.IR "offset+length" "." +The +.BR -a " and " -f +options are mutually exclusive with each other as well as with the +.IR offset " and " length +arguments.