Commit 91e4775d authored by Mauro Carvalho Chehab's avatar Mauro Carvalho Chehab
Browse files

fs: jbd2: make jbd2_journal_start() kernel-doc parseable 



kernel-doc script expects that a function documentation to
be just before the function, otherwise it will be ignored.

So, move the kernel-doc markup to the right place.

Reviewed-by: default avatarJan Kara <jack@suse.cz>
Signed-off-by: default avatarMauro Carvalho Chehab <mchehab@s-opensource.com>
parent 7a2208f6

fs/jbd2/transaction.c

+19 −19
Original line number Diff line number Diff line
@@ -409,25 +409,6 @@ static handle_t *new_handle(int nblocks) 
	return handle;

}



/**

 * handle_t *jbd2_journal_start() - Obtain a new handle.

 * @journal: Journal to start transaction on.

 * @nblocks: number of block buffer we might modify

 *

 * 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. Additionally, if rsv_blocks > 0, we also create another

 * handle with rsv_blocks reserved blocks in the journal. This handle is

 * is stored in h_rsv_handle. It is not attached to any particular transaction

 * and thus doesn't block transaction commit. If the caller uses this reserved

 * handle, it has to set h_rsv_handle to NULL as otherwise jbd2_journal_stop()

 * on the parent handle will dispose the reserved one. Reserved handle has to

 * be converted to a normal handle using jbd2_journal_start_reserved() before

 * it can be used.

 *

 * Return a pointer to a newly allocated handle, or an ERR_PTR() value

 * on failure.

 */

handle_t *jbd2__journal_start(journal_t *journal, int nblocks, int rsv_blocks,

			      gfp_t gfp_mask, unsigned int type,

			      unsigned int line_no)
@@ -478,6 +459,25 @@ handle_t *jbd2__journal_start(journal_t *journal, int nblocks, int rsv_blocks, 
EXPORT_SYMBOL(jbd2__journal_start);





/**

 * handle_t *jbd2_journal_start() - Obtain a new handle.

 * @journal: Journal to start transaction on.

 * @nblocks: number of block buffer we might modify

 *

 * 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. Additionally, if rsv_blocks > 0, we also create another

 * handle with rsv_blocks reserved blocks in the journal. This handle is

 * is stored in h_rsv_handle. It is not attached to any particular transaction

 * and thus doesn't block transaction commit. If the caller uses this reserved

 * handle, it has to set h_rsv_handle to NULL as otherwise jbd2_journal_stop()

 * on the parent handle will dispose the reserved one. Reserved handle has to

 * be converted to a normal handle using jbd2_journal_start_reserved() before

 * it can be used.

 *

 * Return a pointer to a newly allocated handle, or an ERR_PTR() value

 * on failure.

 */

handle_t *jbd2_journal_start(journal_t *journal, int nblocks)

{

	return jbd2__journal_start(journal, nblocks, 0, GFP_NOFS, 0, 0);