journal_next

move to the next journal entry

Move to the next journal entry. You have to call this at least once after opening the handle before you are able to read data.

The returned boolean tells you if there are any more journal records to read. true means you can read the next record (eg. using journal_get), and false means you have reached the end of the journal.

This function depends on the feature "journal". See also feature_available.

Parameters:

this	A GuestfsSession object

Returns:

the returned value, or -1 on error