mv(1)                          DG/UX R4.11MU05                         mv(1)


NAME
       mv - move files

SYNOPSIS
       mv [ -f ] [ -i ] file1 [ file2 ...] target

DESCRIPTION
       The mv command moves filen to target.  filen and target may not have
       the same name.  (Care must be taken when using sh(1) metacharacters).
       If target is not a directory, only one file may be specified before
       it; if it is a directory, more than one file may be specified.  If
       target does not exist, mv creates a file named target.  If target
       exists and is not a directory, its contents are overwritten.  If
       target is a directory the file(s) are moved to that directory.

       If mv determines that the mode of target forbids writing, it will
       print the mode (see chmod(2)), ask for a response, and read the
       standard input for one line.  If the line begins with y, the mv
       occurs, if permissible; otherwise, the command exits.  When the
       parent directory of filen is writable and has the sticky bit set, one
       or more of the following conditions must be true:

            the user must own the file
            the user must own the directory
            the file must be writable by the user
            the user must be a privileged user

       The following options are recognized:


       -i     mv will prompt for confirmation whenever the move would
              overwrite an existing target.  A y answer means that the move
              should proceed.  Any other answer prevents mv from overwriting
              the target.

       -f     mv will move the file(s) without prompting even if it is
              writing over an existing target.  This option overrides the -i
              option.  Note that this is the default if the standard input
              is not a terminal.

       If filen is a directory, target must be a directory in the same
       physical file system.  target and filen do not have to share the same
       parent directory.

       If filen is a file and target is a link to another file with links,
       the other links remain and target becomes a new file.

       If filen is a directory and target is a Control Point Directory (CPD)
       or a directory under a Control Point Directory (CPD), then the mv
       will fail.  This is because the mv could result in hard links
       crossing CPD boundaries which would put the CPD in an inconsistent
       state.

       On a system with DG/UX information security, the process must have
       MAC write access to both the target and filen, or to the directory
       containing target if target does not exist.  With DG/UX information
       security, you must have appropriate privilege to use mv.  On systems
       with information security, appropriate privilege is defined as having
       one or more specific capabilities enabled in the effective capability
       set of the user.  See capdefaults(5) for the default capabilities
       for this command.

       On a generic DG/UX system, appropriate privilege means that your
       process has an effective UID of root.  See the
       appropriateprivilege(5) man page for more information.

       If filen and target are on different file systems, mv will, on a
       generic DG/UX system, copy the file and delete the original; on a
       system with DG/UX information security, it will copy the file,
       preserving its security attributes, and delete the original.  Any
       links to other files are lost.

       A -- permits the user to mark explicitly the end of any command line
       options, allowing mv to recognize filename arguments that begin with
       a -.  As an aid to BSD migration, mv will accept - as a synonym for
       --.  This migration aid may disappear in a future release.  If a --
       and a - both appear on the same command line, the second will be
       interpreted as a filename.

SEE ALSO
       chmod(1), cp(1), cpio(1), ln(1), rm(1), capdefaults(5).


Licensed material--property of copyright holder(s)