{
    "content": [
        {
            "type": "text",
            "text": "# mv(1) (man)\n\n## NAME\n\nmv - move (rename) files\n\n## SYNOPSIS\n\nmv [OPTION]... [-T] SOURCE DEST\nmv [OPTION]... SOURCE... DIRECTORY\nmv [OPTION]... -t DIRECTORY SOURCE...\n\n## DESCRIPTION\n\nRename SOURCE to DEST, or move SOURCE(s) to DIRECTORY.\n\n## TLDR\n\n> Move or rename files and directories.\n\n- Rename a file or directory when the target is not an existing directory:\n  `mv {{path/to/source}} {{path/to/target}}`\n- Move a file or directory into an existing directory:\n  `mv {{path/to/source}} {{path/to/existing_directory}}`\n- Move multiple files into an existing directory, keeping the filenames unchanged:\n  `mv {{path/to/source1 path/to/source2 ...}} {{path/to/existing_directory}}`\n- Do not prompt for confirmation before overwriting existing files:\n  `mv {{-f|--force}} {{path/to/source}} {{path/to/target}}`\n- Prompt for confirmation interactively before overwriting existing files, regardless of file permissions:\n  `mv {{-i|--interactive}} {{path/to/source}} {{path/to/target}}`\n- Do not overwrite existing files at the target:\n  `mv {{-n|--no-clobber}} {{path/to/source}} {{path/to/target}}`\n- Move files in verbose mode, showing files after they are moved:\n  `mv {{-v|--verbose}} {{path/to/source}} {{path/to/target}}`\n- Specify target directory so that you can use external tools to gather movable files:\n  `{{find /var/log -type f -name '*.log' -print0}} | {{xargs -0}} mv {{-t|--target-directory}} {{path/to/target_directory}}`\n\n*Source: tldr-pages*\n\n## Sections\n\n- **NAME**\n- **SYNOPSIS**\n- **DESCRIPTION** (12 subsections)\n- **AUTHOR**\n- **REPORTING BUGS**\n- **COPYRIGHT**\n- **SEE ALSO**\n\nUse structuredContent.sections for detailed options, examples, and full documentation.\n"
        }
    ],
    "structuredContent": {
        "command": "mv",
        "section": "1",
        "mode": "man",
        "summary": "mv - move (rename) files",
        "synopsis": "mv [OPTION]... [-T] SOURCE DEST\nmv [OPTION]... SOURCE... DIRECTORY\nmv [OPTION]... -t DIRECTORY SOURCE...",
        "tldr_summary": "Move or rename files and directories.",
        "tldr_examples": [
            {
                "description": "Rename a file or directory when the target is not an existing directory",
                "command": "mv {{path/to/source}} {{path/to/target}}"
            },
            {
                "description": "Move a file or directory into an existing directory",
                "command": "mv {{path/to/source}} {{path/to/existing_directory}}"
            },
            {
                "description": "Move multiple files into an existing directory, keeping the filenames unchanged",
                "command": "mv {{path/to/source1 path/to/source2 ...}} {{path/to/existing_directory}}"
            },
            {
                "description": "Do not prompt for confirmation before overwriting existing files",
                "command": "mv {{-f|--force}} {{path/to/source}} {{path/to/target}}"
            },
            {
                "description": "Prompt for confirmation interactively before overwriting existing files, regardless of file permissions",
                "command": "mv {{-i|--interactive}} {{path/to/source}} {{path/to/target}}"
            },
            {
                "description": "Do not overwrite existing files at the target",
                "command": "mv {{-n|--no-clobber}} {{path/to/source}} {{path/to/target}}"
            },
            {
                "description": "Move files in verbose mode, showing files after they are moved",
                "command": "mv {{-v|--verbose}} {{path/to/source}} {{path/to/target}}"
            },
            {
                "description": "Specify target directory so that you can use external tools to gather movable files",
                "command": "{{find /var/log -type f -name '*.log' -print0}} | {{xargs -0}} mv {{-t|--target-directory}} {{path/to/target_directory}}"
            }
        ],
        "tldr_source": "official",
        "flags": [
            {
                "flag": "-b",
                "long": "--backup",
                "arg": null,
                "description": ""
            },
            {
                "flag": "-f",
                "long": "--force",
                "arg": null,
                "description": "do not prompt before overwriting"
            },
            {
                "flag": "-i",
                "long": "--interactive",
                "arg": null,
                "description": "prompt before overwrite"
            },
            {
                "flag": "-n",
                "long": "--no-clobber",
                "arg": null,
                "description": "do not overwrite an existing file If you specify more than one of -i, -f, -n, only the final one takes effect."
            },
            {
                "flag": "",
                "long": "--strip-trailing-slashes",
                "arg": null,
                "description": "remove any trailing slashes from each SOURCE argument"
            },
            {
                "flag": "-S",
                "long": "--suffix",
                "arg": null,
                "description": "override the usual backup suffix"
            },
            {
                "flag": "-t",
                "long": "--target-directory",
                "arg": null,
                "description": "move all SOURCE arguments into DIRECTORY"
            },
            {
                "flag": "-T",
                "long": "--no-target-directory",
                "arg": null,
                "description": "treat DEST as a normal file"
            },
            {
                "flag": "-u",
                "long": "--update",
                "arg": null,
                "description": "move only when the SOURCE file is newer than the destination file or when the destina‐ tion file is missing"
            },
            {
                "flag": "-v",
                "long": "--verbose",
                "arg": null,
                "description": "explain what is being done"
            },
            {
                "flag": "-Z",
                "long": "--context",
                "arg": null,
                "description": "set SELinux security context of destination file to default type --help display this help and exit"
            },
            {
                "flag": "",
                "long": "--version",
                "arg": null,
                "description": "output version information and exit The backup suffix is '~', unless set with --suffix or SIMPLEBACKUPSUFFIX. The version con‐ trol method may be selected via the --backup option or through the VERSIONCONTROL environ‐ ment variable. Here are the values: none, off never make backups (even if --backup is given) numbered, t make numbered backups existing, nil numbered if numbered backups exist, simple otherwise simple, never always make simple backups"
            }
        ],
        "examples": [],
        "see_also": [
            {
                "name": "rename",
                "section": "2",
                "url": "https://www.chedong.com/phpMan.php/man/rename/2/json"
            }
        ],
        "section_outline": [
            {
                "name": "NAME",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "SYNOPSIS",
                "lines": 4,
                "subsections": []
            },
            {
                "name": "DESCRIPTION",
                "lines": 7,
                "subsections": [
                    {
                        "name": "-b --backup",
                        "lines": 1,
                        "flag": "-b",
                        "long": "--backup"
                    },
                    {
                        "name": "-f --force",
                        "lines": 2,
                        "flag": "-f",
                        "long": "--force"
                    },
                    {
                        "name": "-i --interactive",
                        "lines": 2,
                        "flag": "-i",
                        "long": "--interactive"
                    },
                    {
                        "name": "-n --no-clobber",
                        "lines": 4,
                        "flag": "-n",
                        "long": "--no-clobber"
                    },
                    {
                        "name": "--strip-trailing-slashes",
                        "lines": 2,
                        "long": "--strip-trailing-slashes"
                    },
                    {
                        "name": "-S --suffix",
                        "lines": 2,
                        "flag": "-S",
                        "long": "--suffix"
                    },
                    {
                        "name": "-t --target-directory",
                        "lines": 2,
                        "flag": "-t",
                        "long": "--target-directory"
                    },
                    {
                        "name": "-T --no-target-directory",
                        "lines": 2,
                        "flag": "-T",
                        "long": "--no-target-directory"
                    },
                    {
                        "name": "-u --update",
                        "lines": 3,
                        "flag": "-u",
                        "long": "--update"
                    },
                    {
                        "name": "-v --verbose",
                        "lines": 2,
                        "flag": "-v",
                        "long": "--verbose"
                    },
                    {
                        "name": "-Z --context",
                        "lines": 4,
                        "flag": "-Z",
                        "long": "--context"
                    },
                    {
                        "name": "--version",
                        "lines": 18,
                        "long": "--version"
                    }
                ]
            },
            {
                "name": "AUTHOR",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "REPORTING BUGS",
                "lines": 3,
                "subsections": []
            },
            {
                "name": "COPYRIGHT",
                "lines": 5,
                "subsections": []
            },
            {
                "name": "SEE ALSO",
                "lines": 8,
                "subsections": []
            }
        ],
        "sections": {
            "NAME": {
                "content": "mv - move (rename) files\n",
                "subsections": []
            },
            "SYNOPSIS": {
                "content": "mv [OPTION]... [-T] SOURCE DEST\nmv [OPTION]... SOURCE... DIRECTORY\nmv [OPTION]... -t DIRECTORY SOURCE...\n",
                "subsections": []
            },
            "DESCRIPTION": {
                "content": "Rename SOURCE to DEST, or move SOURCE(s) to DIRECTORY.\n\nMandatory arguments to long options are mandatory for short options too.\n\n--backup[=CONTROL]\nmake a backup of each existing destination file\n",
                "subsections": [
                    {
                        "name": "-b --backup",
                        "content": "",
                        "flag": "-b",
                        "long": "--backup"
                    },
                    {
                        "name": "-f --force",
                        "content": "do not prompt before overwriting\n",
                        "flag": "-f",
                        "long": "--force"
                    },
                    {
                        "name": "-i --interactive",
                        "content": "prompt before overwrite\n",
                        "flag": "-i",
                        "long": "--interactive"
                    },
                    {
                        "name": "-n --no-clobber",
                        "content": "do not overwrite an existing file\n\nIf you specify more than one of -i, -f, -n, only the final one takes effect.\n",
                        "flag": "-n",
                        "long": "--no-clobber"
                    },
                    {
                        "name": "--strip-trailing-slashes",
                        "content": "remove any trailing slashes from each SOURCE argument\n",
                        "long": "--strip-trailing-slashes"
                    },
                    {
                        "name": "-S --suffix",
                        "content": "override the usual backup suffix\n",
                        "flag": "-S",
                        "long": "--suffix"
                    },
                    {
                        "name": "-t --target-directory",
                        "content": "move all SOURCE arguments into DIRECTORY\n",
                        "flag": "-t",
                        "long": "--target-directory"
                    },
                    {
                        "name": "-T --no-target-directory",
                        "content": "treat DEST as a normal file\n",
                        "flag": "-T",
                        "long": "--no-target-directory"
                    },
                    {
                        "name": "-u --update",
                        "content": "move only when the SOURCE file is newer than the destination file or when the destina‐\ntion file is missing\n",
                        "flag": "-u",
                        "long": "--update"
                    },
                    {
                        "name": "-v --verbose",
                        "content": "explain what is being done\n",
                        "flag": "-v",
                        "long": "--verbose"
                    },
                    {
                        "name": "-Z --context",
                        "content": "set SELinux security context of destination file to default type\n\n--help display this help and exit\n",
                        "flag": "-Z",
                        "long": "--context"
                    },
                    {
                        "name": "--version",
                        "content": "output version information and exit\n\nThe backup suffix is '~', unless set with --suffix or SIMPLEBACKUPSUFFIX.  The version con‐\ntrol  method  may be selected via the --backup option or through the VERSIONCONTROL environ‐\nment variable.  Here are the values:\n\nnone, off\nnever make backups (even if --backup is given)\n\nnumbered, t\nmake numbered backups\n\nexisting, nil\nnumbered if numbered backups exist, simple otherwise\n\nsimple, never\nalways make simple backups\n",
                        "long": "--version"
                    }
                ]
            },
            "AUTHOR": {
                "content": "Written by Mike Parker, David MacKenzie, and Jim Meyering.\n",
                "subsections": []
            },
            "REPORTING BUGS": {
                "content": "GNU coreutils online help: <https://www.gnu.org/software/coreutils/>\nReport any translation bugs to <https://translationproject.org/team/>\n",
                "subsections": []
            },
            "COPYRIGHT": {
                "content": "Copyright © 2020 Free Software Foundation, Inc.  License GPLv3+: GNU GPL version 3  or  later\n<https://gnu.org/licenses/gpl.html>.\nThis  is free software: you are free to change and redistribute it.  There is NO WARRANTY, to\nthe extent permitted by law.\n",
                "subsections": []
            },
            "SEE ALSO": {
                "content": "rename(2)\n\nFull documentation <https://www.gnu.org/software/coreutils/mv>\nor available locally via: info '(coreutils) mv invocation'\n\n\n\nGNU coreutils 8.32                          January 2026                                       MV(1)",
                "subsections": []
            }
        }
    }
}