Globus Toolkit® 3.2 Beta GridFTP Release Notes

Wufptd based server, tools, and libraries

Bug Fixes

• 1309 multiple file FTP's seem to hang
• 1306 "reached end of file" error
• 1268 need passive mode for directory listings when using ftp_client library
• 798 modification_time function uses assumes MDTM result is in local time zone
• 555 chmod functionality in GridFTP library?

Server Updates

• MLST: machine parsable single file info over control channel
• MLSD: machine parsable directory listings over data channel
• OPTS MLST: set the information that you wish to receive via the MLST/MLSD commands
• CKSM: get a checksum (currently only MD5 is supported) of full or partial file.

Client Updates

• ftp:
• globus_ftp_client_mlst
• globus_ftp_client_machine_list (mlsd)
• globus_ftp_client_cksm
• globus_ftp_client_chmod
• gass copy:
• globus_gass_copy_glob_expand_url: expand a file or ftp url with wildcards into a list of matching urls
• globus_gass_copy_mkdir: create a directory from file or ftp url

Globus-url-copy Changes

 globus-url-copy [options] <sourceURL> <destURL>
 globus-url-copy [options] -f <filename>
 
** <sourceURL> may contain wildcard characters * ? and [ ] character ranges
 in the filename only.
** Any url specifying a directory must end with a forward slash '/'
 
** If <sourceURL> is a directory, all files within that directory will
 be copied.
** <destURL> must be a directory if multiple files are being copied.
 
** Note:  If the ftp server from the source url does not support the MLSD
        command, this client will attempt to transfer subdirectories as
        files, resulting in an error.  Recursion is not possible in this
        case, but you can use the -c (continue on errors) option in order
        to transfer the regular files from the top level directory.
        **GridFTP servers prior to version 1.17 (Globus Toolkit 3.2)
          do not support MLSD.
 
 OPTIONS
   -help | -usage
        Print help
   -version
        Print the version of this program
   -versions
        Print the versions of all modules that this program uses
   -c | -continue-on-error
        Do not die after any errors.  By default, program will exit after
        most errors.
   -a | -ascii
        Convert the file to/from ASCII format to/from local file format
   -b | -binary
        Do not apply any conversion to the files. *default*
** -f <filename>
        Read a list of url pairs from filename.  Each line should contain
        <sourceURL> <destURL>
        Enclose URLs with spaces in double qoutes (").
        Blank lines and lines beginning with # will be ignored.
** -r | -recurse
        Copy files in subdirectories
** -fast
        Recommended when using GridFTP servers. Use MODE E for all data
        transfers, including reusing data channels between list and transfer
        operations.
** -q | -quiet 
        Suppress all output for successful operation
** -v | -verbose 
        Display urls being transferred
   -vb | -verbose-perf 
        During the transfer, display the number of bytes transferred
        and the transfer rate per second.  Show urls being transferred
   -dbg | -debugftp 
        Debug ftp connections.  Prints control channel communication
        to stderr
** -rst | -restart 
        Restart failed ftp operations.
** -rst-retries <retries>
        The maximum number of times to retry the operation before giving
        up on the transfer.  Use 0 for infinite.  Default is 5.
** -rst-interval <seconds>
        The interval in seconds to wait after a failure before retrying
        the transfer.  Use 0 for an exponential backoff.  Default is 0.
** -rst-timeout <seconds>
        Maximum time after a failure to keep retrying.  Use 0 for no
        timeout.  Default is 0.
** -rp | -relative-paths
       The path portion of ftp urls will be interpereted as relative to the
       user's starting directory on the server.  By default, all paths are
       root-relative.  When this flag is set, the path portion of the ftp url
       must start with %2F if it designates a root-relative path.
   -s  <subject> | -subject <subject>
        Use this subject to match with both the source and dest servers
   -ss <subject> | -source-subject <subject>
        Use this subject to match with the source server
   -ds <subject> | -dest-subject <subject>
        Use this subject to match with the destionation server
   -tcp-bs <size> | -tcp-buffer-size <size>
        specify the size (in bytes) of the buffer to be used by the
        underlying ftp data channels
   -bs <block size> | -block-size <block size>
        specify the size (in bytes) of the buffer to be used by the
        underlying transfer methods
   -p <parallelism> | -parallel <parallelism>
        specify the number of parallel data connections should be used.
   -notpt | -no-third-party-transfers
        turn third-party transfers off (on by default)
   -nodcau | -no-data-channel-authentication
        turn off data channel authentication for ftp transfers
** -dcsafe | -data-channel-safe
        set data channel protection mode to SAFE
** -dcpriv | -data-channel-private
        set data channel protection mode to PRIVATE
** -off | -partial-offset
        offset for partial ftp file transfers, defaults to 0
** -len | -partial-length
        length for partial ftp file transfers, used only for the source url,
        defaults the full file.