libfwup man page

libfwup — library to support management of system firmware updates

Synopsis

#include <fwup.h>

int fwup_supported(void);p
 - test if firmware updating is supported on the running machine

typedef struct fwup_resource_s fwup_resource;p
typedef struct fwup_resource_iter_s fwup_resource_iter;p

int fwup_resource_iter_create(fwup_resource_iter **iter);p
int fwup_resource_iter_next(fwup_resource_iter *iter,
	fwup_resource **re);p
int fwup_resource_iter_destroy(fwup_resource_iter **iter);p
 - iterate the list of updateable firmware images

int fwup_set_up_update(fwup_resource *re, uint64_t hw_inst, int infd);p
int fwup_clear_status(fwup_resource *re);p
int fwup_get_guid(fwup_resource *re, efi_guid_t **guid);p
int fwup_get_fw_version(fwup_resource *re, uint32_t *version);p
int fwup_get_fw_type(fwup_resource *re, uint32_t *type);p
int fwup_get_lowest_supported_fw_version(fwup_resource *re,
	uint32_t *version);p
int fwup_get_last_attempt_info(fwup_resource *re, uint32_t *version,
	uint32_t *status, time_t *when);p
 - operate on an individual firmware entry

Description

int fwup_supported(void);
Tests if the current machine supports firmware updates

typedef struct fwup_resource_s fwup_resource;p
typedef struct fwup_resource_iter_s fwup_resource_iter;p

int fwup_resource_iter_create(fwup_resource_iter **iter);p
Create a new firmware resoure iterator iter.

int fwup_resource_iter_next(fwup_resource_iter *iter,
	fwup_resource **re);p
Get the next firmware resource re from iterator iter.

int fwup_resource_iter_destroy(fwup_resource_iter **iter);p
Destroy firmware resource iterator iter.

int fwup_set_up_update(fwup_resource *re, uint64_t hw_inst, int infd);p
Set up an update for resource re, hardware instance number hw_inst,
with the file referenced by the file descriptor infd.  infd must
support read(3).

int fwup_clear_status(fwup_resource *re);p
Clear the status of the firmware resource re.  This removes any pending
attempt to update it, as well as clearing any pending error report.

int fwup_get_guid(fwup_resource *re, efi_guid_t **guid);p
Set guid to the GUID which uniquely identifies firmware resource re.

int fwup_get_fw_version(fwup_resource *re, uint32_t *version);p
Set version to the version of the firmware resource re.

#define FWUP_RESOURCE_TYPE_UNKNOWN         0
#define FWUP_RESOURCE_TYPE_SYSTEM_FIRMWARE 1
#define FWUP_RESOURCE_TYPE_DEVICE_FIRMWARE 2
#define FWUP_RESOURCE_TYPE_UEFI_DRIVER     3
int fwup_get_fw_type(fwup_resource *re, uint32_t *type);p
Set type to the type of the firmware resource re.

int fwup_get_lowest_supported_fw_version(fwup_resource *re,
	uint32_t *version);
Set version to the lowest firmware version resource re can be
updated to.

int fwup_get_last_attempt_info(fwup_resource *re, uint32_t *version,
	uint32_t *status, time_t *when);p
Get the status for the last attempt to update firmware resource re.

void fwup_print_update_info(void);p
Print the information of firmware update status.

Authors

Peter Jones <pjones@redhat.com>

See Also

errno(3), strerror(3), strerror_r(3)

Referenced By

fwup_clear_status(3), fwup_get_fw_version(3), fwup_get_guid(3), fwup_get_last_attempt_info(3), fwup_get_lowest_supported_version(3), fwup_resource_iter_create(3), fwup_resource_iter_destroy(3), fwup_resource_iter_next(3), fwup_set_up_update(3), fwup_supported(3) and libfwup.h(3) are aliases of libfwup(3).

Mon 11 May 2015