4.3BSD-Reno/share/man/cat1/mv.0

MV(1)			    UNIX Reference Manual			 MV(1)

NNAAMMEE
     mmvv - move files

SSYYNNOOPPSSIISS
     mmvv [--ff | --ii] _s_o_u_r_c_e _t_a_r_g_e_t
     mmvv [--ff | --ii] _s_o_u_r_c_e ... _s_o_u_r_c_e _d_i_r_e_c_t_o_r_y

DDEESSCCRRIIPPTTIIOONN
     In its first form, the mmvv utility renames the file named by the _s_o_u_r_c_e
     operand to the destination path named by the _t_a_r_g_e_t operand.  This form
     is assumed when the last operand does not name an already existing direc-
     tory.

     In its second form, mmvv moves each file named by a _s_o_u_r_c_e operand to a
     destination file in the existing directory named by the _d_i_r_e_c_t_o_r_y
     operand.  The destination path for each operand is the pathname produced
     by the concatenation of the last operand, a slash, and the final pathname
     component of the named file.

     The following options are available:

     --ff    Do not prompt for confirmation before overwriting the destination
	   path.  (The --ii option is ignored if the --ff option is specified.)

     --ii    Causes mmvv to write a prompt to standard error before moving a file
	   that would overwrite an existing file.  If the response from the
	   standard input begins with the character ``y'', the move is at-
	   tempted.

     It is an error for either the _s_o_u_r_c_e operand or the destination path to
     specify a directory unless both do.

     If the destination path does not have a mode which permits writing, mmvv
     prompts the user for confirmation as specified for the --ii option.

     As the rename(2) call does not work across file systems, mmvv uses cp(1)
     and rm(1) to accomplish the move.	The effect is equivalent to:

	   rm -f destination_path && \
	   cp -pr source_file destination && \
	   rm -rf source_file

     The mmvv utility exits 0 on success, and >0 if an error occurs.

SSEEEE AALLSSOO
     cp(1)

SSTTAANNDDAARRDDSS
     The mmvv function is expected to be POSIX 1003.2 compatible.