Function Signatures

Net Manager Function Signatures. More...

Typedefs
typedef globus_result_t(*	globus_net_manager_pre_listen) (struct globus_net_manager_s *manager, const globus_net_manager_attr_t *manager_attr_array, const char *task_id, const char *transport, const globus_net_manager_attr_t *attr_array, globus_net_manager_attr_t **attr_array_out)
	Net Manager Pre-Listen Function Signature. More...
typedef globus_result_t(*	globus_net_manager_post_listen) (struct globus_net_manager_s *manager, const globus_net_manager_attr_t *manager_attr_array, const char *task_id, const char *transport, const char *local_contact, const globus_net_manager_attr_t *attr_array, char **local_contact_out, globus_net_manager_attr_t **attr_array_out)
	Net Manager Post-Listen Function Signature. More...
typedef globus_result_t(*	globus_net_manager_end_listen) (struct globus_net_manager_s *manager, const globus_net_manager_attr_t *manager_attr_array, const char *task_id, const char *transport, const char *local_contact, const globus_net_manager_attr_t *attr_array)
	Net Manager End-Listen Function Signature. More...
typedef globus_result_t(*	globus_net_manager_pre_accept) (struct globus_net_manager_s *manager, const globus_net_manager_attr_t *manager_attr_array, const char *task_id, const char *transport, const char *local_contact, const globus_net_manager_attr_t *attr_array, globus_net_manager_attr_t **attr_array_out)
	Net Manager Pre-Accept Function Signature. More...
typedef globus_result_t(*	globus_net_manager_post_accept) (struct globus_net_manager_s *manager, const globus_net_manager_attr_t *manager_attr_array, const char *task_id, const char *transport, const char *local_contact, const char *remote_contact, const globus_net_manager_attr_t *attr_array, globus_net_manager_attr_t **attr_array_out)
	Net Manager Post-Accept Function Signature. More...
typedef globus_result_t(*	globus_net_manager_pre_connect) (struct globus_net_manager_s *manager, const globus_net_manager_attr_t *manager_attr_array, const char *task_id, const char *transport, const char *remote_contact, const globus_net_manager_attr_t *attr_array, char **remote_contact_out, globus_net_manager_attr_t **attr_array_out)
	Net Manager Pre-Connect Function Signature. More...
typedef globus_result_t(*	globus_net_manager_post_connect) (struct globus_net_manager_s *manager, const globus_net_manager_attr_t *manager_attr_array, const char *task_id, const char *transport, const char *local_contact, const char *remote_contact, const globus_net_manager_attr_t *attr_array, globus_net_manager_attr_t **attr_array_out)
	Net Manager Post-Connect Function Signature. More...
typedef globus_result_t(*	globus_net_manager_pre_close) (struct globus_net_manager_s *manager, const globus_net_manager_attr_t *manager_attr_array, const char *task_id, const char *transport, const char *local_contact, const char *remote_contact, const globus_net_manager_attr_t *attr_array)
	Net Manager Pre-Close Function Signature. More...
typedef globus_result_t(*	globus_net_manager_post_close) (struct globus_net_manager_s *manager, const globus_net_manager_attr_t *manager_attr_array, const char *task_id, const char *transport, const char *local_contact, const char *remote_contact, const globus_net_manager_attr_t *attr_array)
	Net Manager Post-Close Function Signature. More...

Detailed Description

Net Manager Function Signatures.

Function signatures for the Net Manager interface. globus_net_manager_tutorial

Typedef Documentation

globus_net_manager_end_listen

typedef globus_result_t(* globus_net_manager_end_listen) (struct globus_net_manager_s *manager, const globus_net_manager_attr_t *manager_attr_array, const char *task_id, const char *transport, const char *local_contact, const globus_net_manager_attr_t *attr_array)

Net Manager End-Listen Function Signature.

A function of this signature, if included in a network manager implementation, is called when the transport-specific listening port will be closed.

The network manager is passed the network transport-specific options and contact string for the listener.

The globus_net_manager library aborts the closing of the listening port if this function returns a value other than GLOBUS_SUCCESS. In this case, the globus_net_manager will not call any other globus_net_manager_end_listen functions configured for this listener.

Parameters

[in]	manager	Pointer to the network manager struct that is being invoked.
[in]	manager_attr_array	An array of attributes associated with the manager. The end of the array is indicated by an attribute containing a NULL scope.
[in]	task_id	An application-specific task ID associated with this network operation.
[in]	transport	The name of the transport associated with this listener.
[in]	local_contact	The transport-specific contact string for the listener [in].
[in]	attr_array	An array of transport attributes associated with the listener. The end of the array is indicated by an attribute containing a NULL scope.

globus_net_manager_post_accept

typedef globus_result_t(* globus_net_manager_post_accept) (struct globus_net_manager_s *manager, const globus_net_manager_attr_t *manager_attr_array, const char *task_id, const char *transport, const char *local_contact, const char *remote_contact, const globus_net_manager_attr_t *attr_array, globus_net_manager_attr_t **attr_array_out)

Net Manager Post-Accept Function Signature.

A function of this signature, if included in a network manager implementation, is called after accepting a connection on a transport-specific listening port.

The network manager is passed the network transport-specific options and contact string for both ends of the connection. It may modify the attributes of the local side of the connection.

The globus_net_manager library aborts the accept operation if this function returns a value other than GLOBUS_SUCCESS. In this case, the globus_net_manager will not call any other globus_net_manager_post_accept functions configured for this connection.

Parameters

[in]	manager	Pointer to the network manager struct that is being invoked.
[in]	manager_attr_array	An array of attributes associated with the manager. The end of the array is indicated by an attribute containing a NULL scope.
[in]	task_id	An application-specific task ID associated with this network operation.
[in]	transport	The name of the transport associated with this listener.
[in]	local_contact	The transport-specific contact string for the local side of the connection.
[in]	remote_contact	The transport-specific contact string for the remote side of the connection.
[in]	attr_array	An array of transport attributes associated with the listener. The end of the array is indicated by an attribute containing a NULL scope.
[out]	attr_array_out	A pointer to an array of transport options to apply to the listener prior to returning it to the service. This may be NULL to indicate no change in the options. If non-NULL, this array must be terminated with an attribute having a NULL scope. The array and the members of the globus_net_manager_attr_t struct will be freed by the globus_net_manager library by calling free().

globus_net_manager_post_close

typedef globus_result_t(* globus_net_manager_post_close) (struct globus_net_manager_s *manager, const globus_net_manager_attr_t *manager_attr_array, const char *task_id, const char *transport, const char *local_contact, const char *remote_contact, const globus_net_manager_attr_t *attr_array)

Net Manager Post-Close Function Signature.

A function of this signature, if included in a network manager implementation, is called after closing a connection.

The network manager is passed the network transport-specific options and contact string for both ends of the connection.

The globus_net_manager library aborts the close operation if this function returns a value other than GLOBUS_SUCCESS. In this case, the globus_net_manager will not call any other globus_net_manager_pre_close functions configured for this connection.

Parameters

[in]	manager	Pointer to the network manager struct that is being invoked.
[in]	manager_attr_array	An array of attributes associated with the manager. The end of the array is indicated by an attribute containing a NULL scope.
[in]	task_id	An application-specific task ID associated with this network operation.
[in]	transport	The name of the transport associated with this listener.
[in]	local_contact	The transport-specific contact string for the local side of the connection.
[in]	remote_contact	The transport-specific contact string for the remote side of the connection.
[in]	attr_array	An array of transport attributes associated with the listener. The end of the array is indicated by an attribute containing a NULL scope.

globus_net_manager_post_connect

typedef globus_result_t(* globus_net_manager_post_connect) (struct globus_net_manager_s *manager, const globus_net_manager_attr_t *manager_attr_array, const char *task_id, const char *transport, const char *local_contact, const char *remote_contact, const globus_net_manager_attr_t *attr_array, globus_net_manager_attr_t **attr_array_out)

Net Manager Post-Connect Function Signature.

A function of this signature, if included in a network manager implementation, is called after establishing a connection to a transport-specific listener.

The network manager is passed the network transport-specific options and contact string for both ends of the connection. It may modify the attributes of the local side of the connection.

The globus_net_manager library aborts the connect operation if this function returns a value other than GLOBUS_SUCCESS. In this case, the globus_net_manager will not call any other globus_net_manager_post_connect functions configured for this connection.

Parameters

[in]	manager	Pointer to the network manager struct that is being invoked.
[in]	manager_attr_array	An array of attributes associated with the manager. The end of the array is indicated by an attribute containing a NULL scope.
[in]	task_id	An application-specific task ID associated with this network operation.
[in]	transport	The name of the transport associated with this listener.
[in]	remote_contact	The transport-specific contact string for the remote side of the connection.
[in]	attr_array	An array of transport attributes associated with the listener. The end of the array is indicated by an attribute containing a NULL scope.
[out]	attr_array_out	A pointer to an array of transport options to apply to the listener prior to returning it to the service. This may be NULL to indicate no change in the options. If non-NULL, this array must be terminated with an attribute having a NULL scope. The array and the members of the globus_net_manager_attr_t struct will be freed by the globus_net_manager library by calling free().

globus_net_manager_post_listen

typedef globus_result_t(* globus_net_manager_post_listen) (struct globus_net_manager_s *manager, const globus_net_manager_attr_t *manager_attr_array, const char *task_id, const char *transport, const char *local_contact, const globus_net_manager_attr_t *attr_array, char **local_contact_out, globus_net_manager_attr_t **attr_array_out)

Net Manager Post-Listen Function Signature.

A function of this signature, if included in a network manager implementation, is called after the transport-specific listening port has been created.

The network manager is passed the network transport-specific options and contact string for the listener. It may modify either of these before the transport listener is made available to the service which requested the listening port.

The globus_net_manager library aborts the listen operation if this function returns a value other than GLOBUS_SUCCESS. In this case, the globus_net_manager will not call any other globus_net_manager_post_listen functions configured for this listener.

Parameters

[in]	manager	Pointer to the network manager struct that is being invoked.
[in]	manager_attr_array	An array of attributes associated with the manager. The end of the array is indicated by an attribute containing a NULL scope.
[in]	task_id	An application-specific task ID associated with this network operation.
[in]	transport	The name of the transport associated with this listener.
[in]	local_contact	The transport-specific contact string for the listener [in].
[in]	attr_array	An array of transport attributes associated with the listener. The end of the array is indicated by an attribute containing a NULL scope.
[out]	local_contact_out	A pointer to the local contact which the network manager wants to return to the service. This may be NULL to indicate no change in the contact. This value will be freed() by the globus_net_manager library.
[out]	attr_array_out	A pointer to an array of transport options to apply to the listener prior to returning it to the service. This may be NULL to indicate no change in the options. If non-NULL, this array must be terminated with an attribute having a NULL scope. The array and the members of the globus_net_manager_attr_t struct will be freed by the globus_net_manager library by calling free().

globus_net_manager_pre_accept

typedef globus_result_t(* globus_net_manager_pre_accept) (struct globus_net_manager_s *manager, const globus_net_manager_attr_t *manager_attr_array, const char *task_id, const char *transport, const char *local_contact, const globus_net_manager_attr_t *attr_array, globus_net_manager_attr_t **attr_array_out)

Net Manager Pre-Accept Function Signature.

A function of this signature, if included in a network manager implementation, is called before accepting a connection on a transport-specific listening port.

The network manager is passed the network transport-specific options and contact string for the listener. It may modify the options before the accept operation is complete.

The globus_net_manager library aborts the accept operation if this function returns a value other than GLOBUS_SUCCESS. In this case, the globus_net_manager will not call any other globus_net_manager_pre_accept functions configured for this listener.

Parameters

[in]	manager	Pointer to the network manager struct that is being invoked.
[in]	manager_attr_array	An array of attributes associated with the manager. The end of the array is indicated by an attribute containing a NULL scope.
[in]	task_id	An application-specific task ID associated with this network operation.
[in]	transport	The name of the transport associated with this listener.
[in]	local_contact	The transport-specific contact string for the listener.
[in]	attr_array	A NULL-terminated array of transport attributes associated with the listener.
[out]	attr_array_out	A pointer to an array of transport options to apply to the listener prior to returning it to the service. This may be NULL to indicate no change in the options. If non-NULL, this array must be terminated with an attribute having a NULL scope. The array and the members of the globus_net_manager_attr_t struct will be freed by the globus_net_manager library by calling free().

globus_net_manager_pre_close

typedef globus_result_t(* globus_net_manager_pre_close) (struct globus_net_manager_s *manager, const globus_net_manager_attr_t *manager_attr_array, const char *task_id, const char *transport, const char *local_contact, const char *remote_contact, const globus_net_manager_attr_t *attr_array)

Net Manager Pre-Close Function Signature.

A function of this signature, if included in a network manager implementation, is called prior to closing a connection.

The network manager is passed the network transport-specific options and contact string for both ends of the connection.

The globus_net_manager library aborts the close operation if this function returns a value other than GLOBUS_SUCCESS. In this case, the globus_net_manager will not call any other globus_net_manager_pre_close functions configured for this connection.

Parameters

[in]	manager	Pointer to the network manager struct that is being invoked.
[in]	manager_attr_array	An array of attributes associated with the manager. The end of the array is indicated by an attribute containing a NULL scope.
[in]	task_id	An application-specific task ID associated with this network operation.
[in]	transport	The name of the transport associated with this listener.
[in]	local_contact	The transport-specific contact string for the local side of the connection.
[in]	remote_contact	The transport-specific contact string for the remote side of the connection.
[in]	attr_array	An array of transport attributes associated with the listener. The end of the array is indicated by an attribute containing a NULL scope.

globus_net_manager_pre_connect

typedef globus_result_t(* globus_net_manager_pre_connect) (struct globus_net_manager_s *manager, const globus_net_manager_attr_t *manager_attr_array, const char *task_id, const char *transport, const char *remote_contact, const globus_net_manager_attr_t *attr_array, char **remote_contact_out, globus_net_manager_attr_t **attr_array_out)

Net Manager Pre-Connect Function Signature.

A function of this signature, if included in a network manager implementation, is called after initiating a connection to a transport-specific listener.

The network manager is passed the network transport-specific options and contact string for both ends of the connection. It may modify the attributes of the local side of the connection.

The globus_net_manager library aborts the connect operation if this function returns a value other than GLOBUS_SUCCESS. In this case, the globus_net_manager will not call any other globus_net_manager_pre_connect functions configured for this connection.

Parameters

[in]	manager	Pointer to the network manager struct that is being invoked.
[in]	manager_attr_array	An array of attributes associated with the manager. The end of the array is indicated by an attribute containing a NULL scope.
[in]	task_id	An application-specific task ID associated with this network operation.
[in]	transport	The name of the transport associated with this listener.
[in]	remote_contact	The transport-specific contact string for the remote side of the connection.
[in]	attr_array	An array of transport attributes associated with the listener. The end of the array is indicated by an attribute containing a NULL scope.
[out]	remote_contact_out	A pointer to the remote contact which the network manager wants to connect to. This may be NULL to indicate no change in the contact. This value will be freed() by the globus_net_manager library.
[out]	attr_array_out	A pointer to an array of transport options to apply to the listener prior to returning it to the service. This may be NULL to indicate no change in the options. If non-NULL, this array must be terminated with an attribute having a NULL scope. The array and the members of the globus_net_manager_attr_t struct will be freed by the globus_net_manager library by calling free().

globus_net_manager_pre_listen

typedef globus_result_t(* globus_net_manager_pre_listen) (struct globus_net_manager_s *manager, const globus_net_manager_attr_t *manager_attr_array, const char *task_id, const char *transport, const globus_net_manager_attr_t *attr_array, globus_net_manager_attr_t **attr_array_out)

Net Manager Pre-Listen Function Signature.

A function of this signature, if included in a network manager implementation, is called before the transport-specific listening port has been created.

The network manager is passed the network transport-specific options for the listener. It may modify these before the listener is created by the transport.

The globus_net_manager library aborts the listen operation if this function returns a value other than GLOBUS_SUCCESS. In this case, the globus_net_manager will not call any other globus_net_manager_pre_listen functions configured for this listener.

Parameters

[in]	manager	Pointer to the network manager struct that is being invoked.
[in]	manager_attr_array	An array of attributes associated with the manager. The end of the array is indicated by an attribute containing a NULL scope.
[in]	task_id	An application-specific task ID associated with this network operation.
[in]	transport	The name of the transport associated with this listener.
[in]	attr_array	An array of transport attributes associated with the listener. The end of the array is indicated by an attribute containing a NULL scope.
[out]	attr_array_out	A pointer to an array of transport options to apply to the listener prior to returning it to the service. This may be NULL to indicate no change in the options. If non-NULL, this array must be terminated with an attribute having a NULL scope. The array and the members of the globus_net_manager_attr_t struct will be freed by the globus_net_manager library by calling free().