.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve@ggi-project.org>.
.TH "JOURNAL_START" "" "06 October 2005" "" ""

.SH NAME
journal_start \- Obtain a new handle.
.SH SYNOPSIS
"SYNOPSIS"
.sp
\fB
.sp
handle_t * journal_start  (journal_t * \fIjournal\fB, int \fInblocks\fB);
\fR
.SH "ARGUMENTS"
.TP
\fB\fIjournal\fB\fR
Journal to start transaction on.
.TP
\fB\fInblocks\fB\fR
number of block buffer we might modify
.SH "DESCRIPTION"
.PP
We make sure that the transaction can guarantee at least nblocks of
modified buffers in the log.  We block until the log can guarantee
that much space.  
.PP
This function is visible to journal users (like ext3fs), so is not
called with the journal already locked.
.PP
Return a pointer to a newly allocated handle, or NULL on failure