.TH "globus_gram_client.h" 3 "Version 14.6" "globus_gram_client" \" -*- nroff -*-
.ad l
.nh
.SH NAME
globus_gram_client.h \- GRAM Client API\&.  

.SH SYNOPSIS
.br
.PP
\fC#include 'globus_common\&.h'\fP
.br
\fC#include 'globus_io\&.h'\fP
.br
\fC#include 'globus_gram_protocol_constants\&.h'\fP
.br

.SS "Data Structures"

.in +1c
.ti -1c
.RI "struct \fBglobus_gram_client_job_info_s\fP"
.br
.RI "Extensible job information structure\&. "
.in -1c
.SS "Macros"

.in +1c
.ti -1c
.RI "#define \fBGLOBUS_GRAM_CLIENT_NO_ATTR\fP"
.br
.RI "Default GRAM client operation attribute\&. "
.in -1c
.SS "Typedefs"

.in +1c
.ti -1c
.RI "typedef void(* \fBglobus_gram_client_callback_func_t\fP) (void *user_callback_arg, char *job_contact, int state, int errorcode)"
.br
.RI "Signature for GRAM state notification callback functions\&. "
.ti -1c
.RI "typedef struct \fBglobus_gram_client_job_info_s\fP \fBglobus_gram_client_job_info_t\fP"
.br
.RI "Extensible job information structure\&. "
.ti -1c
.RI "typedef void(* \fBglobus_gram_client_info_callback_func_t\fP) (void *user_callback_arg, const char *job_contact, \fBglobus_gram_client_job_info_t\fP *job_info)"
.br
.RI "Signature for GRAM state notification callback functions with extension support\&. "
.ti -1c
.RI "typedef void * \fBglobus_gram_client_attr_t\fP"
.br
.RI "GRAM client operation attribute\&. "
.ti -1c
.RI "typedef void(* \fBglobus_gram_client_nonblocking_func_t\fP) (void *user_callback_arg, globus_gram_protocol_error_t operation_failure_code, const char *job_contact, globus_gram_protocol_job_state_t job_state, globus_gram_protocol_error_t job_failure_code)"
.br
.RI "Signature for callbacks signalling completion of non-blocking GRAM requests\&. "
.in -1c
.SS "Functions"

.in +1c
.ti -1c
.RI "int \fBglobus_gram_client_callback_allow\fP (\fBglobus_gram_client_callback_func_t\fP callback_func, void *user_callback_arg, char **callback_contact)"
.br
.RI "Begin listening for job state change callbacks\&. "
.ti -1c
.RI "int \fBglobus_gram_client_info_callback_allow\fP (\fBglobus_gram_client_info_callback_func_t\fP callback_func, void *user_callback_arg, char **callback_contact)"
.br
.RI "Begin listening for job state change callbacks\&. "
.ti -1c
.RI "int \fBglobus_gram_client_register_job_request\fP (const char *resource_manager_contact, const char *description, int job_state_mask, const char *callback_contact, \fBglobus_gram_client_attr_t\fP attr, \fBglobus_gram_client_nonblocking_func_t\fP register_callback, void *register_callback_arg)"
.br
.RI "Send a job request to a GRAM service\&. "
.ti -1c
.RI "int \fBglobus_gram_client_job_request\fP (const char *resource_manager_contact, const char *description, int job_state_mask, const char *callback_contact, char **job_contact)"
.br
.RI "Send a job request to a GRAM service\&. "
.ti -1c
.RI "int \fBglobus_gram_client_register_job_request_with_info\fP (const char *resource_manager_contact, const char *description, int job_state_mask, const char *callback_contact, \fBglobus_gram_client_attr_t\fP attr, \fBglobus_gram_client_info_callback_func_t\fP callback, void *callback_arg)"
.br
.RI "Send a job request to a GRAM service with extensions-aware callback\&. "
.ti -1c
.RI "int \fBglobus_gram_client_job_request_with_info\fP (const char *resource_manager_contact, const char *description, int job_state_mask, const char *callback_contact, char **job_contact, \fBglobus_gram_client_job_info_t\fP *info)"
.br
.RI "Send a job request to a GRAM service and parse extensions in the response\&. "
.ti -1c
.RI "int \fBglobus_gram_client_register_job_cancel\fP (const char *job_contact, \fBglobus_gram_client_attr_t\fP attr, \fBglobus_gram_client_nonblocking_func_t\fP register_callback, void *register_callback_arg)"
.br
.RI "Cancel a GRAM job\&. "
.ti -1c
.RI "int \fBglobus_gram_client_job_cancel\fP (const char *job_contact)"
.br
.RI "Cancel a GRAM job\&. "
.ti -1c
.RI "int \fBglobus_gram_client_register_job_status\fP (const char *job_contact, \fBglobus_gram_client_attr_t\fP attr, \fBglobus_gram_client_nonblocking_func_t\fP register_callback, void *register_callback_arg)"
.br
.RI "Send a status query to a GRAM job\&. "
.ti -1c
.RI "int \fBglobus_gram_client_register_job_status_with_info\fP (const char *job_contact, \fBglobus_gram_client_attr_t\fP attr, \fBglobus_gram_client_info_callback_func_t\fP info_callback, void *callback_arg)"
.br
.RI "Send a status query to a GRAM job\&. "
.ti -1c
.RI "int \fBglobus_gram_client_job_refresh_credentials\fP (char *job_contact, gss_cred_id_t creds)"
.br
.RI "Delegate a new credential to a job\&. "
.ti -1c
.RI "int \fBglobus_gram_client_register_job_refresh_credentials\fP (char *job_contact, gss_cred_id_t creds, \fBglobus_gram_client_attr_t\fP attr, \fBglobus_gram_client_nonblocking_func_t\fP register_callback, void *register_callback_arg)"
.br
.RI "Delegate a new credential to a job\&. "
.ti -1c
.RI "int \fBglobus_gram_client_job_status\fP (const char *job_contact, int *job_status, int *failure_code)"
.br
.RI "Send a status query to a GRAM job\&. "
.ti -1c
.RI "int \fBglobus_gram_client_job_status_with_info\fP (const char *job_contact, \fBglobus_gram_client_job_info_t\fP *job_info)"
.br
.RI "Send a status query to a GRAM job\&. "
.ti -1c
.RI "int \fBglobus_gram_client_register_job_signal\fP (const char *job_contact, globus_gram_protocol_job_signal_t signal, const char *signal_arg, \fBglobus_gram_client_attr_t\fP attr, \fBglobus_gram_client_nonblocking_func_t\fP register_callback, void *register_callback_arg)"
.br
.RI "Send a signal a GRAM job\&. "
.ti -1c
.RI "int \fBglobus_gram_client_job_signal\fP (const char *job_contact, globus_gram_protocol_job_signal_t signal, const char *signal_arg, int *job_status, int *failure_code)"
.br
.RI "Send a signal a GRAM job\&. "
.ti -1c
.RI "int \fBglobus_gram_client_register_job_callback_registration\fP (const char *job_contact, int job_state_mask, const char *callback_contact, \fBglobus_gram_client_attr_t\fP attr, \fBglobus_gram_client_nonblocking_func_t\fP register_callback, void *register_callback_arg)"
.br
.RI "Register a new callback contact to be notified for job state changes\&. "
.ti -1c
.RI "int \fBglobus_gram_client_job_callback_register\fP (const char *job_contact, int job_state_mask, const char *callback_contact, int *job_status, int *failure_code)"
.br
.RI "Register a new callback contact to be notified for job state changes\&. "
.ti -1c
.RI "int \fBglobus_gram_client_register_job_callback_unregistration\fP (const char *job_contact, const char *callback_contact, \fBglobus_gram_client_attr_t\fP attr, \fBglobus_gram_client_nonblocking_func_t\fP register_callback, void *register_callback_arg)"
.br
.RI "Unregister a callback contact to stop job state change notifications\&. "
.ti -1c
.RI "int \fBglobus_gram_client_job_callback_unregister\fP (const char *job_contact, const char *callback_contact, int *job_status, int *failure_code)"
.br
.RI "Unregister a callback contact to stop job state change notifications\&. "
.ti -1c
.RI "int \fBglobus_gram_client_callback_disallow\fP (char *callback_contact)"
.br
.RI "Stop listening for job state change callbacks\&. "
.ti -1c
.RI "int \fBglobus_gram_client_job_contact_free\fP (char *job_contact)"
.br
.RI "Free a job contact string\&. "
.ti -1c
.RI "const char * \fBglobus_gram_client_error_string\fP (int error_code)"
.br
.RI "Get a description of a a GRAM error code\&. "
.ti -1c
.RI "int \fBglobus_gram_client_version\fP (void)"
.br
.RI "Return GRAM protocol version\&. "
.ti -1c
.RI "int \fBglobus_gram_client_set_credentials\fP (gss_cred_id_t new_credentials)"
.br
.RI "Set the default GRAM credential\&. "
.ti -1c
.RI "int \fBglobus_gram_client_ping\fP (const char *resource_manager_contact)"
.br
.RI "Send a ping request to a GRAM service\&. "
.ti -1c
.RI "int \fBglobus_gram_client_register_ping\fP (const char *resource_manager_contact, \fBglobus_gram_client_attr_t\fP attr, \fBglobus_gram_client_nonblocking_func_t\fP register_callback, void *register_callback_arg)"
.br
.RI "Send a ping request to a GRAM service\&. "
.ti -1c
.RI "int \fBglobus_gram_client_get_jobmanager_version\fP (const char *resource_manager_contact, globus_hashtable_t *extensions)"
.br
.RI "Get version information from a job manager\&. "
.ti -1c
.RI "int \fBglobus_gram_client_register_get_jobmanager_version\fP (const char *resource_manager_contact, \fBglobus_gram_client_attr_t\fP attr, \fBglobus_gram_client_info_callback_func_t\fP info_callback, void *callback_arg)"
.br
.RI "Get version information from a job manager without blocking\&. "
.ti -1c
.RI "void \fBglobus_gram_client_debug\fP (void)"
.br
.RI "Enable GRAM debugging\&. "
.ti -1c
.RI "int \fBglobus_gram_client_attr_init\fP (\fBglobus_gram_client_attr_t\fP *attr)"
.br
.RI "Initialize a GRAM client attribute\&. "
.ti -1c
.RI "int \fBglobus_gram_client_attr_destroy\fP (\fBglobus_gram_client_attr_t\fP *attr)"
.br
.RI "Destroy a GRAM client attribute\&. "
.ti -1c
.RI "int \fBglobus_gram_client_attr_set_credential\fP (\fBglobus_gram_client_attr_t\fP attr, gss_cred_id_t credential)"
.br
.RI "Set a GRAM client attribute's security credential\&. "
.ti -1c
.RI "int \fBglobus_gram_client_attr_get_credential\fP (\fBglobus_gram_client_attr_t\fP attr, gss_cred_id_t *credential)"
.br
.RI "Get a GRAM client attribute's security credential\&. "
.ti -1c
.RI "int \fBglobus_gram_client_attr_set_delegation_mode\fP (\fBglobus_gram_client_attr_t\fP attr, globus_io_secure_delegation_mode_t mode)"
.br
.RI "Set a GRAM client attribute's delegation mode\&. "
.ti -1c
.RI "int \fBglobus_gram_client_attr_get_delegation_mode\fP (\fBglobus_gram_client_attr_t\fP attr, globus_io_secure_delegation_mode_t *mode)"
.br
.RI "Get a GRAM client attribute's security credential\&. "
.ti -1c
.RI "void \fBglobus_gram_client_job_info_destroy\fP (\fBglobus_gram_client_job_info_t\fP *info)"
.br
.RI "Free memory associated with a globus_gram_client_job_info_t structure\&. "
.in -1c
.SH "Detailed Description"
.PP 
GRAM Client API\&. 

This header file contains the exported client interface of the Resource Allocation Management System\&. 
.SH "Author"
.PP 
Generated automatically by Doxygen for globus_gram_client from the source code\&.