QoS Supervisor Library
[QoS Supervisor Component]

Allows a privileged application to configure level, group and user rules governing security and guarantees policies enforced by the QoS Supervisor Kernel Module. More...

Files

file  qsup_gw.h
 

Common defines and structures for the US to KS gateway.


file  qsup_lib.c
 

Implementation of QSUP library.


file  qsup_lib.h
 

The QoS Supervisor Application Programming Interface.


Functions

qos_rv qsup_init ()
 Initialize the QSUP subsystem just after module load into the kernel.
qos_rv qsup_cleanup ()
 Cleanup the QSUP subsystem before unloading the module from kernel.
qos_rv qsup_add_level_rule (int level_id, qos_bw_t max_level_bw)
 Add a level max bw constraint to the identified level.
qos_rv qsup_add_group_rule (int group_id, qsup_constraints_t *rule)
 Add a group constraint for the specified group.
qos_rv qsup_add_user_rule (int user_id, qsup_constraints_t *rule)
 Add a user constraint for the specified user.
qos_rv qsup_reserve_spare (qos_bw_t spare_bw)
 Set the bandwidth that is considered as spare by the system for adaptive reservation purposes.
qos_rv qsup_get_available_bandwidth (int uid, int gid, qos_bw_t *bw)
 Retrieve total available bandwidth for the specified user and group, after both the minimum values of existing contracts, and the reserved spare bandwidth.

Detailed Description

Allows a privileged application to configure level, group and user rules governing security and guarantees policies enforced by the QoS Supervisor Kernel Module.


Function Documentation

qos_rv qsup_add_group_rule ( int  group_id,
qsup_constraints_t rule 
)

Add a group constraint for the specified group.

Definition at line 73 of file qsup_lib.c.

References check_open(), qsup_iparams_t::group_rule, IOCTL_OP_ADD_GROUP_RULE, qos_chk_rv, qos_int_rv, QOS_OK, qsup_fd, and qsup_iparams_t::u.

Referenced by main().

qos_rv qsup_add_level_rule ( int  level_id,
qos_bw_t  max_level_bw 
)

Add a level max bw constraint to the identified level.

Definition at line 129 of file qsup.c.

References bw_min(), check_open(), IOCTL_OP_ADD_LEVEL_RULE, qsup_level_t::level_max, qsup_iparams_t::level_rule, MAX_NUM_LEVELS, qos_chk_rv, QOS_E_INVALID_PARAM, qos_int_rv, QOS_OK, qsup_fd, qsup_iparams_t::u, and U_LUB.

Referenced by main(), and qsup_gw_ks().

qos_rv qsup_add_user_rule ( int  user_id,
qsup_constraints_t rule 
)

Add a user constraint for the specified user.

Definition at line 88 of file qsup_lib.c.

References check_open(), IOCTL_OP_ADD_USER_RULE, qos_chk_rv, qos_int_rv, QOS_OK, qsup_fd, qsup_iparams_t::u, and qsup_iparams_t::user_rule.

Referenced by main().

qos_rv qsup_cleanup (  ) 

Cleanup the QSUP subsystem before unloading the module from kernel.

Definition at line 186 of file qsup.c.

References qsup_user_rule_t::next, qsup_group_rule_t::next, qsup_user_t::next, qsup_server_t::next, QOS_E_GENERIC, qos_free(), QOS_OK, qsup_fd, and srv.

Referenced by main(), qres_cleanup_module(), qsup_cleanup_ks(), and qsup_cleanup_module().

qos_rv qsup_get_available_bandwidth ( int  uid,
int  gid,
qos_bw_t bw 
)

Retrieve total available bandwidth for the specified user and group, after both the minimum values of existing contracts, and the reserved spare bandwidth.

Definition at line 134 of file qsup_lib.c.

References qsup_iparams_t::avail, check_open(), IOCTL_OP_GET_AVAIL_GUA_BW, qos_chk_ok_do, qos_int_rv, QOS_OK, qsup_fd, and qsup_iparams_t::u.

qos_rv qsup_init (  ) 
qos_rv qsup_reserve_spare ( qos_bw_t  spare_bw  ) 

Set the bandwidth that is considered as spare by the system for adaptive reservation purposes.

The sum of bandwidths allowed as guaranteed minima by the admission control will be U_LUB - spare_bw from now on.

Set the bandwidth that is considered as spare by the system for adaptive reservation purposes.

Set the spare bandwidth for admission control purposes.

Definition at line 594 of file qsup.c.

References check_open(), IOCTL_OP_RESERVE_SPARE, qos_chk_ok_do, QOS_E_INCONSISTENT_STATE, QOS_E_INVALID_PARAM, qos_int_rv, QOS_OK, qsup_fd, qsup_iparams_t::spare_bw, spare_bw, qsup_iparams_t::u, and U_LUB.

Referenced by main(), and qsup_gw_ks().

Generated on Mon Aug 2 22:39:17 2010 for qosres by  doxygen 1.6.3