{"id":3763,"date":"2022-12-20T17:19:59","date_gmt":"2022-12-20T20:19:59","guid":{"rendered":"http:\/\/lode.uno\/linux-man\/index.php\/2022\/12\/20\/xfs_spaceman-man8\/"},"modified":"2022-12-20T17:19:59","modified_gmt":"2022-12-20T20:19:59","slug":"xfs_spaceman-man8","status":"publish","type":"post","link":"https:\/\/lode.uno\/linux-man\/2022\/12\/20\/xfs_spaceman-man8\/","title":{"rendered":"xfs_spaceman (man8)"},"content":{"rendered":"<h1 align=\"center\">xfs_spaceman<\/h1>\n<p> <a href=\"#NAME\">NAME<\/a><br \/> <a href=\"#SYNOPSIS\">SYNOPSIS<\/a><br \/> <a href=\"#DESCRIPTION\">DESCRIPTION<\/a><br \/> <a href=\"#OPTIONS\">OPTIONS<\/a><br \/> <a href=\"#COMMANDS\">COMMANDS<\/a> <\/p>\n<hr>\n<h2>NAME <a name=\"NAME\"><\/a> <\/h2>\n<p style=\"margin-left:11%; margin-top: 1em\">xfs_spaceman \u2212 show free space information about an XFS filesystem<\/p>\n<h2>SYNOPSIS <a name=\"SYNOPSIS\"><\/a> <\/h2>\n<p style=\"margin-left:11%; margin-top: 1em\"><b>xfs_spaceman<\/b> [ <b>\u2212c<\/b> <i>cmd<\/i> ] <i>file<\/i> <b><br \/> xfs_spaceman \u2212V<\/b><\/p>\n<h2>DESCRIPTION <a name=\"DESCRIPTION\"><\/a> <\/h2>\n<p style=\"margin-left:11%; margin-top: 1em\"><b>xfs_spaceman<\/b> reports and controls free space usage in an XFS filesystem.<\/p>\n<h2>OPTIONS <a name=\"OPTIONS\"><\/a> <\/h2>\n<table width=\"100%\" border=\"0\" rules=\"none\" frame=\"void\" cellspacing=\"0\" cellpadding=\"0\">\n<tr valign=\"top\" align=\"left\">\n<td width=\"11%\"><\/td>\n<td width=\"9%\">\n<p style=\"margin-top: 1em\"><b>\u2212c<\/b> <i>cmd<\/i><\/p>\n<\/td>\n<td width=\"6%\"><\/td>\n<td width=\"74%\">\n<p style=\"margin-top: 1em\"><b>xfs_spaceman<\/b> commands may be run interactively (the default) or as arguments on the command line. Multiple <b>\u2212c<\/b> arguments may be given. The commands are run in the sequence given, then the program exits.<\/p>\n<\/td>\n<\/tr>\n<\/table>\n<h2>COMMANDS <a name=\"COMMANDS\"><\/a> <\/h2>\n<p style=\"margin-left:11%; margin-top: 1em\"><b>freesp [ \u2212dgrs ] [-a agno]&#8230; [ \u2212b | \u2212e bsize | \u2212h bsize | \u2212m factor ]<\/b><\/p>\n<p style=\"margin-left:22%;\">With no arguments, <b>freesp<\/b> shows a histogram of all free space extents in the filesystem. The command takes the following options:<\/p>\n<p style=\"margin-left:26%;\"><b>\u2212a agno<\/b><\/p>\n<p style=\"margin-left:32%;\">Collect free space information from this allocation group. This option can be specified multiple times to collect from multiple groups.<\/p>\n<table width=\"100%\" border=\"0\" rules=\"none\" frame=\"void\" cellspacing=\"0\" cellpadding=\"0\">\n<tr valign=\"top\" align=\"left\">\n<td width=\"26%\"><\/td>\n<td width=\"3%\">\n<p><b>\u2212b<\/b><\/p>\n<\/td>\n<td width=\"3%\"><\/td>\n<td width=\"68%\">\n<p>This argument establishes that the histogram bin sizes are successive powers of two. This is the default, and is mutually exclusive with the <b>-e<\/b>, <b>-h<\/b>, and <b>-m<\/b> options.<\/p>\n<\/td>\n<\/tr>\n<tr valign=\"top\" align=\"left\">\n<td width=\"26%\"><\/td>\n<td width=\"3%\">\n<p><b>\u2212d<\/b><\/p>\n<\/td>\n<td width=\"3%\"><\/td>\n<td width=\"68%\">\n<p>Print debugging information such as the raw free space extent information.<\/p>\n<\/td>\n<\/tr>\n<tr valign=\"top\" align=\"left\">\n<td width=\"26%\"><\/td>\n<td width=\"3%\">\n<p><b>\u2212g<\/b><\/p>\n<\/td>\n<td width=\"3%\"><\/td>\n<td width=\"68%\">\n<p>Print the free space block and extent counts for each AG.<\/p>\n<\/td>\n<\/tr>\n<\/table>\n<p style=\"margin-left:26%;\"><b>\u2212e bsize<\/b><\/p>\n<p style=\"margin-left:32%;\">Set all histogram bin sizes to a specific value. This option is mutually exclusive with the <b>-b<\/b>, <b>-h<\/b>, and <b>-m<\/b> options.<\/p>\n<p style=\"margin-left:26%;\"><b>\u2212h bsize<\/b><\/p>\n<p style=\"margin-left:32%;\">Create a histogram bin with a lower bound of this value. The upper bound of this bin will be one less than the lower bound of the next highest histogram bin. This option can be given multiple times to control the exact bin sizes. This option is mutually exclusive with the <b>-b<\/b>, <b>-e<\/b>, and <b>-m<\/b> options.<\/p>\n<p style=\"margin-left:26%;\"><b>\u2212m factor<\/b><\/p>\n<p style=\"margin-left:32%;\">Create each histogram bin with a size that is this many times the size of the prvious bin created. This option is mutually exclusive with the <b>-b<\/b>, <b>-e<\/b>, and <b>-h<\/b> options.<\/p>\n<table width=\"100%\" border=\"0\" rules=\"none\" frame=\"void\" cellspacing=\"0\" cellpadding=\"0\">\n<tr valign=\"top\" align=\"left\">\n<td width=\"11%\"><\/td>\n<td width=\"18%\">\n<p><b>\u2212r<\/b><\/p>\n<\/td>\n<td width=\"3%\"><\/td>\n<td width=\"68%\">\n<p>Query the realtime device for free space information.<\/p>\n<\/td>\n<\/tr>\n<tr valign=\"top\" align=\"left\">\n<td width=\"11%\"><\/td>\n<td width=\"18%\">\n<p><b>\u2212s<\/b><\/p>\n<\/td>\n<td width=\"3%\"><\/td>\n<td width=\"68%\">\n<p>Display a summary of the free space information found.<\/p>\n<\/td>\n<\/tr>\n<tr valign=\"top\" align=\"left\">\n<td width=\"11%\"><\/td>\n<td width=\"18%\">\n<p><b>info<\/b><\/p>\n<\/td>\n<td width=\"3%\"><\/td>\n<td width=\"68%\"> <\/td>\n<\/tr>\n<\/table>\n<p style=\"margin-left:22%; margin-top: 1em\">Displays selected geometry information about the filesystem. The opened file must be a mount point of a XFS filesystem. The output will have the same format that <b>xfs_info<\/b>(8) prints when querying a filesystem.<\/p>\n<p style=\"margin-left:11%;\"><b>health [ \u2212a agno] [ \u2212c ] [ \u2212f ] [ \u2212i inum ] [ \u2212q ] [ paths ]<\/b><\/p>\n<p style=\"margin-left:22%;\">Reports the health of the given group of filesystem metadata.<\/p>\n<p style=\"margin-left:26%;\"><b>\u2212a agno<\/b><\/p>\n<p style=\"margin-left:32%;\">Report on the health of the given allocation group.<\/p>\n<table width=\"100%\" border=\"0\" rules=\"none\" frame=\"void\" cellspacing=\"0\" cellpadding=\"0\">\n<tr valign=\"top\" align=\"left\">\n<td width=\"26%\"><\/td>\n<td width=\"3%\">\n<p><b>\u2212c<\/b><\/p>\n<\/td>\n<td width=\"3%\"><\/td>\n<td width=\"68%\">\n<p>Scan all inodes in the filesystem and report each file\u2019s health status. If the <b>\u2212a<\/b> option is given, scan only the inodes in that AG.<\/p>\n<\/td>\n<\/tr>\n<tr valign=\"top\" align=\"left\">\n<td width=\"26%\"><\/td>\n<td width=\"3%\">\n<p><b>\u2212f<\/b><\/p>\n<\/td>\n<td width=\"3%\"><\/td>\n<td width=\"68%\">\n<p>Report on the health of metadata that affect the entire filesystem.<\/p>\n<\/td>\n<\/tr>\n<\/table>\n<p style=\"margin-left:26%;\"><b>\u2212i inum<\/b><\/p>\n<p style=\"margin-left:32%;\">Report on the health of a specific inode.<\/p>\n<table width=\"100%\" border=\"0\" rules=\"none\" frame=\"void\" cellspacing=\"0\" cellpadding=\"0\">\n<tr valign=\"top\" align=\"left\">\n<td width=\"26%\"><\/td>\n<td width=\"3%\">\n<p><b>\u2212q<\/b><\/p>\n<\/td>\n<td width=\"3%\"><\/td>\n<td width=\"48%\">\n<p>Report only unhealthy metadata.<\/p>\n<\/td>\n<td width=\"20%\"> <\/td>\n<\/tr>\n<\/table>\n<p style=\"margin-left:26%;\"><b>paths<\/b><\/p>\n<p style=\"margin-left:32%;\">Report on the health of the files at the given path.<\/p>\n<p style=\"margin-left:11%;\"><b>help [<\/b> command <b>]<\/b><\/p>\n<p style=\"margin-left:22%;\">Display a brief description of one or all commands.<\/p>\n<p style=\"margin-left:11%;\"><b>prealloc [ \u2212u id ] [ \u2212g id ] [ -p id ] [ \u2212m minlen ] [ \u2212s ]<\/b><\/p>\n<p style=\"margin-left:22%;\">Removes speculative preallocation. If no <b>-u<\/b>, <b>-g<\/b>, or <b>-p<\/b> options are given, this command acts on all files. The command takes the following options:<\/p>\n<p style=\"margin-left:26%;\"><b>\u2212u uid<\/b><\/p>\n<p style=\"margin-left:32%;\">Clear all speculative preallocations for files with this user id. This option can be given in combination with the <b>-g and -p<\/b> options.<\/p>\n<p style=\"margin-left:26%;\"><b>\u2212g gid<\/b><\/p>\n<p style=\"margin-left:32%;\">Clear all speculative preallocations for files with this group id. This option can be given in combination with the <b>-u and -p<\/b> options.<\/p>\n<p style=\"margin-left:26%;\"><b>\u2212p pid<\/b><\/p>\n<p style=\"margin-left:32%;\">Clear all speculative preallocations for files with this project id. This option can be given in combination with the <b>-u and -g<\/b> options.<\/p>\n<p style=\"margin-left:26%;\"><b>\u2212m minlen<\/b><\/p>\n<p style=\"margin-left:32%;\">Ignore all files smaller than this size. Units can be supplied for this argument.<\/p>\n<table width=\"100%\" border=\"0\" rules=\"none\" frame=\"void\" cellspacing=\"0\" cellpadding=\"0\">\n<tr valign=\"top\" align=\"left\">\n<td width=\"11%\"><\/td>\n<td width=\"18%\">\n<p><b>\u2212s<\/b><\/p>\n<\/td>\n<td width=\"3%\"><\/td>\n<td width=\"45%\">\n<p>Wait for removal to complete.<\/p>\n<\/td>\n<td width=\"23%\"> <\/td>\n<\/tr>\n<tr valign=\"top\" align=\"left\">\n<td width=\"11%\"><\/td>\n<td width=\"18%\">\n<p><b>print<\/b><\/p>\n<\/td>\n<td width=\"3%\"><\/td>\n<td width=\"45%\"><\/td>\n<td width=\"23%\"> <\/td>\n<\/tr>\n<\/table>\n<p style=\"margin-left:22%; margin-top: 1em\">Display a list of all open files.<\/p>\n<table width=\"100%\" border=\"0\" rules=\"none\" frame=\"void\" cellspacing=\"0\" cellpadding=\"0\">\n<tr valign=\"top\" align=\"left\">\n<td width=\"11%\"><\/td>\n<td width=\"6%\">\n<p style=\"margin-top: 1em\"><b>quit<\/b><\/p>\n<\/td>\n<td width=\"5%\"><\/td>\n<td width=\"27%\">\n<p style=\"margin-top: 1em\">Exit <b>xfs_spaceman<\/b>.<\/p>\n<\/td>\n<td width=\"51%\"> <\/td>\n<\/tr>\n<\/table>\n<p style=\"margin-left:11%;\"><b>trim ( \u2212a agno | \u2212f |<\/b> <i>offset length<\/i> <b>) [ -m minlen ]<\/b><\/p>\n<p style=\"margin-left:22%;\">Instructs the underlying storage device to release all storage that may be backing free space in the filesystem. The command takes the following options: (One of <b>-a<\/b>, <b>-f<\/b>, or the <i>offset<\/i>\/<i>length<\/i> pair are required.)<\/p>\n<p style=\"margin-left:26%;\"><b>\u2212a agno<\/b><\/p>\n<p style=\"margin-left:32%;\">Trim free space extents in the given allocation group. This option is mutually exclusive with the <b>-f<\/b> option and the <i>offset<\/i>\/<i>length<\/i> options.<\/p>\n<table width=\"100%\" border=\"0\" rules=\"none\" frame=\"void\" cellspacing=\"0\" cellpadding=\"0\">\n<tr valign=\"top\" align=\"left\">\n<td width=\"26%\"><\/td>\n<td width=\"3%\">\n<p><b>\u2212f<\/b><\/p>\n<\/td>\n<td width=\"3%\"><\/td>\n<td width=\"68%\">\n<p>Trim all free space in the filesystem. This option is mutually exclusive with the <b>-a<\/b> option and the <i>offset<\/i>\/<i>length<\/i> options.<\/p>\n<\/td>\n<\/tr>\n<\/table>\n<p style=\"margin-left:26%;\"><i>option<\/i>, <i>length<\/i><\/p>\n<p style=\"margin-left:32%;\">Trim all free space within the physical range defined by the <i>offset<\/i> and <i>length<\/i> from this filesystem. Units can be appended to these arguments. This option is mutually exclusive with the <b>-a<\/b> and <b>-f<\/b> options.<\/p>\n<p style=\"margin-left:26%;\"><b>\u2212m minlen<\/b><\/p>\n<p style=\"margin-left:32%;\">Do not trim free space extents shorter than this length. Units can be appended to this argument.<\/p>\n<hr>\n","protected":false},"excerpt":{"rendered":"<p>  xfs_spaceman \u2212 show free space information about an XFS filesystem <\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2],"tags":[5,52,4,866],"class_list":["post-3763","post","type-post","status-publish","format-standard","hentry","category-8-administracion-del-sistema","tag-5","tag-administracion","tag-man8","tag-xfs_spaceman"],"gutentor_comment":0,"_links":{"self":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/3763","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/comments?post=3763"}],"version-history":[{"count":0,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/3763\/revisions"}],"wp:attachment":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/media?parent=3763"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/categories?post=3763"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/tags?post=3763"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}