Connection Management

Macros

#define GLOBUS_RLS_URL_SCHEME   "rls"
 
#define GLOBUS_RLS_URL_SCHEME_NOAUTH   "rlsn"
 
#define GLOBUS_RLS_SERVER_DEFPORT   39281
 
#define MAXERRMSG   1024
 

Functions

void globus_rls_client_certificate (char *certfile, char *keyfile)
 
void globus_rls_client_proxy_certificate (char *proxy)
 
globus_result_t globus_rls_client_connect (char *url, globus_rls_handle_t **h)
 
globus_result_t globus_rls_client_close (globus_rls_handle_t *h)
 
int globus_rls_client_get_timeout ()
 
void globus_rls_client_set_timeout (int seconds)
 

Detailed Description

Functions to open and close connections to an RLS server.

Macro Definition Documentation

#define GLOBUS_RLS_URL_SCHEME   "rls"

URL scheme to use when connecting to RLS server.

#define GLOBUS_RLS_URL_SCHEME_NOAUTH   "rlsn"

URL scheme when connecting to RLS server without authentication.

#define GLOBUS_RLS_SERVER_DEFPORT   39281

Default port number that RLS server listens on.

#define MAXERRMSG   1024

Maximum length of error messages returned by server.

Function Documentation

void globus_rls_client_certificate ( char *  certfile,
char *  keyfile 
)

Set certificate used in authentication.

Sets environment variables X509_USER_CERT, X509_USER_KEY, and clears X509_USER_PROXY.

Parameters
certfileName of X509 certificate file.
keyfileName of X509 key file.
void globus_rls_client_proxy_certificate ( char *  proxy)

Set X509_USER_PROXY environment variable to specified file.

Parameters
proxyName of X509 proxy certificate file. If NULL clears X509_USER_PROXY.
globus_result_t globus_rls_client_connect ( char *  url,
globus_rls_handle_t **  h 
)

Open connection to RLS server.

Parameters
urlURL of server to connect to. URL scheme should be RLS or RLSN, eg RLS://my.host. If the URL scheme is RLSN then no authentication is performed (the RLS server must be started with authentication disabled as well, this option is primarily intended for testing).
hIf the connection is successful *h will be set to the connection handle. This handle is required by all other functions in the API.
Return values
GLOBUS_SUCCESSHandle h now connected to RLS server identified by url.

References GLOBUS_RLS_BADARG, GLOBUS_RLS_BADURL, GLOBUS_RLS_INVHANDLE, GLOBUS_RLS_NOMEMORY, GLOBUS_RLS_SERVER_DEFPORT, GLOBUS_RLS_SUCCESS, GLOBUS_RLS_URL_SCHEME, GLOBUS_RLS_URL_SCHEME_NOAUTH, and MAXERRMSG.

globus_result_t globus_rls_client_close ( globus_rls_handle_t h)

Close connection to RLS server.

Parameters
hConnection handle to be closed, previously allocated by globus_rls_client_connect().
Return values
GLOBUS_SUCCESSConnection closed, h is no longer valid.

References globus_rls_handle_t::flags, GLOBUS_RLS_INVHANDLE, globus_rls_handle_t::handle, and globus_rls_handle_t::url.

int globus_rls_client_get_timeout ( )

Get timeout for IO calls to RLS server.

If 0 IO calls do not timeout. The default is 30 seconds.

Return values
timeoutSeconds to wait before timing out an IO operation.
void globus_rls_client_set_timeout ( int  seconds)

Set timeout for IO calls to RLS server.

Parameters
secondsSeconds to wait before timing out an IO operation. If 0 IO calls do not timeout. The default is 30 seconds.

about globus | globus toolkit | dev.globus

Comments? webmaster@globus.org