ICECOPY

Copy an input file using native code (NextMidas Only).

ICECOPY - Copy an input file using native code (NextMidas Only)

<IN>    Input file name
<OUT>   Output file name

This primitive will make a copy of an input file. It differs from noop in two
ways. First, this primitive instantiates the native read & write functions 
from the approriate IOResource. Second, this primitive defaults to detaching
the header from the data. 

If one of the files is on an ICE RamDisk and the other is on an ICEFS filesystem, 
the ICEFS file reads and writes will use direct DMA from the physical RAM buffer 
bypassing any VFS or kernel memory copies.

Examples:
  1. Copy a local file
    nM> icecopy localfile localfilecopy
  
  2. Copy a local file to a specified AUX
    nM> icecopy localfile localfilecopy{aux=11}

  3. Copy a local file with a specified transfer length
    nM> icecopy/tl=4M localfile localfilecopy

  4. Copy a local file and reattach the header and data
    nM> icecopy/attach localfile localfilecopy

  5. Copy a file and show progress
    nM> icecopy/gpw localfile localfilecopy

Switches:
  /ATTACH  - Makes the output file attached instead of the default detached
             output file [DEF=not present]

  /REPLAY=n - Number of times to loop through input file.

  /GPW     - Show Graphical Progress Widget of transfer status (usually used
             when downloading a file from a server) [DEF=not present]

  /TL      - Number of elements (in bytes) to transfer in each process loop
             [DEF=# of elements in 32768 bytes, rounded down]

  /FLAGS=m - Mask of options to apply (ATTACH | NATIVE | NIN | NOUT)
             ATTACH is the same as the /ATTACH switch
             NATIVE uses native IO routines instead of Java where applicable
             NIN no Input file reads for testing
             NOUT no Output file writes for testing

  /OSIZE   - Size in elements of output file. If this is less than the input amount,
             the output will wrap at OSIZE. Useful for testing transfer rates.

  /UNPACK=12	- unpacks a file that was aquired in the 12 bit mode into regular 16 bit data

Widgets: NONE

See Also:  NOOP