ICEEXTRACT

Thins and remotely stores an ICE packet file.

<in>	ICE packet file to work on
<out>	"scp"-like syntax for storage
<time>	Start time for trimming (YYYY:MM:DD::HH:MM:SS)
<dur>	Duration or End time for trimming
 
Syntax Rules for Parameters:
 
[in]	Raw name of the input ICE packet file. Do NOT include an extension!
 
[out]	The output name will specify the address, port, remote file directory
        and file name. Do NOT include an extension! Here are some examples:
        
        ftp:<ip>:<port>:/<dir>/<filename>
        ftp:<ip>:/<dir>/<filename>
        ftp:<ip>:/<filename>
 
[time]  Start time for trimming. If no date is specified, the recording start date
        is chosen. Here are some examples:
        
        2011:05:02::15:58:00 - trimming will start at 15:58:00 on May 2nd, 2011
        15:58:00 - trimming will start at 15:58:00 on the recording start date
        
[dur]	The duration can either be specified as a time-string or as a number of 
        seconds from the start time. Here a some examples:
        
        1.0 - trimming will occur for 1 second
        2011:05:02::15:58:00 - trimming will go through 15:58 on May 2nd, 2011
        12:34:56.78 - trimming will go through 12:34:57.78 on the recording start date
        

The trimming will begin at the first sample before the specified start time. It will go
through the first sample after the specified end time/duration.

Examples
  1.  To get just the start and stop times for a recording
    nM> iceextract in
    
  2.  To trim 1 seconds worth of data into the default FTP directory of a host
    nM> iceextract in ftp:192.168.0.1/out 2011:01:01::20:00:00 1.0
    
  3.  To specify a start and end time for trimming
    nM> iceextract in ftp:192.168.0.1/out 2011:01:01::20:00:00 2011:01:01::20:00:01.0
    
  4.  To specify a directory, a relative time and a duration of 75.5 seconds
    nM> iceextract in ftp:192.168.0.1/midas/tmps/out 10:15:30.5 75.5
    
  5.  To specify a port and relative times
    nM> iceextract in ftp:192.168.0.1:21/out 10:15:30.5 10:15:31
    
  6.  To specify a user name and password
    nM> iceextract in xmidas@ftp:192.168.0.1:21/out 10:15:30.5 1.0 /pass="password"
    
  7.  To specify all valid times
  	nM> iceextract in ftp:192.168.0.1:/out
 
Switches :
  /PASS= Login password on the FTP server (if required)
 
See Also:
  SOURCEICE, ICETC