NAME

Cog::Globus::URLCopy - Perl extension for using the Globus 'globus-url-copy' utility to transfer files.

SYNOPSIS

        use Cog::Globus::URLCopy;

EXAMPLES

        use Cog::Globus::URLCopy;
        @output = Cog::Globus::URLCopy::copy(
                source_url=>'gsiftp://host1.sdsc.edu/home/user/bigfile.dat',
                dest_url  =>'gsiftp://host2.sdsc.edu/home/user/bigfilecopy.dat'
                );
        if(defined(@output)) { ....yay.... };
        else { .....doh!...... };
        foreach(@output) { print; }

DESCRIPTION

        This module can be used to copy files from one machine to another. It is
        a light wrapper around the globus toolkit's globus-url-copy binary
        executable. See the help page for that executable for more information
        on the arguments available to you.

        Because this is a wrapper to the globus-url-copy binary, it follows that
        this binary executable must be in existence on your the system that you
        are installing this module on. This module will find globus-url-copy
        by getting the location of the Globus binaries from the Cog::Config module.

EXPORT

None by default.

AUTHORS

Maytal Dahan, maytal@tacc.utexas.edu Catherine Mills, cmills@sdsc.edu Stephen Mock, mock@sdsc.edu

SUBROUTINES

`copy()`


        Description/Usage:
        Used to run a globus-url-copy transferring a file from one place to another.

        @output = Cog::Globus::URLCopy::copy(source_url=>'file:///home/mock/data_file.stuff',
                                             dest_url=>'gsiftp://host.teragrid.org' );
        Required Arguments:
           source_url - the url describing the source file to be copied
           dest_url   - the url describing the destination file to be created

        Optional Arguments:
           arguments - the list of command line options you may like to include to globus-url-copy
           timeout - the number of seconds before the attempt is aborted and the processes are killed

        Returns: undef or an array with the error messages in it.
           If all goes well, this array will be undef. 
           If not, then it will have globus gibberish in it.