NAME

       libfwup - library to support management of system firmware updates

SYNOPSIS

       #include <fwup.h>

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

       typedef struct fwup_resource_s fwup_resource;
       typedef struct fwup_resource_iter_s fwup_resource_iter;

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

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

       void fwup_use_existing_media_path(int use_existing_media_path);
        - instruct fwupdate on whether to reuse old capsule filenames on the ESP.

       void fwup_set_esp_mountpoint(char *path);
        - Override detection of the mountpoint for the ESP directory

       int fwup_get_ux_capsule_info(uint32_t *screen_x_size,
                                      uint32_t *screen_y_size);
        - get the dimensions of the screen during boot

DESCRIPTION

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

       typedef struct fwup_resource_s fwup_resource;
       typedef struct fwup_resource_iter_s fwup_resource_iter;

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

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

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

       int fwup_set_up_update(fwup_resource *re, uint64_t hw_inst, int infd);
       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);
       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);
       Set guid to the GUID which uniquely identifies firmware resource re.

       int fwup_get_fw_version(fwup_resource *re, uint32_t *version);
       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);
       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);
       Get the status for the last attempt to update firmware resource re.

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

       void fwup_use_existing_media_path(int use_existing_media_path);
       Instruct fwupdate on whether to reuse old capsule filenames on the ESP.

       void fwup_set_esp_mountpoint(char *path);
       Override detection of the mountpoint for the ESP directory.

       int fwup_get_ux_capsule_info(uint32_t *screen_x_size,
                                      uint32_t *screen_y_size);
       Get the dimensions of the screen during boot.

AUTHORS

       Peter Jones <pjones@redhat.com>

SEE ALSO

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

                                         Mon 11 May 2015                               LIBFWUP(3)