Subversion Repositories shark

/**
   @file distributed spare capacity
*/

//fsf_distributed_spare_capacity.h
//=====================================================================
//       FFFFFFIII   RRRRR      SSTTTTTTT
//      FF         IIR   RR    SS
//     FF           IR        SS
//    FFFFFF         RRRR    SSSSST
//   FF       FI       RRR  SS
//  FF         II     RRR  SS
// FF           IIIIIR    RS
//
// FSF(FIRST Scheduling Framework)
// distributed spare capacity functionality
//=====================================================================

#include "fsf_core.h"
#include "fsf_distributed.h"

#ifndef _FSF_DISTRIBUTED_SPARE_CAPACITY_H_
#define _FSF_DISTRIBUTED_SPARE_CAPACITY_H_

#define FSF_DISTRIBUTED_SPARE_CAPACITY_MODULE_SUPPORTED       1

/**
   \ingroup distsparemodule

   This operation sets the granted capacity flag in the contract
   parameters object pointed to by contract to the boolean specified
   in granted_capacity_flag. This flag indicates to the scheduler that
   once the negotiation of the respective contract is finished, the
   first values for the budget and period given to the corresponding
   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. */
int
fsf_set_contract_granted_capacity_flag
  (fsf_contract_parameters_t *contract,
   bool                    granted_capacity_flag);


/**
   \ingroup distsparemodule

   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 */
int
fsf_get_contract_granted_capacity_flag
  (fsf_contract_parameters_t *contract,
   bool                   *granted_capacity_flag);


/**
   \ingroup distsparemodule

   This operation is used to return spare capacity that was assigned
   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 */
int
fsf_set_server_capacity
   (fsf_server_id_t          server,
    const struct timespec   *new_period,
    const struct timespec   *new_budget);


#endif // _FSF_DISTRIBUTED_SPARE_CAPACITY_H_