journal_get


Description:

[ CCode ( array_length = false , array_null_terminated = true ) ]
[ Version ( since = "1.23.11" ) ]
public XAttr[] journal_get () throws Error

read the current journal entry

Read the current journal entry. This returns all the fields in the journal as a set of "(attrname, attrval)" pairs. The attrname is the field name (a string).

The attrval is the field value (a binary blob, often but not always a string). Please note that attrval is a byte array, *not* a \0-terminated C string.

The length of data may be truncated to the data threshold (see: journal_set_data_threshold, journal_get_data_threshold).

If you set the data threshold to unlimited (@0) then this call can read a journal entry of any size, ie. it is not limited by the libguestfs protocol.

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

Parameters:

this

A GuestfsSession object

Returns:

an array of XAttr objects, or NULL on error