JOURNAL_EXTEND

Section: The Linux Journalling API (9)
Updated: February 2011
Index Return to Main Contents

NAME

journal_extend - extend buffer credits.

SYNOPSIS

int journal_extend(handle_t * handle, int nblocks);

ARGUMENTS

handle

: handle to 'extend'

nblocks

: nr blocks to try to extend by.

DESCRIPTION

Some transactions, such as large extends and truncates, can be done atomically all at once or in several stages. The operation requests a credit for a number of buffer modications in advance, but can extend its credit if it needs more.

journal_extend tries to give the running handle more buffer credits. It does not guarantee that allocation - this is a best-effort only. The calling process MUST be able to deal cleanly with a failure to extend here.

Return 0 on success, non-zero on failure.

return code < 0 implies an error return code > 0 implies normal transaction-full status.

AUTHORS

Roger Gammans <rgammans@computer-surgery.co.uk>

: Author.

Stephen Tweedie <sct@redhat.com>