stasis-aries-wal/lladd/operations/alloc.h

72 lines
1.7 KiB
C
Raw Normal View History

2004-07-06 20:59:36 +00:00
/**
@file
2005-01-20 21:19:47 +00:00
Allocates and deallocates records.
@todo Talloc() should reuse space freed by Tdealloc(), but
currently just leaks it.
2004-07-06 20:59:36 +00:00
@ingroup OPERATIONS
$Id$
*/
2005-01-20 21:19:47 +00:00
#ifndef __ALLOC_H
#define __ALLOC_H 1
2004-06-24 21:10:31 +00:00
Operation getAlloc();
Operation getDealloc();
Operation getRealloc();
2004-07-06 20:59:36 +00:00
/**
Allocate a record.
2005-01-21 02:13:17 +00:00
@param xid The transaction responsible for the allocation
@param size The size of the new record to be allocated. Talloc will allocate a
blob if the record will not easily fit on a page.
2005-01-20 21:19:47 +00:00
@return the recordid of the new record.
2004-07-06 20:59:36 +00:00
*/
compensated_function recordid Talloc(int xid, long size);
2004-07-06 20:59:36 +00:00
compensated_function recordid TallocFromPage(int xid, long page, long size);
2005-01-20 21:19:47 +00:00
/**
Free a record.
@todo Currently, we just leak store space on dealloc.
*/
compensated_function void Tdealloc(int xid, recordid rid);
2004-06-24 21:10:31 +00:00
2005-01-20 21:19:47 +00:00
/**
Obtain the type of a record, as returned by getRecordType.
@param xid the transaction id.
@param rid the record of interest. The size field will be ignored,
allowing this function to be used to probe for records in pages.
2005-01-20 21:19:47 +00:00
@return UNINITIALIZED_RECORD, BLOB_RECORD, SLOTTED_RECORD, or FIXED_RECORD.
@see getRecordType
2005-01-20 21:19:47 +00:00
*/
compensated_function int TrecordType(int xid, recordid rid);
2004-12-01 01:26:25 +00:00
/**
Obtain the length of the data stored in a record.
@param xid the transaction id.
@param rid the record of interest. The size field will be ignored,
allowing this function to be used to probe for records in pages.
@return -1 if the record does not exist, the size of the record otherwise.
*/
compensated_function int TrecordSize(int xid, recordid rid);
/** Return the number of records stored in page pageid */
compensated_function int TrecordsInPage(int xid, int pageid);
2004-06-24 21:10:31 +00:00
#endif