{
    "mode": "info",
    "parameter": "VGCFGBACKUP",
    "section": "",
    "url": "https://www.chedong.com/phpMan.php/info/VGCFGBACKUP/json",
    "generated": "2026-07-05T15:54:54Z",
    "synopsis": "vgcfgbackup\n[ optionargs ]\n[ positionargs ]",
    "sections": {
        "NAME": {
            "content": "vgcfgbackup - Backup volume group configuration(s)\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "vgcfgbackup\n[ optionargs ]\n[ positionargs ]\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "vgcfgbackup  creates  back  up files containing metadata of VGs.  If no\nVGs are named, back up files are created for all VGs.  See vgcfgrestore\nfor information on using the back up files.\n\nIn  a  default  installation, each VG is backed up into a separate file\nbearing the name of the VG in the directory /etc/lvm/backup.\n\nTo use an alternative back up file, use -f. In this case, when  backing\nup  multiple  VGs,  the file name is treated as a template, with %s re-\nplaced by the VG name.\n\nNB. This DOES NOT back up the data content of LVs.\n\nIt may also be useful to regularly back up the files in /etc/lvm.\n",
            "subsections": []
        },
        "USAGE": {
            "content": "vgcfgbackup\n[ -f|--file String ]\n[    --foreign ]\n[    --ignorelockingfailure ]\n[    --readonly ]\n[    --reportformat basic|json ]\n[ COMMONOPTIONS ]\n[ VG ... ]\n\nCommon options for lvm:\n[ -d|--debug ]\n[ -h|--help ]\n[ -q|--quiet ]\n[ -t|--test ]\n[ -v|--verbose ]\n[ -y|--yes ]\n[    --commandprofile String ]\n[    --config String ]\n[    --driverloaded y|n ]\n[    --lockopt String ]\n[    --longhelp ]\n[    --nolocking ]\n[    --profile String ]\n[    --version ]\n",
            "subsections": []
        },
        "OPTIONS": {
            "content": "--commandprofile String\nThe command profile to use for command configuration.  See\nlvm.conf(5) for more information about profiles.\n\n--config String\nConfig settings for the command. These override lvm.conf set-\ntings.  The String arg uses the same format as lvm.conf, or may\nuse section/field syntax.  See lvm.conf(5) for more information\nabout config.\n\n-d|--debug ...\nSet debug level. Repeat from 1 to 6 times to increase the detail\nof messages sent to the log file and/or syslog (if configured).\n\n--driverloaded y|n\nIf set to no, the command will not attempt to use device-mapper.\nFor testing and debugging.\n\n-f|--file String\nWrite the backup to the named file.  When backing up more than\none VG, the file name is treated as a template, and %s is re-\nplaced by the VG name.\n",
            "subsections": [
                {
                    "name": "--foreign",
                    "content": "Report/display foreign VGs that would otherwise be skipped.  See\nlvmsystemid(7) for more information about foreign VGs.\n\n-h|--help\nDisplay help text.\n",
                    "long": "--foreign"
                },
                {
                    "name": "--ignorelockingfailure",
                    "content": "Allows a command to continue with read-only metadata operations\nafter locking failures.\n\n--lockopt String\nUsed to pass options for special cases to lvmlockd.  See lvm-\nlockd(8) for more information.\n",
                    "long": "--ignorelockingfailure"
                },
                {
                    "name": "--longhelp",
                    "content": "Display long help text.\n",
                    "long": "--longhelp"
                },
                {
                    "name": "--nolocking",
                    "content": "Disable locking.\n\n--profile String\nAn alias for --commandprofile or --metadataprofile, depending on\nthe command.\n\n-q|--quiet ...\nSuppress output and log messages. Overrides --debug and --ver-\nbose.  Repeat once to also suppress any prompts with answer\n'no'.\n",
                    "long": "--nolocking"
                },
                {
                    "name": "--readonly",
                    "content": "Run the command in a special read-only mode which will read on-\ndisk metadata without needing to take any locks. This can be\nused to peek inside metadata used by a virtual machine image\nwhile the virtual machine is running. No attempt will be made to\ncommunicate with the device-mapper kernel driver, so this option\nis unable to report whether or not LVs are actually in use.\n\n--reportformat basic|json\nOverrides current output format for reports which is defined\nglobally by the report/outputformat setting in lvm.conf.  basic\nis the original format with columns and rows.  If there is more\nthan one report per command, each report is prefixed with the\nreport name for identification. json produces report output in\nJSON format. See lvmreport(7) for more information.\n\n-t|--test\nRun in test mode. Commands will not update metadata.  This is\nimplemented by disabling all metadata writing but nevertheless\nreturning success to the calling function. This may lead to un-\nusual error messages in multi-stage operations if a tool relies\non reading back metadata it believes has changed but hasn't.\n\n-v|--verbose ...\nSet verbose level. Repeat from 1 to 4 times to increase the de-\ntail of messages sent to stdout and stderr.\n",
                    "long": "--readonly"
                },
                {
                    "name": "--version",
                    "content": "Display version information.\n\n-y|--yes\nDo not prompt for confirmation interactively but always assume\nthe answer yes. Use with extreme caution.  (For automatic no,\nsee -qq.)\n",
                    "long": "--version"
                }
            ]
        },
        "VARIABLES": {
            "content": "VG\nVolume Group name.  See lvm(8) for valid names.\n\nString\nSee the option description for information about the string con-\ntent.\n\nSize[UNIT]\nSize is an input number that accepts an  optional  unit.   Input\nunits are always treated as base two values, regardless of capi-\ntalization, e.g. 'k' and 'K' both refer to  1024.   The  default\ninput unit is specified by letter, followed by |UNIT.  UNIT rep-\nresents other possible input units:  bBsSkKmMgGtTpPeE.   b|B  is\nbytes,  s|S is sectors of 512 bytes, k|K is KiB, m|M is MiB, g|G\nis GiB, t|T is TiB, p|P is PiB, e|E is EiB.  (This should not be\nconfused  with the output control --units, where capital letters\nmean multiple of 1000.)\n",
            "subsections": []
        },
        "ENVIRONMENT VARIABLES": {
            "content": "See lvm(8) for information about environment  variables  used  by  lvm.\nFor example, LVMVGNAME can generally be substituted for a required VG\nparameter.\n",
            "subsections": []
        },
        "SEE ALSO": {
            "content": "lvm(8) lvm.conf(5) lvmconfig(8)\n\npvchange(8)  pvck(8)  pvcreate(8)  pvdisplay(8)  pvmove(8)  pvremove(8)\npvresize(8) pvs(8) pvscan(8)\n\nvgcfgbackup(8)  vgcfgrestore(8)  vgchange(8) vgck(8) vgcreate(8) vgcon-\nvert(8)  vgdisplay(8)  vgexport(8)  vgextend(8)  vgimport(8)  vgimport-\nclone(8)  vgmerge(8)  vgmknodes(8)  vgreduce(8) vgremove(8) vgrename(8)\nvgs(8) vgscan(8) vgsplit(8)\n\nlvcreate(8) lvchange(8)  lvconvert(8)  lvdisplay(8)  lvextend(8)  lvre-\nduce(8) lvremove(8) lvrename(8) lvresize(8) lvs(8) lvscan(8)\n\nlvm-fullreport(8) lvm-lvpoll(8) lvm2-activation-generator(8) blkdeacti-\nvate(8) lvmdump(8)\n\ndmeventd(8) lvmpolld(8)  lvmlockd(8)  lvmlockctl(8)  cmirrord(8)  lvmd-\nbusd(8)\n\nlvmsystemid(7) lvmreport(7) lvmraid(7) lvmthin(7) lvmcache(7)\n\nRed Hat, Inc.          LVM TOOLS 2.03.11(2) (2021-01-08)        VGCFGBACKUP(8)",
            "subsections": []
        }
    },
    "summary": "vgcfgbackup - Backup volume group configuration(s)",
    "flags": [
        {
            "flag": "",
            "long": "--foreign",
            "arg": null,
            "description": "Report/display foreign VGs that would otherwise be skipped. See lvmsystemid(7) for more information about foreign VGs. -h|--help Display help text."
        },
        {
            "flag": "",
            "long": "--ignorelockingfailure",
            "arg": null,
            "description": "Allows a command to continue with read-only metadata operations after locking failures. --lockopt String Used to pass options for special cases to lvmlockd. See lvm- lockd(8) for more information."
        },
        {
            "flag": "",
            "long": "--longhelp",
            "arg": null,
            "description": "Display long help text."
        },
        {
            "flag": "",
            "long": "--nolocking",
            "arg": null,
            "description": "Disable locking. --profile String An alias for --commandprofile or --metadataprofile, depending on the command. -q|--quiet ... Suppress output and log messages. Overrides --debug and --ver- bose. Repeat once to also suppress any prompts with answer 'no'."
        },
        {
            "flag": "",
            "long": "--readonly",
            "arg": null,
            "description": "Run the command in a special read-only mode which will read on- disk metadata without needing to take any locks. This can be used to peek inside metadata used by a virtual machine image while the virtual machine is running. No attempt will be made to communicate with the device-mapper kernel driver, so this option is unable to report whether or not LVs are actually in use. --reportformat basic|json Overrides current output format for reports which is defined globally by the report/outputformat setting in lvm.conf. basic is the original format with columns and rows. If there is more than one report per command, each report is prefixed with the report name for identification. json produces report output in JSON format. See lvmreport(7) for more information. -t|--test Run in test mode. Commands will not update metadata. This is implemented by disabling all metadata writing but nevertheless returning success to the calling function. This may lead to un- usual error messages in multi-stage operations if a tool relies on reading back metadata it believes has changed but hasn't. -v|--verbose ... Set verbose level. Repeat from 1 to 4 times to increase the de- tail of messages sent to stdout and stderr."
        },
        {
            "flag": "",
            "long": "--version",
            "arg": null,
            "description": "Display version information. -y|--yes Do not prompt for confirmation interactively but always assume the answer yes. Use with extreme caution. (For automatic no, see -qq.)"
        }
    ],
    "examples": [],
    "see_also": [
        {
            "name": "lvm",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/lvm/8/json"
        },
        {
            "name": "lvm.conf",
            "section": "5",
            "url": "https://www.chedong.com/phpMan.php/man/lvm.conf/5/json"
        },
        {
            "name": "lvmconfig",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/lvmconfig/8/json"
        },
        {
            "name": "pvchange",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/pvchange/8/json"
        },
        {
            "name": "pvck",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/pvck/8/json"
        },
        {
            "name": "pvcreate",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/pvcreate/8/json"
        },
        {
            "name": "pvdisplay",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/pvdisplay/8/json"
        },
        {
            "name": "pvmove",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/pvmove/8/json"
        },
        {
            "name": "pvremove",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/pvremove/8/json"
        },
        {
            "name": "pvresize",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/pvresize/8/json"
        },
        {
            "name": "pvs",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/pvs/8/json"
        },
        {
            "name": "pvscan",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/pvscan/8/json"
        },
        {
            "name": "vgcfgbackup",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/vgcfgbackup/8/json"
        },
        {
            "name": "vgcfgrestore",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/vgcfgrestore/8/json"
        },
        {
            "name": "vgchange",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/vgchange/8/json"
        },
        {
            "name": "vgck",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/vgck/8/json"
        },
        {
            "name": "vgcreate",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/vgcreate/8/json"
        },
        {
            "name": "vert",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/vert/8/json"
        },
        {
            "name": "vgdisplay",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/vgdisplay/8/json"
        },
        {
            "name": "vgexport",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/vgexport/8/json"
        },
        {
            "name": "vgextend",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/vgextend/8/json"
        },
        {
            "name": "vgimport",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/vgimport/8/json"
        },
        {
            "name": "clone",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/clone/8/json"
        },
        {
            "name": "vgmerge",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/vgmerge/8/json"
        },
        {
            "name": "vgmknodes",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/vgmknodes/8/json"
        },
        {
            "name": "vgreduce",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/vgreduce/8/json"
        },
        {
            "name": "vgremove",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/vgremove/8/json"
        },
        {
            "name": "vgrename",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/vgrename/8/json"
        },
        {
            "name": "vgs",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/vgs/8/json"
        },
        {
            "name": "vgscan",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/vgscan/8/json"
        },
        {
            "name": "vgsplit",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/vgsplit/8/json"
        },
        {
            "name": "lvcreate",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/lvcreate/8/json"
        },
        {
            "name": "lvchange",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/lvchange/8/json"
        },
        {
            "name": "lvconvert",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/lvconvert/8/json"
        },
        {
            "name": "lvdisplay",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/lvdisplay/8/json"
        },
        {
            "name": "lvextend",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/lvextend/8/json"
        },
        {
            "name": "duce",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/duce/8/json"
        },
        {
            "name": "lvremove",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/lvremove/8/json"
        },
        {
            "name": "lvrename",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/lvrename/8/json"
        },
        {
            "name": "lvresize",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/lvresize/8/json"
        },
        {
            "name": "lvs",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/lvs/8/json"
        },
        {
            "name": "lvscan",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/lvscan/8/json"
        },
        {
            "name": "lvm-fullreport",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/lvm-fullreport/8/json"
        },
        {
            "name": "lvm-lvpoll",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/lvm-lvpoll/8/json"
        },
        {
            "name": "lvm2-activation-generator",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/lvm2-activation-generator/8/json"
        },
        {
            "name": "vate",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/vate/8/json"
        },
        {
            "name": "lvmdump",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/lvmdump/8/json"
        },
        {
            "name": "dmeventd",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/dmeventd/8/json"
        },
        {
            "name": "lvmpolld",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/lvmpolld/8/json"
        },
        {
            "name": "lvmlockd",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/lvmlockd/8/json"
        },
        {
            "name": "lvmlockctl",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/lvmlockctl/8/json"
        },
        {
            "name": "cmirrord",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/cmirrord/8/json"
        },
        {
            "name": "busd",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/busd/8/json"
        },
        {
            "name": "lvmsystemid",
            "section": "7",
            "url": "https://www.chedong.com/phpMan.php/man/lvmsystemid/7/json"
        },
        {
            "name": "lvmreport",
            "section": "7",
            "url": "https://www.chedong.com/phpMan.php/man/lvmreport/7/json"
        },
        {
            "name": "lvmraid",
            "section": "7",
            "url": "https://www.chedong.com/phpMan.php/man/lvmraid/7/json"
        },
        {
            "name": "lvmthin",
            "section": "7",
            "url": "https://www.chedong.com/phpMan.php/man/lvmthin/7/json"
        },
        {
            "name": "lvmcache",
            "section": "7",
            "url": "https://www.chedong.com/phpMan.php/man/lvmcache/7/json"
        }
    ]
}