mirror of
https://git.proxmox.com/git/fwupd
synced 2025-05-22 09:12:32 +00:00
460c4b75fe
This allows a device to identify with different streams, for instance a Lenovo
laptop could have a coreboot firmware or a AMI firmware. The GUIDs would be the
same, but switching firmware would only be done rarely and very carefully.
Another example would be switching the Broadcom BCM57xx nework adaptors from the
vendor nonfree firmware with a signed PXE image, to the free software reverse
engineered driver with no PXE support (and thus no signed DXE) at all.
It is expected firmware would have additional metadata something like this:
...
<branch>sdcc</branch>
<description>
<p>
This is an alternate firmware built by the community using only free
software tools.
</p>
</description>
<requires>
<id compare="ge" version="1.5.0">org.freedesktop.fwupd</id>
<client>switch-branch</client>
</requires>
...
Additionally, alternate branch firmware will not be returned for clients not
setting the FWUPD_FEATURE_FLAG_SWITCH_BRANCH before the GetReleases request.
148 lines
6.3 KiB
C
148 lines
6.3 KiB
C
/*
|
|
* Copyright (C) 2015-2020 Richard Hughes <richard@hughsie.com>
|
|
*
|
|
* SPDX-License-Identifier: LGPL-2.1+
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include <glib-object.h>
|
|
|
|
#include "fwupd-enums.h"
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
#define FWUPD_TYPE_RELEASE (fwupd_release_get_type ())
|
|
G_DECLARE_DERIVABLE_TYPE (FwupdRelease, fwupd_release, FWUPD, RELEASE, GObject)
|
|
|
|
struct _FwupdReleaseClass
|
|
{
|
|
GObjectClass parent_class;
|
|
/*< private >*/
|
|
void (*_fwupd_reserved1) (void);
|
|
void (*_fwupd_reserved2) (void);
|
|
void (*_fwupd_reserved3) (void);
|
|
void (*_fwupd_reserved4) (void);
|
|
void (*_fwupd_reserved5) (void);
|
|
void (*_fwupd_reserved6) (void);
|
|
void (*_fwupd_reserved7) (void);
|
|
};
|
|
|
|
FwupdRelease *fwupd_release_new (void);
|
|
gchar *fwupd_release_to_string (FwupdRelease *release);
|
|
|
|
const gchar *fwupd_release_get_version (FwupdRelease *release);
|
|
void fwupd_release_set_version (FwupdRelease *release,
|
|
const gchar *version);
|
|
const gchar *fwupd_release_get_uri (FwupdRelease *release);
|
|
void fwupd_release_set_uri (FwupdRelease *release,
|
|
const gchar *uri);
|
|
GPtrArray *fwupd_release_get_issues (FwupdRelease *release);
|
|
void fwupd_release_add_issue (FwupdRelease *release,
|
|
const gchar *issue);
|
|
GPtrArray *fwupd_release_get_categories (FwupdRelease *release);
|
|
void fwupd_release_add_category (FwupdRelease *release,
|
|
const gchar *category);
|
|
gboolean fwupd_release_has_category (FwupdRelease *release,
|
|
const gchar *category);
|
|
GPtrArray *fwupd_release_get_checksums (FwupdRelease *release);
|
|
void fwupd_release_add_checksum (FwupdRelease *release,
|
|
const gchar *checksum);
|
|
gboolean fwupd_release_has_checksum (FwupdRelease *release,
|
|
const gchar *checksum);
|
|
|
|
GHashTable *fwupd_release_get_metadata (FwupdRelease *release);
|
|
void fwupd_release_add_metadata (FwupdRelease *release,
|
|
GHashTable *hash);
|
|
void fwupd_release_add_metadata_item (FwupdRelease *release,
|
|
const gchar *key,
|
|
const gchar *value);
|
|
const gchar *fwupd_release_get_metadata_item (FwupdRelease *release,
|
|
const gchar *key);
|
|
|
|
const gchar *fwupd_release_get_filename (FwupdRelease *release);
|
|
void fwupd_release_set_filename (FwupdRelease *release,
|
|
const gchar *filename);
|
|
const gchar *fwupd_release_get_protocol (FwupdRelease *release);
|
|
void fwupd_release_set_protocol (FwupdRelease *release,
|
|
const gchar *protocol);
|
|
const gchar *fwupd_release_get_appstream_id (FwupdRelease *release);
|
|
void fwupd_release_set_appstream_id (FwupdRelease *release,
|
|
const gchar *appstream_id);
|
|
const gchar *fwupd_release_get_detach_caption (FwupdRelease *release);
|
|
void fwupd_release_set_detach_caption (FwupdRelease *release,
|
|
const gchar *detach_caption);
|
|
const gchar *fwupd_release_get_detach_image (FwupdRelease *release);
|
|
void fwupd_release_set_detach_image (FwupdRelease *release,
|
|
const gchar *detach_image);
|
|
const gchar *fwupd_release_get_remote_id (FwupdRelease *release);
|
|
void fwupd_release_set_remote_id (FwupdRelease *release,
|
|
const gchar *remote_id);
|
|
const gchar *fwupd_release_get_vendor (FwupdRelease *release);
|
|
void fwupd_release_set_vendor (FwupdRelease *release,
|
|
const gchar *vendor);
|
|
const gchar *fwupd_release_get_name (FwupdRelease *release);
|
|
void fwupd_release_set_name (FwupdRelease *release,
|
|
const gchar *name);
|
|
const gchar *fwupd_release_get_name_variant_suffix (FwupdRelease *release);
|
|
void fwupd_release_set_name_variant_suffix (FwupdRelease *release,
|
|
const gchar *name_variant_suffix);
|
|
const gchar *fwupd_release_get_summary (FwupdRelease *release);
|
|
void fwupd_release_set_summary (FwupdRelease *release,
|
|
const gchar *summary);
|
|
const gchar *fwupd_release_get_branch (FwupdRelease *release);
|
|
void fwupd_release_set_branch (FwupdRelease *release,
|
|
const gchar *branch);
|
|
const gchar *fwupd_release_get_description (FwupdRelease *release);
|
|
void fwupd_release_set_description (FwupdRelease *release,
|
|
const gchar *description);
|
|
const gchar *fwupd_release_get_homepage (FwupdRelease *release);
|
|
void fwupd_release_set_homepage (FwupdRelease *release,
|
|
const gchar *homepage);
|
|
const gchar *fwupd_release_get_details_url (FwupdRelease *release);
|
|
void fwupd_release_set_details_url (FwupdRelease *release,
|
|
const gchar *details_url);
|
|
const gchar *fwupd_release_get_source_url (FwupdRelease *release);
|
|
void fwupd_release_set_source_url (FwupdRelease *release,
|
|
const gchar *source_url);
|
|
guint64 fwupd_release_get_size (FwupdRelease *release);
|
|
void fwupd_release_set_size (FwupdRelease *release,
|
|
guint64 size);
|
|
guint64 fwupd_release_get_created (FwupdRelease *release);
|
|
void fwupd_release_set_created (FwupdRelease *release,
|
|
guint64 created);
|
|
const gchar *fwupd_release_get_license (FwupdRelease *release);
|
|
void fwupd_release_set_license (FwupdRelease *release,
|
|
const gchar *license);
|
|
FwupdTrustFlags fwupd_release_get_trust_flags (FwupdRelease *release)
|
|
G_DEPRECATED_FOR(fwupd_release_get_flags);
|
|
void fwupd_release_set_trust_flags (FwupdRelease *release,
|
|
FwupdTrustFlags trust_flags)
|
|
G_DEPRECATED_FOR(fwupd_release_set_flags);
|
|
FwupdReleaseFlags fwupd_release_get_flags (FwupdRelease *release);
|
|
void fwupd_release_set_flags (FwupdRelease *release,
|
|
FwupdReleaseFlags flags);
|
|
void fwupd_release_add_flag (FwupdRelease *release,
|
|
FwupdReleaseFlags flag);
|
|
void fwupd_release_remove_flag (FwupdRelease *release,
|
|
FwupdReleaseFlags flag);
|
|
gboolean fwupd_release_has_flag (FwupdRelease *release,
|
|
FwupdReleaseFlags flag);
|
|
FwupdReleaseUrgency fwupd_release_get_urgency (FwupdRelease *release);
|
|
void fwupd_release_set_urgency (FwupdRelease *release,
|
|
FwupdReleaseUrgency urgency);
|
|
guint32 fwupd_release_get_install_duration (FwupdRelease *release);
|
|
void fwupd_release_set_install_duration (FwupdRelease *release,
|
|
guint32 duration);
|
|
const gchar *fwupd_release_get_update_message (FwupdRelease *release);
|
|
void fwupd_release_set_update_message (FwupdRelease *release,
|
|
const gchar *update_message);
|
|
const gchar *fwupd_release_get_update_image (FwupdRelease *release);
|
|
void fwupd_release_set_update_image (FwupdRelease *release,
|
|
const gchar *update_image);
|
|
|
|
FwupdRelease *fwupd_release_from_variant (GVariant *value);
|
|
GPtrArray *fwupd_release_array_from_variant (GVariant *value);
|
|
|
|
G_END_DECLS
|