/usr/include/falcon/garbagelock.h is in falconpl-dev 0.9.6.9-git20120606-2.1+b1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 | /*
FALCON - The Falcon Programming Language.
FILE: garbagelock.h
Garbage lock - safeguards for items in VMs.
-------------------------------------------------------------------
Author: Giancarlo Niccolai
Begin: Thu, 19 Mar 2009 19:59:27 +0100
-------------------------------------------------------------------
(C) Copyright 2009: the FALCON developers (see list in AUTHORS file)
See LICENSE file for licensing details.
*/
#ifndef FALCON_GARBAGELOCK_H
#define FALCON_GARBAGELOCK_H
#include <falcon/setup.h>
#include <falcon/types.h>
#include <falcon/basealloc.h>
#include <falcon/item.h>
namespace Falcon {
class MemPool;
/* Notice that this class is implemented in mempool.cpp */
/** Protects an item from garbage collecting.
This class safely store an item, and all its contents in case it is a
sort of container, from being collected. The garbage locked items
are marked as soon as they reach the lowest possible value
in the live generation count. Extensions are granted to have their
::gcMark() method called when this happens, so any kind of item
can be safely stored as the item() element.
Once destroyed, the garbage lock releases the item, that
can then be immediately collected.
*/
class FALCON_DYN_CLASS GarbageLock: public BaseAlloc
{
GarbageLock *m_garbage_next;
GarbageLock *m_garbage_prev;
Item m_item;
friend class MemPool;
GarbageLock *next() const { return m_garbage_next; }
GarbageLock *prev() const { return m_garbage_prev; }
void next( GarbageLock *next ) { m_garbage_next = next; }
void prev( GarbageLock *prev ) { m_garbage_prev = prev; }
// Constructor used to initialize the gclock ring
GarbageLock( bool );
public:
/** Creates an empty garbage lock.
The item inside this garbage lock is nil.
*/
GarbageLock();
/** Creates a garbage lock protecting an item. */
GarbageLock( const Item &itm );
/** Releases the item that can now be collected. */
~GarbageLock();
/** Return the guarded item (const version). */
const Item &item() const { return m_item; }
/** Return the guarded item.
The returned value can be modified. For example, setting it to nil
or to another flat value will cause the previously guarded value
to be released, and collectible for garbage.
*/
Item &item() { return m_item; }
};
/* Notice that this class is implemented in mempool.cpp */
}
#endif
/* end of garbagelock.h */
|