Connection Management
Functions to open and close connections to an RLS server.
More...
Defines
Functions
Detailed Description
Functions to open and close connections to an RLS server.
Define 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.
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:
-
| certfile | Name of X509 certificate file. |
| keyfile | Name of X509 key file. |
void globus_rls_client_proxy_certificate |
( |
char * |
proxy |
) |
|
Set X509_USER_PROXY environment variable to specified file.
- Parameters:
-
| proxy | Name of X509 proxy certificate file. If NULL clears X509_USER_PROXY. |
Open connection to RLS server.
- Parameters:
-
| url | URL 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). |
| h | If 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_SUCCESS | Handle h now connected to RLS server identified by url. |
Close connection to RLS server.
- Parameters:
-
- Return values:
-
| GLOBUS_SUCCESS | Connection closed, h is no longer valid. |
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:
-
| timeout | Seconds 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:
-
| seconds | Seconds to wait before timing out an IO operation. If 0 IO calls do not timeout. The default is 30 seconds. |