


MV(1L)                                                     MV(1L)


NNAAMMEE
       mv - rename files

SSYYNNOOPPSSIISS
       mmvv [options] source dest
       mmvv [options] source... directory
       Options:
       [-bfiuv]       [-S      backup-suffix]      [-V      {num-
       bered,existing,simple}] [--backup]  [--force]  [--interac-
       tive]   [--update]   [--verbose]  [--suffix=backup-suffix]
       [--version-control={numbered,existing,simple}]

DDEESSCCRRIIPPTTIIOONN
       This manual page documents the GNU version of mmvv.  If  the
       last  argument  names an existing directory, mmvv moves each
       other given file into a file with the same  name  in  that
       directory.   Otherwise,  if  only  two files are given, it
       moves the first onto the second.  It is an  error  if  the
       last  argument  is not a directory and more than two files
       are given.  It can move only regular files across filesys-
       tems.

       If a destination file is unwritable, the standard input is
       a tty, and the _-_f or  _-_-_f_o_r_c_e  option  is  not  given,  mmvv
       prompts  the  user  for whether to overwrite the file.  If
       the response does not begin with `y' or `Y', the  file  is
       skipped.

   OOPPTTIIOONNSS
       _-_b_, _-_-_b_a_c_k_u_p
              Make backups of files that are about to be removed.

       _-_f_, _-_-_f_o_r_c_e
              Remove existing destination files and never  prompt
              the user.

       _-_i_, _-_-_i_n_t_e_r_a_c_t_i_v_e
              Prompt  whether  to overwrite each destination file
              that already exists.   If  the  response  does  not
              begin with `y' or `Y', the file is skipped.

       _-_u_, _-_-_u_p_d_a_t_e
              Do  not  move  a  nondirectory that has an existing
              destination with the  same  or  newer  modification
              time.

       _-_v_, _-_-_v_e_r_b_o_s_e
              Print the name of each file before moving it.

       _-_S_, _-_-_s_u_f_f_i_x _b_a_c_k_u_p_-_s_u_f_f_i_x
              The  suffix used for making simple backup files can
              be set with  the  SSIIMMPPLLEE__BBAACCKKUUPP__SSUUFFFFIIXX  environment
              variable,  which  can be overridden by this option.
              If neither of those is given, the default  is  `~',



                                                                1





MV(1L)                                                     MV(1L)


              as it is in Emacs.

       _-_V_, _-_-_v_e_r_s_i_o_n_-_c_o_n_t_r_o_l _{_n_u_m_b_e_r_e_d_,_e_x_i_s_t_i_n_g_,_s_i_m_p_l_e_}
              The  type  of backups made can be set with the VVEERR--
              SSIIOONN__CCOONNTTRROOLL environment  variable,  which  can  be
              overridden  by  this option.  If VVEERRSSIIOONN__CCOONNTTRROOLL is
              not set and this option is not given,  the  default
              backup  type  is `existing'.  The value of the VVEERR--
              SSIIOONN__CCOONNTTRROOLL environment variable and the  argument
              to  this  option  are  like the GNU Emacs `version-
              control' variable;  they  also  recognize  synonyms
              that  are  more  descriptive.  The valid values are
              (unique abbreviations are accepted):

              `t' or `numbered'
                     Always make numbered backups.

              `nil' or `existing'
                     Make numbered backups of files that  already
                     have them, simple backups of the others.

              `never' or `simple'
                     Always make simple backups.

       The  long-named options can be introduced with `+' as well
       as `--', for compatibility with previous releases.   Even-
       tually  support  for  `+'  will  be removed, because it is
       incompatible with the POSIX.2 standard.





























                                                                2


