# move

## Description

Move a file or fileset to a new file or directory.

## Parameters

file
  Description: File to be moved

  Domain: Valid filename pointing to existing file

  Default: -

to_file
  Description: File to move to

  Domain: Valid filename

  Default: -

to_directory
  Description: Directory to which file(s) should be moved to

  Domain: Valid directoryname pointing to existing directory

  Default: -

## RNG Specification

      <define name="move">
        <element name="move">
          <ref name="dir_if_unless"/>
          <choice>
            <group>
              <attribute name="file"/>
              <attribute name="to_file"/>
            </group>
            <group>
              <attribute name="file"/>
              <attribute name="to_directory"/>
            </group>
            <group>
              <attribute name="to_directory"/>
              <ref name="fileset"/>
            </group>
          </choice>
        </element>
      </define>

## Examples

      <move file="readme.txt" to_file="readme1.txt"/>

      <move file="readme.txt" to_directory="/tmp"/>

      <move to_directory="/tmp">
        <fileset directory="kernel" include="@(**/*.ge)"/>
      </move>