Package balb [Package Group bal]

Provide common application-level facilities. More...

Components
	Component balb_controlmanager
	Provide a mechanism for mapping control messages to callbacks.
	Component balb_filecleanerconfiguration
	Provide an attribute class for file cleaner configuration.
	Component balb_filecleanerutil
	Provide a utility class for configuration-based file removal.
	Component balb_leakybucket
	Provide a mechanism to monitor the consumption rate of a resource.
	Component balb_performancemonitor
	Provide a mechanism to collect process performance measures.
	Component balb_pipecontrolchannel
	Provide a mechanism for reading control messages from a named pipe.
	Component balb_ratelimiter
	Provide a mechanism to limit peak and sustained consumption rates.
	Component balb_reservationguard
	Provide a generic proctor for rate controlling objects.
	Component balb_testmessages
	Provide value-semantic attribute classes.

---

Detailed Description

Outline

• Purpose
• MNEMONIC: Basic Application Library Basis (balb)
• Description
  • Hierarchical Synopsis
  • Component Synopsis

Purpose:

Provide common application-level facilities.

MNEMONIC: Basic Application Library Basis (balb):

See also:

balm

Description:

The balb package provides support for an assortment of common application-level services (e.g., command-line processing). In particular, balb includes the following:

• A mechanism for monitoring and reporting the observable performance of a process.
• Classes for (1) defining commands (as short strings), (2) passing these commands through a pipe-channel to a running process, and (3) registering callback functions to be invoked upon reception of such commands.
• A multi-process performance reporting mechanism and a value-semantic type to represent metrics. Note that the entire balm package is dedicated to metrics gathering.
• A mechanism that allows clients to monitor whether a resource is being consumed at a particular rate.
• A mechanism that enables clients to monitor and control the use of a resource such that the peak consumption rate and the sustained consumption rate do not exceed their respective configured limits.
• Generic proctor to automatically reserve and release units from a rate controlling object.

Hierarchical Synopsis:

The balb package currently has 9 components having 2 levels of physical dependency. The list below shows the hierarchical ordering of the components. The order of components within each level is not architecturally significant, just alphabetical.

  2. balb_filecleanerutil
     balb_ratelimiter
     balb_reservationguard

  1. balb_controlmanager
     balb_filecleanerconfiguration
     balb_leakybucket
     balb_performancemonitor
     balb_pipecontrolchannel
     balb_testmessages

Component Synopsis:

balb_controlmanager:
Provide a mechanism for mapping control messages to callbacks.

balb_filecleanerconfiguration:
Provide an attribute class for file cleaner configuration.

balb_filecleanerutil:
Provide a utility class for configuration-based file removal.

balb_leakybucket:
Provide a mechanism to monitor the consumption rate of a resource.

balb_performancemonitor:
Provide a mechanism to collect process performance measures.

balb_pipecontrolchannel:
Provide a mechanism for reading control messages from a named pipe.

balb_ratelimiter:
Provide a mechanism to limit peak and sustained consumption rates.

balb_reservationguard:
Provide a generic proctor for rate controlling objects.

balb_testmessages:
Provide value-semantic attribute classes.