Subsections

• SUMMARY
• ATTRIBUTES
• HOW TO USE THE PACKAGE
• SPECIFICATION OF GROWL_GRIDFTP
  • Argument List
  • Control and Information
  • Control Parameters
  • Information returned to the User
  • Errors and Warnings
  • Error Returns
  
  
• GENERAL INFORMATION
• METHOD
• EXAMPLE
  • Example text
  • Example data
  • Example results

TRANSFER

SUMMARY

Functions for remote data management, mostly using GridFTP.

ATTRIBUTES

Version: 1.0
Public calls: growl_gridFTP
Public modules: libgrowl.a
Other modules required: gSOAP v2.1.4
Date: 2005
Origin: Hand-Knitted Software, R.J. Allan, CCLRC Daresbury Laboratory
Language: C
Conditions on external use: Standard, see separate chapter

HOW TO USE THE PACKAGE

This module is used by including growl.h and linking to the library libgrowl.a. Publically callable procedures are listed here.

SPECIFICATION OF GROWL_GRIDFTP

[frame=single]
   int growl_gridFTP(char *sessionId,
                     char *source,
		     char *sname,
		     char *target, 
		     char *tname,
		     char **response);

Argument List

char *sessionId
On entry: unique session key as returned from growl_getDelegation. See Chapter .

char *source
On entry: fully qualified dns name of the computer which is the source of data.

char *sname
On entry: full path to source data file

char *target
On entry: fully qualified dns name of the target computer.

char *tname
On entry: full path to target data file to be over-written or created

char **response)
On exit: information from FTP server

Control and Information

Control Parameters

Information returned to the User

Integer, 0=success, !0=failure.

Errors and Warnings

Error Returns

SOAP error message if there is a problem.

GENERAL INFORMATION

Workspace: internal workspace is allocated in all these routines by the gSOAP system for the long return string. This should be freed by the user when it is no longer required.
Use of globals: none
Other routines called directly: none
Input/ output: none
Restrictions:
Notes:

METHOD

This module is based on GridFTP and is intended for 3rd party data transfer. It relies upon the fact that multiple firewall ports for control and data can be open between the source and target hosts. This is unlikely to work to a desktop machine and error notification should be clear if transfer cannot take place for this reason.

EXAMPLE

Put the example code here. Should also be provided as part of the distribution.

Example text

[frame=single]
Part of code listing

Example data

Input data

Example results

Output data