Detailed Description

template<class BlockType>
class stxxl::prefetch_pool< BlockType >

Implements dynamically resizable prefetching pool.

Definition at line 29 of file prefetch_pool.h.

Inheritance diagram for stxxl::prefetch_pool< BlockType >:

Collaboration diagram for stxxl::prefetch_pool< BlockType >:

Classes
struct	bid_hash

Public Types
typedef block_type::bid_type	bid_type

typedef BlockType	block_type

Public Member Functions
	prefetch_pool (unsigned_type init_size=1)
	Constructs pool. More...

virtual	~prefetch_pool ()
	Waits for completion of all ongoing read requests and frees memory. More...

bool	hint (bid_type bid)
	Gives a hint for prefetching a block. More...

bool	hint (bid_type bid, write_pool< block_type > &w_pool)

bool	in_prefetching (bid_type bid)

bool	invalidate (bid_type bid)

request_ptr	read (block_type *&block, bid_type bid)
	Reads block. If this block is cached block is not read but passed from the cache. More...

request_ptr	read (block_type *&block, bid_type bid, write_pool< block_type > &w_pool)

unsigned_type	resize (unsigned_type new_size)
	Resizes size of the pool. More...

unsigned_type	size () const
	Returns number of owned blocks. More...

void	swap (prefetch_pool &obj)

Protected Types
typedef hash_map_type::iterator	busy_blocks_iterator

typedef std::pair< block_type *, request_ptr >	busy_entry

typedef std::list< block_type * > ::iterator	free_blocks_iterator

typedef compat_hash_map < bid_type, busy_entry, bid_hash >::result	hash_map_type

Protected Attributes
hash_map_type	busy_blocks

std::list< block_type * >	free_blocks

unsigned_type	free_blocks_size

Additional Inherited Members
Private Member Functions inherited from stxxl::noncopyable
	noncopyable ()

Member Typedef Documentation

template<class BlockType>

typedef block_type::bid_type stxxl::prefetch_pool< BlockType >::bid_type

Definition at line 33 of file prefetch_pool.h.

template<class BlockType>

typedef BlockType stxxl::prefetch_pool< BlockType >::block_type

Definition at line 32 of file prefetch_pool.h.

template<class BlockType>

typedef hash_map_type::iterator stxxl::prefetch_pool< BlockType >::busy_blocks_iterator

protected

Definition at line 59 of file prefetch_pool.h.

template<class BlockType>

typedef std::pair<block_type*, request_ptr> stxxl::prefetch_pool< BlockType >::busy_entry

protected

Definition at line 56 of file prefetch_pool.h.

template<class BlockType>

typedef std::list<block_type*>::iterator stxxl::prefetch_pool< BlockType >::free_blocks_iterator

protected

Definition at line 58 of file prefetch_pool.h.

template<class BlockType>

typedef compat_hash_map<bid_type, busy_entry, bid_hash>::result stxxl::prefetch_pool< BlockType >::hash_map_type

protected

Definition at line 57 of file prefetch_pool.h.

Constructor & Destructor Documentation

template<class BlockType>

stxxl::prefetch_pool< BlockType >::prefetch_pool ( unsigned_type init_size = 1 )

inlineexplicit

Constructs pool.

Parameters

init_size initial number of blocks in the pool

Definition at line 71 of file prefetch_pool.h.

template<class BlockType>

virtual stxxl::prefetch_pool< BlockType >::~prefetch_pool ( )

inlinevirtual

Waits for completion of all ongoing read requests and frees memory.

Definition at line 86 of file prefetch_pool.h.

Member Function Documentation

template<class BlockType>

bool stxxl::prefetch_pool< BlockType >::hint ( bid_type bid )

inline

Gives a hint for prefetching a block.

Parameters

bid	address of a block to be prefetched

Returns: true if there was a free block to do prefetch and prefetching was scheduled, false otherwise

Note: If there are no free blocks available (all blocks are already in reading or read but not retrieved by user calling read method) calling hint function has no effect

Definition at line 118 of file prefetch_pool.h.

References STXXL_VERBOSE2.

template<class BlockType>

bool stxxl::prefetch_pool< BlockType >::hint	(	bid_type	bid,
		write_pool< block_type > &	w_pool
	)

inline

Definition at line 140 of file prefetch_pool.h.

References stxxl::write_pool< BlockType >::add(), stxxl::write_pool< BlockType >::has_request(), stxxl::write_pool< BlockType >::steal_request(), STXXL_VERBOSE1, and STXXL_VERBOSE2.

template<class BlockType>

bool stxxl::prefetch_pool< BlockType >::in_prefetching ( bid_type bid )

inline

Definition at line 189 of file prefetch_pool.h.

template<class BlockType>

bool stxxl::prefetch_pool< BlockType >::invalidate ( bid_type bid )

inline

Definition at line 171 of file prefetch_pool.h.

template<class BlockType>

request_ptr stxxl::prefetch_pool< BlockType >::read	(	block_type *&	block,
		bid_type	bid
	)

inline

Reads block. If this block is cached block is not read but passed from the cache.

Parameters

block	block object, where data to be read to. If block was cached `block` 's ownership goes to the pool and block from cache is returned in `block` value.
bid	address of the block

Warning: block parameter must be allocated dynamically using new .

Returns: request pointer object of read operation

Definition at line 200 of file prefetch_pool.h.

References STXXL_VERBOSE1.

template<class BlockType>

request_ptr stxxl::prefetch_pool< BlockType >::read	(	block_type *&	block,
		bid_type	bid,
		write_pool< block_type > &	w_pool
	)

inline

Definition at line 220 of file prefetch_pool.h.

References stxxl::write_pool< BlockType >::add(), stxxl::write_pool< BlockType >::has_request(), stxxl::write_pool< BlockType >::steal_request(), and STXXL_VERBOSE1.

template<class BlockType>

unsigned_type stxxl::prefetch_pool< BlockType >::resize ( unsigned_type new_size )

inline

Resizes size of the pool.

Parameters

new_size desired size of the pool. If some blocks are used for prefetching, these blocks can't be freed. Only free blocks (not in prefetching) can be freed by reducing the size of the pool calling this method.

Returns: new size of the pool

Definition at line 258 of file prefetch_pool.h.

template<class BlockType>

unsigned_type stxxl::prefetch_pool< BlockType >::size ( ) const

inline

Returns number of owned blocks.

Definition at line 108 of file prefetch_pool.h.

template<class BlockType>

void stxxl::prefetch_pool< BlockType >::swap ( prefetch_pool< BlockType > & obj )

inline

Definition at line 78 of file prefetch_pool.h.

References stxxl::prefetch_pool< BlockType >::busy_blocks, stxxl::prefetch_pool< BlockType >::free_blocks, and stxxl::prefetch_pool< BlockType >::free_blocks_size.

Member Data Documentation

template<class BlockType>

hash_map_type stxxl::prefetch_pool< BlockType >::busy_blocks

protected

Definition at line 64 of file prefetch_pool.h.

Referenced by stxxl::prefetch_pool< BlockType >::swap().

template<class BlockType>

std::list<block_type*> stxxl::prefetch_pool< BlockType >::free_blocks

protected

Definition at line 62 of file prefetch_pool.h.

Referenced by stxxl::prefetch_pool< BlockType >::swap().

template<class BlockType>

unsigned_type stxxl::prefetch_pool< BlockType >::free_blocks_size

protected

Definition at line 66 of file prefetch_pool.h.

Referenced by stxxl::prefetch_pool< BlockType >::swap().

The documentation for this class was generated from the following file:

include/stxxl/bits/mng/prefetch_pool.h

Detailed Description

template<class BlockType> class stxxl::prefetch_pool< BlockType >

Classes

Public Types

Public Member Functions

Protected Types

Protected Attributes

Additional Inherited Members

Member Typedef Documentation

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation

template<class BlockType>
class stxxl::prefetch_pool< BlockType >