{
    "content": [
        {
            "type": "text",
            "text": "# xfs_growfs (man)\n\n## NAME\n\nxfsgrowfs - expand an XFS filesystem\n\n## SYNOPSIS\n\nxfsgrowfs  [  -dilnrx ] [ -D size ] [ -e rtextsize ] [ -L size ] [ -m maxpct ] [ -t mtab ] [\n\n## DESCRIPTION\n\nxfsgrowfs expands an existing XFS filesystem (see xfs(5)).  The mount-point argument is  the\npathname  of  the directory where the filesystem is mounted. The block-device argument is the\ndevice name of a mounted XFS filesystem.  The filesystem must be mounted  to  be  grown  (see\nmount(8)).   The existing contents of the filesystem are undisturbed, and the added space be‐\ncomes available for additional file storage.\n\n## Sections\n\n- **NAME**\n- **SYNOPSIS** (1 subsections)\n- **DESCRIPTION**\n- **OPTIONS** (9 subsections)\n- **PRACTICAL USE**\n- **SEE ALSO**\n\nUse structuredContent.sections for detailed options, examples, and full documentation.\n"
        }
    ],
    "structuredContent": {
        "command": "xfs_growfs",
        "section": "",
        "mode": "man",
        "summary": "xfsgrowfs - expand an XFS filesystem",
        "synopsis": "xfsgrowfs  [  -dilnrx ] [ -D size ] [ -e rtextsize ] [ -L size ] [ -m maxpct ] [ -t mtab ] [",
        "tldr_summary": null,
        "tldr_examples": [],
        "tldr_source": null,
        "flags": [
            {
                "flag": "-D",
                "long": null,
                "arg": null,
                "description": "Specifies that the data section of the filesystem should be resized. If the -D size option is given, the data section is changed to that size, otherwise the data section is grown to the largest size possible with the -d option. The size is expressed in filesystem blocks. A filesystem with only 1 AG cannot be shrunk further, and a filesystem cannot be shrunk to the point where it would only have 1 AG."
            },
            {
                "flag": "-e",
                "long": null,
                "arg": null,
                "description": "with -r extsize=nnnn."
            },
            {
                "flag": "-i",
                "long": null,
                "arg": null,
                "description": "implemented]"
            },
            {
                "flag": "-L",
                "long": null,
                "arg": null,
                "description": "Specifies that the log section of the filesystem should be grown, shrunk, or moved. If the -L size option is given, the log section is changed to be that size, if possible. The size is expressed in filesystem blocks. The size of an internal log must be smaller than the size of an allocation group (this value is printed at mkfs(8) time). If neither -i nor -x is given with -l, the log continues to be internal or external as it was before. [NOTE: These options are not implemented]"
            },
            {
                "flag": "-m",
                "long": null,
                "arg": null,
                "description": "allocated as inodes. In mkfs.xfs(8) this is specified with -i maxpct=nn."
            },
            {
                "flag": "-n",
                "long": null,
                "arg": null,
                "description": "printed, and argument checking is performed, but no growth occurs. See output exam‐‐ ples below."
            },
            {
                "flag": "-R",
                "long": null,
                "arg": null,
                "description": "Specifies that the real-time section of the filesystem should be grown. If the -R size option is given, the real-time section is grown to that size, otherwise the real-time section is grown to the largest size possible with the -r option. The size is ex‐ pressed in filesystem blocks. The filesystem does not need to have contained a real- time section before the xfsgrowfs operation."
            },
            {
                "flag": "-t",
                "long": null,
                "arg": null,
                "description": "/etc/mtab). This is used when working with filesystems mounted without writing to /etc/mtab file - refer to mount(8) for further details."
            },
            {
                "flag": "-V",
                "long": null,
                "arg": null,
                "description": "xfsgrowfs is most often used in conjunction with logical volumes (see md(4) and lvm(8) on Linux). However, it can also be used on a regular disk partition, for example if a partition has been enlarged while retaining the same starting block."
            }
        ],
        "examples": [],
        "see_also": [
            {
                "name": "mkfs.xfs",
                "section": "8",
                "url": "https://www.chedong.com/phpMan.php/man/mkfs.xfs/8/json"
            },
            {
                "name": "xfsinfo",
                "section": "8",
                "url": "https://www.chedong.com/phpMan.php/man/xfsinfo/8/json"
            },
            {
                "name": "md",
                "section": "4",
                "url": "https://www.chedong.com/phpMan.php/man/md/4/json"
            },
            {
                "name": "lvm",
                "section": "8",
                "url": "https://www.chedong.com/phpMan.php/man/lvm/8/json"
            },
            {
                "name": "mount",
                "section": "8",
                "url": "https://www.chedong.com/phpMan.php/man/mount/8/json"
            },
            {
                "name": "xfsgrowfs",
                "section": "8",
                "url": "https://www.chedong.com/phpMan.php/man/xfsgrowfs/8/json"
            }
        ],
        "section_outline": [
            {
                "name": "NAME",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "SYNOPSIS",
                "lines": 1,
                "subsections": [
                    {
                        "name": "-R",
                        "lines": 2,
                        "flag": "-R"
                    }
                ]
            },
            {
                "name": "DESCRIPTION",
                "lines": 6,
                "subsections": []
            },
            {
                "name": "OPTIONS",
                "lines": 1,
                "subsections": [
                    {
                        "name": "-d -D",
                        "lines": 6,
                        "flag": "-D"
                    },
                    {
                        "name": "-e",
                        "lines": 2,
                        "flag": "-e"
                    },
                    {
                        "name": "-i",
                        "lines": 2,
                        "flag": "-i"
                    },
                    {
                        "name": "-l -L",
                        "lines": 7,
                        "flag": "-L"
                    },
                    {
                        "name": "-m",
                        "lines": 2,
                        "flag": "-m"
                    },
                    {
                        "name": "-n",
                        "lines": 3,
                        "flag": "-n"
                    },
                    {
                        "name": "-r -R",
                        "lines": 6,
                        "flag": "-R"
                    },
                    {
                        "name": "-t",
                        "lines": 3,
                        "flag": "-t"
                    },
                    {
                        "name": "-V -V",
                        "lines": 4,
                        "flag": "-V"
                    }
                ]
            },
            {
                "name": "PRACTICAL USE",
                "lines": 5,
                "subsections": []
            },
            {
                "name": "SEE ALSO",
                "lines": 5,
                "subsections": []
            }
        ],
        "sections": {
            "NAME": {
                "content": "xfsgrowfs - expand an XFS filesystem\n",
                "subsections": []
            },
            "SYNOPSIS": {
                "content": "xfsgrowfs  [  -dilnrx ] [ -D size ] [ -e rtextsize ] [ -L size ] [ -m maxpct ] [ -t mtab ] [",
                "subsections": [
                    {
                        "name": "-R",
                        "content": "xfsgrowfs -V\n",
                        "flag": "-R"
                    }
                ]
            },
            "DESCRIPTION": {
                "content": "xfsgrowfs expands an existing XFS filesystem (see xfs(5)).  The mount-point argument is  the\npathname  of  the directory where the filesystem is mounted. The block-device argument is the\ndevice name of a mounted XFS filesystem.  The filesystem must be mounted  to  be  grown  (see\nmount(8)).   The existing contents of the filesystem are undisturbed, and the added space be‐\ncomes available for additional file storage.\n",
                "subsections": []
            },
            "OPTIONS": {
                "content": "",
                "subsections": [
                    {
                        "name": "-d -D",
                        "content": "Specifies that the data section of the filesystem should be resized. If  the  -D  size\noption  is given, the data section is changed to that size, otherwise the data section\nis grown to the largest size possible with the -d option. The  size  is  expressed  in\nfilesystem  blocks.  A  filesystem  with  only  1  AG  cannot be shrunk further, and a\nfilesystem cannot be shrunk to the point where it would only have 1 AG.\n",
                        "flag": "-D"
                    },
                    {
                        "name": "-e",
                        "content": "with -r extsize=nnnn.\n",
                        "flag": "-e"
                    },
                    {
                        "name": "-i",
                        "content": "implemented]\n",
                        "flag": "-i"
                    },
                    {
                        "name": "-l -L",
                        "content": "Specifies that the log section of the filesystem should be grown, shrunk, or moved. If\nthe  -L size option is given, the log section is changed to be that size, if possible.\nThe size is expressed in filesystem blocks.  The size  of  an  internal  log  must  be\nsmaller  than the size of an allocation group (this value is printed at mkfs(8) time).\nIf neither -i nor -x is given with -l, the log continues to be internal or external as\nit was before.  [NOTE: These options are not implemented]\n",
                        "flag": "-L"
                    },
                    {
                        "name": "-m",
                        "content": "allocated as inodes. In mkfs.xfs(8) this is specified with -i maxpct=nn.\n",
                        "flag": "-m"
                    },
                    {
                        "name": "-n",
                        "content": "printed,  and  argument checking is performed, but no growth occurs.  See output exam‐‐\nples below.\n",
                        "flag": "-n"
                    },
                    {
                        "name": "-r -R",
                        "content": "Specifies that the real-time section of the filesystem should be grown. If the -R size\noption  is given, the real-time section is grown to that size, otherwise the real-time\nsection is grown to the largest size possible with the -r  option.  The  size  is  ex‐\npressed  in filesystem blocks.  The filesystem does not need to have contained a real-\ntime section before the xfsgrowfs operation.\n",
                        "flag": "-R"
                    },
                    {
                        "name": "-t",
                        "content": "/etc/mtab).   This  is  used  when working with filesystems mounted without writing to\n/etc/mtab file - refer to mount(8) for further details.\n",
                        "flag": "-t"
                    },
                    {
                        "name": "-V -V",
                        "content": "xfsgrowfs is most often used in conjunction with logical volumes (see md(4)  and  lvm(8)  on\nLinux).  However, it can also be used on a regular disk partition, for example if a partition\nhas been enlarged while retaining the same starting block.\n",
                        "flag": "-V"
                    }
                ]
            },
            "PRACTICAL USE": {
                "content": "Filesystems normally occupy all of the space on the device where they  reside.  In  order  to\ngrow  a  filesystem, it is necessary to provide added space for it to occupy. Therefore there\nmust be at least one spare new disk partition available.  Adding  the  space  is  often  done\nthrough the use of a logical volume manager.\n",
                "subsections": []
            },
            "SEE ALSO": {
                "content": "mkfs.xfs(8), xfsinfo(8), md(4), lvm(8), mount(8).\n\n\n\nxfsgrowfs(8)",
                "subsections": []
            }
        }
    }
}