


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}]	[--help]
       [--version]

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.

       _-_-_h_e_l_p Print a usage message and exit with a non-zero sta-
	      tus.





FSF			GNU File Utilities			1





MV(1L)							MV(1L)


       _-_-_v_e_r_s_i_o_n
	      Print  version  information  on standard error then
	      exit.

       _-_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 `~',
	      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.

























FSF			GNU File Utilities			2


