man/mv.1

   1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
   2 .TH MV "1" "March 2007" "GNU coreutils 6.9" "User Commands"
   3 .SH NAME
   4 mv \- move (rename) files
   5 .SH SYNOPSIS
   6 .B mv
   7 [\fIOPTION\fR]... [\fI-T\fR] \fISOURCE DEST\fR
   8 .br
   9 .B mv
  10 [\fIOPTION\fR]... \fISOURCE\fR... \fIDIRECTORY\fR
  11 .br
  12 .B mv
  13 [\fIOPTION\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[=\fICONTROL\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\-f\fR, \fB\-\-force\fR
  28 do not prompt before overwriting
  29 .TP
  30 \fB\-i\fR, \fB\-\-interactive\fR
  31 prompt before overwrite
  32 .TP
  33 \fB\-\-strip\-trailing\-slashes\fR
  34 remove any trailing slashes from each SOURCE
  35 argument
  36 .TP
  37 \fB\-S\fR, \fB\-\-suffix\fR=\fISUFFIX\fR
  38 override the usual backup suffix
  39 .TP
  40 \fB\-t\fR, \fB\-\-target\-directory\fR=\fIDIRECTORY\fR
  41 move all SOURCE arguments into DIRECTORY
  42 .TP
  43 \fB\-T\fR, \fB\-\-no\-target\-directory\fR
  44 treat DEST as a normal file
  45 .TP
  46 \fB\-u\fR, \fB\-\-update\fR
  47 move only when the SOURCE file is newer
  48 than the destination file or when the
  49 destination file is missing
  50 .TP
  51 \fB\-v\fR, \fB\-\-verbose\fR
  52 explain what is being done
  53 .TP
  54 \fB\-\-help\fR
  55 display this help and exit
  56 .TP
  57 \fB\-\-version\fR
  58 output version information and exit
  59 .PP
  60 The backup suffix is `~', unless set with \fB\-\-suffix\fR or SIMPLE_BACKUP_SUFFIX.
  61 The version control method may be selected via the \fB\-\-backup\fR option or through
  62 the VERSION_CONTROL environment variable.  Here are the values:
  63 .TP
  64 none, off
  65 never make backups (even if \fB\-\-backup\fR is given)
  66 .TP
  67 numbered, t
  68 make numbered backups
  69 .TP
  70 existing, nil
  71 numbered if numbered backups exist, simple otherwise
  72 .TP
  73 simple, never
  74 always make simple backups
  75 .SH AUTHOR
  76 Written by Mike Parker, David MacKenzie, and Jim Meyering.
  77 .SH "REPORTING BUGS"
  78 Report bugs to <bug\-coreutils@gnu.org>.
  79 .SH COPYRIGHT
  80 Copyright \(co 2007 Free Software Foundation, Inc.
  81 .br
  82 This is free software.  You may redistribute copies of it under the terms of
  83 the GNU General Public License <http://www.gnu.org/licenses/gpl.html>.
  84 There is NO WARRANTY, to the extent permitted by law.
  85 .SH "SEE ALSO"
  86 rename(2)
  87 .PP
  88 The full documentation for
  89 .B mv
  90 is maintained as a Texinfo manual.  If the
  91 .B info
  92 and
  93 .B mv
  94 programs are properly installed at your site, the command
  95 .IP
  96 .B info mv
  97 .PP
  98 should give you access to the complete manual.