manual/GNU_coreutils/original/man1/mv.1

   1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
   2 .TH MV "1" "April 2010" "GNU coreutils 8.5" "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\-n\fR, \fB\-\-no\-clobber\fR
  34 do not overwrite an existing file
  35 .PP
  36 If you specify more than one of \fB\-i\fR, \fB\-f\fR, \fB\-n\fR, only the final one takes effect.
  37 .TP
  38 \fB\-\-strip\-trailing\-slashes\fR
  39 remove any trailing slashes from each SOURCE
  40 argument
  41 .TP
  42 \fB\-S\fR, \fB\-\-suffix\fR=\fISUFFIX\fR
  43 override the usual backup suffix
  44 .TP
  45 \fB\-t\fR, \fB\-\-target\-directory\fR=\fIDIRECTORY\fR
  46 move all SOURCE arguments into DIRECTORY
  47 .TP
  48 \fB\-T\fR, \fB\-\-no\-target\-directory\fR
  49 treat DEST as a normal file
  50 .TP
  51 \fB\-u\fR, \fB\-\-update\fR
  52 move only when the SOURCE file is newer
  53 than the destination file or when the
  54 destination file is missing
  55 .TP
  56 \fB\-v\fR, \fB\-\-verbose\fR
  57 explain what is being done
  58 .TP
  59 \fB\-\-help\fR
  60 display this help and exit
  61 .TP
  62 \fB\-\-version\fR
  63 output version information and exit
  64 .PP
  65 The backup suffix is `~', unless set with \fB\-\-suffix\fR or SIMPLE_BACKUP_SUFFIX.
  66 The version control method may be selected via the \fB\-\-backup\fR option or through
  67 the VERSION_CONTROL environment variable.  Here are the values:
  68 .TP
  69 none, off
  70 never make backups (even if \fB\-\-backup\fR is given)
  71 .TP
  72 numbered, t
  73 make numbered backups
  74 .TP
  75 existing, nil
  76 numbered if numbered backups exist, simple otherwise
  77 .TP
  78 simple, never
  79 always make simple backups
  80 .SH AUTHOR
  81 Written by Mike Parker, David MacKenzie, and Jim Meyering.
  82 .SH "REPORTING BUGS"
  83 Report mv bugs to bug\-coreutils@gnu.org
  84 .br
  85 GNU coreutils home page: <http://www.gnu.org/software/coreutils/>
  86 .br
  87 General help using GNU software: <http://www.gnu.org/gethelp/>
  88 .br
  89 Report mv translation bugs to <http://translationproject.org/team/>
  90 .SH COPYRIGHT
  91 Copyright \(co 2010 Free Software Foundation, Inc.
  92 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
  93 .br
  94 This is free software: you are free to change and redistribute it.
  95 There is NO WARRANTY, to the extent permitted by law.
  96 .SH "SEE ALSO"
  97 rename(2)
  98 .PP
  99 The full documentation for
 100 .B mv
 101 is maintained as a Texinfo manual.  If the
 102 .B info
 103 and
 104 .B mv
 105 programs are properly installed at your site, the command
 106 .IP
 107 .B info coreutils \(aqmv invocation\(aq
 108 .PP
 109 should give you access to the complete manual.