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:
manager Pointer to the network manager struct that
is being invoked.
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.
task_id An application-specific task ID associated with this network
operation.
transport The name of the transport associated with this listener.
local_contact The transport-specific contact string for the 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.
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:
manager Pointer to the network manager struct that
is being invoked.
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.
task_id An application-specific task ID associated with this network
operation.
transport The name of the transport associated with this listener.
local_contact The transport-specific contact string for the local side of
the connection.
remote_contact The transport-specific contact string for the remote side
of the connection.
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.
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().
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:
manager Pointer to the network manager struct that
is being invoked.
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.
task_id An application-specific task ID associated with this network
operation.
transport The name of the transport associated with this listener.
local_contact The transport-specific contact string for the local side of
the connection.
remote_contact The transport-specific contact string for the remote side
of the connection.
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.
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:
manager Pointer to the network manager struct that
is being invoked.
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.
task_id An application-specific task ID associated with this network
operation.
transport The name of the transport associated with this listener.
remote_contact The transport-specific contact string for the remote side
of the connection.
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.
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().
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:
manager Pointer to the network manager struct that
is being invoked.
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.
task_id An application-specific task ID associated with this network
operation.
transport The name of the transport associated with this listener.
local_contact The transport-specific contact string for the 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.
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.
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().
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:
manager Pointer to the network manager struct that
is being invoked.
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.
task_id An application-specific task ID associated with this network
operation.
transport The name of the transport associated with this listener.
local_contact The transport-specific contact string for the listener.
attr_array A NULL-terminated array of transport attributes associated
with the listener.
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().
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:
manager Pointer to the network manager struct that
is being invoked.
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.
task_id An application-specific task ID associated with this network
operation.
transport The name of the transport associated with this listener.
local_contact The transport-specific contact string for the local side of
the connection.
remote_contact The transport-specific contact string for the remote side
of the connection.
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.
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:
manager Pointer to the network manager struct that
is being invoked.
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.
task_id An application-specific task ID associated with this network
operation.
transport The name of the transport associated with this listener.
remote_contact The transport-specific contact string for the remote side
of the connection.
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.
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.
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().
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:
manager Pointer to the network manager struct that
is being invoked.
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.
task_id An application-specific task ID associated with this network
operation.
transport The name of the transport associated with this listener.
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.
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().