{
    "content": [
        {
            "type": "text",
            "text": "# xfsinvutil (man)\n\n## NAME\n\nxfsinvutil - xfsdump inventory database checking and pruning utility\n\n## SYNOPSIS\n\nxfsinvutil [-F|-i] [-m medialabel] -M mountpoint mm/dd/yyyy\nxfsinvutil [-F|-i] [-m medialabel] -u UUID mm/dd/yyyy\nxfsinvutil [-F] -s SESSIONID\nxfsinvutil -i\nxfsinvutil -C\n\n## DESCRIPTION\n\nxfsdump  maintains  an online dump inventory in /var/lib/xfsdump/inventory.  The -I option of\nxfsdump displays the inventory contents hierarchically.  The levels  of  the  hierarchy  are:\nfilesystem, dump session, stream, and media file.\n\n## Sections\n\n- **NAME**\n- **SYNOPSIS**\n- **DESCRIPTION** (8 subsections)\n- **NOTES** (1 subsections)\n- **FILES**\n- **SEE ALSO**\n\nUse structuredContent.sections for detailed options, examples, and full documentation.\n"
        }
    ],
    "structuredContent": {
        "command": "xfsinvutil",
        "section": "",
        "mode": "man",
        "summary": "xfsinvutil - xfsdump inventory database checking and pruning utility",
        "synopsis": "xfsinvutil [-F|-i] [-m medialabel] -M mountpoint mm/dd/yyyy\nxfsinvutil [-F|-i] [-m medialabel] -u UUID mm/dd/yyyy\nxfsinvutil [-F] -s SESSIONID\nxfsinvutil -i\nxfsinvutil -C",
        "tldr_summary": null,
        "tldr_examples": [],
        "tldr_source": null,
        "flags": [
            {
                "flag": "-F",
                "long": null,
                "arg": null,
                "description": "til will normally ask the operator for permission to delete the entry. With this option the deletion is performed, no questions asked."
            },
            {
                "flag": "-i",
                "long": null,
                "arg": null,
                "description": "browse and modify the contents of the inventory. Please refer to the Interactive Mode section below for more information."
            },
            {
                "flag": "-M",
                "long": null,
                "arg": null,
                "description": "Prunes dump sessions identified by the given mount point which were created prior to the specified date. Optionally -m may be be specified to further limit the matching dump sessions by media label. xfsinvutil will prompt the operator prior to pruning a dump session unless the -F or -i options are given."
            },
            {
                "flag": "-u",
                "long": null,
                "arg": null,
                "description": "Like -M, except the matching filesystem is specified using its universally unique iden‐ tifier (UUID) instead of its mount point."
            },
            {
                "flag": "-m",
                "long": null,
                "arg": null,
                "description": "If specified, only sessions with at least one media file whose label matches this value will be eligible for pruning. This restriction is in addition to those imposed by the date and the -M or -u options. This option allows the pruning of all inventory refer‐ ences to media which may have been overwritten or lost. Note that this option does not apply to sessions with no media files."
            },
            {
                "flag": "-s",
                "long": null,
                "arg": null,
                "description": "Prunes the dump session identified by the given session id. xfsinvutil will prompt the operator prior to pruning a dump session unless the -F option is given."
            },
            {
                "flag": "-C",
                "long": null,
                "arg": null,
                "description": "tory database. It fixes any problems found. If no consistent entries are found , the corresponding inventory database file is removed."
            }
        ],
        "examples": [],
        "see_also": [
            {
                "name": "xfsdump",
                "section": "8",
                "url": "https://www.chedong.com/phpMan.php/man/xfsdump/8/json"
            },
            {
                "name": "xfsrestore",
                "section": "8",
                "url": "https://www.chedong.com/phpMan.php/man/xfsrestore/8/json"
            }
        ],
        "section_outline": [
            {
                "name": "NAME",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "SYNOPSIS",
                "lines": 6,
                "subsections": []
            },
            {
                "name": "DESCRIPTION",
                "lines": 10,
                "subsections": [
                    {
                        "name": "-F",
                        "lines": 3,
                        "flag": "-F"
                    },
                    {
                        "name": "-i",
                        "lines": 3,
                        "flag": "-i"
                    },
                    {
                        "name": "-M",
                        "lines": 5,
                        "flag": "-M"
                    },
                    {
                        "name": "-u",
                        "lines": 3,
                        "flag": "-u"
                    },
                    {
                        "name": "-m",
                        "lines": 6,
                        "flag": "-m"
                    },
                    {
                        "name": "-s",
                        "lines": 3,
                        "flag": "-s"
                    },
                    {
                        "name": "-C",
                        "lines": 3,
                        "flag": "-C"
                    },
                    {
                        "name": "Interactive Mode",
                        "lines": 42
                    }
                ]
            },
            {
                "name": "NOTES",
                "lines": 1,
                "subsections": [
                    {
                        "name": "Inventory",
                        "lines": 8
                    }
                ]
            },
            {
                "name": "FILES",
                "lines": 3,
                "subsections": []
            },
            {
                "name": "SEE ALSO",
                "lines": 5,
                "subsections": []
            }
        ],
        "sections": {
            "NAME": {
                "content": "xfsinvutil - xfsdump inventory database checking and pruning utility\n",
                "subsections": []
            },
            "SYNOPSIS": {
                "content": "xfsinvutil [-F|-i] [-m medialabel] -M mountpoint mm/dd/yyyy\nxfsinvutil [-F|-i] [-m medialabel] -u UUID mm/dd/yyyy\nxfsinvutil [-F] -s SESSIONID\nxfsinvutil -i\nxfsinvutil -C\n",
                "subsections": []
            },
            "DESCRIPTION": {
                "content": "xfsdump  maintains  an online dump inventory in /var/lib/xfsdump/inventory.  The -I option of\nxfsdump displays the inventory contents hierarchically.  The levels  of  the  hierarchy  are:\nfilesystem, dump session, stream, and media file.\n\nxfsinvutil  is  a utility to check this inventory database for consistency, to remove entries\nof dump sessions which may no longer be of relevance, and to browse the contents of  the  in‐\nventory.\n\nThe following command line options are available:\n",
                "subsections": [
                    {
                        "name": "-F",
                        "content": "til will normally ask the operator for permission to delete the entry. With this  option\nthe deletion is performed, no questions asked.\n",
                        "flag": "-F"
                    },
                    {
                        "name": "-i",
                        "content": "browse and modify the contents of the inventory. Please refer to  the  Interactive  Mode\nsection below for more information.\n",
                        "flag": "-i"
                    },
                    {
                        "name": "-M",
                        "content": "Prunes dump sessions identified by the given mount point which were created prior to the\nspecified date. Optionally -m may be be specified to further  limit  the  matching  dump\nsessions  by  media  label.  xfsinvutil will prompt the operator prior to pruning a dump\nsession unless the -F or -i options are given.\n",
                        "flag": "-M"
                    },
                    {
                        "name": "-u",
                        "content": "Like -M, except the matching filesystem is specified using its universally unique  iden‐\ntifier (UUID) instead of its mount point.\n",
                        "flag": "-u"
                    },
                    {
                        "name": "-m",
                        "content": "If  specified, only sessions with at least one media file whose label matches this value\nwill be eligible for pruning.  This restriction is in addition to those imposed  by  the\ndate  and  the -M or -u options.  This option allows the pruning of all inventory refer‐\nences to media which may have been overwritten or lost. Note that this option  does  not\napply to sessions with no media files.\n",
                        "flag": "-m"
                    },
                    {
                        "name": "-s",
                        "content": "Prunes  the dump session identified by the given session id.  xfsinvutil will prompt the\noperator prior to pruning a dump session unless the -F option is given.\n",
                        "flag": "-s"
                    },
                    {
                        "name": "-C",
                        "content": "tory  database.   It  fixes any problems found. If no consistent entries are found , the\ncorresponding inventory database file is removed.\n",
                        "flag": "-C"
                    },
                    {
                        "name": "Interactive Mode",
                        "content": "When run with -i, xfsinvutil will present the operator with a hierarchical representation  of\nthe  xfsdump  inventory.   In  this mode, the operator can use the arrow keys (or the h j k l\nkeys) to navigate the inventory and also use the following keys and functionality:\n\n+    Expand a branch of the tree.\n\n-    Collapse a branch of the tree.\n\n*    Fully expand a branch of the tree.\n\n%    Fully collapse a branch of the tree.\n\nh    Move selection to the parent entry.\n\nl    Move selection to the child entry.\n\nj    Move selection to next entry.\n\nk    Move selection to previous entry.\n\nd    Mark the current record, and all sub-records, to be deleted.\n\nu    Clear the current record and all parent records from being deleted.\n\ni    Import another xfsdump inventory.\n\n?    Show help window.\n\nx    Commit any changes made to the inventory, and exit the program.\n\nq    Exit the program without committing any changes to the inventory.\n\nInventories from other hosts can be imported to create a larger common inventory.  It is rec‐\nommended  that  the  contents of /var/lib/xfsdump/inventory on the remote host be copied to a\ntemporary local directory prior to running xfsinvutil.  When xfsinvutil is run in interactive\nmode,  and the operator hits i, they will be prompted for the path to the inventory to be im‐\nported.  xfsinvutil will then add the contents of the imported inventory to the main  window,\nand  all  entries  will be marked as imported.  The operator can then delete any of these en‐\ntries that are not to be imported.  When the operator commits the  changes,  xfsinvutil  will\nimport  any  entries  which  were  not  marked  as deleted.  Deleted entries are not actually\ndeleted from the original imported inventory.\n"
                    }
                ]
            },
            "NOTES": {
                "content": "",
                "subsections": [
                    {
                        "name": "Inventory",
                        "content": "Each dump session updates an inventory database in /var/lib/xfsdump/inventory.  xfsdump  uses\nthe inventory to determine the base of incremental and resumed dumps.\n\nThis  database  can  be  displayed  by invoking xfsdump with the -I option.  The display uses\ntabbed indentation to present the inventory hierarchically.  The first level  is  filesystem.\nThe  second  level is session.  The third level is media stream (currently only one stream is\nsupported).  The fourth level lists the media files sequentially composing the stream.\n"
                    }
                ]
            },
            "FILES": {
                "content": "/var/lib/xfsdump/inventory\ndump inventory database\n",
                "subsections": []
            },
            "SEE ALSO": {
                "content": "xfsdump(8), xfsrestore(8).\n\n\n\nxfsinvutil(8)",
                "subsections": []
            }
        }
    }
}