Debian Codegraph @

upstream/debian-trixie/man1/mv.1

raw
1 .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.50.1.
2 .TH MV "1" "June 2025" "GNU coreutils 9.7" "User Commands"
3 .SH NAME
4 mv \- move (rename) files
5 .SH SYNOPSIS
6 .B mv
7 [\fI\,OPTION\/\fR]... [\fI\,-T\/\fR] \fI\,SOURCE DEST\/\fR
8 .br
9 .B mv
10 [\fI\,OPTION\/\fR]... \fI\,SOURCE\/\fR... \fI\,DIRECTORY\/\fR
11 .br
12 .B mv
13 [\fI\,OPTION\/\fR]... \fI\,-t DIRECTORY SOURCE\/\fR...
14 .SH DESCRIPTION
15 .\" Add any additional description here
16 .PP
17 Rename SOURCE to DEST, or move SOURCE(s) to DIRECTORY.
18 .PP
19 Mandatory arguments to long options are mandatory for short options too.
20 .TP
21 \fB\-\-backup\fR[=\fI\,CONTROL\/\fR]
22 make a backup of each existing destination file
23 .TP
24 \fB\-b\fR
25 like \fB\-\-backup\fR but does not accept an argument
26 .TP
27 \fB\-\-debug\fR
28 explain how a file is copied. Implies \fB\-v\fR
29 .TP
30 \fB\-\-exchange\fR
31 exchange source and destination
32 .TP
33 \fB\-f\fR, \fB\-\-force\fR
34 do not prompt before overwriting
35 .TP
36 \fB\-i\fR, \fB\-\-interactive\fR
37 prompt before overwrite
38 .TP
39 \fB\-n\fR, \fB\-\-no\-clobber\fR
40 do not overwrite an existing file
41 .PP
42 If you specify more than one of \fB\-i\fR, \fB\-f\fR, \fB\-n\fR, only the final one takes effect.
43 .TP
44 \fB\-\-no\-copy\fR
45 do not copy if renaming fails
46 .TP
47 \fB\-\-strip\-trailing\-slashes\fR
48 remove any trailing slashes from each SOURCE
49 argument
50 .TP
51 \fB\-S\fR, \fB\-\-suffix\fR=\fI\,SUFFIX\/\fR
52 override the usual backup suffix
53 .TP
54 \fB\-t\fR, \fB\-\-target\-directory\fR=\fI\,DIRECTORY\/\fR
55 move all SOURCE arguments into DIRECTORY
56 .TP
57 \fB\-T\fR, \fB\-\-no\-target\-directory\fR
58 treat DEST as a normal file
59 .TP
60 \fB\-\-update\fR[=\fI\,UPDATE\/\fR]
61 control which existing files are updated;
62 UPDATE={all,none,none\-fail,older(default)}
63 .TP
64 \fB\-u\fR
65 equivalent to \fB\-\-update\fR[=\fI\,older\/\fR]. See below
66 .TP
67 \fB\-v\fR, \fB\-\-verbose\fR
68 explain what is being done
69 .TP
70 \fB\-Z\fR, \fB\-\-context\fR
71 set SELinux security context of destination
72 file to default type
73 .TP
74 \fB\-\-help\fR
75 display this help and exit
76 .TP
77 \fB\-\-version\fR
78 output version information and exit
79 .PP
80 UPDATE controls which existing files in the destination are replaced.
81 \&'all' is the default operation when an \fB\-\-update\fR option is not specified,
82 and results in all existing files in the destination being replaced.
83 \&'none' is like the \fB\-\-no\-clobber\fR option, in that no files in the
84 destination are replaced, and skipped files do not induce a failure.
85 \&'none\-fail' also ensures no files are replaced in the destination,
86 but any skipped files are diagnosed and induce a failure.
87 \&'older' is the default operation when \fB\-\-update\fR is specified, and results
88 in files being replaced if they're older than the corresponding source file.
89 .PP
90 The backup suffix is '~', unless set with \fB\-\-suffix\fR or SIMPLE_BACKUP_SUFFIX.
91 The version control method may be selected via the \fB\-\-backup\fR option or through
92 the VERSION_CONTROL environment variable. Here are the values:
93 .TP
94 none, off
95 never make backups (even if \fB\-\-backup\fR is given)
96 .TP
97 numbered, t
98 make numbered backups
99 .TP
100 existing, nil
101 numbered if numbered backups exist, simple otherwise
102 .TP
103 simple, never
104 always make simple backups
105 .SH AUTHOR
106 Written by Mike Parker, David MacKenzie, and Jim Meyering.
107 .SH "REPORTING BUGS"
108 GNU coreutils online help: <https://www.gnu.org/software/coreutils/>
109 .br
110 Report any translation bugs to <https://translationproject.org/team/>
111 .SH "SEE ALSO"
112 \fBrename\fP(2)
113 .PP
114 .br
115 Full documentation <https://www.gnu.org/software/coreutils/mv>
116 .br
117 or available locally via: info \(aq(coreutils) mv invocation\(aq
118 .PP
119 .br
120 Packaged by Debian (9.7\-3)
121 .br
122 Copyright \(co 2025 Free Software Foundation, Inc.
123 .br
124 License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
125 .br
126 This is free software: you are free to change and redistribute it.
127 .br
128 There is NO WARRANTY, to the extent permitted by law.