Subversion Repositories shark

Compare Revisions

Ignore whitespace Rev 985 → Rev 986

/shark/trunk/ports/first/fsf_include/fsf_distributed.h
283,6 → 283,48
/**
\ingroup distjmodule
 
This operation eliminates any resources reserved for the given
endpoint. After callling this operation the endpoint can not be
further used to invoke receive operations on it.
 
@param endpoint pointer to the endpoint
@retval 0 if the operation is succesful
@retval FSF_ERR_BAD_ARGUMENT if endpoint is null, or not valid
*/
int
fsf_destroy_receive_endpoint
(fsf_receive_endpoint_t *endpoint);
 
 
/**
\ingroup distjmodule
 
This operation returns in the variables network_id,
and port, the corresponding parameters used in the
creation of the given receive endpoint.
@param [in] endpoint pointer to the endpoint
@param [out] network_id pointer to variable the will contain
the network id
@param [out] port pointer to variable the will contain
the protocol dependent information used to get in contact
with the desired destination process
 
@retval 0 if the operation is succesful
@retval FSF_ERR_BAD_ARGUMENT if endpoint is null, or not valid
or all the other pointers are NULL.
*/
int
fsf_get_receive_endpoint_parameters
(fsf_receive_endpoint_t *endpoint,
fsf_network_id_t *network_id,
fsf_port_t *port);
 
 
/**
\ingroup distjmodule
 
If there are no messages available in the specified receive endpoint
this operation blocks the calling thread waiting for a message to be
received. When a message is available, if its size is less than or
/shark/trunk/ports/first/fsf_include/fsf_distributed_spare_capacity.h
35,8 → 35,14
server must not be changed due to the negotiation or renegotiation
of any other contract in the system. The period can change, though,
if a renegotiation or a change of quality and importance is
requested for the corresponding server It fails with
FSF_ERR_BAD_ARGUMENT if contract is NULL. */
requested for the corresponding server.
 
@param contract the pointer to the contract object
@param[in] granted_capacity_flag boolean value set to true to
avoid the change in the period due to changes in other servers
 
@retval FSF_ERR_BAD_ARGUMENT : if contract is NULL
*/
int
fsf_set_contract_granted_capacity_flag
(fsf_contract_parameters_t *contract,
48,8 → 54,14
 
This operation returns in the place pointed to by
granted_capacity_flag the value of the corresponding flag in the
contract parameters object pointed to by contract. It fails with
FSF_ERR_BAD_ARGUMENT if any of the pointers is NULL */
contract parameters object pointed to by contract.
@param[in] contract the pointer to the contract object
@param[in] granted_capacity_flag pointer to the variable that
will contain the boolean value of the granted_capacity_flag
 
@retval FSF_ERR_BAD_ARGUMENT : if any of the pointers is NULL
*/
int
fsf_get_contract_granted_capacity_flag
(fsf_contract_parameters_t *contract,
63,17 → 75,23
to a server but that cannot be used due to restrictions in other
servers of a distributed transaction. This operation changes the
cycle period and budget of the given server to the values given in
new_period and new_budget, respectively. It fails with
FSF_ERR_BAD_ARGUMENT if the server does not have the
granted_capacity flag set, if the new period is less than the
current one, or if the new budget is larger than the current
one. It also fails with the same error number if the new period is
greater than the maximum period currently specified in the contract
associated to the server or, similarly, if the new budget is
smaller than the minimum budget in the contract. It also fails
with the same number if the granularity is discrete and the new
period and budget do not match any of the period-budget pairs in
the utilization set of the server */
new_period and new_budget, respectively.
 
@param [in] server server id
@param [in] new_period pointer to the new period value
@param [in] new_budget pointer to the new budget value
@retval FSF_ERR_BAD_ARGUMENT : if (the server does not have
the granted_capacity flag set) or
(the new period is less than the current one), or
(the new budget is larger than the current one), or
(the new period is greater than the maximum period currently
specified in the contract associated to the server), or
(the new budget is smaller than the minimum budget in the contract) or
(if the granularity is discrete and the new period and budget
do not match any of the period-budget pairs in the utilization
set of the server).
*/
int
fsf_set_server_capacity
(fsf_server_id_t server,