Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ mvf — Apollo

Media Vault

Software Library

Restoration Projects

Artifacts Sought

6.0a;mvf (move_file), revision 6.0a, 87/03/20
MVF (MOVE_FILE) -- Move a file.
usage:  MVF source destination [-C|-R] [-DU] [-F] [-CHN] [-LF [-LDL]] {CL}


FORMAT

  MVF source [destination] ... [options]


  MVF  moves  a  file to a different location in the naming tree.  Its effect is
  identical to

      $ CPF source destination           copy source to destination
      $ DLF source                       delete the source

  MVF always retains the source ACL on objects moved.


ARGUMENTS

  source
  (required)          Specify  name  of  file  to  be  moved.    Wildcarding  is
                     permitted.

  destination
  (optional)          Specify new file location.  This pathname may be a derived
                     name.  If 'destination' is a directory, the  command  moves
                     the  source file into that directory.  Otherwise it creates
                     the new file using the name specified.

                     Default if omitted:  copy source to current working
                                          directory

  Multiple source/target pairs and wildcarding are permitted.


OPTIONS

  Default options are indicated by "(D)."

  -C           (D)   Create the target file.  If the target file already exists,
                     an error will result.

  -R                  Replace  target file with source file.  Use this option if
                     the target file already exists.    If  the  file  does  not
                     exist, this option works like -C.

  -DU                 Delete  when unlocked.  This option is useful with -R.  If
                     the object to be replaced is locked when  MVF  is  invoked,
                     the  replace operation will be performed when the object is
                     unlocked.

  -F                 Force deletion  of  destination  object  if  you  have  'p'
                     (protect)  rights,  even  if  you  do not have 'd' (delete)
                     rights.

  -LF                List files moved.

  -LDL               List files deleted by -R option.

  -CHN                Change  the  name  of  an  existing  destination  file  if
                     required.    This option modifies the meaning of -C and -R.
                     If -C is specified, this option causes any existing  object
                     with  the  destination  pathname to be renamed prior to the
                     move.  If  -R  is  specified,  the  destination  object  is
                     renamed if it is in use and cannot be deleted.

  This  command  uses  the command line parser, and so also accepts the standard
  command options listed in HELP CL.


EXAMPLES

  $ mvf //anger/sam/letter //mary -r       Move the file "letter" from the
                                            directory "//anger/sam" to the
                                            directory "//mary" and replace
                                            the current file.

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026