Return to resource.sgml CVS log

Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / bird / lib

Annotation of embedaddon/bird/lib/resource.sgml, revision 1.1.1.1

1.1       misho       1: <!--
                      2:        BIRD Programmer's Guide: Resources
                      3: 
                      4:        (c) 2000 Martin Mares <mj@ucw.cz>
                      5: -->
                      6: 
                      7: <chapt>Resources
                      8: 
                      9: <sect>Introduction
                     10: 
                     11: <p>Most large software projects implemented in classical procedural
                     12: programming languages usually end up with lots of code taking care
                     13: of resource allocation and deallocation. Bugs in such code are often
                     14: very difficult to find, because they cause only `resource leakage',
                     15: that is keeping a lot of memory and other resources which nobody
                     16: references to.
                     17: 
                     18: <p>We've tried to solve this problem by employing a resource tracking
                     19: system which keeps track of all the resources allocated by all the
                     20: modules of BIRD, deallocates everything automatically when a module
                     21: shuts down and it is able to print out the list of resources and
                     22: the corresponding modules they are allocated by.
                     23: 
                     24: <p>Each allocated resource (from now we'll speak about allocated
                     25: resources only) is represented by a structure starting with a standard
                     26: header (struct <struct/resource/) consisting of a list node (resources are
                     27: often linked to various lists) and a pointer to <struct/resclass/ -- a resource
                     28: class structure pointing to functions implementing generic resource
                     29: operations (such as freeing of the resource) for the particular resource
                     30: type.
                     31: 
                     32: <p>There exist the following types of resources:
                     33: 
                     34: <itemize>
                     35: <item><it/Resource pools/ (<struct/pool/)
                     36: <item><it/Memory blocks/
                     37: <item><it/Linear memory pools/ (<struct/linpool/)
                     38: <item><it/Slabs/ (<struct/slab/)
                     39: <item><it/Events/ (<struct/event/) 
                     40: <item><it/Timers/ (<struct/timer/) 
                     41: <item><it/Sockets/ (<struct/socket/) 
                     42: </itemize>