journal_get
Description:
[ 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 |